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

Agrega un bloque CIDR secundario a una VPC.

Descripción de la operación

El número máximo de bloques CIDR secundarios que se pueden agregar a una VPC es el siguiente:
- Se pueden agregar hasta 5 bloques CIDR IPv4 secundarios a una VPC.
- Se pueden agregar hasta 5 bloques CIDR IPv6 secundarios a una VPC.
La operación AssociateVpcCidrBlock no admite la adición simultánea de bloques CIDR secundarios a la misma VPC.

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

create

*VPC

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región de la VPC a la que desea agregar un bloque CIDR secundario. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.	ch-hangzhou
VpcId	string	Sí	El ID de la VPC a la que desea agregar un bloque CIDR secundario.	vpc-o6wrloqsdqc9io3mg****
SecondaryCidrBlock	string	No	El bloque CIDR IPv4 secundario que se va a agregar. El bloque CIDR debe cumplir los siguientes requisitos: Utilice una dirección IPv4 privada especificada en RFC 1918 como bloque CIDR IPv4 secundario de la nube privada virtual (VPC). La máscara de subred debe tener una longitud de 16 a 28 bits. Ejemplos: 10.0.0.0/16, 172.16.0.0/16 y 192.168.0.0/16. Puede utilizar un bloque CIDR personalizado distinto de 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8, 169.254.0.0/16 o sus subredes como bloque CIDR IPv4 secundario de la nube privada virtual (VPC). Límites de configuración: El bloque CIDR no puede comenzar con 0. La máscara de subred debe tener una longitud de 16 a 28 bits. El bloque CIDR secundario no puede superponerse con el bloque CIDR principal ni con los bloques CIDR secundarios existentes de la VPC. Nota Si no utiliza un pool de IPAM para agregar un bloque CIDR secundario a la VPC, debe especificar el parámetro SecondaryCidrBlock o el parámetro Ipv6CidrBlock, pero no ambos.	192.168.0.0/16
SecondaryCidrMask	integer	No	La máscara de subred utilizada para agregar un bloque CIDR IPv4 secundario desde un pool de IPAM a la VPC. Nota Cuando utiliza un pool de IPAM para agregar un bloque CIDR IPv4 secundario a la VPC, debe especificar al menos uno de los parámetros SecondaryCidrBlock o SecondaryCidrMask.	16
IPv6CidrBlock	string	No	El bloque CIDR IPv6 especificado de la VPC. Nota No puede especificar SecondaryCidrBlock e Ipv6CidrBlock simultáneamente.	2408:XXXX:0:6a::/56
Ipv6Isp	string	No	El tipo de bloque CIDR 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 su cuenta está incluida en la lista blanca de ancho de banda de ISP único de China, puede configurar este parámetro como ChinaTelecom (China Telecom), ChinaUnicom (China Unicom) o ChinaMobile (China Mobile).	BGP
IpVersion	string	No	La versión de la dirección IP. Valores válidos: IPV4: dirección IPv4. IPV6: dirección IPv6. Cuando IpVersion se establece en IPV6 y no se especifica SecondaryCidrBlock, se agrega un bloque CIDR IPv6 secundario a la VPC.	IPV4
IpamPoolId	string	No	El ID de instancia del pool de IPAM.	ipam-pool-sycmt3p2a9v63i****
Ipv6CidrMask	integer	No	La máscara de subred utilizada para agregar un bloque CIDR IPv6 desde un pool de IPAM a la VPC. Nota Cuando utiliza un pool de IPAM para agregar un bloque CIDR IPv6 secundario a la VPC, debe especificar al menos uno de los parámetros IPv6CidrBlock o Ipv6CidrMask.	56
RegionId	string	Sí	El ID de la región de la VPC a la que desea agregar un bloque CIDR secundario. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.	ch-hangzhou

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El ID de la solicitud.
RequestId	string	El ID de la solicitud.	C1221A1F-2ACD-4592-8F27-474E02883159
CidrBlock	string	El bloque CIDR secundario agregado a la VPC.	192.168.0.0/16
IpVersion	string	La versión de dirección IP del bloque CIDR secundario.	IPV4

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "C1221A1F-2ACD-4592-8F27-474E02883159",
  "CidrBlock": "192.168.0.0/16",
  "IpVersion": "IPV4"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidVpc.NotFound	%s
400	IncorrectStatus.Vpc	%s
400	ParamExclusive.SecondaryCidrAndIpv6Cidr	%s
400	OperationUnsupported.VpcMultiCidr	%s
400	MissingParam.SecondaryCidrOrIpv6Cidr	%s
400	OperationUnsupported.IPv6ULA	%s
400	OperationFailed.Ipv6CidrBlockExisted	%s
400	InvalidIpv6ULACidrBlock.Malformed	%s
400	QuotaExceeded.GUAIpv6CidrBlock	%s
400	IllegalParam.Ipv6CidrType	%s
400	OperationUnsupported.OnlyULA	%s
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.
400	IllegalParam.SecondaryCidrBlock	%s
400	Duplicated.SecondaryCidrBlock	%s
400	OperationFailed.ConflictWithEntry	%s
400	QuotaExceeded.VpcMultiCidr	%s
400	MissingParam.SecondaryCidrBlockOrIpv6CidrBlock	Either SecondaryCidrBlock or Ipv6CidrBlock must be specified.	The secondary CIDR block or the IPv6 CIDR block is not specified.
400	MissingParam.VpcId	You must specify VpcId.	You must specify VpcId.
400	UnsupportedFeature.Ipv6Isp	The Ipv6Isp feature is not supported.	The specified IPv6 ISP is not supported.
400	IllegalParam.IpVersion	%s
400	OperationDenied.GUAIpv6CidrBlock	The operation is not allowed because this ipv6 CIDR is not reserved.
400	OperationFailed.IPv6CidrNotReserved	Operation failed because this ipv6 cidr is not reserved.
400	InvalidCidrBlock	Specified CIDR block is already exists.
400	IllegalParam.IpamPool	The specified IPAM pool cannot be empty.	The IPAM pool cannot be empty.
400	MissingParam.SecondaryCidrMask	The parameter SecondaryCidrMask must be input.	SecondaryCidrMask is required.
400	IllegalParam.SecondaryCidrMask	The specified Secondary CIDR Mask is illegal.	Invalid SecondaryCidrMask.
400	OperationDenied.RequestRegionInvalid	The operation is not allowed because the request is not invoked in the region of the IPAM pool.	The operation is not allowed because the request is not invoked in the region of the IPAM pool.
400	OperationDenied.IpamPoolNotInRegion	The operation is not allowed because the IPAM pool not in specific region does not support creating VPC or associating CIDR for VPC.	The operation is not allowed because the IPAM pool not in specific region does not support creating VPC or associating CIDR for VPC.
400	MissingParam.CidrOrCidrMask	The CIDR or CIDR Mask must be input.	The CIDR or CIDR Mask must be input.
400	OperationDenied.CidrInExcludeCidrs	The operation is not allowed because the input CIDR is within the illegal CIDRs.	The operation is not allowed because the input CIDR is within the illegal CIDRs.
400	OperationDenied.AvailableCidrInsufficient	The operation is not allowed because available CIDR is insufficient.	The operation is not allowed because available CIDR is insufficient.
400	UnsupportedFeature.Ipam	IPAM is not supported in this region.	The IPAM feature is not supported in this region.
400	UnsupportedFeature.VpcIpamIpv6	The specified IPAM pool does not support the IPv6 feature.	The specified IPAM pool does not support the IPv6 feature.
400	OperationDenied.CidrUnavailableInPool	The operation is not allowed because the CIDR is unavailable in the IPAM pool.	The operation is not allowed because the CIDR is unavailable in the IPAM pool.
400	InvalidIpv6CidrBlock.Malformed	Param Ipv6CidrBlock is malformed.	IPv6 network segment is illegal
400	MissingParam.IpVersion	The parameter IpVersion is missing.	The parameter IpVersion is missing.
400	Mismatch.IpVersionAndIpamPoolIpVersion	The input IpVersion is inconsistent with the IpVersion of the input IPAM pool.	The input IpVersion is inconsistent with the IpVersion of the input IPAM pool.
400	IllegalParam.Ipv6CidrBlock	The parameter of Ipv6CidrBlock is illegal.	The Ipv6CidrBlock parameter is invalid.
400	OperationFailed.Ipv6CidrBlockOverLapped	The input IPv6 CIDR block overlaps with the existing ones.	The input IPv6 CIDR block overlaps with the existing ones.
400	QuotaExceeded.IPv6CidrBlock	The number of IPv6 CIDR blocks in the VPC exceeds the limit.	The number of IPv6 CIDR blocks in the VPC exceeds the limit.
400	OperationDenied.MaskOfCidrIsNotAllowed	The input mask or mask of the input CIDR is not allowed.	The input mask or mask of the input CIDR is not allowed.
400	IllegalParam.Ipv6Isp	The specified Ipv6Isp is illegal.	The specified Ipv6Isp is illegal.
400	IllegalParam.CidrMask	The input CIDR mask is illegal.	The input CIDR mask is illegal.
500	OperationFailed.ResourceNotEnough	Insufficient resources.	The resources that you request are insufficient. If you still want to request the resources, submit a ticket.
403	Forbbiden	User not authorized to operate on the specified resource.	User not authorized to operate on the specified resource.
404	ResourceNotFound.IpamPool	The dependent IPAM pool is not found.	The dependent IPAM pool is not found.

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.