Todos os produtos
Search
Central de documentação

Virtual Private Cloud:ModifyVpcAttribute

Última atualização: Aug 28, 2026

Modifica a configuração de uma VPC especificada.

Descrição da operação

  • A operação ModifyVpcAttribute não suporta modificações simultâneas na configuração da mesma VPC.

  • A operação ModifyVpcAttribute pode ativar o IPv6 para uma VPC, mas não pode modificar o bloco CIDR IPv6 ou o tipo de endereço IPv6 de uma VPC que já tenha o IPv6 ativado.

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

update

*VPC.

acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}

  • vpc:tag
Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

VpcId

string

Sim

O ID da VPC cuja configuração você deseja modificar.

vpc-bp1qtbach57ywecf****

Description

string

Não

A nova descrição da VPC.

A descrição deve ter de 1 a 256 caracteres e não pode começar com http:// ou https://.

Esta é minha VPC

VpcName

string

Não

O novo nome da VPC.

O nome deve ter de 1 a 128 caracteres e não pode começar com http:// ou https://.

Vpc-1

CidrBlock

string

Não

O novo bloco CIDR IPv4 da VPC.

Você pode expandir ou reduzir o bloco CIDR dentro do bloco CIDR IPv4 original da VPC. A máscara de sub-rede recomendada é de 16 a 28 bits. Se você reduzir o bloco CIDR IPv4 da VPC, a modificação falhará se quaisquer endereços IP já em uso estiverem fora do bloco CIDR de destino.

Nota

A modificação do bloco CIDR IPv4 de uma VPC não afeta os serviços existentes.

192.168.0.0/24

RegionId

string

Não

O ID da região da VPC.

Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.

cn-hangzhou

EnableIPv6

boolean

Não

Especifica se o IPv6 deve ser ativado. Valores válidos:

  • false (padrão): Desativado.

  • true: Ativado.

false

Ipv6CidrBlock

string

Não

O bloco CIDR IPv6 da VPC. Quando você ativa o IPv6 para uma VPC, o sistema atribui um bloco CIDR IPv6. Para especificar um bloco CIDR IPv6, você precisa primeiro invocar a operação AllocateVpcIpv6Cidr para reservar um bloco CIDR IPv6 específico e, em seguida, transmiti-lo.

Nota

Para uma VPC que já tenha o IPv6 ativado, você não pode modificar o bloco CIDR IPv6 transmitindo este parâmetro.

2408:XXXX:0:6a::/56

Ipv6Isp

string

Não

O tipo do bloco CIDR IPv6 da VPC. Valores válidos:

  • BGP (padrão): BGP IPv6 do Alibaba Cloud.

  • ChinaMobile: China Mobile (ISP único).

  • ChinaUnicom: China Unicom (ISP único).

  • ChinaTelecom: China Telecom (ISP único).

Nota

Se você for um usuário que ativou a lista de permissões de largura de banda de ISP único, poderá definir este parâmetro como ChinaTelecom (China Telecom), ChinaUnicom (China Unicom) ou ChinaMobile (China Mobile).

BGP

EnableDnsHostname

boolean

Não

Especifica se o recurso de nome de host DNS deve ser ativado. Valores válidos:

  • false (padrão): Desativado.

  • true: Ativado.

false

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O ID da solicitação.

RequestId

string

O ID da solicitação.

43B72D30-25E1-4FA3-96A8-89374A521D1A

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "43B72D30-25E1-4FA3-96A8-89374A521D1A"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 Forbidden.VpcNotFound Specified VPC does not exist.
400 InvalidDescription.Malformed description not valid..
400 InvalidVpcName.Malformed Specified VPC name is not valid.
400 InvalidVpcDiscription.Malformed Specified VPC description is not valid.
400 InvalidParameter Specified UserCidr invalid format.
400 InvalidUserCidr.Quota Specified UserCidr number is greater than 3.
400 InvalidUserCidr.Malformed Specified UserCidr overlapping in of 100.64.0.0/10. O status do UserCidr está incorreto.
400 InvalidVpcId.NotFound Specified VPC name is not valid.
400 IncorrectVpcStatus Current VPC status does not support this operation.
400 IllegalCidrBlock Some subnet cidrBlock is not in the cidrBlock.
400 InvalidRegion.Malformed Specified RegionId is not vaild.
400 InvalidCidrBlock.Malformed Specified CIDR block is not valid.
400 OperationUnsupported.DisableIpv6 %s
400 OperationUnsupported.Ipv6Feature %s
400 ParamExclusive.EnableIpv6AndCidrBlock EnableIpv6 and CidrBlock is mutually exclusive.
400 OperationFailed.ClassicLinkEnabled Operation failed because classicLink is enabled.
400 OperationFailed.IpV6VSwitchInuse %s
400 OperationFailed.Ipv6GatewayInUse The IPv6 gateway is in use. Os atributos da VPC não podem ser modificados porque o gateway IPv6 ainda está em uso.
400 OperationFailed.QueryCenIpv6Status Failed to query the IPv6 status of the specified VPC in CEN. Falha ao consultar o status do IPv6 da VPC na instância CEN.
400 OperationUnsupported.CenIpv6Enabled The IPv6 feature is enabled in CEN. O recurso IPv6 já está ativado na instância CEN.
400 UnsupportedFeature.Ipv6Isp The Ipv6Isp feature is not supported. O recurso Ipv6Isp especificado não é suportado.
400 ResourceNotEnough.Ipv6Cidr The specified resource ipv6 cidr is not enough. Recursos de endereços IPv6 insuficientes.
400 OperationFailed.IPv6CidrNotReserved The IPv6 CIDR block is not reserved. A operação falhou. O bloco CIDR IPv6 especificado não está reservado.
400 IllegalParam.Ipv6Cidr The specified Ipv6CidrBlock is invalid. O Ipv6CidrBlock especificado é inválido.
400 InvalidIpv6Instance.NotFound The specified resource of InvalidIpv6Instance is not found. O recurso Ipv6Instance especificado não foi encontrado.
400 ExclusiveParam.EnableIpv6AndCidrBlock The param of EnableIpv6 and CidrBlock are mutually exclusive. Os parâmetros EnableIpv6 e CidrBlock são mutuamente exclusivos.
400 UnsupportedFeature.VpcDnsHostname The feature of vpc dns hostname is unsupported. O recurso de resolução de domínio privado da VPC não está disponível na região atual.
400 OperationFailed.Ipv6RouteEntryUsing VPC exist IPv6 Route Entry, cannot disable IPv6. A VPC contém roteamento IPv6. Você não pode desativar o IPv6.
400 OperationFailed.ModifyVpcDnsHostname Operation failed because DnsHostName resource is in transient state, please try again later. O recurso de nome de domínio DNS não está em um estado estável. Tente novamente mais tarde.
400 IncorrectStatus.VpcDnsHostnameStatus The DnsHostname status of vpc does not support this operation. O status atual do nome de domínio privado desta VPC não suporta esta operação.
400 OperationFailed.ConflictWithSecondaryCidr The modified cidr is conflict with the secondary cidr. A operação falhou porque o CidrBlock modificado entra em conflito com um bloco CIDR secundário.
400 IllegalParam.CidrBlock The param of CidrBlock [%s] is illegal. O bloco CIDR é inválido.
400 IncorrectStatus.Vpc The status of %s [%s] is incorrect. O status atual da instância não está estável.
404 InvalidVpcId.NotFound Specified VPC does not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.