API - Conectar 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 conectar-se a partir de um dispositivo virtual Network Edge, consulte Network Edge para 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 de API para obter instruções sobre como chamar a API OAuth para validar e autenticar suas credenciais.
Determine as informações do seu lado A. Ou:
- Recupere as informações das portas do Equinix Fabric usando a solicitação de API Obter todas as portas.
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.
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.
Escolha a localização do metrô do lado Z. Use a solicitação de API Obter todos os metrôs para encontrar todos os metrôs onde o Equinix Fabric está disponível e determinar a localização de destino.
Identifique as informações do perfil de serviço do Google Cloud Partner Interconnect. Mais informações sobre qual perfil de serviço você deve escolher estão na página Visão geral.
- Zona 1 - bd4570e2-d792-4a00-87f5-3bde040cdcd7
- Zona 2 - b97dacca-abe6-4e8c-8be1-fcdd1be1defe
Valide sua chave de autorização. Envie uma solicitação POST para o endpoint /fabric/v4/connections/validate para verificar se sua chave de emparelhamento pode ser usada para criar uma conexão com o perfil de serviço selecionado no metro especificado.

Conectando de uma porta DOT1Q

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

Forneça seus detalhes do GCP 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 ao qual você está se conectando em profile.uuid.
Especifique a localização Equinix Metro à qual você está se conectando em location.metroCode.
Defina authenticationKey como a sua chave de emparelhamento emitida pelo Google Cloud.

Assegurar que:

Se você estiver criando uma conexão onde a redundância é PRIMARY, a chave de emparelhamento termina em /1 e você está 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 onde a redundância é SECUNDÁRIA, a chave de emparelhamento termina em /2 e você está 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 de conexão 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:

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 com o Google Cloud Partner Interconnect, 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.
Defina 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 seus detalhes do GCP 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 ao qual você está se conectando em profile.uuid.
Especifique a localização Equinix Metro à qual você está se conectando em location.metroCode.
Defina authenticationKey como a sua chave de emparelhamento emitida pelo Google Cloud.

Assegurar que:

Se você estiver criando uma conexão onde a redundância é PRIMARY, a chave de emparelhamento termina em /1 e você está 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 onde a redundância é SECUNDÁRIA, a chave de emparelhamento termina em /2 e você está 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 de conexão 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:

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 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 GCP 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 ao qual você está se conectando em profile.uuid.
Especifique a localização Equinix Metro à qual você está se conectando em location.metroCode.
Defina authenticationKey como a sua chave de emparelhamento emitida pelo Google Cloud.

Assegurar que:

Se você estiver criando uma conexão onde a redundância é PRIMARY, a chave de emparelhamento termina em /1 e você está 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 onde a redundância é SECUNDÁRIA, a chave de emparelhamento termina em /2 e você está 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 de conexão 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:

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 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 GCP 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 ao qual você está se conectando em profile.uuid.
Especifique a localização Equinix Metro à qual você está se conectando em location.metroCode.
Defina authenticationKey como a sua chave de emparelhamento emitida pelo Google Cloud.

Assegurar que:

Se você estiver criando uma conexão onde a redundância é PRIMARY, a chave de emparelhamento termina em /1 e você está 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 onde a redundância é SECUNDÁRIA, a chave de emparelhamento termina em /2 e você está 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 de conexão 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:

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>"
      ]
    }
  ]
}'

Monitorando o status da conexão

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

`equinixStatus` parameter values	`providerStatus` attribute values	Google Status	Description
`PROVISIONING`	`PROVISIONING`		Connection request has not been sent to Googleyet.
`PROVISIONED`	`PENDING_APPROVAL`	Waiting for service provider.	Connection waiting for acceptance.
`PROVISIONED`	`PROVISIONING`	Activation needed -> Border Gateway Protocol (BGP) configuration required.	Connection establishment in progress.
`PROVISIONED`	`PROVISIONED`	Pending -> availability	Connection accepted by client.

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​

Monitorando o 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

Monitorando o status da conexão

Ativando a conexão