Gérer les ressources d'API avec Apigee Spaces

Consultez la documentation d'Apigee Edge.

Cet article explique comment créer et gérer des ressources d'API dans un espace. Vous pouvez créer des proxys d'API, des flux partagés et des produits d'API dans un espace. Les ressources créées dans l'espace héritent des mêmes autorisations que l'espace.

La création de ressources dans un espace est identique à la création de ressources dans une organisation Apigee, sauf que vous pouvez sélectionner un espace lorsque vous créez la ressource. Pour la version GA privée, vous pouvez créer des ressources d'API à partir de la ligne de commande à l'aide des API Apigee ou de la console Apigee dans Cloud.

Ce guide décrit les étapes nécessaires pour :

Pour en savoir plus sur Apigee Spaces, consultez la section Apigee Spaces.

Pour en savoir plus sur les types de ressources de l'API Apigee, consultez les ressources suivantes :

Avant de commencer

Avant de commencer à créer des ressources d'API dans Apigee Spaces, assurez-vous d'avoir effectué les tâches suivantes :

Rôles et autorisations requis

Avec l'introduction d'Apigee Spaces, la façon dont IAM vérifie les autorisations requises pour effectuer certaines opérations sur les ressources d'API a changé. Si la ressource d'API existe dans un espace, IAM vérifie les autorisations appropriées au niveau de l'espace pour le membre de l'espace qui effectue l'opération. Les autorisations requises pour ces opérations lorsque les ressources de l'API se trouvent dans un espace sont décrites ci-dessous :

Opération Autorisation requise Champ d'application
Déployer un proxy d'API
apigee.deployments.create
ET
apigee.proxyrevisions.deploy
Environnement
 
proxy d'API
Répertorier tous les déploiements d'un proxy d'API apigee.proxies.get proxy d'API
Répertorier tous les déploiements d'une révision de proxy d'API apigee.proxyrevisions.get Révision du proxy d'API
Répertorier tous les déploiements d'un proxy d'API dans un environnement
apigee.deployments.list
OU
apigee.proxies.get
Environnement
 
proxy d'API
Obtenir le déploiement d'une révision de proxy d'API
apigee.deployments.get
OU
apigee.proxyrevisions.get
Révision du proxy d'API
 
Environnement
Supprimer une révision d'un proxy d'API apigee.deployments.delete Révision du proxy d'API ET environnement
Déployer un flux partagé
apigee.deployments.create
ET
apigee.sharedflows.deploy
Environnement
 
Flux partagés
Liste de tous les déploiements d'un flux partagé apigee.sharedflows.get Flux partagés
Lister tous les déploiements d'une révision de flux partagé apigee.sharedflowrevisions.get Révision de flux partagé
Lister tous les déploiements d'un flux partagé dans un environnement
apigee.deployments.list
OU
apigee.sharedflows.get
Environnement
 
Flux partagés
Obtenir le déploiement d'une révision de flux partagé
apigee.deployments.get
OU
apigee.sharedflowrevisions.get
Révision du proxy d'API
 
Flux partagés
Supprimer un flux partagé apigee.deployments.delete Flux partagé ET environnement
Créer une session de débogage pour une révision de proxy d'API apigee.tracesessions.create Révision du proxy d'API ET environnement
Récupérer une session de débogage apigee.tracesessions.get Proxy d'API ET environnement
Supprimer des données d'une session de débogage apigee.tracesessions.delete Proxy d'API ET environnement
Liste des sessions de débogage actives dans la révision du proxy d'API apigee.tracesessions.list Environnement OU révision du proxy d'API
Récupérer les données de débogage d'une transaction apigee.tracesessions.get Révision de l'environnement ET du proxy d'API
Répertorier les ID de transaction d'une session de débogage apigee.tracesessions.get Révision de l'environnement ET du proxy d'API

Attribuer des rôles et des autorisations aux membres d'un espace

Les différentes autorisations décrites sont incluses dans le rôle apigee.apiAdminV2 ou apigee.environmentAdmin. Pour en savoir plus, consultez la page Rôles Apigee.

Pour attribuer ces rôles et leurs autorisations à un membre de l'espace, vous pouvez effectuer l'une des opérations suivantes :

  • Ajoutez le rôle roles/apiAdminV2 à l'espace à l'aide de l'API et ajoutez le rôle roles/environmentAdmin à l'environnement cible à l'aide de l'API.
  • Ajoutez les rôles au projet à l'aide de l'interface utilisateur IAM.

  1. Dans la console Google Cloud, accédez à la page IAM.

    Accéder à IAM
  2. Sélectionnez le projet.

  3. Dans la colonne Compte principal, recherchez toutes les lignes qui vous identifient ou un groupe auquel vous appartenez. Pour savoir à quels groupes vous appartenez, contactez votre administrateur.

  4. Pour toutes les lignes qui vous spécifient ou vous incluent, consultez la colonne Rôle pour vous assurer que la liste inclut les rôles requis.

  1. Dans la console Google Cloud, accédez à la page IAM.

    Accéder à IAM
  2. Sélectionnez le projet.
  3. Cliquez sur Accorder l'accès.

  4. Dans le champ Nouveaux comptes principaux, saisissez votre identifiant utilisateur. Il s'agit généralement de l'adresse e-mail d'un compte Google.

  5. Dans la liste Sélectionner un rôle, sélectionnez un rôle.
  6. Pour attribuer des rôles supplémentaires, cliquez sur Ajouter un autre rôle et ajoutez chaque rôle supplémentaire.
  7. Cliquez sur Enregistrer.

Rôle requis pour accéder aux ressources d'API dans la console Google Cloud

Pour accéder à l'interface utilisateur Apigee dans la console Cloud en tant que membre de l'équipe Space, les utilisateurs doivent disposer du rôle ApigeeSpaceUser. Pour en savoir plus, consultez Rôles et autorisations IAM.

Gérer les proxys d'API dans un espace

Les membres de l'organisation Apigee affectés à un espace peuvent créer, déployer et désinstaller des proxys d'API en tant que ressources de l'espace. Les membres attribués uniquement à d'autres espaces ne pourront pas accéder à ces proxys ni les gérer.

Créer un proxy d'API en tant que ressource Space

Créez un proxy d'API en tant que ressource Space à l'aide de la console Apigee dans Cloud ou de l'API, comme décrit dans les sections suivantes.

Apigee dans la console CloudAPI Apigee

Pour créer un proxy d'API en tant que ressource d'espace à l'aide d'Apigee dans la console Cloud :

  1. Suivez les étapes décrites dans Créer un proxy d'API.
  2. À l'étape 5, un champ supplémentaire s'affiche sous Proxy details (Détails du proxy), dans lequel vous pouvez sélectionner un espace pour le proxy d'API. Sélectionnez un espace dans la zone de liste. Si vous ne souhaitez pas attribuer le proxy d'API à un espace, vous pouvez ignorer ce champ.
  3. Cliquez sur Suivant pour passer à l'étape facultative de déploiement de la création du proxy ou sur Créer pour créer le proxy sans le déployer.

Pour créer un proxy d'API en tant que ressource Space à l'aide des API Apigee, utilisez la commande suivante : 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/apis?name=PROXY_NAME&space=SPACE_NAME&action=import" \
    -X POST -H "Authorization: Bearer $TOKEN" \
    -H "Content-type: multipart/form-data" \
    -F "file=@PROXY_BUNDLE"

Où :

  • ORG_NAME est le nom de votre organisation Apigee.
  • PROXY_NAME est le nom du proxy d'API que vous créez. Le nom doit être unique au niveau mondial et pas seulement au sein de l'espace.
  • SPACE_NAME est le nom de l'espace dans lequel vous créez le proxy d'API.
  • PROXY_BUNDLE est le nom du fichier de groupe de proxys d'API.

Par exemple, avec la commande suivante, un membre de l'équipe red crée un proxy d'API nommé proxy-1 en tant qu'espace red de l'organisation acme à l'aide du fichier proxy-bundle.zip : 

curl "https://apigee.googleapis.com/v1/organizations/acme/apis?name=proxy-1&space=red&action=import" \
    -X POST -H "Authorization: Bearer $TOKEN" \
    -H "Content-type: multipart/form-data \
    -F "file=@proxy-bundle.zip"

L'exemple suivant présente la réponse à la commande : 

{
  "basepaths": ["/proxy-1"],
  "revision": 1,
  "apiProxyId": "proxy-1",
  "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
  "space": "red",
  "createTime": ...,
  "updateTime": ...
}

Déployer un proxy d'API en tant que ressource Space

Déployez un proxy d'API en tant que ressource Space à l'aide d'Apigee dans la console Cloud ou de l'API, comme décrit dans les sections suivantes.

Apigee dans la console CloudAPI Apigee

Pour déployer un proxy d'API en tant que ressource Space à l'aide d'Apigee dans la console Cloud, suivez la procédure décrite dans Déployer un proxy d'API. Aucune autre étape ou champ n'est requis.

Pour déployer un proxy d'API en tant que ressource Space à l'aide des API Apigee, utilisez la commande suivante : 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/apis/PROXY_NAME/revisions/REVISION_NUMBER/deployments" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

Où :

  • ORG_NAME est le nom de votre organisation Apigee.
  • ENV_NAME est le nom de l'environnement dans lequel vous déployez le proxy d'API.
  • PROXY_NAME est le nom du proxy d'API que vous déployez.
  • REVISION_NUMBER correspond au numéro de révision du proxy d'API que vous déployez.

Par exemple, à l'aide de la commande suivante, un membre de l'équipe red déploie le proxy d'API proxy-1, révision 1 de l'organisation acme dans l'environnement prod : 

curl "https://apigee.googleapis.com/v1/organizations/acme/environments/prod/apis/proxy-1/revisions/1/deployments" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

L'exemple suivant présente la réponse à la commande : 

      {
        "environment": "prod",
        "revision": "1",
        "apiProxy": "proxy-1",
        ...
      }

Déployer un proxy d'API associé à un espace

Déployez un proxy d'API associé à un espace à l'aide d'Apigee dans la console Cloud ou de l'API, comme décrit dans les sections suivantes.

Apigee dans la console CloudAPI Apigee

Pour annuler le déploiement d'un proxy d'API associé à un espace à l'aide de la console Apigee dans Cloud, suivez la procédure décrite dans la section Annuler le déploiement d'un proxy d'API. Aucune autre étape ou champ n'est requis.

Pour annuler le déploiement d'un proxy d'API associé à un espace à l'aide des API Apigee, exécutez la commande suivante : 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/apis/PROXY_NAME/revisions/REVISION_NUMBER/deployments" \
          -X DELETE -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

Où :

  • ORG_NAME est le nom de votre organisation Apigee.
  • ENV_NAME est le nom de l'environnement dans lequel vous annulez le déploiement du proxy d'API.
  • PROXY_NAME est le nom du proxy d'API que vous annulez.
  • REVISION_NUMBER correspond au numéro de révision du proxy d'API dont vous annulez le déploiement.

Par exemple, avec la commande suivante, un membre de l'équipe red annule de déploiement du proxy d'API proxy-1, révision 1 de l'organisation acme à partir de l'environnement prod : 

curl "https://apigee.googleapis.com/v1/organizations/acme/environments/prod/apis/proxy-1/revisions/1/deployments" \
          -X DELETE -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

Gérer les flux partagés en tant que ressources d'espace

Les membres attribués à un espace peuvent également créer, déployer et désinstaller des flux partagés en tant que ressources de l'espace. Les membres des autres espaces ne pourront pas accéder à ces flux partagés ni les gérer.

Créer un flux partagé en tant que ressource d'espace

Créez un flux partagé en tant que ressource Space à l'aide de la console Apigee dans Cloud ou de l'API, comme décrit dans les sections suivantes.

Apigee dans la console CloudAPI Apigee
Pour créer un flux partagé en tant que ressource d'espace à l'aide d'Apigee dans la console Cloud :
  1. Suivez les étapes décrites dans Créer un flux partagé dans l'interface utilisateur d'Apigee pour créer un flux partagé à partir de zéro ou importer un groupe de flux existant.
  2. À l'étape 4, un champ supplémentaire s'affiche dans la boîte de dialogue Créer un flux partagé. Vous pouvez y sélectionner un espace pour le proxy d'API. Sélectionnez un espace dans la zone de liste. Si vous ne souhaitez pas attribuer le proxy d'API à un espace, vous pouvez ignorer ce champ.
  3. Cliquez sur Créer pour créer le flux partagé.

Pour créer un flux partagé en tant que ressource Space à l'aide des API Apigee, utilisez la commande suivante : 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/sharedflows?name=FLOW_NAME&space=SPACE_NAME&action=import" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: multipart/form-data" \
          -F "file=@SHARED_FLOW_BUNDLE"

Où :

  • ORG_NAME est le nom de votre organisation Apigee.
  • FLOW_NAME est le nom du flux partagé que vous créez. Le nom doit être unique au niveau mondial et pas seulement au sein de l'espace.
  • SPACE_NAME est le nom de l'espace dans lequel vous créez le flux partagé.
  • SHARED_FLOW_BUNDLE est le nom du fichier de groupe de flux partagés.

Par exemple, avec la commande suivante, un membre de l'équipe red crée un flux partagé nommé flow-1 associé à l'espace red de l'organisation acme :

curl "https://apigee.googleapis.com/v1/organizations/acme/sharedflows?name=flow-1&space=red&action=import" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: multipart/form-data" \
          -F "file=@sharedflow-bundle.zip"

L'exemple suivant présente la réponse à la commande : 

      {
        "name": "organizations/acme/sharedflows/flow-1",
        "revision": 1,
        "sharedFlowId": "flow-1",
        "space": "red",
        "createTime": ...,
        "updateTime": ...
      }

Déployer un flux partagé en tant que ressource d'espace

Déployez un flux partagé en tant que ressource Space à l'aide d'Apigee dans la console Cloud ou de l'API, comme décrit dans les sections suivantes.

Apigee dans la console CloudAPI Apigee

Pour déployer un flux partagé en tant que ressource Space à l'aide de la console Apigee dans Cloud :

  1. Connectez-vous à l'interface utilisateur Apigee dans la console Cloud.
  2. Sélectionnez l'organisation contenant votre flux partagé. Consultez la page Passer d'une organisation à une autre.
  3. Dans la barre de navigation de gauche, sélectionnez Développement de proxy > Flux partagés.
  4. Sur la page de présentation des flux partagés, cliquez sur le nom du flux partagé que vous souhaitez déployer. La page d'informations du flux partagé s'affiche.
  5. Cliquez sur Déployer pour ouvrir la boîte de dialogue de déploiement.
  6. Saisissez ce qui suit :
    • Révision : numéro de révision du flux partagé que vous souhaitez déployer.
    • Environnement : environnement dans lequel vous souhaitez déployer le flux partagé.
    • Compte de service (facultatif) : un compte de service pour le flux partagé.
  7. Cliquez sur Déployer.

Pour déployer un flux partagé en tant que ressource Space à l'aide des API Apigee, utilisez la commande suivante : 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/sharedflows/FLOW_NAME/revisions/REVISION_NUMBER/deployments" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

Où :

  • ORG_NAME est le nom de votre organisation Apigee.
  • ENV_NAME est le nom de l'environnement dans lequel vous déployez le flux partagé.
  • FLOW_NAME correspond au nom du flux partagé que vous déployez.
  • REVISION_NUMBER est le numéro de révision du flux partagé que vous déployez.

Par exemple, à l'aide de la commande suivante, un membre de l'équipe red déploie le flux partagé flow-1, numéro de révision 1 du répertoire acme dans l'environnement prod : 

curl "https://apigee.googleapis.com/v1/organizations/acme/environments/prod/sharedflows/flow-1/revisions/1/deployments" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

L'exemple suivant présente la réponse à la commande : 

      {
        "environment": "prod",
        "revision": "1",
        "sharedFlow": "flow-1",
        ...
      }

Déployer un flux partagé associé à un espace

Déployez un flux partagé associé à un espace à l'aide d'Apigee dans la console Cloud ou de l'API, comme décrit dans les sections suivantes.

Apigee dans la console CloudAPI Apigee

Pour annuler le déploiement d'un flux partagé associé à un espace dans la console Apigee in Cloud :

  1. Connectez-vous à l'interface utilisateur Apigee dans la console Cloud.
  2. Sélectionnez l'organisation contenant votre flux partagé. Consultez la page Passer d'une organisation à une autre.
  3. Dans la barre de navigation de gauche, sélectionnez Développement de proxy > Flux partagés.
  4. Sur la page d'aperçu des flux partagés, cliquez sur le nom du flux partagé que vous souhaitez désinstaller. La page d'informations du flux partagé s'affiche.
  5. Sous Déploiements, cliquez sur Annuler le déploiement.

Pour annuler le déploiement d'un flux partagé associé à un espace à l'aide des API Apigee, exécutez la commande suivante : 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/sharedflows/FLOW_NAME/revisions/REVISION_NUMBER/deployments" \
          -X DELETE -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

Où :

  • ORG_NAME est le nom de votre organisation Apigee.
  • ENV_NAME correspond au nom de l'environnement dans lequel vous annulez le déploiement du flux partagé.
  • FLOW_NAME est le nom du flux partagé dont vous annulez le déploiement.
  • REVISION_NUMBER est le numéro de révision du flux partagé dont vous annulez le déploiement.

Gérer un produit d'API en tant que ressource Space

Les membres attribués à un espace peuvent créer un produit d'API pour regrouper leurs proxys d'API. Lorsque vous créez des produits d'API, les membres de l'espace peuvent sélectionner tous les proxys d'API auxquels ils ont accès, y compris les proxys créés directement sous l'organisation et les proxys d'API créés dans les espaces dont ils sont membres. Les membres des autres espaces ne pourront pas accéder à ces produits d'API ni les gérer.

Créez un produit d'API en tant que ressource Space à l'aide de la console Apigee dans Cloud ou de l'API, comme décrit dans les sections suivantes.

Apigee dans la console CloudAPI Apigee

Pour créer un produit d'API en tant que ressource d'espace à l'aide d'Apigee dans la console Cloud :

  1. Suivez la procédure décrite dans Créer un produit d'API.
  2. À l'étape 4, un champ supplémentaire s'affiche sur la page Détails du produit. Vous pouvez y sélectionner un espace pour le produit d'API. Sélectionnez un espace dans la zone de liste. Si vous ne souhaitez pas attribuer le produit d'API à un espace, vous pouvez ignorer ce champ.
  3. Renseignez les autres informations de configuration, puis cliquez sur Enregistrer.

Pour créer un produit d'API en tant que ressource d'espace, utilisez la commande suivante : 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/apiproducts" \
            -X POST -H "Authorization: Bearer $TOKEN" \
            -H "Content-type: application/json" \
            -d  \
              `{
                "name": "PRODUCT_NAME",
                "displayName": "DISPLAY_NAME",
                "description": "PRODUCT_DESCRIPTION",
                "approvalType": "auto",
                "apiResources": [
                  {
                    "apiproduct": "PRODUCT_NAME",
                    "apiResource": "PROXY_NAME",
                    "operations": [
                      {
                        "method": "GET",
                        "path": "/"
                      }
                    ]
                  }
                ],
                "space": "SPACE_NAME"
              }`

Où :

  • ORG_NAME est le nom de votre organisation Apigee.
  • PRODUCT_NAME est le nom du produit d'API que vous créez. Le nom doit être unique et pas seulement au sein de l'espace.
  • DISPLAY_NAME est le nom du produit d'API que vous créez, tel qu'il s'affiche dans l'interface utilisateur.
  • PRODUCT_DESCRIPTION est la description du produit d'API que vous créez.
  • SPACE_NAME est le nom de l'espace dans lequel vous créez le produit d'API.
  • PROXY_NAME est le nom du proxy d'API que vous ajoutez au produit d'API.

Par exemple, avec la commande suivante, un membre de l'équipe red crée un produit d'API nommé product-1 associé à l'espace red de l'organisation acme :

curl "https://apigee.googleapis.com/v1/organizations/acme/apiproducts?name=product-1&space=red&action=import" \
            -X POST -H "Authorization: Bearer $TOKEN" \
            -X "Content-type: application/json" \
            -d  \
              `{
                "name": "product-1",
                "displayName": "product-1",
                "description": "Product 1",
                "apiResources": [
                  {
                    "apiproduct": "product-1",
                    "apiResource": "proxy-1",
                    "operations": [
                      {
                        "method": "GET",
                        "path": "/"
                      }
                    ]
                  }
                ],
                "space": "red"
              }`

L'exemple suivant présente la réponse à la commande : 

        {
          "name": "organizations/acme/apiproducts/product-1",
          "displayName": "product-1",
          "description": "Product 1",
          "apiResources": [
            {
              "apiproduct": "product-1",
              "apiResource": "proxy-1",
              "operations": [
                {
                  "method": "GET",
                  "path": "/"
                }
              ]
            }
          ],
          "space": "red",
          "createTime": ...,
          "updateTime": ...
        }

Lister toutes les ressources d'API associées à un espace

Pour toutes les opérations de liste, y compris ListApiProxies, ListSharedFlows et ListApiProducts, vous pouvez spécifier un nom d'espace pour lister toutes les ressources associées à cet espace. Si vous ne spécifiez pas de nom d'espace, l'opération de liste renvoie toutes les ressources de l'organisation auxquelles vous avez accès, qu'elles soient associées ou non à un espace.

Pour effectuer cette tâche, vous devez disposer de l'autorisation apigee.apiResources.list. Cette autorisation est incluse dans le rôle Apigee > Apigee Organization Admin.

Lister les ressources d'API associées à un espace spécifique

Répertoriez toutes les ressources d'API associées à un espace spécifique dans la console Apigee dans Cloud ou à l'aide de l'API, comme décrit dans les sections suivantes.

Apigee dans la console CloudAPI Apigee

Pour lister toutes les ressources d'API associées à un espace spécifique dans Apigee dans la console Cloud, ouvrez la page d'aperçu du type de ressource concerné (proxy d'API, flux partagés ou produits d'API). Dans la zone Filtre, sélectionnez l'option Espace dans la liste, puis saisissez le nom de l'espace. La liste des ressources attribuées à cet espace s'affiche. Notez que seules les ressources associées à un espace dont l'utilisateur est membre sont affichées.

Pour lister toutes les ressources d'API associées à un espace spécifique, exécutez la commande suivante : 

curl -H "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/ORG_NAME/RESOURCE_TYPE?space=SPACE_NAME"

Où :

  • ORG_NAME est le nom de votre organisation Apigee.
  • RESOURCE_TYPE est le type de la ressource que vous listez. Les valeurs valides sont les suivantes :
    • apis
    • sharedFlows
    • apiProducts
  • SPACE_NAME est le nom de l'espace dans lequel vous listez la ressource.

Par exemple, avec la commande suivante, un membre de l'équipe red répertorie tous les proxys d'API associés à l'espace red dans l'organisation acme :

curl -H  "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/acme/apis?space=red"

L'exemple suivant présente la réponse à la commande : 

      {
        "proxies": [
          {
            "basepaths": "/proxy-1",
            "revision": "1",
            "apiProxyId": "proxy-1",
            "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
            "space": "red",
            "createTime": ...,
            ....
          }
        ]
      }

Lister les ressources d'API sans spécifier d'espace

Lister toutes les ressources d'API sans spécifier d'espace dans la console Apigee dans Cloud ou à l'aide de l'API, comme décrit dans les sections suivantes.

Apigee dans la console CloudAPI Apigee

Pour afficher la liste de toutes les ressources d'API d'un type donné dans Apigee dans la console Cloud, indépendamment de l'association à un espace, ouvrez la page d'aperçu du type de ressource concerné (proxys d'API, flux partagés ou produits d'API). La liste de toutes les ressources disponibles s'affiche. Notez que seules les ressources auxquelles l'utilisateur est autorisé à accéder sont affichées. Cela inclut les ressources associées à un ou plusieurs espaces dont l'utilisateur est membre, ou les ressources non associées à un espace.

Vous pouvez également lister les ressources d'API sans spécifier d'espace à l'aide de la commande suivante : 

curl -H "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/ORG_NAME/RESOURCE_TYPE"

Où :

  • ORG_NAME est le nom de votre organisation Apigee.
  • RESOURCE_TYPE est le type de la ressource que vous listez. Les valeurs valides sont les suivantes :
    • apis
    • sharedFlows
    • apiProducts

Par exemple, un utilisateur disposant d'un accès Organization Admin à toutes les ressources de l'organisation peut exécuter la commande suivante pour lister tous les proxys d'API de l'organisation acme : 

curl -H  "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/acme/apis"

Si l'organisation acme dispose de trois proxys, la commande renvoie les informations sur les trois proxys. Exemple : 

      {
        "proxies": [
          {
            "basepaths": "/proxy-1",
            "revision": "1",
            "apiProxyId": "proxy-1",
            "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
            "space": "red",
            "createTime": ...,
            ....
          },
          {
            "basepaths": "/proxy-2",
            "revision": "1",
            "apiProxyId": "proxy-2",
            "resourceName": "organizations/acme/apis/proxy-2/revisions/1",
            "space": "blue",
            "createTime": ...,
            ....
          },
          {
            "basepaths": "/proxy-3",
            "revision": "1",
            "apiProxyId": "proxy-3",
            "resourceName": "organizations/acme/apis/proxy-3/revisions/1",
            "space": "green",
            "createTime": ...,
            ....
          }
        ]
      }

Si un autre utilisateur qui ne dispose que d'un accès apiAdmin aux ressources de l'espace red exécute la même commande, celle-ci ne renverra que les informations sur proxy-1. La réponse se présente comme suit : 

      {
        "proxies": [
          {
            "basepaths": "/proxy-1",
            "revision": "1",
            "apiProxyId": "proxy-1",
            "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
            "space": "red",
            "createTime": ...,
            ....
          }
        ]
      }

Étape suivante