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

Cria um gateway NAT de Internet aprimorado ou um gateway NAT de VPC.

Descrição da operação

Ao chamar esta operação, observe os seguintes itens:

Ao criar um gateway NAT pela primeira vez, o sistema cria automaticamente uma função vinculada ao serviço chamada AliyunServiceRoleForNatgw e anexa uma política de acesso chamada AliyunServiceRolePolicyForNatgw à função. Isso concede ao gateway NAT as permissões para acessar outros recursos de nuvem. Para mais informações, consulte Funções vinculadas ao serviço.
Após a criação de um gateway NAT de Internet aprimorado, o sistema adiciona automaticamente uma entrada de rota cujo bloco CIDR de destino é 0.0.0.0/0 e cujo próximo salto é o gateway NAT à tabela de rotas da VPC. Isso direciona o tráfego para o gateway NAT.
CreateNatGateway é uma operação assíncrona. O sistema primeiro retorna o ID da instância do gateway NAT (gateway NAT de Internet ou gateway NAT de VPC), mas a instância do gateway NAT ainda não foi criada e a tarefa de criação ainda está em execução em segundo plano. Você pode chamar DescribeNatGateways para consultar o status do gateway NAT.
- Se o gateway NAT estiver no estado Creating, o gateway NAT está sendo criado. Neste estado, você pode realizar apenas operações de consulta.
- Se o gateway NAT estiver no estado Available, o gateway NAT foi criado.

Normalmente, leva de 1 a 3 minutos para criar 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 do gateway NAT. Você pode chamar a operação DescribeRegions para consultar os IDs das regiões.	cn-hangzhou
VpcId	string	Sim	O ID da VPC onde você deseja criar o gateway NAT.	vpc-bp1di7uewzmtvfuq8****
Name	string	Não	O nome do gateway NAT. O nome deve ter de 2 a 128 caracteres. Deve começar com uma letra ou um caractere chinês e pode conter dígitos, sublinhados (_) e hifens (-). Se você não especificar este parâmetro, o sistema gerará um nome padrão para o gateway NAT.	fortest
Description	string	Não	A descrição do gateway NAT. A descrição pode ser deixada em branco ou ter de 2 a 256 caracteres. Não pode começar com `http://` ou `https://`.	testnat
ClientToken	string	Não	O token de 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. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como o ClientToken. O RequestId de cada solicitação de API pode ser diferente.	5A2CFF0E-5718-45B5-9D4D-70B3FF3898
Spec	string	Não	Os gateways NAT de Internet por assinatura não estão mais disponíveis para compra. Este parâmetro não é mais utilizado.	Invalid parameter
InstanceChargeType	string	Não	O método de cobrança do gateway NAT. Valores válidos: PostPaid (padrão): pós-pago. Para mais informações, consulte Cobrança do gateway NAT de Internet e Cobrança do gateway NAT de VPC.	PostPaid
PricingCycle	string	Não	Os gateways NAT de Internet por assinatura não estão mais disponíveis para compra. Este parâmetro não é mais utilizado.	Invalid parameter
Duration	string	Não	Os gateways NAT de Internet por assinatura não estão mais disponíveis para compra. Este parâmetro não é mais utilizado.	Invalid parameter
AutoPay	boolean	Não	Os gateways NAT de Internet por assinatura não estão mais disponíveis para compra. Este parâmetro não é mais utilizado. Importante Este parâmetro foi descontinuado.	false
VSwitchId	string	Não	O ID do vSwitch ao qual o gateway NAT pertence. Ao criar um gateway NAT, você deve especificar o vSwitch ao qual o gateway NAT pertence. O sistema aloca um endereço IP privado ocioso do vSwitch para o gateway NAT. Se você deseja criar um gateway NAT em um vSwitch existente, certifique-se de que a zona à qual o vSwitch pertence suporte gateways NAT e que o vSwitch tenha endereços IP disponíveis. Se você não criou um vSwitch, crie um vSwitch em uma zona que suporte gateways NAT e, em seguida, especifique o vSwitch ao qual o gateway NAT pertence. Nota Você pode chamar a operação ListEnhanhcedNatGatewayAvailableZones para consultar as zonas que suportam gateways NAT e chamar a operação DescribeVSwitches para consultar a contagem de endereços IP disponíveis em um vSwitch.	vsw-bp1e3se98n9fq8hle****
NatType	string	Não	O tipo do gateway NAT. Defina o valor como Enhanced, que especifica um gateway NAT aprimorado.	Enhanced
InternetChargeType	string	Não	O método de medição do gateway NAT. Defina o valor como PayByLcu, que especifica o pagamento por LCU.	PayByLcu
NetworkType	string	Não	O tipo do gateway NAT que você deseja criar. Valores válidos: internet: gateway NAT de Internet. intranet: gateway NAT de VPC.	internet
SecurityProtectionEnabled `deprecated`	boolean	Não	Especifica se o recurso de firewall deve ser ativado. Valores válidos: false (padrão): desativa o recurso de firewall. Importante Este parâmetro foi descontinuado.	false
IcmpReplyEnabled	boolean	Não	Especifica se a resposta de eco ICMP deve ser ativada. Valores válidos: true (padrão): ativa a resposta de eco ICMP. false: desativa a resposta de eco ICMP.	true
PrivateLinkEnabled	boolean	Não	Especifica se o PrivateLink deve ser ativado. Valores válidos: true: ativa o PrivateLink. false (padrão): desativa o PrivateLink.	false
EipBindMode	string	Não	O modo de vinculação de EIP do gateway NAT. Valores válidos: MULTI_BINDED (padrão): modo multi-EIP visível para NIC. NAT: modo NAT, que é compatível com gateways IPv4. Nota Quando o modo de vinculação de EIP do gateway NAT é definido como modo NAT, o EIP ocupa um endereço IP privado do vSwitch ao qual o gateway NAT pertence. Certifique-se de que o vSwitch tenha endereços IP privados suficientes. Se o vSwitch ao qual o gateway NAT pertence não tiver endereços IP privados ociosos disponíveis, você não poderá vincular novos EIPs. Quando o modo de vinculação de EIP do gateway NAT é definido como modo NAT, o gateway NAT suporta no máximo 50 EIPs.	MULTI_BINDED
Tag	array<object>	Não	A lista de tags.	MULTI_BINDED
	object	Não
Key	string	Não	A chave da tag. Você pode usar o formato Tag.N.Key ao chamar operações de API. Valores válidos de N: 1 a 20. Se você especificar este parâmetro, ele não poderá ser uma string vazia. A chave da tag pode ter até 128 caracteres. Não pode começar com aliyun ou acs: e não pode conter http:// ou https://.	TestKey
Value	string	Não	O valor da tag. Você pode usar o formato Tag.N.Value ao chamar operações de API. Valores válidos de N: 1 a 20. Se você especificar este parâmetro, ele não poderá ser uma string vazia. O valor da tag pode ter até 128 caracteres. Não pode começar com aliyun ou acs: e não pode conter http:// ou https://.	TestValue
AccessMode	object	Não	O modo de acesso para acesso reverso ao gateway NAT de VPC.	MULTI_BINDED
ModeValue	string	Não	O modo de acesso. Valores válidos: route: modo de rota. tunnel: modo de túnel. Nota Quando este campo é especificado, o campo PrivateLinkEnabled deve ser definido como true.	route
TunnelType	string	Não	O tipo de modo de túnel. Valores válidos: geneve: Geneve. Nota Este valor é válido apenas quando o modo de acesso é definido como modo de túnel.	geneve
NatIp	string	Não	O endereço IP privado alocado ao gateway NAT. Use um endereço IP não alocado no bloco CIDR do vSwitch do gateway NAT. Se este parâmetro for deixado em branco, um endereço IP será alocado aleatoriamente. Nota Este parâmetro entra em vigor apenas para gateways NAT de VPC.	192.168.0.2
Ipv4Prefix	string	Não	O bloco CIDR de prefixo IP usado para criar endereços IP NAT em lotes. Use um bloco CIDR reservado não alocado no vSwitch ao qual o gateway NAT pertence. Nota Este parâmetro entra em vigor apenas para gateways NAT de VPC.	192.168.0.0/28
AvailabilityMode	string	Não	O tipo de recuperação de desastres do gateway NAT. Valores válidos: CrossAZ: recuperação de desastres entre zonas. SingleAZ: recuperação de desastres de zona única.	CrossAZ

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A estrutura da resposta.
NatGatewayId	string	O ID da instância do gateway NAT criado.	ngw-112za33e4****
RequestId	string	O ID da solicitação.	2315DEB7-5E92-423A-91F7-4C1EC9AD97C3
ForwardTableIds	object
ForwardTableId	array	A tabela DNAT.
	string	A tabela DNAT.	ftb-11tc6xgmv****
SnatTableIds	object
SnatTableId	array	A tabela SNAT.
	string	A tabela SNAT.	stb-SnatTableIds****
FullNatTableIds	object
FullNatTableId	array	A tabela FULLNAT.
	string	A tabela FULLNAT.	fulltb-gw88z7hhlv43rmb26****

Exemplos

Resposta de sucesso

JSON formato

{
  "NatGatewayId": "ngw-112za33e4****",
  "RequestId": "2315DEB7-5E92-423A-91F7-4C1EC9AD97C3",
  "ForwardTableIds": {
    "ForwardTableId": [
      "ftb-11tc6xgmv****"
    ]
  },
  "SnatTableIds": {
    "SnatTableId": [
      "stb-SnatTableIds****"
    ]
  },
  "FullNatTableIds": {
    "FullNatTableId": [
      "fulltb-gw88z7hhlv43rmb26****"
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Forbidden.NatPayBySpec	Pay-by-specification NAT is no longer supported. Newly purchased pay-as-you-go NAT gateways only support the pay-by-CU metering method.	Os gateways NAT cobrados por especificação não estão mais disponíveis. Selecione um gateway NAT cobrado por uso de unidade de capacidade (CU).
400	DependencyViolation.FullNatEntry	The specified resource of %s depends on %s, so the operation cannot be completed.
400	UnsupportedFeature.InternetChargeType	The feature of InternetChargeType is not supported.
400	InvalidVPCStatus	vpc incorrect status.
400	InvalidNatGatewayName.MalFormed	NatGateway name is not valid.
400	InvalidNatGatewayDescription.MalFormed	NatGateway description is not valid.
400	MissingParameter.BandwidthPackage	only support one BandwidthPackage be created with NatGateway.
400	OperationDenied	The user cannot allow to create natgw, please call PD to authorize
400	RouterEntryConflict.Duplicated	A route entry already exists, which CIDR is '0.0.0.0/0'
400	MissingParameter	Miss mandatory parameter.
400	QuotaExceeded.BandwidthPackageIps	The specified ipCount exceeded quota.	O número de endereços IP excede o limite. Você pode solicitar um aumento de cota na página Gerenciamento de Cotas.
400	AllocateIpFailed	Alloc bandwidthPackage ips failed, maybe no available ip.
400	InvalidParameter.Name.Malformed	The specified Name is not valid.
400	InvalidParameter.Description.Malformed	The specified Description is not valid.
400	ZONE_NO_AVAILABLE_IP	The Zone have no available ip.
400	ParameterIllegal	ipCount,bandwidth parameter invalid
400	InvalidParameter.BandwidthPackage.n.ISP.ValueNotSupport	The specified ISP of BandwidthPackage is not valid.
400	InvalidNatGatewayId.NotFound	The NatGatewayId not exist.
400	VpcStatusError	The Vpc is creating .
400	InvalidParameter.Spec.ValueNotSupported	The specified Spec is not valid.
400	TaskConflict	The operation is too frequent, TaskConflict.	As operações no EIP são muito frequentes.
400	COMMODITY.INVALID_COMPONENT	The instance component is invalid.	O componente da instância especificado é inválido. Verifique se o componente da instância está correto.
400	CreateNatGateway.RouteConflict.DynamicRoute	Route conflict exists in routing table.
400	OperationUnsupported.MultiNatGateway	More than one natGateway per vpc is unsupported.
400	Forbidden.CheckEntryRuleQuota	Route entry quota rule check error.
400	OperationFailed.UnpaidBillsExist	The account has unpaid bills. Please pay your overdue bill first.	A conta possui pedidos não pagos.
400	IncorrectStatus.RouteEntry	Specified routeEntry status error.
400	OperationFailed.RiskControl	Risk control check failed.	Um risco de segurança foi detectado com seu método de pagamento. Verifique sua identidade usando o link fornecido no e-mail ou na mensagem do console e, em seguida, reenvie o pedido.
400	OperationFailed.TokenVerfiy	Token verify failed.
400	IllegalParam.Name	The specified Name is invalid, shorter than 2 characters.
400	OperationFailed.EnhancedQuotaExceed	Enhanced nat gateway per vpc quota is exceeded	A operação falhou porque o número de NAT gateways aprimorados na VPC atual excede o limite.
400	NoPermission.CreateServiceLinkedRole	You are not authorized to create service linked role
400	OperationFailed.EnhancedInventoryNotEnough	Operation failed because inventory is not enough.
400	OperationFailed.VswNotBelongToVpc	Operation failed because the specified VSwitch is not bound to the same VPC with NAT gateway.	A operação falhou porque o vSwitch e o NAT gateway não pertencem à mesma VPC.
400	OperationFailed.EnhancedUserIsUnAuthorized	Operation failed because the user is not authorized to create an enhanced NAT gateway.	A operação falhou porque você não está autorizado a criar um NAT gateway aprimorado.
400	OperationUnsupported.PrePaidPyByLcu	The operation failed because the subscription NAT gateway does not support the pay-by-LCU billing method.	As instâncias de gateway NAT por assinatura não oferecem suporte ao método de cobrança por LCU.
400	OperationFailed.NormalInventoryNotEnough	Standard NAT gateways are no longer offered. You can create enhanced NAT gateways and set the correct natType.
400	OperationFailed.VSwitchNoAvailableIp	Operation failed because the specified vswitch does not have availabe ip.
400	UnsupportedFeature.IcmpReplyEnabled	The feature of IcmpReplyEnabled is not supported.	A modificação do recurso de ativação de recuperação ICMP não é suportada.
400	UnsupportedFeature.SecurityProtectionEnabled	The feature of SecurityProtectionEnabled is not supported.
400	OperationFailed.RegionConvert	Operation failed because do not find region info.
400	UnsupportedFeature.VpcNat	The feature of VpcNat is not supported.
400	InvalidVSWITCHID.NotFound	The specified resource of %s is not found.
400	Forbidden.OperateShareResource	Operate share resource is forbidden.
400	IncorrectStatus.VSWITCH	The status of VSWITCH is incorrect.	O switch virtual está em um estado anormal.
400	OperationFailed.VpcNatGatewayInventoryNotEnough	The operation is failed because of inventory is not enough.
400	OperationFailed.VpcNatGatewayCheckInventory	The operation is failed because of check inventory result is unexpected
400	ExclusiveParam.%sAnd%s	The param of %s and %s are mutually exclusive.	Os parâmetros %s e %s são mutuamente exclusivos.
400	SecurityGroupType.NotSupported	The specified security group type is not supported.	O grupo de segurança é gerenciado e não pode ser usado.
400	SecurityGroup.NotExist	The specified security group is not exist.	O grupo de segurança não existe nesta VPC.
400	OperationFailed.ContainForbiddenLabel	There is a label that prohibits ordering, please contact your distributor for processing.	Existe uma tag que proíbe a realização de pedidos. Entre em contato com seu distribuidor para obter assistência.
400	OperationDenied.PrePaidInstance	The operation is not allowed because prepaid instance is no longer supported.	As instâncias por assinatura não estão mais disponíveis para compra.
400	UnsupportedFeature.Geneve	The feature of Geneve is not supported.	Não há suporte para a criação de gateways NAT no modo Geneve.
400	OperationFailed.NoAvailableResource	The Zone have no available resource.	Não há recursos disponíveis na região.
400	ExclusiveParam.AccessModeValueAndAccessTunnelType	The specified param AccessModeValue and AccessTunnelType are mutually exclusive.	Os parâmetros AccessMode.ModeValue e AccessMode.TunnelType especificados estão em conflito entre si.
400	ExclusiveParam.PrivateLinkModeAndAccessMode	The specified param PrivateLinkMode and AccessMode are mutually exclusive.	Os parâmetros PrivateLinkMode e AccessMode especificados estão em conflito entre si.
400	ExclusiveParam.PrivateLinkEnabledAndAccessMode	The specified paramPrivateLinkEnabled and AccessMode are mutually exclusive.	Os parâmetros PrivateLinkEnabled e AccessMode especificados estão em conflito entre si.
400	UnsupportedFeature.AccessModeValue	The feature of AccessMode.ModeValue(%s) is not supported.	Esta operação não é suportada para a propriedade AccessMode.ModeValue de um gateway NAT de VPC.
400	IllegalParam.AccessTunnelType	The request parameter AccessMode.TunnelType is illegal.	O parâmetro de solicitação AccessMode.TunnelType é inválido.
400	IllegalParam.AccessModeValue	The request parameter AccessMode.ModeValue is illegal.	O parâmetro de solicitação AccessMode.ModeValue é inválido.
400	OperationFailed.VSwitchStatusError	The vSwitch is creating .	O vSwitch está sendo criado.
400	UnsupportedFeature.PrivateLinkMode	The feature of %s is not supported.	O recurso de acesso reverso não é suportado atualmente.
400	OperationFailed.EcsNetworkInterfaceQuotaNotSatisfy	ECS network interface quota is not satisfy.	A cota para interfaces de rede elásticas (ENIs) do ECS é insuficiente.
400	OperationFailed.NoNameAuthentication	You have not passed the real name authentication and do not meet the purchase conditions. Please log in to the user center for real-name authentication.	Você não concluiu a verificação de nome real e não atende aos requisitos de compra. Faça login na Central do Usuário para concluir a verificação de nome real.
400	Mismatch.NatIpAndNatIpCidr	The %s and %s are mismatched.	%s e %s não correspondem.
400	Mismatch.Ipv4PrefixAndNatIpCidr	The %s and %s are mismatched.	O Ipv4Prefix e o NatIpCidr não coincidem.
400	ResourceAlreadyExist.NatIp	The specified resource of NatIp has already exist.	O endereço IP NAT especificado já existe.
400	Mismatch.Ipv4PrefixAndCidrReservations	The %s and %s are mismatched.	O Ipv4Prefix não corresponde ao bloco CIDR reservado para um vSwitch.
400	ResourceAlreadyAssociated.Ipv4Prefix	%s is already associated.	O Ipv4Prefix já foi alocado.
400	ResourceNotEnough.Ipv4Prefix	The resource of %s is not enough.	Os recursos Ipv4Prefix são insuficientes.
400	ResourceNotFound.Ipv4Prefix	The resource of s% is not found.
400	ResourceAlreadyAssociated.NatIp	The resource of %s was already associated.	O recurso NatIp já foi alocado.
400	ResourceNotEnough.NatIp	The specified resource of NatIp is not enough.	Endereços IP insuficientes no bloco CIDR especificado.
400	ResourceNotFound.NatIp	The specified resource of %s is not found.	O recurso de endereço IP NAT não pode ser encontrado.
400	IllegalParam.Ipv4Prefix	The param of %s is illegal, must be /28 network segment.	O parâmetro Ipv4Prefix é inválido.
400	IllegalParam.NatIp	The param of %s is illegal.	O parâmetro NatIp é inválido.
400	OperationUnsupported.EnhancedRegion	Region not support.	Os NAT gateways aprimorados não são suportados na região atual.
400	IncorrectStatus.RouteTableStatus	The route table status is invaild. Please try again later.	A tabela de rotas especificada não está em um estado estável.
400	OperationUnsupported.User	The current user does not support this operation.	Esta operação não é suportada para o usuário atual.
400	OperationUnsupported.EnhancedCURegion	Operation failed because of this region not unsupported.	NAT gateways aprimorados cobrados por CU não são suportados na região atual.
400	OrderError.NoAvailablePaymentMethod	Order payment parameter is not available.	Ocorreu um erro de pedido. O parâmetro do método de cobrança é inválido.
400	OrderError.BasicInfoUncompleted	Order basic parameter is not completed.	Ocorreu um erro de pedido. As informações básicas do parâmetro estão incompletas.
400	OperationUnsupported.Region	Operation unsupport this region parameter.	Esta operação não suporta o parâmetro de região.
400	InvalidParameter.SingleZone	Operation failed because current user not support create single zone nat.	Você não tem permissão para criar um gateway NAT de zona única.
500	OrderError.NatGateway	The Account failed to create order.
500	OperationFailed.AccessTunnelId	AccessTunnelId param do operation failed.	O gateway NAT de VPC falhou ao gerar um ID de túnel. Tente novamente mais tarde.
500	OperationFailed.EnhancedCheckInventory	The NAT gateway in the current zone is not in service, or the resource inventory is insufficient.	Os gateways NAT não estão disponíveis na zona atual ou os recursos subjacentes são insuficientes.
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.
404	InvalidVpcId.NotFound	Specified value of VpcId is not found in our record.	A VPC não existe. Verifique se a VPC especificada está correta.
404	InvalidZoneId.NotFound	Specified value of ZoneId is not exists.
404	VPC_ONLY_CAN_CREATE_ONE_NAT_GATEWAY	NatGateway in one vpc support only one.
404	OperationFailed.CrateEntryTimeOut	Operation failed because create custom routeEntry timeout.
404	Forbidden.CreateSpecialSpecNatGateway	You are not authorized to create special spec nat gateway.
404	UnsupportedZoneForFwNat	The zone is unsupported for FW NAT.	A zona não oferece suporte a gateways NAT protegidos.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.