Criar um dispositivo SDWAN

Pré-requisitos

Autenticar - Envie suas credenciais de usuário, ID do Cliente e Segredo do Cliente para autenticação OAuth2. Consulte Autenticação de API para obter instruções sobre como chamar a API OAuth para validar e autenticar suas credenciais.

Etapa 2: Obtenha os tipos de dispositivos e a conta

Chame Obter Tipos de Dispositivo API para encontrar os dispositivos SD-WAN que você pode implementar na plataforma NE. Você aprenderá sobre as regiões metropolitanas (metroCode) onde esses dispositivos estão disponíveis, o número de núcleos disponíveis (core), os pacotes de software (packageCode e version) e todas as opções possíveis de licenciamento e taxa de transferência.

Você pode pular esta etapa se já souber qual dispositivo deseja.

Verifique o número da sua conta (ou accountReferenceId) e o status na rede metropolitana onde você deseja um dispositivo virtual, chamando a API Get Accounts {metro}. Por motivos de faturamento, você precisa ter uma conta na rede metropolitana onde deseja um dispositivo virtual, seja no estado Ativo ou Pendente. Para saber como criar uma conta, acesse Gerenciamento de Contas de Faturamento.

Se você for um revendedor tentando criar um dispositivo para o seu cliente, certifique-se de que as contas do cliente e a sua (do revendedor) estejam ambas com o status Ativo ou Pendente. Sua conta será cobrada, porém, você precisa enviar o número da conta do cliente para a API POST para criar um dispositivo SD-WAN para ele.

Você pode pular esta etapa se já souber o número da sua conta (ou accountReferenceId) e status.

Etapa 3: Configurar uma licença

Por enquanto, a opção de licenciamento "traga sua própria licença" (BYOL) é a única disponível para dispositivos SD-WAN. O processo para BYOL (Bring Your Own Load - Traga Sua Própria Ferramenta) é específico para cada fornecedor.

Para configurar uma licença para dispositivos Cisco SD-WAN, você deve fazer o seguinte:

• Gere um arquivo bootstrap na plataforma Cisco vManage.
• Para criar um C8000V-SDWAN, carregue o arquivo de inicialização da Cisco chamando Upload File. Você receberá um fileUuid na resposta. Você pode inserir o valor no campo day0TextFileId do payload de criação para criar um dispositivo C8000V-SDWAN virtual.

Para configurar uma licença para um dispositivo CloudGenix, você deve fazer o seguinte:

• Gere uma chave de licença (chave ION) e um segredo de licença (chave secreta) na plataforma CloudGenix.
• Insira a chave de licença (chave ION) e a chave secreta (chave secreta) ao chamar o comando equinix create. API do dispositivo para criar um dispositivo CloudGenix SD-WAN.

A licença não é obrigatória para dispositivos Fortinet no momento da criação do dispositivo. Se você tiver um token, Insira-o no campo licenseToken. Para configurar um arquivo de licença para um dispositivo SD-WAN da Fortinet, faça o seguinte: seguindo:

• Gere um arquivo de licença no portal Fortinet.
• Faça o upload do arquivo de licença no portal da Equinix chamando Post License File. Você receberá um fileId que poderá usar para criar um dispositivo SD-WAN virtual.

Para configurar um dispositivo Versa, crie um modelo de dispositivo vNF no Versa Director e anote o número de série. número.

Você não precisa de um arquivo de licença para configurar um dispositivo Aruba na plataforma Network Edge .

Para carregar uma licença para uma Juniper SD- WAN, você deve fazer o seguinte:

• Gere um arquivo de licença no portal Juniper .
• Faça o upload do arquivo de licença no portal da Equinix chamando Post License File. Você receberá um fileId que poderá usar para criar um dispositivo SD-WAN da Juniper.

Etapa 4: Parâmetros específicos do fornecedor

Cada fornecedor de SD-WAN requer seu próprio conjunto de parâmetros, além dos parâmetros comuns listados como parte de Definição da API POST na Etapa 5. Verifique os parâmetros. do seu fornecedor e passe os parâmetros no objeto vendorConfig{} ao criar um novo dispositivo na Etapa 5.

Cisco SD-WAN

Cisco vendorConfig{ } parameters	Mandatory	Type	Example	Possible Values	Description
siteId	Yes	string	12345		Site Id. Mandatory for Cisco SD-WAN devices. A siteId is a particular physical location within the Viptela overlay network, such as a branch office, or a campus.
systemIpAddress	Yes	string	192.168.1.5		System IP address. Mandatory for Cisco SD-WAN devices. Each vEdge router and vSmart controller is assigned a system IP address. It should be in decimal four-part dotted notation, just like IPv4 address.
hostname	Conditional	string	SR-01		hostname. Mandatory for C8000V-SDWAN.

CloudGenix PRISMA-SDWAN

CloudGenix vendorConfig{ } parameters	Mandatory	Type	Example	Possible Values	Description
licenseKey (ION key)	Yes	string	<license_key>		License key (ION key). Mandatory for CloudGenix devices.
licenseSecret (Secret key)	Yes	string	ec68e425-f973-452e-a866-76be5844d0ba		License secret (Secret key). Mandatory for CloudGenix devices.

Versa VERSA_SDWAN

Versa vendorConfig{ } parameters	Mandatory	Type	Example	Possible Values	Description
localId	Yes	string	SDWAN-Branch@Versa.com		Email address of the branch location.
remoteId	Yes	string	Controller-01-staging@Versa.com		Email address of the controller side.
serialNumber	Yes	string	12345		The customer selects a serial number when setting up the device template on Versa director. Versa post-staging device serial number on Versa director should match this input.
controller1	Yes	string	54.219.248.29		Ip address of the SD-WAN controller1.
controller2	Yes	string	54.177.220.115		Ip address of the SD-WAN controller2.

FortiGate FG-SDWAN *

FortiGate vendorConfig{ } parameters	Mandatory	Type	Example	Possible Values	Description
adminPassword	Yes	string	ThisPassword9		Password. This password should be at least 6 characters long and must include an uppercase letter and a number.
controller1	Yes	string	1.1.1.1		System IP address. Mandatory for FortiGate SD-WAN devices.

*Os dispositivos SD-WAN FortiGate também precisam de um nome de host, mas ele não faz parte do objeto vendorConfig, sendo apenas passado como um parâmetro juntamente com outros como deviceTypeCode, accountNumber, etc.

Arista VELOCLOUD-SDWAN

Arista vendorConfig{ } parameters	Mandatory	Type	Example	Possible Values	Description
activationKey	Yes	string	GJUK-JM2X-59BJ-SAMPLE		Activation key. Available on the VeloCloud Orchestration Portal.
controllerFqdn	Yes	string	demo.velocloud.net		VeloCloud SD-WAN Gateway. In the list of ACLs for the device, please provide the IP addresses associated with the controllerFqdn.
rootPassword	No	string	TestPassword!		CLI password for the device.

Aruba EDGECONNECT-SDWAN

Aruba vendorConfig{ } parameters	Mandatory	Type	Example	Possible Values	Description
accountName	Yes	string	accountName		The name of the account.
hostname	Yes	string	myhostname1		Host name for identification. This gets included as FQDN and ensures the device is reachable from the approved sources. Only a-z, A-Z, 0-9, and hyphen(-) are allowed. It should start with a letter and end with a letter or digit. The length should be between 2-30 characters. Exceptions - FTDv 2-14; Aruba 2-24.
accountKey	Yes	string	accountKey		The account key.
applianceTag	No	string	applianceTag		The appliance tag.

Etapa 5: Criar dispositivos SD- WAN

	POST /ne/v1/devices
Method	POST
URL or End Point	/ne/v1/devices
Headers	Authorization, Content-Type
Query Parameters	draft, draftUuid

Se você deseja criar um dispositivo SD-WAN redundante com dois dispositivos, primário e secundário, faça o seguinte: seguindo:

1. Defina os parâmetros vendorConfig do objeto secundário opcional.

   • forneça dois licenseFileIds para um Cisco SD-WAN na carga útil do corpo da solicitação
   • Fornecer duas chaves de licença (chaves ION) e segredos de licença (chaves secretas) para um CloudGenix redundante. dispositivo no corpo da solicitação
   • Fornecer duas chaves de ativação para um dispositivo Arista VeloCloud SD-WAN Edge redundante.

2. Você pode ter um modelo de ACL, número de conta, largura de banda adicional, metroCode e notificações diferentes para seu dispositivo secundário.

3. Se você for um revendedor tentando criar um dispositivo redundante para o seu cliente, certifique-se de que as áreas metropolitanas primária e secundária estejam no mesmo país. Além disso, os números de conta primária e secundária devem ser os mesmos. A conta do revendedor será faturada, porém, esta API aceita o número da conta do cliente para criar dispositivos para ele. As restrições acima são necessárias, pois cada cliente está associado à conta de faturamento de um revendedor.

Se você não tiver todas as informações necessárias, ainda poderá salvar as informações como rascunho. Você precisa fornecer um deviceTypeCode, um accountNumber/accountReferenceId e um metroCode para salvar. um rascunho.

observação

Ao criar um dispositivo virtual, você aceita os Termos do Pedido. Chame Obter Termos do Pedido para revisar os detalhes.

Solicitação de amostra

Um exemplo de solicitação curl para criar um 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 obter uma lista completa de parâmetros e opções, consulte a Referência da API.

Resposta de amostra

Exemplo de resposta para um único dispositivo 202: Solicitação aceita.

{
    "uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec"
}

Exemplo de resposta para um dispositivo redundante 202: Solicitação aceita.

{
    "uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec",
    "secondaryUuid": "de5cf79b-3d16-4ccd-841b-3b68ecda2142"
}

Se você receber “Acesso negado”, entre em contato com o Equinix Service Desk local para obter acesso ao Portal.

Status do dispositivo

Quando um dispositivo SD-WAN é criado, ele passa por vários estados dentro da infraestrutura Equinix. Esses estados podem ser monitorados usando o atributo de resposta "status" da API Get Virtual Device {uuid}. Após o provisionamento do dispositivo e a aplicação da licença, você poderá criar conexões com provedores de serviços em nuvem.

Virtual device states	Description
INITIALIZING	Equinix is in the process of reserving resources and creating the device.
PENDING_ACCOUNT	Customer's account is not approved. The device creation will continue once the account gets approved.
PROVISIONING	The device is booting.
PENDING_ORDER	This status only applies to orders coming to NE from Siebel. Customers need to log in to the Network Edge portal and submit the pending order.
PENDING_SIGNATURE	The customer has not yet accepted Network Edge terms.
CANCEL_ORDER	The order from Siebel to NE is canceled. This status only applies to orders coming to Network Edge from Siebel.
WAITING_FOR_PRIMARY	The secondary device is ready but the primary is not. This state may appear if you have requested a redundant device.
WAITING_FOR_SECONDARY	The primary device is ready but the secondary is not. This state may appear if you have requested a redundant device.
FAILED	The device creation failed.
PROVISIONED	The device is ready.
DEPROVISIONING	Equinix accepted the customer's request to delete the virtual device.
DEPROVISIONED	The device is de-provisioned/deleted.

Quando um usuário final exclui um dispositivo usando a API Excluir Dispositivos Virtuais, o dispositivo passa pelos seguintes estados no Equinix. infraestrutura.

status	Description
DEPROVISIONING	Equinix accepted the customer's request to delete the virtual device.
DEPROVISIONED	The device is de-provisioned/deleted.