CreatePhysicalConnection - Express Connect - Centre de documentation Alibaba Cloud

Appelle l'opération CreatePhysicalConnection pour demander un circuit Express Connect.

Description de l'opération

Vous pouvez demander un circuit Express Connect dédié ou un circuit Express Connect partagé pour un locataire. Une fois la demande terminée, le circuit Express Connect passe à l'état Initial. Contactez l'opérateur pour démarrer la construction.

Lors de l'appel de cette opération, notez les points suivants :

Lorsque vous demandez un circuit Express Connect, le nombre de circuits Express Connect qui ne sont pas dans l'état Enabled ne peut pas dépasser 5.
Si votre compte présente un impayé pour un circuit Express Connect, vous ne pouvez pas demander de nouveau circuit Express Connect.

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

create

*PhysicalConnection.

acs:vpc:{#regionId}:{#accountId}:physicalconnection/*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région du circuit Express Connect. Vous pouvez appeler l'opération DescribeRegions pour interroger l'identifiant de la région.	cn-shanghai
AccessPointId	string	Oui	L'identifiant du point d'accès où se trouve le circuit Express Connect.	ap-cn-beijing-ft-A
Type	string	Non	Le type du circuit Express Connect. Valeur par défaut : VPC.	VPC
LineOperator	string	Oui	L'opérateur qui fournit la ligne physique pour le circuit Express Connect. Valeurs valides : CT : China Telecom. CU : China Unicom. CM : China Mobile. CO : Autres opérateurs en Chine continentale. Equinix : Equinix. Other : Autres opérateurs en dehors de la Chine continentale.	CT
bandwidth	integer	Non	La bande passante des circuits Express Connect partagés. Unité : Mbit/s. Valeurs valides : 50, 100, 200, 300, 400, 500, 1000, 2000, 4000, 5000, 8000 et 10000.	50
PeerLocation	string	Non	L'emplacement géographique du centre de données sur site.	Rue XX
PortType	string	Non	Le type de port du circuit Express Connect. Valeurs valides : 100Base-T : port Ethernet 100M. 1000Base-T : port électrique 1 GE. 1000Base-LX : port optique monomode GE (10 km). 10GBase-T : port électrique 10 GE. 10GBase-LR : port optique monomode 10 GE (10 km). 40GBase-LR : port optique monomode 40 GE. 100GBase-LR : port optique monomode 100 GE. Différents points d'accès prennent en charge différents types de ports. Avant d'appeler cette opération, appelez ListBusinessAccessPoints pour interroger les SupportPortTypes du point d'accès cible. Pour les ports optiques, vérifiez également les OpticalModuleModels. Remarque Les ports 40GBase-LR et 100GBase-LR sont créés en fonction de la disponibilité réelle des ports backend. Contactez votre gestionnaire de compte pour plus de détails.	1000Base-T
RedundantPhysicalConnectionId	string	Non	L'identifiant d'instance du circuit Express Connect redondant. Le circuit doit être dans l'état Allocated, Confirmed ou Enabled.	pc-119mfjzm****
Description	string	Non	La description du circuit Express Connect. La description doit comporter de 2 à 256 caractères et doit commencer par une lettre ou un caractère chinois. Elle ne peut pas commencer par `http://` ou `https://`.	description
Name	string	Non	Le nom du circuit Express Connect. Le nom doit comporter de 2 à 128 caractères et doit commencer par une lettre ou un caractère chinois. Il peut contenir des chiffres, des traits de soulignement (_) et des traits d'union (-). Il ne peut pas commencer par `http://` ou `https://`.	test
CircuitCode	string	Non	Le code de circuit fourni par l'opérateur pour le circuit Express Connect.	longtel001
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Générez une valeur de paramètre depuis votre client pour garantir l'unicité entre les différentes requêtes. 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 peut être différent pour chaque requête API.	123e4567-e89b-12d3-a456-42665544****
ResourceGroupId	string	Non	L'identifiant du groupe de ressources auquel appartient le circuit Express Connect.	rg-acfmoiyermp****
Tag	array<object>	Non	La liste des balises.
	object	Non	La liste des balises.
Key	string	Non	La clé de balise de la ressource. Vous pouvez spécifier jusqu'à 20 clés de balise. Si vous spécifiez ce paramètre, la valeur ne peut pas être une chaîne vide. La clé de balise peut comporter jusqu'à 128 caractères et ne peut pas commencer par `aliyun` ou `acs:`. Elle ne peut pas contenir `http://` ou `https://`.	FinanceDept
Value	string	Non	La valeur de balise de la ressource. Vous pouvez spécifier jusqu'à 20 valeurs de balise. Si vous spécifiez ce paramètre, la valeur peut être une chaîne vide. La valeur de balise peut comporter jusqu'à 128 caractères et ne peut pas commencer par `aliyun` ou `acs:`. Elle ne peut pas contenir `http://` ou `https://`.	FinanceJoshua
DeviceAdvancedCapacity	array	Non	La liste des capacités avancées de l'équipement.
	string	Non	La liste des capacités avancées de l'équipement. Valeurs valides : SubifRateLimit : prend en charge la limitation de la bande passante au niveau de la granularité VBR. DualStack : prend en charge le protocole IPv6. BFD : prend en charge le protocole réseau de détection de pannes entre les points de transfert. CEN : prend en charge le protocole MP-BGP. CENv6 : prend en charge le protocole MP-BGPv6. QOS : prend en charge la QoS. MS-HA : prend en charge les groupes de basculement rapide. Multi-MS-HA : prend en charge plusieurs groupes de basculement. Valeurs valides : BFD : BFD. SubifRateLimit : SubifRateLimit. DualStack : DualStack. CENv6 : CENv6 CEN : CEN.	CENv6
OpticalModuleModel	string	Non	Le modèle de module optique pris en charge au point d'accès du circuit Express Connect. Valeurs valides : 1000Base-LX : `SFP-GE-LR-SM1310,10KM` `SFP-GE-ER-SM1310,40KM` `SFP-GE-ZR-SM1550,80KM` 10GBase-LR : `SFP-10G-LR-SM1310,10KM` `SFP-10G-ER-SM1550,40KM` `SFP-10G-ZR-SM1550,80KM` 40GBase-LR : `QSFP-40G-LR4-WDM1300,10KM` `QSFP-40G-ER4-WDM1300,40KM` `QSFP-40G-ZR4-WDM1300,80KM` 100GBase-LR : `QSFP28-100G-LR4-WDM1300,10KM` `QSFP28-100G-ER4-WDM1300,40KM` `QSFP28-100G-ZR4-WDM1300,80KM`	SFP-GE-LR-SM1310,10KM

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
PhysicalConnectionId	string	L'identifiant d'instance du circuit Express Connect.	pc-bp1ciz7ekd2grn1as****
RequestId	string	L'identifiant de la requête.	8A6A5EC5-6F6C-4906-9689-56ACE58A13E0

Exemples

JSON format

{
  "PhysicalConnectionId": "pc-bp1ciz7ekd2grn1as****",
  "RequestId": "8A6A5EC5-6F6C-4906-9689-56ACE58A13E0"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	Invalid.Status	The device or interface status invalid, or has been used..	Le paramètre Status n'est pas valide.
400	InvalidType.Malformd	The Type provided was invalid.
400	InvalidPeerLocation.Malformd	The PeerLocation provided was invalid.
400	InvalidLineOperator.Malformd	The LineOperator provided was invalid.
400	InvalidPortType.Malformd	The PortType provided was invalid.
400	InvalidDescription.Malformed	The specifid ?Description? is not valid.	La description doit comporter de 2 à 256 caractères et ne peut pas commencer par http:// ou https://.
400	InvalidRedundantPhysicalConnectionId.NotFound	The RedundantPhysicalConnectionId does not found.
400	InvalidName.Malformed	The specified ?Name? is not valid.
400	QuotaExceeded.pConnPerAP	Physical connection count per ap quota exceed.
400	InvalidBandwidth	invalid physical connection banwidth.
400	InvalidRedundantPhysicalConnection	redundant physical connection doesn't belong to current user.
400	InvalidRedundantPhysicalConnectionStatus	invalid redundant physical connection status.
400	InvalidCircuitCode.Malformed	circuitCode is illegal.
400	QuotaExceeded.freePconnPerAP	free physical connections count excceeded.
400	InvalidPhysicalConnectionOperator.Malformed	Specified PhysicalConnection Operator is not valid.	L'opération sur le circuit Express Connect n'est pas valide.
400	InvalidPhysicalConnectionPortType.Malformed	Specified PhysicalConnection PortType is not valid.	Le type de port du circuit Express Connect n'est pas valide.
400	InvalidPhysicalConnectionBandwidth.Malformed	Specified PhysicalConnection Bandwidth is not valid.	La valeur de bande passante liée au circuit Express Connect n'est pas valide.
400	IllegalParam.ClientToken	Token verify failed because client token length too long.	Le paramètre ClientToken n'est pas valide.
400	InvalidPortType.NotFound	Specified port type is not found.	Le type de port spécifié n'existe pas.
400	OperationFailed.PconnTrafficNotEnable	The operation is failed because of PconnTrafficNotEnable.	L'opération a échoué car le service de trafic cloud sortant n'est pas activé.
400	InvalidAccessPointId.NotEnabled	Invalid access point status.	Le point d'accès spécifié ne dispose pas de ressources suffisantes. Contactez votre gestionnaire de compte.
400	ResourceNotFound.AccessPointId	The specified resource of access point id is not found.	Les informations du point d'accès actuel n'existent pas. Vérifiez les informations et réessayez.
400	InvalidParameter.DeviceAdvancedCapacity	Invalid physical connection device advanced capacity.	La fonctionnalité de port avancé n'est temporairement pas prise en charge. Vérifiez et réessayez.
400	CreatePconnFailed.AdvancedCapacity	Create physical connection failed, no devices match the advanced capacity requirements.	Échec de la création du circuit Express Connect. Aucun équipement d'accès ne correspond aux fonctionnalités avancées d'équipement spécifiées.
400	CreatePconnFailed.OpticalModule	Create physical connection failed, no devices match the optical module requirements.	Échec de la création du circuit Express Connect. Aucun équipement d'accès ne correspond au module optique spécifié.
400	CreatePconnFailed.RedundantPconnId	Create physical connection failed, no devices available after excluding redundant device.	Échec de la création du circuit Express Connect. Aucun équipement d'accès éligible n'a été trouvé après l'exclusion des circuits redondants.
400	UnsupportedFeature.LinkDelay.Region	LinkDelay feature is not enabled in region.	L'attribut de la commande de délai de transition d'état n'est pas à l'état d'activation dans la région actuelle.
404	InvalidPortType.NotFound	There are no resources with the portType.	Le type de port spécifié n'existe pas.

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

Notes de version

Consultez Notes de version pour la liste complète.