# 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. ![](https://docs.equinix.com/pt-BR/assets/images/connectToGoogle-73a150d957737a8b28aab08b1ac4127d.png) > **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](https://docs.equinix.com/pt-BR/fabric-marketplace/connecting-to-service-provider/gcp/fabric-gcp-googleqc.md). ## Pré-requisitos[​](#pré-requisitos "Link direto para Pré-requisitos") 1. Autenticar - Envie suas credenciais de usuário, ID do cliente e segredo do cliente para OAuth2. autenticação. Consulte [Autenticação API](https://docs.equinix.com/pt-BR/equinix-api/api-authentication.md) para obter instruções sobre como chamar o OAuth API para validar e autenticar suas credenciais. 2. Determine suas informações do A-Side. Ou: * Obtenha as informações das suas portas Equinix Fabric usando a solicitação[Get All Ports](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/ports/getports.md) 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`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/cloud-routers/searchcloudrouters.md) 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/serviceTokens`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Tokens/operation/getServiceTokens)endpoint. Você precisa do UUID do token. O token A-Side fornece as informações relevantes para configurar o A-Side da conexão. 3. Escolha o local do mercado estratégico Z-Side. Use a solicitação[Get All Metrôs](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/metros/getmetros.md) API ([Obter todos os](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/metros/getmetros.md) mercados[estratégicos](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/metros/getmetros.md)) para encontrar todos os mercados estratégicos onde o Equinix Fabric está disponível e determinar o local de destino. 4. 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ágina[Visão geral](https://docs.equinix.com/pt-BR/fabric-marketplace/connecting-to-service-provider/gcp/gcp-interconnect-overview.md#redundancy-and-service-profiles). * Zona 1 - `bd4570e2-d792-4a00-87f5-3bde040cdcd7` * Zona 2 - `b97dacca-abe6-4e8c-8be1-fcdd1be1defe` 5. Valide sua chave de autorização. Envie uma `POST` solicitação ao [`/fabric/v4/connections/validate`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/validateconnections.md)terminal 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[​](#conectando-de-uma-porta-dot1q "Link direto para 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`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) terminal. A conexão `type` é `EVPL_VC`. Forneça suas informações de porta no `aSide`objeto, 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` `PRIMARY`a chave de emparelhamento termina `/1`e 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` `SECONDARY`a chave de emparelhamento termina `/2`e 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](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) . Exemplo de solicitação cURL: ``` POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{ "type": "EVPL_VC", "name": "", "bandwidth": , "redundancy": { "priority": "" }, "aSide": { "accessPoint": { "type": "COLO", "port": { "uuid": "" }, "linkProtocol": { "type": "DOT1Q", "vlanTag": } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "uuid": "" }, "location": { "metroCode": "" }, "authenticationKey": "", "sellerRegion": "" } }, "order": { "purchaseOrderNumber": "" }, "notifications": [ { "type": "ALL", "emails": [ "", "" ] } ] }' ``` ## Conectando de uma Porta QINQ[​](#conectando-de-uma-porta-qinq "Link direto para 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`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) terminal. A conexão `type` é `EVPL_VC`. Forneça suas informações de porta no `aSide`objeto, 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` `PRIMARY`a chave de emparelhamento termina `/1`e 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` `SECONDARY`a chave de emparelhamento termina `/2`e 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](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) . Exemplo de solicitação cURL: ``` POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{ "type": "EVPL_VC", "name": "", "bandwidth": "redundancy": { "priority: "" }, "aSide": { "accessPoint": { "type": "COLO", "port": { "uuid": "" }, "linkProtocol": { "type": "QINQ", "vlanCTag": , "vlanSTag": } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "uuid": "" }, "location": { "metroCode": "" }, "authenticationKey": "", "sellerRegion": "" } }, "order": { "purchaseOrderNumber": "" }, "notifications": [ { "type": "ALL", "emails": [ "", "" ] } ] }' ``` ## Conexão a partir de um Fabric Cloud Router[​](#conexão-a-partir-de-um-fabric-cloud-router "Link direto para 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`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) terminal. A conexão `type` é `IP_VC`. Defina seu Fabric Cloud Router no `aSide`objeto, 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` `PRIMARY`a chave de emparelhamento termina `/1`e 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` `SECONDARY`a chave de emparelhamento termina `/2`e 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](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) . Exemplo de solicitação cURL: ``` POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{ "type": "IP_VC", "name": "", "bandwidth": "redundancy": { "priority: "" }, "aSide": { "accessPoint": { "type": "CLOUD_ROUTER", "router": { "uuid": "" } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "uuid": "" }, "location": { "metroCode": "" }, "authenticationKey": "", "sellerRegion": "" } }, "order": { "purchaseOrderNumber": "" }, "notifications": [ { "type": "ALL", "emails": [ "", "" ] } ] }' ``` ## Conectando usando um Token de Serviço[​](#conectando-usando-um-token-de-serviço "Link direto para 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`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) terminal. A conexão `type` é `EVPL_VC`. Forneça o UUID do token de serviço para no `aSide`objeto. 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` `PRIMARY`a chave de emparelhamento termina `/1`e 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` `SECONDARY`a chave de emparelhamento termina `/2`e 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](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md) . Exemplo de solicitação cURL: ``` POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{ "type": "EVPL_VC", "name": "", "bandwidth": "redundancy": { "priority: "" }, "aSide": { "serviceToken": { "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4" } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "uuid": "" }, "location": { "metroCode": "" }, "authenticationKey": "", "sellerRegion": "" } }, "order": { "purchaseOrderNumber": "" }, "notifications": [ { "type": "ALL", "emails": [ "", "" ] } ] }' ``` ## Monitoramento do status da conexão[​](#monitoramento-do-status-da-conexão "Link direto para Monitoramento do status da conexão") Envie uma `GET` solicitação ao [`fabric/v4/connections/{connectionId}`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/getconnectionbyuuid.md)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[​](#ativando-a-conexão "Link direto para Ativando a conexão") Ative a conexão virtual usando o Google Cloud Platform. Consulte [a documentação do Google Cloud](https://console.cloud.google.com/) para obter instruções sobre como ativar a conexão usando o Console do Google Cloud Platform.