Crear un grupo de enlace de dispositivos

Un grupo de enlace de dispositivo puede incluir cualquier dispositivo virtual que esté aprovisionado y registrado, a menos que las interfaces de dispositivo ya estén llenas. Para obtener más información sobre los enlaces de dispositivos, consulte la [guía] Network Edge(../device-link/ne-device-link.md). Para crear un grupo de enlaces de dispositivos utilizando las API, debe tener lo siguiente:

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

• Debe proporcionar ASN para los dispositivos si no se han establecido. Si un dispositivo ya tiene un ASN, recupérelo llamando a Obtener dispositivo virtual.

• Número de cuenta de facturación de Equinix. Su cuenta debe estar en 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 añadir al grupo. Este no es un campo obligatorio en el momento en que intenta crear un grupo de enlace; sin embargo, debe proporcionarlo para tener un grupo de enlace funcional.

• Proporcione información de metroLinks (número de cuenta, caudal, 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 API Authentication para obtener instrucciones sobre cómo llamar a la API OAuth para validar y autenticar sus credenciales.

Paso 2: Obtener dispositivos virtuales

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

• virtualDeviceUuids
• metroCodes,
• ASNs
• accountNumbers.

Paso 3: Crear enlace de dispositivo

	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 ejemplo de solicitud curl para crear un grupo de enlace 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"  
    }  
  ]  
   
}'

Un ejemplo de solicitud curl 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:

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

Estado del dispositivo

Cuando se crea un grupo de enlace de dispositivos, éste pasa por varios estados que pueden supervisarse utilizando el atributo de respuesta status del método Get Device Link. Su grupo de enlace debe estar aprovisionado antes de que pueda empezar a realizar otras operaciones como añadir o eliminar dispositivos.

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.

Puede actualizar un grupo de enlace utilizando Actualizar enlace de dispositivo.

Si elimina un grupo de enlaces de dispositivos mediante el método Delete Device Link, el grupo pasa por los siguientes estados:

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