CreateTransitRouterVpcAttachment - - Centre de documentation Alibaba Cloud

Appelle l'opération CreateTransitRouterVpcAttachment pour rattacher une instance de cloud privé virtuel (VPC) à une instance de routeur de transit Enterprise Edition afin d'activer l'appairage de réseau privé. Une fois l'attachement créé, l'instance de routeur de transit vous aide à mettre en œuvre la connectivité du réseau privé via le transfert et le routage.

Description de l'opération

Vous pouvez créer un rattachement VPC pour un routeur de transit Édition Entreprise de deux manières :
- Si vous avez déjà créé une instance de routeur de transit Édition Entreprise dans la région cible, spécifiez VpcId, ZoneMappings.N.VSwitchId, ZoneMappings.N.ZoneId, TransitRouterId et RegionId pour créer le rattachement VPC.
- Si vous n'avez pas créé d'instance de routeur de transit Édition Entreprise dans la région cible, spécifiez VpcId, ZoneMappings.N.VSwitchId, ZoneMappings.N.ZoneId, CenId et RegionId pour créer le rattachement VPC. Le système utilise la création automatique pour créer une instance de routeur de transit Édition Entreprise lorsque vous créez le rattachement VPC.
CreateTransitRouterVpcAttachment est une opération asynchrone. Le système renvoie un identifiant de rattachement VPC avant que le rattachement VPC ne soit créé. La tâche de création s'exécute en arrière-plan. Appelez ListTransitRouterVpcAttachments pour interroger l'état du rattachement VPC.
- Lorsque le rattachement VPC est dans l'état Attaching, le rattachement VPC est en cours de création. Dans cet état, vous pouvez uniquement interroger le rattachement VPC et ne pouvez pas exécuter d'autres opérations.
- Lorsque le rattachement VPC est dans l'état Attached, le rattachement VPC est créé.
Une fois qu'un rattachement VPC est créé, il n'est associé à aucune table de routage de routeur de transit pour les relations d'apprentissage de routage ou les relations de transfert par défaut.

Avant de commencer

Avant d'appeler cette opération pour créer un rattachement VPC, assurez-vous que les exigences suivantes sont remplies :

L'instance VPC dispose d'au moins une instance vSwitch avec au moins une adresse IP disponible dans une zone prise en charge par le routeur de transit Édition Entreprise. Pour plus d'informations sur les régions et les zones prises en charge par les routeurs de transit Édition Entreprise, consultez Régions et zones prises en charge par les routeurs de transit Édition Entreprise.
Si vous souhaitez rattacher une instance connectée à un VPC appartenant à un compte différent, obtenez d'abord une autorisation inter-comptes. Pour plus d'informations, consultez Autorisation d'instance connectée à un VPC inter-comptes.
La création d'un rattachement VPC entraîne des frais. Assurez-vous de comprendre les règles de facturation. Pour plus d'informations, consultez Facturation.

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.

cen:CreateTransitRouterVpcAttachment

create

CenInstance.

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

TransitRouter.

acs:cen:*:{#accountId}:centransitrouter/{#TransitRouterId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Générez une valeur unique à partir de votre client pour ce paramètre. ClientToken ne prend en charge que les caractères ASCII. Remarque Si vous ne spécifiez pas ce paramètre, le système utilise le RequestId de la requête API comme ClientToken. Le RequestId de chaque requête API est différent.	02fb3da4-130e-11e9-8e44-001****
CenId	string	Non	L'identifiant de l'instance du Cloud Enterprise Network (CEN).	cen-j3jzhw1zpau2km****
TransitRouterId	string	Non	L'identifiant de l'instance du routeur de transit Enterprise Edition.	tr-bp1su1ytdxtataupl****
RegionId	string	Non	L'identifiant de la région où l'instance VPC est déployée. Vous pouvez appeler DescribeChildInstanceRegions pour interroger les identifiants de région.	cn-hangzhou
TransitRouterAttachmentName	string	Non	Le nom de l'attachement VPC. Le nom peut être laissé vide ou contenir de 1 à 128 caractères. Il ne peut pas commencer par http:// ou https://.	testname
TransitRouterAttachmentDescription	string	Non	La description de l'attachement VPC. La description peut être laissée vide ou contenir de 1 à 256 caractères. Elle ne peut pas commencer par http:// ou https://.	testname
VpcId	string	Oui	L'identifiant de l'instance VPC.	vpc-bp1kbjcre9vtsebo1****
VpcOwnerId	integer	Non	L'identifiant du compte Alibaba Cloud auquel l'instance VPC appartient. La valeur par défaut est l'identifiant du compte Alibaba Cloud actuellement connecté. Remarque Ce paramètre est requis si vous souhaitez rattacher une instance réseau appartenant à un compte différent.	1250123456123456
ChargeType	string	Non	La méthode de facturation. Valeur par défaut : POSTPAY, qui indique la méthode de facturation à l'usage.	POSTPAY
DryRun	boolean	Non	Indique si un test à blanc doit être effectué sur la requête, y compris les vérifications d'autorisation et la validation de l'état de l'instance. Valeurs valides : false (par défaut) : envoie une requête normale et crée un VPC après la réussite de la vérification. Utilisez cette valeur pour créer un VPC. true : envoie une requête de test à blanc pour validation uniquement, sans créer l'attachement VPC. La vérification comprend la spécification des paramètres requis et la validité du format de la requête. Si la vérification échoue, l'erreur correspondante est renvoyée. Si la vérification réussit, le code d'erreur `DryRunOperation` est renvoyé.	false
ZoneMappings	array<object>	Oui	Sélectionnez une instance vSwitch dans une zone prise en charge par le routeur de transit Enterprise Edition. Vous pouvez ajouter jusqu'à 10 entrées à la fois.
	object	Non	Les informations sur les zones prises en charge par le routeur de transit Enterprise Edition et les instances vSwitch correspondantes.
VSwitchId	string	Oui	L'instance vSwitch dans une zone prise en charge par le routeur de transit Enterprise Edition. Vous pouvez sélectionner des instances vSwitch pour jusqu'à 10 zones à la fois.	vsw-bp1a214sbus8z3b54****
ZoneId	string	Oui	L'identifiant d'une zone prise en charge par le routeur de transit Enterprise Edition. Vous pouvez appeler DescribeZones pour interroger les identifiants de zone. Vous pouvez sélectionner jusqu'à 10 zones à la fois.	cn-hangzhou-h
AutoPublishRouteEnabled	boolean	Non	Indique si le routeur de transit Enterprise Edition publie automatiquement les entrées de routage vers l'instance VPC. false (par défaut) : ne publie pas automatiquement les entrées de routage. true : publie automatiquement les entrées de routage.	true
TransitRouterVPCAttachmentOptions	object	Non	La liste des attributs de fonctionnalité pour l'attachement VPC (bientôt obsolète — utilisez plutôt le nouveau paramètre Options).
	string	Non	L'attribut de fonctionnalité pour l'attachement VPC (bientôt obsolète — utilisez plutôt le nouveau paramètre Options). ipv6Support : indique si IPv6 doit être activé. enable : active IPv6. disable : désactive IPv6. Désactive IPv6 pour l'attachement. Remarque Avant d'activer IPv6 pour un attachement VPC, assurez-vous que l'instance VPC et ses instances vSwitch associées ont IPv6 activé. Pour plus d'informations, consultez AllocateVpcIpv6Cidr et CreateVSwitchCidrReservation.	disable
Tag	array<object>	Non	La liste des balises. Vous pouvez spécifier jusqu'à 20 balises à la fois.
	object	Non	La balise.
Key	string	Non	La clé de balise de la ressource. Si ce paramètre est spécifié, il ne peut pas s'agir d'une chaîne vide. La clé de balise peut contenir jusqu'à 64 caractères et ne peut pas commencer par `aliyun` ou `acs:`. Elle ne peut pas contenir `http://` ou `https://`. Vous pouvez spécifier jusqu'à 20 clés de balise à la fois.	tagtest
Value	string	Non	La valeur de balise de la ressource. Si ce paramètre est spécifié, il ne peut pas être vide. La valeur de balise peut contenir jusqu'à 128 caractères et ne peut pas commencer par aliyun ou acs:. Elle ne peut pas contenir http:// ou https://. Chaque clé de balise correspond à une valeur de balise. Vous pouvez spécifier jusqu'à 20 paires clé-valeur de balise à la fois.	tagtest
Options	object	Non	La collection des attributs de fonctionnalité.
ApplianceModeSupport	string	Non	Indique si le mode de redirection du trafic de l'appliance réseau doit être activé. disable (par défaut) : désactivé. enable : activé.	enable
Ipv6Support	string	Non	Indique si la prise en charge d'IPv6 doit être activée. disable (par défaut) : désactivée. enable : activée.	enable

Éléments de réponse

Élément	Type	Description	Exemple
	object	Le résultat de la réponse.
RequestId	string	L'identifiant de la requête.	C087A369-82B9-43EF-91F4-4B63A9C6E6B6
TransitRouterAttachmentId	string	L'identifiant de l'attachement VPC.	tr-attach-ia340z7xis7t5s****

Exemples

JSON format

{
  "RequestId": "C087A369-82B9-43EF-91F4-4B63A9C6E6B6",
  "TransitRouterAttachmentId": "tr-attach-ia340z7xis7t5s****"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	OperationUnsupported.TransitRouterRegionId	The specified TransitRouterRegion does not support the operation.
400	NoPermission.AliyunServiceRoleForCEN	You are not authorized to create the service linked role. Role Name: AliyunServiceRoleForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission.	Vous n'avez pas l'autorisation de créer le rôle lié au service. Nom du rôle : AliyunServiceRoleForCEN. Nom du service : cen.aliyuncs.com. Assurez-vous que l'autorisation ram:CreateServiceLinkedRole a été accordée à l'utilisateur actuel.
400	IllegalParam.RegionId	The Specified Parameter RegionId is illegal	La région spécifiée dans la requête n'est pas valide.
400	MissingParam.CenIdOrRegionId	Either CenId or RegionId must be specified.	CenId ou RegionId est un paramètre requis.
400	IllegalParam.ZoneId	The specified ZoneId is illegal.	La zone spécifiée n'est pas valide.
400	IllegalParam.ChargeType	The specified ChargeType is illegal.	Le type de facturation est invalide.
400	InvalidTransitRouterId.NotFound	The specified TransitRouterId is not found.	Le routeur de transit correspondant est introuvable.
400	IncorrectStatus.VpcResource	The resource is not in a valid state for the attachment operation.	La ressource VPC n'est pas dans un état stable et ne peut faire l'objet d'aucune opération. Attendez que les opérations en cours sur le VPC actuel soient terminées, puis réessayez.
400	IncorrectStatus.Vpc	The resource is not in a valid state for the attachment operation.	L'état actuel du VPC ne prend pas en charge cette opération. Réessayez ultérieurement.
400	IncorrectStatus.VpcOrVswitch	The Vpc Or Vswith is not in a valid state for the attachment operation.	L'état actuel du VPC ou du vSwitch ne prend pas en charge cette opération. Réessayez ultérieurement.
400	OperationNotSupport.VpcAutoRoutesPublish	Auto publish vpc routes is not supported in this region.	L'annonce automatique des routes VPC n'est pas prise en charge dans la région actuelle.
400	InvalidOperation.VpnAssociated	The operation is not supported because the VPC is associated with VPN.	Le VPC actuel est attaché à un VPN. La fonctionnalité de synchronisation automatique du routage ne peut pas être activée.
400	Forbbiden.TransitRouterServiceNotOpen	The user has not open transit router service.	Le service de routeur de transit n'est pas activé. Activez le service et réessayez.
400	IllegalParam.ZoneMappings	The Specified Parameter ZoneMappings is illegal	Les ZoneMappings spécifiés dans le paramètre ne sont pas valides.
400	OperationUnsupported.TransitRouterType	The specified TransitRouterType does not support the operation.	Le type de routeur de transit actuel ne prend pas en charge cette opération.
400	InvalidCenId.NotFound	CenId is not found.	L'instance CEN n'existe pas.
400	IllegalParam.VSwitchId	VSwitchId is illegal.	Le VSwitchId spécifié dans le paramètre n'est pas valide.
400	IncorrectStatus.TransitRouterInstance	The status of TransitRouter is incorrect.	Le routeur de transit est dans un état non valide.
400	OperationUnsupported.CenFullLevel	CEN full level does not support TransitRouter	Une instance CEN de type Full ne prend pas en charge la création de routeurs de transit Enterprise Edition.
400	IllegalParam.ServiceMode	ServiceMode is illegal.	Le ServiceMode n'est pas valide.
400	QuotaFull.ChildInstanceRelatedCen	The childinstance has exceed the quota of the times that a childinstance can be attached as an attachment.	Le nombre d'instances CEN associées à cette instance a atteint la limite supérieure. L'instance ne peut pas être chargée.
400	OperationUnsupported.CloudBoxVswNotSupport	Cloud Box vsw does not support.	Le vSwitch d'une CloudBox ne peut pas être chargé.
400	IncorrectStatus.TransitRouter	The status of TransitRouter is incorrect.	L'état actuel du routeur de transit ne prend pas en charge cette opération. Réessayez ultérieurement.
400	Duplicated.ZoneMapping	The parameter ZoneMapping is duplicated.	ZoneMapping contient des entrées en double.
400	QuotaExceeded.CenQuotaVpcAttachPerTransitRouter	The maximum number of VPC attachment per Transit Router is exceeded.	Le nombre de VPC pouvant être connectés à chaque routeur de transit a dépassé la limite.
400	IncorrectStatus.VpcRouteTable	The VPC route table is not in a desired state.	La table de routage VPC associée à cette opération n'est pas dans un état stable et ne peut faire l'objet d'aucune opération. Réessayez ultérieurement.
400	InvalidStatus.VpcAttachedFullModeCen	The VPC has been attached to another CEN instance whose protection level is FULL.	Le VPC spécifié dans la requête est déjà associé à une autre instance CEN avec le niveau de protection défini sur FULL et ne peut pas être associé à d'autres instances CEN.
400	Forbbiden.AttachChildInstanceAcrossBid	VPCs that belong to another BID cannot be associated. You need to apply for cross-BID attaching.	L'association d'un VPC sous un compte bid différent n'est pas autorisée.
400	InvalidOperation.VpcAutoRoutesPublishInOtherCEN	The specified VPC already has its routes synchronized with another CEN instance.	Le VPC actuel a déjà activé la synchronisation automatique du routage dans une autre instance CEN. Cette opération n'est pas prise en charge.
400	QuotaExceeded.VpcAutoRoutesPublishPerTransitRouter	The number of VPCs that have route synchronization enabled has reached the upper limit.	Le nombre de VPC avec la synchronisation automatique du routage activée a atteint la limite supérieure.
400	InsufficientIpAddr.vsw	Insufficient available IP addresses in the vSwitch.	Le nombre d'adresses IP actives dans le vSwitch est insuffisant.
400	Forbidden.ResourceOwnerTransitRouterServiceNotOpen	The resource owner user has not opened transit router service.	Le service de routeur de transit du compte propriétaire de la ressource n'est pas activé. Informez le propriétaire du compte d'activer le service et réessayez.
400	IllegalParam.TransitRouterRegionId	TransitRouterRegionId is illegal.	Le TransitRouterRegionId est invalide.
400	InvalidTransitRouterMode.NeedUpgrade	TransitRouter need to upgrade.	Le mode actuel du routeur de transit n'est pas pris en charge.
400	IllegalParam.Ipv6Support	Ipv6Support is illegal. Valid Values are [enable, disable].	La valeur du paramètre de requête Ipv6Support est invalide. Valeurs valides : enable et disable.
400	OperationFailed.VSwitchNotFound	The specified vswitch not found.	Le VSwitchId spécifié n'existe pas. Vérifiez si le vSwitch est disponible ou spécifiez un autre vSwitch disponible.
400	OperationFailed.VSwitchIpv6CidrNotAllocated	The specified vswitch does not have IPv6 address allocated.	Le vSwitch spécifié n'a pas IPv6 activé. Activez IPv6 avant d'effectuer cette opération.
400	Forbidden.ResourceOwnerTransitRouterServiceExpired	The transit router service of the account to which the resource belongs has been suspended due to arrears. Please notify the other party to renew the service and try again.	Le service de routeur de transit du compte propriétaire de la ressource a été suspendu en raison d'un retard de paiement. Informez le propriétaire du compte de renouveler le service et réessayez.
400	Forbidden.TransitRouterServiceExpired	The transit router service is out of service.	Le service de routeur de transit a été suspendu en raison d'un retard de paiement. Renouvelez le service et réessayez.
400	InvalidParameter	Invalid parameter.	Le paramètre n'est pas valide.
400	Unauthorized	The AccessKeyId is unauthorized.	Vous ne disposez pas des autorisations suffisantes pour effectuer cette opération. Soumettez un ticket pour obtenir de l'aide.
400	InvalidParameter.ResourceType	The specified parameter ResourceType is invalid.	Le paramètre ResourceType spécifié n'est pas valide.
400	ParamExclusive.TransitRouterVPCAttachmentOptionsAndOptions	When creating or modifying a VPC attachment, the input parameter TransitRouterVPCAttachmentOptions and Options cannot be used at the same time.	Lors de la création ou de la modification d'une connectivité réseau VPC, les paramètres TransitRouterVPCAttachmentOptions et Options ne peuvent pas être utilisés en même temps.
400	InvalidParameter.ApplianceModeSupport	The specified parameter ApplianceModeSupport is invalid.	Le paramètre ApplianceModeSupport n'est pas valide.
400	InvalidParameter.Ipv6Support	The specified parameter Ipv6Support is invalid.	Le paramètre Ipv6Support spécifié est invalide.
400	INVALID_OPERATION_RESOURCE_NOT_SUPPORT_APPLIANCE_MODE	Only VPC attachment support appliance mode.	Seule la connectivité réseau VPC prend en charge le modèle de redirection du trafic des éléments réseau.
400	InvalidParameter.TagValue	The specified parameter TagValue is invalid.	Le paramètre Tag Value spécifié n'est pas valide.
400	InvalidParameter.CenBandwidthPackageId	The specified parameter CenBandwidthPackageId is invalid.	Le paramètre CenBandwidthPackageId spécifié est invalide.
400	InvalidParameter.CenId	The specified parameter CenId is invalid.	Le paramètre CenId spécifié est invalide.
400	InvalidParameter.TransitRouterId	The specified parameter TransitRouterId is invalid.	Le paramètre TransitRouterId spécifié n'est pas valide.
400	InvalidParameter.AssociateRouteTableId	The specified parameter AssociateRouteTableId is invalid.	Le paramètre AssociateRouteTableId n'est pas valide.
400	OperationFailed.PostPay95BwpNotAllowEnterpriseTr	Cbn with post pay 95 bandwidth package does not allow enterprise tr.	Une instance CEN qui utilise un ancien plan de bande passante au 95e centile ne prend pas en charge la création d'un routeur de transit Enterprise Edition.
400	OperationUnsupported.VpcRoutePropagationSource	The operation on this VPC route propagation source is not supported.	Les opérations sur cette source de propagation de routes VPC ne sont pas prises en charge.
404	InvalidVSwitchId.NotFound	The specified VSwitchId is not found.	Le VSwitchId spécifié n'existe pas.
409	InvalidOperation.CenInstanceStatus	The CEN instance is not in a valid state for the operation.	L'état actuel du CEN ne prend pas en charge cette opération. Réessayez plus tard.
409	IncorrectStatus.VpcSwitch	The resource is not in a valid state for the attachment operation.

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

Notes de version

Consultez Notes de version pour la liste complète.