Passer au contenu principal

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​

  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.

Informations a-Side​

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

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

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

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

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

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

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 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 <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 Standard Cross Connect avec une LOA​

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

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

Commande de Standard Cross-Connect Exemple complet​

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 .

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