# Migrar conexão para um dispositivo virtual diferente ![](https://docs.equinix.com/pt-BR/assets/images/MigrateConnectionToDifferentVirtualDevice-c2f98589b6a3ad47dc85d71ac39d316b.jpg) ## Pré-requisitos[​](#pré-requisitos "Link direto para Pré-requisitos") 1. Autenticar - Envie suas credenciais de usuário, ID do cliente e segredo do cliente para autenticação OAuth2. Consulte [Autenticação API](https://docs.equinix.com/pt-BR/equinix-api/api-authentication.md) para obter instruções sobre como chamar o OAuth API para validar e autenticar suas credenciais. 2. Determine o ID da conexão existente. Use o endpoint[Pesquisar conexões](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/searchconnections.md) para recuperar uma lista de conexões e determinar o ID da conexão que você deseja migrar para outra porta. 3. 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](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/virtual-device/getvirtualdevices) ou [Obter dispositivo virtual (uuuid)](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid). 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[​](#atualizando-a-conexão "Link direto para 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](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/updateconnectionbyuuid.md). 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)](https://docs.equinix.com/pt-BR/equinix-api/testing/testing-in-production-dry-run.md). 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 ' -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",     } } ```