Conecte-se a um provedor de serviços no Fabric
Estabeleça uma conexão entre seus ativos alocado do IBX e um perfil de serviço.
Pré-requisitos
-
Autenticar - Envie suas credenciais de usuário, ID do cliente e segredo do cliente para autenticação OAuth2. Consulte Autenticação API para obter instruções sobre como chamar o OAuth API para validar e autenticar suas credenciais.
-
Determine as informações da porta A-Side. Obtenha suas informações relevantes de porta usando o endpointObter todas as portas.
-
Escolha o local do mercado estratégico no Z-Side. Use o endpointObter todos os mercados estratégicos para encontrar todos os mercados estratégicos onde o Equinix Fabric está disponível e determinar o local de destino da sua conexão.
-
Identifique as informações do perfil de serviço do provedor de serviços. Use o endpoint Recuperar perfis de serviço para procurar um perfil de serviço específico ou use o endpointListar perfis de serviço para listar todos os perfis de serviço disponíveis e identificar o perfil ao qual você deseja se conectar.
Criando uma conexão de uma porta DOT1Q para um provedor de serviços
Para criar uma conexão de uma porta DOT1Q para um provedor de serviços, envie uma POST solicitação para o /fabric/v4/connections terminal. Especifique os detalhes de configuração da sua conexão no corpo da solicitação.
POST /fabric/v4/connections | |
|---|---|
| Método | POST |
| Ponto de extremidade | /fabric/v4/connections |
| Cabeçalhos | Authorization, Content-Type |
| Parâmetros do caminho | Não aplicável |
| Parâmetros de consulta | Não aplicável |
| Parâmetros Corporais | type``name, , order, redundancy, bandwidth, , aSide``zSide, , notifications |
Para validar com segurança essa solicitação na produção sem criar uma conexão, consulte Testes em produção (API Dry Run).
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,
"redundancy": {
"group": "b767f685-41b0-1b07-6de0-320a5c00abdd",
"priority": "SECONDARY"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": 1001
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"
},
"location": {
"metroCode": "SV"
}
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test@equinix.com"
]
}
]
}'
Os parâmetros incluídos no corpo da solicitação são específicos deste exemplo. Para obter uma lista completa de parâmetros e suas descrições, consulte a Referência 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,
"redundancy": {
"group": "b767f685-41b0-1b07-6de0-320a5c00abdd",
"priority": "SECONDARY"
},
"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/serviceProfiles/a867f685-41b0-1b07-6de0-320a5c00abdd",
"type": "L2_Profile",
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"location": {
"href": "https://api.equinix.com/v4/metros/SV",
"metrocode": "SV",
"region": "AMER"
}
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test2@equinix.com"
]
}
],
"operation": {
"equinixStatus": "PENDING_APPROVAL",
"providerStatus": "NOT_AVAILABLE"
},
"changeLog": {
"createdDateTime": "2021-07-15T19:30:29.526Z"
}
}
O payload de resposta inclui parâmetros de configuração definidos no corpo da solicitação. Para obter uma lista completa dos parâmetros possíveis e suas descrições, consulte a Referência API .
Criando uma conexão de uma porta QINQ para um provedor de serviços
Para criar uma conexão de uma porta QINQ para um provedor de serviços, envie uma POST solicitação para o /fabric/v4/connections terminal. 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,
"redundancy": {
"group": "b767f685-41b0-1b07-6de0-320a5c00abdd",
"priority": "SECONDARY"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
},
"linkProtocol": {
"type": "QINQ",
"vlanCTag": 1001,
"vlanSTag": 1002
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"
},
"location": {
"metroCode": "SV"
}
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test@equinix.com"
]
}
]
}'
Os parâmetros incluídos no corpo da solicitação são específicos deste exemplo. Para obter uma lista completa de parâmetros e suas descrições, consulte a Referência API .
Monitorando a Conexão
Use o endpointObter conexão especificada para monitorar o status da conexão.
equinixStatus valores de parâmetro | providerStatus valores de parâmetro | Descrição |
|---|---|---|
PENDING_APPROVAL | NOT_AVAILABLE | solicitar de conexão aguardando aprovação. |
PROVISIONING ou REJECTED | NOT_AVAILABLE | Estabelecimento de conexão em andamento ou o vendedor rejeitou a conexão. |
PROVISIONED | AVAILABLE | Conexão estabelecida. |
