調用GetNatGatewayAttribute介面查詢單個NAT Gateway執行個體的資訊。
介面說明
本介面可以查詢單個公網 NAT Gateway或 VPC NAT Gateway的資訊,文中出現的“NAT Gateway”不做具體的區分。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RegionId |
string |
是 |
NAT Gateway所屬的地區 ID。 您可以通過調用 DescribeRegions 介面擷取地區 ID。 |
cn-qingdao |
| NatGatewayId |
string |
是 |
NAT Gateway執行個體 ID。 |
ngw-bp1b0lic8uz4r6vf2**** |
| RegionId |
string |
是 |
NAT Gateway所屬的地區 ID。 您可以通過調用 DescribeRegions 介面擷取地區 ID。 |
cn-qingdao |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| VpcId |
string |
NAT Gateway執行個體所屬 VPC 的 ID。 |
vpc-bp15zckdt37pq72z**** |
| CreationTime |
string |
NAT Gateway的建立時間。格式為:YYYY-MM-DDThh:mm:ssZ。 |
2021-12-08T12:20:20Z |
| Status |
string |
NAT Gateway的狀態。取值:
|
Available |
| NatType |
string |
公網 NAT Gateway的類型,當前取值為 Enhanced,即增強型 NAT Gateway。 |
Enhanced |
| NetworkType |
string |
NAT Gateway的類型。取值:
|
internet |
| RegionId |
string |
NAT Gateway執行個體所在的地區 ID。 |
cn-qingdao |
| EcsMetricEnabled |
boolean |
是否開啟了網關流量監控功能。取值:
|
true |
| RequestId |
string |
請求 ID。 |
4EC47282-1B74-4534-BD0E-403F3EE64CAF |
| Description |
string |
NAT Gateway執行個體的描述。 |
NAT |
| ExpiredTime |
string |
NAT Gateway執行個體的到期時間。 |
2021-12-26T12:20:20Z |
| ResourceGroupId |
string |
資源群組 ID。 |
rg-bp67acfmxazb4ph**** |
| NatGatewayId |
string |
NAT Gateway執行個體的 ID。 |
ngw-bp1047e2d4z7kf2ki**** |
| BusinessStatus |
string |
NAT Gateway的業務狀態。取值:
|
Normal |
| Name |
string |
NAT Gateway執行個體名稱。 |
abc |
| ForwardTable |
object |
DNAT 列表的資訊。 |
|
| ForwardTableId |
string |
DNAT 表的 ID。 |
ftb-uf6gj3mhsg94qsqst**** |
| ForwardEntryCount |
integer |
DNAT 條目的個數。 |
1 |
| SnatTable |
object |
SNAT 列表資訊。 |
|
| SnatEntryCount |
integer |
SANT 條目的個數。 |
1 |
| SnatTableId |
string |
SNAT 列表的 ID。 |
stb-SnatTableIds**** |
| FullNatTable |
object |
FULLNAT 列表的資訊。 |
|
| FullNatEntryCount |
integer |
FULLNAT 條目的個數。 |
1 |
| FullNatTableId |
string |
FULLNAT 表的 ID。 |
fulltb-gw88z7hhlv43rmb26**** |
| BillingConfig |
object |
賬單配置資訊。 |
|
| InternetChargeType |
string |
NAT Gateway執行個體的計費類型。取值:
|
PayBySpec |
| AutoPay |
string |
是否自動付費,當 InstanceChargeType 參數的值為 PrePaid 時,返回以下值:
當 InstanceChargeType 參數的值為 PostPaid 時,傳回值為空白。 |
false |
| Spec |
string |
公網 NAT Gateway執行個體的規格,且當 InternetChargeType 為 PayBySpec 時,返回以下值:
|
Small |
| InstanceChargeType |
string |
NAT Gateway執行個體的付費模式,取值:PostPaid(隨用隨付)。 |
PostPaid |
| PrivateInfo |
object |
NAT Gateway執行個體的私網資訊。 |
|
| MaxBandwidth |
integer |
最大頻寬值,單位為 Mbps。 |
5120 |
| VswitchId |
string |
NAT Gateway執行個體所屬的交換器 ID。 |
vsw-bp1s2laxhdf9ayjbo*** |
| PrivateIpAddress |
string |
私網 IP 位址。 |
192.168.XX.XX |
| IzNo |
string |
NAT Gateway執行個體所屬的可用性區域。 |
cn-qingdao-b |
| EniInstanceId |
string |
彈性網卡執行個體 ID。 |
eni-bp1cmgtoaka8vfyg**** |
| DeletionProtectionInfo |
object |
刪除保護資訊。 |
|
| Enabled |
boolean |
是否開啟刪除保護功能。
|
true |
| IpList |
array<object> |
公網 NAT Gateway綁定的彈性公網 IP 列表。 |
|
|
object |
公網 NAT Gateway綁定的彈性公網 IP 列表。 |
||
| UsingStatus |
string |
公網 NAT Gateway執行個體綁定的彈性公網 IP 的關聯關係。
|
idle |
| IpAddress |
string |
彈性公網 IP 的地址。 |
116.33.XX.XX |
| AllocationId |
string |
彈性公網 IP 的執行個體 ID。 |
eip-bp13e9i2qst4g6jzi**** |
| PrivateLinkEnabled |
boolean |
是否支援私網串連,取值:
|
true |
| PrivateLinkMode |
string |
私網串連服務轉化模式,取值:
|
FullNat |
| EnableSessionLog |
boolean |
是否開啟會話日誌,取值:
|
true |
| LogDelivery |
object |
會話日誌配置資訊。 |
|
| LogDeliveryType |
string |
會話日誌投遞目的類型。取值: sls,阿里雲Log Service SLS。 |
sls |
| LogDestination |
string |
會話日誌寫入目的地址。 |
acs:log:cn-hangzhou:0000:project/nat_session_log_project/logstore/session_log_test |
| DeliveryStatus |
string |
會話日誌寫入狀態。取值:
|
Failure |
| DeliverLogsErrorMessage |
string |
會話日誌寫入失敗的錯誤資訊。 |
LogStoreNotExist: logstore session_log_test does not exist |
| AccessMode |
object |
反向訪問 VPC NAT Gateway的訪問模式。 |
|
| ModeValue |
string |
訪問模式取值:
|
route |
| TunnelType |
string |
隧道模式類型:
|
geneve |
| AvailabilityMode |
string |
樣本
正常返回樣本
JSON格式
{
"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": ""
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist in our records. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。