CreateNatIpCidr - : Central de Documentação do Alibaba Cloud

Observações de uso

Não chame a operação CreateNatIpCidr repetidamente para criar um bloco CIDR de NAT dentro do período especificado.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
RegionId	String	Sim	eu-central-1	ID da região do gateway NAT ao qual associar o bloco CIDR. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
NatGatewayId	String	Sim	ngw-gw8v16wgvtq26vh59****	ID do gateway NAT da Virtual Private Cloud (VPC) ao qual associar o bloco CIDR.
NatIpCidrName	String	Sim	newcidr	Nome do bloco CIDR. O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos, pontos (.), sublinhados (_) e hifens (-). Deve começar com uma letra. Não pode começar com `http://` ou `https://`.
NatIpCidrDescription	String	Sim	mycidr	Descrição do bloco CIDR de NAT. A descrição deve ter de 2 a 256 caracteres. Deve começar com uma letra, mas não pode começar com `http://` ou `https://`.
DryRun	Boolean	Não	false	Defina se a solicitação deve ser verificada sem executar a operação. Valores válidos: true: pré-verifica a solicitação, mas não cria o bloco CIDR de NAT. O sistema verifica os parâmetros obrigatórios, a sintaxe da solicitação e os limites. Se a verificação falhar, o sistema retorna uma mensagem de erro. Se a vericação for bem-sucedida, o sistema retorna o código de erro `DryRunOperation`. false (padrão): envia a solicitação. Se a verificação for bem-sucedida, o sistema retorna um código de status HTTP 2xx e cria o bloco CIDR de NAT.
ClientToken	String	Não	5A2CFF0E-5718-45B5-9D4D-70B3FF3898	Token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o valor, mas garanta que ele seja exclusivo entre diferentes solicitações. O token de cliente pode conter apenas caracteres ASCII. Nota Se você não definir este parâmetro, o sistema usará automaticamente o RequestId como ClientToken. O RequestId de cada solicitação de API pode ser diferente.
NatIpCidr	String	Sim	172.16.0.0/24	Bloco CIDR de NAT a ser associado ao gateway NAT. O bloco CIDR de NAT deve atender às seguintes condições: Deve estar dentro de 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 ou suas sub-redes. A máscara de sub-rede deve ter de 16 a 32 bits. Não pode haver sobreposição com o bloco CIDR privado da VPC à qual o gateway NAT pertence. Para usar outros endereços IP do bloco CIDR privado da VPC para fornecer serviços de NAT, crie um vSwitch e anexe-o a outro gateway NAT da VPC. Para utilizar endereços IP públicos na prestação de serviços de NAT, certifique-se de que eles estejam dentro de um bloco CIDR de cliente da VPC à qual o gateway NAT da VPC pertence. Para obter mais informações, consulte O que é um bloco CIDR de cliente?.
Action	String	Sim	CreateNatIpCidr	Operação a ser executada. Defina o valor como CreateNatIpCidr.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
NatIpCidrId	String	vpcnatcidr-gw8lhqtvdn4qnea****	ID do bloco CIDR de NAT.
RequestId	String	7021BEB1-210F-48A9-AB82-BE9A9110BB89	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?RegionId=eu-central-1
&NatGatewayId=ngw-gw8v16wgvtq26vh59****
&NatIpCidrName=newcidr
&NatIpCidrDescription=mycidr
&DryRun=false
&ClientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF3898
&NatIpCidr=172.16.0.0/24
&Action=CreateNatIpCidr
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<CreateNatIpCidrResponse>
    <NatIpCidrId>vpcnatcidr-gw8lhqtvdn4qnea****</NatIpCidrId>
    <RequestId>7021BEB1-210F-48A9-AB82-BE9A9110BB89</RequestId>
</CreateNatIpCidrResponse>

Formato JSON

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

{
  "NatIpCidrId" : "vpcnatcidr-gw8lhqtvdn4qnea****",
  "RequestId" : "7021BEB1-210F-48A9-AB82-BE9A9110BB89"
}

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.	A mensagem de erro retornada porque o ID da região especificada não existe.

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.