Todos os produtos
Search

Este produto

    :CreateNatIp

    Central de documentação

    :CreateNatIp

    Última atualização: Jul 04, 2026

    Crie um endereço IP NAT.

    Observações de uso

    A operação CreateNatIp é assíncrona. Após o envio da solicitação, o sistema retorna uma resposta e executa a tarefa em segundo plano. Para consultar o status da tarefa, chame a operação ListNatIps.

    • Se um endereço IP NAT estiver no estado Creating, ele estará em criação. Nesse caso, você pode apenas consultar o endereço IP NAT; outras operações não são permitidas.

    • Se um endereço IP NAT estiver no estado Available, ele foi criado com sucesso.

    Não chame a operação CreateNatIp repetidamente para criar um endereço IP NAT em um curto período.

    Depuração

    O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo para diferentes SDKs.

    Parâmetros da solicitação

    ParameterTypeRequiredExampleDescription
    RegionIdStringYeseu-central-1

    ID da região do gateway NAT ao qual pertence o endereço IP NAT a ser criado.

    Para obter a lista mais recente de regiões, chame a operação DescribeRegions.

    NatGatewayIdStringYesngw-gw8v16wgvtq26vh59****

    ID do gateway NAT da Virtual Private Cloud (VPC) para o qual você deseja criar o endereço IP NAT.

    NatIpNameStringYesnewnatip

    Nome do endereço IP NAT.

    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 e não pode iniciar com http:// ou https://.

    NatIpDescriptionStringYestest

    Descrição do endereço IP NAT.

    A descrição deve ter de 2 a 256 caracteres e começar com uma letra. Não pode iniciar com http:// ou https://.

    DryRunBooleanNofalse

    Especifique se apenas uma simulação será executada, sem realizar a solicitação real. Valores válidos:

    • true: execute apenas a simulação. O sistema verifica possíveis problemas na solicitação, como parâmetros ausentes, sintaxe incorreta e limites de serviço. Se a simulação falhar, uma mensagem de erro é retornada. Se for aprovada, o código de erro DryRunOperation é retornado.
    • false (padrão): execute a simulação e a solicitação real. Se a simulação for bem-sucedida, um código de status HTTP 2xx é retornado e a operação é executada.
    ClientTokenStringNo5A2CFF0E-5718-45B5-9D4D-70B3FF3898

    Token do cliente usado para garantir a idempotência da solicitação.

    Gere o token usando o cliente, mas garanta que ele seja único entre diferentes solicitações. O token aceita apenas caracteres ASCII.

    Nota Se este parâmetro não for especificado, o sistema usará automaticamente o ID da solicitação como o token do cliente. O ID da solicitação pode variar a cada solicitação.
    NatIpCidrStringYes192.168.0.0/24

    Bloco CIDR ao qual o endereço IP NAT pertence.

    NatIpStringNo192.168.0.34

    Endereço IP NAT a ser criado.

    Se nenhum endereço IP for especificado, o sistema aloca aleatoriamente um endereço IP do bloco CIDR informado.

    ActionStringYesCreateNatIp

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

    Parâmetros de resposta

    Parameter

    Type

    Example

    Description

    NatIp

    String

    192.168.0.34

    Endereço IP NAT criado.

    RequestId

    String

    E9AD97A0-5338-43F8-8A80-5E274CCBA11B

    ID da solicitação.

    NatIpId

    String

    vpcnatip-gw8y7q3cpk3fggs8****

    ID do endereço IP NAT.

    Exemplos

    Exemplo de solicitação

    http(s)://[Endpoint]/?RegionId=eu-central-1
&NatGatewayId=ngw-gw8v16wgvtq26vh59****
&NatIpName=newnatip
&NatIpDescription=test
&DryRun=false
&ClientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF3898
&NatIpCidr=192.168.0.0/24
&NatIpCidrId=vpcnatip-gw8y7q3cpk3fggs87****
&NatIp=192.168.0.34
&Action=CreateNatIp
&Common request parameters

    Exemplo de resposta de sucesso

    Formato XML

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

<CreateNatIpResponse>
    <NatIp>192.168.0.34</NatIp>
    <RequestId>E9AD97A0-5338-43F8-8A80-5E274CCBA11B</RequestId>
    <NatIpId>vpcnatip-gw8y7q3cpk3fggs8****</NatIpId>
</CreateNatIpResponse>

    Formato JSON

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

{
  "NatIp" : "192.168.0.34",
  "RequestId" : "E9AD97A0-5338-43F8-8A80-5E274CCBA11B",
  "NatIpId" : "vpcnatip-gw8y7q3cpk3fggs8****"
}

    Códigos de erro

    HttpCode

    Error code

    Error message

    Description

    400

    IncorrectStatus.NatGateway

    %The status of %s [%s] is incorrect.

    O gateway NAT está em um estado inválido.

    400

    ResourceNotEnough.SwitchAvailableIps

    The available private Ip number is not enough in your subnet.

    A quantidade de endereços IP privados disponíveis na sub-rede é insuficiente.

    400

    ResourceNotEnough.NatIp

    The specified resource of NatIp is not enough.

    Endereços IP insuficientes no bloco CIDR especificado.

    404

    InvalidRegionId.NotFound

    The specified RegionId does not exist in our records.

    O ID da região especificado não existe.

    Para obter uma lista completa de códigos de erro, consulte Códigos de erro do serviço.