Cette page explique comment afficher les détails d'un dossier, modifier ses paramètres et le supprimer à l'aide de la Google Cloud console, de Google Cloud CLI ou de l'API. Découvrez comment modifier les noms à afficher des dossiers et gérer leur emplacement dans la hiérarchie de votre organisation.
Répertorier les dossiers et afficher leurs détails
Pour répertorier des dossiers ou afficher les métadonnées d'un dossier spécifique, telles que son nom à afficher, son ID parent et son état de cycle de vie, vous devez disposer du rôle Lecteur de dossier (roles/resourcemanager.folderViewer) ou du rôle Lecteur de l'organisation (roles/resourcemanager.organizationViewer).
Console
Dans la Google Cloud console, ouvrez 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 située à 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 le Actions à la fin de la ligne correspondant à cette ressource spécifique.
Utilisez la barre Filtrer en haut de la liste des ressources pour rechercher des ressources par nom, ID ou étiquette.
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 principale de la page Resource Manager. Utilisez-le pour remplacer votre contexte global actif par 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 le menu déroulant pour filtrer les résultats.
Parcourez la hiérarchie ou recherchez le projet ou le dossier vers lequel vous souhaitez basculer. Lorsque vous cliquez sur une ressource dans ce sélecteur, votre contexte global est modifié, ce qui affecte les ressources visibles sur les autres pages de service (comme Compute Engine ou Cloud Storage).
gcloud
Pour obtenir des détails sur un dossier, utilisez la commande resource-manager folders describe.
gcloud resource-manager folders describe FOLDER_ID
Remplacez FOLDER_ID par l'ID du dossier que vous souhaitez afficher.
Pour répertorier les dossiers enfants d'une ressource d'organisation, utilisez la commande 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 une liste de dossiers enfants.
Pour répertorier les dossiers enfants d'une ressource de dossier, utilisez la commande 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 une liste de dossiers enfants.
Pour répertorier les projets sous une ressource d'organisation ou de dossier, ou sous un dossier, utilisez la commande projects list avec l'argument 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 une liste de 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.
Modifier des dossiers
Pour modifier le nom à afficher d'un dossier, vous devez disposer du rôle Éditeur de dossier (roles/resourcemanager.folderEditor) ou du rôle Administrateur de dossier (roles/resourcemanager.folderAdmin) pour ce dossier.
Console
Dans la Google Cloud console, ouvrez la page Gérer les ressources.
Cliquez sur la flèche située à 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 modifier, cliquez sur le Actions menu à la fin de la ligne, puis sur Paramètres.
Saisissez le nouveau nom du dossier, puis cliquez sur Enregistrer.
gcloud
Pour modifier le nom à afficher d'un dossier :
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 modifier.NEW_DISPLAY_NAME: nouveau nom à afficher pour le dossier.
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- FOLDER_ID : ID du Google Cloud dossier
- NEW_DISPLAY_NAME : nouveau nom à afficher pour le 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,
et 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,
et 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 dans 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 Google Cloud console, ouvrez la page Gérer les ressources.