Passer au contenu principal

Migrer la connexion vers un autre appareil virtuel

Conditions préalables​

  1. Authentifier - envoyez vos identifiants utilisateur, votre identifiant client et votre secret client pour l'authentification OAuth2. Pour obtenir des instructions sur la façon d'appeler l'API OAuth pour valider et authentifier vos identifiants, reportez-vous à authentification API.

  2. Déterminez l'identifiant de connexion existant. Utilisez le point de terminaisonRechercher les connexions pour récupérer une liste de connexions et déterminer l'identifiant de la connexion que vous souhaitez migrer vers un autre port.

  3. Déterminez les informations relatives à votre appareil Network Edge. Vous avez besoin d'un dispositif virtuel Equinix/de dispositifs redondants/de clusters provisionnés avec une licence enregistrée. Vérifiez vos dispositifs virtuels et clusters disponibles en appelant GetVirtualDevices ou Get Virtual Device {UUID}. Vous pouvez choisir n'importe quelle interface disponible sur l'appareil pour votre connexion. Cependant, Equinix sélectionnera une interface si vous n'en spécifiez pas.

Mise à jour de la connexion​

Pour mettre à jour une connexion et la migrer vers un autre périphérique virtuel, envoyez PATCHune demande au noeud final/Fabric/v4/connections/{ID}. Dans le corps de la demande, spécifiez l'identifiant a-side de la connexion au dispositif virtuel vers lequel vous migrez la connexion.

PATCH /fabric/v4/connections/{uuid}
MéthodePATCH
URL ou point final/fabric/v4/connections/{uuid}
En-têtesAuthorization Content-Type
Paramètres du chemin d'accèsuuid
Paramètres d'interrogationNon applicable
Paramètres du corpsop, chemin, valeur

Pour valider en toute sécurité cette demande en production sans modifier les connexions, voir test en production (API à sec).

Exemple de requête 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
            }
        }
    }
]'

Paramètres de chemin

ParamètreObligatoireTypeExempleValeurs applicablesDescription
uuidouichaîne3a58dd05-f46d-4b1d-a154-2e85c396ea62-Identifiant de connexion attribué par Equinix.

Paramètres du corps

ParamètreObligatoireTypeExempleValeurs applicablesDescription
opouichaîneremplacerremplacerType de demande de mise à jour.
cheminouichaîne/Aide/AccessPoint/Aide/AccessPointChemin des paramètres.
Valeurouiobjet-
typeouichaîneVDVDVD - Virtual Device (appareil virtuel).
appareil virtuelouiobjet-Détails de l'appareil virtuel.
typeouichaîneEDGEEDGEEDGE.
uuidouichaîne78rtdd05-f46d-4b1d-a154-2e85c396yt56Identité unique du nouvel appareil virtuel.
interfacenonobjetDétails de l'interface.
typenonchaîneRéseauRÉSEAU.
IDnonentier5Interface de l'appareil virtuel.

Exemple de réponse :

{
    "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",
    }
}
Cette page vous a-t-elle été utile ?