Todos os produtos
Search
Central de documentação

Virtual Private Cloud:ModifyVpcAttribute

Última atualização: Jul 07, 2026

Modifica o nome e a descrição de uma VPC.

Descrição da operação

Descrição

Você não pode chamar a operação ModifyVpcAttribute repetidamente para modificar o nome e a descrição de uma VPC dentro do período de tempo especificado.

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

VpcId

string

Sim

O ID da VPC que 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://.

This is my 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 especificar um bloco CIDR IPv4 maior ou menor que o bloco CIDR IPv4 da VPC. A máscara de sub-rede deve ter de 8 a 28 bits. Se você especificar um bloco CIDR IPv4 menor e os endereços IP existentes não estiverem dentro do bloco CIDR, a modificação falhará.

Nota

Se você modificar o bloco CIDR de uma VPC, seus serviços existentes não serão afetados.

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 os blocos CIDR IPv6 devem ser ativados. Valores válidos:

  • true

  • false (padrão)

false

Ipv6CidrBlock

string

Não

O bloco CIDR IPv6 da VPC.

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

Ipv6Isp

string

Não

O tipo de bloco CIDR IPv6. Valores válidos:

  • BGP (padrão)

  • ChinaMobile

  • ChinaUnicom

  • ChinaTelecom

Nota

Se a sua conta Alibaba Cloud tiver permissão para ativar largura de banda de ISP único, você pode definir este parâmetro como ChinaTelecom, ChinaUnicom ou ChinaMobile.

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. The user CIDR block that you specify overlaps with 100.64.0.0/10.
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. You cannot modify the VPC attributes because the IPv6 gateway is in use.
400 OperationFailed.QueryCenIpv6Status Failed to query the IPv6 status of the specified VPC in CEN. The operation failed because the system failed to query the IPv6 status of the VPC that is attached to the CEN instance.
400 OperationUnsupported.CenIpv6Enabled The IPv6 feature is enabled in CEN. The IPv6 feature is already enabled for CEN.
400 UnsupportedFeature.Ipv6Isp The Ipv6Isp feature is not supported. The specified IPv6 ISP is not supported.
400 ResourceNotEnough.Ipv6Cidr The specified resource ipv6 cidr is not enough. Insufficient IPv6 CIDR block resources.
400 OperationFailed.IPv6CidrNotReserved The IPv6 CIDR block is not reserved.
400 IllegalParam.Ipv6Cidr The specified Ipv6CidrBlock is invalid. Ipv6CidrBlock is set to an invalid value.
400 InvalidIpv6Instance.NotFound The specified resource of InvalidIpv6Instance is not found. The error message returned because the IPv6 resource is not found.
400 ExclusiveParam.EnableIpv6AndCidrBlock The param of EnableIpv6 and CidrBlock are mutually exclusive. The param of EnableIpv6 and CidrBlock are mutually exclusive.
400 UnsupportedFeature.VpcDnsHostname The feature of vpc dns hostname is unsupported. The VPC private domain name function does not take effect in the current region.
400 OperationFailed.Ipv6RouteEntryUsing VPC exist IPv6 Route Entry, cannot disable IPv6. The VPC has an IPv6 route, and IPv6 must not be disabled.
400 OperationFailed.ModifyVpcDnsHostname Operation failed because DnsHostName resource is in transient state, please try again later. dns domain name resource is unstable, please try again later.
400 IncorrectStatus.VpcDnsHostnameStatus The DnsHostname status of vpc does not support this operation. The private domain name status of the current VPC does not support this operation.
400 OperationFailed.ConflictWithSecondaryCidr The modified cidr is conflict with the secondary cidr.
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.