Criar um grupo de links de dispositivos

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

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

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

• Número da conta de faturamento da Equinix. Sua conta deve estar no status Ativo ou Pendente. Você deve fornecer um número de conta para cada link criado.

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

• Forneça metroLinks informações (número da conta, taxa de transferência, metroCode), 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 API para obter instruções sobre como chamar o OAuth API para validar e autenticar suas credenciais.

Etapa 2: Obtenha dispositivos virtuais

Para obter detalhes de seus dispositivos virtuais, ligue para Obter Dispositivos Virtuais . A resposta incluirá:

• virtualDeviceUuids
• metroCodes,
• ASNs
• accountNumbers.

Etapa 3: Criar Device Link

	POST /ne/v1/links
Método	POST
URL ou ponto final	/ne/v1/links
Cabeçalhos	Authorization, Em inglês Content-Type
Parâmetros do caminho	NA
Parâmetros Corporais	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 do API .

Resposta de amostra

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

Carga útil de resposta:

Campo	Tipo	Valores de exemplo	Descrição
uuid	corda	b43ba509-a7d9-4334-8dee-dc4f29bf2e77	O ID exclusivo do grupo de links do dispositivo .

Status do dispositivo

Quando um grupo de links de dispositivos é criado, ele transita por vários estados que podem ser monitorados usando o statusatributo de resposta do métodoGet Device Link. Seu grupo de links deve ser provisionado para que você possa começar a executar outras operações, como adicionar ou remover dispositivos.

Status	Descrição
PROVISIONING	O grupo de links do dispositivo está inicializando.
FAILED	Falha na criação do link.
PROVISIONED	O grupo de links do dispositivo está pronto.
DEPROVISIONING	O grupo de links de dispositivo está sendo desprovisionado.
DEPROVISIONED	O grupo de links do dispositivo foi desprovisionado.

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

Se você excluir um grupo de vínculo de dispositivo usando o métodoExcluir vínculo de dispositivo, o grupo passará pelos seguintes estados:

Status	Descrição
DEPROVISIONING	A Equinix aceitou a solicitar do cliente para excluir um grupo de links de dispositivo .
DEPROVISIONED	O link do dispositivo foi excluído.