API - Conectarse a Google Cloud Platform

Establezca una conexión directa de capa 2 con Google Cloud Partner Interconnect utilizando un Fabric Port, Fabric Cloud Router o un token de servicio.

nota

Para obtener instrucciones sobre cómo conectarse desde un dispositivo virtual Network Edge, consulte Network Edge a Google Cloud Platform.

Requisitos previos

Autenticar - Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para OAuth2 autenticación. Consulte Autenticación API para obtener instrucciones sobre cómo llamar a la API OAuth para validar y autenticar sus credenciales.
Determine la información de su cara A. Cualquiera:
- Recupere la información de los puertos de Equinix Fabric mediante la solicitud API Get All Ports.
O
- Determine la información de su Fabric Cloud Router. Compruebe sus enrutadores en la nube disponibles enviando una solicitud POST al punto final /fabric/v4/routers/search. Necesita el UUID del enrutador.
O
- Recupere su token o tokens de servicio del lado a enviando una solicitud GET al punto final /fabric/v4/serviceTokens. Necesitará el UUID del token. El token del lado a proporciona la información relevante para configurar el lado a de la conexión.
Elija la ubicación del metro del lado Z. Utilice la solicitud API Get All Metros para encontrar todos los metros en los que Equinix Fabric está disponible y determinar la ubicación de destino.
Identifique la información del perfil de servicio de interconexión de socios de Google Cloud. Encontrará más información sobre qué perfil de servicio debe elegir en la página Overview.
- Zona 1 - bd4570e2-d792-4a00-87f5-3bde040cdcd7
- Zona 2 - b97dacca-abe6-4e8c-8be1-fcdd1be1defe
Valide su clave de autorización. Envíe una solicitud POST al punto final /fabric/v4/connections/validate para verificar que su clave de emparejamiento puede utilizarse para crear una conexión con el perfil de servicio seleccionado en el metro dado.

Conexión desde un puerto DOT1Q

Para crear una conexión desde su puerto DOT1Q a Google Cloud Partner Interconnect, envíe una solicitud POST al punto final /fabric/v4/connections. El tipo de conexión es EVPL_VC.

Proporcione la información de su puerto en el objeto aSide incluyendo:

accessPoint.type as COLO
Proporcione el UUID de su puerto a port.uuid.
Establezca linkProtocol.type como DOT1Q.
Proporcione el ID de la VLAN a linkProtocol.vlanTag.

Proporcione los datos de su GCP y los detalles de su ubicación en el objeto zSide, incluyendo:

Establezca accessPoint.type como SP.
Establezca profile.type como L2_PROFILE.
Especifique el perfil de servicio al que se está conectando en profile.uuid.
Especifique la ubicación de Equinix Metro a la que se está conectando en location.metroCode.
Establezca authenticationKey como su clave de emparejamiento emitida por Google Cloud.

Asegúrese de que:

Si está creando una conexión en la que la redundancia es PRIMARY que la clave de emparejamiento termine en /1 y está utilizando el perfil de servicio Google Cloud Partner Interconnect Zone 1 UUID bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Si está creando una conexión en la que la redundancia es SECUNDARIA que la clave de emparejamiento termine en /2 y está utilizando el perfil de servicio de interconexión de socios de Google Cloud Zona 2 UUID b97dacca-abe6-4e8c-8be1-fcdd1be1defe.
Si está creando conexiones redundantes, envíe dos solicitudes API, una por cada prioridad de redundancia.

Especifique cualquier otro detalle de configuración de la conexión, en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la Referencia API.

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

Conexión desde un puerto QINQ

Para crear una conexión desde su puerto QINQ a Google Cloud Partner Interconnect, envíe una solicitud POST al punto final /fabric/v4/connections. El tipo de conexión es EVPL_VC.

Proporcione la información de su puerto en el objeto aSide incluyendo:

accessPoint.type as COLO
Proporcione el UUID de su puerto a port.uuid.
Establezca linkProtocol.type como QINQ.
Proporcione el ID de la etiqueta interna a linkProtocol.vlanCTag.
Proporcione el ID de etiqueta exterior a linkProtocol.vlanSTag.

Proporcione los datos de su GCP y los detalles de su ubicación en el objeto zSide, incluyendo:

Establezca accessPoint.type como SP.
Establezca profile.type como L2_PROFILE.
Especifique el perfil de servicio al que se está conectando en profile.uuid.
Especifique la ubicación de Equinix Metro a la que se está conectando en location.metroCode.
Establezca authenticationKey como su clave de emparejamiento emitida por Google Cloud.

Asegúrese de que:

Si está creando una conexión en la que la redundancia es PRIMARY que la clave de emparejamiento termine en /1 y está utilizando el perfil de servicio Google Cloud Partner Interconnect Zone 1 UUID bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Si está creando una conexión en la que la redundancia es SECUNDARIA que la clave de emparejamiento termine en /2 y está utilizando el perfil de servicio de interconexión de socios de Google Cloud Zona 2 UUID b97dacca-abe6-4e8c-8be1-fcdd1be1defe.
Si está creando conexiones redundantes, envíe dos solicitudes API, una por cada prioridad de redundancia.

Especifique cualquier otro detalle de configuración de la conexión, en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la Referencia API.

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

Conexión desde un Fabric Cloud Router

Para crear una conexión desde su Fabric Cloud Router a AWS, envíe una solicitud POST al punto final /fabric/v4/connections. El tipo de conexión es IP_VC.

Defina su Fabric Cloud Router en el objeto aSide incluyendo:

Establezca accessPoint.type como CLOUD_ROUTER.
Establezca router.uuid como UUID de su router.

Proporcione los datos de su GCP y los detalles de su ubicación en el objeto zSide, incluyendo:

Establezca accessPoint.type como SP.
Establezca profile.type como L2_PROFILE.
Especifique el perfil de servicio al que se está conectando en profile.uuid.
Especifique la ubicación de Equinix Metro a la que se está conectando en location.metroCode.
Establezca authenticationKey como su clave de emparejamiento emitida por Google Cloud.

Asegúrese de que:

Si está creando una conexión en la que la redundancia es PRIMARY que la clave de emparejamiento termine en /1 y está utilizando el perfil de servicio Google Cloud Partner Interconnect Zone 1 UUID bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Si está creando una conexión en la que la redundancia es SECUNDARIA que la clave de emparejamiento termine en /2 y está utilizando el perfil de servicio de interconexión de socios de Google Cloud Zona 2 UUID b97dacca-abe6-4e8c-8be1-fcdd1be1defe.
Si está creando conexiones redundantes, envíe dos solicitudes API, una por cada prioridad de redundancia.

Especifique cualquier otro detalle de configuración de la conexión, en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la Referencia API.

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

Conexión mediante un token de servicio

Para crear una conexión utilizando un token de servicio del lado A con AWS, envíe una solicitud POST al punto final /fabric/v4/connections. El tipo de conexión es EVPL_VC.

Proporcione su UUID de token de servicio a en el objeto aSide. El token de servicio proporciona el resto de la información necesaria para establecer la conexión.

Proporcione los datos de su GCP y los detalles de su ubicación en el objeto zSide, incluyendo:

Establezca accessPoint.type como SP.
Establezca profile.type como L2_PROFILE.
Especifique el perfil de servicio al que se está conectando en profile.uuid.
Especifique la ubicación de Equinix Metro a la que se está conectando en location.metroCode.
Establezca authenticationKey como su clave de emparejamiento emitida por Google Cloud.

Asegúrese de que:

Si está creando una conexión en la que la redundancia es PRIMARY que la clave de emparejamiento termine en /1 y está utilizando el perfil de servicio Google Cloud Partner Interconnect Zone 1 UUID bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Si está creando una conexión en la que la redundancia es SECUNDARIA que la clave de emparejamiento termine en /2 y está utilizando el perfil de servicio de interconexión de socios de Google Cloud Zona 2 UUID b97dacca-abe6-4e8c-8be1-fcdd1be1defe.
Si está creando conexiones redundantes, envíe dos solicitudes API, una por cada prioridad de redundancia.

Especifique cualquier otro detalle de configuración de la conexión, en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la Referencia API.

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

Supervisión del estado de la conexión

Envíe una solicitud GET al punto final fabric/v4/connections/{connectionId} para supervisar el estado de la conexión.

`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.

Activar la conexión

Active la conexión virtual mediante Google Cloud Platform. Consulte la [documentación de Google Cloud para obtener instrucciones sobre cómo activar la conexión mediante la consola de Google Cloud Platform.

Requisitos previos​

Conexión desde un puerto DOT1Q​

Conexión desde un puerto QINQ​

Conexión desde un Fabric Cloud Router​

Conexión mediante un token de servicio​

Supervisión del estado de la conexión​

Activar la conexión​

Requisitos previos

Conexión desde un puerto DOT1Q

Conexión desde un puerto QINQ

Conexión desde un Fabric Cloud Router

Conexión mediante un token de servicio

Supervisión del estado de la conexión

Activar la conexión