Saltar al contenido principal

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​

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

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

nota

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étodoPOST
Punto final/fabric/v4/connections
EncabezadosAuthorization, Content-Type
Parámetros de la rutaNo aplicable
Parámetros de consultaNo aplicable
Parámetros corporalestype, 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.

¿Le ha resultado útil esta página?