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

  2. Llame a Get Device Types para averiguar qué dispositivo de clúster (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.

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

  4. Llame a Get Accounts {METRO} para verificar su account number (oacountReferenceId) 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 al API POST para crear un dispositivo para tu cliente.

Opciones de licencia​

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

  • Juniper Cluster - No es necesario subir archivos de licencia para un Juniper Cluster. Sin embargo, puede cargar dos archivos de licencia. Para subir dos archivos de licencia, llame a Post License File dos veces. Obtendrá el archivo de licencia IDS en la respuesta que puede usar para crear un clúster.

  • Palo Alto Cluster - Debe subir dos tokens de licencia del proveedor. Los tokens de licencia pueden ser iguales o diferentes.

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

  • Arista VeloCloud SD-WAN Edge Cluster No es necesario 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 que se crea su dispositivo, debe iniciar sesión en el dispositivo y cargar la licencia. A continuación, llame a Actualizar dispositivo virtual con el valor de estado PROVISIONED.

Crear dispositivo de clúster​

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

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 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​

Respuesta de la 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 pueden ser monitoreados usando el statusatributo response del métodoGet Virtual Device {uuid}. Su clúster debe estar aprovisionado y su licencia debe estar registrada antes de poder usar este clúster para conectarse a proveedores de servicios en la nube.

Estados de 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 llegan 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 llegan a Network Edge desde Siebel.
WAITING_FOR_PRIMARYEl dispositivo secundario está listo pero el primario no lo está. Este estado puede aparecer si ha solicitado un dispositivo redundante.
WAITING_FOR_SECONDARYEl dispositivo primario está listo pero el secundario no lo está. 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?