Pular para o conteúdo principal

Conecte o dispositivo de Network Edge à porta remota

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

Pré-requisitos da API Fabric​

  1. 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.

  2. Determine suas informações A-Side. Recupere as informações de seus dispositivos Network Edge usando Obter dispositivos virtuais ou Obter dispositivo virtual . 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.

  3. Recupere suas informações de 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 a uma porta remota com tráfego não marcado, envie uma POST solicitação para o /fabric/v4/connections ponto de extremidade. 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
MétodoPOST
Ponto de extremidade/fabric/v4/connections
CabeçalhosAuthorization, Em inglês Content-Type
Parâmetros do caminhoNão aplicável
Parâmetros de consultaNão aplicável
Parâmetros Corporaistype``name, , order bandwidth, , , aSide, , , zSide, projectem inglês, 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 do API .

Conectando a uma Porta remota DOT1Q​

Para criar uma conexão de um dispositivo Network Edge a uma porta remota DOT1Q, envie uma POST solicitação para o /fabric/v4/connections endpoint. 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 do API .

Conectando a uma Porta remota QinQ​

Para criar uma conexão de um dispositivo Network Edge a uma porta remota QinQ, envie uma POST solicitação para o /fabric/v4/connections endpoint. 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.

Esta página foi útil?