Vous pouvez afficher les détails des dossiers, modifier les noms à afficher, déplacer des dossiers et supprimer les dossiers inutiles à l'aide de la console Google Cloud , de la Google Cloud CLI ou de l'API Cloud Resource Manager. La gestion des dossiers vous permet d'organiser vos ressources et de maintenir votre hiérarchie de ressources Google Cloud à mesure que les projets et les équipes évoluent.
Lister les dossiers et afficher leurs détails
Pour lister des dossiers ou afficher les métadonnées d'un dossier spécifique, telles que son nom à afficher, l'ID de son parent et son état de cycle de vie, vous devez disposer du rôle Lecteur de dossiers (roles/resourcemanager.folderViewer) ou Lecteur de l'organisation (roles/resourcemanager.organizationViewer).
Console
Dans la console Google Cloud , accédez à la page Gérer les ressources.
La liste des ressources affiche votre hiérarchie sous forme de tableau. Sélectionnez votre ressource d'organisation.
Cliquez sur la flèche à côté du nom de l'organisation pour développer l'arborescence et afficher ses dossiers enfants.
Pour effectuer des actions, telles que déplacer, supprimer ou afficher des paramètres, cliquez sur Actions à la fin de la ligne de la ressource concernée.
Utilisez la barre Filtre en haut de la liste des ressources pour rechercher des ressources par nom, ID ou étiquette.
Pour savoir comment la page Gérer les ressources calcule le code temporel Dernier accès pour les dossiers et les projets, consultez Comprendre le code temporel Dernier accès.
Utiliser le sélecteur de projet
Le sélecteur de projet se trouve dans la barre de navigation et ne fait pas partie de l'interface de la page principale de Resource Manager. Utilisez-la pour basculer votre contexte global actif vers un projet ou un dossier spécifique.
Cliquez sur le sélecteur de projet. Dans la boîte de dialogue qui s'affiche, sélectionnez votre organisation dans la liste déroulante pour filtrer les résultats.
Parcourez la hiérarchie ou recherchez le projet ou le dossier vers lequel vous souhaitez basculer. En cliquant sur une ressource dans ce sélecteur, vous modifiez votre contexte global, ce qui affecte les ressources visibles sur les pages d'autres services (comme Compute Engine ou Cloud Storage).
gcloud
Pour obtenir les détails d'un dossier, utilisez la commande gcloud resource-manager folders describe :
gcloud resource-manager folders describe FOLDER_ID
Remplacez FOLDER_ID par l'ID du dossier que vous souhaitez afficher.
Pour lister les dossiers enfants d'une ressource d'organisation, utilisez la commande gcloud resource-manager folders list :
gcloud resource-manager folders list \
--organization=ORGANIZATION_ID
Remplacez ORGANIZATION_ID par l'ID de la ressource d'organisation pour laquelle vous souhaitez afficher la liste des dossiers enfants.
Pour lister les dossiers enfants d'une ressource de dossier, utilisez la commande gcloud resource-manager folders list :
gcloud resource-manager folders list \
--folder=FOLDER_ID
Remplacez FOLDER_ID par l'ID de la ressource de dossier pour laquelle vous souhaitez afficher la liste des dossiers enfants.
Pour lister les projets d'une ressource d'organisation ou de dossier, utilisez la commande gcloud projects list avec l'option --filter :
gcloud projects list \
--filter="parent.id='RESOURCE_ID'"
Remplacez RESOURCE_ID par l'ID de la ressource d'organisation ou de dossier pour laquelle vous souhaitez afficher la liste des projets enfants.
REST
Requête curl pour obtenir des dossiers :
curl -X GET -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/FOLDER_ID
Remplacez FOLDER_NAME par le nom du dossier, par exemple folders/123.
Requête curl pour répertorier des dossiers :
curl -X GET -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/folders?parent=PARENT_NAME
Remplacez PARENT_NAME par le nom de la ressource parente sous laquelle vous créez le dossier, par exemple organizations/123 ou folders/123.
Mettre à jour des dossiers
Pour modifier le nom à afficher d'un dossier, vous devez disposer du rôle Éditeur de dossier (roles/resourcemanager.folderEditor) ou Administrateur de dossier (roles/resourcemanager.folderAdmin) sur le dossier.
Console
Dans la console Google Cloud , accédez à la page Gérer les ressources.
Cliquez sur la flèche à côté du nom de l'organisation pour développer l'arborescence et afficher ses dossiers enfants.
Sur la ligne du dossier que vous souhaitez mettre à jour, cliquez sur le menu Actions à la fin de la ligne, puis sur Paramètres.
Saisissez le nouveau nom du dossier, puis cliquez sur Enregistrer.
gcloud
Pour mettre à jour le nom à afficher d'un dossier, utilisez la commande gcloud resource-manager folders update :
gcloud resource-manager folders update FOLDER_ID \ --display-name="NEW_DISPLAY_NAME"
Remplacez les éléments suivants :
FOLDER_ID: ID du dossier que vous souhaitez mettre à jour.NEW_DISPLAY_NAME: nouveau nom à afficher du dossier.
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- FOLDER_ID : ID du dossier Google Cloud
- NEW_DISPLAY_NAME : nouveau nom à afficher du dossier
Méthode HTTP et URL :
PATCH https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName
Corps JSON de la requête :
{
"displayName": "NEW_DISPLAY_NAME"
}
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 PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName"
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 PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{
"name": "operations/fc.1234567890abcdef",
"metadata": {
"@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperationMetadata",
"displayName": "NEW_DISPLAY_NAME",
"operationType": "UPDATE",
"resourceName": "folders/FOLDER_ID"
},
"done": false
}
Déplacer un dossier vers un autre dossier
Pour déplacer un dossier dans un autre dossier, vous devez disposer de l'autorisation resourcemanager.folders.move pour les dossiers source et de destination.
Console
Le processus consistant à déplacer des dossiers dans d'autres dossiers de la console s'apparente au transfert de projets.
- Dans la console Google Cloud , ouvrez la page "Gérer les ressources".
- Sélectionnez votre ressource d'organisation dans le menu déroulant Organisation en haut à gauche de la page.
- Cliquez sur la ligne de votre dossier pour le sélectionner dans la liste des projets et des dossiers.
- Cliquez sur le menu d'options (trois points verticaux) sur la ligne, puis sur Déplacer.
- Cliquez sur Parcourir pour sélectionner le dossier dans lequel vous souhaitez déplacer le dossier.
- Cliquez sur Déplacer.
gcloud
Pour déplacer un dossier sous la ressource d'organisation, exécutez la commande suivante dans la Google Cloud CLI :
gcloud resource-manager folders move FOLDER_ID \ --organization=PARENT_ID
Remplacez les éléments suivants :
FOLDER_ID: ID du dossier que vous souhaitez déplacer.PARENT_ID: ID de la ressource d'organisation parente.
Pour déplacer un dossier sous un autre dossier :
gcloud resource-manager folders move FOLDER_ID \ --folder=PARENT_ID
Remplacez les éléments suivants :
FOLDER_ID: ID du dossier que vous souhaitez déplacer.PARENT_ID: ID du dossier parent.
REST
Requête JSON :
request_json= '{
destinationParent: "folders/DESTINATION_FOLDER_ID"
}'
Requête curl pour déplacer un dossier :
curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token} \
-d "$request_json" \
https://cloudresourcemanager.googleapis.com/v3/folders/DISPLAY_NAME:move
Remplacez les éléments suivants :
- DESTINATION_FOLDER_ID : ID du dossier sous lequel vous déplacez un autre dossier, par exemple
98765. - DISPLAY_NAME : nom à afficher du dossier en cours de déplacement, par exemple "Mon super dossier".
Réponse pour le transfert de dossier :
{
"name": "operations/fm.1234567890",
"metadata": {
"@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
"displayName": "DISPLAY_NAME",
"operationType": "MOVE"
}
}
Requête curl pour l'opération Get :
curl -H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/operations/fm.1234567890
Réponse pour l'opération Get :
{
"name": "operations/fm.1234567890",
"metadata": {
"@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
"displayName": "DISPLAY_NAME",
"operationType": "MOVE"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.resourcemanager.v3.Folder",
"name": "folders/12345",
"parent": "folders/98765",
"displayName": "DISPLAY_NAME",
"lifecycleState": "ACTIVE",
"createTime": "2017-07-19T23:29:26.018Z",
"updateTime": "2017-07-20T00:54:44.295Z"
}
}
Supprimer des dossiers
Pour supprimer un dossier, vous devez disposer du rôle Éditeur de dossier (roles/resourcemanager.folderEditor) ou Administrateur de dossier (roles/resourcemanager.folderAdmin) sur le dossier.
Console
Dans la console Google Cloud , accédez à la page Gérer les ressources.
Dans la console Google Cloud , accédez à la page "Gérer les ressources".Cliquez sur la flèche à côté du nom de l'organisation pour développer l'arborescence et afficher ses dossiers enfants.
Sur la ligne du dossier que vous souhaitez supprimer, cliquez sur le menu Actions à la fin de la ligne, puis sur Supprimer.
Dans la boîte de dialogue de confirmation, saisissez l'ID ou le nom du dossier pour confirmer, puis cliquez sur Supprimer.
gcloud
Pour supprimer un dossier, exécutez la commande suivante :
gcloud resource-manager folders delete FOLDER_ID
Remplacez les éléments suivants :
FOLDER_ID: ID du dossier que vous souhaitez supprimer.
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 :
DELETE https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID"
PowerShell
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{
"name": "operations/fc.1234567890abcdef",
"metadata": {
"@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperationMetadata",
"operationType": "DELETE",
"resourceName": "folders/FOLDER_ID"
},
"done": false
}
Informations supplémentaires
Lorsque vous supprimez un dossier, il passe à l'état de suppression réversible pendant une période de conservation de 30 jours avant d'être définitivement supprimé.
État de suppression réversible : pendant la période de conservation de 30 jours, le dossier est marqué pour suppression et n'est plus actif. Vous ne pouvez pas créer de projets ni de sous-dossiers dans un dossier soumis à une suppression réversible.
État de suppression définitive : après 30 jours, Google Cloud supprime définitivement le dossier et ses métadonnées. Cette action est irréversible.
Annuler la suppression : si vous supprimez accidentellement un dossier, vous pouvez le restaurer dans un délai de 30 jours à l'aide de la commande gcloud resource-manager folders undelete ou de l'API.
Prérequis et contraintes
- Le dossier doit être vide : vous ne pouvez pas supprimer un dossier qui contient encore des projets ou des sous-dossiers actifs. Vous devez d'abord déplacer ou supprimer toutes les ressources enfants.
- Autorisations requises : pour supprimer ou annuler la suppression d'un dossier, vous devez disposer du rôle Éditeur de dossier (
roles/resourcemanager.folderEditor) ou Administrateur de dossier (roles/resourcemanager.folderAdmin).
Rechercher
Pour rechercher des dossiers correspondant à une requête spécifique, utilisez la commande gcloud alpha resource-manager folders search et transmettez votre condition de recherche dans l'option --query. Le champ d'application de la recherche inclut tous les dossiers que vous êtes autorisé à afficher.
Par exemple, pour rechercher des dossiers dont le nom à afficher commence par vij, comme vijeta ou vijay-folder, exécutez la commande suivante :
gcloud alpha resource-manager folders search --query="displayName:vij*"
Pour rechercher les dossiers en attente de suppression, exécutez la commande suivante :
gcloud alpha resource-manager folders search --query="state:DELETE_REQUESTED"
Pour renvoyer tous les dossiers que vous êtes autorisé à afficher, exécutez la commande gcloud alpha resource-manager folders search sans l'option --query :
gcloud alpha resource-manager folders search
Étapes suivantes
- Découvrez comment gérer des projets dans des dossiers.
- En savoir plus sur les rôles et autorisations pour les dossiers