# Connexion à l'aide de deux jetons de service Vous pouvez établir des connexions entre vos équipements ou des tiers à l'aide des informations prédéfinies dans un jeton de service. Les jetons de service peuvent être émis pour le côté a et le côté 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[​](#conditions-préalables "Lien direct vers 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](https://docs.equinix.com/fr-CA/equinix-api/api-authentication.md). 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[​](#création-dune-connexion-dun-jeton-de-service-côté-a-vers-un-jeton-de-service-côté-z "Lien direct vers Création d'une connexion d'un jeton de service côté A vers un jeton de service côté Z") Pour créer une connexion entre des tokens de service, envoyez une `POST` demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/createconnection.md)point final. Dans le corps de la demande, spécifiez les détails de vos jetons de service a-Side et z-Side. > **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** | | --------------------- | ------------------------------------------------------------------------------------- | | Méthode | `POST` | | Terminal | `/fabric/v4/connections` | | En-têtes | `Authorization`, `Content-Type` | | Paramètres du chemin | Non applicable | | Paramètres de requête | Non applicable | | Paramètres corporels | `type`, `name`, `order`, `redundancy`, , `bandwidth``aSide`, `zSide`, `notifications` | Pour valider en toute sécurité cette demande en production sans créer de connexion, voir [test en production (API à sec)](https://docs.equinix.com/fr-CA/equinix-api/testing/testing-in-production-dry-run.md). Exemple de requête cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -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 demande sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, reportez-vous à la [référence API](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/createconnection.md) . 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 réponse comprend les paramètres de configuration définis dans le corps de la demande. Pour obtenir la liste complète des paramètres possibles et leurs descriptions, reportez-vous à la [référence API](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/createconnection.md) . ## Surveillance de la connexion[​](#surveillance-de-la-connexion "Lien direct vers Surveillance de la connexion") Utilisez le point de terminaison[obtenir la connexion spécifiée](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/getconnectionbyuuid.md) pour surveiller l'état de la connexion.