Conecte-se usando dois tokens de serviço

Você pode estabelecer conexões entre seus ativos ou terceiros usando as informações predefinidas em um Token de Serviço. Tokens de Serviço podem ser emitidos tanto para o lado A quanto para o lado Z de uma conexão.

Por exemplo, você pode criar uma conexão de uma origem definida por um token de serviço do lado A para um destino definido por um token de serviço do lado Z.

Pré-requisitos

1. Autenticar - Envie suas credenciais de usuário, ID do Cliente e Segredo do Cliente para autenticação OAuth2. Consulte Autenticação de API para obter instruções sobre como chamar a API OAuth para validar e autenticar suas credenciais.

2. Obtenha os detalhes do token de serviço do lado A junto ao provedor.

3. Obtenha os detalhes do token de serviço do lado Z junto ao provedor.

Essas informações são necessárias para invocar a API de criação de conexão .

Criando uma conexão de um token de serviço do lado A para um do lado Z

Para criar uma conexão entre dois tokens de serviço, envie uma solicitação POST para o endpoint /fabric/v4/connections. Especifique os detalhes dos tokens de serviço do lado A e do lado Z no corpo da solicitação.

observação

Um token de serviço pode ser enviado para vários destinatários e é válido para uso único por qualquer um deles.

	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 esta solicitação com segurança em produção sem criar uma conexão, consulte Testando em Produção (Simulação de API).

Exemplo de solicitação 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"      ]  
    }  
    ]  
}'

Os parâmetros incluídos no corpo da solicitação são específicos deste exemplo. Para obter uma lista completa dos parâmetros e suas descrições, consulte a Referência da API.

Exemplo de resposta:

{  
    "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"    }  
}

A resposta inclui parâmetros de configuração definidos no corpo da requisição. Para obter uma lista completa dos parâmetros possíveis e suas descrições, consulte a Referência da API.

Monitorando a Conexão

Use o endpoint Obter conexão especificada para monitorar o status da conexão.