Migrer la connexion vers un autre appareil virtuel

Conditions préalables

1. Authentifier - Soumettez vos informations d'identification de l'utilisateur, l'ID du client et le secret du client pour l'authentification OAuth2. Reportez-vous à API Authentication pour savoir comment appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.

2. Déterminez l'ID de la connexion existante. Utilisez le point de terminaison Search Connections pour récupérer une liste de connexions et déterminer l'ID de la connexion que vous souhaitez migrer vers un port différent.

3. Déterminez les informations relatives à votre périphérique Network Edge. Vous devez disposer d'un dispositif virtuel, d'un dispositif redondant ou d'un cluster Equinix provisionné avec une licence enregistrée. Vérifiez vos dispositifs virtuels et clusters disponibles en appelant Get Virtual Devices ou Get Virtual Device {uuid}. Vous pouvez choisir n'importe quelle interface disponible sur le périphérique pour votre connexion. Toutefois, 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 dispositif virtuel différent, envoyez une requête PATCH au point de terminaison /fabric/v4/connections/{id}. Spécifiez l'ID a-side de la connexion vers le dispositif virtuel vers lequel vous migrez la connexion dans le corps de la demande.

	PATCH /fabric/v4/connections/{uuid}
Method	PATCH
URL or Endpoint	/fabric/v4/connections/{uuid}
Headers	Authorization, Content-Type
Path Parameters	uuid
Query Parameters	Not applicable
Body Parameters	op, path, value

Pour valider cette demande en toute sécurité en production sans modifier aucune connexion, consultez Testing in Production (API Dry Run).

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 du chemin

Parameter	Mandatory	Type	Example	Applicable Values	Description
uuid	yes	string	3a58dd05-f46d-4b1d-a154-2e85c396ea62	-	Equinix-assigned connection identifier.

Paramètres corporels

Parameter	Mandatory	Type	Example	Applicable Values	Description
op	yes	string	replace	replace	Update reqest type.
path	yes	string	/aSide/accessPoint	/aSide/accessPoint	Parameter path.
value	yes	object		-
type	yes	string	VD	VD	VD - Virtual Device.
virtualDevice	yes	object		-	Virtual Device details.
type	yes	string	EDGE	EDGE	EDGE.
uuid	yes	string	78rtdd05-f46d-4b1d-a154-2e85c396yt56		Unique Id of the new Virtual Device.
interface	no	object			Interface details.
type	no	string	NETWORK		NETWORK.
id	no	integer	5		Interface of the Virtual Device.

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",  
    }  
}