Saltar al contenido principal

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. 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 Obtener dispositivo virtual .

  • 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 añadir al grupo. Este no es un campo obligatorio en el momento en que intenta crear un grupo de vinculación; sin embargo, debe proporcionarlo para tener un grupo de vinculación 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 al API de 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
MétodoPOST
URL o punto final/ne/v1/links
EncabezadosAuthorization, Content-Type
Parámetros de la rutaNA
Parámetros corporalesgroupName, subnet, redundancyType, , linkDevices[deviceUuid, asn, interfaceId]``metroLinks[ {accountNumber, throughput, throughputUnit, metroCode}]

Una solicitud de curl de ejemplo para crear un grupo de enlaces de dispositivos entre dos dispositivos en dos áreas metropolitanas 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 ejemplo para crear un enlace de dispositivo entre dos dispositivos dentro de un área metropolitana.

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 de API .

Muestra de respuesta​

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

Carga útil de la respuesta:

CampoTipoEjemplos de valoresDescripción
uuidcadenab43ba509-a7d9-4334-8dee-dc4f29bf2e77El ID único del grupo de enlaces de dispositivos.

Estado del dispositivo​

Cuando se crea un grupo de enlaces de dispositivos, este realiza la transición a través de varios estados que se pueden monitorizar utilizando el statusatributo de respuesta del métodoGet Device Link. Su grupo de enlaces debe estar aprovisionado para poder comenzar a realizar otras operaciones, como añadir o eliminar dispositivos.

EstadoDescripción
PROVISIONINGEl grupo de enlaces de dispositivos se está iniciando.
FAILEDError de creación del enlace.
PROVISIONEDEl grupo de enlaces de dispositivos está listo.
DEPROVISIONINGEl grupo de enlaces de dispositivos se está desaprovisionando.
DEPROVISIONEDEl grupo de enlaces de dispositivos está desaprovisionado.

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

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

EstadoDescripción
DEPROVISIONINGEquinix aceptó la solicitud del cliente para eliminar un grupo de enlaces de dispositivos.
DEPROVISIONEDSe ha eliminado el enlace del dispositivo.
¿Le ha resultado útil esta página?