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 Cloud de Confiance by S3NS , 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

  1. Accédez à la page d'accueil de la console Cloud de Confiance .

    Accéder à la page d'accueil

  2. Dans le sélecteur de projets situé en haut de la page, sélectionnez votre projet.

    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 Cloud de Confiance by S3NS 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 Cloud de Confiance by S3NS

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 Cloud de Confiance by S3NS

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

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

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 Cloud de Confiance by S3NS

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

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 Cloud de Confiance by S3NS

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

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 Cloud de Confiance console, procédez comme suit :

  1. Dans la console Cloud de Confiance , 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 Cloud de Confiance .

  2. En haut de l'écran, cliquez sur la liste déroulante de sélection de projets.
  3. 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.
  4. Sélectionnez votre projet dans la liste qui apparaît.
  5. Pour changer le nom du projet, modifiez le nom du projet, puis cliquez sur Enregistrer.
  6. 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.
  7. 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

  1. Dans la console Cloud de Confiance , activez Cloud Shell.

    Activer Cloud Shell

    En bas de la console Cloud de Confiance , 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.

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