CreateVpcPeerConnection - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Avant de créer une connexion d'appairage VPC, vérifiez que les conditions suivantes sont remplies :

Cloud Data Transfer (CDT) est activé pour gérer la facturation des transferts de données internes aux frontières. Pour activer CDT, appelez l'opération OpenCdtService.

L'opération CreateVpcPeerConnection est asynchrone. Après l'envoi d'une requête, le système renvoie un ID de requête et un ID VPC et exécute la tâche en arrière-plan. Appelez l'opération GetVpcPeerConnectionAttribute pour interroger l'état de la tâche.
- Si une connexion d'appairage VPC est dans l'état Creating, la connexion est en cours de création.
- Si une connexion d'appairage VPC est dans l'état Activated, la connexion a été créée.
- Si une connexion d'appairage VPC est dans l'état Accepting, la connexion a été créée entre différents comptes et l'accepteur est en train d'accepter la connexion d'appairage VPC.
Vous ne pouvez pas appeler l'opération CreateVpcPeerConnection de manière répétée dans un délai spécifique.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateVpcPeerConnection	L'opération à effectuer. Définissez la valeur sur CreateVpcPeerConnection.
RegionId	String	Yes	cn-hangzhou	L'ID de la région où vous souhaitez créer une connexion d'appairage VPC. Appelez l'opération DescribeRegions pour interroger la liste des régions la plus récente.
VpcId	String	Yes	vpc-bp1gsk7h12ew7oegk****	L'ID du VPC demandeur.
AcceptingAliUid	Long	Yes	1210123456123456	L'ID du compte Alibaba Cloud auquel appartient le VPC accepteur. Pour créer une connexion d'appairage VPC au sein de votre compte Alibaba Cloud, saisissez l'ID de votre compte Alibaba Cloud. Pour créer une connexion d'appairage VPC entre votre compte Alibaba Cloud et un autre compte Alibaba Cloud, saisissez l'ID du compte Alibaba Cloud homologue. Remarque Si le VPC accepteur appartient à un utilisateur Resource Access Management (RAM), définissez la valeur de AcceptingAliUid sur l'ID du compte Alibaba Cloud correspondant.
AcceptingRegionId	String	Yes	cn-hangzhou	L'ID de région du VPC accepteur de la connexion d'appairage VPC que vous souhaitez créer. Pour créer une connexion d'appairage VPC intra-région, saisissez un ID de région identique à celui du VPC demandeur. Pour créer une connexion d'appairage VPC inter-régions, saisissez un ID de région différent de celui du VPC demandeur.
AcceptingVpcId	String	Yes	vpc-bp1vzjkp2q1xgnind****	L'ID du VPC accepteur.
Name	String	No	vpcpeer	Le nom de la connexion d'appairage VPC. Le nom doit comporter entre 2 et 128 caractères et peut contenir des lettres, des chiffres, des traits de soulignement (_) et des traits d'union (-). Il doit commencer par une lettre.
Description	String	No	description	La description de la connexion d'appairage VPC. La description doit comporter entre 2 et 256 caractères. Elle doit commencer par une lettre mais ne peut pas commencer par `http://` ou `https://`.
DryRun	Boolean	No	false	Indique s'il faut effectuer uniquement un test à blanc, sans exécuter la requête réelle. Valeurs possibles : true : effectue uniquement un test à blanc. Le système vérifie la requête pour détecter d'éventuels problèmes, notamment les valeurs de paramètres manquantes, la syntaxe de requête incorrecte et les limites de service. Si la requête échoue au test à blanc, un message d'erreur est renvoyé. Si la requête réussit le test à blanc, le code d'erreur `DryRunOperation` est renvoyé. false (par défaut) : effectue un test à blanc puis exécute la requête réelle. Si la requête réussit le test à blanc, un code d'état HTTP 2xx est renvoyé et l'opération est effectuée.
ClientToken	String	No	02fb3da4-130e-11e9-8e44-001****	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que le jeton est unique parmi différentes requêtes. Le jeton ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères. Remarque Si vous ne spécifiez pas ce paramètre, le système utilise automatiquement le client token comme request ID. L'request ID peut être différent pour chaque requête.
ResourceGroupId	String	No	rg-acfmxazb4ph6aiy****	L'ID du groupe de ressources. Pour plus d'informations sur les groupes de ressources, consultez Qu'est-ce qu'un groupe de ressources ?

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	54B48E3D-DF70-471B-AA93-08E683A1B45	L'ID de la requête.
InstanceId	String	pcc-lnk0m24khwvtkm****	L'ID de la connexion d'appairage VPC.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=CreateVpcPeerConnection
&RegionId=cn-hangzhou
&VpcId=vpc-bp1gsk7h12ew7oegk****
&AcceptingAliUid=1210123456123456
&AcceptingRegionId=cn-hangzhou
&AcceptingVpcId=vpc-bp1vzjkp2q1xgnind****
&Name=vpcpeer
&Description=description
&DryRun=false
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&ResourceGroupId=rg-acfmxazb4ph6aiy****
&Common request parameters

Exemples de réponses réussies

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateVpcPeerConnectionResponse>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <InstanceId>pcc-lnk0m24khwvtkm****</InstanceId>
</CreateVpcPeerConnectionResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "InstanceId" : "pcc-lnk0m24khwvtkm****"
}

Codes d'erreur

HttpCode	Error code	Error message	Description
400	OperationFailed.CdtNotOpened	The operation failed because the Cdt service is not opened.	L'opération a échoué car Cloud Data Transfer (CDT) n'est pas activé.
400	ResourceAlreadyExist.RouterInterface	The specified resource of %s already exists.	L'interface de routeur spécifiée existe déjà.
400	ResourceAlreadyExist.VpcPeer	The specified resource of %s already exists.	La connexion d'appairage VPC spécifiée existe déjà.
400	UnsupportedRegion	The feature of %s is not supported in the region of %s.	Les connexions d'appairage VPC ne sont pas prises en charge dans cette région.
400	OperationFailed.NotExist.ResourceGroup	The operation failed because the resource group does not exist.	L'opération a échoué car le groupe de ressources n'existe pas.
400	OperationFailed.AcceptUserCdtNotOpened	The operation failed because the Cdt service of accept user is not opened.	L'opération a échoué car CDT n'est pas activé pour l'homologue.
400	OperationFailed.AcceptUserCrossBorderCdtNotOpened	The operation failed because the CrossBorderCdt service of accept user is not opened.	L'opération a échoué car le service transfrontalier de CDT n'est pas activé pour l'homologue.
400	IncorrectBusinessStatus.AcceptUserVpcPeer	The business status of %s [%s] is incorrect.	Le VPC homologue est dans un état métier invalide.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.