API - Conexão ao AWS Direct Connect

Estabeleça uma conexão direto de camada 2 entre seus ativos IBX alocado e seus recursos da Amazon Web Services (AWS) com o Fabric e o AWS Direct Connect. Use a API para criar a conexão a partir de uma Porta, um dispositivo de Network Edge ou um Fabric Cloud Router.

Se você tiver um token de serviço fornecido pela AWS, consulte Conectar-se a um destino usando um token de serviço.

Pré-requisitos da API

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

   • Determine as informações das portas do seu Equinix Fabric enviando uma solicitação GET para o endpoint /fabric/v4/ports. Você precisa do(s) UUID(s) da(s) porta(s) e do tipo de protocolo de link (DOT1Q ou QINQ).

   OU

   • Recupere seu(s) token(s) de serviço do lado A enviando uma solicitação GET para o endpoint /fabric/v4/serviceTokens. Você precisa do UUID do token. O token do lado A fornece as informações relevantes para configurar o lado A da conexão.

   OU

   • Determine as informações do seu dispositivo de borda de rede. Verifique seus dispositivos virtuais e clusters disponíveis enviando uma solicitação GET para o endpoint /ne/v1/devices. Você precisa do(s) UUID(s) do(s) dispositivo(s). Envie uma solicitação GET para o endpoint /ne/v1/devices/{device_id} para obter as especificações de um dispositivo. Você pode escolher qualquer interface disponível no dispositivo para sua conexão. Se você não especificar uma, a conexão será atribuída automaticamente à próxima interface disponível.

   OU

   • Determine as informações do seu roteador Fabric Cloud. Verifique seus roteadores em nuvem disponíveis enviando uma solicitação POST para o endpoint /fabric/v4/routers/search. Você precisa do UUID do roteador.

3. Identifique o perfil de serviço e as informações de localização do AWS Direct Connect . Mais informações sobre qual perfil de serviço você deve escolher estão na página Visão geral do AWS Direct Connect .

   • UUID do AWS Direct Connect - 69ee618d-be52-468d-bc99-00566f2dd2b9
   • UUID de alta capacidade do AWS Direct Connect - de55ca94-df3b-4680-845f-6f7093f76bef
   • UUID redundante do AWS Direct Connect - 8b5cbdbd-53da-4d37-9bfc-cc988eb522f1
   • AWS Direct Connect - Alta Capacidade Redundante - ed48616a-c182-40b4-a462-a78ba812e961

   Para obter as informações de localização, envie uma solicitação GET para o endpoint /fabric/v4/serviceProfiles/{service_profile_ID} usando um dos IDs de perfil de serviço do AWS Direct Connect. O objeto metros na resposta contém uma lista de Metros da Equinix e suas respectivas regiões da AWS. Você precisa de ambos para criar uma conexão.

4. Identifique e valide seu ID de conta da Amazon. Faça login no Console de Gerenciamento da AWS e localize o número da sua conta. Consulte a [documentação da AWS para obter instruções sobre como encontrar o número da sua conta. Envie uma solicitação POST para o endpoint /fabric/v4/connections/validate para verificar se o seu ID de conta da AWS pode ser usado para criar uma conexão com o perfil de serviço selecionado na região metropolitana especificada.

Conexão de uma Porta DOT1Q

Para criar uma conexão da sua porta DOT1Q com a AWS, envie uma solicitação POST para o endpoint /fabric/v4/connections. O tipo de conexão é EVPL_VC.

Forneça as informações da sua porta no objeto aSide, incluindo:

• accessPoint.type as COLO
• Forneça o UUID da sua porta para port.uuid.
• linkProtocol.type como DOT1Q
• Forneça o ID da VLAN para linkProtocol.vlanTag.

Forneça seus detalhes do AWS Direct Connect e detalhes de localização no objeto zSide, incluindo:

• Defina accessPoint.type como SP.
• Defina profile.type como L2_PROFILE.
• Especifique o perfil de serviço da AWS ao qual você está se conectando em profile.uuid.
• Especifique a localização Equinix Metro à qual você está se conectando em location.metroCode.
• Especifique a região da AWS associada ao Equinix Metro em sellerRegion. Essas informações podem ser encontradas no endpoint /fabric/v4/serviceProfiles/{service_profile_ID}. Consulte o endpoint Pré-requisitos da API para obter mais detalhes.
• Defina authenticationKey como o seu ID de conta da AWS.

Especifique quaisquer outros detalhes de configuração de conexão, incluindo largura de banda e redundância, no corpo da solicitação. Para obter uma lista completa dos parâmetros e suas descrições, consulte a Referência da 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": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "COLO",
      "port": {
        "uuid": "<port_uuid>"
      },
      "linkProtocol": {
        "type": "DOT1Q",
        "vlanTag": <vlan_ID>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}'

Conectando de uma Porta QINQ

Para criar uma conexão da sua porta QINQ com a AWS, envie uma solicitação POST para o endpoint /fabric/v4/connections. O tipo de conexão é EVPL_VC.

Forneça as informações da sua porta no objeto aSide, incluindo:

• Defina accessPoint.type como COLO.
• Forneça o UUID da sua porta para port.uuid.
• linkProtocol.type as QINQ
• Forneça o ID da tag interna para linkProtocol.vlanCTag.
• Forneça o ID da tag externa para linkProtocol.vlanSTag.

Forneça seus detalhes do AWS Direct Connect e detalhes de localização no objeto zSide, incluindo:

• Defina accessPoint.type como SP.
• Defina profile.type como L2_PROFILE.
• Especifique o perfil de serviço da AWS ao qual você está se conectando em profile.uuid.
• Especifique a localização Equinix Metro à qual você está se conectando em location.metroCode.
• Especifique a região da AWS associada ao Equinix Metro em sellerRegion. Essas informações podem ser encontradas no endpoint /fabric/v4/serviceProfiles/{service_profile_ID}. Consulte o endpoint Pré-requisitos da API para obter mais detalhes.
• Defina authenticationKey como o seu ID de conta da AWS.

Especifique quaisquer outros detalhes de configuração de conexão, incluindo largura de banda e redundância, no corpo da solicitação. Para obter uma lista completa dos parâmetros e suas descrições, consulte a Referência da 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": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "COLO",
      "port": {
        "uuid": "<port_uuid>"
      },
      "linkProtocol": {
        "type": "QINQ",
        "vlanCTag": <inner_tag_ID>,
        "vlanSTag": <outer_tag_ID>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}

Conexão usando um token de serviço

Para criar uma conexão usando um token de serviço do lado A para a AWS, envie uma solicitação POST para o endpoint /fabric/v4/connections. O tipo de conexão é EVPL_VC.

Forneça o UUID do seu token de serviço no objeto aSide. O token de serviço fornece todas as outras informações necessárias para estabelecer a conexão.

Forneça seus detalhes do AWS Direct Connect e detalhes de localização no objeto zSide, incluindo:

• Defina accessPoint.type como SP.
• Defina profile.type como L2_PROFILE.
• Especifique o perfil de serviço da AWS ao qual você está se conectando em profile.uuid.
• Especifique a localização Equinix Metro à qual você está se conectando em location.metroCode.
• Especifique a região da AWS associada ao Equinix Metro em sellerRegion. Essas informações podem ser encontradas no endpoint /fabric/v4/serviceProfiles/{service_profile_ID}. Consulte o endpoint Pré-requisitos da API para obter mais detalhes.
• Defina authenticationKey como o seu ID de conta da AWS.

Especifique quaisquer outros detalhes de configuração de conexão, incluindo largura de banda e redundância, no corpo da solicitação. Para obter uma lista completa dos parâmetros e suas descrições, consulte a Referência da 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": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "serviceToken": {
      "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}

Conexão de um dispositivo de Network Edge

Para criar uma conexão do seu dispositivo Network Edge com a AWS, envie uma solicitação POST para o endpoint /fabric/v4/connections. O tipo de conexão é EVPL_VC.

Defina seu dispositivo de borda de rede no objeto aSide, incluindo:

• accessPoint.type as VD
• virtualDevice.type as EDGE
• virtualDevice.uuid as your device's UUID

Forneça seus detalhes do AWS Direct Connect e detalhes de localização no objeto zSide, incluindo:

• Defina accessPoint.type como SP.
• Defina profile.type como L2_PROFILE.
• Especifique o perfil de serviço da AWS ao qual você está se conectando em profile.uuid.
• Especifique a localização Equinix Metro à qual você está se conectando em location.metroCode.
• Especifique a região da AWS associada ao Equinix Metro em sellerRegion. Essas informações podem ser encontradas no endpoint /fabric/v4/serviceProfiles/{service_profile_ID}. Consulte o endpoint Pré-requisitos da API para obter mais detalhes.
• Defina authenticationKey como o seu ID de conta da AWS.

Especifique quaisquer outros detalhes de configuração de conexão, incluindo largura de banda e redundância, no corpo da solicitação. Para obter uma lista completa dos parâmetros e suas descrições, consulte a Referência da 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": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "VD",
      "virtualDevice": {
        "type": "EDGE",
        "uuid": "<device_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}'

Conexão a partir de um Fabric Cloud Router

Para criar uma conexão do seu Fabric Cloud Router com a AWS, envie uma solicitação POST para o endpoint /fabric/v4/connections. O tipo de conexão é IP_VC.

Defina seu roteador Fabric Cloud no objeto aSide, incluindo:

• Defina accessPoint.type como CLOUD_ROUTER.
• Defina router.uuid como o UUID do seu roteador.

Forneça seus detalhes do AWS Direct Connect e detalhes de localização no objeto zSide, incluindo:

• Defina accessPoint.type como SP.
• Defina profile.type como L2_PROFILE.
• Especifique o perfil de serviço da AWS ao qual você está se conectando em profile.uuid.
• Especifique a localização Equinix Metro à qual você está se conectando em location.metroCode.
• Especifique a região da AWS associada ao Equinix Metro em sellerRegion. Essas informações podem ser encontradas no endpoint /fabric/v4/serviceProfiles/{service_profile_ID}. Consulte o endpoint Pré-requisitos da API para obter mais detalhes.
• Defina authenticationKey como o ID da sua conta AWS.

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": "IP_VC",
  "name": "<your_connection_name>",
    "bandwidth": <connection_speed>,
    "redundancy": {
      "priority": "<redundancy_code>"
    },
  "aSide": {
    "accessPoint": {
      "type": "CLOUD_ROUTER",
      "router": {
        "uuid": "<cloud_router_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}'

Monitorando o status da conexão

Envie uma solicitação GET para o endpoint fabric/v4/connections/{connection_id} para monitorar o status da conexão.

equinixStatus attribute values	providerStatus attribute values	AWS Direct Connect State	Description
PROVISIONING	PROVISIONING		Connection request has not been sent to AWS yet.
PROVISIONED	PENDING_APPROVAL	Ordering -> Requested	The connection awaits for acceptance.
PROVISIONED	PROVISIONING	Pending	Connection establishment in progress.
PROVISIONED	PROVISIONED	Pending -> Available	The connection has been accepted.