Conecte o dispositivo de Network Edge à porta remota
Estabeleça uma conexão desmarcada entre seu dispositivo virtual Network Edge e uma porta Fabric remota usando o Fabric API .

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 API para obter instruções sobre como chamar o OAuth API para validar e autenticar suas credenciais.
-
Determine suas informações do A-Side. Obtenha as informações dos seus dispositivos Network Edge usando Obter dispositivos virtuais ou Obter dispositivo virtual (uuid). Você pode escolher qualquer interface disponível no dispositivo para sua conexão. No entanto, o Equinix selecionará uma interface se você não especificar uma.
-
Obtenha as informações das suas portas Equinix Fabric usando a solicitaçãoGet All Ports API.
Conectando a uma Porta remota não marcada
Para criar uma conexão de um dispositivo Network Edge para uma porta remota com tráfego não marcado, 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.
Você pode criar apenas uma única conexão não marcada de um dispositivo virtual do Network Edge para uma porta remota.
| 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, bandwidth, aSide, , zSide``project, , 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",
"bandwidth": 100,
"redundancy": {
"priority": "PRIMARY"
},
"name": "ConnectionName-1",
"order": {
"purchaseOrderNumber": "1-3232923"
},
"aSide": {
"accessPoint": {
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "fd5342f3-d067-4683-a24f-be952279630b"
},
"interface": {
"type": "NETWORK",
"id": 45645
}
}
},
"zSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"linkProtocol": {
"type": "UNTAGGED"
}
}
},
"project": {
"projectId": 567
},
"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 de parâmetros e suas descrições, consulte a Referência API .
Conectando a uma Porta remota DOT1Q
Para criar uma conexão de um dispositivo Network Edge para uma porta remota DOT1Q, 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",
"bandwidth": 1000,
"name": "vd to COLO",
"aSide": {
"accessPoint": {
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"interface": {
"type": "NETWORK",
"id": 45645
}
}
},
"zSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": 300
}
}
},
"order": {
"purchaseOrderNumber": "1-129105284100"
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test1@equinix.com"
]
}
]
}'
Exemplo de resposta:
{
"type": "EVPL_VC",
"href": "https://api.equinix.com/fabric/v4/connections/c193c1c4-2c7e-472d-8c91-0283bc3b5a71",
"uuid": "c193c1c4-2c7e-472d-8c91-0283bc3b5a71",
"name": "ConnectionName-1",
"state": "PROVISIONING",
"operation": {
"providerStatus": "NOT_AVAILABLE",
"equinixStatus": "PROVISIONING"
},
"order": {
"purchaseOrderNumber": "1-3232923"
},
"project": {
"projectId": 567
},
"notifications": [
{
"type": "ALL",
"emails": [
"testqq@equinix.com"
]
}
],
"account": {
"accountNumber": 270217,
"orgId": 92287,
"globalOrgId": "0016u000003JZ53AAG"
},
"changeLog": {
"createdBy": "eqxnfvuser",
"createdDateTime": "2022-03-22T23:14:23.546Z"
},
"bandwidth": 100,
"redundancy": {
"group": "79a0e626-55fe-4fe1-89a5-4d7ca52214db",
"priority": "PRIMARY"
},
"isRemote": true,
"direction": "INTERNAL",
"aSide": {
"accessPoint": {
"interface": {
"uuid": "bf8a606b-32b2-4a53-a450-6eabd7d9ccab",
"id": 45645,
"type": "CLOUD"
},
"type": "VD",
"account": {
"accountNumber": 270217,
"orgId": 92287,
"organizationName": "eqx-nfv",
"globalOrgId": "0016u000003JZ53AAG"
},
"location": {
"href": "https://api.equinix.com/fabric/v4/metros/DC",
"region": "AMER",
"metroName": "Ashburn",
"metroCode": "DC"
},
"virtualDevice": {
"href": "https://api.equinix.com/ne/v1/devices/fd5342f3-d067-4683-a24f-be952279630b",
"uuid": "fd5342f3-d067-4683-a24f-be952279630b",
"name": "ha-json",
"type": "EDGE"
}
}
},
"zSide": {
"accessPoint": {
"type": "COLO",
"account": {
"accountNumber": 270224,
"orgId": 92287,
"organizationName": "eqx-nfv",
"globalOrgId": "0016u000003JZ53AAG"
},
"location": {
"href": "https://api.equinix.com/fabric/v4/metros/SY",
"region": "APAC",
"metroName": "Sydney",
"metroCode": "SY"
},
"port": {
"href": "https://api.equinix.com/fabric/v4/ports/c791f8cb-5d73-d730-8ce0-306a5c00a4ee",
"uuid": "c791f8cb-5d73-d730-8ce0-306a5c00a4ee",
"name": "eqx-nfv-SY1-L-Dot1q-BO-PRI-10G-JN-1147"
},
"linkProtocol": {
"type": "DOT1Q"
}
}
},
"additionalInfo": []
}
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 .
Conectando a uma Porta remota QinQ
Para criar uma conexão de um dispositivo Network Edge para uma porta remota QinQ, 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",
"bandwidth": 1000,
"name": "vd to COLO",
"aSide": {
"accessPoint": {
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"interface": {
"type": "NETWORK",
"id": 45645
}
}
},
"zSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"linkProtocol": {
"type": "QINQ",
"vlanSTag": 300,
"vlanCTag": 400
}
}
},
"order": {
"purchaseOrderNumber": "1-129105284100"
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test1@equinix.com"
]
}
]
}
'
Monitorando sua conexão
Use o ponto de extremidadeGet Specified Connection API para monitorar o status da conexão.