API - Conectar ao Alibaba
Estabeleça uma conexão direta de camada 2 com o Alibaba Cloud.
Identifique o ID da sua conta Alibaba
Efetue login no Console de gerenciamento do Alibaba Express Connect e localize seu ID de conta.
Pré-requisitos da API Fabric
-
Autenticar - Envie suas credenciais de usuário, ID do cliente e segredo do cliente para OAuth2. Autenticação. Consulte Autenticação de API para obter instruções sobre como chamar a API OAuth para validar e autenticar suas credenciais.
-
Determine as informações do seu lado A. Ou:
- Recupere as informações das portas do Equinix Fabric usando a solicitação de API Obter todas as portas.
OU
- Determine as informações do seu dispositivo de borda de rede. Você precisa de um dispositivo virtual/dispositivo redundante/cluster Equinix provisionado com uma licença registrada. Verifique seus dispositivos virtuais e clusters disponíveis chamando Obter Dispositivos Virtuais ou Obter Dispositivo Virtual {uuid}. Você pode escolher qualquer interface disponível no dispositivo para sua conexão. No entanto, a Equinix selecionará uma interface se você não especificar uma.
-
Escolha a localização do metrô do lado Z. Use a solicitação de API Obter todos os metrôs para encontrar todos os metrôs onde o Equinix Fabric está disponível e determinar a localização de destino.
-
Identifique o perfil de serviço. Use a solicitação de API Recuperar Perfis de Serviço para pesquisar um perfil de serviço específico ou use a solicitação de API Obter Perfis de Serviço para listar todos os perfis de serviço disponíveis e identificar o perfil desejado. perfil ao qual você deseja se conectar.
Conectando-se ao Alibaba Express Connect a partir de uma Porta DOT1Q
Para criar uma conexão da sua porta DOT1Q com o Alibaba Express Connect, envie uma solicitação POST para o endpoint /fabric/v4/connections. Especifique os detalhes de configuração da sua conexão no corpo da solicitação.
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, bandwidth, aSide, zSide, additionalInfo, notifications |
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": "Conn-1",
"order": {
"purchaseOrderNumber": "1-129105284100"
},
"bandwidth": 1000,
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": 1001
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"uuid": "4c4b8edf-873b-4c6c-805a-edb2c335bd6c"
},
"location": {
"metroCode": "SV"
},
"authenticationKey": "xx-xxx-xx",
"sellerRegion": "us-west-1"
}
},
"notifications": {
"type": "ALL",
"emails": [
"test@equinix.com",
"test2@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/3a58dd05-f46d-4b1d-a154-2e85c396ea62",
"type": "EVPL_VC",
"uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62",
"name": "Conn-1",
"state": "PROVISIONING",
"order": {
"purchaseOrderNumber": "1-129105284100",
"billingTier": "Up to 1 Gbps"
},
"bandwidth": 1000,
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",
"type": "XF_PORT",
"uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": 1001
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"href": "https://api.equinix.com/fabric/v4/services/serviceProfiles/20d32a80-0d61-4333-bc03-707b591ae2f5",
"type": "L2_PROFILE",
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"
},
"location": {
"href": "https://api.equinix.com/v4/metros/SV",
"metroCode": "SV",
"region": "AMER"
},
"authenticationKey": "xx-xxx-xx",
"sellerRegion": "us-west-1"
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test2@equinix.com"
]
}
],
"operation": {
"equinixStatus": "PROVISIONING",
"providerStatus": "PROVISIONING"
},
"changeLog": {
"createdDateTime": "2021-07-15T19:30:29.526Z"
}
}
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.
Conectando-se ao Alibaba Express Connect a partir de uma Porta QINQ
Para criar uma conexão da sua porta QINQ com o Alibaba Express Connect, envie uma solicitação POST para o endpoint /fabric/v4/connections. Especifique os detalhes de configuração da sua conexão no corpo da solicitação.
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": "Conn-1",
"order": {
"purchaseOrderNumber": "1-129105284100"
},
"bandwidth": 1000,
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
},
"linkProtocol": {
"type": "QINQ",
"vlanCTag": 1001,
"vlanSTag": 1002
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"uuid": "4c4b8edf-873b-4c6c-805a-edb2c335bd6c"
},
"location": {
"metroCode": "SV"
},
"authenticationKey": "xx-xxx-xx",
"sellerRegion": "us-west-1"
}
},
"notifications": {
"type": "ALL",
"emails": [
"test@equinix.com",
"test2@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.
Conectando-se ao Alibaba Express Connect a partir de um dispositivo de Network Edge
Para criar uma conexão do seu dispositivo Network Edge com o Alibaba Express Connect, envie uma solicitação POST para o endpoint /fabric/v4/connections. Especifique os detalhes de configuração da sua conexão no corpo da solicitação.
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, bandwidth, aSide, zSide, additionalInfo, notifications |
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": "vd2Alibaba-vvv-0425b",
"bandwidth": "50",
"aSide": {
"accessPoint": {
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"type": "L2_PROFILE",
"uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
},
"location": {
"metroCode": "SV"
},
"authenticationKey": "XXXXXXXXXXXXXXX",
"sellerRegion": "us-west-1"
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"X@gmail.com"
]
}
],
"project": {
"projectId": "16799d66-ef43-445c-ba29-d17522d8a137"
}
}'
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.
{
"type": "EVPL_VC",
"href": "https://api.equinix.com/fabric/v4/connections/66ed4e8a-584c-4027-9788-748fecb5ce35",
"uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"name": "vd2Alibaba-vvv-0425c",
"operation": {
"providerStatus": "PROVISIONING",
"equinixStatus": "PROVISIONING"
},
"order": {
"billingTier": "Up to 50 MB"
},
"notifications": [
{
"type": "ALL",
"emails": [
"X@gmail.com"
]
}
],
"changeLog": {
"createdBy": "fabricamcrh1",
"createdByFullName": "fabric amcrh1",
"createdByEmail": "X@gmail.com",
"createdDateTime": "2024-04-25T20:43:43.199Z",
"updatedBy": "fabricamcrh1",
"updatedByFullName": "fabric amcrh1",
"updatedByEmail": "X@gmail.com",
"updatedDateTime": "2024-04-25T20:43:43.199Z"
},
"bandwidth": 50,
"redundancy": {
"group": "160e06b5-cd42-4c2c-b674-6dcda54da4d8",
"priority": "PRIMARY"
},
"aSide": {
"accessPoint": {
"interface": {
"uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"id": 6,
"type": "CLOUD"
},
"location": {
"metroCode": "DC"
},
"virtualDevice": {
"uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"type": "EDGE"
}
}
},
"zSide": {
"accessPoint": {
"location": {
"metroCode": "SV"
},
"profile": {
"href": "https://api.equinix.com/fabric/v4/serviceProfiles/4c4b8edf-873b-4c6c-805a-edb2c335bd6c",
"type": "L2_PROFILE",
"name": "Alibaba Cloud Express Connect",
"uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
},
"sellerRegion": "us-west-1",
"authenticationKey": "1111111111111"
}
}
}
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 o status da conexão
Envie uma solicitação GET para o endpoint fabric/v4/connections/{connectionId} para monitorar o status da conexão.
equinixStatus attribute values | providerStatus attribute values | Alibaba Cloud status | Description |
|---|---|---|---|
PROVISIONING | NOT_AVAILABLE | - | Connection request has not been sent to Alibaba yet. |
PROVISIONED | PENDING_APPROVAL | Pending creation | The connection awaits for approval. |
PROVISIONED | PROVISIONING / PROVISIONED | Create in progress | Connection establishment in progress. |
PROVISIONED | PROVISIONED | Active | Connection established. |
Aceite e pague pela conexão
- Efetue login no Console de gerenciamento do Alibaba Express Connect.
- No menu à esquerda, selecione Conexões Físicas.
- Identifique a instância recém-criada e clique. Aceitar e pagar.
- Crie uma instância de Virtual Border Router (VBR) e associe-a ao connection.
Para obter mais informações, consulte [Faturamento - Preços | Central de Documentação da Alibaba Cloud.