全部產品
Search
文件中心

NAT Gateway:GetNatGatewayAttribute - 查看單個NAT Gateway執行個體詳細資料

更新時間:Apr 29, 2026

調用GetNatGatewayAttribute介面查詢單個NAT Gateway執行個體的資訊。

介面說明

本介面可以查詢單個公網 NAT Gateway或 VPC NAT Gateway的資訊,文中出現的“NAT Gateway”不做具體的區分。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

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的狀態。取值:

  • Creating:建立中。建立 NAT Gateway是非同步作業,在建立完成之前是 Creating 狀態。

  • Available:可用。NAT Gateway建立完成後的狀態,是穩定點。

  • Modifying:修改中。變更配置 NAT Gateway是非同步作業,在變更配置的過程中是 Modifying 狀態。

  • Deleting:刪除中。刪除 NAT Gateway是非同步作業,在刪除的過程中是 Deleting 狀態。

  • Converting:轉換中。普通型 NAT Gateway轉換到增強型 NAT Gateway是非同步作業,在轉換過程中是 Converting 狀態。

Available

NatType

string

公網 NAT Gateway的類型,當前取值為 Enhanced,即增強型 NAT Gateway。

Enhanced

NetworkType

string

NAT Gateway的類型。取值:

  • internet:公網 NAT Gateway。

  • intranet:VPC NAT Gateway。

internet

RegionId

string

NAT Gateway執行個體所在的地區 ID。

cn-qingdao

EcsMetricEnabled

boolean

是否開啟了網關流量監控功能。取值:

  • true:開啟了網關流量監控功能。

  • false:未開啟網關流量監控功能。

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:正常。

  • FinancialLocked:欠費鎖定狀態。

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:按固定規格計費。

  • PayByLcu:按使用量計費。

PayBySpec

AutoPay

string

是否自動付費,當 InstanceChargeType 參數的值為 PrePaid 時,返回以下值:

  • false:不開啟自動付費,產生訂單後需要到訂單中心完成支付。

  • true:開啟自動付費,自動支付訂單。

InstanceChargeType 參數的值為 PostPaid 時,傳回值為空白。

false

Spec

string

公網 NAT Gateway執行個體的規格,且當 InternetChargeTypePayBySpec 時,返回以下值:

  • Small:小型。

  • Middle:中型。

  • Large:大型。 當 InternetChargeTypePayByLcu 時,傳回值為空白。

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:開啟了刪除保護功能。

  • false:未開啟刪除保護功能。

true

IpList

array<object>

公網 NAT Gateway綁定的彈性公網 IP 列表。

object

公網 NAT Gateway綁定的彈性公網 IP 列表。

UsingStatus

string

公網 NAT Gateway執行個體綁定的彈性公網 IP 的關聯關係。

  • idle:彈性公網 IP 未關聯 SNAT 條目或 DNAT 條目。

  • UsedBySnatTable:彈性公網 IP 已關聯 SNAT 條目。

  • UsedByForwardTable:彈性公網 IP 已關聯 DNAT 條目。

idle

IpAddress

string

彈性公網 IP 的地址。

116.33.XX.XX

AllocationId

string

彈性公網 IP 的執行個體 ID。

eip-bp13e9i2qst4g6jzi****

PrivateLinkEnabled

boolean

是否支援私網串連,取值:

  • true:支援私網串連。

  • false:不支援私網串連。

true

PrivateLinkMode

string

私網串連服務轉化模式,取值:

  • FullNat:使用 FULLNAT 模式。

  • Geneve:使用 Geneve 模式。

FullNat

EnableSessionLog

boolean

是否開啟會話日誌,取值:

  • true:已開啟會話日誌。

  • false:已關閉會話日誌。

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

會話日誌寫入狀態。取值:

  • Succsess:成功。

  • Failure:失敗。

Failure

DeliverLogsErrorMessage

string

會話日誌寫入失敗的錯誤資訊。

LogStoreNotExist: logstore session_log_test does not exist

AccessMode

object

反向訪問 VPC NAT Gateway的訪問模式。

ModeValue

string

訪問模式取值:

  • route:路由模式。

  • tunnel:隧道模式。

route

TunnelType

string

隧道模式類型:

  • geneve: Geneve 類型。

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.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情