Créer une commande 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 connexions croisées démarrent à partir du même IBX, de la même cage et du même compte côté A
Toutes les connexions croisées se terminent au même fournisseur côté Z, IBX et cage
Le nombre total de connexions croisées dans une requête ne dépasse pas 10.

Si les connecteurs croisés que vous souhaitez commander ne répondent pas à ces critères, vous devez soumettre des demandes de commande séparées.

Conditions préalables

Authentification - Soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète 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.

Informations a-Side

Utilisez le point de terminaisonOBTENIR DES emplacements 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 ignorer cette étape si vous connaissez déjà les informations de localisation de votre équipe A.
Utilisez OBTENIR les services de connexion 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 ignorer cette étape si vous connaissez déjà les informations relatives aux services de connexion pour votre côté A.
Utilisez l’option OBTENIR des panneaux de brassage 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} 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

Utilisez le point de terminaisonGET 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 terminaisonOBTENIR DES emplacements 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.
Utilisez OBTENIR les services de connexion 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.
Utilisez l’option OBTENIR des panneaux de brassage 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.
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'identifiant du circuit.

Commande de Cross Connects standard sans LOA

Pour commander un Cross Connect standard, envoyez POSTune demande au /colocations/v2/orders/crossConnectsterminal.

Spécifiez l'ID du panneau de brassage côté A, les détails complets des services de connexion, ainsi que le type de connecteur côté Z, l'ID du circuit et l'ID du panneau de brassage dans le corps de la requête.

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 <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 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 .

Commande de Cross Connects standard avec une LOA

Pour commander un Cross Connect standard, envoyez POSTune demande au /colocations/v2/orders/crossConnectsterminal.

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 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 terminaisondu fichier de pièces jointes POST .

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 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 .

Exemple complet de commande de Cross Connects standard

Pour commander un Cross Connect standard, envoyez POSTune demande au /colocations/v2/orders/crossConnectsterminal.

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 terminaisondu fichier de pièces jointes POST .

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 leurs descriptions, reportez-vous à la référence API .

Conditions préalables​

Informations a-Side​

Informations Z-Side​

Commande de Cross Connects standard sans LOA​

Commande de Cross Connects standard avec une LOA​

Exemple complet de commande de Cross Connects standard​

Conditions préalables

Informations a-Side

Informations Z-Side

Commande de Cross Connects standard sans LOA

Commande de Cross Connects standard avec une LOA

Exemple complet de commande de Cross Connects standard