Todos os produtos
Search
Central de documentação

:DescribeSnatTableEntries

Última atualização: Jul 05, 2026

Consulta entradas SNAT.

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 DescribeSnatTableEntries

Operação a executar. Defina o valor como DescribeSnatTableEntries.

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.

SnatTableId String Não stb-8vbczigrhop8x5u3t****

ID da tabela SNAT.

Nota Defina pelo menos um dos parâmetros SnatTableId ou NatGatewayId.
SnatEntryId String Não snat-8vbae8uqh7rjpk7d2****

ID da entrada SNAT.

SourceVSwitchId String Não vsw-3xbjkhjshjdf****

ID do vSwitch.

  • Na consulta de entradas SNAT de gateways NAT da Internet, este parâmetro especifica que instâncias do Elastic Compute Service (ECS) no vSwitch podem usar entradas SNAT para acessar a Internet.
  • Na consulta de entradas SNAT de gateways NAT de VPC, este parâmetro especifica que instâncias ECS no vSwitch podem usar entradas SNAT para acessar redes externas.
SourceCIDR String Não 116.22.XX.XX/24

Bloco CIDR de source especificado na entrada SNAT.

SnatIp String Não 116.22.XX.XX
  • Para consultas de entradas SNAT em gateways NAT da Internet, este parâmetro indica o EIP na entrada SNAT.
  • Para consultas de entradas SNAT em gateways NAT de VPC, este parâmetro indica o endereço IP NAT na entrada SNAT.
SnatEntryName String Não SnatEntry-1

Nome da entrada SNAT.

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

PageNumber Integer Não 1

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

PageSize Integer Não 10

Quantidade de entradas a retornar por 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 SnatTableId ou NatGatewayId.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
PageSize Integer 5

Quantidade de entradas retornadas por página.

RequestId String 6D7E89B1-1C5B-412B-8585-4908E222EED5

ID da solicitação.

PageNumber Integer 1

Número da página retornada.

TotalCount Integer 1

Total de entradas retornadas.

SnatTableEntries Array of SnatTableEntry

Detalhes das entradas SNAT.

SnatTableEntry
Status String Pending

Status da entrada SNAT. Valores válidos:

  • Pending: em criação ou modificação
  • Available: disponível
  • Deleting: em exclusão
SnatEntryName String SnatEntry-1

Nome da entrada SNAT.

SourceVSwitchId String vsw-3xbdsffvfgdfds****
  • Na consulta de entradas SNAT de gateways NAT da Internet, este parâmetro indica o ID do vSwitch que usa SNAT para acessar a Internet.
  • Na consulta de entradas SNAT de gateways NAT de VPC, este parâmetro indica o ID do vSwitch que usa SNAT para acessar redes externas.
SourceCIDR String 116.22.XX.XX/24

Bloco CIDR de source especificado na entrada SNAT.

SnatEntryId String snat-kmd6nv8fy****

ID da entrada SNAT.

SnatTableId String stb-gz3r3odawdgffde****

ID da tabela SNAT à qual a entrada pertence.

SnatIp String 116.22.XX.XX
  • Na consulta de entradas SNAT de gateways NAT da Internet, este parâmetro indica o EIP na entrada SNAT.
  • Na consulta de entradas SNAT de gateways NAT de VPC, este parâmetro indica o endereço IP NAT na entrada SNAT.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=DescribeSnatTableEntries
&RegionId=cn-hangzhou
&SnatTableId=stb-8vbczigrhop8x5u3t****
&SnatEntryId=snat-8vbae8uqh7rjpk7d2****
&SourceVSwitchId=vsw-3xbjkhjshjdf****
&SourceCIDR=116.22.XX.XX/24
&SnatIp=116.22.XX.XX
&SnatEntryName=SnatEntry-1
&PageNumber=1
&PageSize=10
&NatGatewayId=ngw-bp1uewa15k4iy5770****
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<DescribeSnatTableEntriesResponse>
    <PageSize>5</PageSize>
    <RequestId>6D7E89B1-1C5B-412B-8585-4908E222EED5</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>1</TotalCount>
    <SnatTableEntries>
        <Status>Pending</Status>
        <SnatEntryName>SnatEntry-1</SnatEntryName>
        <SourceVSwitchId>vsw-3xbdsffvfgdfds****</SourceVSwitchId>
        <SourceCIDR>116.22.XX.XX/24</SourceCIDR>
        <SnatEntryId>snat-kmd6nv8fy****</SnatEntryId>
        <SnatTableId>stb-gz3r3odawdgffde****</SnatTableId>
        <SnatIp>116.22.XX.XX</SnatIp>
    </SnatTableEntries>
</DescribeSnatTableEntriesResponse>

Formato JSON

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

{
  "PageSize" : 5,
  "RequestId" : "6D7E89B1-1C5B-412B-8585-4908E222EED5",
  "PageNumber" : 1,
  "TotalCount" : 1,
  "SnatTableEntries" : [ {
    "Status" : "Pending",
    "SnatEntryName" : "SnatEntry-1",
    "SourceVSwitchId" : "vsw-3xbdsffvfgdfds****",
    "SourceCIDR" : "116.22.XX.XX/24",
    "SnatEntryId" : "snat-kmd6nv8fy****",
    "SnatTableId" : "stb-gz3r3odawdgffde****",
    "SnatIp" : "116.22.XX.XX"
  } ]
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

404

InvalidRegionId.NotFound

The specified RegionId does not exist in our records.

Erro retornado porque o ID da região especificado não existe.

404

InvalidSnatTableId.NotFound

Specified SNAT table does not exist.

Erro retornado porque a tabela SNAT especificada não existe. Verifique se o ID da tabela SNAT é válido.

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