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 de 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 de API para obtener instrucciones sobre cómo llamar a OAuth API para validar y autenticar sus credenciales.
Determine su información de A-Side. O bien:
- Recupere la información de sus puertos de Equinix Fabric con la solicitudGet All Ports API.
O
- Determina la información de tu Fabric Cloud Router. Compruebe sus enrutadores en la nube disponibles enviando una POST solicitud al /fabric/v4/routers/search punto final. Necesita el UUID del router.
O
- Recupere su token o tokens de servicio de A-Side enviando una GET solicitud al /fabric/v4/serviceTokens punto final. Necesita el UUID del token. El token de A-Side proporciona la información relevante para configurar el A-Side de la conexión.
Elija la ubicación del área metropolitana de Z-Side. Utilice la solicitudGet all Metro API para buscar todas las áreas metropolitanas en las que Equinix Fabric está disponible y determinar la ubicación de destino.
Identifique la información del perfil de servicio de Google Cloud Partner Interconnect. Más información sobre el perfil de servicio que debe elegir se encuentra en la páginaDescripción general.
- Zona 1 - bd4570e2-d792-4a00-87f5-3bde040cdcd7
- Zona 2 - b97dacca-abe6-4e8c-8be1-fcdd1be1defe
Valide su clave de autorización. Envíe una POST solicitud al /fabric/v4/connections/validate punto final para verificar que su clave de emparejamiento se puede utilizar para crear una conexión con el perfil de servicio seleccionado en el área metropolitana determinada.

Conexión desde un puerto DOT1Q

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

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

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

Proporcione los detalles de su GCP y los detalles de la ubicación en el zSide objeto, incluidos los siguientes:

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

Asegúrese de que:

Si va a crear una conexión en la que redundancytermina la clave de emparejamiento /1IS PRIMARYy está utilizando el UUID del perfil de servicio de Google Cloud Partner Interconnect Zone 1 bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Si está creando una conexión en la que redundancytermina la clave de emparejamiento /2IS SECONDARYy está utilizando el perfil de servicio UUID de la zona 2 de interconexión de socios de Google Cloud 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 conexión en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la referencia de 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 de QINQ a Google Cloud Partner Interconnect, envíe una POST solicitud al /fabric/v4/connections punto final. La conexión type es EVPL_VC.

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

accessPoint.type as COLO
Proporcione el UUID de su puerto a port.uuid
Establecer linkProtocol.type como QINQ
Proporcione el ID de etiqueta interno a linkProtocol.vlanCTag
Proporcione el ID de la etiqueta externa a linkProtocol.vlanSTag

Proporcione los detalles de su GCP y los detalles de la ubicación en el zSide objeto, incluidos los siguientes:

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

Asegúrese de que:

Si va a crear una conexión en la que redundancytermina la clave de emparejamiento /1IS PRIMARYy está utilizando el UUID del perfil de servicio de Google Cloud Partner Interconnect Zone 1 bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Si está creando una conexión en la que redundancytermina la clave de emparejamiento /2IS SECONDARYy está utilizando el perfil de servicio UUID de la zona 2 de interconexión de socios de Google Cloud 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 conexión en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la referencia de 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 POST solicitud al /fabric/v4/connections punto final. La conexión type es IP_VC.

Defina su Fabric Cloud Router en el aSide objeto incluyendo:

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

Proporcione los detalles de su GCP y los detalles de la ubicación en el zSide objeto, incluidos los siguientes:

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

Asegúrese de que:

Si va a crear una conexión en la que redundancytermina la clave de emparejamiento /1IS PRIMARYy está utilizando el UUID del perfil de servicio de Google Cloud Partner Interconnect Zone 1 bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Si está creando una conexión en la que redundancytermina la clave de emparejamiento /2IS SECONDARYy está utilizando el perfil de servicio UUID de la zona 2 de interconexión de socios de Google Cloud 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 conexión en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la referencia de 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 con un token de servicio de A-Side A AWS, envíe una POST solicitud al /fabric/v4/connections punto final. La conexión type es EVPL_VC.

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

Proporcione los detalles de su GCP y los detalles de la ubicación en el zSide objeto, incluidos los siguientes:

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

Asegúrese de que:

Si va a crear una conexión en la que redundancytermina la clave de emparejamiento /1IS PRIMARYy está utilizando el UUID del perfil de servicio de Google Cloud Partner Interconnect Zone 1 bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Si está creando una conexión en la que redundancytermina la clave de emparejamiento /2IS SECONDARYy está utilizando el perfil de servicio UUID de la zona 2 de interconexión de socios de Google Cloud 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 conexión en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la referencia de 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 GET solicitud al fabric/v4/connections/{connectionId} punto final para supervisar el estado de la conexión.

`equinixStatus` valores de parámetros	`providerStatus` valores de atributo	Estado de Google	Descripción
`PROVISIONING`	`PROVISIONING`		La solicitud de conexión no ha sido enviada a Googleyet.
`PROVISIONED`	`PENDING_APPROVAL`	A la espera de proveedor de servicios.	Conexión en espera de aceptación.
`PROVISIONED`	`PROVISIONING`	Activación necesaria -> Se requiere la configuración del Protocolo de Pasarela Fronteriza (BGP).	Establecimiento de conexión en curso.
`PROVISIONED`	`PROVISIONED`	Pendiente -> disponibilidad	Conexión aceptada por el cliente.

Activar la conexión

Activa la conexión virtual con Google Cloud Platform. Consulte la documentación de Google Cloud para obtener instrucciones sobre cómo activar la conexión con Google Cloud Platform Console.

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