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

Modifica uma entrada SNAT especificada.

Descrição da operação

ModifySnatEntry é uma operação assíncrona. Após o envio de uma solicitação, o sistema retorna um ID de solicitação, mas a entrada SNAT ainda não foi modificada. A tarefa de modificação ainda está em execução em segundo plano. Você pode chamar DescribeSnatTableEntries para consultar o status da entrada SNAT:

Se a entrada SNAT estiver no estado Pending, a entrada SNAT está sendo modificada. Nesse estado, você pode realizar apenas operações de consulta e não pode realizar outras operações.
Se a entrada SNAT estiver no estado Available, a entrada SNAT foi modificada.

Nota

Se qualquer entrada SNAT em uma tabela SNAT estiver no estado Pending, você não poderá modificar as entradas SNAT na tabela SNAT.

A operação ModifySnatEntry não suporta modificações simultâneas de uma entrada SNAT especificada na mesma instância de entrada SNAT.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

vpc:ModifySnatEntry

update

*SnatTable

acs:vpc:{#regionId}:{#accountId}:snattable/{#SnatTableId}

Nenhuma

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 o ID da região.	cn-hangzhou
SnatTableId	string	Sim	O ID da tabela SNAT à qual a entrada SNAT pertence.	stb-8vbczigrhop8x5u3t****
SnatEntryId	string	Sim	O ID da entrada SNAT que você deseja modificar.	snat-bp1vcgcf8tm0plqcg****
SnatIp	string	Não	Ao modificar uma entrada SNAT para um gateway NAT de Internet, este parâmetro especifica os EIPs na entrada SNAT. Separe vários EIPs com vírgulas (,). Nota Ao especificar vários EIPs para alocar um pool IPAM de IP SNAT, o tráfego de serviço é distribuído entre os EIPs usando um algoritmo de hash. Como o tráfego varia entre as conexões, o tráfego de serviço pode ser distribuído de forma desigual entre os EIPs. Adicione todos os EIPs à mesma instância de Internet Shared Bandwidth para evitar interrupções de serviço causadas pela limitação de largura de banda em um único EIP. Ao modificar uma entrada SNAT para um gateway NAT de VPC, este parâmetro especifica os endereços IP NAT na entrada SNAT. Separe vários endereços IP NAT com vírgulas (,). Os parâmetros SnatIp e NetworkInterfaceId não podem ser especificados ao mesmo tempo.	47.98.XX.XX
SnatEntryName	string	Não	O nome da entrada SNAT. O nome deve ter de 2 a 128 caracteres e deve começar com uma letra ou um caractere chinês. Não pode começar com `http://` ou `https://`.	SnatEntry-1
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 token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O valor de ClientToken pode conter apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará o RequestId da solicitação de API como o ClientToken. O RequestId pode ser diferente para cada solicitação de API.	02fb3da4-130e-11e9-8e44-001****
EipAffinity	integer	Não	Especifica se a afinidade de EIP deve ser ativada. Valores válidos: 0: desativa a afinidade de EIP. 1: ativa a afinidade de EIP. Nota Após ativar a afinidade de EIP, se a entrada SNAT estiver associada a vários EIPs ou endereços IP NAT, o mesmo cliente usará o mesmo EIP ou endereço IP NAT para acesso. Caso contrário, o cliente seleciona aleatoriamente um EIP ou endereço IP NAT dentre os associados para acesso.	1
NetworkInterfaceId	string	Não	O ID das interfaces de rede elásticas (ENIs). Nota Os endereços IPv4 do controlador de interface de rede (NIC) são usados como os endereços SNAT.	eni-gw8g131ef2dnbu3k****
DryRun	boolean	Não	Especifica se deve ser realizado um dry run. Valores válidos: true: realiza um dry run sem modificar a entrada SNAT. O sistema verifica os parâmetros obrigatórios, o formato da solicitação e os limites do serviço. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for bem-sucedida, o código de erro `DryRunOperation` será retornado. false (padrão): realiza um dry run e envia a solicitação. Após a verificação ser bem-sucedida, um código de status HTTP 2xx é retornado e a entrada SNAT é modificada.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O corpo da resposta.
RequestId	string	O ID da solicitação.	2315DEB7-5E92-423A-91F7-4C1EC9AD****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "2315DEB7-5E92-423A-91F7-4C1EC9AD****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidSnatIp.Malformed	The specified SnatIp is not a valid IP address.
400	Forbidden.SourceVSwitchId.Duplicated	The specified SourceCIDRis duplicated.
400	Forbidden.IpUsedInForwardTable	The specified SnatIp already used in forward table
400	OperationUnsupported.EipForSnatPool	The Eip cannot support snat pool
400	InvalidParameter.Name.Malformed	The specified Name is not valid.
400	IncorretSnatEntryStatus	The Specified SnatEntry is not stable status, can not operation
400	EIP_NOT_IN_GATEWAY	The Eip not in nat gateway
400	InvalidParameter.SnatIp	Error public ip must in same bandwidth package.
400	QuotaExceeded.SnatIp	Public ip number exceeds quota.
400	InvalidSnatEntryId.NotFound	Specified SNAT entry does not exist.
400	IncorrectStatus.SnatEntry	The Specified SnatEntry is not stable status, can not operation	The specified SNAT entries are not in a stable state and cannot be operated.
400	OperationFailed.CanNotUseEipInDnat	Operation failed because the eip can not used by forward entry.
400	OperationUnsupported.EipNatGWCheck	Operation unsupported because the relation check of eip and nat gateway is failed.
400	ResourceNotFound.SnatEntry	Specified SNAT entry does not exist.
400	IncorrectStatus.NatIp	Specified NatIp does not exist.
400	OperationFailed.CanNotUseNatIpInDnat	Operation failed because the NatIp can not used by forward entry.
400	IncorrectStatus.NATGW	NATGW status is invalid.	The NAT gateway is in an invalid state.
400	OperationUnsupported.EipInBinding	Create snat entry with eip in associating status is unsupported.	You cannot use an associated EIP when you create an SNAT entry.
400	OperationUnsupported.EipNatBWPCheck	The EIP is not associated with a NAT service plan.	The EIP is not associated with a NAT service plan.
400	IllegalParam.NetworkInterfaceId	The param of NetworkInterfaceId is illegal.	Invalid NetworkInterfaceId value.
400	OperationFailed.SnatIpPoolBwpRules	The operation failed because the IP in Snat entryl was added to multiple NAT bandwidth packets.	The operation failed because the IP in the SNAT rule IP address pool was added to multiple NAT bandwidth packets.
400	OperationFailed.SnatIpPoolCbwpRules	The operation failed because the SNAT rule IPs are added to multi bandwidth packages.	The operation failed because the SNAT rule IP address pool was added to multiple bandwidth packages.
400	OperationFailed.SnatIpsTooMany	The maximum number of IP addresses is exceeded in the SNAT pool.	The maximum number of IP addresses is exceeded in the SNAT pool.
400	OperationFailed.SnatIpsCheck	The operation fails because some IPs address in the SNAT entry are not added to common bandwidth packet.	The operation fails because the IP address in the Snat rule IP address pool is not added to the shared bandwidth packet.
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.
404	InvalidSnatTableId.NotFound	Specified SNAT table does not exist.
404	InvalidSnatEntryId.NotFound	Specified SNAT entry does not exist.
404	InvalidSnatIp.NotFound	Specified SnatIp does not found on the NAT Gateway
404	ResourceNotFound.NatIp	Specified NatIp does not found on the NAT Gateway

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.