Iniciar dispositivo de clúster

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.
Llame a Get Device Types para averiguar qué dispositivo de clúster (por ejemplo, enrutador o cortafuegos) desea lanzar en la plataforma NE. Obtendrá información sobre las regiones metropolitanas en las que está disponible el dispositivo virtual, 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. En caso contrario, Equinix elegirá la primera interfaz disponible.
Llame a Obtener cuentas {metro} para comprobar su número de cuenta (o acountReferenceId) y el 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 (../billing/ne-billing-account-creation.md) 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 POST para crear un dispositivo para su cliente.

Opciones de licencia

Por ahora, sólo ofrecemos la opción BYOL (traiga su propia licencia) para los clusters.

Clúster Juniper - No es necesario cargar archivos de licencia para un clúster Juniper. Sin embargo, puede cargar dos archivos de licencia. Para cargar dos archivos de licencia, llame dos veces a Post License File. Obtendrá IDs de archivos de licencia en la respuesta que podrá utilizar para crear un cluster.
Palo Alto Cluster - Debe cargar dos tokens de licencia del proveedor. Los tokens de licencia pueden ser iguales o diferentes.
Fortinet Cluster - No necesita introducir ningún token o licencia. Si desea cargar archivos de licencia, debe cargar dos archivos de licencia diferentes. Para cargar dos archivos de licencia, llame dos veces a Post License File. Obtendrá IDs de archivos de licencia en la respuesta que podrá utilizar para crear un cluster.
Arista VeloCloud SD-WAN Edge Cluster No necesita cargar un archivo de licencia o token. Sin embargo, debe proporcionar su clave de activación. Si su licencia no se registra después de crear su dispositivo, debe iniciar sesión en el dispositivo y cargar la licencia. A continuación, llame a Update Virtual Device con el valor de estado PROVISIONED.

Crear dispositivo de clúster

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

Nota: Al crear un dispositivo virtual, acepta las Condiciones del pedido. Llame a Obtener Condiciones del Pedido para revisar los detalles.

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

Un ejemplo de solicitud curl para crear un clúster vSRX:

curl -X
POST "https://api.equinix.com/ne/v1/devices?draft=false"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '
{
    "deviceTypeCode": "VSRX",
    "clusterDetails": {
        "clusterName": "sroy-juniper",
        "clusterNodeDetails": {
            "node0": {
                "vendorConfig": {
                    "hostname": "sr012"
                },
                "licenseFileId": "1274fe9f-511c-436f-bc0c-14c876ec55da"
            },
            "node1": {
                "vendorConfig": {
                    "hostname": "sr123"
                },
                "licenseFileId": "65a9be3f-57fb-4c4d-a15b-40950951bc13"
            }
        }
    },
    "metroCode": "SV",
    "termLength": "1",
    "licenseMode": "BYOL",
    "packageCode": "STD",
    "virtualDeviceName": "Test-device-001-SROY",
    "notifications": [
        "test@equinix.com"
    ],
    "hostname": "sr012",
    "aclDetails": [
       {
         "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",
         "interfaceType": "WAN"
       }
    ],
    "accountNumber": "201148",
    "version": "18.4R3-S2",
    "interfaceCount": 8,
    "agreeOrderTerms": true,
    "deviceManagementType": "SELF-CONFIGURED",
    "core": 5,
    "userPublicKey": {
        "username": "sroy",
        "keyName": "keyLlhzL"
    },
    "additionalBandwidth": "100"
}
'

Un ejemplo de solicitud curl para crear un clúster Arista Velocloud SDWAN:

curl -X
POST "https://api.equinix.com/ne/v1/devices?draft=false"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '
{
    "metroCode": "SY",
    "deviceTypeCode": "VELOCLOUD-SDWAN",
    "termLength": "1",
    "clusterDetails": {
        "clusterName": "sroy-velo-cluster",
        "vendorConfig": {
            "node0": {
                "activationKey": "GJUK-JM2X-59BJ-SAMPLE",
                "controllerFqdn": "demo.velocloud.net",
                "rootPassword": "TestPassword!"
            },
            "node1": {
                "rootPassword": "TestPassword#"
            }
        }
    },
    "licenseMode": "BYOL",
    "packageCode": "VeloCloud-4",
    "virtualDeviceName": "velo-cluster",
    "notifications": [
        "test@equinix.com"
    ],
    "aclDetails": [
       {
         "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",
         "interfaceType": "WAN"
       }
    ],
    "accountNumber": "2393479",
    "version": "3.4.2",
    "interfaceCount": 8,
    "deviceManagementType": "SELF-CONFIGURED",
    "agreeOrderTerms": true,
    "core": 4,
    "userPublicKey": {
        "username": "sroy",
        "keyName": "key7YFfL"
    },
    "additionalBandwidth": "200"
}
'

Un ejemplo de solicitud curl para crear un clúster PANW 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": "PA-VM",
    "clusterDetails": {
        "clusterName": "NEAut-",
        "clusterNodeDetails": {
            "node0": {
            "vendorConfig": {
                "hostname": "PANCluster"
            }
            },
            "node1": {
            "vendorConfig": {
                "hostname": "PANCluster"
            }
            }
        }
    },
    "metroCode": "#(supportedMetro)",
    "zoneCode": "Zone1",
    "termLength": "1",
    "licenseMode": "BYOL",
    "packageCode": "VM100",
    "virtualDeviceName": "NEAut-",
    "notifications": [
        "t@t.com"
    ],
    "version": "10.1.3",
    "interfaceCount": 10,
    "deviceManagementType": "SELF-CONFIGURED",
    "core": 2,
    "connectivity": "PRIVATE"
}
'

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

Muestra de respuesta

Ejemplo de respuesta 202: Solicitud aceptada.

{
    "uuid": "34b7838c-ec82-4166-ac19-efa03b4e34fe",
    "deviceIds": {
        "node0": "34b7838c-ec82-4166-ac19-efa03b4e34fe",
        "node1": "f27f1475-3c7f-447f-b0db-e3bb3af3de16"
    },
    "clusterId": "27eea9aa-327b-431b-bf62-3cee4d880f2e"
}

Estado del dispositivo

Cuando se crea un clúster, el clúster autoconfigurado pasa por varios estados dentro de la infraestructura de Equinix. Estos estados pueden supervisarse utilizando el atributo de respuesta status del método Get Virtual Device {uuid}. Su clúster debe estar aprovisionado y su licencia debe estar registrada antes de que pueda utilizar este clúster para conectarse a proveedores de servicios en la nube.

Virtual device states	Description
`INITIALIZING`	Equinix is in the process of reserving resources and creating the device.
`PENDING_ACCOUNT`	Customer's account is not approved. The device creation will continue once the account gets approved.
`PROVISIONING`	The device is booting.
`PENDING_ORDER`	This status only applies to orders coming to NE from Siebel. Customers need to log in to the Network Edge portal and submit the pending order.
`PENDING_SIGNATURE`	The customer has not yet accepted Network Edge terms.
`CANCEL_ORDER`	The order from Siebel to NE is canceled. This status only applies to orders coming to Network Edge from Siebel.
`WAITING_FOR_PRIMARY`	The secondary device is ready but the primary is not. This state may appear if you have requested a redundant device.
`WAITING_FOR_SECONDARY`	The primary device is ready but the secondary is not. This state may appear if you have requested a redundant device.
`FAILED`	The device creation failed.
`PROVISIONED`	The device is ready.
`DEPROVISIONING`	Equinix accepted the customer's request to delete the virtual device.
`DEPROVISIONED`	The device is de-provisioned/deleted.

Cuando un usuario final elimina un dispositivo utilizando la API Delete Virtual Devices, el dispositivo pasa por los siguientes estados dentro de la infraestructura de Equinix.

status	Description
`DEPROVISIONING`	Equinix accepted the customer's request to delete the virtual device.
`DEPROVISIONED`	The device is de-provisioned/deleted.

Requisitos previos​

Opciones de licencia​

Crear dispositivo de clúster​

Muestra de respuesta​

Estado del dispositivo​

Requisitos previos

Opciones de licencia

Crear dispositivo de clúster

Muestra de respuesta

Estado del dispositivo