Créer un groupe de liaison de dispositifs

Un groupe de liens de périphériques peut inclure n'importe quel périphérique virtuel provisionné et enregistré, à moins que les interfaces de périphériques ne soient déjà pleines. Pour en savoir plus sur les liaisons de périphériques, consultez le [guide] Network Edge(../device-link/ne-device-link.md). Pour créer un groupe de liens de dispositifs à l'aide des API, vous devez disposer des éléments suivants :

• Au moins deux dispositifs virtuels provisionnés avec des licences enregistrées. Vous devez avoir le deviceUuids et les metroCodes où les appareils sont situés.

• Vous devez fournir des ASN pour les appareils si les ASN n'ont pas été définis. Si un appareil a déjà un ASN, récupérez-le en appelant [Get Virtual Device] (/api-catalog/network-edgev1/#tag/Virtual-Device/operation/getVirtualDevices).

• 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 tenant compte du nombre d'appareils que vous souhaitez ajouter au groupe. Ce champ n'est pas obligatoire au moment où vous essayez de créer un groupe de liaison ; cependant, vous devez le remplir pour avoir un groupe de liaison fonctionnel.

• Fournissez les informations metroLinks (numéro de compte, débit, metroCode) à moins que les appareils ne soient dans le réseau de l'entreprise. même métro.

Conditions préalables

Authentifier - Soumettez vos informations d'identification de l'utilisateur, l'ID du client et le secret du client pour l'authentification OAuth2. Reportez-vous à API Authentication pour savoir comment appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.

Étape 2 : Obtenir des appareils virtuels

Pour obtenir des détails sur vos dispositifs virtuels, appelez [Get Virtual Devices] (/api-catalog/network-edgev1#operation/getVirtualDevices). La réponse comprendra :

• virtualDeviceUuids
• metroCodes,
• ASNs
• accountNumbers.

Étape 3 : Créer un lien entre les appareils

	POST /ne/v1/links
Method	POST
URL or End Point	/ne/v1/links
Headers	Authorization, Content-Type
Path Parameters	NA
Body Parameters	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 obtenir une liste complète des paramètres et des options, consultez la [Référence API] (/api-catalog/network-edgev1#operation/createDeviceLinkGroup).

Exemple de réponse

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

Contenu de la réponse :

Field	Type	Example Values	Description
uuid	string	b43ba509-a7d9-4334-8dee-dc4f29bf2e77	The unique ID of the device link group.

État de l'appareil

Lorsqu'un groupe de liens de périphériques est créé, il passe par différents états qui peuvent être surveillés à l'aide de l'attribut de réponse status de la méthode Get Device Link. Votre groupe de liens doit être approvisionné avant que vous ne puissiez commencer à effectuer d'autres opérations telles que l'ajout ou la suppression de périphériques.

Status	Description
PROVISIONING	The device link group is booting.
FAILED	Link creation failed.
PROVISIONED	The device link group is ready.
DEPROVISIONING	The device link group is being de-provisioned.
DEPROVISIONED	The device link group is de-provisioned.

Vous pouvez mettre à jour un groupe de liens en utilisant Update Device Link.

Si vous supprimez un groupe de liaisons de périphériques à l'aide de la méthode Delete Device Link, le groupe passe par les états suivants :

Status	Description
DEPROVISIONING	Equinix accepted the customer's request to delete a device link group.
DEPROVISIONED	The device link is deleted.