Ir para o conteúdo principal

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​

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

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

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, Content-Type
Parâmetros do caminhoNão aplicável
Parâmetros de consultaNão aplicável
Parâmetros Corporaistype``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.

Esta página foi útil?