Ir para o conteúdo principal

Conecte-se como E-Access

Habilite o acesso aos seus serviços de rede no Equinix Fabric sem precisar gerenciar as informações de C-tag das conexões.

Pré-requisitos​

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

  2. Obtenha suas informações relevantes de porta usando o endpointObter todas as portas. Especificamente, as portas precisam atender aos seguintes critérios:

    • A porta que agrega tráfego de diferentes clientes deve usar encapsulamento QINQ.
    • A porta que agrega tráfego de diferentes clientes pode ser atribuída apenas a outros ACCESS_EPL_VC tipos de conexões.
    • A porta do lado do cliente deve ser uma porta EPL e não pode ser atribuída a nenhuma outra conexão, a menos que esteja no DEPROVISIONED estado.

Criando uma conexão - Porta QINQ para Porta EPL​

Para criar uma conexão como acesso eletrônico de uma porta QINQ para uma porta EPL, 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é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, redundancy, bandwidth, , aSide``zSide, , project, , , 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 requisição cURL:

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
    "type": "ACCESS_EPL_VC",
    "name": "Conn-1",
    "order": {
        "purchaseOrderNumber": "1-129105284100"
    },
    "bandwidth": 50,
    "redundancy": {
        "priority": "PRIMARY"
    },
    "aSide": {
        "accessPoint": {
            "type": "COLO",
            "port": {
                "uuid": "3312101f-5bd0-43d5-b21a-d442b35816a5"
            },
            "linkProtocol": {
                "type": "QINQ",
                "vlanSTag": 1001
            }
        }
    },
    "zSide": {
        "accessPoint": {
            "type": "COLO",
            "port": {
                "uuid": "ca655bb1-cca0-ca01-75e0-306a5c00ae38"
            }
        }
    },
    "project": {  
        "projectId": 568
    },
    "notifications": [
        {
            "type": "ALL",
            "emails": [
                "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:

{
    "type": "ACCESS_EPL_VC",
    "href": "https://api.equinix.com/fabric/v4/connections/eb45d323-5281-44dc-842b-c19a15ac837f",
    "uuid": "eb45d323-5281-44dc-842b-c19a15ac837f",
    "name": "Conn-1",
    "state": "PROVISIONING",
    "operation": {
        "providerStatus": "NOT_AVAILABLE",
        "equinixStatus": "PROVISIONING"
    },
    "order": {
        "purchaseOrderNumber": "1-129105284100",
        "billingTier": "Up to 50 Mbps"
    },
    "notifications": [
        {
            "type": "ALL",
            "emails": [
                "test@equinix.com"
            ]
        }
    ],
    "project": {  
        "projectId": 568
    },
    "account": {
        "accountNumber": 272235,
        "orgId": 91604,
        "globalOrgId": "0016u000003JZ6HAAW"
    },
    "changeLog": {
        "createdBy": "EPL-account01-user",
        "createdDateTime": "2022-03-26T11:07:47.325Z"
    },
    "bandwidth": 50,
    "redundancy": {
        "group": "5c0e9384-aa79-4ec9-b7a2-557f8c307292",
        "priority": "PRIMARY"
    },
    "isRemote": false,
    "direction": "INTERNAL",
    "aSide": {
        "accessPoint": {
            "type": "COLO",
            "account": {
                "accountNumber": 272235,
                "orgId": 91604,
                "organizationName": "EPL-account01",
                "globalOrgId": "0016u000003JZ6HAAW"
            },
            "location": {
                "href": "https://api.equinix.com/fabric/v4/metros/DA",
                "region": "AMER",
                "metroName": "Dallas",
                "metroCode": "DA"
            },
            "port": {
                "href": "https://api.equinix.com/fabric/v4/ports/3312101f-5bd0-43d5-b21a-d442b35816a5",
                "uuid": "3312101f-5bd0-43d5-b21a-d442b35816a5",
                "name": "272235-DA1-CX-Primary-01"
            },
            "linkProtocol": {
                "type": "QINQ",
                "vlanSTag": 689,
                "vlanCTag": 0
            }
        }
    },
    "zSide": {
        "accessPoint": {
            "type": "COLO",
            "account": {
                "accountNumber": 272235,
                "orgId": 91604,
                "organizationName": "EPL-account01",
                "globalOrgId": "0016u000003JZ6HAAW"
            },
            "location": {
                "href": "https://api.equinix.com/fabric/v4/metros/DA",
                "region": "AMER",
                "metroName": "Dallas",
                "metroCode": "DA"
            },
            "port": {
                "href": "https://api.equinix.com/fabric/v4/ports/ca655bb1-cca0-ca01-75e0-306a5c00ae38",
                "uuid": "ca655bb1-cca0-ca01-75e0-306a5c00ae38",
                "name": "EPL-account01-DA1-NL-EPL-STD-SEC-10G-NK-28"
            },
            "linkProtocol": {
                "type": "UNTAGGED"
            }
        }
    }
}

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 - Porta EPL para Porta QINQ​

Para criar uma conexão como e-Access de uma porta EPL para uma porta 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 requisição cURL:

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
    "type": "ACCESS_EPL_VC",
    "name": "Conn-1",
    "order": {
        "purchaseOrderNumber": "1-129105284100"
    },
    "bandwidth": 50,
    "redundancy": {
        "priority": "PRIMARY"
    },
    "aSide": {
        "accessPoint": {
            "type": "COLO",
            "port": {
                "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
            }
        }
    },
    "zSide": {
        "accessPoint": {
            "type": "COLO",
            "port": {
                "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
            },
            "linkProtocol": {
                "type": "QINQ",
                "vlanSTag": 1001
            }
        }
    },
    "project": {  
        "projectId": 568
    },
    "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.

Esta página foi útil?