Créer un groupe de liaison d'appareils

Un groupe DeviceLink peut inclure tout périphérique virtuel provisionné et enregistré, sauf si les interfaces de périphérique 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 périphériques virtuels provisionnés avec des licences enregistrées. Vous devez avoir le deviceUuids et l'metroCodesemplacement des périphériques.

• Vous devez fournir des ASN pour les périphériques si les ASN n'ont pas été définis. Si un périphérique possède déjà un ASN, récupérez l'ASN en appelant Get Virtual Device.

• Numéro de compte de facturation Equinix. Votre compte doit être à l'état 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 périphériques que vous souhaitez ajouter au groupe. Ce champ n'est pas obligatoire lorsque vous essayez de créer un groupe de liaison ; cependant, vous devez le fournir pour avoir un groupe de liaison fonctionnel.

• Fournissez metroLinks des informations (numéro de compte, débit, metroCode) sauf si les périphériques se trouvent dans le même métro.

Conditions préalables

Authentifier - soumettre vos informations d'identification utilisateur, ID client et secret client pour l'authentification OAuth2. Reportez-vous à authentification API pour obtenir des instructions sur la façon d'appeler le API OAuth pour valider et authentifier vos informations d'identification.

Étape 2 : Obtenir des appareils virtuels

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

• virtualDeviceUuids
• metroCodes,
• ASNs
• accountNumbers.

Étape 3 : Créer un lien avec un appareil

	POST /ne/v1/links
Méthode	POST
URL ou point final	/ne/v1/links
En-têtes	Authorization Content-Type
Paramètres du chemin d'accès	NA
Paramètres du corps	groupName, subnet, redundancyType, , linkDevices[deviceUuid, asn, interfaceId]``metroLinks[ {accountNumber, throughput, throughputUnit, metroCode}]

Un exemple de requête curl pour créer un groupe de liens entre deux appareils dans deux métropoles différentes.

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 entre deux appareils 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 une 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"  
}

Contenu de la réponse :

Champ	Type	Exemples de valeurs	Description
uuid	chaîne	b43ba509-a7d9-4334-8dee-dc4f29bf2e77	L'ID unique du groupe de liens de l'appareil.

État du périphérique

Lorsqu'un groupe DeviceLink est créé, il passe par différents états qui peuvent être surveillés à l'aide de l'statusattribut response de la méthodeGet Device Link. 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.

État	Description
PROVISIONING	Le groupe de liens de l'appareil est en train de démarrer.
FAILED	La création du lien a échoué.
PROVISIONED	Le groupe de liaison de l'appareil est prêt.
DEPROVISIONING	Le groupe de liens de l'appareil est en cours de déprovisionnement.
DEPROVISIONED	Le groupe de liens de l'appareil 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éthodeDelete Device Link, le groupe passe par les états suivants :

État	Description
DEPROVISIONING	Equinix a accepté la demande du client de supprimer un groupe de liens de dispositifs.
DEPROVISIONED	Le lien avec l'appareil est supprimé.