# API - Se connecter à Google Cloud Platform Établissez une connexion directe de couche 2 à l'interconnexion des partenaires Google Cloud à l'aide d'un port Fabric, d'un routeur Fabric Cloud ou d'un jeton de service. ![](https://docs.equinix.com/fr/assets/images/connectToGoogle-73a150d957737a8b28aab08b1ac4127d.png) > **Note** > > Pour obtenir des instructions sur la connexion à partir d'un appareil virtuel Network Edge, consultez [Network Edge to Google Cloud Platform](https://docs.equinix.com/fr/fabric-marketplace/connecting-to-service-provider/gcp/fabric-gcp-googleqc.md). ## Conditions préalables[​](#conditions-préalables "Lien direct vers Conditions préalables") 1. Authentifier - Soumettez vos informations d'identification, votre ID client et votre secret client pour OAuth2. authentification. Pour savoir comment appeler OAuth API pour valider et authentifier vos identifiants, reportez-vous à [authentification API](https://docs.equinix.com/fr/equinix-api/api-authentication.md). 2. Déterminez vos informations A-Side. Soit : * Récupérez les informations de vos ports Equinix Fabric à l'aide de la demande[Get All ports](https://docs.equinix.com/fr/api-catalog/fabricv4/ports/getports.md) API. OU * Déterminez vos informations Fabric Cloud Router. Vérifiez vos routeurs cloud disponibles en envoyant une `POST` demande au [`/fabric/v4/routers/search`](https://docs.equinix.com/fr/api-catalog/fabricv4/cloud-routers/searchcloudrouters.md)terminal. Vous avez besoin de l'UUID du routeur. OU * Récupérez vos jetons de service a-Side en envoyant une `GET` demande au [`/fabric/v4/serviceTokens`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Tokens/operation/getServiceTokens)point final. Vous avez besoin de l'UUID du jeton. Le jeton a-Side fournit les informations pertinentes pour configurer le a-Side de la connexion. 3. Choisissez l'emplacement métropolitain Z-Side. Utilisez la demande[Get All Metros](https://docs.equinix.com/fr/api-catalog/fabricv4/metros/getmetros.md) API pour trouver toutes les[métros](https://docs.equinix.com/fr/api-catalog/fabricv4/metros/getmetros.md) où Equinix Fabric est disponible et déterminer l'emplacement de destination. 4. Identifiez les informations du profil de service Google Cloud Partner Interconnect. Vous trouverez plus d'informations sur le profil de service que vous devez choisir sur la page[présentation](https://docs.equinix.com/fr/fabric-marketplace/connecting-to-service-provider/gcp/gcp-interconnect-overview.md#redundancy-and-service-profiles). * Zone 1 - `bd4570e2-d792-4a00-87f5-3bde040cdcd7` * Zone 2 - `b97dacca-abe6-4e8c-8be1-fcdd1be1defe` 5. Validez votre clé d'autorisation. Envoyez une `POST` demande au [`/fabric/v4/connections/validate`](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/validateconnections.md)point de terminaison pour vérifier que votre clé de couplage peut être utilisée pour créer une connexion au profil de service sélectionné dans la zone métropolitaine donnée. ## Connexion à partir d'un port DOT1Q[​](#connexion-à-partir-dun-port-dot1q "Lien direct vers Connexion à partir d'un port DOT1Q") Pour créer une connexion entre votre port DOT1Q et Google Cloud Partner Interconnect, envoyez une `POST` demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md)point de terminaison. La connexion `type` est `EVPL_VC`. Indiquez vos informations de port dans l'`aSide`objet, notamment : * `accessPoint.type` as `COLO` * Indiquez l'UUID de votre port à `port.uuid` * Définir `linkProtocol.type` comme `DOT1Q` * Indiquez l'identifiant VLAN à `linkProtocol.vlanTag` Dans l'objet, indiquez les détails de votre GCP et de votre emplacement`zSide`, notamment : * Définir `accessPoint.type` comme `SP`. * Définir `profile.type` comme `L2_PROFILE`. * Spécifiez le profil de service auquel vous vous connectez dans `profile.uuid`. * Spécifiez l'emplacement métropolitain Equinix auquel vous vous connectez dans `location.metroCode`. * Définir `authenticationKey` comme clé de couplage Google Cloud. Veillez à ce que : * Si vous créez une connexion où `redundancy` `PRIMARY`se termine la clé de couplage `/1`et que vous utilisez l'UUID du profil de service Google Cloud Partner Interconnect zone 1 `bd4570e2-d792-4a00-87f5-3bde040cdcd7`. * Si vous créez une connexion où `redundancy` `SECONDARY`se termine la clé de couplage `/2`et que vous utilisez l'UUID du profil de service Google Cloud Partner Interconnect zone 2 `b97dacca-abe6-4e8c-8be1-fcdd1be1defe`. * Si vous créez des connexions redondantes, envoyez deux requêtes API, une pour chaque priorité de redondance. Dans le corps de la demande, spécifiez tout autre détail de configuration de connexion. Pour obtenir la liste complète des paramètres et leurs descriptions, reportez-vous à la [référence API](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md) . Exemple de requête 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": [ "", "" ] } ] }' ``` ## Connexion à partir d'un port QINQ[​](#connexion-à-partir-dun-port-qinq "Lien direct vers Connexion à partir d'un port QINQ") Pour créer une connexion entre votre port QINQ et Google Cloud Partner Interconnect, envoyez une `POST` demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md)terminal. La connexion `type` est `EVPL_VC`. Indiquez vos informations de port dans l'`aSide`objet, notamment : * `accessPoint.type` as `COLO` * Indiquez l'UUID de votre port à `port.uuid` * Définir `linkProtocol.type` comme `QINQ` * Indiquez l'identifiant de l'étiquette interne à `linkProtocol.vlanCTag` * Indiquez l'identifiant de la balise externe à `linkProtocol.vlanSTag` Dans l'objet, indiquez les détails de votre GCP et de votre emplacement`zSide`, notamment : * Définir `accessPoint.type` comme `SP`. * Définir `profile.type` comme `L2_PROFILE`. * Spécifiez le profil de service auquel vous vous connectez dans `profile.uuid`. * Spécifiez l'emplacement métropolitain Equinix auquel vous vous connectez dans `location.metroCode`. * Définir `authenticationKey` comme clé de couplage Google Cloud. Veillez à ce que : * Si vous créez une connexion où `redundancy` `PRIMARY`se termine la clé de couplage `/1`et que vous utilisez l'UUID du profil de service Google Cloud Partner Interconnect zone 1 `bd4570e2-d792-4a00-87f5-3bde040cdcd7`. * Si vous créez une connexion où `redundancy` `SECONDARY`se termine la clé de couplage `/2`et que vous utilisez l'UUID du profil de service Google Cloud Partner Interconnect zone 2 `b97dacca-abe6-4e8c-8be1-fcdd1be1defe`. * Si vous créez des connexions redondantes, envoyez deux requêtes API, une pour chaque priorité de redondance. Dans le corps de la demande, spécifiez tout autre détail de configuration de connexion. Pour obtenir la liste complète des paramètres et leurs descriptions, reportez-vous à la [référence API](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md) . Exemple de requête 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": [ "", "" ] } ] }' ``` ## Connexion à partir d'un Fabric Cloud Router[​](#connexion-à-partir-dun-fabric-cloud-router "Lien direct vers Connexion à partir d'un Fabric Cloud Router") Pour créer une connexion entre votre Fabric Cloud Router et AWS, envoyez une `POST` demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md)terminal. La connexion `type` est `IP_VC`. Définissez votre Fabric Cloud Router dans l'`aSide`objet, y compris : * Définir `accessPoint.type` comme `CLOUD_ROUTER`. * Définir `router.uuid` comme UUID de votre routeur. Dans l'objet, indiquez les détails de votre GCP et de votre emplacement`zSide`, notamment : * Définir `accessPoint.type` comme `SP`. * Définir `profile.type` comme `L2_PROFILE`. * Spécifiez le profil de service auquel vous vous connectez dans `profile.uuid`. * Spécifiez l'emplacement métropolitain Equinix auquel vous vous connectez dans `location.metroCode`. * Définir `authenticationKey` comme clé de couplage Google Cloud. Veillez à ce que : * Si vous créez une connexion où `redundancy` `PRIMARY`se termine la clé de couplage `/1`et que vous utilisez l'UUID du profil de service Google Cloud Partner Interconnect zone 1 `bd4570e2-d792-4a00-87f5-3bde040cdcd7`. * Si vous créez une connexion où `redundancy` `SECONDARY`se termine la clé de couplage `/2`et que vous utilisez l'UUID du profil de service Google Cloud Partner Interconnect zone 2 `b97dacca-abe6-4e8c-8be1-fcdd1be1defe`. * Si vous créez des connexions redondantes, envoyez deux requêtes API, une pour chaque priorité de redondance. Dans le corps de la demande, spécifiez tout autre détail de configuration de connexion. Pour obtenir la liste complète des paramètres et leurs descriptions, reportez-vous à la [référence API](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md) . Exemple de requête 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": [ "", "" ] } ] }' ``` ## Connexion à l'aide d'un jeton de service[​](#connexion-à-laide-dun-jeton-de-service "Lien direct vers Connexion à l'aide d'un jeton de service") Pour créer une connexion à AWS à l'aide d'un jeton de service A-Side, envoyez `POST`une demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md)point final. La connexion `type` est `EVPL_VC`. Attribuez votre UUID de jeton de service à dans l'`aSide`objet. Le jeton de service fournit toutes les autres informations nécessaires pour établir la connexion. Dans l'objet, indiquez les détails de votre GCP et de votre emplacement`zSide`, notamment : * Définir `accessPoint.type` comme `SP`. * Définir `profile.type` comme `L2_PROFILE`. * Spécifiez le profil de service auquel vous vous connectez dans `profile.uuid`. * Spécifiez l'emplacement métropolitain Equinix auquel vous vous connectez dans `location.metroCode`. * Définir `authenticationKey` comme clé de couplage Google Cloud. Veillez à ce que : * Si vous créez une connexion où `redundancy` `PRIMARY`se termine la clé de couplage `/1`et que vous utilisez l'UUID du profil de service Google Cloud Partner Interconnect zone 1 `bd4570e2-d792-4a00-87f5-3bde040cdcd7`. * Si vous créez une connexion où `redundancy` `SECONDARY`se termine la clé de couplage `/2`et que vous utilisez l'UUID du profil de service Google Cloud Partner Interconnect zone 2 `b97dacca-abe6-4e8c-8be1-fcdd1be1defe`. * Si vous créez des connexions redondantes, envoyez deux requêtes API, une pour chaque priorité de redondance. Dans le corps de la demande, spécifiez tout autre détail de configuration de connexion. Pour obtenir la liste complète des paramètres et leurs descriptions, reportez-vous à la [référence API](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md) . Exemple de requête 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": [ "", "" ] } ] }' ``` ## Contrôle de l'état de la connexion[​](#contrôle-de-létat-de-la-connexion "Lien direct vers Contrôle de l'état de la connexion") Envoyer une `GET` demande au [`fabric/v4/connections/{connectionId}`](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/getconnectionbyuuid.md)point final pour surveiller l'état de la connexion. | `equinixStatus` valeurs des paramètres | `providerStatus` valeurs d'attribut | **Statut Google** | **Description** | | -------------------------------------- | ----------------------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------- | | `PROVISIONING` | `PROVISIONING` | | La demande de connexion n'a pas été envoyée à Googleyet. | | `PROVISIONED` | `PENDING_APPROVAL` | En attente d'un fournisseur de services. | Connexion en attente d'acceptation. | | `PROVISIONED` | `PROVISIONING` | Activation nécessaire -> configuration Border Gateway Protocol (BGP) requise. | Établissement de la connexion en cours. | | `PROVISIONED` | `PROVISIONED` | En attente -> disponibilité | Connexion acceptée par le client. | ## Activation de la connexion[​](#activation-de-la-connexion "Lien direct vers Activation de la connexion") Activez la connexion virtuelle à l'aide de Google Cloud Platform. Consultez la [documentation Google Cloud](https://console.cloud.google.com/) pour savoir comment activer la connexion à l'aide de la console Google Cloud Platform.