API - Conectando-se ao AWS Direct Connect

Com Fabric e AWS Direct Connect, estabeleça uma conexão direta de camada 2 entre seus ativos colocated IBX e seus recursos Amazon Web Services (AWS). Use o API para criar a conexão a partir de uma porta, dispositivo Network Edge ou 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

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.
Determine suas informações do A-Side. Ou:
- Para determinar as informações das suas portas Equinix Fabric, envie uma GET solicitação ao /fabric/v4/portsterminal. Você precisa do(s) UUID(s) da porta e do tipo de protocolo de link (DOT1Q ou QINQ),
OU
- Recupere seu token de serviço A-Side ou tokens enviando uma GET solicitação ao /fabric/v4/serviceTokensendpoint. Você precisa do UUID do token. O token A-Side fornece as informações relevantes para configurar o A-Side da conexão.
OU
- Determine as informações do seu dispositivo Network Edge. Verifique seus dispositivos virtuais e clusters disponíveis enviando uma GET solicitação para o /ne/v1/devices terminal. Você precisa do(s) UUID(s) do dispositivo. Envie uma GET solicitação para o /ne/v1/devices/{device_id} terminal 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 suas informações de Fabric Cloud Router. Verifique seus roteadores de cloud disponíveis enviando uma POST solicitação para o /fabric/v4/routers/search terminal. Você precisa do UUID do roteador.
Identifique o perfil de serviço AWS Direct Connect e as informações de localização. Para obter mais informações sobre o perfil de serviço que você deve escolher, consulte a páginaVisão geral do AWS Direct Connect.
- UUID do AWS Direct Connect - 69ee618d-be52-468d-bc99-00566f2dd2b9
- UUID de alta capacidade AWS Direct Connect - de55ca94-df3b-4680-845f-6f7093f76bef
- UUID redundante AWS Direct Connect - 8b5cbdbd-53da-4d37-9bfc-cc988eb522f1
- AWS Direct Connect- Redundante de alta capacidade - ed48616a-c182-40b4-a462-a78ba812e961
Para encontrar as informações de localização, envie uma GET solicitação ao /fabric/v4/serviceProfiles/{service_profile_ID}terminal usando um dos IDS de perfil de serviço AWS Direct Connect. O metros objeto na resposta contém uma lista de mercados estratégicos Equinix e sua região AWS associada. Você precisa de ambos para criar uma conexão.
Identifique e valide o ID da sua conta Amazon. Faça login no AWS Management Console e localize o número da sua conta. Consulte a documentação do AWS para obter instruções sobre como encontrar o número da sua conta. Envie uma POST solicitação ao /fabric/v4/connections/validateterminal para verificar se o ID da sua conta AWS pode ser usado para criar uma conexão com o perfil de serviço selecionado no mercado estratégico específico.

Conexão de uma Porta DOT1Q

Para criar uma conexão da porta DOT1Q para o AWS, envie uma POST solicitação para o /fabric/v4/connections terminal. A conexão type é EVPL_VC.

Forneça suas informações de porta no aSideobjeto, incluindo:

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

Forneça os detalhes do AWS Direct Connect e os detalhes de localização no zSideobjeto, incluindo:

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

Especifique quaisquer outros detalhes de configuração da conexão, incluindo bandwidth e redundancy, no corpo da solicitação. Para obter uma lista completa de parâmetros e suas descrições, consulte a Referência 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 para o AWS, envie uma POST solicitação para o /fabric/v4/connections terminal. A conexão type é EVPL_VC.

Forneça suas informações de porta no aSideobjeto, incluindo:

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

Forneça os detalhes do AWS Direct Connect e os detalhes de localização no zSideobjeto, incluindo:

Definir accessPoint.type como SP.
Definir profile.type como L2_PROFILE.
Especifique o perfil de serviço AWS ao qual você está se conectando no profile.uuid.
Especifique o local estratégico da Equinix ao qual você está se conectando em location.metroCode.
Especifique a região do AWS associada ao mercado estratégico de Equinix em sellerRegion. Essas informações podem ser encontradas no /fabric/v4/serviceProfiles/{service_profile_ID}terminal. Consulte o endpoint depré-requisitos do API. Consulte Pré-requisitos do API para obter detalhes.
Defina authenticationKey como seu ID de 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": "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 A-Side para o AWS, envie uma POST solicitação para o /fabric/v4/connections terminal. A conexão type é EVPL_VC.

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

Forneça os detalhes do AWS Direct Connect e os detalhes de localização no zSideobjeto, incluindo:

Definir accessPoint.type como SP.
Definir profile.type como L2_PROFILE.
Especifique o perfil de serviço AWS ao qual você está se conectando no profile.uuid.
Especifique o local estratégico da Equinix ao qual você está se conectando em location.metroCode.
Especifique a região do AWS associada ao mercado estratégico de Equinix em sellerRegion. Essas informações podem ser encontradas no /fabric/v4/serviceProfiles/{service_profile_ID}terminal. Consulte o endpoint depré-requisitos do API. Consulte Pré-requisitos do API para obter detalhes.
Defina authenticationKey como seu ID de 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": "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 o AWS, envie uma POST solicitação para o /fabric/v4/connections terminal. A conexão type é EVPL_VC.

Defina seu dispositivo Network Edge no aSide objeto, incluindo:

accessPoint.type as VD
virtualDevice.type como EDGE
virtualDevice.uuid Como UUID do seu dispositivo

Forneça os detalhes do AWS Direct Connect e os detalhes de localização no zSideobjeto, incluindo:

Definir accessPoint.type como SP.
Definir profile.type como L2_PROFILE.
Especifique o perfil de serviço AWS ao qual você está se conectando no profile.uuid.
Especifique o local estratégico da Equinix ao qual você está se conectando em location.metroCode.
Especifique a região do AWS associada ao mercado estratégico de Equinix em sellerRegion. Essas informações podem ser encontradas no /fabric/v4/serviceProfiles/{service_profile_ID}terminal. Consulte o endpoint depré-requisitos do API. Consulte Pré-requisitos do API para obter detalhes.
Defina authenticationKey como seu ID de 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": "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 para o AWS, envie uma POST solicitação para o /fabric/v4/connections terminal. A conexão type é IP_VC.

Defina seu Fabric Cloud Router no aSideobjeto, incluindo:

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

Forneça os detalhes do AWS Direct Connect e os detalhes de localização no zSideobjeto, incluindo:

Definir accessPoint.type como SP.
Definir profile.type como L2_PROFILE.
Especifique o perfil de serviço AWS ao qual você está se conectando no profile.uuid.
Especifique o local estratégico da Equinix ao qual você está se conectando em location.metroCode.
Especifique a região do AWS associada ao mercado estratégico de Equinix em sellerRegion. Essas informações podem ser encontradas no /fabric/v4/serviceProfiles/{service_profile_ID}terminal. Consulte o endpoint depré-requisitos do API. Consulte Pré-requisitos do API para obter detalhes.
Defina authenticationKey como seu ID de 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>"
      ]
    }
  ]
}'

Monitoramento do status da conexão

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

`equinixStatus` valores de atributo	`providerStatus` valores de atributo	Estado do AWS Direct Connect	Descrição
`PROVISIONING`	`PROVISIONING`		A solicitação de conexão ainda não foi enviada para a AWS.
`PROVISIONED`	`PENDING_APPROVAL`	Pedido -> Solicitado	A conexão aguarda aceitação.
`PROVISIONED`	`PROVISIONING`	Pendente	Estabelecimento de conexão em andamento.
`PROVISIONED`	`PROVISIONED`	Pendente -> Disponível	A conexão foi aceita.

Pré-requisitos da API​

Conexão de uma Porta DOT1Q​

Conectando de uma Porta QINQ​

Conexão usando um token de serviço​

Conexão de um dispositivo de Network Edge​

Conexão a partir de um Fabric Cloud Router​

Monitoramento do status da conexão​

Pré-requisitos da API

Conexão de uma Porta DOT1Q

Conectando de uma Porta QINQ

Conexão usando um token de serviço

Conexão de um dispositivo de Network Edge

Conexão a partir de um Fabric Cloud Router

Monitoramento do status da conexão