Cette page vous explique comment modifier la classe de stockage par défaut d'un bucket. Lorsque vous importez un objet dans un bucket sans lui allouer de classe de stockage, la classe de stockage par défaut du bucket lui est attribuée. Pour en savoir plus sur les classes de stockage, reportez-vous à la page Classes de stockage.
Autorisations requises
Console
Pour suivre ce guide à l'aide de Google Cloud Console, vous devez disposer des autorisations IAM appropriées. Si vous n'avez pas créé le bucket auquel vous souhaitez accéder, vous devrez peut-être demander au propriétaire du projet de vous attribuer un rôle contenant les autorisations nécessaires.
Pour obtenir la liste des autorisations requises pour des actions spécifiques, consultez la page Autorisations IAM pour Google Cloud Console.
Pour obtenir la liste des rôles pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.
Command line
Pour suivre ce guide à l'aide d'un utilitaire de ligne de commande, vous devez disposer des autorisations IAM appropriées. Si vous n'avez pas créé le bucket auquel vous souhaitez accéder, vous devrez peut-être demander au propriétaire du projet de vous attribuer un rôle contenant les autorisations nécessaires.
Pour obtenir la liste des autorisations requises pour des actions spécifiques, consultez la page Autorisations IAM pour les commandes gsutil.
Pour obtenir la liste des rôles pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.
Bibliothèques clientes
Pour suivre ce guide à l'aide des bibliothèques clientes Cloud Storage, vous devez disposer des autorisations IAM appropriées. Si vous n'avez pas créé le bucket auquel vous souhaitez accéder, vous devrez peut-être demander au propriétaire du projet de vous attribuer un rôle contenant les autorisations nécessaires.
Sauf indication contraire, les requêtes de bibliothèque cliente sont effectuées via l'API JSON et nécessitent des autorisations, comme indiqué dans la section Autorisations IAM pour les méthodes JSON. Pour savoir quelles méthodes d'API JSON sont appelées lorsque vous envoyez des requêtes à l'aide d'une bibliothèque cliente, consignez les requêtes brutes.
Pour obtenir la liste des rôles IAM pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.
API REST
API JSON
Pour suivre ce guide à l'aide de l'API JSON, vous devez disposer des autorisations IAM appropriées. Si vous n'avez pas créé le bucket auquel vous souhaitez accéder, vous devrez peut-être demander au propriétaire du projet de vous attribuer un rôle contenant les autorisations nécessaires.
Pour obtenir la liste des autorisations requises pour des actions spécifiques, consultez la page Autorisations IAM pour les méthodes JSON.
Pour obtenir la liste des rôles pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.
Modifier la classe de stockage par défaut d'un bucket
Console
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
Dans la liste de buckets, recherchez le bucket que vous souhaitez modifier, puis cliquez sur le menu déroulant qui lui est associé
.
Cliquez sur Modifier la classe de stockage par défaut.
Dans la fenêtre superposée, sélectionnez la nouvelle classe de stockage par défaut que vous souhaitez définir pour votre bucket.
Cliquez sur Save (Enregistrer).
Pour savoir comment obtenir des informations détaillées sur les erreurs liées aux opérations Cloud Storage ayant échoué dans la console Google Cloud, consultez la section Dépannage.
Ligne de commande
gcloud
Exécutez la commande gcloud storage buckets update
avec l'option --default-storage-class
:
gcloud storage buckets update gs://BUCKET_NAME --default-storage-class=STORAGE_CLASS
Où :
BUCKET_NAME
correspond au nom du bucket concerné. Par exemple,my-bucket
.STORAGE_CLASS
correspond à la nouvelle classe de stockage souhaitée pour votre bucket. Exemple :nearline
.
La réponse est semblable à ceci :
Setting default storage class to "nearline" for bucket gs://my-bucket
gsutil
Exécutez la commande gsutil defstorageclass set
:
gsutil defstorageclass set STORAGE_CLASS gs://BUCKET_NAME
Où :
STORAGE_CLASS
correspond à la nouvelle classe de stockage souhaitée pour votre bucket. Exemple :nearline
.BUCKET_NAME
correspond au nom du bucket concerné. Exemple :my-bucket
La réponse est semblable à ceci :
Setting default storage class to "nearline" for bucket gs://my-bucket
Bibliothèques clientes
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
C#
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C#.
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
Node.js
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Node.js.
PHP
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage PHP.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Ruby.
API REST
API JSON
- Obtenez un jeton d'autorisation d'accès sur la page OAuth 2.0 Playground. Configurez Playground pour utiliser vos propres identifiants OAuth. Pour obtenir des instructions, consultez la page Authentification des API.
Créez un fichier JSON contenant les informations suivantes :
{ "storageClass": "STORAGE_CLASS" }
Où
STORAGE_CLASS
correspond à la nouvelle classe de stockage que vous souhaitez pour votre bucket. Exemple :nearline
.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 OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=storageClass"
Où :
JSON_FILE_NAME
correspond au chemin d'accès au fichier JSON que vous avez créé à l'étape 2.OAUTH2_TOKEN
correspond au jeton d'accès que vous avez généré à l'étape 1.BUCKET_NAME
correspond au nom du bucket concerné. Exemple :my-bucket
API XML
- Obtenez un jeton d'autorisation d'accès sur la page OAuth 2.0 Playground. Configurez Playground pour utiliser vos propres identifiants OAuth. Pour obtenir des instructions, consultez la page Authentification des API.
Créez un fichier XML contenant les informations suivantes :
<StorageClass>STORAGE_CLASS</StorageClass>
Où
STORAGE_CLASS
correspond au nom de la nouvelle classe de stockage que vous souhaitez pour votre bucket. Par exemple,nearline
.Utilisez
cURL
pour appeler l'API XML avec une requête de bucketPUT
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?storageClass"
Où :
XML_FILE_NAME
correspond au chemin d'accès au fichier XML que vous avez créé à l'étape 2.OAUTH2_TOKEN
correspond au jeton d'accès que vous avez généré à l'étape 1.BUCKET_NAME
correspond au nom du bucket concerné. Par exemple,my-bucket
.
Étape suivante
- Déplacez ou renommez un bucket.
- Importez un objet.
- Modifiez la classe de stockage d'un objet.
- Gérez le cycle de vie des objets.
- Apprenez-en plus sur la gestion automatique des classes de stockage à l'aide de la fonctionnalité de classe automatique.