Ir para o conteúdo principal

Conectar-se a uma rede

Estabeleça uma conexão direto e de baixa latência entre suas redes, portas e dispositivos virtuais.

Pré-requisitos​

  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. Obtenha as informações da sua rede Fabric - envie uma solicitação POST para o endpoint fabric/v4/networks/search para pesquisar e recuperar uma lista das suas redes disponíveis.

  3. Determine suas informações de Porta ou dispositivo virtual.

    • Recupere as informações das portas do Equinix Fabric usando o endpoint Obter todas as portas. Para encontrar informações sobre uma porta específica, use o endpoint Obter porta específica.

    • Determine as informações do seu dispositivo de borda de rede. Você precisa de um dispositivo virtual/dispositivo redundante/cluster Equinix provisionado com uma licença registrada. Verifique seus dispositivos virtuais e clusters disponíveis chamando 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 se você não especificar uma.

Criando uma conexão de uma Porta marcada para uma rede EVPLAN​

Para criar uma conexão de uma porta marcada para uma rede EVPLAN, 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
MethodPOST
Endpoint/fabric/v4/connections
HeadersAuthorization, Content-Type
Path ParametersNot applicable
Query ParametersNot applicable
Body Parameterstype, name, order, bandwidth, aSide, zSide, notifications, redundancy

Para validar esta solicitação com segurança em produção sem criar uma conexão, consulte Testando em Produção (Simulação de API).

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": "EVPLAN_VC",  
  "name": "MY-EVPLAN-CONNECTION-1",  
  "bandwidth": 1000,  
  "aSide": {  
    "accessPoint": {  
      "type": "COLO",  
      "port": {  
        "uuid": "9127bb72-5f4f-4517-be74-3af7ce612687"  
      },  
      "linkProtocol": {  
        "type": "DOT1Q",  
        "vlanTag": 300  
      }  
    }  
  },  
  "zSide": {  
    "accessPoint": {  
      "type": "NETWORK",  
      "network": {  
        "uuid": "25f8884e-85e3-4eaa-8ea9-a7ad2ca5b3c2"  
      }  
    }  
  },  
  "order": {  
    "purchaseOrderNumber": "1-129105284100"  
  },  
  "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.

Exemplo de resposta:

{  
"type": "EVPLAN_VC",  
"href": "https://uat2api.npclouda.equinix.com/fabric/v4/connections/01df5124-eed1-4a30-89bb-240c33d5cd12",  
"uuid": "01df5124-eed1-4a30-89bb-240c33d5cd12",  
"name": "test2",  
"operation": {  
    "providerStatus": "NOT_AVAILABLE",  
    "equinixStatus": "PROVISIONING"  
},  
"order": {  
    "billingTier": "Up to 50 MB"  
},  
"notifications": [  
    {  
    "type": "ALL",  
    "emails": [  
        "1eqxnfvuser1@equinix.com"  
    ]  
    }  
],  
"changeLog": {  
    "createdBy": "eqxnfvuser1",  
    "createdByFullName": "eqxnfvuser eqxnfvuser",  
    "createdByEmail": "1eqxnfvuser1@equinix.com",  
    "createdDateTime": "2023-03-27T18:29:53.117Z",  
    "updatedBy": "eqxnfvuser1",  
    "updatedByFullName": "eqxnfvuser eqxnfvuser",  
    "updatedByEmail": "1eqxnfvuser1@equinix.com",  
    "updatedDateTime": "2023-03-27T18:29:53.117Z"  
},  
"bandwidth": 50,  
"redundancy": {  
    "priority": "PRIMARY",  
    "group": "7a58dd05-f46d-4b1d-a154-2e85c396ea63"  
},  
"aSide": {  
    "accessPoint": {  
    "location": {  
        "metroCode": "DC"  
    },  
    "port": {  
        "type": "XF_PORT",  
        "href": "https://uat2api.npclouda.equinix.com/fabric/v4/ports/e569f0bb-96d5-6d5e-92e0-387a5c00a379",  
        "uuid": "e569f0bb-96d5-6d5e-92e0-387a5c00a379",  
        "name": "eqx-nfv-DC5-L-Dot1q-STD-Pri-1G-JP-2"  
    },  
    "linkProtocol": {  
        "type": "DOT1Q",  
        "vlanTag": 44  
    }  
    }  
},  
"zSide": {  
    "accessPoint": {  
    "network": {  
        "href": "https://uat2api.npclouda.equinix.com/fabric/v4/networks/ecc81fe0-7a96-4e08-94f2-0ab52fae662b",  
        "uuid": "ecc81fe0-7a96-4e08-94f2-0ab52fae662b",  
        "name": "EVPLAN-AMER-1",  
        "platformUuid": "52c6ec8b-4aad-4167-be6d-1972a12d1b83",  
        "state": "ACTIVE",  
        "type": "EVPLAN",  
        "scope": "REGIONAL",  
        "location": {  
        "region": "AMER"  
        }  
    }  
    }  
}  
}

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.

Criando uma conexão de uma Porta não marcada para uma rede EPLAN​

Para criar uma conexão de uma porta não etiquetada para uma rede EPLAN, 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.

curl -X  
POST 'https://api.equinix.com/fabric/v4/connections'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '  
{  
  "type": "EPLAN_VC",  
  "name": "MY-EPLAN-CONNECTION-1",  
  "bandwidth": 1000,  
  "aSide": {  
    "accessPoint": {  
      "type": "COLO",  
      "port": {  
        "uuid": "9127bb72-5f4f-4517-be74-3af7ce612687"  
      }  
    }  
  },  
  "zSide": {  
    "accessPoint": {  
      "type": "NETWORK",  
      "network": {  
        "uuid": "25f8884e-85e3-4eaa-8ea9-a7ad2ca5b3c2"  
      }  
    }  
  },  
  "order": {  
    "purchaseOrderNumber": "1-129105284100"  
  },  
  "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.

Criando uma conexão de um dispositivo virtual para uma rede EVPLAN​

Para criar uma conexão de um dispositivo virtual para a rede EVPLAN, 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.

curl -X  
POST 'https://api.equinix.com/fabric/v4/connections'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '  
{  
  "type": "EVPLAN_VC",  
  "name": "MY-VD-EVPLAN-CONNECTION-1",  
  "bandwidth": 1000,  
  "aSide": {  
    "accessPoint": {  
      "type": "VD",  
      "virtualDevice": {  
        "type": "EDGE",  
        "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"  
      },  
      "interface": {  
        "type": "NETWORK",  
        "id": 7  
      }  
    }  
  },  
  "zSide": {  
    "accessPoint": {  
      "type": "NETWORK",  
      "network": {  
        "uuid": "25f8884e-85e3-4eaa-8ea9-a7ad2ca5b3c2"  
      }  
    }  
  },  
  "order": {  
    "purchaseOrderNumber": "1-129105284100"  
  },  
  "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.

Esta página foi útil?