Créer un ordre de connexion croisée
Un Cross-Connect est une liaison câblée point à point entre deux clients dans le même centre de données Equinix IBX ou dans un centre différent. Les cross-connexions ne peuvent être commandées que par un utilisateur du portail client disposant des autorisations de commande Cross-Connect & Intra-Facility Cables.
Cette méthode crée une demande de commande de connexions croisées entre deux clients Equinix (côté A et côté Z) dans le même site IBX ou dans des sites différents. Le client côté A initie cette demande pour se connecter au fournisseur côté Z.
Une seule ou plusieurs quantités de raccords croisés peuvent être commandées en une seule fois. Les raccords transversaux en plusieurs quantités ne peuvent être soumis dans une seule demande de commande que s'ils remplissent les critères suivants :
- Toutes les connexions croisées partent du même IBX, de la même cage et du même compte du côté A.
- Toutes les connexions croisées aboutissent au même fournisseur du côté Z, IBX et cage.
- Le nombre total de connexions croisées dans une demande ne dépasse pas 10
Si les connexions transversales que vous souhaitez commander ne répondent pas à ces critères, vous devez soumettre des demandes de commande distinctes.
Conditions préalables
- Authentifier - Soumettez vos informations d'identification, votre ID client et votre secret client pour OAuth2. authentification. Reportez-vous à API Authentication pour savoir comment appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.
Informations sur la face A
-
Utilisez le point de terminaison GET Locations les informations de localisation pour le point de départ de votre Cross-Connect (côté a). Déterminez l'IBX exact, l'ID de la cage et l'ID de l'armoire. Assurez-vous que tous les Cross-Connect souhaités appartiennent au même IBX et à la même cage.
Si vous souhaitez patcher votre équipement pour ce Cross-Connect, l'identifiant de l'armoire sera transmis dans votre requête pour le paramètre a-side suivant :
cabinetId.Vous pouvez sauter cette étape si vous connaissez déjà les informations relatives à l'emplacement de votre face A.
-
Utilisez GET Connection Services pour récupérer toutes les informations sur les 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 l'IBX sélectionné.
Ces valeurs seront également transmises dans le corps de la requête pour les paramètres a-side suivants :
connectionService,mediaType,connectorType,protocolType.Vous pouvez sauter cette étape si vous connaissez déjà les informations relatives aux services de connexion pour votre côté a.
-
Utilisez GET PatchPanels pour déterminer l'ID du panneau de brassage préféré pour votre côté a. Cette valeur sera transmise dans votre requête. Cette valeur sera transmise dans le corps de votre requête pour le paramètre a-side suivant (partie de patchPanel object) :
id.Si vous souhaitez obtenir davantage d'informations sur votre panneau de brassage, telles que les ports disponibles et tous ses services de connexion, consultez GET PatchPanels {patchPanelId} dans la section API Reference.
Vous pouvez sauter cette étape si vous connaissez déjà les informations relatives au panneau de brassage.
Informations sur le côté Z
-
Utilisez le point d'extrémité GET Providers pour récupérer une liste de vos fournisseurs de services z-side disponibles et déterminer leur numéro de compte.
-
Utilisez le point de terminaison GET Locations les informations de localisation pour la destination de votre Cross-Connect (côté z). Déterminez l'IBX exact, l'ID de la cage et l'ID de l'armoire. Assurez-vous que tous les Cross-Connect souhaités appartiennent au même IBX et à la même cage.
-
Utilisez GET Connection Services pour récupérer toutes les informations sur les 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 l'IBX sélectionné.
Ces valeurs seront transmises dans le corps de la requête pour le paramètre z-side suivant :
connectorType. -
Utilisez GET PatchPanels pour déterminer l'ID du panneau de brassage préféré pour votre côté a. Cette valeur sera transmise dans votre requête. Cette valeur sera transmise dans le corps de votre requête pour le paramètre a-side suivant (partie de patchPanel object) :
id. -
Consultez votre fournisseur de services pour connaître le numéro de référence de son 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 Standard Cross Connect sans lettre d'intention
Pour commander un Cross Connect standard, envoyez une requête POST au point de terminaison /colocations/v2/orders/crossConnects.
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 du tableau de détails représente une Cross-Connect. Lorsque vous commandez des Cross-Connect multiples, passez plusieurs objets dans le tableau des détails.
curl -X
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-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 requête sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leur description, consultez la Référence API.
Commande de Standard Cross Connect avec une LOA
Pour commander un Cross Connect standard, envoyez une requête POST au point de terminaison /colocations/v2/orders/crossConnects.
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, l'ID du panneau de brassage et l'ID de la pièce jointe LOA dans le corps de la demande.
Un objet du tableau de détails représente une Cross-Connect. Lorsque vous commandez des Cross-Connect multiples, passez plusieurs objets dans le tableau des détails.
Avant de créer une commande avec une pièce jointe, utilisez le point de terminaison POST Attachments File.
Exemple de requête cURL :
curl -X
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-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 requête sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leur description, consultez la Référence API.
Commande de Standard Cross Connect Exemple complet
Pour commander un Cross Connect standard, envoyez une requête POST au point de terminaison /colocations/v2/orders/crossConnects.
Cet exemple est une commande accélérée pour des Cross-Connect depuis un compte dans une cage avec plusieurs comptes vers un nouveau fournisseur de services avec une pièce jointe LOA, 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 POST Attachments File.
Exemple de requête cURL :
curl -X
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-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 leur description, consultez la Référence API.