ModifySnatEntry - NAT Gateway - Alibaba Cloud Documentation Center

Mengubah entri SNAT tertentu.

Deskripsi operasi

ModifySnatEntry adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem mengembalikan ID permintaan, tetapi entri SNAT belum diubah. Tugas modifikasi masih berjalan di latar belakang. Anda dapat memanggil DescribeSnatTableEntries untuk mengkueri status entri SNAT:

Jika entri SNAT berada dalam status Pending, entri SNAT sedang diubah. Dalam status ini, Anda hanya dapat melakukan operasi kueri dan tidak dapat melakukan operasi lain.
Jika entri SNAT berada dalam status Available, entri SNAT telah diubah.

Catatan

Jika ada entri SNAT dalam tabel SNAT yang berada dalam status Pending, Anda tidak dapat mengubah entri SNAT dalam tabel SNAT tersebut.

Operasi ModifySnatEntry tidak mendukung modifikasi konkuren pada entri SNAT tertentu dalam instans entri SNAT yang sama.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

vpc:ModifySnatEntry

update

*SnatTable

acs:vpc:{#regionId}:{#accountId}:snattable/{#SnatTableId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah gerbang NAT. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-hangzhou
SnatTableId	string	Yes	ID tabel SNAT tempat entri SNAT berada.	stb-8vbczigrhop8x5u3t****
SnatEntryId	string	Yes	ID entri SNAT yang ingin Anda ubah.	snat-bp1vcgcf8tm0plqcg****
SnatIp	string	No	Saat Anda mengubah entri SNAT untuk gerbang NAT Internet, parameter ini menentukan EIP dalam entri SNAT. Pisahkan beberapa EIP dengan koma (,). Catatan Saat Anda menentukan beberapa EIP untuk mengalokasikan kolam IPAM IP SNAT, lalu lintas layanan didistribusikan ke seluruh EIP menggunakan algoritma hash. Karena trafik bervariasi di setiap koneksi, lalu lintas layanan mungkin tidak terdistribusi secara merata ke seluruh EIP. Tambahkan semua EIP ke instans Internet Shared Bandwidth yang sama untuk mencegah gangguan layanan yang disebabkan oleh Pembatasan bandwidth pada satu EIP. Saat Anda mengubah entri SNAT untuk gerbang NAT VPC, parameter ini menentukan alamat IP NAT dalam entri SNAT. Pisahkan beberapa alamat IP NAT dengan koma (,). Parameter SnatIp dan NetworkInterfaceId tidak dapat ditentukan secara bersamaan.	47.98.XX.XX
SnatEntryName	string	No	Nama entri SNAT. Panjang nama harus 2 hingga 128 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Nama tidak dapat diawali dengan `http://` atau `https://`.	SnatEntry-1
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Nilai ClientToken hanya dapat berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.	02fb3da4-130e-11e9-8e44-001****
EipAffinity	integer	No	Apakah akan mengaktifkan afinitas EIP. Nilai valid: 0: Menonaktifkan afinitas EIP. 1: Mengaktifkan afinitas EIP. Catatan Setelah Anda mengaktifkan afinitas EIP, jika entri SNAT dikaitkan dengan beberapa EIP atau alamat IP NAT, klien yang sama akan menggunakan EIP atau alamat IP NAT yang sama untuk akses. Jika tidak, klien akan memilih EIP atau alamat IP NAT secara acak dari yang dikaitkan untuk akses.	1
NetworkInterfaceId	string	No	ID antarmuka jaringan elastis (ENI). Catatan Alamat IPv4 dari pengontrol antarmuka jaringan (NIC) digunakan sebagai alamat SNAT.	eni-gw8g131ef2dnbu3k****
DryRun	boolean	No	Apakah akan menjalankan dry run. Nilai valid: true: Menjalankan dry run tanpa mengubah entri SNAT. Sistem memeriksa parameter yang diperlukan, format permintaan, dan batas layanan. Jika pemeriksaan gagal, kode kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan `DryRunOperation` akan dikembalikan. false (default): Menjalankan dry run dan mengirim permintaan. Setelah pemeriksaan berhasil, kode status HTTP 2xx akan dikembalikan dan entri SNAT diubah.	false

Elemen respons

Element	Type	Description	Example
	object	Badan respons.
RequestId	string	ID permintaan.	2315DEB7-5E92-423A-91F7-4C1EC9AD****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "2315DEB7-5E92-423A-91F7-4C1EC9AD****"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidSnatIp.Malformed	The specified SnatIp is not a valid IP address.
400	Forbidden.SourceVSwitchId.Duplicated	The specified SourceCIDRis duplicated.
400	Forbidden.IpUsedInForwardTable	The specified SnatIp already used in forward table
400	OperationUnsupported.EipForSnatPool	The Eip cannot support snat pool
400	InvalidParameter.Name.Malformed	The specified Name is not valid.
400	IncorretSnatEntryStatus	The Specified SnatEntry is not stable status, can not operation
400	EIP_NOT_IN_GATEWAY	The Eip not in nat gateway
400	InvalidParameter.SnatIp	Error public ip must in same bandwidth package.
400	QuotaExceeded.SnatIp	Public ip number exceeds quota.
400	InvalidSnatEntryId.NotFound	Specified SNAT entry does not exist.
400	IncorrectStatus.SnatEntry	The Specified SnatEntry is not stable status, can not operation	Entri SNAT yang ditentukan tidak dalam status stabil dan tidak dapat dioperasikan.
400	OperationFailed.CanNotUseEipInDnat	Operation failed because the eip can not used by forward entry.
400	OperationUnsupported.EipNatGWCheck	Operation unsupported because the relation check of eip and nat gateway is failed.
400	ResourceNotFound.SnatEntry	Specified SNAT entry does not exist.
400	IncorrectStatus.NatIp	Specified NatIp does not exist.
400	OperationFailed.CanNotUseNatIpInDnat	Operation failed because the NatIp can not used by forward entry.
400	IncorrectStatus.NATGW	NATGW status is invalid.	Status NAT gateway tidak valid.
400	OperationUnsupported.EipInBinding	Create snat entry with eip in associating status is unsupported.	EIP dalam status associating tidak dapat digunakan untuk membuat entri SNAT.
400	OperationUnsupported.EipNatBWPCheck	The EIP is not associated with a NAT service plan.	EIP saat ini tidak termasuk dalam paket bandwidth NAT.
400	IllegalParam.NetworkInterfaceId	The param of NetworkInterfaceId is illegal.	Parameter NetworkInterfaceId tidak valid.
400	OperationFailed.SnatIpPoolBwpRules	The operation failed because the IP in Snat entryl was added to multiple NAT bandwidth packets.	Operasi gagal karena IP dalam pool alamat IP aturan SNAT ditambahkan ke beberapa paket bandwidth NAT.
400	OperationFailed.SnatIpPoolCbwpRules	The operation failed because the SNAT rule IPs are added to multi bandwidth packages.	Operasi gagal karena pool alamat IP aturan SNAT ditambahkan ke beberapa paket bandwidth.
400	OperationFailed.SnatIpsTooMany	The maximum number of IP addresses is exceeded in the SNAT pool.	Terlalu banyak alamat IP dalam pool SNAT.
400	OperationFailed.SnatIpsCheck	The operation fails because some IPs address in the SNAT entry are not added to common bandwidth packet.	Operasi gagal karena beberapa alamat IP dalam pool alamat IP aturan SNAT tidak ditambahkan ke paket bandwidth EIP.
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.
404	InvalidSnatTableId.NotFound	Specified SNAT table does not exist.
404	InvalidSnatEntryId.NotFound	Specified SNAT entry does not exist.
404	InvalidSnatIp.NotFound	Specified SnatIp does not found on the NAT Gateway
404	ResourceNotFound.NatIp	Specified NatIp does not found on the NAT Gateway

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.