Todos os produtos
Search
Central de documentação

NAT Gateway:GetNatGatewayAttribute

Última atualização: Oct 15, 2026

Consulta os detalhes de uma instância de NAT gateway.

Descrição da operação

Esta operação consulta os detalhes de um NAT gateway de Internet ou de um NAT gateway de VPC. O termo "NAT gateway" neste tópico refere-se a ambos os tipos, salvo indicação em contrário.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região do NAT gateway.

Você pode chamar a operação DescribeRegions para consultar os IDs de região.

cn-qingdao

NatGatewayId

string

Sim

O ID da instância do NAT gateway.

ngw-bp1b0lic8uz4r6vf2****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

VpcId

string

O ID da VPC à qual o NAT gateway pertence.

vpc-bp15zckdt37pq72z****

CreationTime

string

A hora em que o NAT gateway foi criado. A hora segue o padrão ISO 8601 no formato AAAA-MM-DDThh:mm:ssZ.

2021-12-08T12:20:20Z

Status

string

O status do NAT gateway. Valores válidos:

  • Creating: O NAT gateway está sendo criado. A criação de um NAT gateway é uma operação assíncrona. O NAT gateway permanece no estado Creating até ser criado.

  • Available: O NAT gateway está disponível. Este é um estado estável após a criação do NAT gateway.

  • Modifying: O NAT gateway está sendo modificado. A modificação das especificações de um NAT gateway é uma operação assíncrona. O NAT gateway permanece no estado Modifying até ser modificado.

  • Deleting: O NAT gateway está sendo excluído. A exclusão de um NAT gateway é uma operação assíncrona. O NAT gateway permanece no estado Deleting até ser excluído.

  • Converting: O NAT gateway está sendo atualizado. A atualização de um NAT gateway padrão para um NAT gateway aprimorado é uma operação assíncrona. O NAT gateway permanece no estado Converting até ser atualizado.

Available

NatType

string

O tipo do NAT gateway de Internet. O valor é Enhanced, que indica um NAT gateway aprimorado.

Enhanced

NetworkType

string

O tipo do NAT gateway. Valores válidos:

  • internet: NAT gateway de Internet.

  • intranet: NAT gateway de VPC.

internet

RegionId

string

O ID da região do NAT gateway.

cn-qingdao

EcsMetricEnabled

boolean

Indica se o recurso de monitoramento de tráfego do gateway está ativado. Valores válidos:

  • true: O recurso de monitoramento de tráfego do gateway está ativado.

  • false: O recurso de monitoramento de tráfego do gateway está desativado.

true

RequestId

string

O ID da solicitação.

4EC47282-1B74-4534-BD0E-403F3EE64CAF

Description

string

A descrição do NAT gateway.

NAT

ExpiredTime

string

A hora de expiração do NAT gateway. A hora segue o padrão ISO 8601 no formato AAAA-MM-DDThh:mm:ssZ. A hora é exibida em UTC.

2021-12-26T12:20:20Z

ResourceGroupId

string

O ID do grupo de recursos.

rg-bp67acfmxazb4ph****

NatGatewayId

string

O ID do NAT gateway.

ngw-bp1047e2d4z7kf2ki****

BusinessStatus

string

O status do serviço do NAT gateway. Valores válidos:

  • Normal: O NAT gateway está funcionando normalmente.

  • FinancialLocked: O NAT gateway está bloqueado devido a um pagamento em atraso.

Normal

Name

string

O nome do NAT gateway.

abc

ForwardTable

object

As informações sobre a tabela DNAT.

ForwardTableId

string

O ID da tabela DNAT.

ftb-uf6gj3mhsg94qsqst****

ForwardEntryCount

integer

O número de entradas DNAT.

1

SnatTable

object

As informações sobre a tabela SNAT.

SnatEntryCount

integer

O número de entradas SNAT.

1

SnatTableId

string

O ID da tabela SNAT.

stb-SnatTableIds****

FullNatTable

object

As informações sobre a tabela FULLNAT.

FullNatEntryCount

integer

O número de entradas FULLNAT.

1

FullNatTableId

string

O ID da tabela FULLNAT.

fulltb-gw88z7hhlv43rmb26****

BillingConfig

object

A configuração de cobrança.

InternetChargeType

string

O tipo de cobrança da instância do NAT gateway. Valores válidos:

  • PayBySpec: cobrança por especificações definidas.

  • PayByLcu: cobrança por uso.

PayBySpec

AutoPay

string

Indica se o pagamento automático está ativado. Se o parâmetro InstanceChargeType estiver definido como PrePaid, os seguintes valores serão retornados:

  • false: O pagamento automático está desativado. Após a geração de um pedido, você deve concluir o pagamento no User Center.

  • true: O pagamento automático está ativado. O pedido é pago automaticamente.

Se o parâmetro InstanceChargeType estiver definido como PostPaid, este parâmetro ficará vazio.

false

Spec

string

A especificação do NAT gateway de Internet. Se o parâmetro InternetChargeType estiver definido como PayBySpec, os seguintes valores serão retornados:

  • Small: pequeno.

  • Middle: médio.

  • Large: grande. Se o parâmetro InternetChargeType estiver definido como PayByLcu, este parâmetro ficará vazio.

Small

InstanceChargeType

string

O método de cobrança do NAT gateway. Valor válido: PostPaid (pós-pago).

PostPaid

PrivateInfo

object

As informações de rede privada sobre o NAT gateway.

MaxBandwidth

integer

A largura de banda máxima. Unidade: Mbit/s.

5120

VswitchId

string

O ID do vSwitch ao qual o NAT gateway pertence.

vsw-bp1s2laxhdf9ayjbo***

PrivateIpAddress

string

O endereço IP privado.

192.168.XX.XX

IzNo

string

A zona à qual o NAT gateway pertence.

cn-qingdao-b

EniInstanceId

string

O ID da instância do controlador de interface de rede elástica (NIC).

eni-bp1cmgtoaka8vfyg****

DeletionProtectionInfo

object

As informações de proteção contra exclusão.

Enabled

boolean

Indica se a proteção contra exclusão está ativada. Valores válidos:

  • true: A proteção contra exclusão está ativada.

  • false: A proteção contra exclusão está desativada.

true

IpList

array<object>

Os endereços IP elásticos (EIPs) associados ao NAT gateway de Internet.

object

Os endereços IP elásticos (EIPs) associados ao NAT gateway de Internet.

UsingStatus

string

O status de associação do EIP associado ao NAT gateway de Internet. Valores válidos:

  • idle: O EIP não está associado a uma entrada SNAT ou a uma entrada DNAT.

  • UsedBySnatTable: O EIP está associado a uma entrada SNAT.

  • UsedByForwardTable: O EIP está associado a uma entrada DNAT.

idle

IpAddress

string

O endereço IP do EIP.

116.33.XX.XX

AllocationId

string

O ID da instância do EIP.

eip-bp13e9i2qst4g6jzi****

PrivateLinkEnabled

boolean

Indica se há suporte para PrivateLink. Valores válidos:

  • true: Há suporte para PrivateLink.

  • false: Não há suporte para PrivateLink.

true

PrivateLinkMode

string

O modo de tradução do serviço PrivateLink. Valores válidos:

  • FullNat: modo FULLNAT.

  • Geneve: modo Geneve.

FullNat

EnableSessionLog

boolean

Indica se o recurso de log de sessão está ativado. Valores válidos:

  • true: O recurso de log de sessão está ativado.

  • false: O recurso de log de sessão está desativado.

true

LogDelivery

object

A configuração de log de sessão.

LogDeliveryType

string

O tipo de destino da entrega de log de sessão. Valor válido:

  • sls: Simple Log Service.

sls

LogDestination

string

O endereço de destino para o qual o log de sessão é entregue.

acs:log:cn-hangzhou:0000:project/nat_session_log_project/logstore/session_log_test

DeliveryStatus

string

O status de entrega do log de sessão. Valores válidos:

  • Succsess: A entrega foi bem-sucedida.

  • Failure: A entrega falhou.

Failure

DeliverLogsErrorMessage

string

A mensagem de erro retornada quando a entrega do log de sessão falha.

LogStoreNotExist: logstore session_log_test does not exist

AccessMode

object

O modo de acesso para acesso reverso ao NAT gateway de VPC.

ModeValue

string

O modo de acesso. Valores válidos:

  • route: modo de rota.

  • tunnel: modo de túnel.

route

TunnelType

string

O tipo de modo de túnel. Valor válido:

  • geneve: Geneve.

geneve

AvailabilityMode

string

O tipo de recuperação de desastres do NAT gateway. Valores válidos:

  • CrossAZ: recuperação de desastres entre zonas.

  • SingleAZ: recuperação de desastres de zona única.

CrossAZ

Exemplos

Resposta de sucesso

JSON formato

{
  "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": "CrossAZ"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.