API - Conecte-se ao Google Cloud Platform

Estabeleça uma conexão direta de camada 2 com o Google Cloud Partner Interconnect usando uma Fabric Port, um Fabric Cloud Router ou um token de serviço.

observação

Para obter instruções sobre como se conectar a partir de um dispositivo virtual Network Edge, consulte Network Edge ao Google Cloud Platform.

Pré-requisitos

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:
- Obtenha as informações das suas portas Equinix Fabric usando a solicitaçãoGet All Ports API.
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.
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.
Escolha o local do mercado estratégico Z-Side. Use a solicitaçãoGet All Metrôs API (Obter todos os mercadosestratégicos) para encontrar todos os mercados estratégicos onde o Equinix Fabric está disponível e determinar o local de destino.
Identifique as informações do perfil de serviço do Google Cloud Partner Interconnect. Para obter mais informações sobre qual perfil de serviço você deve escolher, consulte a páginaVisão geral.
- Zona 1 - bd4570e2-d792-4a00-87f5-3bde040cdcd7
- Zona 2 - b97dacca-abe6-4e8c-8be1-fcdd1be1defe
Valide sua chave de autorização. Envie uma POST solicitação ao /fabric/v4/connections/validateterminal para verificar se sua chave de emparelhamento pode ser usada para criar uma conexão com o perfil de serviço selecionado no mercado estratégico específico.

Conectando de uma porta DOT1Q

Para criar uma conexão da porta DOT1Q com o Google Cloud Partner Interconnect, 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
Definir linkProtocol.type como DOT1Q
Forneça o ID do VLAN para linkProtocol.vlanTag

Forneça os detalhes do GCP e os detalhes de localização no zSide objeto, incluindo:

Definir accessPoint.type como SP.
Definir profile.type como L2_PROFILE.
Especifique o perfil de serviço 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.
Defina authenticationKey como sua chave de emparelhamento emitida pelo Google Cloud.

Assegure-se de que:

Se você estiver criando uma conexão em que redundancy PRIMARYa chave de emparelhamento termina /1e estiver usando o UUID do perfil de serviço da Zona 1 do Google Cloud Partner Interconnect bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Se você estiver criando uma conexão em que redundancy SECONDARYa chave de emparelhamento termina /2e estiver usando o UUID do perfil de serviço da Zona 2 do Google Cloud Partner Interconnect b97dacca-abe6-4e8c-8be1-fcdd1be1defe.
Se você estiver criando conexões redundantes, envie duas solicitações de API, uma para cada prioridade de redundância.

Especifique quaisquer outros detalhes de configuração da conexão 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:

POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<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": {
        "uuid": "<gcp_service_profile_uuid>"
      },
      "location": {
        "metroCode": "<metro_code>"
      },
      "authenticationKey": "<gcp_pairing_key>",
      "sellerRegion": "<gcp_region>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<po_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>",
        "<contact_email>"
      ]
    }
  ]
}'

Conectando de uma Porta QINQ

Para criar uma conexão da sua porta QINQ para o Google Cloud Partner Interconnect, 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
Definir 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 GCP e os detalhes de localização no zSide objeto, incluindo:

Definir accessPoint.type como SP.
Definir profile.type como L2_PROFILE.
Especifique o perfil de serviço 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.
Defina authenticationKey como sua chave de emparelhamento emitida pelo Google Cloud.

Assegure-se de que:

Se você estiver criando uma conexão em que redundancy PRIMARYa chave de emparelhamento termina /1e estiver usando o UUID do perfil de serviço da Zona 1 do Google Cloud Partner Interconnect bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Se você estiver criando uma conexão em que redundancy SECONDARYa chave de emparelhamento termina /2e estiver usando o UUID do perfil de serviço da Zona 2 do Google Cloud Partner Interconnect b97dacca-abe6-4e8c-8be1-fcdd1be1defe.
Se você estiver criando conexões redundantes, envie duas solicitações de API, uma para cada prioridade de redundância.

Especifique quaisquer outros detalhes de configuração da conexão 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:

POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<connection_name>",
  "bandwidth": <connection_speed>
  "redundancy": {
    "priority: "<priority_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "COLO",
      "port": {
        "uuid": "<port_uuid>"
      },
      "linkProtocol": {
        "type": "QINQ",
        "vlanCTag": <vlan_id>,
        "vlanSTag": <vlan_id>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "uuid": "<gcp_service_profile_uuid>"
      },
      "location": {
        "metroCode": "<metro_code>"
      },
      "authenticationKey": "<gcp_pairing_key>",
      "sellerRegion": "<gcp_region>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<po_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>",
        "<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 GCP e os detalhes de localização no zSide objeto, incluindo:

Definir accessPoint.type como SP.
Definir profile.type como L2_PROFILE.
Especifique o perfil de serviço 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.
Defina authenticationKey como sua chave de emparelhamento emitida pelo Google Cloud.

Assegure-se de que:

Se você estiver criando uma conexão em que redundancy PRIMARYa chave de emparelhamento termina /1e estiver usando o UUID do perfil de serviço da Zona 1 do Google Cloud Partner Interconnect bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Se você estiver criando uma conexão em que redundancy SECONDARYa chave de emparelhamento termina /2e estiver usando o UUID do perfil de serviço da Zona 2 do Google Cloud Partner Interconnect b97dacca-abe6-4e8c-8be1-fcdd1be1defe.
Se você estiver criando conexões redundantes, envie duas solicitações de API, uma para cada prioridade de redundância.

Especifique quaisquer outros detalhes de configuração da conexão 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:

POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "IP_VC",
  "name": "<connection_name>",
  "bandwidth": <connection_speed>
  "redundancy": {
    "priority: "<priority_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "CLOUD_ROUTER",
      "router": {
        "uuid": "<cloud_router_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "uuid": "<gcp_service_profile_uuid>"
      },
      "location": {
        "metroCode": "<metro_code>"
      },
      "authenticationKey": "<gcp_pairing_key>",
      "sellerRegion": "<gcp_region>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<po_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>",
        "<contact_email>"
      ]
    }
  ]
}'

Conectando 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 GCP e os detalhes de localização no zSide objeto, incluindo:

Definir accessPoint.type como SP.
Definir profile.type como L2_PROFILE.
Especifique o perfil de serviço 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.
Defina authenticationKey como sua chave de emparelhamento emitida pelo Google Cloud.

Assegure-se de que:

Se você estiver criando uma conexão em que redundancy PRIMARYa chave de emparelhamento termina /1e estiver usando o UUID do perfil de serviço da Zona 1 do Google Cloud Partner Interconnect bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Se você estiver criando uma conexão em que redundancy SECONDARYa chave de emparelhamento termina /2e estiver usando o UUID do perfil de serviço da Zona 2 do Google Cloud Partner Interconnect b97dacca-abe6-4e8c-8be1-fcdd1be1defe.
Se você estiver criando conexões redundantes, envie duas solicitações de API, uma para cada prioridade de redundância.

Especifique quaisquer outros detalhes de configuração da conexão 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:

POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<connection_name>",
  "bandwidth": <connection_speed>
  "redundancy": {
    "priority: "<priority_code>"
  },
  "aSide": {
    "serviceToken": {
      "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "uuid": "<gcp_service_profile_uuid>"
      },
      "location": {
        "metroCode": "<metro_code>"
      },
      "authenticationKey": "<gcp_pairing_key>",
      "sellerRegion": "<gcp_region>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<po_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>",
        "<contact_email>"
      ]
    }
  ]
}'

Monitoramento do status da conexão

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

`equinixStatus` valores de parâmetro	`providerStatus` valores de atributo	Status do Google	Descrição
`PROVISIONING`	`PROVISIONING`		A solicitação de conexão ainda não foi enviada ao Google.
`PROVISIONED`	`PENDING_APPROVAL`	Aguardando o provedor de serviços.	Aguardando conexão.
`PROVISIONED`	`PROVISIONING`	Ativação necessária -> Configuração do Border Gateway Protocol (BGP) requerida.	Estabelecimento de conexão em andamento.
`PROVISIONED`	`PROVISIONED`	Pendente -> disponibilidade	Conexão aceita pelo cliente.

Ativando a conexão

Ative a conexão virtual usando o Google Cloud Platform. Consulte a documentação do Google Cloud para obter instruções sobre como ativar a conexão usando o Console do Google Cloud Platform.

Pré-requisitos​

Conectando de uma porta DOT1Q​

Conectando de uma Porta QINQ​

Conexão a partir de um Fabric Cloud Router​

Conectando usando um Token de Serviço​

Monitoramento do status da conexão​

Ativando a conexão​

Pré-requisitos

Conectando de uma porta DOT1Q

Conectando de uma Porta QINQ

Conexão a partir de um Fabric Cloud Router

Conectando usando um Token de Serviço

Monitoramento do status da conexão

Ativando a conexão