Skip to main content

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 d'interconnexions et de câbles intra-centre peuvent commander des interconnexions.

Cette méthode crée une demande d'interconnexion entre deux clients Equinix (côté A et côté Z) situés dans le même IBX ou dans des IBX différents. Le client du côté A lance cette demande pour se connecter au fournisseur du côté Z.

Il est possible de commander une ou plusieurs quantités de câbles de raccordement sur une seule demande. Les commandes de plusieurs câbles de raccordement ne peuvent être regroupées dans une seule demande que si elles répondent aux critères suivants:

  • Toutes les interconnexions partent du même IBX côté A, de la même cage et du même compte
  • Tous les raccordements croisés aboutissent 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.

Préalable​

  1. 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 sur la face A​

  1. 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 équipe A.

  2. 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 relatives aux services de connexion pour votre côté A.

  3. 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 sauter cette étape si vous connaissez déjà les informations relatives au panneau de brassage.

Informations du côté Z​

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

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

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

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

  5. 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 sauter cette étape si vous connaissez déjà l'identifiant du circuit.

Commande de connecteurs croisés standards sans lettre d'autorisation​

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 requête.

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 connecteurs croisés standards avec une lettre d'autorisation​

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 dans le corps de la requête 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, l'ID du panneau de brassage et l'ID de l'attache LOA.

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"  
      }  
    }  
  ]  
}'

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

Exemple complet de commande de connecteurs croisés standard​

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.

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

Cette page vous a-t-elle été utile ?