Criar um dispositivo

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 detalhes do dispositivo

Chame Get Device Types para descobrir qual dispositivo autoconfigurado (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 disponível de núcleos e os pacotes de software e suas versões. Selecione deviceTypeCode, metroCode, core, packageCodee version.
Chame Get Allowed Interfaces 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.
Ligue para Obter contas (metro) para verificar o número da sua conta (ou accountReferenceId) e o status no metro onde você deseja um dispositivo virtual. Por motivos de cobrança, você deve ter uma conta no metrô onde deseja um dispositivo virtual, no estado Ativo ou Pendente. Crie uma conta se você não tiver uma.

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á cobrada, no entanto, você deve enviar o número da conta do cliente para o API para criar um dispositivo para o cliente.

Etapa 3: Opções de licenciamento

Oferecemos BYOL (Bring Your Own Licensing) como uma opção de licenciamento para a maioria dos dispositivos. Carregue um arquivo de licença ou um código/token/ID, dependendo do que seu fornecedor oferece. Para o Cisco 8000V, você tem a opção de licenciamento de assinatura.

Arista: Não oferecemos suporte ao upload de uma licença para o dispositivo Arista. No entanto, você pode fazer login em seu dispositivo depois que ele for criado para carregar uma licença e aumentar sua taxa de transferência.
A Cisco e a Palo Alto fornecem tokens de licença. Insira o token de licença no licenseTokencampo.
A Juniper fornece arquivos de licença. Para trazer sua própria licença (BYOL) para um dispositivo Juniper, use o arquivo de pós-licença para carregar um arquivo de licença. Você receberá um ID de arquivo que pode ser usado para criar um dispositivo virtual. Caso você tenha um dispositivo Juniper redundante, poderá usar o mesmo ID de arquivo para os dispositivos primário e secundário.
Fortinet: 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, você deve fazer 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 virtual.
- Efetue login no dispositivo para verificar o status da sua licença.

Etapa 4: Criar dispositivo autoconfigurado

	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`, Em inglês `draftUuid`

Para criar um dispositivo redundante que tenha dispositivos primários e secundários:

Definir parâmetros do objeto secundário
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. Os números da conta principal e secundária devem ser iguais. Embora a conta do revendedor seja faturada, esse 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.
No caso de dispositivos Cisco FTD, o tipo de gerenciamento para os dispositivos primário e secundário deve ser o mesmo.

observação

Ao criar um dispositivo virtual, você aceita os Termos do pedido. Ligue para Obter Termos do Pedido para revisar os detalhes.

Para salvar um rascunho de dispositivo, você deve fornecer deviceTypeCode, accountNumber ou accountReferenceIde metroCode.

Exemplos de solicitações

Um exemplo de solicitar curl para criar um único dispositivo.

curl -X  
POST "https://api.equinix.com/ne/v1/devices?draft=false"  
-H "content-type: application/json"  
-H "Authorization: Bearer <token>"  
-d '  
{  
    "metroCode": "SV",  
    "deviceTypeCode": "VSRX",  
    "agreeOrderTerms": true,  
    "termLength": "1",  
    "licenseMode": "BYOL",  
    "packageCode": "STD",  
    "virtualDeviceName": "Test-device-001-SROY",  
    "notifications": [  
        "test@equinix.com"  
    ],  
    "hostNamePrefix": "TC12",  
    "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
    "accountNumber": "200541",  
    "version": "23.2R1.13",  
    "interfaceCount": 8,  
    "deviceManagementType": "SELF-CONFIGURED",  
    "core": 2,  
    "userPublicKey": {  
        "username": "userName",  
        "keyName": "keyName"  
    },  
    "additionalBandwidth": "100"  
}  
'

Um exemplo de solicitação curl para criar um dispositivo redundante.

curl -X  
POST "https://api.equinix.com/ne/v1/devices?draft=false"  
-H "content-type: application/json"  
-H "Authorization: Bearer <token>"  
-d '  
{  
    "metroCode": "DC",  
    "deviceTypeCode": "C8000V",  
    "agreeOrderTerms": true,  
    "termLength": "1",  
    "licenseMode": "BYOL",  
    "packageCode": "network-advantage",  
    "virtualDeviceName": "Test-device-001-SROY - primary",  
    "notifications": [  
        "test@equinix.com"  
    ],  
    "hostNamePrefix": "TC01",  
        "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
    "accountNumber": "201148",  
    "version": "17.06.06a",  
    "interfaceCount": 10,  
    "deviceManagementType": "SELF-CONFIGURED",  
    "core": 2,  
    "userPublicKey": {  
        "username": "sroy",  
        "keyName": "keyWIQzB"  
    },  
    "sshInterfaceId": "3",  
    "channelPartner": "SDCI",  
    "secondary": {  
        "metroCode": "DC",  
        "hostNamePrefix": "TC02",  
        "notifications": [  
            "test@equinix.com"  
        ],  
        "virtualDeviceName": "Test-device-002-SROY - secondary",  
        "additionalBandwidth": "100",  
            "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
        "accountNumber": "201148",  
        "sshInterfaceId": "4"  
    }  
}  
'

Um exemplo de solicitação curl para criar um dispositivo secundário Cisco FTD 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": "Cisco_NGFW",  
    "licenseMode": "BYOL",  
    "packageCode": "FTDv5",  
    "virtualDeviceName": "NEAut-",  
    "metroCode": "DC",  
    "notifications": [  
        "t@t.com"  
    ],  
    "hostNamePrefix": "test",  
    "interfaceCount": 10,  
    "deviceManagementType": "SELF-CONFIGURED",  
    "core": 4,  
    "version": "7.0.4-55",  
    "vendorConfig": {  
        "managementType": "FDM"  
    },  
    "connectivity": "PRIVATE",  
    "secondary": {  
        "hostNamePrefix": "test-123",  
        "metroCode": "DC",  
        "notifications": [  
            "t@t.com"  
        ],  
        "virtualDeviceName": "test-secondary",  
        "vendorConfig": {  
            "managementType": "FDM"  
        }  
    }  
}  
'

Para obter uma lista completa de parâmetros e opções, consulte a Referência do API .

Exemplos de Respostas

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"  
}

Status do dispositivo

Monitore o status do seu dispositivo chamando Get Virtual Device (uuid). Seu dispositivo deve ser provisionado e sua licença deve ser registrada antes que você possa se conectar a provedores de serviços de nuvem.

"Status" do dispositivo virtual	Descrição
`INITIALIZING`	A Equinix está no processo de reservar recursos e criar o dispositivo.
`PROVISIONING`	O dispositivo está inicializando.
`PENDING_ORDER`	A ordem chegou a NE de Siebel. Os clientes precisam fazer login no portal NE e enviar o pedido.
`PENDING_SIGNATURE`	O cliente se inscreveu para a aceitação offline dos termos do NE, mas ainda não aceitou os termos.
`CANCEL_ORDER`	O pedido de Siebel para NE foi cancelado.
`WAITING_FOR_PRIMARY`	O dispositivo secundário está pronto, mas o primário não. Esse estado pode aparecer somente se você tiver criado um dispositivo secundário para redundância.
`WAITING_FOR_SECONDARY`	O dispositivo primário está pronto, mas o secundário não. Esse estado pode aparecer somente se você tiver criado um dispositivo secundário para redundância.
`FAILED`	A criação do dispositivo falhou.
`PROVISIONED`	O dispositivo está pronto.

Quando os usuários finais excluem um dispositivo usando a APIExcluir dispositivos virtuais, o dispositivo passa pelos seguintes estados na infraestrutura do Equinix.

"Status" do dispositivo virtual em /ne/v1/devices/{uuid}	Descrição
DESPROVISIONANDO	A Equinix aceitou a solicitação do cliente para excluir um dispositivo virtual.
DESPROVISIONADO	O dispositivo foi desprovisionado/excluído.

Pré-requisitos​

Etapa 2: Obter detalhes do dispositivo​

Etapa 3: Opções de licenciamento​

Etapa 4: Criar dispositivo autoconfigurado​

Exemplos de solicitações​

Exemplos de Respostas​

Status do dispositivo​