Criar um grupo de links de dispositivos

Um grupo de links de dispositivos pode incluir qualquer dispositivo virtual provisionado e registrado, a menos que o dispositivo As interfaces já estão cheias. Para saber mais sobre links de dispositivos, consulte o guia Network Edge. Para criar um grupo de links de dispositivos usando APIs, você precisa do seguinte:

• Pelo menos dois dispositivos virtuais provisionados com licenças registradas. Você deve ter o deviceUuids e os metroCodes que indicam onde os dispositivos estão localizados.

• Você precisa fornecer os ASNs para os dispositivos se eles ainda não tiverem sido definidos. Se um dispositivo já tiver um ASN, recupere-o chamando Obter Dispositivo Virtual.

• Número da conta de cobrança da Equinix . Sua conta deve estar com status Ativo ou Pendente. Você deve fornecer um número de conta para cada link você .

• Escolha uma sub-rede para o grupo. Você deve escolher uma sub-rede levando em consideração o número de dispositivos que deseja adicionar ao grupo. Este campo não é obrigatório ao você criar um grupo de vinculação; no entanto, você deve fornecê-lo para ter um grupo de vinculação funcional.

• Forneça informações do metroLinks (número da conta, capacidade, código do metrô), a menos que os dispositivos estejam no mesmo metrô.

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 dispositivos virtuais

Para obter detalhes sobre seus dispositivos virtuais, chame Obter Dispositivos Virtuais. A resposta incluirá:

• virtualDeviceUuids
• metroCodes,
• ASNs
• accountNumbers.

Etapa 3: Criar link de dispositivo

	POST /ne/v1/links
Method	POST
URL or End Point	/ne/v1/links
Headers	Authorization, Content-Type
Path Parameters	NA
Body Parameters	groupName, subnet, redundancyType, linkDevices[deviceUuid, asn, interfaceId], metroLinks[ {accountNumber, throughput, throughputUnit, metroCode}]

Um exemplo de solicitar curl para criar um grupo de links de dispositivo entre dois dispositivos em duas áreas metropolitanas diferentes.

curl -X  
POST "https://api.equinix.com/ne/v1/links"  
-H "content-type: application/json"  
-H "Authorization: Bearer <token>"  
-d '{  
  "groupName": "test-link",  
  "subnet": "10.0.0.0/27",  
    "redundancyType": "SECONDARY",  
  "linkDevices": [  
    {  
      "deviceUuid": "d186dc1a-29e7-4829-bb5e-50fa57aca923",  
      "asn": 65414,  
      "interfaceId": 6  
    },  
    {  
      "deviceUuid": "ea128600-1875-4f7a-80e9-307a5bbeac51",  
      "asn": 100,  
      "interfaceId": 6  
    }  
  ],  
  "metroLinks": [  
    {  
      "accountNumber": "23945678",  
      "metroCode": "SV",  
      "throughput": 1000,  
      "throughputUnit": "Mbps"  
    },  
  
    {  
      "accountNumber": "2395123",  
      "metroCode": "SY",  
      "throughput": 1000,  
      "throughputUnit": "Mbps"  
    }  
  ]  
   
}'

Um exemplo de solicitar curl para criar um link de dispositivo entre dois dispositivos dentro de um área metropolitana.

curl -X  
POST "https://api.equinix.com/ne/v1/links"  
-H "content-type: application/json"  
-H "Authorization: Bearer <token>"  
-d '{  
    "groupName": "test-link",  
    "subnet": "10.0.0.0/27",  
    "redundancyType": "SECONDARY",  
    "linkDevices": [  
    {  
        "deviceUuid": "d186dc1a-29e7-4829-bb5e-50fa57aca923",  
        "asn": 65414,  
        "interfaceId": 6  
    },  
    {  
        "deviceUuid": "ea128600-1875-4f7a-80e9-307a5bbeac51",  
        "asn": 100,  
        "interfaceId": 6  
    }  
    ],  
    "metroLinks": []  
      
}'

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

Resposta de amostra

{  
    "uuid": "85ebe7b7-6182-45a1-be51-cb194f2f1e39"  
}

Carga útil de resposta:

Field	Type	Example Values	Description
uuid	string	b43ba509-a7d9-4334-8dee-dc4f29bf2e77	The unique ID of the device link group.

Status do dispositivo

Quando um grupo de links de dispositivos é criado, ele passa por vários estados que podem ser monitorados usando o atributo de resposta status do método Obter Link de Dispositivo. Seu grupo de links deve ser provisionado antes que você possa começar a executar outras operações, como adicionar ou remover dispositivos.

Status	Description
PROVISIONING	The device link group is booting.
FAILED	Link creation failed.
PROVISIONED	The device link group is ready.
DEPROVISIONING	The device link group is being de-provisioned.
DEPROVISIONED	The device link group is de-provisioned.

Você pode atualizar um grupo de links usando Atualizar link do dispositivo.

Se você excluir um grupo de links de dispositivos usando o método Excluir Link de Dispositivo, o grupo passará pelos seguintes estados:

Status	Description
DEPROVISIONING	Equinix accepted the customer's request to delete a device link group.
DEPROVISIONED	The device link is deleted.