Conecte o dispositivo de Network Edge à porta remota

Estabeleça uma conexão não etiquetada entre seu dispositivo virtual Network Edge e uma porta Fabric remota usando a API Fabric.

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. Recupere as informações dos seus dispositivos de borda de rede usando 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 caso você não especifique nenhuma.
Recupere as informações das portas do Equinix Fabric usando a solicitação de API Obter todas as portas.

Conectando a uma Porta remota não marcada

Para criar uma conexão de um dispositivo de borda de rede para uma porta remota com tráfego não etiquetado, 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.

observaçã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
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`, `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 dos parâmetros e suas descrições, consulte a Referência da API.

Conectando a uma Porta remota DOT1Q

Para criar uma conexão de um dispositivo Network Edge para uma porta remota DOT1Q, 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",  
    "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": []  
}

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 a uma Porta remota QinQ

Para criar uma conexão de um dispositivo Network Edge para uma porta remota QinQ, 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",  
    "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 endpoint da API Obter conexão especificada para monitorar o status da conexão.

Pré-requisitos da API Fabric​

Conectando a uma Porta remota não marcada​

Conectando a uma Porta remota DOT1Q​

Conectando a uma Porta remota QinQ​

Monitorando sua conexão​

Pré-requisitos da API Fabric

Conectando a uma Porta remota não marcada

Conectando a uma Porta remota DOT1Q

Conectando a uma Porta remota QinQ

Monitorando sua conexão