Connexion à l'aide de deux jetons de service

Vous pouvez établir des connexions entre vos actifs ou des tiers en utilisant les informations prédéfinies dans un jeton de service. Les jetons de service peuvent être émis à la fois 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 - 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. 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 deux jetons de service, envoyez une requête POST au point de terminaison /fabric/v4/connections. Spécifiez les détails de votre jeton de service a-side et z-side dans le corps de la requête.

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
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 cette demande en toute sécurité en production sans créer de connexion, consultez Testing in Production (API Dry Run).

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 spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leur description, consultez la [Référence API] (/api-catalog/fabricv4#tag/Connections/operation/createConnection).

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 comprend les paramètres de configuration définis dans le corps de la demande. Pour une liste complète des paramètres possibles et de leurs descriptions, voir la [Référence API] (/api-catalog/fabricv4#tag/Connections/operation/createConnection).

Contrôle de la connexion

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