Afficher et modifier des projets

Cette page explique comment récupérer les métadonnées d'un projet et modifier les paramètres existants. Vous pouvez également rechercher des projets spécifiques dans votre hiérarchie de ressources en fonction de leur état ou de leur nom à afficher.

Trouver le nom, le numéro et l'ID du projet

Pour interagir avec les ressources Google Cloud , vous devez fournir les informations d'identification du projet pour chaque requête. Un projet est identifié par son ID de projet et son numéro de projet.

Console

Accédez à la page d'accueil de la console Google Cloud .
Accéder à la page d'accueil
Dans le sélecteur de projets situé en haut de la page, sélectionnez votre projet.

Remarque : Le sélecteur de projet peut afficher jusqu'à 4 000 ressources. Si vous ne voyez pas une ressource qui devrait s'afficher, accédez à la page Gérer les ressources et filtrez la liste à l'aide du nom de cette ressource.

Le nom ainsi que le numéro et l'ID du projet apparaissent après l'en-tête Bienvenue.

Obtenir un projet existant

Pour obtenir les métadonnées détaillées d'un projet Google Cloud spécifique, telles que l'état du cycle de vie, l'heure de création et la ressource parente du projet, utilisez la Google Cloud CLI ou l'API.

Vous devez être propriétaire du projet ou disposer des autorisations du rôle Navigateur (roles/browser) pour accéder aux détails du projet.

gcloud

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

PROJECT_ID : ID du projet Google Cloud

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud projects describe PROJECT_ID

Windows (PowerShell)

gcloud projects describe PROJECT_ID

Windows (cmd.exe)

gcloud projects describe PROJECT_ID

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

PROJECT_ID : ID du projet Google Cloud

Méthode HTTP et URL :

GET https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID

Corps JSON de la requête :

{}

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Remarque : Pour la commande suivante, nous partons du principe que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID"

PowerShell

Remarque : Pour la commande suivante, nous partons du principe que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
    "projectNumber": "464036093014",
    "projectId": "our-project-123",
    "lifecycleState": "ACTIVE",
    "name": "my project",
    "labels": {
        "mylabel": "prod"
    },
    "createTime": "2016-01-07T21:59:43.314Z"
}

Répertorier tous les projets d'une ressource

Pour répertorier tous les projets qui sont des enfants directs d'une ressource, utilisez la méthode projects.list v3 et spécifiez la ressource parente dans la requête :

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

FOLDER_ID : ID du dossier Google Cloud

Méthode HTTP et URL :

GET https://cloudresourcemanager.googleapis.com/v3/projects

Corps JSON de la requête :

{
    "parent": "folders/662951040570"
}

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects"

PowerShell

Remarque : Pour la commande suivante, nous partons du principe que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
    "projectNumber": "464036093014",
    "projectId": "our-project-123",
    "lifecycleState": "ACTIVE",
    "name": "my project",
    "labels": {
        "mylabel": "prod"
    },
    "createTime": "2016-01-07T21:59:43.314Z"
}

Rechercher des projets

Pour trouver des projets qui correspondent à des critères spécifiques, tels qu'un préfixe de nom à afficher ou un état de cycle de vie spécifique, utilisez la méthode projects.search ou la commande gcloud alpha resource-manager projects search.

Le champ d'application de la recherche inclut tous les projets pour lesquels vous disposez de l'autorisation resourcemanager.projects.get.

Syntaxe des requêtes

Vous pouvez filtrer votre recherche à l'aide de l'option --query (gcloud) ou du paramètre query (API). Voici quelques filtres de recherche courants :

displayName : nom convivial du projet.
state : état du cycle de vie du projet, par exemple ACTIVE ou DELETE_REQUESTED
parent.type et parent.id : filtrent les résultats par organisation ou dossier spécifiques.

Autorisations

Si vous spécifiez un parent dans la requête (par exemple, parent:folders/123), vous devez disposer des autorisations resourcemanager.projects.list sur ce parent. Si vous disposez de cette autorisation, tous les projets situés sous le parent seront affichés une fois les filtres restants appliqués.

Si vous ne disposez pas de cette autorisation, tous les projets pour lesquels vous disposez de l'autorisation resourcemanager.projects.get seront renvoyés une fois les filtres restants appliqués.

Si vous ne spécifiez pas de parent, les résultats incluent tous les projets pour lesquels vous disposez des autorisations resourcemanager.projects.get.

gcloud

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

PROJECT_ID : ID du projet Google Cloud

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud alpha projects search --query="name:z*"

Windows (PowerShell)

gcloud alpha projects search --query="name:z*"

Windows (cmd.exe)

gcloud alpha projects search --query="name:z*"

Vous devriez obtenir un résultat semblable à celui-ci :

The response contains the projects with names starting with 'z'

REST

Méthode HTTP et URL :

GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain

Corps JSON de la requête :

{}

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain"

PowerShell

Remarque : Pour la commande suivante, nous partons du principe que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
      "projects": [
        {
          "name": "projects/951040570662",
          "parent": "folders/662951040570",
          "projectId": "tokyo-rain-123",
          "state": "ACTIVE",
          "displayName": "Tokyo Rain",
          "createTime": "2013-11-13T20:31:53.308Z",
          "updateTime": "2013-11-13T20:31:53.308Z",
          "etag": "BwWUlZ6XEfY="
        }
      ]
}

Mettre à jour des projets

Vous pouvez modifier le nom, les libellés et les tags du projet. Pour en savoir plus sur la mise à jour des projets, consultez la page de référence de l'API du projet. Pour mettre à jour des projets, utilisez l'une des méthodes suivantes :

Console

Pour mettre à jour le nom ou les libellés d'un projet à l'aide de la Google Cloud console, procédez comme suit :

Dans la console Google Cloud , accédez à la page Paramètres de IAM et administration.
Accéder à la page Paramètres de la section IAM et administration

Les étapes restantes s'affichent dans la console Google Cloud .
En haut de l'écran, cliquez sur la liste déroulante de sélection de projets.
Dans la fenêtre Sélectionnez une organisation qui s'affiche, cliquez sur la liste déroulante des organisations, puis sélectionnez votre organisation. Si vous êtes un utilisateur de la version d'essai sans frais, ignorez cette étape car cette liste n'apparaîtra pas.
Sélectionnez votre projet dans la liste qui apparaît.
Pour changer le nom du projet, modifiez le nom du projet, puis cliquez sur Enregistrer.
Pour ajouter ou modifier des tags, accédez à la section Tags de la page, puis cliquez sur Gérer les tags. Pour savoir comment ajouter ou modifier des clés et des valeurs de tags, consultez Créer et gérer des tags.
Pour changer les libellés, cliquez sur Libellés dans la barre de navigation de gauche.
En savoir plus sur l'utilisation des libellés.

gcloud

Dans la console Google Cloud , activez Cloud Shell.

Activer Cloud Shell

En bas de la console Google Cloud , une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.
Pour mettre à jour le nom ou les libellés d'un projet, exécutez la commande gcloud alpha projects update :
```
gcloud alpha projects update PROJECT_ID \
   --name=NAME \
   --update-labels=KEY=VALUE, ...
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet que vous souhaitez mettre à jour.
- NAME : nouveau nom que vous souhaitez attribuer au projet.
- KEY : clé d'un libellé que vous souhaitez modifier.
- VALUE : valeur d'un libellé que vous souhaitez modifier.
Pour obtenir plus d'informations ainsi que des options supplémentaires pouvant être utilisées avec cette commande, consultez le SDK Google Cloud CLI.

REST

Pour mettre à jour un projet, procédez comme suit :

Récupérez l'objet project à l'aide de la méthode projects.get.
Modifiez les champs que vous souhaitez mettre à jour.
Appelez la méthode projects.patch.

L'exemple suivant met à jour le nom à afficher du projet en myproject et définit le libellé color sur red :

Requête :

PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NUMBER?updateMask=displayName,labels

PROJECT_NUMBER correspond à l'ID numérique du projet que vous souhaitez mettre à jour.

Corps JSON de la requête :

{
  "displayName": "myproject",
  "labels": {
    "color": "red"
  }
}

Réponse :

{
  "projects": [
    {
      "name": "projects/951054970012",
      "parent": "folders/662951040570",
      "projectId": "Osaka-rain-234",
      "state": "ACTIVE",
      "displayName": "myproject",
      "createTime": "2013-11-13T20:31:53.308Z",
      "updateTime": "2013-11-13T20:35:42.308Z",
      "etag": "BwWUlZ6XEfY=",
      "labels": {
        "color": "red"
      }
    }
  ]
}

Étapes suivantes

Découvrez comment déplacer un projet dans la hiérarchie de vos ressources.
Découvrez comment migrer un projet d'une ressource d'organisation vers une autre.

Afficher et modifier des projets Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Trouver le nom, le numéro et l'ID du projet

Console

Obtenir un projet existant

gcloud

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

Répertorier tous les projets d'une ressource

REST

curl

PowerShell

Rechercher des projets

gcloud

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

Mettre à jour des projets

Console

gcloud

REST

Étapes suivantes

Afficher et modifier des projets