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 a OAuth API para validar y autenticar sus credenciales.
Paso 2: Obtener tipos de dispositivo y cuenta
Llame a la API Get Device Types para encontrar los dispositivos SD-WAN que puede lanzar en la plataforma NE. Conocerá los metros (metroCode) en los que 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 licencia y rendimiento.
Puede omitir este paso si ya sabe qué dispositivo desea.
Compruebe su número de cuenta (o accountReferenceId) y su estado en el metro en el que desea un dispositivo virtual llamando a la API Get Accounts {metro}. 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. Para saber cómo crear una cuenta, vaya a Gestión de cuentas de facturación.
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á su cuenta, sin embargo, debe enviar el número de cuenta del cliente a la 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: Configurar 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, haga lo siguiente:
- Genere un archivo de arranque en la plataforma Cisco vManage.
- Para crear una SDWAN C8000V, cargue el archivo de arranque de Cisco llamando a Upload File. Obtendrá un
fileUuiden la respuesta. Puede introducir el valor en el campoday0TextFileIdde la carga útil de creación para crear un dispositivo C8000V-SDWAN virtual.
Para configurar una licencia para un dispositivo Prisma, haga lo siguiente:
- Genere una clave de licencia (ION KEY) y un secreto de licencia (Secret Key) en Prisma Orchestrator.
- Ingrese 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 dispone de un token, introdúzcalo en el campo licenseToken. Para configurar un archivo de licencia para un dispositivo SD-WAN de Fortinet, haga 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
fileIdque podrá 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 Equinix llamando a Post License File. Obtendrá un
fileIdque podrá utilizar 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, aparte de los parámetros comunes enumerados como parte de la definición de la API POST en Paso 5. Por favor, compruebe los parámetros de su proveedor y pase los parámetros en el objeto vendorConfig{} cuando cree un nuevo dispositivo en el Paso 5.
SD-WAN de Cisco
| Cisco vendorConfig{ } Parámetros | Obligatorio | Escriba a | Ejemplo | Valores posibles | Descripción |
|---|---|---|---|---|---|
| SiteID | Sí | cadena | 12345 | Site Id. Obligatorio para los dispositivos SD-WAN de Cisco. Un siteId es una ubicación física concreta dentro de la red superpuesta 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 partes con puntos, 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
| Palo Alto Networks vendorConfig{ } Parámetros | Obligatorio | Escriba a | Ejemplo | Valores posibles | Descripción |
|---|---|---|---|---|---|
| LICENSEKEY (ION KEY) | Sí | cadena | <license_key> | Clave de licencia (ION KEY). Obligatorio para dispositivos Palo Alto Networks. | |
| LicenseSecret (Clave secreta) | Sí | cadena | ec68e425-f973-452e-a866-76be5844d0ba | Secreto de licencia (Clave secreta). Obligatorio para dispositivos Palo Alto Networks. |
Versa VERSA_SDWAN
| Versa vendorConfig{ } Parámetros | Obligatorio | Escriba a | 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 de puesta a disposición posterior de Versa en Versa director debe coincidir con esta entrada. | |
| controlador 1 | Sí | cadena | 54.219.248.29 | Dirección IP del controlador SD-WAN1. | |
| controlador2 | Sí | cadena | 54.177.220.115 | Dirección IP del controlador SD-WAN2. |
FortiGate FG-SDWAN *
| FortiGate vendorConfig{ } Parámetros | Obligatorio | Escriba a | Ejemplo | Valores posibles | Descripción |
|---|---|---|---|---|---|
| AdminPassword | Sí | cadena | ThisPassword9 | 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 FortiGate SD-WAN. |
*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
| Arista vendorConfig{ } Parámetros | Obligatorio | Escriba a | Ejemplo | Valores posibles | Descripción |
|---|---|---|---|---|---|
| ActivaciónKey | Sí | cadena | GJUK-JM2X-59BJ-SAMPLE | Clave de activación. Disponible en el Portal de Orquestación VeloCloud. | |
| ControllerFqdn | Sí | cadena | demo.velocloud.net | Puerta de enlace VeloCloud SD-WAN. En la lista de ACL del dispositivo, indique las direcciones IP asociadas al controladorFqdn. | |
| RootPassword | No | cadena | ¡TestPassword! | Contraseña CLI para el dispositivo. |
HPE ARUBA EDGECONNECT-SDWAN
| Aruba vendorConfig{ } Parámetros | Obligatorio | Escriba a | 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 identificación. Se incluye como FQDN y garantiza que se pueda acceder al dispositivo desde las fuentes autorizadas. Sólo se permiten a-z, A-Z, 0-9 y guión(-). Debe empezar por una letra y terminar por una letra o un dígito. La longitud debe estar comprendida entre 2 y 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: Crear dispositivos SD-WAN
| PUBLICAR /ne/v1/devices | |
|---|---|
| Método | POST |
| URL o punto final | /ne/v1/devices |
| Cabeceras | 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 los parámetros
vendorConfigdel 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 activationKeys para un dispositivo redundante Arista VeloCloud SD-WAN Edge.
-
Es posible que tenga una plantilla ACL, un número de cuenta, un additionalBandwidth, un metroCode y notificaciones diferentes para su dispositivo secundario.
-
Si usted es un revendedor tratando de crear un dispositivo redundante para su cliente, asegúrese de que tanto el metro primario como secundario estén en el mismo país. Además, los números de cuenta primarios y secundarios deben ser los mismos. Se facturará la cuenta del revendedor, 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 con la cuenta de facturación de un revendedor.
Debe proporcionar un deviceTypeCode, un accountNumber/accountReferenceId y un metroCode para guardar un borrador.
Al crear un dispositivo virtual, usted acepta los Términos del pedido. Llame a Get Order Términos 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 API.
Muestra de respuesta
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"
}
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 pasa por varios estados dentro de la infraestructura de Equinix. Estos estados pueden supervisarse utilizando el atributo de respuesta "status" de la API Get Virtual Device {uuid}. Una vez aprovisionado su dispositivo y aplicada la licencia, puede crear conexiones con los proveedores de servicios en la nube.
| Estados de 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á cuando se apruebe la cuenta. |
PROVISIONING | El dispositivo está arrancando. |
PENDING_ORDER | Este estado sólo se aplica a los pedidos que llegan a NE desde Siebel. Los clientes deben iniciar sesión en el portal Network Edge y enviar el pedido pendiente. |
PENDING_SIGNATURE | El cliente aún no ha aceptado las condiciones de Network Edge. |
CANCEL_ORDER | El pedido de Siebel a NE está cancelado. Este estado sólo se aplica a los pedidos que llegan a Network Edge desde Siebel. |
WAITING_FOR_PRIMARY | El dispositivo secundario está listo pero el primario no. Este estado puede aparecer si ha solicitado un dispositivo redundante. |
WAITING_FOR_SECONDARY | El dispositivo primario 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 utilizando la API Delete Virtual Devices, el dispositivo pasa por 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. |