Créer un groupe de liens d'appareils

Un groupe de liaison d'appareils peut inclure tout périphérique virtuel provisionné et enregistré, sauf si le périphérique Les interfaces sont déjà saturées. Pour en savoir plus sur les liaisons de périphériques, consultez le guide Réseau Edge (../device-link/ne-device-link.md). Pour créer un groupe de liaisons de périphériques à l'aide des API, vous devez disposer des éléments suivants:

• Au moins deux machines virtuelles provisionnées avec licences enregistrées. Vous devez disposer du deviceUuids et les metroCodes où se trouvent les appareils.

• Vous devez fournir les ASN des appareils si ceux-ci n'ont pas été définis. Si un appareil possède déjà un ASN, récupérez-le en appelant Get Virtual Device.

• Numéro de compte de facturation Equinix . Votre compte doit être actif ou en attente. Vous devez fournir un numéro de compte pour chaque lien créé.

• Choisissez un sous-réseau pour le groupe. Vous devez choisir un sous-réseau en fonction du nombre d'appareils que vous souhaitez ajouter au groupe. Ce champ n'est pas obligatoire lors de la création d'un groupe de liaison ; cependant, vous devez le renseigner pour qu'il soit fonctionnel.

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

Préalable

Authentification: soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète pour l’authentification OAuth2. Consultez la documentation relative à l’authentification API (Authentification API) pour savoir comment appeler l’API OAuth afin de valider et d’authentifier vos identifiants.

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

Pour obtenir des renseignements détaillés sur vos appareils virtuels, appelez Get Virtual Devices. La réponse comprendra:

• virtualDeviceUuids
• metroCodes,
• ASNs
• accountNumbers.

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

	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 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 une liste complète des paramètres et des options, consultez la référence API.

Exemple de réponse

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

Charge utile de 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

Lors de la création d'un groupe de liens de périphériques, celui-ci passe par différents états que vous pouvez suivre grâce à l'attribut de réponse status de la méthode Get Device Link. Votre groupe de liens doit être approvisionné avant que vous puissiez effectuer d'autres opérations, comme 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 à l'aide de Update Device Link.

Si vous supprimez un groupe de liens de périphériques à l'aide de la méthode Supprimer un lien de périphérique, 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.