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 API para obter instruções sobre como chamar o OAuth API para validar e autenticar suas credenciais.

Etapa 2: Obtenha tipos de dispositivo e conta

Ligue para Get Device Types 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 softwarepackageCode (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 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 .

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

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. Você receberá um fileUuidna resposta. Você pode inserir o valor no day0TextFileIdcampo 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 . 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 . Você receberá um fileId que pode ser usado para criar um dispositivo Juniper SD-WAN.

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. 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	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

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	<license_key>		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 vendorConfig	Obrigatório	Tipo	Exemplo	Valores possíveis	Descrição
ID local	Sim	corda	SDWAN-Branch@Versa.com		Endereço de e-mail da filial.
ID remoto	Sim	corda	Controller-01-staging@Versa.com		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 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 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

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

	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 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 do 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, o dispositivo transita por vários estados dentro da infraestrutura Equinix. Esses estados podem ser monitorados usando o atributo de resposta "status" do APIObter dispositivo virtual (uuuid). 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.

Quando um usuário final exclui um dispositivo usando o APIExcluir dispositivos virtuais, 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.