Cette page explique comment obtenir la taille de vos buckets Cloud Storage.
Rôles requis
Pour avoir les autorisations requises pour obtenir la taille d'un bucket Cloud Storage, demandez à votre administrateur de vous accorder le rôle d'administrateur de l'espace de stockage (roles/storage.objectViewer) sur le bucket. Si vous prévoyez d'utiliser la console Google Cloud , demandez à votre administrateur de vous attribuer le rôle de lecteur Monitoring (roles/monitoring.viewer) sur le projet contenant le bucket.
Ces rôles contiennent les autorisations requises pour obtenir la taille d'un bucket.
Pour afficher les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
storage.objects.list
Cette autorisation n'est requise que pour exécuter les instructions de cette page à l'aide de Google Cloud CLI.
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
Dans la barre d'outils de la console Google Cloud , sélectionnez votre projet Google Cloud .
Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.
Dans l'élément Métrique, développez le menu Sélectionner une métrique, saisissez Total bytes (v2) dans la barre de filtre, puis utilisez les sous-menus pour sélectionner un type de ressource et des métriques spécifiques :
Dans le menu Ressources actives, sélectionnez Bucket GCS.
Dans le menu Catégories de métriques actives, sélectionnez Stockage.
Dans le menu Métriques actives, sélectionnez Nombre total d'octets (V2).
Cliquez sur Appliquer.
Le nom complet de cette métrique est storage.googleapis.com/storage/v2/total_bytes.
Pour ajouter des filtres qui suppriment des séries temporelles des résultats de la requête, utilisez l'élément Filtre.
Pour combiner des séries temporelles, utilisez les menus de l'élément Agrégation.
Par exemple, pour afficher l'utilisation du processeur pour vos VM en fonction de leur zone, définissez le premier menu sur Moyenne et le second sur zone.
Toutes les séries temporelles sont affichées lorsque le premier menu de l'élément Agrégation est défini sur Non agrégé. Les paramètres par défaut de l'élément Aggregation (Agrégation) sont déterminés par le type de métrique que vous avez sélectionné.
Pour le quota et les autres métriques qui indiquent un échantillon par jour, procédez comme suit :
Dans le volet Affichage, définissez le type de widget sur Graphique à barres empilées.
Définissez la période sur au moins une semaine.
Vous pouvez également utiliser l'explorateur de métriques pour mesurer d'autres métriques de bucket, telles que storage.googleapis.com/storage/object_count et storage.googleapis.com/storage/v2/total_byte_seconds, qui mesurent le nombre quotidien d'objets et la consommation quotidienne de stockage respectivement. Consultez la documentation sur les métriquesGoogle Cloud pour obtenir la liste complète des métriques disponibles et la page Métriques, séries temporelles et ressources pour plus d'informations sur l'utilisation de l'explorateur de métriques.
Ligne de commande
Exécutez la commande gcloud storage du avec une option --summarize :
gcloud storage du gs://BUCKET_NAME --summarize
où BUCKET_NAME est le nom du bucket concerné.
La réponse est semblable à ceci :
134620 gs://my-bucket
Dans cet exemple, la taille du bucket my-bucket est de 134 620 octets.
Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de Cloud Storage en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[],[],null,["[Concepts](/storage/docs/bucket-metadata)\n\nThis page shows you how to get the size of your Cloud Storage [buckets](/storage/docs/buckets).\n\nRequired roles\n\nIn order to get the required permissions for getting the size of a\nCloud Storage bucket, ask your administrator to grant you the Storage\nObject Viewer (`roles/storage.objectViewer`) role on the bucket. If you plan on\nusing the Google Cloud console, ask your administrator to grant you the\nMonitoring Viewer (`roles/monitoring.viewer`) role on the project that contains\nthe bucket instead.\n\nThese roles contain the permissions required to get the size of a bucket.\nTo see the exact permissions that are required, expand the\n**Required permissions** section: \n\nRequired permissions\n\n- `storage.objects.list`\n - This permission is only required for using the Google Cloud CLI to perform the instructions on this page.\n\nTo see the permissions associated with `roles/monitoring.viewer`,\nrefer to the\n[Monitoring Viewer documentation](/iam/docs/understanding-roles#monitoring.editor).\n\nYou might be able to get the required permission with other\n[predefined roles](/iam/docs/understanding-roles) or [custom roles](/iam/docs/creating-custom-roles). For instructions on granting roles\non buckets, see [Use IAM with buckets](/storage/docs/access-control/using-iam-permissions#bucket-iam). For instructions on\ngranting roles on projects, see [Manage access to projects](/iam/docs/granting-changing-revoking-access).\n\nDetermine a bucket's size \n\nConsole**Note:** Monitoring measures bucket size once a day and does not report empty buckets. To measure bucket size at a given moment for any bucket, use `gcloud storage` instead.\n\nTo view the metrics for a monitored resource by using the\nMetrics Explorer, do the following:\n\n1. In the Google Cloud console, go to the\n *leaderboard* **Metrics explorer** page:\n\n [Go to **Metrics explorer**](https://console.cloud.google.com/monitoring/metrics-explorer)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Monitoring**.\n2. In the toolbar of the Google Cloud console, select your Google Cloud project. For [App Hub](/app-hub/docs/overview) configurations, select the App Hub host project or the app-enabled folder's management project.\n3. In the **Metric** element, expand the **Select a metric** menu, enter `Total bytes (v2)` in the filter bar, and then use the submenus to select a specific resource type and metric:\n 1. In the **Active resources** menu, select **GCS Bucket**.\n 2. In the **Active metric categories** menu, select **Storage**.\n 3. In the **Active metrics** menu, select **Total bytes (v2)**.\n 4. Click **Apply**.\n\n The fully qualified name for this metric is **storage.googleapis.com/storage/v2/total_bytes**.\n4. To add filters, which remove time series from the query results, use the\n [**Filter** element](/monitoring/charts/metrics-selector#filter-option).\n\n5. To combine time series, use the menus on the\n [**Aggregation** element](/monitoring/charts/metrics-selector#select_display).\n For example, to display the CPU utilization for your VMs, based on their zone, set the\n first menu to **Mean** and the second menu to **zone**.\n\n All time series are displayed when the first menu of the **Aggregation** element is set\n to **Unaggregated** . The default settings for the **Aggregation** element\n are determined by the metric type you selected.\n6. For quota and other metrics that report one sample per day, do the following:\n 1. In the **Display** pane, set the **Widget type** to **Stacked bar chart**.\n 2. Set the time period to at least one week.\n\nYou can also use the Metrics Explorer to measure other bucket metrics\nsuch as **storage.googleapis.com/storage/object_count** and\n**storage.googleapis.com/storage/v2/total_byte_seconds** , which measure the\ndaily number of objects and the daily storage consumed, respectively. See\nthe [Google Cloud metrics documentation](/monitoring/api/metrics_gcp_p_z#gcp-storage) for a complete list of\navailable metrics and [Metrics, time series, and resources](/monitoring/api/v3/metrics) for more\ninformation about using the Metrics Explorer.\n\nCommand line**Caution:** The `gcloud storage du` command calculates the current space usage by making a series of object listing requests, which can take a long time for large buckets. If the number of objects in your bucket is hundreds of thousands or more, or if you want to monitor your bucket size over time, use Monitoring instead, as described in the Console tab.\n\nUse the [`gcloud storage du`](/sdk/gcloud/reference/storage/du) command with a `--summarize` flag: \n\n```\ngcloud storage du gs://BUCKET_NAME --summarize\n```\n\nwhere \u003cvar translate=\"no\"\u003eBUCKET_NAME\u003c/var\u003e is the name of the relevant\nbucket.\n\nThe response looks like the following example: \n\n```\n134620 gs://my-bucket\n```\n\nIn this example, the size of the bucket named `my-bucket` is 134,620\nbytes.\n\nWhat's next\n\n- [List the objects in your bucket](/storage/docs/listing-objects).\n- [Get object metadata](/storage/docs/viewing-editing-metadata).\n- [Learn more about monitoring your resources in Monitoring](/monitoring/api/v3/metrics).\n\nTry it for yourself\n\n\nIf you're new to Google Cloud, create an account to evaluate how\nCloud Storage performs in real-world\nscenarios. New customers also get $300 in free credits to run, test, and\ndeploy workloads.\n[Try Cloud Storage free](https://console.cloud.google.com/freetrial)"]]
