Crear un grupo de enlace de dispositivos

Un grupo de enlaces de dispositivos puede incluir cualquier dispositivo virtual que esté aprovisionado y registrado a menos que las interfaces de dispositivos ya estén llenas. Para obtener más información sobre los enlaces de dispositivos, consulte la guía de Network Edge . Para crear un grupo de enlaces de dispositivos mediante API, debe tener lo siguiente:

• Al menos dos dispositivos virtuales aprovisionados con licencias registradas. Usted debe tener el deviceUuids y el metroCodes lugar donde se encuentran los dispositivos.

• Debe proporcionar ASN para los dispositivos si los ASN no se han configurado. Si un dispositivo ya tiene un ASN, recupere el ASN llamando a Get Virtual Device.

• Número de cuenta de facturación de Equinix. Su cuenta debe estar en el estado Activo o Pendiente. Debe proporcionar un número de cuenta para cada enlace que cree.

• Elija una subred para el grupo. Debe elegir una subred teniendo en cuenta el número de dispositivos que desea agregar al grupo. Este no es un campo obligatorio en el momento en que intenta crear un grupo de enlace; sin embargo, debe proporcionar esto para tener un grupo de enlace funcional.

• Proporcione metroLinks información (número de cuenta, rendimiento, metroCode) a menos que los dispositivos estén en el mismo metro.

Requisitos previos

Autenticar: Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte Autenticación de API para obtener instrucciones sobre cómo llamar a OAuth API para validar y autenticar sus credenciales.

Paso 2: Obtener dispositivos virtuales

Para obtener detalles de sus dispositivos virtuales, llame a Get Virtual Devices. La respuesta incluirá:

• virtualDeviceUuids
• metroCodes,
• ASNs
• accountNumbers.

Paso 3: Crear enlace de dispositivo

	POST /ne/v1/links
Método	POST
URL o punto final	/ne/v1/links
Encabezados	Authorization, Content-Type
Parámetros de la ruta	NA
Parámetros corporales	groupName, subnet, redundancyType, , , linkDevices[deviceUuid, asn, interfaceId]``metroLinks[ {accountNumber, throughput, throughputUnit, metroCode}]

Una solicitud curl de muestra para crear un grupo de enlaces de dispositivos entre dos dispositivos en dos metros diferentes.

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"  
    }  
  ]  
   
}'

Una solicitud de curl de muestra para crear un enlace de dispositivo entre dos dispositivos dentro de un metro.

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": []  
      
}'

Para obtener una lista completa de parámetros y opciones, consulte la Referencia API .

Muestra de respuesta

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

Carga útil de la respuesta:

Campo	Tipo	Ejemplos de valores	Descripción
uuid	cadena	b43ba509-a7d9-4334-8dee-dc4f29bf2e77	El ID único del grupo de enlaces de dispositivos.

Estado del dispositivo

Cuando se crea un grupo de enlaces de dispositivos, este transita a través de varios estados que se pueden monitorear utilizando el statusatributo de respuesta del métodoGet Device Link. Su grupo de enlaces debe estar aprovisionado antes de que pueda comenzar a realizar otras operaciones como agregar o quitar dispositivos.

Estado	Descripción
PROVISIONING	El grupo de enlaces de dispositivos se está iniciando.
FAILED	La creación de enlaces falló.
PROVISIONED	El grupo de enlaces de dispositivos está listo.
DEPROVISIONING	El grupo de enlaces de dispositivos se está desaprovisionando.
DEPROVISIONED	El grupo de enlaces de dispositivos está desaprovisionado.

Puede actualizar un grupo de enlaces mediante Actualizar enlace de dispositivo .

Si elimina un grupo de vínculos de dispositivo mediante el métodoEliminar enlace de dispositivo, el grupo realiza la transición a través de los siguientes estados:

Estado	Descripción
DEPROVISIONING	Equinix aceptó la solicitud del cliente de eliminar un grupo de enlaces de dispositivos.
DEPROVISIONED	El enlace del dispositivo se elimina.