API - Connexion à Google Cloud Platform

Établissez une connexion directe de couche 2 à Google Cloud Partner Interconnect à l'aide d'un port Fabric, d'un routeur Fabric Cloud ou d'un jeton de service.

remarque

Pour obtenir des instructions sur la connexion à partir d'un périphérique virtuel Network Edge, consultez Network Edge vers Google Cloud Platform.

Conditions préalables

Authentification - Soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète client pour OAuth2 Authentification. Consultez Authentification API pour obtenir des instructions sur la façon d'appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.
Déterminez vos informations de la face A. Soit:
- Récupérez les informations sur les ports de votre Equinix Fabric à l'aide de la requête API Get All Ports.
OU
- Déterminez les informations de votre routeur Fabric Cloud. Consultez la liste des routeurs infonuagiques disponibles en envoyant une requête POST au point de terminaison /fabric/v4/routers/search. Vous aurez besoin de l'UUID du routeur.
OU
- Récupérez votre ou vos jetons de service côté client en envoyant une requête GET au point de terminaison /fabric/v4/serviceTokens (https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Tokens/operation/getServiceTokens). Vous aurez besoin de l'UUID du jeton. Ce jeton côté client fournit les informations nécessaires à la configuration de la partie client de la connexion.
Choisissez l'emplacement du métro côté Z. Utilisez la requête API Get All Metros pour trouver tous les métros où Equinix Fabric est disponible et déterminer l'emplacement de destination.
Identifiez les renseignements du profil de service Google Cloud Partner Interconnect. Pour plus d'informations sur le profil de service à choisir, consultez la page Présentation.
- Zone 1 - bd4570e2-d792-4a00-87f5-3bde040cdcd7
- Zone 2 - b97dacca-abe6-4e8c-8be1-fcdd1be1defe
Validez votre clé d'autorisation. Envoyez une requête POST au point de terminaison /fabric/v4/connections/validate pour vérifier que votre clé d'appairage peut être utilisée pour créer une connexion au profil de service sélectionné dans le métro donné.

Connexion à partir d'un port DOT1Q

Pour établir une connexion entre votre port DOT1Q et Google Cloud Partner Interconnect, envoyez une requête POST au point de terminaison /fabric/v4/connections. Le type de connexion est EVPL_VC.

Veuillez indiquer les informations relatives à votre port dans l'objet aSide, notamment:

accessPoint.type as COLO
Fournissez l'UUID de votre port à port.uuid
Définir linkProtocol.type comme DOT1Q
Fournissez l'ID du VLAN à linkProtocol.vlanTag

Veuillez fournir vos informations GCP et vos détails de localisation dans l'objet 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 le site Equinix Metro auquel vous vous connectez dans location.metroCode.
Définissez authenticationKey comme votre clé d'appairage émise par Google Cloud.

Assurez-vous que:

Si vous créez une connexion où la redondance est PRIMARY que la clé d'appairage se termine par /1 et que vous utilisez le profil de service UUID de la zone d'interconnexion Google Cloud Partner 1 bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Si vous créez une connexion où la redondance est SECONDAIRE que la clé d'appairage se termine par /2 et que vous utilisez le profil de service UUID de la zone d'interconnexion Google Cloud Partner 2 b97dacca-abe6-4e8c-8be1-fcdd1be1defe.
Si vous créez des connexions redondantes, envoyez deux requêtes API, une pour chaque priorité de redondance.

Spécifiez tout autre détail de configuration de connexion dans le corps de la requête. Pour obtenir la liste complète des paramètres et leurs descriptions, consultez la référence de l'API.

Exemple de requête 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>"
      ]
    }
  ]
}'

Connexion à partir d'un port QINQ

Pour établir une connexion entre votre port QINQ et Google Cloud Partner Interconnect, envoyez une requête POST au point de terminaison /fabric/v4/connections. Le type de connexion est EVPL_VC.

Veuillez indiquer les informations relatives à votre port dans l'objet aSide, notamment:

accessPoint.type as COLO
Fournissez l'UUID de votre port à port.uuid
Définir linkProtocol.type comme QINQ
Fournissez l'ID de la balise interne à linkProtocol.vlanCTag
Fournissez l'ID de la balise externe à linkProtocol.vlanSTag

Veuillez fournir vos informations GCP et vos détails de localisation dans l'objet 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 le site Equinix Metro auquel vous vous connectez dans location.metroCode.
Définissez authenticationKey comme votre clé d'appairage émise par Google Cloud.

Assurez-vous que:

Si vous créez une connexion où la redondance est PRIMARY que la clé d'appairage se termine par /1 et que vous utilisez le profil de service UUID de la zone d'interconnexion Google Cloud Partner 1 bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Si vous créez une connexion où la redondance est SECONDAIRE que la clé d'appairage se termine par /2 et que vous utilisez le profil de service UUID de la zone d'interconnexion Google Cloud Partner 2 b97dacca-abe6-4e8c-8be1-fcdd1be1defe.
Si vous créez des connexions redondantes, envoyez deux requêtes API, une pour chaque priorité de redondance.

Spécifiez tout autre détail de configuration de connexion dans le corps de la requête. Pour obtenir la liste complète des paramètres et leurs descriptions, consultez la référence de l'API.

Exemple de requête 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>"
      ]
    }
  ]
}'

Connexion à partir d'un Fabric Cloud Router

Pour établir une connexion entre votre routeur Fabric Cloud et AWS, envoyez une requête POST au point de terminaison /fabric/v4/connections. Le type de connexion est IP_VC.

Définissez votre routeur Fabric Cloud dans l'objet aSide, en incluant:

Définir accessPoint.type sur CLOUD_ROUTER.
Définissez router.uuid comme l'UUID de votre routeur.

Veuillez fournir vos informations GCP et vos détails de localisation dans l'objet 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 le site Equinix Metro auquel vous vous connectez dans location.metroCode.
Définissez authenticationKey comme votre clé d'appairage émise par Google Cloud.

Assurez-vous que:

Si vous créez une connexion où la redondance est PRIMARY que la clé d'appairage se termine par /1 et que vous utilisez le profil de service UUID de la zone d'interconnexion Google Cloud Partner 1 bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Si vous créez une connexion où la redondance est SECONDAIRE que la clé d'appairage se termine par /2 et que vous utilisez le profil de service UUID de la zone d'interconnexion Google Cloud Partner 2 b97dacca-abe6-4e8c-8be1-fcdd1be1defe.
Si vous créez des connexions redondantes, envoyez deux requêtes API, une pour chaque priorité de redondance.

Spécifiez tout autre détail de configuration de connexion dans le corps de la requête. Pour obtenir la liste complète des paramètres et leurs descriptions, consultez la référence de l'API.

Exemple de requête 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>"
      ]
    }
  ]
}'

Connexion à l'aide d'un jeton de service

Pour établir une connexion à AWS à l'aide d'un jeton de service côté A, envoyez une requête POST au point de terminaison /fabric/v4/connections. Le type de connexion est EVPL_VC.

Fournissez l'UUID de votre jeton de service dans l'objet aSide. Ce jeton de service fournit tous les autres renseignements nécessaires à l'établissement de la connexion.

Veuillez fournir vos informations GCP et vos détails de localisation dans l'objet 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 le site Equinix Metro auquel vous vous connectez dans location.metroCode.
Définissez authenticationKey comme votre clé d'appairage émise par Google Cloud.

Assurez-vous que:

Si vous créez une connexion où la redondance est PRIMARY que la clé d'appairage se termine par /1 et que vous utilisez le profil de service UUID de la zone d'interconnexion Google Cloud Partner 1 bd4570e2-d792-4a00-87f5-3bde040cdcd7.
Si vous créez une connexion où la redondance est SECONDAIRE que la clé d'appairage se termine par /2 et que vous utilisez le profil de service UUID de la zone d'interconnexion Google Cloud Partner 2 b97dacca-abe6-4e8c-8be1-fcdd1be1defe.
Si vous créez des connexions redondantes, envoyez deux requêtes API, une pour chaque priorité de redondance.

Spécifiez tout autre détail de configuration de connexion dans le corps de la requête. Pour obtenir la liste complète des paramètres et leurs descriptions, consultez la référence de l'API.

Exemple de requête 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>"
      ]
    }
  ]
}'

Surveillance de l'état de la connexion

Envoyez une requête GET au point de terminaison fabric/v4/connections/{connectionId} pour surveiller l'état de la connexion.

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

Activation de la connexion

Activez la connexion virtuelle à l'aide de Google Cloud Platform. Consultez la [documentation Google Cloud pour obtenir des instructions sur la procédure d'activation de la connexion via la console Google Cloud Platform.

Conditions préalables​

Connexion à partir d'un port DOT1Q​

Connexion à partir d'un port QINQ​

Connexion à partir d'un Fabric Cloud Router​

Connexion à l'aide d'un jeton de service​

Surveillance de l'état de la connexion​

Activation de la connexion​

Conditions préalables

Connexion à partir d'un port DOT1Q

Connexion à partir d'un port QINQ

Connexion à partir d'un Fabric Cloud Router

Connexion à l'aide d'un jeton de service

Surveillance de l'état de la connexion

Activation de la connexion