Passer au contenu principal

Migrer la connexion vers un autre périphérique 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 de terminaison/fabric/v4/connections/{uuid}
En-têtesAuthorization, Content-Type
Paramètres du cheminuuid
Paramètres de requêteNon applicable
Paramètres corporelsop, 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îneremplacerremplacerMettre à jour le type de demande.
cheminouichaîne/Aide/AccessPoint/Aide/AccessPointChemin du paramètre.
Valeurouiobjet-
typeouichaîneVDVDVD - Périphérique virtuel.
appareil virtuelouiobjet-Détails du périphérique virtuel.
typeouichaîneBORDBORDBORD.
uuidouichaîne78rtdd05-f46d-4b1d-a154-2e85c396yt56Identifiant unique du nouveau périphérique virtuel.
interfaceNonobjetDétails de l'interface.
typeNonchaîneRÉSEAURÉSEAU.
IDNonentier5Interface du périphérique 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 ?