Passer au contenu principal

Connectez-vous à 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 à partir d'une origine définie par un jeton de service a-side vers une destination définie par un jeton de service z-side.

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. 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 entre un jeton de service côté A et un jeton de service côté Z​

Pour créer une connexion entre des tokens de service, envoyez une POST demande au /fabric/v4/connectionspoint final. Dans le corps de la demande, spécifiez les détails de vos jetons de service a-Side et z-Side.

note

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

POST /fabric/v4/connections
MéthodePOST
Terminal/fabric/v4/connections
En-têtesAuthorization Content-Type
Paramètres du chemin d'accèsNon applicable
Paramètres d'interrogationNon applicable
Paramètres du corpstype, 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).

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 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 .

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 .

Contrôle de la connexion​

Utilisez le point de terminaisonobtenir la connexion spécifiée pour surveiller l'état de la connexion.

Cette page vous a-t-elle été utile ?