Migrar conexão para um dispositivo virtual diferente

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.
-
Determine o ID da conexão existente. Use o endpointPesquisar conexões para recuperar uma lista de conexões e determinar o ID da conexão que você deseja migrar para outra porta.
-
Determine as informações do seu dispositivo Network Edge. Você precisa de um dispositivo virtual Equinix provisionado/Dispositivos redundantes/cluster com uma licença registrada. Para verificar seus dispositivos virtuais e clusters disponíveis, ligue para Obter dispositivos virtuais ou Obter dispositivo virtual (uuuid). Você pode escolher qualquer interface disponível no dispositivo para sua conexão. No entanto, o Equinix selecionará uma interface se você não especificar uma.
Atualizando a conexão
Para atualizar uma conexão e migrá-la para outro dispositivo virtual, envie uma PATCH solicitação para o terminal/Fabric/v4/connections/id. No corpo da solicitação, especifique o ID A-Side da conexão para o dispositivo virtual para o qual você está migrando a conexão.
| PATCH /Fabric/v4/Connections/(uuid) | |
|---|---|
| Método | PATCH |
| URL ou ponto final | /fabric/v4/connections/{uuid} |
| Cabeçalhos | Authorization, Content-Type |
| Parâmetros do caminho | uuid |
| Parâmetros de consulta | Não aplicável |
| Parâmetros Corporais | op, caminho, valor |
Para validar com segurança essa solicitação na produção sem alterar nenhuma conexão, consulte Testes em produção (API Dry Run).
Exemplo de solicitação cURL:
curl -X
PATCH 'https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62'
-H 'content-type: application/json-patch+json'
-H 'authorization: Bearer <token>'
-d '[
{
"op": "replace",
"path": "/aSide/accessPoint",
"value": {
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "e8b49cd7-9b4c-4123-8bd4-fbead83c3436"
},
"interface": {
"type": "NETWORK",
"id": 5
}
}
}
]'
Parâmetros do caminho
| Parâmetro | Obrigatório | Tipo | Exemplo | Valores aplicáveis | Descrição |
|---|---|---|---|---|---|
| uuid | sim | corda | 3a58dd05-f46d-4b1d-a154-2e85c396ea62 | - | Identificador de conexão atribuído pela Equinix. |
Parâmetros do corpo
| Parâmetro | Obrigatório | Tipo | Exemplo | Valores aplicáveis | Descrição |
|---|---|---|---|---|---|
| op | sim | corda | substitua | substitua | Atualizar tipo de solicitação. |
| caminho | sim | corda | /Aside/AccessPoint | /Aside/AccessPoint | Caminho do parâmetro. |
| Valor | sim | objeto | - | ||
| tipo | sim | corda | D | D | VD - Dispositivo Virtual. |
| dispositivo virtual | sim | objeto | - | Detalhes do dispositivo virtual. | |
| tipo | sim | corda | EDGE | EDGE | BORDA. |
| uuid | sim | corda | 78rtdd05-f46d-4b1d-a154-2e85c396yt56 | ID exclusivo do novo dispositivo virtual. | |
| interface | não | objeto | Detalhes da interface. | ||
| tipo | não | corda | Telecom | REDE. | |
| ID | não | número inteiro | 5 | Interface do dispositivo virtual. |
Exemplo de resposta:
{
"href": "https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62",
"type": "EVPL_VC",
"uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62",
"name": "Conn-Name-2",
"state": "PROVISIONED",
"order": {
"purchaseOrderNumber": "1-129105284100",
"billingTier": "Up to 1 Gbps"
},
"bandwidth": 1000,
"redundancy": {
"group": "m167f685-41b0-1b07-6de0-320a5c00abeu",
"priority": "PRIMARY"
},
“aSide”: {
“accessPoint”: {
"interface": {
“uuid”: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
“id”: 7,
“type”: "NETWORK"
},
“location”: {
“metroCode”: "AM"
},
“virtualDevice”: {
“uuid”: "XXXXXXXXXXXXXXXXXXXXXXXXXX",
“type”: "EDGE"
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",
"type": "L2_Profile",
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"location": {
"href": "https://api.equinix.com/v4/metros/SV",
"metrocode": "SV",
"region": "AMER"
}
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test@equinix.com"
]
}
],
"operation": {
"equinixStatus": "PROVISIONED",
"providerStatus": "PROVISIONED"
},
"changeLog": {
"createdDateTime": "2021-07-15T19:30:29.526Z",
"updatedDateTime": "2021-08-15T19:30:29.526Z",
}
}