Dispositivo de cluster de inicialização

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.
Chame Obter Tipos de Dispositivo para descobrir qual dispositivo de cluster (por exemplo, roteador ou firewall) você deseja executar na plataforma NE. Você obterá informações sobre as regiões metropolitanas onde os dispositivos virtuais estão disponíveis, os fornecedores dos 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.
Chame Obter Interfaces Permitidas para descobrir o número de interfaces permitidas 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.
Chame Obter Contas {metro} para verificar seu número da conta (ou acountReferenceId) e status na rede metropolitana onde você deseja um dispositivo virtual. Por motivos de faturamento, você precisa ter uma conta na rede metropolitana onde deseja um dispositivo virtual, seja no estado Ativo ou Pendente. Crie uma conta se você ainda não tiver uma.

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 o dispositivo para ele.

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 fazer o upload de arquivos de licença para um cluster Juniper. No entanto, você pode fazer o upload de dois arquivos de licença. Para fazer o upload de dois arquivos de licença, chame Post License File duas vezes. Você receberá os IDs dos arquivos de licença na resposta, que poderão ser usados para criar um cluster.
Cluster Palo Alto - Você deve enviar dois tokens de licença do fornecedor. Os tokens de licença podem ser iguais ou diferentes.
Cluster Fortinet - Não é necessário inserir um token ou licença. Se desejar carregar arquivos de licença, você deve carregar dois arquivos de licença diferentes. Para carregar dois arquivos de licença, chame Post License File duas vezes. Você receberá os IDs dos arquivos de licença na resposta, que poderão ser usados para criar um cluster.
Cluster de borda SD-WAN Arista VeloCloud Você não precisa fazer o upload de um arquivo de licença ou token. No entanto, você deve fornecer sua chave de ativação. Se sua licença não for registrada após a criação do seu dispositivo, você deverá fazer login no dispositivo e fazer o upload da licença. Em seguida, chame Atualizar Dispositivo Virtual com o valor de status PROVISIONED.

Criar dispositivo de cluster

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

Observação: Ao criar um dispositivo virtual, você aceita os Termos do Pedido. Chame Obter Termos do Pedido para revisar os detalhes.

Para salvar um rascunho de dispositivo, você deve fornecer um deviceTypeCode, um accountNumber ou um 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 <token>"
-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 <token>"
-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 <token>"
-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 da API.

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

Quando um cluster é criado, o cluster autoconfigurado transita por vários estados dentro do cluster. Infraestrutura Equinix. Esses estados podem ser monitorados usando o atributo de resposta status do método Obter Dispositivo Virtual {uuid}. Seu cluster deve ser provisionado e sua licença deve ser registrada antes que você possa usar este cluster para se conectar a 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.

Pré-requisitos​

Opções de licenciamento​

Criar dispositivo de cluster​

Resposta de amostra​

Status do dispositivo​

Pré-requisitos

Opções de licenciamento

Criar dispositivo de cluster

Resposta de amostra

Status do dispositivo