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 a OAuth API para validar y autenticar sus credenciales.

Paso 2: Obtenga detalles del dispositivo​

  • Llame a Get Device Types para averiguar qué dispositivo autoconfigurado (por ejemplo, router o firewall) desea iniciar en la plataforma NE. Aprenderá sobre las regiones metropolitanas donde están disponibles los dispositivos virtuales, los proveedores de dispositivos, el número de núcleos disponibles, y los paquetes de software y sus versiones. Seleccionar deviceTypeCode, metroCode, , core, packageCodey version.

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

  • Llame a Get Accounts {METRO} para verificar su número de cuenta (o accountReferenceId) y el estado en el metro donde desea un dispositivo virtual. Por razones de facturación, debes tener una cuenta en el metro donde deseas un dispositivo virtual, ya sea en estado Activo o Pendiente. Crea una cuenta si no tienes una.

Si eres un revendedor que intenta crear un dispositivo para tu cliente, debes asegurarte de que las cuentas del cliente y de tu (revendedor) estén en estado Activo o Pendiente. Se facturará tu cuenta, sin embargo, debes enviar el número de cuenta del cliente a API para crear un dispositivo para tu cliente.

Paso 3: Opciones de licencia​

Ofrecemos BYOL (Bring Your Own Licensing) como una 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 apoyamos la carga de una licencia para el dispositivo Arista. Sin embargo, puede iniciar sesión en su dispositivo después de que se haya 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 usar para crear un dispositivo virtual. En caso de que tenga un dispositivo Juniper redundante, puede usar el mismo ID de archivo tanto para los dispositivos primarios como 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 a Archivo de licencia de publicación . Obtendrás un fileId que puedes usar para crear un dispositivo virtual.
    • Inicie sesión en el dispositivo para comprobar el estado de su licencia.

Paso 4: Crear dispositivo autoconfigurado​

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

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

  • Parametrizar el objeto secundario
  • Si usted es un revendedor tratando de crear un dispositivo redundante para su cliente, asegúrese de que tanto el metro primario como secundario estén en el mismo país. Tanto el número de cuenta principal como el secundario deben ser los mismos. Aunque se facturará la cuenta del revendedor, 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 con la cuenta de facturación de un revendedor.
  • 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, usted acepta los Términos del pedido. Llame a Get Order Términos 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 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 Get Virtual Device {uuid}. Su dispositivo debe estar aprovisionado y su licencia debe estar registrada antes de 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_ORDERLa orden 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 primario no lo está. Este estado puede aparecer solo si ha creado un dispositivo secundario para la redundancia.
WAITING_FOR_SECONDARYEl dispositivo primario está listo pero el secundario no lo está. Este estado puede aparecer solo 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.
DEPROVISADOEl dispositivo se desprovisiona/elimina.
¿Le ha resultado útil esta página?