Passer au contenu principal

Créer un groupe de liaisons entre dispositifs

Un groupe de liaisons entre dispositifs peut inclure tout dispositif virtuel provisionné et enregistré, sauf si les interfaces de dispositifs sont déjà pleines. Pour en savoir plus sur DeviceLink, consultez le guide Network Edge . Pour créer un groupe DeviceLink à l'aide d'API, vous devez disposer des éléments suivants :

  • Au moins deux dispositifs virtuels provisionnés avec des licences enregistrées. Vous devez disposer du deviceUuids et l'metroCodesemplacement des appareils.

  • Vous devez fournir des ASN pour les appareils si les ASN n'ont pas été définis. Si un appareil dispose déjà d'un ASN, récupérez l'ASN en appelant obtenir un appareil virtuel .

  • Numéro de compte de facturation Equinix. Votre compte doit avoir le statut actif ou en attente. Vous devez fournir un numéro de compte pour chaque lien que vous créez.

  • Choisissez un sous-réseau pour le groupe. Vous devez choisir un sous-réseau en gardant à l’esprit le nombre de dispositifs que vous souhaitez ajouter au groupe. Ce champ n'est pas obligatoire au moment où vous essayez de créer un groupe de liaison ; toutefois, vous devez le fournir pour avoir un groupe de liaison fonctionnel.

  • Fournir metroLinks des informations (numéro de compte, débit, metroCode), sauf si les appareils se trouvent dans le Même métro.

Conditions préalables​

Authentifier - envoyez vos identifiants utilisateur, votre identifiant client et votre secret client pour l'authentification OAuth2. Pour obtenir des instructions sur la façon d'appeler l'API OAuth pour valider et authentifier vos identifiants, reportez-vous à authentification API.

Étape 2 : Obtenir des périphériques virtuels​

Pour obtenir des détails sur vos dispositifs virtuels, appelez obtenir des dispositifs virtuels . La réponse comprendra :

  • virtualDeviceUuids
  • metroCodes,
  • ASNs
  • accountNumbers.

Étape 3 : Créer un lien de dispositif​

POST /ne/v1/links
MéthodePOST
URL ou point de terminaison/ne/v1/links
En-têtesAuthorization, Content-Type
Paramètres du cheminNA
Paramètres corporelsgroupName, subnet, redundancyType, , linkDevices[deviceUuid, asn, interfaceId]``metroLinks[ {accountNumber, throughput, throughputUnit, metroCode}]

Un exemple de requête curl pour créer un groupe de liens d'appareils entre deux appareils dans deux métros différents.

curl -X
POST "https://api.equinix.com/ne/v1/links"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '{
  "groupName": "test-link",
  "subnet": "10.0.0.0/27",
    "redundancyType": "SECONDARY",
  "linkDevices": [
    {
      "deviceUuid": "d186dc1a-29e7-4829-bb5e-50fa57aca923",
      "asn": 65414,
      "interfaceId": 6
    },
    {
      "deviceUuid": "ea128600-1875-4f7a-80e9-307a5bbeac51",
      "asn": 100,
      "interfaceId": 6
    }
  ],
  "metroLinks": [
    {
      "accountNumber": "23945678",
      "metroCode": "SV",
      "throughput": 1000,
      "throughputUnit": "Mbps"
    },

    {
      "accountNumber": "2395123",
      "metroCode": "SY",
      "throughput": 1000,
      "throughputUnit": "Mbps"
    }
  ]
 
}'

Un exemple de requête curl pour créer un lien de périphérique entre deux périphériques au sein d'un métro.

curl -X
POST "https://api.equinix.com/ne/v1/links"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '{
    "groupName": "test-link",
    "subnet": "10.0.0.0/27",
    "redundancyType": "SECONDARY",
    "linkDevices": [
    {
        "deviceUuid": "d186dc1a-29e7-4829-bb5e-50fa57aca923",
        "asn": 65414,
        "interfaceId": 6
    },
    {
        "deviceUuid": "ea128600-1875-4f7a-80e9-307a5bbeac51",
        "asn": 100,
        "interfaceId": 6
    }
    ],
    "metroLinks": []
    
}'

Pour obtenir la liste complète des paramètres et des options, reportez-vous à la référence API .

Exemple de réponse​

{
    "uuid": "85ebe7b7-6182-45a1-be51-cb194f2f1e39"
}

Charge utile de réponse:

ChampTypeExemples de valeursDescription
uuidchaîneb43ba509-a7d9-4334-8dee-dc4f29bf2e77L'ID unique du groupe de liens de l'appareil.

État du dispositif​

Lorsqu'un groupe de liaisons entre dispositifs est créé, il passe par différents états qui peuvent être surveillés à l'aide de l'statusattribut response de la méthodeobtenir liaison entre dispositifs. Votre groupe de liaisons doit être provisionné avant que vous puissiez commencer à effectuer d'autres opérations telles que l'ajout ou la suppression de périphériques.

ÉtatDescription
PROVISIONINGLe groupe de liaison de périphériques démarre.
FAILEDLa création du lien a échoué.
PROVISIONEDLe groupe de liaison de l'appareil est prêt.
DEPROVISIONINGLe groupe de liens de périphériques est en cours de déprovisionnement.
DEPROVISIONEDLe groupe de liens de périphériques est déprovisionné.

Vous pouvez mettre à jour un groupe de liens à l'aide de mettre à jour Device Link.

Si vous supprimez un groupe DeviceLink à l'aide de la méthodeSupprimer Device Link, le groupe passe par les états suivants :

ÉtatDescription
DEPROVISIONINGEquinix a accepté la demande du client de supprimer un groupe de liens d'appareils.
DEPROVISIONEDLe lien de l'appareil est supprimé.
Cette page vous a-t-elle été utile ?