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
deviceUuidset 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
metroLinksdes 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 :
virtualDeviceUuidsmetroCodes,ASNsaccountNumbers.
Étape 3 : Créer un lien de dispositif
POST /ne/v1/links | |
|---|---|
| Méthode | POST |
| URL ou point de terminaison | /ne/v1/links |
| En-têtes | Authorization, Content-Type |
| Paramètres du chemin | NA |
| Paramètres corporels | 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 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:
| 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 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.
| État | Description |
|---|---|
PROVISIONING | Le groupe de liaison de périphériques démarre. |
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 périphériques est en cours de déprovisionnement. |
DEPROVISIONED | Le 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 :
| État | Description |
|---|---|
DEPROVISIONING | Equinix a accepté la demande du client de supprimer un groupe de liens d'appareils. |
DEPROVISIONED | Le lien de l'appareil est supprimé. |