Tous les produits
Search
Centre de documentation

NAT Gateway:GetNatGatewayAttribute

Dernière mise à jour :Oct 15, 2026

Consulte les détails d'une instance de passerelle NAT.

Description de l'opération

Cette opération consulte les détails d'une passerelle NAT Internet ou d'une passerelle NAT VPC. Le terme « passerelle NAT » dans cette rubrique fait référence aux deux types, sauf indication contraire.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

RegionId

string

Oui

L'identifiant de la région de la passerelle NAT.

Vous pouvez appeler l'opération DescribeRegions pour obtenir les identifiants de région.

cn-qingdao

NatGatewayId

string

Oui

L'identifiant de l'instance de la passerelle NAT.

ngw-bp1b0lic8uz4r6vf2****

Éléments de réponse

Élément

Type

Description

Exemple

object

VpcId

string

L'identifiant du VPC auquel la passerelle NAT appartient.

vpc-bp15zckdt37pq72z****

CreationTime

string

L'heure de création de la passerelle NAT. L'heure suit la norme ISO 8601 au format AAAA-MM-JJThh:mm:ssZ.

2021-12-08T12:20:20Z

Status

string

L'état de la passerelle NAT. Valeurs valides :

  • Creating : la passerelle NAT est en cours de création. La création d'une passerelle NAT est une opération asynchrone. La passerelle NAT reste dans l'état Creating jusqu'à sa création.

  • Available : la passerelle NAT est disponible. Il s'agit d'un état stable après la création de la passerelle NAT.

  • Modifying : la passerelle NAT est en cours de modification. La modification des spécifications d'une passerelle NAT est une opération asynchrone. La passerelle NAT reste dans l'état Modifying jusqu'à sa modification.

  • Deleting : la passerelle NAT est en cours de suppression. La suppression d'une passerelle NAT est une opération asynchrone. La passerelle NAT reste dans l'état Deleting jusqu'à sa suppression.

  • Converting : la passerelle NAT est en cours de mise à niveau. La mise à niveau d'une passerelle NAT standard vers une passerelle NAT améliorée est une opération asynchrone. La passerelle NAT reste dans l'état Converting jusqu'à sa mise à niveau.

Available

NatType

string

Le type de la passerelle NAT Internet. La valeur est Enhanced, ce qui indique une passerelle NAT améliorée.

Enhanced

NetworkType

string

Le type de la passerelle NAT. Valeurs valides :

  • internet : passerelle NAT Internet.

  • intranet : passerelle NAT VPC.

internet

RegionId

string

L'identifiant de la région de la passerelle NAT.

cn-qingdao

EcsMetricEnabled

boolean

Indique si la fonctionnalité de surveillance du trafic de la passerelle est activée. Valeurs valides :

  • true : la fonctionnalité de surveillance du trafic de la passerelle est activée.

  • false : la fonctionnalité de surveillance du trafic de la passerelle est désactivée.

true

RequestId

string

L'identifiant de la requête.

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

Description

string

La description de la passerelle NAT.

NAT

ExpiredTime

string

L'heure d'expiration de la passerelle NAT. L'heure suit la norme ISO 8601 au format AAAA-MM-JJThh:mm:ssZ. L'heure est affichée en UTC.

2021-12-26T12:20:20Z

ResourceGroupId

string

L'identifiant du groupe de ressources.

rg-bp67acfmxazb4ph****

NatGatewayId

string

L'identifiant de la passerelle NAT.

ngw-bp1047e2d4z7kf2ki****

BusinessStatus

string

L'état du service de la passerelle NAT. Valeurs valides :

  • Normal : la passerelle NAT fonctionne normalement.

  • FinancialLocked : la passerelle NAT est verrouillée en raison d'un paiement en retard.

Normal

Name

string

Le nom de la passerelle NAT.

abc

ForwardTable

object

Les informations sur la table DNAT.

ForwardTableId

string

L'identifiant de la table DNAT.

ftb-uf6gj3mhsg94qsqst****

ForwardEntryCount

integer

Le nombre d'entrées DNAT.

1

SnatTable

object

Les informations sur la table SNAT.

SnatEntryCount

integer

Le nombre d'entrées SNAT.

1

SnatTableId

string

L'identifiant de la table SNAT.

stb-SnatTableIds****

FullNatTable

object

Les informations sur la table FULLNAT.

FullNatEntryCount

integer

Le nombre d'entrées FULLNAT.

1

FullNatTableId

string

L'identifiant de la table FULLNAT.

fulltb-gw88z7hhlv43rmb26****

BillingConfig

object

La configuration de facturation.

InternetChargeType

string

Le type de facturation de l'instance de passerelle NAT. Valeurs valides :

  • PayBySpec : facturation selon des spécifications définies.

  • PayByLcu : facturation à l'usage.

PayBySpec

AutoPay

string

Indique si le paiement automatique est activé. Si le paramètre InstanceChargeType est défini sur PrePaid, les valeurs suivantes sont renvoyées :

  • false : le paiement automatique est désactivé. Une fois la commande générée, vous devez effectuer le paiement dans le centre utilisateur.

  • true : le paiement automatique est activé. La commande est payée automatiquement.

Si le paramètre InstanceChargeType est défini sur PostPaid, ce paramètre est laissé vide.

false

Spec

string

La spécification de la passerelle NAT Internet. Si le paramètre InternetChargeType est défini sur PayBySpec, les valeurs suivantes sont renvoyées :

  • Small : petite.

  • Middle : moyenne.

  • Large : grande. Si le paramètre InternetChargeType est défini sur PayByLcu, ce paramètre est laissé vide.

Small

InstanceChargeType

string

La méthode de facturation de la passerelle NAT. Valeur valide : PostPaid (paiement à l'usage).

PostPaid

PrivateInfo

object

Les informations sur le réseau privé de la passerelle NAT.

MaxBandwidth

integer

La bande passante maximale. Unité : Mbit/s.

5120

VswitchId

string

L'identifiant du vSwitch auquel la passerelle NAT appartient.

vsw-bp1s2laxhdf9ayjbo***

PrivateIpAddress

string

L'adresse IP privée.

192.168.XX.XX

IzNo

string

La zone à laquelle la passerelle NAT appartient.

cn-qingdao-b

EniInstanceId

string

L'identifiant de l'instance de l'interface réseau élastique (NIC).

eni-bp1cmgtoaka8vfyg****

DeletionProtectionInfo

object

Les informations sur la protection contre la suppression.

Enabled

boolean

Indique si la protection contre la suppression est activée. Valeurs valides :

  • true : la protection contre la suppression est activée.

  • false : la protection contre la suppression est désactivée.

true

IpList

array<object>

Les adresses IP élastiques (EIP) associées à la passerelle NAT Internet.

object

Les adresses IP élastiques (EIP) associées à la passerelle NAT Internet.

UsingStatus

string

L'état d'association de l'EIP associée à la passerelle NAT Internet. Valeurs valides :

  • idle : l'EIP n'est associée à aucune entrée SNAT ou DNAT.

  • UsedBySnatTable : l'EIP est associée à une entrée SNAT.

  • UsedByForwardTable : l'EIP est associée à une entrée DNAT.

idle

IpAddress

string

L'adresse IP de l'EIP.

116.33.XX.XX

AllocationId

string

L'identifiant de l'instance de l'EIP.

eip-bp13e9i2qst4g6jzi****

PrivateLinkEnabled

boolean

Indique si PrivateLink est pris en charge. Valeurs valides :

  • true : PrivateLink est pris en charge.

  • false : PrivateLink n'est pas pris en charge.

true

PrivateLinkMode

string

Le mode de traduction du service PrivateLink. Valeurs valides :

  • FullNat : mode FULLNAT.

  • Geneve : mode Geneve.

FullNat

EnableSessionLog

boolean

Indique si la fonctionnalité de journal de session est activée. Valeurs valides :

  • true : la fonctionnalité de journal de session est activée.

  • false : la fonctionnalité de journal de session est désactivée.

true

LogDelivery

object

La configuration du journal de session.

LogDeliveryType

string

Le type de destination de la livraison du journal de session. Valeur valide :

  • sls : Simple Log Service.

sls

LogDestination

string

L'adresse de destination à laquelle le journal de session est livré.

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

DeliveryStatus

string

L'état de livraison du journal de session. Valeurs valides :

  • Succsess : la livraison a réussi.

  • Failure : la livraison a échoué.

Failure

DeliverLogsErrorMessage

string

Le message d'erreur renvoyé lorsque la livraison du journal de session échoue.

LogStoreNotExist: logstore session_log_test does not exist

AccessMode

object

Le mode d'accès pour l'accès inverse à la passerelle NAT VPC.

ModeValue

string

Le mode d'accès. Valeurs valides :

  • route : mode routage.

  • tunnel : mode tunnel.

route

TunnelType

string

Le type de mode tunnel. Valeur valide :

  • geneve : Geneve.

geneve

AvailabilityMode

string

Le type de reprise sur sinistre de la passerelle NAT. Valeurs valides :

  • CrossAZ : reprise sur sinistre interzones.

  • SingleAZ : reprise sur sinistre monozone.

CrossAZ

Exemples

JSON format

{
  "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 : le logstore session_log_test n'existe pas"
  },
  "AccessMode": {
    "ModeValue": "route",
    "TunnelType": "geneve"
  },
  "AvailabilityMode": "CrossAZ"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

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

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.