ModifyVpcAttribute - Virtual Private Cloud - Centro de documentación de Alibaba Cloud

Modifica la configuración de una VPC especificada.

Descripción de la operación

La operación ModifyVpcAttribute no admite modificaciones simultáneas en la configuración de la misma VPC.
La operación ModifyVpcAttribute puede habilitar IPv6 para una VPC. Sin embargo, no es posible modificar el bloque CIDR de IPv6 ni el tipo de bloque CIDR de IPv6 de una VPC que ya tiene IPv6 habilitado.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

vpc:ModifyVpcAttribute

update

*VPC

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

vpc:tag

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
VpcId	string	Sí	El ID de la VPC que desea modificar.	vpc-bp1qtbach57ywecf****
Description	string	No	La nueva descripción de la VPC. La descripción debe tener entre 1 y 256 caracteres de longitud y no puede comenzar con `http://` o `https://`.	Esta es mi VPC
VpcName	string	No	El nuevo nombre de la VPC. El nombre debe tener entre 1 y 128 caracteres de longitud y no puede comenzar con `http://` o `https://`.	Vpc-1
CidrBlock	string	No	El nuevo bloque CIDR de IPv4 de la VPC. Puede expandir o reducir el bloque CIDR dentro del bloque CIDR de IPv4 original de la VPC. La máscara de subred recomendada es de 16 a 28 bits. Si reduce el bloque CIDR de IPv4 de la VPC y las direcciones IP que ya están en uso quedan fuera del bloque CIDR de destino, la modificación fallará. Nota Modificar el bloque CIDR de IPv4 de una VPC no afecta los servicios existentes.	192.168.0.0/24
RegionId	string	No	El ID de la región de la VPC. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
EnableIPv6	boolean	No	Especifica si se debe habilitar IPv6. Valores válidos: false (predeterminado): deshabilitado. true: habilitado.	false
Ipv6CidrBlock	string	No	El bloque CIDR de IPv6 de la VPC. Cuando habilita IPv6 para una VPC, el sistema asigna un bloque CIDR de IPv6. Para especificar un bloque CIDR de IPv6, primero invoque la operación AllocateVpcIpv6Cidr para reservar un bloque CIDR de IPv6 específico y luego páselo como parámetro. Nota Para una VPC que ya tiene IPv6 habilitado, no es posible modificar el bloque CIDR de IPv6 mediante este parámetro.	2408:XXXX:0:6a::/56
Ipv6Isp	string	No	El tipo de bloque CIDR de IPv6 de la VPC. Valores válidos: BGP (predeterminado): BGP IPv6 de Alibaba Cloud. ChinaMobile: China Mobile (ISP único). ChinaUnicom: China Unicom (ISP único). ChinaTelecom: China Telecom (ISP único). Nota Si usted es un usuario que tiene habilitada la lista blanca de ancho de banda de ISP único, puede establecer este parámetro en ChinaTelecom (China Telecom), ChinaUnicom (China Unicom) o ChinaMobile (China Mobile).	BGP
EnableDnsHostname	boolean	No	Especifica si se debe habilitar la función de nombre de host DNS. Valores válidos: false (predeterminado): deshabilitado. true: habilitado.	false

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El ID de la solicitud.
RequestId	string	El ID de la solicitud.	43B72D30-25E1-4FA3-96A8-89374A521D1A

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
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.	The operation failed because the specified 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.
400	IllegalParam.CidrBlock	The param of CidrBlock [%s] is illegal.	The CidrBlock parameter is set to an invalid value.
404	InvalidVpcId.NotFound	Specified VPC does not exist.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.