CreateIpv6EgressOnlyRule - IPv6 Gateway: Central de Documentação do Alibaba Cloud

Cria uma regra somente de saída IPv6 para um endereço IPv6 chamando CreateIpv6EgressOnlyRule. Você pode criar uma regra somente de saída para permitir que instâncias ECS em uma VPC com um bloco CIDR IPv6 acessem proativamente endpoints IPv6 no lado do cliente, impedindo ao mesmo tempo que os endpoints IPv6 do cliente acessem instâncias ECS na VPC pela Internet.

Descrição da operação

A operação CreateIpv6EgressOnlyRule é assíncrona. Após o envio da solicitação, o sistema retorna um ID de instância, mas a regra somente de saída IPv6 ainda não foi criada. A tarefa de criação continua sendo executada em segundo plano. Você pode chamar DescribeIpv6EgressOnlyRules para consultar o status de criação da regra somente de saída IPv6:
- Se a regra somente de saída IPv6 estiver no estado Creating, a regra está sendo criada.
- Se a regra somente de saída IPv6 estiver no estado Created, a regra foi criada.
A operação CreateIpv6EgressOnlyRule não suporta a criação simultânea de regras somente de saída para o mesmo endereço IPv6.

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:CreateIpv6EgressOnlyRule

create

*Ipv6EgressRule.

acs:vpc:{#regionId}:{#accountId}:ipv6gateway/{#Ipv6GatewayId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do gateway IPv6. Você pode chamar a operação DescribeRegions para consultar o ID da região.	cn-huhehaote
Ipv6GatewayId	string	Sim	O ID da instância do gateway IPv6.	ipv6gw-hp3c2paq0ywauasza****
InstanceId	string	Sim	O ID do endereço IPv6 para o qual você deseja criar uma regra somente de saída.	ipv6-hp3nxjkfxn5pnhgl5****
InstanceType	string	Não	O tipo da instância para a qual você deseja criar uma regra somente de saída. Defina o valor como Ipv6Address (padrão), que indica o tipo de endereço IPv6.	Ipv6Address
Name	string	Não	O nome da regra somente de saída. O nome deve ter de 0 a 128 caracteres e não pode começar com `http://` ou `https://`.	rulename
Description	string	Não	A descrição da regra somente de saída. A descrição deve ter de 0 a 256 caracteres e não pode começar com `http://` ou `https://`.	ruledescription
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 token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como ClientToken. O RequestId pode ser diferente para cada solicitação de API.	0c593ea1-3bea-11e9-b96b-88e9fe637760
RegionId	string	Sim	Especifica se deve ser realizado um dry run sem executar a solicitação real.	cn-huhehaote
DryRun	boolean	Não	Realiza um dry run da solicitação sem executá-la de fato.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Ipv6EgressRuleId	string	O ID da regra somente de saída.	ipv6py-hp3w98rmlbqp01245****
RequestId	string	O ID da solicitação.	9DFEDBEE-E5AB-49E8-A2DC-CC114C67AF75

Exemplos

Resposta de sucesso

JSON formato

{
  "Ipv6EgressRuleId": "ipv6py-hp3w98rmlbqp01245****",
  "RequestId": "9DFEDBEE-E5AB-49E8-A2DC-CC114C67AF75"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidIpv6Gateway.NotFound	The specified IPv6 gateway was not found.	O gateway IPv6 especificado não foi encontrado.
400	IllegalParam.Name	The param of Name [%s] is illegal.	O parâmetro Name é inválido. Insira um valor válido conforme especificado nos requisitos de parâmetros da solicitação.
400	IllegalParam.Description	The parameter of Description is illegal.	O parâmetro Description é inválido.
400	IllegalParam.InstanceType	The parameter of InstanceType is illegal.	O parâmetro InstanceType é inválido.
400	OperationFailed.FinancialLocked	The operation is forbidden because of financialLocked.	A operação falhou devido a um pagamento em atraso.
400	OperationUnsupported.EgressRuleVSwitch	The specified VSwitch is not supported to create egress-only rule.	A região especificada não suporta regras apenas de saída no nível do vSwitch.
400	InvalidIpv6Instance.NotFound	The specified resource of InvalidIpv6Instance is not found.	A instância IPv6 especificada não foi encontrada.
400	OperationFailed.NoInternetBandwidth	Operation failed because the ipv6 instance has no internet bandwidth.	A operação não é suportada porque a instância IPv6 não possui largura de banda de Internet.
400	OperationFailed.Ipv6EgressRuleExisted	An egress-only rule already exists for the IPv6 address.	Já existe uma regra de somente saída IPv6 para esta instância IPv6.
400	OperationFailed.InternetBandwidthUnstable	The operation is forbidden because of InternetBandwidthUnstable.	A operação é proibida porque a instância de largura de banda está em um estado transitório.
400	IncorrectStatus.Ipv6InternetBandwidth	The status of the IPv6InternetBandwidth is incorrect.	O estado atual da largura de banda de Internet IPv6 não oferece suporte à criação de uma regra somente de saída IPv6.
400	OperationUnsupported.EgressRuleInDefaultSpec	Egress-only rule is not supported. Please update the spec of IPv6 Gateway to Medium or Large.	O gateway IPv6 da edição gratuita não suporta a criação de regras apenas de saída. Atualize o gateway IPv6 para a Edição Enterprise ou Edição Enterprise Aprimorada.
400	QuotaExceeded.Ipv6EgressRules	%s quota exceeded.	A cota de Ipv6EgressRules foi excedida.
400	Mismatch.Ipv6AddressAndIpv6Gateway	The %s and %s are mismatched.	O Ipv6Address e o Ipv6Gateway especificados não estão na mesma VPC.
400	OperationUnsupported.EgressOnlyRuleOnFreeIpv6Instance	Creating ipv6 egress only rule on ipv6 instance that not associated with any resource is unsupported.	Você não pode criar uma regra apenas de saída em uma instância IPv6 que não esteja associada a um recurso.
400	MissingParam.InstanceId	The parameter InstanceId is mandatory.	O parâmetro InstanceId não pode estar vazio.
400	OperationUnsupported.ULA	%s is unsupported.	A operação atual não oferece suporte a endereços ULA.
400	OperationUnsupported.PrivateGUA	This operation does not support private GUA addresses.	A operação atual não oferece suporte a endereços GUA privados.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.