AssociateVpcCidrBlock - Virtual Private Cloud - Centre de documentation Alibaba Cloud

Ajoute un bloc CIDR secondaire à un VPC.

Description de l'opération

Le nombre maximal de blocs CIDR secondaires pouvant être ajoutés à un VPC est le suivant :
- Un maximum de 5 blocs CIDR IPv4 secondaires peut être ajouté à un VPC.
- Un maximum de 5 blocs CIDR IPv6 secondaires peut être ajouté à un VPC.
L'opération AssociateVpcCidrBlock ne prend pas en charge l'ajout simultané de blocs CIDR secondaires au même VPC.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

vpc:AssociateVpcCidrBlock

create

*VPC.

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région du VPC auquel vous souhaitez ajouter un bloc CIDR secondaire. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.	ch-hangzhou
VpcId	string	Oui	L'identifiant du VPC auquel vous souhaitez ajouter un bloc CIDR secondaire.	vpc-o6wrloqsdqc9io3mg****
SecondaryCidrBlock	string	Non	Le bloc CIDR IPv4 secondaire à ajouter. Le bloc CIDR doit répondre aux exigences suivantes : Utilisez des adresses IPv4 privées spécifiées dans la RFC 1918 comme bloc CIDR IPv4 secondaire du cloud privé virtuel (VPC). Le masque de sous-réseau doit avoir une longueur de 16 à 28 bits. Exemples : 10.0.0.0/16, 172.16.0.0/16 et 192.168.0.0/16. Vous pouvez utiliser un bloc CIDR personnalisé autre que 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8 ou 169.254.0.0/16 et leurs sous-réseaux comme bloc CIDR IPv4 secondaire du cloud privé virtuel (VPC). Limites de configuration : Le bloc CIDR ne peut pas commencer par 0. Le masque de sous-réseau doit avoir une longueur de 16 à 28 bits. Le bloc CIDR secondaire ne peut pas chevaucher le bloc CIDR principal ou les blocs CIDR secondaires existants du VPC. Remarque Si vous n'utilisez pas de pool IPAM pour ajouter un bloc CIDR secondaire au VPC, vous devez spécifier soit le paramètre SecondaryCidrBlock, soit le paramètre Ipv6CidrBlock, mais pas les deux.	192.168.0.0/16
SecondaryCidrMask	integer	Non	Le masque de sous-réseau utilisé pour ajouter un bloc CIDR IPv4 secondaire à partir d'un pool IPAM au VPC. Remarque Lorsque vous utilisez un pool IPAM pour ajouter un bloc CIDR IPv4 secondaire au VPC, vous devez spécifier au moins SecondaryCidrBlock ou SecondaryCidrMask.	16
IPv6CidrBlock	string	Non	Le bloc CIDR IPv6 spécifié du VPC. Remarque Vous ne pouvez pas spécifier à la fois SecondaryCidrBlock et Ipv6CidrBlock.	2408:XXXX:0:6a::/56
Ipv6Isp	string	Non	Le type de bloc CIDR IPv6 du VPC. Valeurs valides : BGP (par défaut) : BGP IPv6 d'Alibaba Cloud. ChinaMobile : China Mobile (FAI unique). ChinaUnicom : China Unicom (FAI unique). ChinaTelecom : China Telecom (FAI unique). Remarque Si votre compte est inclus dans la liste blanche de la bande passante FAI unique en Chine, vous pouvez définir ce paramètre sur ChinaTelecom (China Telecom), ChinaUnicom (China Unicom) ou ChinaMobile (China Mobile).	BGP
IpVersion	string	Non	La version de l'adresse IP. Valeurs valides : IPV4 : adresse IPv4. IPV6 : adresse IPv6. Lorsque IpVersion est défini sur IPV6 et que SecondaryCidrBlock n'est pas spécifié, un bloc CIDR IPv6 secondaire est ajouté au VPC.	IPV4
IpamPoolId	string	Non	L'identifiant d'instance du pool IPAM.	ipam-pool-sycmt3p2a9v63i****
Ipv6CidrMask	integer	Non	Le masque de sous-réseau utilisé pour ajouter un bloc CIDR IPv6 à partir d'un pool IPAM au VPC. Remarque Lorsque vous utilisez un pool IPAM pour ajouter un bloc CIDR IPv6 secondaire au VPC, vous devez spécifier au moins IPv6CidrBlock ou Ipv6CidrMask.	56

Éléments de réponse

Élément	Type	Description	Exemple
	object	L'identifiant de la requête.
RequestId	string	L'identifiant de la requête.	C1221A1F-2ACD-4592-8F27-474E02883159
CidrBlock	string	Le bloc CIDR secondaire ajouté au VPC.	192.168.0.0/16
IpVersion	string	La version de l'adresse IP du bloc CIDR secondaire.	IPV4

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
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.	Le paramètre requis, bloc CIDR secondaire ou bloc CIDR IPv6, est manquant.
400	MissingParam.VpcId	You must specify VpcId.	Le paramètre requis VpcId est manquant.
400	UnsupportedFeature.Ipv6Isp	The Ipv6Isp feature is not supported.	La fonctionnalité Ipv6Isp spécifiée n'est pas prise en charge.
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.	Le pool IPAM ne peut pas être vide.
400	MissingParam.SecondaryCidrMask	The parameter SecondaryCidrMask must be input.	Le paramètre SecondaryCidrMask est requis.
400	IllegalParam.SecondaryCidrMask	The specified Secondary CIDR Mask is illegal.	Le paramètre SecondaryCidrMask spécifié n'est pas valide.
400	OperationDenied.RequestRegionInvalid	The operation is not allowed because the request is not invoked in the region of the IPAM pool.	L'opération est rejetée car la requête n'a pas été appelée dans la région où réside le pool IPAM.
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.	L'opération est rejetée car vous ne pouvez pas créer de VPC ni ajouter un bloc CIDR secondaire à un VPC à partir d'un pool IPAM qui ne possède pas d'attribut de région.
400	MissingParam.CidrOrCidrMask	The CIDR or CIDR Mask must be input.	Spécifiez le paramètre Cidr ou CidrMask lorsque vous créez une ressource à partir d'un pool IPAM.
400	OperationDenied.CidrInExcludeCidrs	The operation is not allowed because the input CIDR is within the illegal CIDRs.	L'opération est rejetée car le bloc CIDR spécifié se trouve dans une plage de blocs CIDR non valide.
400	OperationDenied.AvailableCidrInsufficient	The operation is not allowed because available CIDR is insufficient.	L'opération est rejetée car les ressources de bloc CIDR disponibles sont insuffisantes.
400	UnsupportedFeature.Ipam	IPAM is not supported in this region.
400	UnsupportedFeature.VpcIpamIpv6	The specified IPAM pool does not support the IPv6 feature.	Le pool IPAM spécifié ne prend pas en charge IPv6.
400	OperationDenied.CidrUnavailableInPool	The operation is not allowed because the CIDR is unavailable in the IPAM pool.	L'opération a été rejetée car le bloc CIDR n'est pas disponible dans le pool IPAM.
400	InvalidIpv6CidrBlock.Malformed	Param Ipv6CidrBlock is malformed.	Le paramètre de bloc CIDR IPv6 n'est pas valide.
400	MissingParam.IpVersion	The parameter IpVersion is missing.	Le paramètre IpVersion est manquant.
400	Mismatch.IpVersionAndIpamPoolIpVersion	The input IpVersion is inconsistent with the IpVersion of the input IPAM pool.	L'IpVersion spécifiée ne correspond pas à l'IpVersion du pool d'adresses spécifié.
400	IllegalParam.Ipv6CidrBlock	The parameter of Ipv6CidrBlock is illegal.	Le bloc CIDR IPv6 n'est pas valide.
400	OperationFailed.Ipv6CidrBlockOverLapped	The input IPv6 CIDR block overlaps with the existing ones.	Le bloc CIDR IPv6 spécifié chevauche un bloc CIDR existant.
400	QuotaExceeded.IPv6CidrBlock	The number of IPv6 CIDR blocks in the VPC exceeds the limit.	Le nombre de blocs CIDR IPv6 dans le VPC a dépassé la limite.
400	OperationDenied.MaskOfCidrIsNotAllowed	The input mask or mask of the input CIDR is not allowed.	Le masque ou le masque de bloc CIDR spécifié n'est pas dans la plage autorisée.
400	IllegalParam.Ipv6Isp	The specified Ipv6Isp is illegal.	Le paramètre Ipv6Isp spécifié n'est pas valide.
400	IllegalParam.CidrMask	The input CIDR mask is illegal.	Le masque de bloc CIDR spécifié n'est pas valide.
400	OperationDenied.CidrMaskTooLarge	The operation is denied because the CIDR mask %s is larger than the allocationMaxNetmask %s of the pool.	Le masque du paramètre Cidr ou du paramètre CidrMask dépasse la longueur maximale de masque réseau spécifiée dans la règle de conformité du pool IPAM.
500	OperationFailed.ResourceNotEnough	Insufficient resources.
403	Forbbiden	User not authorized to operate on the specified resource.	L'EIP n'appartient pas à l'appelant actuel. Vérifiez que vous disposez des autorisations nécessaires pour appeler cet EIP.
404	ResourceNotFound.IpamPool	The dependent IPAM pool is not found.	Le pool IPAM dépendant n'existe pas.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.