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

Etapa 2: Obtenha detalhes do dispositivo

Chame Obter Tipos de Dispositivo para descobrir qual dispositivo autoconfigurável (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 a função 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 o número da sua conta (ou acountReferenceId) e o 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 para criar o dispositivo para ele.

Etapa 3: Opções de licenciamento

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

Arista: Não oferecemos suporte para upload de licenças para dispositivo Arista. No entanto, você pode fazer login no seu dispositivo após a criação para fazer upload de 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 campo licenseToken.
A Juniper fornece arquivos de licença. Para trazer sua própria licença (BYOL) para um dispositivo Juniper, use Postar Arquivo de Licença para carregar um arquivo de licença. Você receberá um ID de arquivo que poderá usar 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 campo licenseToken. 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.
- Faça o upload do arquivo de licença no portal da Equinix chamando Post License File. Você receberá um fileId que poderá usar para criar um dispositivo virtual.
- Efetue login no dispositivo para verificar o status da sua licença.

Etapa 4: Crie um dispositivo autoconfigurado

	POST /ne/v1/devices
Method	`POST`
URL or End Point	`/ne/v1/devices`
Headers	`Authorization` token, `Content-Type`
Query Parameters	`draft`, `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 o seu cliente, certifique-se de que as áreas metropolitanas primária e secundária estejam no mesmo país. Os números de conta primário e secundário devem ser idênticos. Embora a fatura seja emitida para a conta do revendedor, esta API aceita o número da conta do cliente para criar dispositivos para ele. 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. Chame Obter Termos do Pedido para revisar os detalhes. Consulte Criando um Dispositivo de Borda Autoconfigurável para entender os detalhes comerciais.

Para salvar um rascunho de dispositivo, você deve fornecer deviceTypeCode, accountNumber ou accountReferenceId e 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": "18.4R2-S1.4",  
    "interfaceCount": 10,  
    "deviceManagementType": "SELF-CONFIGURED",  
    "core": 5,  
    "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-002-SROY",  
    "notifications": [  
        "test@equinix.com"  
    ],  
    "hostNamePrefix": "TC01",  
        "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
    "accountNumber": "201148",  
    "version": "17.06.01a",  
    "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-001-SROY - secondary",  
        "additionalBandwidth": "100",  
            "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
        "accountNumber": "201148",  
        "sshInterfaceId": "4"  
    },  
    "additionalBandwidth": "100"  
}  
'

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": "#(supportedMetro)",  
    "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": "#(supportedMetroForSec)",  
        "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 da API.

Exemplos de Respostas

Exemplo de resposta para um único dispositivo. 202: Solicitação aceita.

{  
    "uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec"  
}

Resposta de exemplo 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 Obter Dispositivo Virtual {uuid}. Seu dispositivo deve estar provisionado e sua licença deve estar registrada antes que você possa se conectar aos provedores de serviços em nuvem.

Virtual device "status"	Description
`INITIALIZING`	Equinix is in the process of reserving resources and creating the device.
`PROVISIONING`	The device is booting.
`PENDING_ORDER`	The order has come to NE from Siebel. Customers need to log in to the NE portal and submit the order.
`PENDING_SIGNATURE`	The customer has signed up for the offline acceptance of NE terms but has not yet accepted the terms.
`CANCEL_ORDER`	The order from Siebel to NE is canceled.
`WAITING_FOR_PRIMARY`	The secondary device is ready but the primary is not. This state might appear only if you have created a secondary device for redundancy.
`WAITING_FOR_SECONDARY`	The primary device is ready but the secondary is not. This state might appear only if you have created a secondary device for redundancy.
`FAILED`	The device creation failed.
`PROVISIONED`	The device is ready.

Quando os usuários finais excluem um dispositivo usando a API Excluir Dispositivos Virtuais, o dispositivo passa pelos seguintes estados no Equinix. infraestrutura.

Virtual device "status" under /ne/v1/devices/{uuid}	Description
DEPROVISIONING	Equinix accepted the customer's request to delete a virtual device.
DEPROVISIONED	The device is de-provisioned/deleted.

Pré-requisitos​

Etapa 2: Obtenha detalhes do dispositivo​

Etapa 3: Opções de licenciamento​

Etapa 4: Crie um dispositivo autoconfigurado​

Exemplos de solicitações​

Exemplos de Respostas​

Status do dispositivo​