Conecte o dispositivo de Network Edge a outros provedores de serviços

Estabeleça uma conexão direta de camada 2 com provedores de serviços em nuvem a partir do seu dispositivo de borda de rede usando a API Fabric.

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 de API para obter instruções sobre como chamar a API OAuth para validar e autenticar suas credenciais.

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

3. Escolha a localização do metrô do lado Z. Use a solicitação de API Obter todos os metrôs para encontrar todos os metrôs onde o Equinix Fabric está disponível e determinar a localização de destino.

4. Identifique o perfil de serviço do provedor de serviços em nuvem. Use a solicitação de API Recuperar Perfis de Serviço para pesquisar um perfil de serviço específico ou use a solicitação de API Obter Perfis de Serviço para listar todos os perfis de serviço disponíveis e identificar o provedor de serviços em nuvem ao qual você deseja se conectar.

Conectando-se a um provedor de serviços

Para conectar seu dispositivo de borda de rede a um provedor de serviços, 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.

	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, 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",  
    "name": "vd2other-sp-0412a",  
    "bandwidth": 1000,  
    "aSide": {  
        "accessPoint": {  
            "type": "VD",  
            "virtualDevice": {  
                "type": "EDGE",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXX"  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "type": "L2_PROFILE",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX"  
            },  
            "location": {  
                "metroCode": "DC"  
            }  
        }  
    },  
    "project": {  
        "projectId": "16799d66-ef43-445c-ba29-d17522d8a137"  
    },  
    "order": {  
        "purchaseOrderNumber": "1-129105284100"  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "x@gmail.com"  
            ]  
        }  
    ]  
}'

Exemplo de resposta:

{  
    "type": "EVPL_VC",  
    "href": "https://api.equinix.com/fabric/v4/connections/53c89f1a-0be7-44a1-9c03-28059632a72d",  
    "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
    "name": "vd2other-sp-0425a",  
    "operation": {  
        "providerStatus": "PROVISIONING",  
        "equinixStatus": "PROVISIONING"  
    },  
    "order": {  
        "purchaseOrderNumber": "1-129105284100",  
        "billingTier": "Up to 1G"  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "x@gmail.com"  
            ]  
        }  
    ],  
    "changeLog": {  
        "createdBy": "fabricamcrh1",  
        "createdByFullName": "fabric amcrh1",  
        "createdByEmail": "x@gmail.com",  
        "createdDateTime": "2024-04-25T20:40:40.676Z",  
        "updatedBy": "fabricamcrh1",  
        "updatedByFullName": "fabric amcrh1",  
        "updatedByEmail": "x@gmail.com",  
        "updatedDateTime": "2024-04-25T20:40:40.677Z"  
    },  
    "bandwidth": 1000,  
    "redundancy": {  
        "group": "43009a55-87ee-4dff-8ae4-70ccb7c3d4e9",  
        "priority": "PRIMARY"  
    },  
    "aSide": {  
        "accessPoint": {  
            "interface": {  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
                "id": 5,  
                "type": "CLOUD"  
            },  
            "location": {  
                "metroCode": "DC"  
            },  
            "virtualDevice": {  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
                "type": "EDGE"  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "location": {  
                "metroCode": "DC"  
            },  
            "profile": {  
                "href": "https://api.equinix.com/fabric/v4/serviceProfiles/60ef0382-cdaa-44e7-bd36-b803731816b8",  
                "type": "L2_PROFILE",  
                "name": "Other Service Provider",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  
            }  
        }  
    }  
}

Monitoramento do status da conexão

Use o endpoint Obter conexão especificada para monitorar o status da conexão.

equinixStatus parameter values	providerStatus attribute values	Description
PROVISIONING	PROVISIONING	Connection request has not been sent to Oracle yet.
PROVISIONED	PROVISIONING	Connection establishment in progress.
PROVISIONED	PROVISIONED	Connection established.