Conectar utilizando dos tokens de servicio

Puede establecer conexiones entre sus activos o terceros utilizando la información predefinida en una Ficha de Servicio. Los Service Tokens pueden emitirse tanto para el lado a como para el lado z 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

1. Autenticar - Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte API Authentication para obtener instrucciones sobre cómo llamar a la API OAuth para validar y autenticar sus credenciales.

2. Obtenga los detalles del token de servicio del lado A del proveedor.

3. 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 solicitud POST al punto final /fabric/v4/connections. Especifique los detalles de su token de servicio del lado a y del lado z en el cuerpo de la solicitud.

nota

Un token de servicio puede enviarse a varios destinatarios, y es válido para un único uso por cualquiera de ellos.

	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

Para validar de forma segura esta solicitud en producción sin crear una conexión, consulte Pruebas en producción (API Dry 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 los parámetros y sus descripciones, consulte la Referencia 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 la respuesta incluye los 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 API.

Supervisión de la conexión

Utilice el punto final Obtener conexión especificada para supervisar el estado de la conexión.