# Dispositivo de cluster de inicialização ![](https://docs.equinix.com/pt-BR/assets/images/LaunchClusterDevice-8cbbed9f9cbc2854ae5a7b777f1f7935.png) ## Pré-requisitos[​](#pré-requisitos "Link direto para Pré-requisitos") 1. 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. 2. Ligue [para Get Device Types](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/availability-and-metros/getvirtualdevicetypes) para descobrir qual dispositivo de cluster (por exemplo, roteador ou firewall) você deseja iniciar na plataforma NE. Você aprenderá sobre as regiões metropolitanas onde os dispositivos virtuais estão disponíveis, os fornecedores de dispositivos, o número de núcleos disponíveis e os pacotes de software e suas versões. Selecione `deviceTypeCode`, `metroCode`, `core`, , `packageCode`e `version`. 3. Ligue [para Get Allowed Interfaces](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/availability-and-metros/getallowedinterfaces) para descobrir o número permitido de interfaces para o núcleo selecionado. Você pode selecionar qualquer interface de dispositivo disponível como sshInterfaceId. Caso contrário, a Equinix escolherá a primeira interface disponível. 4. Ligue [para Obter contas (mercado estratégico)](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/availability-and-metros/getaccountswithstatus) para verificar seu `account number` (ou `acountReferenceId`) e o status no mercado estratégico onde você deseja um dispositivo virtual. Por motivos de cobrança, você deve ter uma conta no mercado estratégico onde deseja um dispositivo virtual, no estado Ativo ou Pendente. Se você não tiver uma[conta](https://docs.equinix.com/pt-BR/network-edge/billing/ne-billing-account-creation.md). 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 para seu cliente. ## Opções de licenciamento[​](#opções-de-licenciamento "Link direto para Opções de licenciamento") No momento, oferecemos apenas a opção BYOL (traga sua própria licença) para clusters. * **Cluster Juniper** - Não é necessário carregar arquivos de licença para um Cluster Juniper. No entanto, você pode carregar dois arquivos de licença. Para carregar dois arquivos de licença, ligue [para Pós-arquivo de licença](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/availability-and-metros/uploadlicense) duas vezes. Você receberá o IDS do arquivo de licença na resposta que pode ser usada para criar um cluster. * **Cluster Palo Alto** - Você deve carregar dois tokens de licença do fornecedor. Os tokens de licença podem ser iguais ou diferentes. * **Cluster Fortinet** - Você não precisa inserir um token ou licença. Para carregar arquivos de licença, você deve carregar dois arquivos de licença diferentes. Para carregar dois arquivos de licença, ligue [para Pós-arquivo de licença](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/availability-and-metros/uploadlicense) duas vezes. Você receberá o IDS do arquivo de licença na resposta que pode ser usada para criar um cluster. * **Cluster de borda Arista VeloCloud SD-WAN** Você não precisa fazer upload de um arquivo de licença ou token. No entanto, você deve fornecer sua chave de ativação. Se a licença não for registrada após a criação do dispositivo, você deverá fazer login no dispositivo e carregar a licença. Em seguida, chame [Atualizar dispositivo virtual](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/virtual-device/updatevirtualdevicebyuuid) com o valor de status `PROVISIONED`. ## Criar dispositivo de cluster[​](#criar-dispositivo-de-cluster "Link direto para Criar dispositivo de cluster") | | POST /ne/v1/devices | | ---------------------- | ------------------------------------- | | Método | `POST` | | URL ou ponto final | `/ne/v1/devices` | | Cabeçalhos | `Authorization` token, `Content-Type` | | Parâmetros de consulta | `draft`, `draftUuid` | Nota: 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. Para salvar um rascunho de dispositivo, você deve fornecer um `deviceTypeCode`, um `accountNumber` ou `accountReferenceId` e um `metroCode`. Um exemplo de solicitar curl para criar um cluster vSRX: ``` curl -X POST "https://api.equinix.com/ne/v1/devices?draft=false" -H "content-type: application/json" -H "Authorization: Bearer " -d ' {     "deviceTypeCode": "VSRX",     "clusterDetails": {         "clusterName": "sroy-juniper",         "clusterNodeDetails": {             "node0": {                 "vendorConfig": {                     "hostname": "sr012"                 },                 "licenseFileId": "1274fe9f-511c-436f-bc0c-14c876ec55da"             },             "node1": {                 "vendorConfig": {                     "hostname": "sr123"                 },                 "licenseFileId": "65a9be3f-57fb-4c4d-a15b-40950951bc13"             }         }     },     "metroCode": "SV",     "termLength": "1",     "licenseMode": "BYOL",     "packageCode": "STD",     "virtualDeviceName": "Test-device-001-SROY",     "notifications": [         "test@equinix.com"     ],     "hostname": "sr012",     "aclDetails": [        {          "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",          "interfaceType": "WAN"        }     ],     "accountNumber": "201148",     "version": "18.4R3-S2",     "interfaceCount": 8,     "agreeOrderTerms": true,     "deviceManagementType": "SELF-CONFIGURED",     "core": 5,     "userPublicKey": {         "username": "sroy",         "keyName": "keyLlhzL"     },     "additionalBandwidth": "100" } ' ``` Exemplo de solicitação curl para criar um cluster Arista Velocloud SDWAN: ``` curl -X POST "https://api.equinix.com/ne/v1/devices?draft=false" -H "content-type: application/json" -H "Authorization: Bearer " -d ' {     "metroCode": "SY",     "deviceTypeCode": "VELOCLOUD-SDWAN",     "termLength": "1",     "clusterDetails": {         "clusterName": "sroy-velo-cluster",         "vendorConfig": {             "node0": {                 "activationKey": "GJUK-JM2X-59BJ-SAMPLE",                 "controllerFqdn": "demo.velocloud.net",                 "rootPassword": "TestPassword!"             },             "node1": {                 "rootPassword": "TestPassword#"             }         }     },     "licenseMode": "BYOL",     "packageCode": "VeloCloud-4",     "virtualDeviceName": "velo-cluster",     "notifications": [         "test@equinix.com"     ],     "aclDetails": [        {          "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",          "interfaceType": "WAN"        }     ],     "accountNumber": "2393479",     "version": "3.4.2",     "interfaceCount": 8,     "deviceManagementType": "SELF-CONFIGURED",     "agreeOrderTerms": true,     "core": 4,     "userPublicKey": {         "username": "sroy",         "keyName": "key7YFfL"     },     "additionalBandwidth": "200" } ' ``` Um exemplo de solicitar curl para criar um cluster PANW sem acesso à Internet: ``` curl -X POST "https://api.equinix.com/ne/v1/devices?draft=false" -H "content-type: application/json" -H "Authorization: Bearer " -d ' {     "deviceTypeCode": "PA-VM",     "clusterDetails": {         "clusterName": "NEAut-",         "clusterNodeDetails": {             "node0": {             "vendorConfig": {                 "hostname": "PANCluster"             }             },             "node1": {             "vendorConfig": {                 "hostname": "PANCluster"             }             }         }     },     "metroCode": "#(supportedMetro)",     "zoneCode": "Zone1",     "termLength": "1",     "licenseMode": "BYOL",     "packageCode": "VM100",     "virtualDeviceName": "NEAut-",     "notifications": [         "t@t.com"     ],     "version": "10.1.3",     "interfaceCount": 10,     "deviceManagementType": "SELF-CONFIGURED",     "core": 2,     "connectivity": "PRIVATE" } ' ``` 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 202: Solicitação aceita. ``` {     "uuid": "34b7838c-ec82-4166-ac19-efa03b4e34fe",     "deviceIds": {         "node0": "34b7838c-ec82-4166-ac19-efa03b4e34fe",         "node1": "f27f1475-3c7f-447f-b0db-e3bb3af3de16"     },     "clusterId": "27eea9aa-327b-431b-bf62-3cee4d880f2e" } ``` ## Status do dispositivo[​](#status-do-dispositivo "Link direto para Status do dispositivo") Quando um cluster é criado, o cluster autoconfigurado transita por vários estados dentro da infraestrutura Equinix. Esses estados podem ser monitorados usando o `status`atributo de resposta do método[Get Virtual Device (uuid)](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid). Seu cluster deve ser provisionado e sua licença deve ser registrada para que você possa usar esse cluster para se conectar a 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/LaunchClusterDeviceStatus-c01747a2fac38f81e3e43d32810dbc59.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. |