Se connecter à l'aide de deux jetons de service

Vous pouvez établir des connexions entre vos actifs ou des tiers grâce aux informations prédéfinies dans un jeton de service. Les jetons de service peuvent être émis pour les côtés A et Z d'une connexion.

Par exemple, vous pouvez créer une connexion depuis une origine définie par un jeton de service côté a vers une destination définie par un jeton de service côté z.

Conditions préalables

1. Authentification: soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète pour l’authentification OAuth2. Consultez la documentation relative à l’authentification API (Authentification API) pour savoir comment appeler l’API OAuth afin de valider et d’authentifier vos identifiants.

2. Obtenez les détails du jeton de service côté A auprès du fournisseur.

3. Obtenez les détails du jeton de service côté Z auprès du fournisseur.

Ces informations sont nécessaires pour invoquer l'API de création de connexion.

Création d'une connexion d'un jeton de service côté A vers un jeton de service côté Z

Pour établir une connexion entre deux jetons de service, envoyez une requête POST au point de terminaison /fabric/v4/connections. Précisez les détails de vos jetons de service côté A et côté Z dans le corps de la requête.

remarque

Un jeton de service peut être envoyé à plusieurs destinataires et est valable pour une seule utilisation par chacun d'entre eux.

	POST /fabric/v4/connections
Method	POST
Endpoint	/fabric/v4/connections
Headers	Authorization, Content-Type
Path Parameters	Not applicable
Query Parameters	Not applicable
Body Parameters	type, name, order, redundancy, bandwidth, aSide, zSide, notifications

Pour valider en toute sécurité cette requête en production sans créer de connexion, consultez Tests en production (exécution à blanc de l'API).

Exemple de requête cURL:

curl -X  
POST 'https://api.equinix.com/fabric/v4/connections'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '{  
    "type": "EVPL_VC",  
    "name": "AST_TO_ZST_CONNECTION",  
    "order": {  
    "purchaseOrderNumber": "1-129105284100"  },  
    "bandwidth": 100,  
    "redundancy": {  
    "priority": "PRIMARY"  },  
    "aSide": {  
    "serviceToken": {  
        "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"    }  
    },  
    "zSide": {  
    "serviceToken": {  
        "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"    }  
    },  
    "notifications": [  
    {  
        "type": "ALL",  
        "emails": [  
        "test@equinix.com",  
        "test1@equinix.com"      ]  
    }  
    ]  
}'

Les paramètres inclus dans le corps de la requête sont propres à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, consultez la référence de l'API.

Exemple de réponse:

{  
    "href": "https://api.equinix.com/fabric/v4/connections/b067f685-49b0-1a09-6fe0-360a5d00a",  
    "type": "EVPL_VC",  
    "uuid": "b067f685-49b0-1a09-6fe0-360a5d00a",  
    "name": "AST_TO_ZST_CONNECTION",  
    "state": "ACTIVE",  
    "operation": {  
        "providerStatus": "PROVISIONED",  
        "equinixStatus": "PROVISIONED"    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "test@equinix.com"            ]  
        }  
    ],  
    "account": {  
        "accountNumber": 201246,  
        "orgId": 92610,  
        "globalOrgId": "0017i000011X250AAC"    },  
    "changeLog": {  
        "createdBy": "testuser",  
        "createdDateTime": "2022-05-16T07:50:49.749Z"    },  
    "bandwidth": 100,  
    "redundancy": {  
        "group": "b067f685-49b0-1a09-6fe0-360a5d00afdg",  
        "priority": "PRIMARY"    },  
    "isRemote": true,  
    "direction": "OUTGOING",  
    "aSide": {  
        "serviceToken": {  
            "href": "https://api.equinix.com/fabric/v4/serviceTokens/b067f685-49b0-1a09-6fe0-360a5d00afdg",  
            "uuid": "b067f685-49b0-1a09-6fe0-360a5d00afdg"        },  
        "accessPoint": {  
            "location": {  
                "metroHref": "https://api.equinix.com/fabric/v4/metros/SV",  
                "metroCode": "SV"            },  
            "port": {  
                "href": "https://api.equinix.com/fabric/v4/ports/b067f685-49b0-1a09-6fe0-360a5d00afdg",  
                "uuid": "b067f685-49b0-1a09-6fe0-360a5d00afdg"            },  
            "linkProtocol": {  
                "type": "DOT1Q"            }  
        }  
    },  
    "zSide": {  
        "serviceToken": {  
            "href": "https://api.equinix.com/fabric/v4/serviceTokens/b067f685-49b0-1a09-6fe0-360a5d00afdg",  
            "uuid": "b067f685-49b0-1a09-6fe0-360a5d00afdg"        },  
        "accessPoint": {  
            "location": {  
                "metroHref": "https://api.equinix.com/fabric/v4/metros/SV",  
                "metroCode": "SV"            },  
            "port": {  
                "href": "https://api.equinix.com/fabric/v4/ports/b067f685-49b0-1a09-6fe0-360a5d00afdg",  
                "uuid": "b067f685-49b0-1a09-6fe0-360a5d00afdg"            },  
            "linkProtocol": {  
                "type": "DOT1Q"            }  
        }  
    },  
    "order": {  
        "purchaseOrderNumber": "1122334",  
        "billingTier": "Up to 50 MB"    }  
}

La charge utile de la réponse inclut les paramètres de configuration définis dans le corps de la requête. Pour obtenir la liste complète des paramètres possibles et leurs descriptions, consultez la référence de l'API.

Surveillance de la connexion

Utilisez le point de terminaison Get Specified Connection pour surveiller l'état de la connexion.