Conéctese utilizando dos tokens de servicio
Puede establecer conexiones entre sus activos o terceros utilizando la información predefinida en un token de servicio. Se pueden emitir tokens de servicio tanto para el A-Side como para el z-Side de una conexión.
Por ejemplo, puede crear una conexión desde un origen definido por un token de servicio del lado a a un destino definido por un token de servicio del lado z.
Requisitos previos
-
Autenticar: Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte Autenticación de API para obtener instrucciones sobre cómo llamar al API de OAuth para validar y autenticar sus credenciales.
-
Obtenga los detalles del token de servicio del lado A del proveedor.
-
Obtenga los detalles del token de servicio del lado Z del proveedor.
Esta información es necesaria para invocar la API de creación de conexión.
Creación de una conexión desde un token de servicio del lado A al lado Z
Para crear una conexión entre tokens de servicio, envíe una POST solicitud al /fabric/v4/connections punto final. Especifique los detalles de su token de servicio de A-Side y z-Side en el cuerpo de la solicitud.
Un token de servicio puede enviarse a varios destinatarios, y es válido para un único uso por cualquiera de ellos.
| PUBLICAR /fabric/v4/Connections | |
|---|---|
| Método | POST |
| Punto final | /fabric/v4/connections |
| Encabezados | Authorization, Content-Type |
| Parámetros de la ruta | No aplicable |
| Parámetros de consulta | No aplicable |
| Parámetros corporales | type, name, order redundancy, , , bandwidth``aSide, zSide, , notifications |
Para validar de forma segura esta solicitud en producción sin crear una conexión, consulte Pruebas en producción (API Seco Run).
Ejemplo de solicitud 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" ]
}
]
}'
Los parámetros incluidos en el cuerpo de la solicitud son específicos de este ejemplo. Para obtener una lista completa de parámetros y sus descripciones, consulte la referencia de API .
Respuesta de muestra:
{
"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 carga útil de respuesta incluye parámetros de configuración definidos en el cuerpo de la solicitud. Para obtener una lista completa de los posibles parámetros y sus descripciones, consulte la Referencia de API .
Supervisión de la conexión
Utilice el punto final deconexión Get Especified para supervisar el estado de la conexión.