Saltar al contenido principal

Crear un dispositivo

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: Obtén los detalles del dispositivo​

  • Llame a obtener tipos de dispositivo para averiguar qué dispositivo autoconfigurado (por ejemplo, enrutador o cortafuegos) desea iniciar en la plataforma NE. Aprenderá sobre las regiones metropolitanas donde hay dispositivos virtuales disponibles, los proveedores de dispositivos, el número de núcleos disponibles y los paquetes de software y sus versiones. Seleccione deviceTypeCode, metroCode, , core, packageCodey version.

  • Llama a Obtener interfaces permitidas para averiguar el número permitido de interfaces para el núcleo seleccionado. Puede seleccionar cualquier interfaz de dispositivo disponible como sshInterfaceId. De lo contrario, Equinix elegirá la primera interfaz disponible.

  • Llame a obtener cuentas {METRO} para comprobar su número de cuenta (o accountReferenceId) y el estado en el área metropolitana donde desea un dispositivo virtual. Por motivos de facturación, debe tener una cuenta en la zona metropolitana donde desea un dispositivo virtual, ya sea en estado Activo o Pendiente. Cree una cuenta si no tiene una.

Si es un distribuidor que intenta crear un dispositivo para su cliente, debe asegurarse de que las cuentas del cliente y de su (distribuidor) estén en estado Activo o Pendiente. Se facturará su cuenta. Sin embargo, debe enviar el número de cuenta del cliente al API para crear un dispositivo para su cliente.

Paso 3: Opciones de licencia​

Ofrecemos BYOL (Traiga su propia licencia) como opción de licencia para la mayoría de los dispositivos. Cargue un archivo de licencia o un código/token/ID, dependiendo de lo que ofrezca su proveedor. Para Cisco 8000V, tiene la opción de licencia de suscripción.

  • Arista: No admitimos cargar una licencia para el dispositivo Arista. Sin embargo, puede iniciar sesión en su dispositivo una vez creado para cargar una licencia para aumentar su rendimiento.

  • Cisco y Palo Alto proporcionan tokens de licencia. Introduzca el token de licencia en el licenseToken campo.

  • Juniper proporciona archivos de licencia. Para traer su propia licencia (BYOL) para un dispositivo Juniper, utilice el archivo de licencia Post para cargar un archivo de licencia. Obtendrá un ID de archivo que puede utilizar para crear un dispositivo virtual. En caso de que tenga un dispositivo Juniper redundante, puede utilizar el mismo ID de archivo tanto para los dispositivos principales como para los secundarios.

  • Fortinet: La licencia no es obligatoria para los dispositivos Fortinet en el momento de la creación del dispositivo. Si tiene un token, introdúzcalo en el licenseToken campo. Para configurar un archivo de licencia para un dispositivo Fortinet, debe hacer lo siguiente:

    • Genere un archivo de licencia en el portal de Fortinet.
    • Cargue el archivo de licencia en el portal de Equinix llamando al archivo de licencia posterior . Obtendrá una fileId que puede utilizar para crear un dispositivo virtual.
    • Inicie sesión en el dispositivo para comprobar el estado de su licencia.

Paso 4: Cree un dispositivo autoconfigurado​

PUBLICAR /ne/v1/dispositivos
MétodoPOST
URL o punto final/ne/v1/devices
EncabezadosAuthorization token, Content-Type
Parámetros de consultadraft, draftUuid

Para crear un dispositivo redundante que tenga dispositivos primarios y secundarios:

  • Parametrizar el objeto secundario
  • Si es un distribuidor que intenta crear un dispositivo redundante para su cliente, asegúrese de que tanto la zona metropolitana principal como la secundaria estén en el mismo país. Tanto los números de cuenta principal como los números secundarios deben ser los mismos. Aunque se facturará la cuenta del distribuidor, este API acepta el número de cuenta del cliente para crear dispositivos para el cliente. Las restricciones anteriores son necesarias, ya que cada cliente está asociado a la cuenta de facturación de un distribuidor.
  • En el caso de los dispositivos Cisco FTD, el tipo de gestión de los dispositivos primario y secundario debe ser el mismo.
nota

Al crear un dispositivo virtual, acepta los Términos del pedido. Llame a Obtener términos del pedido para revisar los detalles.

Para guardar un borrador de dispositivo, debe proporcionar deviceTypeCode, accountNumber o accountReferenceId, y metroCode.

Ejemplos de solicitudes​

Un ejemplo de solicitud curl para crear un único dispositivo.

curl -X  
POST "https://api.equinix.com/ne/v1/devices?draft=false"  
-H "content-type: application/json"  
-H "Authorization: Bearer <token>"  
-d '  
{  
    "metroCode": "SV",  
    "deviceTypeCode": "VSRX",  
    "agreeOrderTerms": true,  
    "termLength": "1",  
    "licenseMode": "BYOL",  
    "packageCode": "STD",  
    "virtualDeviceName": "Test-device-001-SROY",  
    "notifications": [  
        "test@equinix.com"  
    ],  
    "hostNamePrefix": "TC12",  
    "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
    "accountNumber": "200541",  
    "version": "23.2R1.13",  
    "interfaceCount": 8,  
    "deviceManagementType": "SELF-CONFIGURED",  
    "core": 2,  
    "userPublicKey": {  
        "username": "userName",  
        "keyName": "keyName"  
    },  
    "additionalBandwidth": "100"  
}  
'

Un ejemplo de petición curl para crear un dispositivo redundante.

curl -X  
POST "https://api.equinix.com/ne/v1/devices?draft=false"  
-H "content-type: application/json"  
-H "Authorization: Bearer <token>"  
-d '  
{  
    "metroCode": "DC",  
    "deviceTypeCode": "C8000V",  
    "agreeOrderTerms": true,  
    "termLength": "1",  
    "licenseMode": "BYOL",  
    "packageCode": "network-advantage",  
    "virtualDeviceName": "Test-device-001-SROY - primary",  
    "notifications": [  
        "test@equinix.com"  
    ],  
    "hostNamePrefix": "TC01",  
        "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
    "accountNumber": "201148",  
    "version": "17.06.06a",  
    "interfaceCount": 10,  
    "deviceManagementType": "SELF-CONFIGURED",  
    "core": 2,  
    "userPublicKey": {  
        "username": "sroy",  
        "keyName": "keyWIQzB"  
    },  
    "sshInterfaceId": "3",  
    "channelPartner": "SDCI",  
    "secondary": {  
        "metroCode": "DC",  
        "hostNamePrefix": "TC02",  
        "notifications": [  
            "test@equinix.com"  
        ],  
        "virtualDeviceName": "Test-device-002-SROY - secondary",  
        "additionalBandwidth": "100",  
            "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
        "accountNumber": "201148",  
        "sshInterfaceId": "4"  
    }  
}  
'

Un ejemplo de solicitud curl para crear un dispositivo secundario Cisco FTD sin acceso a Internet.

curl -X  
POST "https://api.equinix.com/ne/v1/devices?draft=false"  
-H "content-type: application/json"  
-H "Authorization: Bearer <token>"  
-d '  
{  
    "deviceTypeCode": "Cisco_NGFW",  
    "licenseMode": "BYOL",  
    "packageCode": "FTDv5",  
    "virtualDeviceName": "NEAut-",  
    "metroCode": "DC",  
    "notifications": [  
        "t@t.com"  
    ],  
    "hostNamePrefix": "test",  
    "interfaceCount": 10,  
    "deviceManagementType": "SELF-CONFIGURED",  
    "core": 4,  
    "version": "7.0.4-55",  
    "vendorConfig": {  
        "managementType": "FDM"  
    },  
    "connectivity": "PRIVATE",  
    "secondary": {  
        "hostNamePrefix": "test-123",  
        "metroCode": "DC",  
        "notifications": [  
            "t@t.com"  
        ],  
        "virtualDeviceName": "test-secondary",  
        "vendorConfig": {  
            "managementType": "FDM"  
        }  
    }  
}  
'

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

Ejemplos de respuestas​

Respuesta de muestra para un solo dispositivo. 202: Solicitud aceptada.

{  
    "uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec"  
}

Respuesta de muestra para un dispositivo redundante. 202: Solicitud aceptada.

{  
    "uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec",  
    "secondaryUuid": "de5cf79b-3d16-4ccd-841b-3b68ecda2142"  
}

Estado del dispositivo​

Monitoree el estado de su dispositivo llamando a Obtener dispositivo virtual {uuid}. Su dispositivo debe estar aprovisionado y su licencia debe estar registrada para poder conectarse a proveedores de servicios en la nube.

"Estado" del dispositivo virtualDescripción
INITIALIZINGEquinix está en proceso de reservar recursos y crear el dispositivo.
PROVISIONINGEl dispositivo está arrancando.
PENDING_ORDEREl pedido ha llegado a NE desde Siebel. Los clientes deben iniciar sesión en el portal de NE y enviar el pedido.
PENDING_SIGNATUREEl cliente se ha inscrito para la aceptación offline de las condiciones NE, pero aún no las ha aceptado.
CANCEL_ORDERSe cancela el pedido de Siebel a NE.
WAITING_FOR_PRIMARYEl dispositivo secundario está listo, pero el principal no. Este estado solo puede aparecer si ha creado un dispositivo secundario para la redundancia.
WAITING_FOR_SECONDARYEl dispositivo principal está listo, pero el secundario no. Este estado solo puede aparecer si ha creado un dispositivo secundario para la redundancia.
FAILEDLa creación del dispositivo ha fallado.
PROVISIONEDEl aparato está listo.

Cuando los usuarios finales eliminan un dispositivo mediante el APIEliminar dispositivos virtuales, el dispositivo realiza la transición a través de los siguientes estados dentro de la infraestructura de Equinix.

Dispositivo virtual "status" en /ne/v1/devices/{uuid}Descripción
DESAPROVISIONAMIENTOEquinix aceptó la solicitud del cliente de eliminar un dispositivo virtual.
DESAPROVISIONADOEl dispositivo se desprovisiona/elimina.
¿Le ha resultado útil esta página?