Tous les produits
Search
Centre de documentation

:DescribeForwardTableEntries

Dernière mise à jour :Aug 19, 2026

Interroge les entrées DNAT.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

DescribeForwardTableEntries

Opération à effectuer. Définissez la valeur sur DescribeForwardTableEntries.

RegionId

String

Oui

cn-hangzhou

ID de région de la passerelle NAT.

Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.

ForwardTableId

String

Non

ftb-bp1mbjubq34hlcqpa****

ID de la table DNAT.

Remarque

Vous devez définir au moins l'un des paramètres ForwardTableId et NatGatewayId.

ForwardEntryId

String

Non

fwd-8vbn3bc8roygjp0gy****

ID de l'entrée DNAT.

ExternalIp

String

Non

116.28.XX.XX

  • Adresses IP élastiques (EIP) accessibles via Internet lors de l'interrogation des entrées DNAT des passerelles NAT Internet.

  • Adresses IP NAT accessibles par les réseaux externes lors de l'interrogation des entrées DNAT des passerelles NAT Virtual Private Cloud (VPC).

ExternalPort

String

Non

8080

  • Port externe ou plage de ports utilisé pour la redirection de port lors de l'interrogation des entrées DNAT des passerelles NAT Internet.

    • Valeurs valides : 1 à 65535.

    • Pour interroger une plage de ports, séparez le premier et le dernier port par une barre oblique (/), par exemple 10/20.

    • Si vous définissez ExternalPort sur une plage de ports, vous devez également définir InternalPort sur une plage de ports, et le nombre de ports spécifiés par ces paramètres doit être identique. Par exemple, si vous définissez ExternalPort sur 10/20, vous pouvez définir InternalPort sur 80/90.

  • Port utilisé lorsque l'adresse IP NAT est accessible par les réseaux externes lors de l'interrogation des entrées DNAT des passerelles NAT VPC. Valeurs valides : 1 à 65535.

InternalIp

String

Non

192.168.XX.XX

Adresse IP privée.

  • Adresse IP privée de l'instance ECS qui utilise les entrées DNAT pour communiquer avec Internet lors de l'interrogation des entrées DNAT des passerelles NAT Internet.

  • Adresse IP privée qui utilise les entrées DNAT pour la communication lors de l'interrogation des entrées DNAT des passerelles NAT VPC.

InternalPort

String

Non

80

  • Port interne ou plage de ports utilisé pour la redirection de port lors de l'interrogation des entrées DNAT des passerelles NAT Internet. Valeurs valides : 1 à 65535.

  • Port de l'instance ECS de destination à mapper lors de l'interrogation des entrées DNAT des passerelles NAT VPC. Valeurs valides : 1 à 65535.

IpProtocol

String

Non

TCP

Protocole. Valeurs valides :

  • TCP : La passerelle NAT transfère les paquets TCP.

  • UDP : La passerelle NAT transfère les paquets UDP.

  • Any : La passerelle NAT transfère les paquets de tous les protocoles.

ForwardEntryName

String

Non

ForwardEntry-1

Nom de l'entrée DNAT.

Le nom doit comporter entre 2 et 128 caractères et peut contenir des chiffres, des points (.), des traits de soulignement (_) et des tirets (-). Il doit commencer par une lettre.

PageNumber

Integer

Non

1

Numéro de page de la page à renvoyer. Valeur par défaut : 1.

PageSize

Integer

Non

10

Nombre d'entrées à renvoyer sur chaque page. Valeur maximale : 50. Valeur par défaut : 10.

NatGatewayId

String

Non

ngw-bp1uewa15k4iy5770****

ID de la passerelle NAT.

Remarque

Vous devez définir au moins l'un des paramètres ForwardTableId et NatGatewayId.

Paramètres de réponse

Paramètre

Type

Exemple

Description

PageSize

Integer

10

Nombre d'entrées renvoyées par page.

RequestId

String

A6C4A8B1-7561-4509-949C-20DEB40D71E6

ID de la requête.

PageNumber

Integer

1

Numéro de page de la page renvoyée.

TotalCount

Integer

5

Nombre d'entrées renvoyées.

ForwardTableEntries

Array of ForwardTableEntry

Détails des entrées DNAT.

ForwardTableEntry

Status

String

Available

État de l'entrée DNAT. Valeurs valides :

  • Pending : en cours de création ou de modification

  • Available : disponible

  • Deleting : en cours de suppression

ForwardEntryId

String

fwd-119smw5tk****

ID de l'entrée DNAT.

InternalIp

String

192.168.XX.XX

Adresse IP privée.

  • Adresse IP privée de l'instance ECS qui utilise les entrées DNAT pour communiquer avec Internet lors de l'interrogation des entrées DNAT des passerelles NAT Internet.

  • Adresse IP privée qui utilise les entrées DNAT lors de l'interrogation des entrées DNAT des passerelles NAT VPC.

InternalPort

String

25

  • Port interne ou plage de ports utilisé pour la redirection de port lors de l'interrogation des entrées DNAT des passerelles NAT Internet.

  • Port de l'instance ECS de destination à mapper lors de l'interrogation des entrées DNAT des passerelles NAT VPC.

ForwardEntryName

String

ForwardEntry-1

Nom de l'entrée DNAT.

ForwardTableId

String

ftb-11tc6xgmv****

ID de la table DNAT à laquelle appartient l'entrée DNAT.

IpProtocol

String

TCP

Protocole. Valeurs valides :

  • TCP : La passerelle NAT transfère les paquets TCP.

  • UDP : La passerelle NAT transfère les paquets UDP.

  • Any : La passerelle NAT transfère les paquets de tous les protocoles.

ExternalPort

String

80

  • Port externe ou plage de ports utilisé pour la redirection de port lors de l'interrogation des entrées DNAT des passerelles NAT Internet.

  • Port utilisé lorsque l'adresse IP NAT est accessible par les réseaux externes lors de l'interrogation des entrées DNAT des passerelles NAT VPC.

ExternalIp

String

139.79.XX.XX

  • EIP accessibles via Internet lors de l'interrogation des entrées DNAT des passerelles NAT Internet.

  • Adresses IP NAT accessibles par les réseaux externes lors de l'interrogation des entrées DNAT des passerelles NAT VPC.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=DescribeForwardTableEntries
&RegionId=cn-hangzhou
&ForwardTableId=ftb-bp1mbjubq34hlcqpa****
&ForwardEntryId=fwd-8vbn3bc8roygjp0gy****
&ExternalIp=116.28.XX.XX
&ExternalPort=8080
&InternalIp=192.168.XX.XX	
&InternalPort=80
&IpProtocol=TCP
&ForwardEntryName=ForwardEntry-1
&PageNumber=1
&PageSize=10
&NatGatewayId=ngw-bp1uewa15k4iy5770****
&Common request parameters

Exemples de réponses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeForwardTableEntriesResponse>
    <PageSize>10</PageSize>
    <RequestId>A6C4A8B1-7561-4509-949C-20DEB40D71E6</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>5</TotalCount>
    <ForwardTableEntries>
        <Status>Available</Status>
        <ForwardEntryId>fwd-119smw5tk****</ForwardEntryId>
        <InternalIp>192.168.XX.XX</InternalIp>
        <InternalPort>25</InternalPort>
        <ForwardEntryName>ForwardEntry-1</ForwardEntryName>
        <ForwardTableId>ftb-11tc6xgmv****</ForwardTableId>
        <IpProtocol>TCP</IpProtocol>
        <ExternalPort>80</ExternalPort>
        <ExternalIp>139.79.XX.XX</ExternalIp>
    </ForwardTableEntries>
</DescribeForwardTableEntriesResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageSize" : 10,
  "RequestId" : "A6C4A8B1-7561-4509-949C-20DEB40D71E6",
  "PageNumber" : 1,
  "TotalCount" : 5,
  "ForwardTableEntries" : [ {
    "Status" : "Available",
    "ForwardEntryId" : "fwd-119smw5tk****",
    "InternalIp" : "192.168.XX.XX",
    "InternalPort" : "25",
    "ForwardEntryName" : "ForwardEntry-1",
    "ForwardTableId" : "ftb-11tc6xgmv****",
    "IpProtocol" : "TCP",
    "ExternalPort" : "80",
    "ExternalIp" : "139.79.XX.XX"
  } ]
}

Codes d'erreur

HttpCode

Code d'erreur

Message d'erreur

Description

400

IncorretForwardEntryStatus

Some Forward entry status blocked this operation..

Le message d'erreur indique que vous n'êtes pas autorisé à effectuer l'opération spécifiée. Le message d'erreur indique qu'une ou plusieurs entrées DNAT de la table DNAT sont dans l'état Pending ou Modifying.

404

InvalidRegionId.NotFound

The specified RegionId does not exist in our records.

Le message d'erreur indique que l'ID de région spécifié n'existe pas.

404

InvalidForwardTableId.NotFound

Specified forwardTableId does not exist

Le message d'erreur indique que la table DNAT spécifiée n'existe pas. Vérifiez la valeur du paramètre et réessayez.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.