Ir para o conteúdo principal

Migrar conexão para um dispositivo virtual diferente

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 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 endpointPesquisar conexões 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 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étodoPATCH
URL ou ponto final/fabric/v4/connections/{uuid}
CabeçalhosAuthorization, Content-Type
Parâmetros do caminhouuid
Parâmetros de consultaNão aplicável
Parâmetros Corporaisop, 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âmetroObrigatórioTipoExemploValores aplicáveisDescrição
uuidsimcorda3a58dd05-f46d-4b1d-a154-2e85c396ea62-Identificador de conexão atribuído pela Equinix.

Parâmetros do corpo

ParâmetroObrigatórioTipoExemploValores aplicáveisDescrição
opsimcordasubstituasubstituaAtualizar tipo de solicitação.
caminhosimcorda/Aside/AccessPoint/Aside/AccessPointCaminho do parâmetro.
Valorsimobjeto-
tiposimcordaDDVD - Dispositivo Virtual.
dispositivo virtualsimobjeto-Detalhes do dispositivo virtual.
tiposimcordaEDGEEDGEBORDA.
uuidsimcorda78rtdd05-f46d-4b1d-a154-2e85c396yt56ID exclusivo do novo dispositivo virtual.
interfacenãoobjetoDetalhes da interface.
tiponãocordaTelecomREDE.
IDnãonúmero inteiro5Interface 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",
    }
}
Esta página foi útil?