GetNatGatewayAttribute - NAT Gateway - Alibaba Cloud Documentation Center

Mengkueri informasi tentang satu instans gerbang NAT.

Deskripsi operasi

Operasi ini mengkueri informasi tentang satu Internet NAT gerbang atau VPC NAT gerbang. Kata kunci "NAT gerbang" dalam topik ini tidak membedakan antara kedua jenis tersebut.

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:GetNatGatewayAttribute

get

*NatGateway.

acs:vpc:{#regionId}:{#accountId}:natgateway/{#NatGatewayId}

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-qingdao
NatGatewayId	string	Yes	ID instans gerbang NAT.	ngw-bp1b0lic8uz4r6vf2****

Elemen respons

Element	Type	Description	Example
	object
VpcId	string	ID VPC tempat instans NAT gerbang berada.	vpc-bp15zckdt37pq72z****
CreationTime	string	Waktu pembuatan NAT gerbang. Waktu ditampilkan dalam format YYYY-MM-DDThh:mm:ssZ.	2021-12-08T12:20:20Z
Status	string	Status NAT gerbang. Nilai valid: Creating: NAT gerbang sedang dibuat. Pembuatan NAT gerbang adalah operasi asinkron. NAT gerbang tetap dalam status Creating hingga operasi selesai. Available: NAT gerbang tersedia. Ini adalah status stabil setelah NAT gerbang dibuat. Modifying: NAT gerbang sedang dimodifikasi. Modifikasi NAT gerbang adalah operasi asinkron. NAT gerbang tetap dalam status Modifying hingga operasi selesai. Deleting: NAT gerbang sedang dihapus. Penghapusan NAT gerbang adalah operasi asinkron. NAT gerbang tetap dalam status Deleting hingga operasi selesai. Converting: NAT gerbang sedang dikonversi. Konversi Jenis Penyimpanan Standar NAT gerbang menjadi Enhanced NAT gerbang adalah operasi asinkron. NAT gerbang tetap dalam status Converting hingga operasi selesai.	Available
NatType	string	Tipe Internet NAT gerbang. Nilainya adalah Enhanced, yang menunjukkan Enhanced NAT gerbang.	Enhanced
NetworkType	string	Tipe NAT gerbang. Nilai valid: internet: Internet NAT gerbang. intranet: VPC NAT gerbang.	internet
RegionId	string	ID wilayah instans NAT gerbang.	cn-qingdao
EcsMetricEnabled	boolean	Apakah fitur pemantauan trafik gerbang diaktifkan. Nilai valid: true: Fitur pemantauan trafik gerbang diaktifkan. false: Fitur pemantauan trafik gerbang dinonaktifkan.	true
RequestId	string	ID permintaan.	4EC47282-1B74-4534-BD0E-403F3EE64CAF
Description	string	Deskripsi instans NAT gerbang.	NAT
ExpiredTime	string	Pengatur waktu kedaluwarsa instans NAT gerbang.	2021-12-26T12:20:20Z
ResourceGroupId	string	ID kelompok sumber daya.	rg-bp67acfmxazb4ph****
NatGatewayId	string	ID instans NAT gerbang.	ngw-bp1047e2d4z7kf2ki****
BusinessStatus	string	Status bisnis NAT gerbang. Nilai valid: Normal: Normal. FinancialLocked: Terkunci karena Pembayaran tertunda.	Normal
Name	string	Nama instans NAT gerbang.	abc
ForwardTable	object	Informasi Tabel DNAT.
ForwardTableId	string	ID Tabel DNAT.	ftb-uf6gj3mhsg94qsqst****
ForwardEntryCount	integer	Jumlah Entri DNAT.	1
SnatTable	object	Informasi Tabel SNAT.
SnatEntryCount	integer	Jumlah Entri SNAT.	1
SnatTableId	string	ID Tabel SNAT.	stb-SnatTableIds****
FullNatTable	object	Informasi Tabel FULLNAT.
FullNatEntryCount	integer	Jumlah Entri FULLNAT.	1
FullNatTableId	string	ID Tabel FULLNAT.	fulltb-gw88z7hhlv43rmb26****
BillingConfig	object	Informasi konfigurasi penagihan.
InternetChargeType	string	Tipe penagihan instans NAT gerbang. Nilai valid: PayBySpec: Ditagih berdasarkan spesifikasi yang ditentukan. PayByLcu: Ditagih berdasarkan Penggunaan.	PayBySpec
AutoPay	string	Apakah pembayaran otomatis diaktifkan. Ketika nilai InstanceChargeType adalah PrePaid, nilai berikut dikembalikan: false: Pembayaran otomatis dinonaktifkan. Setelah Pesanan dibuat, buka Pusat Pesanan untuk menyelesaikan pembayaran. true: Pembayaran otomatis diaktifkan. Pesanan dibayar secara otomatis. Ketika nilai InstanceChargeType adalah PostPaid, nilai kosong dikembalikan.	false
Spec	string	Spesifikasi instans Internet NAT gerbang. Ketika InternetChargeType adalah PayBySpec, nilai berikut dikembalikan: Small: kecil. Middle: Menengah. Large: Tingkat Tinggi. Ketika InternetChargeType adalah PayByLcu, nilai kosong dikembalikan.	Small
InstanceChargeType	string	Metode penagihan instans NAT gerbang. Nilai valid: PostPaid (pay-as-you-go).	PostPaid
PrivateInfo	object	Informasi jaringan pribadi instans NAT gerbang.
MaxBandwidth	integer	Nilai bandwidth maksimum. Unit: Mbit/s.	5120
VswitchId	string	ID vSwitch tempat instans NAT gerbang berada.	vsw-bp1s2laxhdf9ayjbo***
PrivateIpAddress	string	Alamat IP pribadi.	192.168.XX.XX
IzNo	string	Zona tempat instans NAT gerbang berada.	cn-qingdao-b
EniInstanceId	string	ID instans pengontrol antarmuka jaringan (NIC) elastic network interfaces (ENIs).	eni-bp1cmgtoaka8vfyg****
DeletionProtectionInfo	object	Informasi perlindungan penghapusan.
Enabled	boolean	Apakah perlindungan penghapusan diaktifkan. true: Perlindungan penghapusan diaktifkan. false: Perlindungan penghapusan dinonaktifkan.	true
IpList	array<object>	Daftar elastic IP addresses (EIPs) yang terkait dengan Internet NAT gerbang.
	object	Daftar elastic IP addresses (EIPs) yang terkait dengan Internet NAT gerbang.
UsingStatus	string	Status asosiasi EIP yang terikat pada instans Internet NAT gerbang. idle: EIP tidak terkait dengan Entri SNAT atau Entri DNAT. UsedBySnatTable: EIP terkait dengan Entri SNAT. UsedByForwardTable: EIP terkait dengan Entri DNAT.	idle
IpAddress	string	Alamat IP EIP.	116.33.XX.XX
AllocationId	string	ID instans EIP.	eip-bp13e9i2qst4g6jzi****
PrivateLinkEnabled	boolean	Apakah konektivitas pribadi didukung. Nilai valid: true: Konektivitas pribadi didukung. false: Konektivitas pribadi tidak didukung.	true
PrivateLinkMode	string	Mode konversi layanan konektivitas pribadi. Nilai valid: FullNat: Mode FULLNAT. Geneve: Mode Geneve.	FullNat
EnableSessionLog	boolean	Apakah pencatatan log Sesi diaktifkan. Nilai valid: true: Pencatatan log Sesi diaktifkan. false: Pencatatan log Sesi dinonaktifkan.	true
LogDelivery	object	Informasi konfigurasi log Sesi.
LogDeliveryType	string	Jenis tujuan untuk Pengiriman log Sesi. Nilai valid: sls: Alibaba Cloud Simple Log Service (SLS).	sls
LogDestination	string	Alamat tujuan tempat log Sesi ditulis.	acs:log:cn-hangzhou:0000:project/nat_session_log_project/logstore/Sesi_log_test
DeliveryStatus	string	Status penulisan log Sesi. Nilai valid: Succsess: Berhasil. Failure: Gagal.	Failure
DeliverLogsErrorMessage	string	Paket error untuk kegagalan penulisan log Sesi.	LogStoreNotExist: logstore session_log_test does not exist
AccessMode	object	Mode akses untuk akses balik ke VPC NAT gateway.
ModeValue	string	Nilai mode akses. Nilai valid: route: Mode entri rute. tunnel: Mode saluran data.	route
TunnelType	string	Tipe mode saluran data. Nilai valid: geneve: Tipe Geneve.	geneve
AvailabilityMode	string

Contoh

Respons sukses

JSONformat

{
  "VpcId": "vpc-bp15zckdt37pq72z****",
  "CreationTime": "2021-12-08T12:20:20Z",
  "Status": "Available",
  "NatType": "Enhanced",
  "NetworkType": "internet",
  "RegionId": "cn-qingdao",
  "EcsMetricEnabled": true,
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
  "Description": "NAT",
  "ExpiredTime": "2021-12-26T12:20:20Z",
  "ResourceGroupId": "rg-bp67acfmxazb4ph****",
  "NatGatewayId": "ngw-bp1047e2d4z7kf2ki****",
  "BusinessStatus": "Normal",
  "Name": "abc",
  "ForwardTable": {
    "ForwardTableId": "ftb-uf6gj3mhsg94qsqst****",
    "ForwardEntryCount": 1
  },
  "SnatTable": {
    "SnatEntryCount": 1,
    "SnatTableId": "stb-SnatTableIds****"
  },
  "FullNatTable": {
    "FullNatEntryCount": 1,
    "FullNatTableId": "fulltb-gw88z7hhlv43rmb26****"
  },
  "BillingConfig": {
    "InternetChargeType": "PayBySpec",
    "AutoPay": "false",
    "Spec": "Small",
    "InstanceChargeType": "PostPaid"
  },
  "PrivateInfo": {
    "MaxBandwidth": 5120,
    "VswitchId": "vsw-bp1s2laxhdf9ayjbo***",
    "PrivateIpAddress": "192.168.XX.XX",
    "IzNo": "cn-qingdao-b",
    "EniInstanceId": "eni-bp1cmgtoaka8vfyg****"
  },
  "DeletionProtectionInfo": {
    "Enabled": true
  },
  "IpList": [
    {
      "UsingStatus": "idle",
      "IpAddress": "116.33.XX.XX",
      "AllocationId": "eip-bp13e9i2qst4g6jzi****"
    }
  ],
  "PrivateLinkEnabled": true,
  "PrivateLinkMode": "FullNat",
  "EnableSessionLog": true,
  "LogDelivery": {
    "LogDeliveryType": "sls",
    "LogDestination": "acs:log:cn-hangzhou:0000:project/nat_session_log_project/logstore/session_log_test",
    "DeliveryStatus": "Failure",
    "DeliverLogsErrorMessage": "LogStoreNotExist: logstore session_log_test does not exist"
  },
  "AccessMode": {
    "ModeValue": "route",
    "TunnelType": "geneve"
  },
  "AvailabilityMode": ""
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.