# Criar um dispositivo SDWAN ![](https://docs.equinix.com/pt-BR/assets/images/LaunchSDWANDevice-4b2ded8e9446a178320c2beefdef8bdd.png) ## Pré-requisitos[​](#pré-requisitos "Link direto para Pré-requisitos") Autenticar - Envie suas credenciais de usuário, ID do cliente e segredo do cliente para autenticação OAuth2. Consulte [Autenticação API](https://docs.equinix.com/pt-BR/equinix-api/api-authentication.md) para obter instruções sobre como chamar o OAuth API para validar e autenticar suas credenciais. ## Etapa 2: Obtenha tipos de dispositivo e conta[​](#etapa-2-obtenha-tipos-de-dispositivo-e-conta "Link direto para Etapa 2: Obtenha tipos de dispositivo e conta") Ligue [para Get Device Types](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/availability-and-metros/getvirtualdevicetypes) API para encontrar os dispositivos SD-WAN que você pode iniciar na plataforma NE. Você aprenderá sobre mercados (`metroCode`) onde esses dispositivos estão disponíveis, o número disponível de núcleos (), os pacotes de software`packageCode` (`core` 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. Para verificar o número da sua conta (ou `accountReferenceId`) e o status no mercado estratégico onde você quer um dispositivo virtual, ligue para [Get accounts](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/availability-and-metros/getmetros) API. Por motivos de cobrança, você deve ter uma conta no mercado estratégico onde deseja um dispositivo virtual, no estado Ativo ou Pendente. Para saber como criar uma conta, acesse [Gestão de Contas de Cobrança](https://docs.equinix.com/en-us/Content/Interconnection/NE/user-guide/NE-billing-account-creation.htm) . Se você for um **revendedor** tentando criar um dispositivo para seu cliente, você deve garantir que as contas do cliente e suas contas (do revendedor) estejam no status Ativo ou Pendente. Sua conta será cobrada, no entanto, você deve enviar o número da conta do cliente para o POST API para criar um dispositivo SD-WAN para seu cliente. Você pode ignorar esta etapa se já souber o número da sua conta (ou `accountReferenceId`) e o status. ## Etapa 3: Configure uma licença[​](#etapa-3-configure-uma-licença "Link direto para Etapa 3: Configure 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, faça o seguinte: * Gere um arquivo bootstrap na plataforma Cisco vManage. * Para criar um C8000V-SDWAN, carregue o arquivo bootstrap da Cisco chamando [Upload File](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/availability-and-metros/uploadfile). Você receberá um `fileUuid`na resposta. Você pode inserir o valor no `day0TextFileId`campo de Criar payload para criar um dispositivo virtual C8000V-SDWAN. Para configurar uma licença para um dispositivo Prisma, faça o seguinte: * Gere uma chave de licença (chave ION) e um segredo de licença (chave secreta) no Prisma Orchestrator. * Insira a chave de licença (chave ION) e o segredo (chave secreta) ao chamar Equinix Create device API para criar um dispositivo Prisma 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 `licenseToken` campo. Para configurar um arquivo de licença para um dispositivo Fortinet SD-WAN, faça o seguinte: * Gere um arquivo de licença no portal Fortinet. * Faça o upload do arquivo de licença no portal do Equinix chamando [Arquivo de licença](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/availability-and-metros/uploadlicense) . Você receberá um `fileId` que pode ser usado para criar um dispositivo SD-WAN virtual. Para configurar um dispositivo Versa, crie um modelo de dispositivo vNF no director Versa e anote o número de série. 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 um SD-WAN Juniper, faça o seguinte: * Gere um arquivo de licença no portal Juniper . * Faça o upload do arquivo de licença no portal do Equinix chamando [Arquivo de licença](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/availability-and-metros/uploadlicense) . Você receberá um `fileId` que pode ser usado para criar um dispositivo Juniper SD-WAN. ## Etapa 4: Parâmetros específicos do fornecedor[​](#etapa-4-parâmetros-específicos-do-fornecedor "Link direto para 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 da definição POST API na [Etapa 5](#step-5-create-sd-wan-devices). 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-sd-wan "Link direto para Cisco SD-WAN") | **Cisco vendorConfig** | **Obrigatório** | **Tipo** | **Exemplo** | **Valores possíveis** | **Descrição** | | ---------------------- | --------------- | -------- | ----------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ID do site | Sim | corda | 12345 | | ID do local. Obrigatório para dispositivos Cisco SD-WAN. Um siteId é um local físico específico dentro da rede de sobreposição da Viptela, como uma filial ou um campus. | | SystemIpAddress | Sim | corda | 192.168.1.5 | | Endereço IP do sistema. Obrigatório para dispositivos Cisco SD-WAN. Cada roteador vEdge e controlador vSmart recebe um endereço IP do sistema. Ele deve estar em notação decimal pontilhada de quatro partes, assim como o endereço IPv4. | | nome de host | Condicional | corda | SR-01 | | nome de host. Obrigatório para C8000V-SDWAN. | ### PRISMA-SDWAN da Palo Alto Networks[​](#prisma-sdwan-da-palo-alto-networks "Link direto para PRISMA-SDWAN da Palo Alto Networks") | **Parâmetros de venda da Palo Alto Networks** | **Obrigatório** | **Tipo** | **Exemplo** | **Valores possíveis** | **Descrição** | | --------------------------------------------- | --------------- | -------- | ------------------------------------ | --------------------- | ---------------------------------------------------------------------------------------------- | | Chave de licença (chave ION) | Sim | corda | `` | | Chave de licença (chave ION). Obrigatório para dispositivos da Palo Alto Networks. | | LicenseSecret (chave secreta) | Sim | corda | ec68e425-f973-452e-a866-76be5844d0ba | | Chave secreta da licença (chave secreta). Obrigatório para dispositivos da Palo Alto Networks. | ### Versa VERSA\_SDWAN[​](#versa-versa_sdwan "Link direto para Versa VERSA_SDWAN") | **Versa vendorConfig** | **Obrigatório** | **Tipo** | **Exemplo** | **Valores possíveis** | **Descrição** | | ---------------------- | --------------- | -------- | --------------------------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ID local | Sim | corda | | | Endereço de e-mail da filial. | | ID remoto | Sim | corda | | | Endereço de e-mail do controlador. | | Número de série | Sim | corda | 12345 | | O cliente seleciona um número de série ao configurar o modelo de dispositivo no Versa Director. O número de série do dispositivo pós-staging do Versa no director Versa deve corresponder a essa entrada. | | controlador1 | Sim | corda | 54.219.248.29 | | Endereço IP do controlador SD-WAN1. | | controlador2 | Sim | corda | 54.177.220.115 | | Endereço IP do controlador SD-WAN2. | ### FortiGate FG-SDWAN \*[​](#fortigate-fg-sdwan- "Link direto para FortiGate FG-SDWAN *") | **FortiGate vendorConfig** | **Obrigatório** | **Tipo** | **Exemplo** | **Valores possíveis** | **Descrição** | | -------------------------- | --------------- | -------- | ----------- | --------------------- | ----------------------------------------------------------------------------------------------- | | Admin Password | Sim | corda | Esta passa9 | | Senha. A senha deve ter pelo menos 6 caracteres e deve incluir uma letra maiúscula e um número. | | controlador1 | Sim | corda | 1.1.1.1 | | Endereço IP do sistema. Obrigatório para dispositivos FortiGate SD-WAN. | \*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-velocloud-sdwan "Link direto para Arista VELOCLOUD-SDWAN") | **ARISTA vendorConfig** | **Obrigatório** | **Tipo** | **Exemplo** | **Valores possíveis** | **Descrição** | | ----------------------- | --------------- | -------- | ---------------------- | --------------------- | ----------------------------------------------------------------------------------------------------------------- | | ActivationKey | Sim | corda | GJUK-JM2X-59BJ-AMOSTRA | | Chave de ativação. Disponível no Portal de Orquestração do VeloCloud. | | ControladorFqdn | Sim | corda | demo.velocloud.net | | Gateway VeloCloud SD-WAN. Na lista de ACLs do dispositivo, forneça os endereços IP associados ao controladorFqdn. | | RootPassword | Não | corda | Senha de teste! | | Senha CLI para o dispositivo. | ### HPE ARUBA EDGECONNECT-SDWAN[​](#hpe-aruba-edgeconnect-sdwan "Link direto para HPE ARUBA EDGECONNECT-SDWAN") | **Aruba vendorConfig** | **Obrigatório** | **Tipo** | **Exemplo** | **Valores possíveis** | **Descrição** | | ---------------------- | --------------- | -------- | ---------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nome da conta | Sim | corda | Nome da conta | | O nome da conta. | | nome de host | Sim | corda | meuhostname1 | | Nome do host para identificação. Isso é incluído como FQDN e garante que o dispositivo seja acessível a partir das fontes aprovadas. Apenas a-z, A-Z, 0-9 e hífen(-) são permitidos. Ele deve começar com uma letra e terminar com uma letra ou dígito. O comprimento deve ter entre 2-30 caracteres. Exceções - FTDv 2-14; Aruba 2-24. | | Chave da conta | Sim | corda | Chave da conta | | A chave da conta. | | Tag de aplicação | Não | corda | Tag de aplicação | | A etiqueta do aparelho. | ## Passo 5: Crie dispositivos SD-WAN[​](#passo-5-crie-dispositivos-sd-wan "Link direto para Passo 5: Crie dispositivos SD-WAN") | | POST /ne/v1/devices | | ---------------------- | ------------------------------- | | Método | `POST` | | URL ou ponto final | `/ne/v1/devices` | | Cabeçalhos | `Authorization`, `Content-Type` | | Parâmetros de consulta | `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 `vendorConfig` os parâmetros 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 seu cliente, certifique-se de que os mercados primário e secundário estejam no mesmo país. Além disso, os números da conta primária e secundária devem ser iguais. A conta do revendedor será cobrada, no entanto, este API aceita o número da conta do cliente para criar dispositivos para o cliente. As restrições acima são necessárias, pois cada cliente está associado à conta de cobrança de um revendedor. Se você não tiver todas as informações necessárias, ainda poderá salvar as informações como rascunho. Você deve 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. Ligue [para Obter Termos do Pedido](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/availability-and-metros/getorderterms) para revisar os detalhes. ## Solicitação de amostra[​](#solicitação-de-amostra "Link direto para 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 '  -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 do API](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/virtual-device/createvirtualdevice) . ## Resposta de amostra[​](#resposta-de-amostra "Link direto para 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[​](#status-do-dispositivo "Link direto para Status do dispositivo") Quando um dispositivo SD-WAN é criado, o dispositivo transita por vários estados dentro da infraestrutura Equinix. Esses estados podem ser monitorados usando o atributo de resposta "status" do API[Obter dispositivo virtual (uuuid)](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid). Quando o dispositivo estiver provisionado e a licença for aplicada, você poderá criar conexões com provedores de serviços de cloud. | **estados do dispositivo virtual** | **Descrição** | | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `INITIALIZING` | A Equinix está no processo de reservar recursos e criar o dispositivo. | | `PENDING_ACCOUNT` | A conta do cliente não foi aprovada. A criação do dispositivo continuará assim que a conta for aprovada. | | `PROVISIONING` | O dispositivo está inicializando. | | `PENDING_ORDER` | Este status só se aplica a pedidos recebidos para NE da Siebel. Os clientes precisam fazer login no portal Network Edge e enviar o pedido pendente. | | `PENDING_SIGNATURE` | O cliente ainda não aceitou os termos do Network Edge . | | `CANCEL_ORDER` | O pedido de Siebel para NE foi cancelado. Este status só se aplica a pedidos que chegam à Network Edge pela Siebel. | | `WAITING_FOR_PRIMARY` | O dispositivo secundário está pronto, mas o primário não está. Este estado pode aparecer se você solicitou um dispositivo redundante. | | `WAITING_FOR_SECONDARY` | O dispositivo primário está pronto, mas o secundário não está. Este estado pode aparecer se você solicitou um dispositivo redundante. | | `FAILED` | A criação do dispositivo falhou. | | `PROVISIONED` | O dispositivo está pronto. | | `DEPROVISIONING` | A Equinix aceitou a solicitação do cliente para excluir o dispositivo virtual. | | `DEPROVISIONED` | O dispositivo foi desprovisionado/excluído. | ![](https://docs.equinix.com/pt-BR/assets/images/LaunchSDWANDeviceStatus-ec85c8073706c572830c9b87116993e6.png) Quando um usuário final exclui um dispositivo usando o API[Excluir dispositivos virtuais](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/virtual-device/deletevirtualdevicebyuuid), o dispositivo passa pelos seguintes estados dentro da infraestrutura Equinix. | status | Descrição | | ---------------- | ------------------------------------------------------------------------------ | | `DEPROVISIONING` | A Equinix aceitou a solicitação do cliente para excluir o dispositivo virtual. | | `DEPROVISIONED` | O dispositivo foi desprovisionado/excluído. |