ListNatIps - NAT Gateway: Central de Documentação do Alibaba Cloud

Consulta os endereços IP em um gateway NAT.

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 onde o gateway NAT está implantado. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	eu-central-1
NatGatewayId	string	Sim	O ID do gateway NAT.	ngw-gw8v16wgvtq26vh59****
NatIpCidr	string	Não	O bloco CIDR ao qual o endereço IP pertence.	192.168.0.0/24
DryRun	boolean	Não	Especifica se deve apenas pré-verificar a solicitação. Valores válidos: true: Verifica a solicitação de API. Os endereços IP não são consultados. O sistema verifica os parâmetros obrigatórios, a sintaxe da solicitação e os limites. Se a solicitação não passar na pré-verificação, a mensagem de erro correspondente será retornada. Se a solicitação passar na pré-verificação, o código de erro DryRunOperation será retornado. false (padrão): Envia a solicitação. Se a solicitação passar na pré-verificação, um código de status HTTP 2xx será retornado e a operação será executada.	false
ClientToken	string	Não	O token do cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o valor, mas deve garantir que ele seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Nota Se você não definir este parâmetro, o sistema usará automaticamente RequestId como ClientToken. RequestId pode ser diferente para cada solicitação de API.	5A2CFF0E-5718-45B5-9D4D-70B3FF3898
NatIpStatus	string	Não	O status do endereço IP. Valores válidos: Available Deleting Creating	Available
NextToken	string	Não	O token usado para a próxima consulta. Valores válidos: Se esta for sua primeira consulta ou nenhuma próxima consulta precisar ser enviada, ignore este parâmetro. Se uma próxima consulta precisar ser enviada, defina o valor como o valor de NextToken retornado da última chamada.	FFmyTO70tTpLG6I3FmYAXGKPd****f84eb48b699f0a4883
MaxResults	string	Não	O número de entradas a serem retornadas em cada página. Valores válidos: 1 a 100. Valor padrão: 20.	20
NatIpName	array	Não	O nome do endereço IP. Valores válidos de N: 1 a 20.	test
	string	Não	O nome do endereço IP. Valores válidos de N: 1 a 20.	test
NatIpIds	array	Não	O ID do endereço IP. Valores válidos de N: 1 a 20.	vpcnatip-gw8a863sut1zijxh0****
	string	Não	O ID do endereço IP. Valores válidos de N: 1 a 20.	vpcnatcidr-gw8ov42ei6xh1jys2****
RegionId	string	Sim	O ID da região onde o gateway NAT está implantado. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	eu-central-1
IpOrigin	string	Não	A enumeração dos campos usados para descrever a origem do NatIp. Prefix indica o NatIp que pertence ao IPv4Prefix. O valor cidr indica NatIp isolado. O valor control indica todos os NatIp.	cidr
Ipv4Prefix	string	Não	O intervalo de endereços de prefixo IP.	192.168.0.0/28

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
NextToken	string	O token usado para a próxima consulta. Valores válidos: Se o valor de NextToken não for retornado, indica que nenhuma próxima consulta será enviada. Se o valor de NextToken for retornado, o valor indica o token usado para a próxima consulta.	FFmyTO70tTpLG6I3FmYAXGKPd****
RequestId	string	O ID da solicitação.	7E78CEEA-BF8F-44D1-9DCD-D9141135B71E
TotalCount	string	O número de endereços IP retornados.	1
NatIps	array<object>	A lista de endereços IP do gateway NAT.
	object
IsDefault	boolean	Indica se o endereço IP é o endereço IP padrão do gateway NAT. Valores válidos: true: Sim. false: Não.	true
NatIp	string	O endereço IP.	192.168.0.126
Ipv4Prefix	string	O intervalo de endereços de prefixo IP ao qual o endereço IP NAT consultado pertence.	192.168.0.0/28
NatIpCidr	string	O bloco CIDR ao qual o endereço IP pertence.	192.168.0.0/24
NatIpId	string	O ID do endereço IP.	vpcnatip-gw8a863sut1zijxh0****
NatIpDescription	string	A descrição do endereço IP.	default
NatGatewayId	string	O ID do gateway NAT da Virtual Private Cloud (VPC) ao qual o endereço IP está atribuído.	ngw-gw8v16wgvtq26vh59****
NatIpName	string	O nome do endereço IP.	default
NatIpStatus	string	O status do endereço IP. Valores válidos: Available: Disponível. Deleted: Excluído. Deleting: Excluindo. Creating: Criando. Associated: Especificado em uma entrada SNAT ou DNAT. Associating: Sendo especificado em uma entrada SNAT ou DNAT.	Available

Exemplos

Resposta de sucesso

JSON formato

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "7E78CEEA-BF8F-44D1-9DCD-D9141135B71E",
  "TotalCount": "1",
  "NatIps": [
    {
      "IsDefault": true,
      "NatIp": "192.168.0.126",
      "Ipv4Prefix": "192.168.0.0/28",
      "NatIpCidr": "192.168.0.0/24",
      "NatIpId": "vpcnatip-gw8a863sut1zijxh0****",
      "NatIpDescription": "default",
      "NatGatewayId": "ngw-gw8v16wgvtq26vh59****",
      "NatIpName": "default",
      "NatIpStatus": "Available"
    }
  ]
}

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.