AllocateVpcIpv6Cidr - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Descrição da operação

Para alocar um bloco CIDR IPv6 especificado a uma VPC, execute as seguintes etapas:\n1. Chame esta operação para reservar um bloco CIDR IPv6 especificado.\n2. Para alocar um bloco CIDR IPv6 especificado a uma VPC existente, chame a operação AssociateVpcCidrBlock e defina RegionId, VpcId e IPv6CidrBlock como o bloco CIDR IPv6 especificado, e defina IpVersion como ipv6. Para alocar um bloco CIDR IPv6 especificado a uma nova VPC, chame a operação CreateVpc e defina RegionId e Ipv6CidrBlock como o bloco CIDR IPv6 especificado, e defina EnableIpv6 como true.

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

none

*All resources.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região onde a VPC está implantada.\n\nVocê pode chamar a operação DescribeRegions para consultar os IDs das regiões.	cn-hangzhou
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. O token de cliente pode conter apenas caracteres ASCII.\n\n> 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.	123e4567-e89b-12d3-a456-426655440000
Ipv6Isp	string	Não	O tipo de ISP do bloco CIDR IPv6 para a VPC. Valores válidos:\n\n- BGP (padrão): BGP (Multi-ISP).\n- BGP_International: BGP (Multi-ISP) International.\n- ChinaMobile: China Mobile (ISP único).\n- ChinaUnicom: China Unicom (ISP único).\n- ChinaTelecom: China Telecom (ISP único).\n- ChinaMobile_L2: China Mobile (ISP único) L2.\n- ChinaUnicom_L2: China Unicom (ISP único) L2.\n- ChinaTelecom_L2: China Telecom (ISP único) L2.\n\n> - Se a sua conta estiver adicionada à lista de permissões correspondente, você poderá definir este parâmetro como ChinaTelecom (China Telecom), ChinaUnicom (China Unicom), ChinaMobile (China Mobile), ChinaTelecom_L2 (China Telecom L2), ChinaUnicom_L2 (China Unicom L2), ChinaMobile_L2 (China Mobile L2) ou BGP_International (BGP Multi-ISP International).\n> - Você pode reservar apenas um bloco CIDR IPv6 de cada tipo de ISP. Você só pode reservar o próximo bloco CIDR IPv6 depois que o atual for alocado a uma VPC.	BGP
AddressPoolType	string	Não	O tipo do pool de endereços IPv6. Valores válidos:\n- aliyun (padrão): O bloco CIDR IPv6 é alocado pelo sistema.\n- custom: O bloco CIDR IPv6 é personalizado pelo usuário.	custom
Ipv6CidrBlock	string	Não	O bloco CIDR IPv6 a ser reservado.	2408:XXXX:0:a600::/56

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	As informações retornadas.
Ipv6CidrBlock	string	O bloco CIDR IPv6 reservado.	2408:XXXX:0:a600::/56
RequestId	string	O ID da solicitação.	D20C13EA-2584-53BC-8393-69DE6D98EFF1

Exemplos

Resposta de sucesso

JSON formato

{
  "Ipv6CidrBlock": "2408:XXXX:0:a600::/56",
  "RequestId": "D20C13EA-2584-53BC-8393-69DE6D98EFF1"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	OperationUnsupported.Ipv6Feature	The IPv6 feature is not supported in the region.	O recurso IPv6 não é suportado na região atual.
400	UnsupportedFeature.Ipv6Isp	The Ipv6Isp feature is not supported.	O recurso de ISP IPv6 especificado não é suportado.
400	IllegalParam.AddressPoolType	The specified addressPoolType is invalid.	O tipo de pool de endereços especificado é inválido.
400	ResourceNotEnough.Ipv6Cidr	The specified resource ipv6 cidr is not enough.	Os recursos de endereços IPv6 são insuficientes.
400	IllegalParam.Ipv6Cidr	The specified Ipv6CidrBlock is invalid.	O bloco CIDR IPv6 especificado é inválido.
400	Unavailable.Ipv6Cidr	The specified resource ipv6 cidr is not available.	O bloco CIDR IPv6 especificado não está disponível.
400	IllegalParam.CidrBlock	The param of cidrBlock is illegal.	O bloco CIDR é inválido.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.