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 API Authentication para obtener instrucciones sobre cómo llamar a la API OAuth para validar y autenticar sus credenciales.

Paso 2: Obtener detalles del dispositivo

Llame a Get Device Types para averiguar qué dispositivo autoconfigurado (por ejemplo, enrutador o cortafuegos) desea lanzar en la plataforma NE. Conocerá las regiones metropolitanas en las que están disponibles los dispositivos virtuales, los proveedores de los dispositivos, el número de núcleos disponibles y los paquetes de software y sus versiones. Seleccione deviceTypeCode, metroCode, core, packageCode y version.
Llame a Obtener interfaces permitidas para averiguar el número de interfaces permitidas 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 Obtener cuentas {metro} para comprobar su número de cuenta (o acountReferenceId) y su estado en el metro en el que desea un dispositivo virtual. Por motivos de facturación, debe tener una cuenta en el metro en el que desea un dispositivo virtual, ya sea en estado Activo o Pendiente. Cree una cuenta si no dispone de una.

Si usted es un revendedor de **** que intenta crear un dispositivo para su cliente, debe asegurarse de que tanto la cuenta del cliente como la suya (la del revendedor) están en estado Activo o Pendiente. Sin embargo, deberá enviar el número de cuenta del cliente a la API para crear un dispositivo para su cliente.

Paso 3: Opciones de licencia

Ofrecemos la opción de licencia BYOL (Bring Your Own Licensing) 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 8KV, 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

	POST /ne/v1/devices
Method	`POST`
URL or End Point	`/ne/v1/devices`
Headers	`Authorization` token, `Content-Type`
Query Parameters	`draft`, `draftUuid`

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

Parametrizar el objeto secundario
Si usted es un revendedor de **** que intenta crear un dispositivo redundante para su cliente, asegúrese de que tanto el metro primario como el secundario se encuentran en el mismo país. Tanto el número de cuenta primario como el secundario deben ser el mismo. Aunque se facturará a la cuenta del revendedor, esta API acepta el número de cuenta del cliente para crear dispositivos para él. Las restricciones anteriores son necesarias ya que cada cliente está asociado a una cuenta de facturación del 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, acepta las Condiciones del pedido. Llame a Obtener Condiciones del Pedido para revisar los detalles. Consulte Creación de un dispositivo Edge autoconfigurado para conocer los detalles comerciales.

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": "18.4R2-S1.4",  
    "interfaceCount": 10,  
    "deviceManagementType": "SELF-CONFIGURED",  
    "core": 5,  
    "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-002-SROY",  
    "notifications": [  
        "test@equinix.com"  
    ],  
    "hostNamePrefix": "TC01",  
        "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
    "accountNumber": "201148",  
    "version": "17.06.01a",  
    "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-001-SROY - secondary",  
        "additionalBandwidth": "100",  
            "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
        "accountNumber": "201148",  
        "sshInterfaceId": "4"  
    },  
    "additionalBandwidth": "100"  
}  
'

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": "#(supportedMetro)",  
    "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": "#(supportedMetroForSec)",  
        "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.

Virtual device "status"	Description
`INITIALIZING`	Equinix is in the process of reserving resources and creating the device.
`PROVISIONING`	The device is booting.
`PENDING_ORDER`	The order has come to NE from Siebel. Customers need to log in to the NE portal and submit the order.
`PENDING_SIGNATURE`	The customer has signed up for the offline acceptance of NE terms but has not yet accepted the terms.
`CANCEL_ORDER`	The order from Siebel to NE is canceled.
`WAITING_FOR_PRIMARY`	The secondary device is ready but the primary is not. This state might appear only if you have created a secondary device for redundancy.
`WAITING_FOR_SECONDARY`	The primary device is ready but the secondary is not. This state might appear only if you have created a secondary device for redundancy.
`FAILED`	The device creation failed.
`PROVISIONED`	The device is ready.

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.

Virtual device "status" under /ne/v1/devices/{uuid}	Description
DEPROVISIONING	Equinix accepted the customer's request to delete a virtual device.
DEPROVISIONED	The device is de-provisioned/deleted.

Requisitos previos​

Paso 2: Obtener detalles del dispositivo​

Paso 3: Opciones de licencia​

Paso 4: Crear dispositivo autoconfigurado​

Ejemplos de solicitudes​

Ejemplos de respuestas​

Estado del dispositivo​