Créer une commande de connexion croisée

Une interconnexion est une liaison câblée point à point entre deux clients situés dans le même centre de données Equinix IBX ou dans des centres de données différents. Seuls les utilisateurs du portail client disposant des autorisations de commande Cross Connect et de câbles intra-centre peuvent commander des interconnexions.

Cette méthode crée une demande de connexion croisée entre deux clients Equinix (côté A et côté Z) situés dans des emplacements IBX identiques ou différents. Le client côté A initie cette demande pour se connecter au fournisseur côté Z.

Une ou plusieurs quantités de connecteurs croisés peuvent être commandées dans une même demande. Les connecteurs croisés multiquantités ne peuvent être soumis dans une même demande que s'ils 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 demande ne dépasse pas 10

Si les connexions croisées 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. Consultez Authentification API pour obtenir des instructions sur la façon d'appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.

Informations côté A

Utilisez la requête GET Locations%20Locations%20 par%20permission%20code) indiquez l'emplacement du point de départ de votre connexion croisée (côté A). Déterminez l'IBX, l'ID de cage et l'ID d'armoire exacts. Assurez-vous que toutes les connexions croisées souhaitées appartiennent au même IBX et à la même cage.

Si vous souhaitez configurer votre équipement pour cette interconnexion, l'ID de l'armoire sera transmis dans votre requête pour le paramètre côté A suivant: cabinetId.

Vous pouvez ignorer cette étape si vous connaissez déjà les informations de localisation de votre face A.
Utilisez les [Services de connexion GET](/api-catalog/lookupv2/#tag/Lookup/operation/Retrieve%20list%20 sur%20connection%Utilisez la commande 20services pour récupérer toutes les informations relatives aux services de connexion disponibles pour votre emplacement. Déterminez quels services de connexion, types de médias, types de connecteurs et types de protocoles sont disponibles dans l'IBX sélectionné.

Ces valeurs seront également transmises dans le corps de la requête pour les paramètres côté A suivants: connectionService, mediaType, connectorType, protocolType.

Vous pouvez ignorer cette étape si vous connaissez déjà les informations sur les services de connexion pour votre face A.
Utilisez [GET PatchPanels](/api-catalog/lookupv2/#tag/Lookup/operation/Retrieve%20all%20 correctifs%20panels) pour déterminer l'ID du panneau de brassage préféré pour votre côté a. Cette valeur sera transmise dans le corps de votre requête pour le paramètre côté a suivant (qui fait partie de patchPanel). objet): id.

Pour obtenir plus d'informations sur votre panneau de brassage, comme les ports disponibles et tous ses services de connexion, consultez GET PatchPanels {patchPanelId} dans la section Référence API.

Vous pouvez ignorer cette étape si vous connaissez déjà les informations du panneau de brassage.

Informations côté Z

Utilisez les [fournisseurs GET](/api-catalog/lookupv2/#tag/Lookup/operation/Retrieve%20list%20of%20 fournisseurs) endpoint pour récupérer une liste de vos fournisseurs de services z-side disponibles et déterminer leur numéro de compte.
Utilisez la méthode GET Locations%20Locations%20 par%20permission%20code) indiquez l'emplacement de destination de votre commutateur (côté Z). Déterminez l'IBX, l'ID de cage et l'ID d'armoire exacts. Assurez-vous que tous les commutateurs souhaités appartiennent au même IBX et à la même cage.
Utilisez les [Services de connexion GET](/api-catalog/lookupv2/#tag/Lookup/operation/Retrieve%20list%20 sur%20connection%Utilisez la commande 20services pour récupérer toutes les informations relatives aux services de connexion disponibles pour votre emplacement. Déterminez quels services de connexion, types de médias, types de connecteurs et types de protocoles sont 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](/api-catalog/lookupv2/#tag/Lookup/operation/Retrieve%20all%20 correctifs%20panels) pour déterminer l'ID du panneau de brassage préféré pour votre côté a. Cette valeur sera transmise dans le corps de votre requête pour le paramètre côté a suivant (qui fait partie de patchPanel). objet): id.
Veuillez contacter votre fournisseur de services pour connaître le numéro de référence du câble Circuit ID. Cette valeur sera transmise dans le corps de la requête pour le paramètre z-side circuitId.

Vous pouvez ignorer cette étape si vous connaissez déjà l’ID du circuit.

Commande de Cross Connects standard sans LOA

Pour commander une interconnexion standard, envoyez une requête POST à l'adresse [/colocations/v2/orders/crossConnects](/api-catalog/crossconnectsv2/#tag/Cross-Connects/operation/Order%20cross%20 connexions) point de terminaison.

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

Un objet du tableau de détails représente une interconnexion. Lors de la commande de plusieurs interconnexions, passez Plusieurs objets dans le tableau de 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 propres à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, consultez la [Référence de l'API](/api-catalog/crossconnectsv2/#tag/Cross-Connects/operation/Order%20cross%20 connexions).

Commande de Cross Connects standard avec une LOA

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 du tableau de détails représente une interconnexion. Lors de la commande de plusieurs interconnexions, passez Plusieurs objets dans le tableau de 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"  
      }  
    }  
  ]  
}'

Exemple complet de commande de Cross Connects standard

Cet exemple est une commande accélérée de connexions croisées d'un compte dans un espace partagé avec plusieurs comptes vers un nouveau fournisseur de services avec une lettre d'autorisation (LOA) en pièce jointe, ainsi que d'autres pièces jointes. renseignements 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 leurs descriptions, consultez la [Référence API](/api-catalog/crossconnectsv2/#tag/Cross-Connects/operation/Order%20cross%20 connexions).

Conditions préalables​

Informations côté A​

Informations côté Z​

Commande de Cross Connects standard sans LOA​

Commande de Cross Connects standard avec une LOA​

Exemple complet de commande de Cross Connects standard​