Saltar al contenido principal

Iniciar dispositivo de clúster

Requisitos previos​

  1. 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.

  2. Llame a obtener tipos de dispositivo para averiguar qué dispositivo del clúster (por ejemplo, router 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.

  3. 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.

  4. Llama a Obtener cuentas {METRO} para comprobar tu account number (o acountReferenceId) y el estado en el área metropolitana donde deseas 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 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 de Juniper - No es necesario cargar archivos de licencia para un clúster de Juniper. Sin embargo, puede cargar dos archivos de licencia. Para cargar dos archivos de licencia, llame al archivo de licencia Post dos veces. Obtendrá el IDS del archivo de licencia en la respuesta que puede utilizar para crear un clúster.

  • Clúster de Palo Alto - Debe cargar dos tokens de licencia del proveedor. Los tokens de licencia pueden ser iguales o diferentes.

  • Clúster de Fortinet - No es necesario introducir un token o una licencia. Si desea cargar archivos de licencia, debe cargar dos archivos de licencia diferentes. Para cargar dos archivos de licencia, llame al archivo de licencia Post dos veces. Obtendrá el IDS del archivo de licencia en la respuesta que puede utilizar para crear un clúster.

  • 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, llama a Actualizar dispositivo virtual con el valor de estado PROVISIONED.

Crear dispositivo de clúster​

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

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 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 de API .

Muestra de respuesta​

Respuesta de muestra 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 transita a través de varios estados dentro de la infraestructura de Equinix. Estos estados se pueden monitorizar utilizando el status atributo respuesta del métodoGet Virtual Device {uuid}. Su clúster debe estar aprovisionado y su licencia debe estar registrada antes de poder utilizar este clúster para conectarse a proveedores de servicios en la nube.

Estados del dispositivo virtualDescripción
INITIALIZINGEquinix está en proceso de reservar recursos y crear el dispositivo.
PENDING_ACCOUNTLa cuenta del cliente no está aprobada. La creación del dispositivo continuará una vez que se apruebe la cuenta.
PROVISIONINGEl dispositivo está arrancando.
PENDING_ORDEREste estado solo se aplica a los pedidos que lleguen a NE desde Siebel. Los clientes deben iniciar sesión en el portal de Network Edge y enviar el pedido pendiente.
PENDING_SIGNATUREEl cliente aún no ha aceptado los términos de Network Edge.
CANCEL_ORDERSe cancela el pedido de Siebel a NE. Este estado solo se aplica a los pedidos que lleguen a Network Edge desde Siebel.
WAITING_FOR_PRIMARYEl dispositivo secundario está listo, pero el principal no. Este estado puede aparecer si ha solicitado un dispositivo redundante.
WAITING_FOR_SECONDARYEl dispositivo principal está listo, pero el secundario no. Este estado puede aparecer si ha solicitado un dispositivo redundante.
FAILEDLa creación del dispositivo ha fallado.
PROVISIONEDEl aparato está listo.
DEPROVISIONINGEquinix aceptó la solicitud del cliente de eliminar el dispositivo virtual.
DEPROVISIONEDEl dispositivo se desprovisiona/elimina.

Cuando un usuario final elimina 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.

estadoDescripción
DEPROVISIONINGEquinix aceptó la solicitud del cliente de eliminar el dispositivo virtual.
DEPROVISIONEDEl dispositivo se desprovisiona/elimina.
¿Le ha resultado útil esta página?