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: Obtenga tipos de dispositivos y cuenta
Llame a Obtener tipos de dispositivo
API para encontrar los dispositivos SD-WAN que puede iniciar en la plataforma NE. Aprenderá acerca de Metros (metroCode) donde estos dispositivos están disponibles, el número de núcleos disponibles (core), los paquetes de software (packageCode y version), y todas las posibles opciones 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 el metro donde desea un dispositivo virtual llamando a Obtener cuentas {METRO} API. Por razones de facturación, debes tener una cuenta en el metro donde deseas un dispositivo virtual, ya sea en estado Activo o Pendiente. Para aprender a crear una cuenta, vaya a Administració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: 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, haga lo siguiente:
- Genere un archivo de arranque en la plataforma Cisco vManage.
- Para crear un C8000V-SDWAN, cargue el archivo bootstrap de Cisco llamando a Upload File. Obtendrás un
fileUuiden 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, 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 tiene un token,
introdúzcalo en el licenseToken campo. Para configurar un archivo de licencia para un dispositivo Fortinet SD-WAN, haga lo
siguiente:
- Genere un archivo de licencia en el portal de Fortinet.
- Cargue el archivo de licencia en el portal de Equinix llamando a Archivo de licencia de publicación . Obtendrá un
fileIddispositivo que puede usar 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 a Archivo de licencia de publicación . Obtendrás un
fileIddispositivo que puedes usar para crear un dispositivo Juniper SD-WAN.
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 Step 5.
Cisco SD-WAN
| Cisco vendorConfig{ } Parámetros | Obligatorio | Tipo | Ejemplo | Valores posibles | Descripción |
|---|---|---|---|---|---|
| SiteID | Sí | cadena | 12345 | ID del sitio. Obligatorio para los dispositivos Cisco SD-WAN. 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 Cisco SD-WAN. 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 punteada, 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
| Palo Alto Networks vendorConfig{ } Parámetros | Obligatorio | Tipo | 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 | 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 de pospuesta 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 | Tipo | 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 | Tipo | Ejemplo | Valores posibles | Descripción |
|---|---|---|---|---|---|
| ActivaciónKey | Sí | cadena | GJUK-JM2X-59BJ-SAMPLE | Clave de activación. Disponible en el Portal de Orquestación de VeloCloud. | |
| ControllerFqdn | Sí | cadena | demo.velocloud.net | Puerta de enlace VeloCloud SD-WAN. En la lista de ACL para el dispositivo, por favor proporcione las direcciones IP asociadas con el controlador Fqdn. | |
| RootPassword | No | cadena | ¡TestPassword! | Contraseña CLI para el dispositivo. |
HPE ARUBA EDGECONNECT-SDWAN
| Aruba vendorConfig{ } Parámetros | 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 el dispositivo sea accesible 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: Crea dispositivos SD-WAN
| PUBLICAR /ne/v1/devices | |
|---|---|
| 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
vendorConfigpará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 teclas de activación 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.
Si no tiene toda la información necesaria, aún puede guardar la información como un borrador. Debe proporcionar un deviceTypeCode, un countNumber/countReferenceId 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
Respuesta de muestra para un solo dispositivo 202: Solicitud aceptada.
{
"uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec"
}
Respuesta de muestra 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 pueden ser monitoreados usando el atributo de respuesta "status" del APIGet Virtual Device {uuid}. Una vez que se aprovisiona el dispositivo y se aplica la licencia, puede crear conexiones con 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á una vez que se apruebe la cuenta. |
PROVISIONING | El dispositivo está arrancando. |
PENDING_ORDER | Este 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_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 llegan a Network Edge desde Siebel. |
WAITING_FOR_PRIMARY | El dispositivo secundario está listo pero el primario no lo está. Este estado puede aparecer si ha solicitado un dispositivo redundante. |
WAITING_FOR_SECONDARY | El dispositivo primario está listo pero el secundario no lo está. 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. |