Cette page vous explique comment activer, désactiver et vérifier l'état de la fonctionnalité de classe automatique, qui est définie sur un bucket dans Cloud Storage.
Rôles requis
Pour obtenir les autorisations nécessaires pour définir et gérer la classe automatique sur un bucket, demandez à votre administrateur de vous accorder le rôle IAM d'administrateur de l'espace de stockage (roles/storage.admin
) sur le bucket. Ce rôle prédéfini contient les autorisations requises pour définir et gérer la classe automatique sur un bucket. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
storage.buckets.get
storage.buckets.list
- Cette autorisation n'est nécessaire que pour effectuer les tâches décrites sur cette page à l'aide de la console Google Cloud.
storage.buckets.update
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés.
Pour en savoir plus sur l'attribution de rôles dans des buckets, consultez la page Utiliser IAM avec des buckets.
Définir la classe automatique d'un bucket
Pour définir la classe automatique d'un bucket, procédez comme suit :
Console
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
Dans la liste des buckets, cliquez sur le nom du bucket souhaité.
Sur la page Informations sur le bucket, cliquez sur l'onglet Configuration.
Cliquez sur l'icône Modifier (edit) pour Classe de stockage par défaut.
Dans la fenêtre superposée, sélectionnez Autoclass pour activer la classe automatique. Pour désactiver la classe automatique, sélectionnez Définir une classe par défaut, puis une classe de stockage par défaut pour le bucket.
Cliquez sur Confirmer.
Pour changer la classe de stockage du terminal d'un bucket pour lequel la classe automatique est activée, cliquez sur l'icône Modifier (edit) à côté de Classes incluses, puis cliquez sur Confirmer dans la fenêtre qui apparaît en superposition.
Ligne de commande
Exécutez la commande gcloud storage buckets update
avec l'option appropriée :
gcloud storage buckets update gs://BUCKET_NAME FLAG
Où :
BUCKET_NAME
correspond au nom du bucket concerné. Par exemple,my-bucket
.FLAG
est l'un des éléments suivants :--enable-autoclass
pour activer la classe automatique.--no-enable-autoclass
pour désactiver la classe automatique.--autoclass-terminal-storage-class=CLASS
permet de définir la classe de stockage du terminal pour la classe automatique. CLASS peut correspondre àNEARLINE
ouARCHIVE
.
Si l'opération réussit, la réponse se présente comme suit :
Updating gs://my-bucket/... Completed 1
Bibliothèques clientes
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
C#
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C#.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
Node.js
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Node.js.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
PHP
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage PHP.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Ruby.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
API REST
API JSON
Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête
Authorization
.Créez un fichier JSON contenant les informations suivantes :
{ "storageClass": "DEFAULT_CLASS", "autoclass": { "enabled": BOOLEAN, "terminalStorageClass":TERMINAL_CLASS } }
Où :
DEFAULT_CLASS
définit les métadonnées de la classe de stockage pour le bucket. Lorsque vous activez la classe automatique,STANDARD
est la seule valeur valide. Elle est obligatoire si le bucket utilise actuellement une classe de stockage différente.BOOLEAN
est défini surtrue
pour activer la classe automatique ou surfalse
pour la désactiver.TERMINAL_CLASS
est la classe de stockage du terminal à utiliser lorsque la classe automatique est activée.
Exécutez
cURL
pour appeler l'API JSON avec une requête de bucketPATCH
:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=autoclass"
Où :
JSON_FILE_NAME
correspond au chemin d'accès au fichier JSON que vous avez créé à l'étape 2.BUCKET_NAME
correspond au nom du bucket concerné. Exemple :my-bucket
API XML
Cette fonctionnalité ne peut pas être gérée via l'API XML. Utilisez plutôt la console Google Cloud ou un autre outil.
Afficher l'état de la classe automatique d'un bucket
Pour afficher l'état de la classe automatique d'un bucket individuel, procédez comme suit :
Console
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
Cliquez sur le nom du bucket dont vous souhaitez vérifier l'état.
Cliquez sur l'onglet Configuration.
L'état de la classe automatique est affiché dans le champ Classe de stockage par défaut.
Si la classe automatique est activée, le champ indique Géré avec la classe automatique et le champ Classes incluses affiche les classes de stockage entre lesquelles les objets peuvent transiter.
Ligne de commande
Exécutez la commande gcloud storage buckets describe
avec l'option --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(autoclass)"
Où BUCKET_NAME
correspond au nom du bucket dont vous souhaitez afficher l'état. Exemple :my-bucket
Si l'opération réussit, la réponse se présente comme suit :
autoclass: enabled: true terminalStorageClass: ARCHIVE terminalStorageClassUpdateTime: '2023-02-10T16:11:02.384000+00:00' toggleTime: '2022-11-09T16:01:40.775000+00:00'
Bibliothèques clientes
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
C#
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C#.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
Node.js
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Node.js.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
PHP
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage PHP.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Ruby.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
API REST
API JSON
Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête
Authorization
.Utilisez
cURL
pour appeler l'API JSON avec une requête de bucketGET
incluant le champautoclass
:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=autoclass"
Où
BUCKET_NAME
est le nom du bucket concerné. Exemple :my-bucket
Si la classe automatique est activée sur le bucket, la réponse se présente comme suit :
{ "autoclass": { "enabled": "BOOLEAN", "toggleTime": "DATETIME", "terminalStorageClass": "STORAGE_CLASS", "terminalStorageClassUpdateTime": "DATETIME" }, }
API XML
Cette fonctionnalité ne peut pas être gérée via l'API XML. Utilisez plutôt la console Google Cloud ou un autre outil.
Étapes suivantes
- Apprenez-en plus sur la classe automatique.
- Découvrez la gestion du cycle de vie des objets, qui modifie automatiquement la classe de stockage d'un objet lorsqu'elle répond aux critères que vous spécifiez.