Todos os produtos
Search
Central de documentação

:DescribeForwardTableEntries

Última atualização: Jul 05, 2026

Consulta entradas DNAT.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DescribeForwardTableEntries

Operação a ser executada. Defina o valor como DescribeForwardTableEntries.

RegionId

String

Sim

cn-hangzhou

ID da região do gateway NAT.

Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

ForwardTableId

String

Não

ftb-bp1mbjubq34hlcqpa****

ID da tabela DNAT.

Nota

Defina pelo menos um dos parâmetros ForwardTableId ou NatGatewayId.

ForwardEntryId

String

Não

fwd-8vbn3bc8roygjp0gy****

ID da entrada DNAT.

ExternalIp

String

Não

116.28.XX.XX

  • Endereços IP elásticos (EIPs) acessíveis pela Internet durante a consulta de entradas DNAT em gateways NAT da Internet.

  • Endereços IP NAT acessíveis por redes externas durante a consulta de entradas DNAT em gateways NAT da Virtual Private Cloud (VPC).

ExternalPort

String

Não

8080

  • Porta externa ou intervalo de portas usado para encaminhamento ao consultar entradas DNAT em gateways NAT da Internet.

    • Valores válidos: 1 a 65535.

    • Para consultar um intervalo de portas, separe a primeira e a última porta com uma barra (/), como em 10/20.

    • Se definir ExternalPort como um intervalo de portas, defina também InternalPort como um intervalo. A quantidade de portas especificada em ambos os parâmetros deve ser igual. Por exemplo, se definir ExternalPort como 10/20, poderá definir InternalPort como 80/90.

  • Porta usada quando o endereço IP NAT é acessível por redes externas durante a consulta de entradas DNAT em gateways NAT da VPC. Valores válidos: 1 a 65535.

InternalIp

String

Não

192.168.XX.XX

Endereço IP privado.

  • Endereço IP privado da instância ECS que usa entradas DNAT para comunicação com a Internet durante a consulta de entradas DNAT em gateways NAT da Internet.

  • Endereço IP privado que usa entradas DNAT para comunicação durante a consulta de entradas DNAT em gateways NAT da VPC.

InternalPort

String

Não

80

  • Porta interna ou intervalo de portas usado para encaminhamento durante a consulta de entradas DNAT em gateways NAT da Internet. Valores válidos: 1 a 65535.

  • Porta da instância ECS de destino a ser mapeada durante a consulta de entradas DNAT em gateways NAT da VPC. Valores válidos: 1 a 65535.

IpProtocol

String

Não

TCP

Protocolo. Valores válidos:

  • TCP: o gateway NAT encaminha pacotes TCP.

  • UDP: o gateway NAT encaminha pacotes UDP.

  • Any: o gateway NAT encaminha pacotes de todos os protocolos.

ForwardEntryName

String

Não

ForwardEntry-1

Nome da entrada DNAT.

O nome deve ter de 2 a 128 caracteres e pode conter dígitos, pontos (.), sublinhados (_) e hifens (-). Deve começar com uma letra.

PageNumber

Integer

Não

1

Número da página a ser retornada. Valor padrão: 1.

PageSize

Integer

Não

10

Quantidade de entradas a serem retornadas em cada página. Valor máximo: 50. Valor padrão: 10.

NatGatewayId

String

Não

ngw-bp1uewa15k4iy5770****

ID do gateway NAT.

Nota

Defina pelo menos um dos parâmetros ForwardTableId ou NatGatewayId.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

PageSize

Integer

10

Quantidade de entradas retornadas por página.

RequestId

String

A6C4A8B1-7561-4509-949C-20DEB40D71E6

ID da solicitação.

PageNumber

Integer

1

Número da página retornada.

TotalCount

Integer

5

Quantidade total de entradas retornadas.

ForwardTableEntries

Array of ForwardTableEntry

Detalhes das entradas DNAT.

ForwardTableEntry

Status

String

Available

Status da entrada DNAT. Valores válidos:

  • Pending: em criação ou modificação

  • Available: disponível

  • Deleting: em exclusão

ForwardEntryId

String

fwd-119smw5tk****

ID da entrada DNAT.

InternalIp

String

192.168.XX.XX

Endereço IP privado.

  • Endereço IP privado da instância ECS que usa entradas DNAT para comunicação com a Internet durante a consulta de entradas DNAT em gateways NAT da Internet.

  • Endereço IP privado que usa entradas DNAT durante a consulta de entradas DNAT em gateways NAT da VPC.

InternalPort

String

25

  • Porta interna ou intervalo de portas usado para encaminhamento durante a consulta de entradas DNAT em gateways NAT da Internet.

  • Porta da instância ECS de destino a ser mapeada durante a consulta de entradas DNAT em gateways NAT da VPC.

ForwardEntryName

String

ForwardEntry-1

Nome da entrada DNAT.

ForwardTableId

String

ftb-11tc6xgmv****

ID da tabela DNAT à qual a entrada pertence.

IpProtocol

String

TCP

Protocolo. Valores válidos:

  • TCP: o gateway NAT encaminha pacotes TCP.

  • UDP: o gateway NAT encaminha pacotes UDP.

  • Any: o gateway NAT encaminha pacotes de todos os protocolos.

ExternalPort

String

80

  • Porta externa ou intervalo de portas usado para encaminhamento durante a consulta de entradas DNAT em gateways NAT da Internet.

  • Porta usada quando o endereço IP NAT é acessível por redes externas durante a consulta de entradas DNAT em gateways NAT da VPC.

ExternalIp

String

139.79.XX.XX

  • EIPs acessíveis pela Internet durante a consulta de entradas DNAT em gateways NAT da Internet.

  • Endereços IP NAT acessíveis por redes externas durante a consulta de entradas DNAT em gateways NAT da VPC.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas

Formato XML

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>

Formato JSON

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"
  } ]
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

IncorretForwardEntryStatus

Some Forward entry status blocked this operation..

Mensagem de erro retornada porque você não tem autorização para executar a operação especificada ou porque uma ou mais entradas DNAT na tabela estão no estado Pending ou Modifying.

404

InvalidRegionId.NotFound

The specified RegionId does not exist in our records.

Mensagem de erro retornada porque o ID da região especificado não existe.

404

InvalidForwardTableId.NotFound

Specified forwardTableId does not exist

Mensagem de erro retornada porque a tabela DNAT especificada não existe. Verifique o valor do parâmetro e tente novamente.

Para obter uma lista de códigos de erro, visite o API Error Center.