Crear un dispositivo SDWAN
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 al API de OAuth para validar y autenticar sus credenciales.
Paso 2: Obtener tipos de dispositivo y cuenta
Llame a Obtener tipos de dispositivo
API para encontrar los dispositivos SD-WAN que puede iniciar en la plataforma NE. Aprenderá sobre áreas metropolitanas (metroCode) donde están disponibles estos dispositivos, el número de núcleos disponibles (core), los paquetes de software (packageCode y version), y todas las opciones posibles de licencias y rendimiento.
Puede omitir este paso si ya sabe qué dispositivo desea.
Compruebe su número de cuenta (o accountReferenceId) y el estado en la zona metropolitana donde desea un dispositivo virtual llamando a Obtener cuentas {METRO} API. 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. Para obtener información sobre cómo crear una cuenta, vaya a Gestión de cuentas de facturación .
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 SD-WAN para su cliente.
Puede omitir este paso si ya conoce su número de cuenta (o accountReferenceId) y
su estado.
Paso 3: Configure una licencia
Por ahora, traer su propia licencia (BYOL) es la única opción de licencia disponible para los dispositivos SD-WAN y el proceso para BYOL es único para cada proveedor.
Para configurar una licencia para dispositivos SD-WAN de Cisco, realice lo siguiente:
- Genere un archivo de arranque en la plataforma Cisco vManage.
- Para crear una C8000V-SDWAN, cargue el archivo bootstrap de Cisco llamando a Subir archivo. Obtendrá un
fileUuidIN en la respuesta. Puede introducir el valor enday0TextFileIdel campo de la carga útil Crear para crear un dispositivo virtual C8000V-SDWAN.
Para configurar una licencia para un dispositivo Prisma, realice lo siguiente:
- Genere una clave de licencia (clave ION) y un secreto de licencia (clave secreta) en Prisma Orchestrator.
- Introduzca la clave de licencia (clave ION) y el secreto (clave secreta) al llamar a Equinix Create Device API para crear un dispositivo Prisma SD-WAN.
La licencia no es obligatoria para los dispositivos Fortinet en el momento de la creación del dispositivo. Si tiene un token,
introdúzcalo en el licenseToken campo. Para configurar un archivo de licencia para un dispositivo SD-WAN de Fortinet, realice lo
siguiente:
- Genere un archivo de licencia en el portal de Fortinet.
- Cargue el archivo de licencia en el portal de Equinix llamando al archivo de licencia posterior . Obtendrá una
fileIdque puede utilizar para crear un dispositivo SD-WAN virtual.
Para configurar un dispositivo Versa, cree una plantilla de dispositivo VNF en el director Versa y anote el número de serie.
No necesita un archivo de licencia para configurar un dispositivo Aruba en la plataforma Network Edge.
Para cargar una licencia para un Juniper SD-WAN, haga lo siguiente:
- Genere un archivo de licencia en el portal de Juniper.
- Cargue el archivo de licencia en el portal de Equinix llamando al archivo de licencia posterior . Obtendrá un
fileIddispositivo que puede usar para crear un dispositivo SD-WAN de Juniper.
Paso 4: Parámetros específicos del proveedor
Cada proveedor de SD-WAN requiere su propio conjunto de parámetros distintos de los parámetros comunes enumerados como parte de la definición POST API en el paso 5. Compruebe los parámetros de su proveedor y pase los parámetros en el objeto vendorConfig{} al crear un nuevo dispositivo en el paso 5.
SD-WAN de Cisco
| Parámetros de Cisco vendorConfig{ } | Obligatorio | Tipo | Ejemplo | Valores posibles | Descripción |
|---|---|---|---|---|---|
| ID de sitio | Sí | cadena | 12345 | ID del sitio. Obligatorio para los dispositivos SD-WAN de Cisco. Un SiteID es una ubicación física particular dentro de la red de superposición de Viptela, como una sucursal o un campus. | |
| SystemIpAddress | Sí | cadena | 192.168.1.5 | Dirección IP del sistema. Obligatorio para los dispositivos SD-WAN de Cisco. A cada router vEdge y controlador vSmart se le asigna una dirección IP del sistema. Debe estar en notación decimal de cuatro puntos, al igual que la dirección IPv4. | |
| nombre de host | Condicional | cadena | SR-01 | nombre de host. Obligatorio para C8000V-SDWAN. |
Palo Alto Networks PRISMA-SDWAN
| Parámetros de Palo Alto Networks vendorConfig{ } | Obligatorio | Tipo | Ejemplo | Valores posibles | Descripción |
|---|---|---|---|---|---|
| LICENSEKEY (clave ION) | Sí | cadena | <license_key> | Clave de licencia (clave ION). Obligatorio para dispositivos de Palo Alto Networks. | |
| LicenseSecret (clave secreta) | Sí | cadena | ec68e425-f973-452e-a866-76be5844d0ba | Secreto de licencia (clave secreta). Obligatorio para dispositivos de Palo Alto Networks. |
Versa VERSA_SDWAN
| Parámetros versa vendorConfig{ } | Obligatorio | Tipo | Ejemplo | Valores posibles | Descripción |
|---|---|---|---|---|---|
| LocalId | Sí | cadena | SDWAN-Branch@Versa.com | Dirección de correo electrónico de la sucursal. | |
| RemoteId | Sí | cadena | Controller-01-staging@Versa.com | Dirección de correo electrónico de la parte controladora. | |
| SERIALNUMBER | Sí | cadena | 12345 | El cliente selecciona un número de serie al configurar la plantilla del dispositivo en Versa director. El número de serie del dispositivo posterior a la puesta en escena en Versa director debe coincidir con esta entrada. | |
| controlador 1 | Sí | cadena | 54.219.248.29 | Dirección IP del controlador SD-WAN1. | |
| controlador 2 | Sí | cadena | 54.177.220.115 | Dirección IP del controlador SD-WAN2. |
FortiGate FG-SDWAN *
| Parámetros de FortiGate vendorConfig{ } | Obligatorio | Tipo | Ejemplo | Valores posibles | Descripción |
|---|---|---|---|---|---|
| AdminPassword | Sí | cadena | Esta contraseña 9 | Contraseña. Esta contraseña debe tener al menos 6 caracteres y debe incluir una letra mayúscula y un número. | |
| controlador 1 | Sí | cadena | 1.1.1.1 | Dirección IP del sistema. Obligatorio para los dispositivos SD-WAN de FortiGate. |
*Los dispositivos SD-WAN FortiGate también necesitan un nombre de host, pero no forma parte del objeto vendorConfig, sólo se pasa como parámetro junto con otros como deviceTypeCode, accountNumber, etc.
Arista VELOCLOUD-SDWAN
| Parámetros de Arista vendorConfig{ } | Obligatorio | Tipo | Ejemplo | Valores posibles | Descripción |
|---|---|---|---|---|---|
| ActivationKey | Sí | cadena | GJUK-JM2X-59BJ-SAMPLE | Clave de activación. Disponible en el portal de orquestación de VeloCloud. | |
| Controlador Fqdn | Sí | cadena | demo.velocloud.net | Puerta de enlace SD-WAN de VeloCloud. En la lista de ACL del dispositivo, proporcione las direcciones IP asociadas al controlador Fqdn. | |
| RootPassword | No | cadena | ¡Contraseña de prueba! | Contraseña CLI para el dispositivo. |
HPE ARUBA EDGECONNECT-SDWAN
| Parámetros de Aruba vendorConfig{ } | Obligatorio | Tipo | Ejemplo | Valores posibles | Descripción |
|---|---|---|---|---|---|
| Nombre de la cuenta | Sí | cadena | Nombre de la cuenta | El nombre de la cuenta. | |
| nombre de host | Sí | cadena | myhostname1 | Nombre de host para la identificación. Esto se incluye como FQDN y garantiza que se pueda acceder al dispositivo desde las fuentes aprobadas. Solo se permiten A-z, A-Z, 0-9, y guion(-). Debe comenzar con una letra y terminar con una letra o un dígito. La longitud debe ser de entre 2-30 caracteres. Excepciones - FTDv 2-14; Aruba 2-24. | |
| AccountKey | Sí | cadena | AccountKey | La llave de la cuenta. | |
| ApplianceTag | No | cadena | ApplianceTag | La etiqueta del aparato. |
Paso 5: Cree dispositivos SD-WAN
| PUBLICAR /ne/v1/dispositivos | |
|---|---|
| Método | POST |
| URL o punto final | /ne/v1/devices |
| Encabezados | Authorization, Content-Type |
| Parámetros de consulta | draft, draftUuid |
Si desea crear un dispositivo SD-WAN redundante que tenga dos dispositivos, uno primario y otro secundario, haga lo siguiente:
-
Establezca
vendorConfiglos parámetros del objeto secundario opcional.- proporcione dos licenseFileIds para una Cisco SD-WAN en la carga útil del cuerpo de la solicitud
- proporcione dos claves de licencia (claves ION) y secretos de licencia (claves Secret) para un CloudGenix redundante dispositivo en la carga útil del cuerpo de la solicitud
- Proporcione dos claves de activación para un dispositivo redundante SD-WAN Edge de Arista VeloCloud.
-
Es posible que tenga una plantilla ACL, un número de cuenta, un additionalBandwidth, un metroCode y notificaciones diferentes para su dispositivo secundario.
-
Si es un distribuidor que intenta crear un dispositivo redundante para su cliente, asegúrese de que tanto la zona metropolitana principal como la secundaria estén en el mismo país. Además, los números de cuenta principal y secundaria deben ser los mismos. Se facturará la cuenta del distribuidor; sin embargo, 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 a la cuenta de facturación de un distribuidor.
Si no tiene toda la información necesaria, puede guardar la información como borrador. Debe proporcionar un deviceTypeCode, un countNumber/countReferenceId y un metroCode para guardar un borrador.
Al crear un dispositivo virtual, acepta los Términos del pedido. Llame a Obtener términos del pedido para revisar los detalles.
Solicitud de muestra
Un ejemplo de solicitud curl para crear un dispositivo Cisco SD-WAN redundante.
curl -X POST
https://api.equinix.com/ne/v1/devices?draft=false
-H 'Authorization: Bearer <token>'
-H 'Content-Type: application/json'
-d '
{
"deviceTypeCode": "C8000V-SDWAN",
"projectId": "XXXXX",
"metroCode": "DC",
"termLength": "1",
"licenseMode": "BYOL",
"packageCode": "DNA",
"virtualDeviceName": "sroy-cisco-8v-controller",
"notifications": [
"test@equinix.com"
],
"version": "17.09.01a",
"interfaceCount": 10,
"deviceManagementType": "SELF-CONFIGURED",
"core": 4,
"vendorConfig": {
"systemIpAddress": "1.1.1.1",
"siteId": "4567",
"hostname": "SR-01"
},
"aclTemplateUuid": "3319e378-be2f-40e4-8e79-13ea2aed7a5f",
"day0TextFileId": "917f2621-11d4-468f-9a09-af8fd66c0e57",
"accountNumber": "201091",
"secondary": {
"metroCode": "DC",
"notifications": [
"test@equinix.com"
],
"virtualDeviceName": "sroy-cisco-8v-controller-secondary",
"additionalBandwidth": "100",
"vendorConfig": {
"systemIpAddress": "1.1.1.1",
"siteId": "9886",
"hostname": "SR-02"
},
"aclTemplateUuid": "3319e378-be2f-40e4-8e79-13ea2aed7a5f",
"day0TextFileId": "dec1dee5-eba9-4187-a029-ae76341e8874",
"accountNumber": "201091"
},
"additionalBandwidth": "100"
}
'
Para obtener una lista completa de parámetros y opciones, consulte la referencia de API .
Muestra de respuesta
Respuesta de ejemplo para un solo dispositivo 202: Solicitud aceptada.
{
"uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec"
}
Respuesta de ejemplo para un dispositivo redundante 202: Solicitud aceptada.
{
"uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec",
"secondaryUuid": "de5cf79b-3d16-4ccd-841b-3b68ecda2142"
}
Si aparece el mensaje "Acceso denegado", póngase en contacto con el servicio local de atención al cliente de Equinix para obtener acceso al Portal.
Estado del dispositivo
Cuando se crea un dispositivo SD-WAN, el dispositivo transita a través de varios estados dentro de la infraestructura de Equinix. Estos estados se pueden monitorizar utilizando el atributo de respuesta "status" del APIGet Virtual Device {uuid}. Una vez que su dispositivo esté aprovisionado y se aplique la licencia, puede crear conexiones con proveedores de servicios en la nube.
| Estados del dispositivo virtual | Descripción |
|---|---|
INITIALIZING | Equinix está en proceso de reservar recursos y crear el dispositivo. |
PENDING_ACCOUNT | La cuenta del cliente no está aprobada. La creación del dispositivo continuará una vez que se apruebe la cuenta. |
PROVISIONING | El dispositivo está arrancando. |
PENDING_ORDER | Este 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_SIGNATURE | El cliente aún no ha aceptado los términos de Network Edge. |
CANCEL_ORDER | Se cancela el pedido de Siebel a NE. Este estado solo se aplica a los pedidos que lleguen a Network Edge desde Siebel. |
WAITING_FOR_PRIMARY | El dispositivo secundario está listo, pero el principal no. Este estado puede aparecer si ha solicitado un dispositivo redundante. |
WAITING_FOR_SECONDARY | El dispositivo principal está listo, pero el secundario no. Este estado puede aparecer si ha solicitado un dispositivo redundante. |
FAILED | La creación del dispositivo ha fallado. |
PROVISIONED | El aparato está listo. |
DEPROVISIONING | Equinix aceptó la solicitud del cliente de eliminar el dispositivo virtual. |
DEPROVISIONED | El 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.
| estado | Descripción |
|---|---|
DEPROVISIONING | Equinix aceptó la solicitud del cliente de eliminar el dispositivo virtual. |
DEPROVISIONED | El dispositivo se desprovisiona/elimina. |