# Créer un ordre de Cross Connect Un Cross Connect est une liaison câblée point à point entre deux clients dans le même datacentre Equinix IBX ou dans un autre datacentre. Cross Connects ne peut être commandé que par un utilisateur du Portail client disposant des autorisations de commande de câbles Cross Connect et intra-établissement. Cette méthode crée une demande de commande Cross Connects entre deux clients Equinix (A-Side et Z-Side) dans le même site IBX ou dans des sites différents. Le client A-Side lance cette demande de connexion au fournisseur Z-Side. Une ou plusieurs quantités de Cross Connects peuvent être commandées en une seule demande. Les Cross Connects en quantités multiples ne peuvent être soumises que dans une seule demande de commande si elles remplissent les critères suivants : * Toutes les Cross-Connect partent du même IBX côté A, de la même cage et du même compte. * Toutes les Cross-Connect se terminent chez le même fournisseur côté Z, IBX et cage. * Le nombre total de Cross-Connect dans une même demande ne dépasse pas 10. Si les Cross-Connect que vous souhaitez commander ne remplissent pas ces critères, vous devez soumettre des demandes de commande distinctes. ## Conditions préalables[​](#conditions-préalables "Lien direct vers Conditions préalables") 1. Authentifier - Soumettez vos informations d'identification, votre ID client et votre secret client pour OAuth2. authentification. Pour obtenir des instructions sur la façon d'appeler l'API OAuth pour valider et authentifier vos identifiants, reportez-vous à [authentification API](https://docs.equinix.com/fr/equinix-api/api-authentication.md). ### Informations a-Side[​](#informations-a-side "Lien direct vers Informations a-Side") 1. Utilisez le point de terminaison[OBTENIR DES emplacements](https://docs.equinix.com/fr/api-catalog/lookupv2/lookup/get%20locations%20by%20permission%20code.md) les informations de localisation pour le point de départ de votre Cross Connect (a-Side). Déterminez le IBX exact, l'identifiant de la cage et l'identifiant de l'armoire. Assurez-vous que tous les Cross Connects souhaités appartiennent au même IBX et à la même cage. Si vous souhaitez appliquer un correctif à votre équipement pour ce Cross Connect, l'identifiant de l'armoire sera transmis dans votre demande pour le paramètre a-Side suivant : `cabinetId`. Vous pouvez sauter cette étape si vous connaissez déjà les informations relatives à la localisation de votre côté a. 2. Utilisez [OBTENIR les services de connexion](https://docs.equinix.com/fr/api-catalog/lookupv2/lookup/retrieve%20list%20of%20connection%20services.md) pour récupérer toutes les informations relatives aux services de connexion pour votre emplacement préféré. Déterminez le service de connexion, le type de média, le type de connecteur et le type de protocole disponibles dans le IBX sélectionné. Ces valeurs seront également transmises dans le corps de la demande pour les paramètres a-Side suivants : `connectionService`, `mediaType`, , `connectorType` `protocolType`. Vous pouvez sauter cette étape si vous connaissez déjà les informations sur les services de connexion de votre côté a. 3. Utilisez l’option [OBTENIR des panneaux de brassage](https://docs.equinix.com/fr/api-catalog/lookupv2/lookup/retrieve%20all%20patch%20panels.md) pour déterminer l’identifiant de panneau de brassage préféré pour votre face A. Cette valeur sera transmise dans le corps de votre requête pour le paramètre a-Side suivant (qui fait partie de patchPanel objet) : `id`. Si vous souhaitez obtenir plus d'informations sur votre panneau de brassage, telles que les ports disponibles et tous ses services de connexion, consultez [OBTENIR DES panneaux de brassage {patchPanelId}](https://docs.equinix.com/fr/api-catalog/lookupv2/lookup/retrieve%20patch%20panel%20details.md) dans la section référence API. Vous pouvez sauter cette étape si vous connaissez déjà les informations relatives au panneau de brassage. ### Informations Z-Side[​](#informations-z-side "Lien direct vers Informations Z-Side") 1. Utilisez le point de terminaison[GET Providers](https://docs.equinix.com/fr/api-catalog/lookupv2/lookup/retrieve%20list%20of%20providers.md) pour récupérer une liste de vos fournisseurs de services z-Side disponibles et déterminer leur numéro de compte. 2. Utilisez le point de terminaison[OBTENIR DES emplacements](https://docs.equinix.com/fr/api-catalog/lookupv2/lookup/get%20locations%20by%20permission%20code.md) les informations de localisation pour la destination de votre Cross Connect (z-Side). Déterminez le IBX exact, l'identifiant de la cage et l'identifiant de l'armoire. Assurez-vous que tous les Cross Connects souhaités appartiennent au même IBX et à la même cage. 3. Utilisez [OBTENIR les services de connexion](https://docs.equinix.com/fr/api-catalog/lookupv2/lookup/retrieve%20list%20of%20connection%20services.md) pour récupérer toutes les informations relatives aux services de connexion pour votre emplacement préféré. Déterminez le service de connexion, le type de média, le type de connecteur et le type de protocole disponibles dans le IBX sélectionné. Ces valeurs seront transmises dans le corps de la demande pour le paramètre z-Side suivant : `connectorType`. 4. Utilisez l’option [OBTENIR des panneaux de brassage](https://docs.equinix.com/fr/api-catalog/lookupv2/lookup/retrieve%20all%20patch%20panels.md) pour déterminer l’identifiant de panneau de brassage préféré pour votre face A. Cette valeur sera transmise dans le corps de votre requête pour le paramètre a-Side suivant (qui fait partie de patchPanel objet) : `id`. 5. Contactez votre fournisseur de services pour obtenir son numéro de référence de câble d'identification de circuit. Cette valeur sera transmise dans le corps de la requête pour le paramètre z-Side `circuitId`. Vous pouvez sauter cette étape si vous connaissez déjà l'ID du circuit. ## Commande de Cross Connects standard sans lettre d'autorisation (LOA)[​](#commande-de-cross-connects-standard-sans-lettre-dautorisation-loa "Lien direct vers Commande de Cross Connects standard sans lettre d'autorisation (LOA)") Pour commander un Cross Connect standard, envoyez `POST`une demande au [`/colocations/v2/orders/crossConnects`](https://docs.equinix.com/fr/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md)terminal. Spécifiez l'ID du panneau de brassage côté a, les détails complets des services de connexion, et le type de connecteur côté Z, l'ID du circuit et l'ID du panneau de brassage dans le corps de la demande. Un objet dans le tableau Details représente un Cross Connect. Lors de la commande de multi-Cross Connects, passez plusieurs objets dans le tableau Details. ``` curl -X POST "https://api.equinix.com/colocations/v2/orders/crossConnects" -H "content-type: application/json" -H "authorization: Bearer " -d '{     "details": [     {       "aSide": {         "connectionService": "SINGLE_MODE_FIBER",         "mediaType": "SINGLE_MODE_FIBER",         "protocolType": "10_GIG_ETHERNET",         "connectorType": "FC",         "patchPanel": {           "id": "CP:0104:1199890"         }       },       "zSide": {         "connectorType": "LC",         "circuitId": "1-12312312",         "patchPanel": {           "id": "PP:0104:1190123"         }       }     }   ] }' ``` Les paramètres inclus dans le corps de la demande sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, reportez-vous à la [référence API](https://docs.equinix.com/fr/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md) . ## Commande de Standard Cross Connect avec une LOA[​](#commande-de-standard-cross-connect-avec-une-loa "Lien direct vers Commande de Standard Cross Connect avec une LOA") Pour commander un Cross Connect standard, envoyez `POST`une demande au [`/colocations/v2/orders/crossConnects`](https://docs.equinix.com/fr/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md)terminal. Spécifiez l'ID du panneau de connexion côté a, les détails complets des services de connexion, et le type de connecteur côté Z, l'ID du circuit, l'ID du panneau de connexion et l'ID de l'attachement LOA dans le corps de la demande. Un objet dans le tableau Details représente un Cross Connect. Lors de la commande de multi-Cross Connects, passez plusieurs objets dans le tableau Details. Avant de créer une commande avec une pièce jointe, utilisez le point de terminaison[du fichier de pièces jointes POST](https://docs.equinix.com/fr/api-catalog/attachmentsv1/attachments/createattachment.md) . Exemple de requête cURL : ``` curl -X POST "https://api.equinix.com/colocations/v2/orders/crossConnects" -H "content-type: application/json" -H "authorization: Bearer " -d '{     "details": [     {       "aSide": {         "connectionService": "SINGLE_MODE_FIBER",         "mediaType": "SINGLE_MODE_FIBER",         "protocolType": "10_GIG_ETHERNET",         "connectorType": "FC",         "patchPanel": {           "id": "CP:0104:1199890"         }       },       "zSide": {         "providerName": "Acme Corporation",         "ibx": "AM1",         "loaAttachmentId": "fcb2k8763-2947-456e-8d68-f280753d60ba"       }     }   ] }' ``` Les paramètres inclus dans le corps de la demande sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, reportez-vous à la [référence API](https://docs.equinix.com/fr/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md) . ## Commande de Standard Cross-Connect Exemple complet[​](#commande-de-standard-cross-connect-exemple-complet "Lien direct vers Commande de Standard Cross-Connect Exemple complet") Pour commander un Cross Connect standard, envoyez `POST`une demande au [`/colocations/v2/orders/crossConnects`](https://docs.equinix.com/fr/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md)terminal. Cet exemple est une commande accélérée pour Cross Connects à partir d'un compte dans une cage avec plusieurs comptes vers un nouveau fournisseur de services avec une pièce jointe à une lettre d'autorisation, ainsi que d'autres pièces jointes, informations et demandes. Avant de créer une commande avec une pièce jointe, utilisez le point de terminaison[du fichier de pièces jointes POST](https://docs.equinix.com/fr/api-catalog/attachmentsv1/attachments/createattachment.md) . Exemple de requête cURL : ``` curl -X POST "https://api.equinix.com/colocations/v2/orders/crossConnects" -H "content-type: application/json" -H "authorization: Bearer " -d '{     "details": [     {       "aSide": {         "connectionService": "SINGLE_MODE_FIBER",         "mediaType": "SINGLE_MODE_FIBER",         "protocolType": "10_GIG_ETHERNET",         "connectorType": "FC",         "mediaConverterRequired": false,         "ifcCircuitCount": 2,         "patchPanel": {           "id": "CP:0104:1199890",           "portA": 12,           "portB": 13         },         "patchEquipment": {           "cabinetId": "SG1:01:00EQ00:0001",           "connectorType": "FC",           "details": "Refer to attachment for patching details.",           "port": 10         }       },       "zSide": {         "providerName": "Acme Corporation",         "ibx": "PE2",         "connectorType": "LC",         "circuitId": "1-12312312",         "patchPanel": {           "id": "PP:0104:1190123",           "portA": 1,           "portB": 2         },         "loaAttachmentId": "fcb2k8763-2947-456e-8d68-f280753d60ba",         "notificationEmail": "johndoe@acme.com"       },       "verifyLink": true,       "circuitDeliveryDate": "2020-10-09T10:00:22.395Z",       "submarineEngineerRequired": true     }   ],   "expediteDateTime": "2020-10-10T06:30:22.395Z",   "customerReferenceId": "EQX_CC_20201010",   "description": "Please refer to attachment for full details for this cross connects order.",   "attachments": [     {       "id": "85d9660a-f877-405a-b38e-8e61a4f77f44",       "name": "OrderInstructions.docx"     }   ],   "purchaseOrder": {     "type": "NEW",     "number": "EQXPO_Ref9654284",     "amount": 10000,     "startDate": "2020-10-01",     "endDate": "2021-09-30",     "attachmentId": "56d10de6-f2c0-4edd-ba29-b70736aa2093"   },   "contacts": [     {       "type": "NOTIFICATION",       "registeredUsers": [         "john_doe",         "john_doe1"       ]     },     {       "type": "TECHNICAL",       "firstName": "Jane",       "lastName": "Doe",       "availability": "WORK_HOURS",       "timezone": "America/New_York",       "details": [         {           "type": "EMAIL",           "value": "janedoe@acme.com"         },         {           "type": "PHONE",           "value": "+1-987654321"         },         {           "type": "MOBILE",           "value": "+1-912345678"         }       ]     }   ] }' ``` Pour obtenir la liste complète des paramètres et leurs descriptions, reportez-vous à la [référence API](https://docs.equinix.com/fr/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md) .