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: Obtener 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 es posible cargar una licencia para un dispositivo Arista. Sin embargo, puede iniciar sesión en el dispositivo después de crearlo para cargar una licencia y aumentar el rendimiento.

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

  • Juniper proporciona archivos de licencia. Para traer su propia licencia (BYOL) para un dispositivo Juniper, utilice Post License File para cargar un archivo de licencia. Obtendrá un ID de archivo que podrá utilizar para crear un dispositivo virtual. En caso de que tenga un dispositivo Juniper redundante, puede utilizar el mismo fileId tanto para el dispositivo primario como para el secundario.

  • Fortinet: La licencia no es obligatoria para los dispositivos Fortinet en el momento de la creación del dispositivo. Si dispone de un token, introdúzcalo en el campo licenseToken. 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 Equinix llamando a Post License File. Obtendrá un fileId que podrá utilizar 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
CabecerasAuthorization 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.
Notas

Al crear un dispositivo virtual, usted acepta los Términos del pedido. Llame a Get Order Términos para revisar los detalles. Compruebe la creación de un dispositivo Edge autoconfigurado para comprender los detalles del negocio.

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​

Ejemplo de respuesta para un único dispositivo. 202: Solicitud aceptada.

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

Ejemplo de respuesta para un dispositivo redundante. 202: Solicitud aceptada.

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

Estado del dispositivo​

Supervise 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 los 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 primario no. Este estado puede aparecer sólo si ha creado un dispositivo secundario para redundancia.
WAITING_FOR_SECONDARYEl dispositivo primario está listo pero el secundario no. Este estado puede aparecer sólo si ha creado un dispositivo secundario para redundancia.
FAILEDLa creación del dispositivo ha fallado.
PROVISIONEDEl aparato está listo.

Cuando los usuarios finales eliminan un dispositivo utilizando la API Delete Virtual Devices, el dispositivo pasa por 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.
¿Fue útil esta página?