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: Obter 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 Metrôs (metroCode) onde esses dispositivos estão disponíveis, o número disponível de núcleos (core), os pacotes de software (packageCode e version) e todas as opções possíveis de licenciamento e throughput.

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

Verifique o número da sua conta (ou accountReferenceId) e o status no metrô onde você deseja um dispositivo virtual ligando para Obter contas (metro) API. Por motivos de cobrança, você deve ter uma conta no metrô onde deseja um dispositivo virtual, no estado Ativo ou Pendente. Para saber como criar uma conta, vá para Gerenciamento de contas de faturamento .

Se você for um revendedor tentando criar um dispositivo para seu cliente, deverá garantir que as contas do cliente e de sua (do revendedor) estejam no status Ativo ou Pendente. Sua conta será faturada, 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: 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, 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 fileUuid na resposta. Você pode inserir o valor no day0TextFileIdcampo Criar carga útil 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 Secret) 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.
• Carregue o arquivo de licença no portal do Equinix chamando Arquivo de Licença Pós . 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 .
• Carregue o arquivo de licença no portal do Equinix chamando Arquivo de Licença Pós . 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 PÓS-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

Parâmetros Cisco vendorConfig	Obrigatório	Tipo	Exemplo	Valores possíveis	Descrição
ID do site	Sim	corda	12345		ID do site. Obrigatório para dispositivos Cisco SD-WAN. Um ID do site é 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 recebem um endereço IP do sistema. Ele deve estar em notação pontilhada decimal de quatro partes, assim como o endereço IPv4.
nome do host	Condicional	corda	SR-01		nome do host. Obrigatório para C8000V-SDWAN.

Palo Alto Networks PRISMA-SDWAN

Palo Alto Networks	Obrigatório	Tipo	Exemplo	Valores possíveis	Descrição
Licensekey (tecla 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		Segredo de licença (Chave secreta). Obrigatório para dispositivos da Palo Alto Networks.

Versa VERSA_SDWAN

Parâmetros do 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 de pós-preparação 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
AdminPassword (Senha de administrador)	Sim	corda	Esta passada9		Senha. Essa 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

Parâmetros Arista vendorConfig	Obrigatório	Tipo	Exemplo	Valores possíveis	Descrição
ActivationKey	Sim	corda	AMOSTRA GJUK-JM2X-59BJ		Chave de ativação. Disponível no VeloCloud Orchestration Portal.
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.

SDWAN HPE ARUBA EDGECONNECT

Parâmetros Aruba vendorConfig	Obrigatório	Tipo	Exemplo	Valores possíveis	Descrição
Nome da conta	Sim	corda	Nome da conta		O nome da conta.
nome do 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. Somente a-z, A-Z, 0-9 e hífen(-) são permitidos. 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 de conta	Sim	corda	Chave de conta		A chave da conta.
Aplique a etiqueta	Não	corda	Aplique a etiqueta		A etiqueta do aparelho.

Etapa 5: Crie dispositivos SD-WAN

	POST /ne/v1/devices
Método	POST
URL ou ponto final	/ne/v1/devices
Cabeçalhos	Authorization, Em inglês Content-Type
Parâmetros de consulta	draft, Em inglês 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 Metrôs primário e secundário estejam no mesmo país. Além disso, os números da conta principal e secundária devem ser os mesmos. 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 faturamento 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

Amostra 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 do Equinix. Esses estados podem ser monitorados usando o atributo de resposta "status" do APIGet Virtual Device (uuid). Depois que seu dispositivo for provisionado e a licença for aplicada, você poderá criar conexões com provedores de serviços de nuvem.

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	Esse status se aplica somente a pedidos que chegam ao NE da Siebel. Os clientes precisam fazer login no portal do 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. Esse status se aplica somente a pedidos que chegam à Network Edge da Siebel.
WAITING_FOR_PRIMARY	O dispositivo secundário está pronto, mas o primário não. Esse estado pode aparecer se você tiver solicitado um dispositivo redundante.
WAITING_FOR_SECONDARY	O dispositivo primário está pronto, mas o secundário não. Esse estado pode aparecer se você tiver solicitado 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 a APIExcluir dispositivos virtuais, o dispositivo passa pelos seguintes estados na infraestrutura do 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.