En esta página, se muestra cómo cambiar la clase de almacenamiento predeterminada para un bucket. Cuando subes un objeto al bucket, se le asigna la clase de almacenamiento predeterminada del bucket, en caso de que no especifiques una clase de almacenamiento para el objeto. Para obtener más información sobre las clases de almacenamiento, consulta las Clases de almacenamiento.
Prerequisites
Los requisitos previos pueden variar según la herramienta que se use:
Consola
Para completar esta guía con Google Cloud Console, debes tener los permisos de IAM adecuados. Si no creaste el bucket al que deseas acceder, es posible que el propietario del proyecto te otorgue una función que contenga los permisos necesarios.
A fin de obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para Google Cloud Console.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Línea de comandos
Para completar esta guía con una utilidad de línea de comandos, debes tener los permisos de IAM adecuados. Si no creaste el bucket al que deseas acceder, es posible que el propietario del proyecto te otorgue una función que contenga los permisos necesarios.
Si deseas obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para los comandos de gsutil.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Muestras de código
Para completar esta guía con las bibliotecas cliente de Cloud Storage, debes tener los permisos de IAM adecuados. Si no creaste el bucket al que deseas acceder, es posible que el propietario del proyecto te otorgue una función que contenga los permisos necesarios. A menos que se indique lo contrario, las solicitudes de la biblioteca cliente se realizan mediante la API de JSON.
Si deseas obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para métodos JSON.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
API de REST
API de JSON
Para completar esta guía con la API de JSON, debes tener los permisos de IAM adecuados. Si no creaste el bucket al que deseas acceder, es posible que el propietario del proyecto te otorgue una función que contenga los permisos necesarios.
Si deseas obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para métodos JSON.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Cambiar la clase de almacenamiento predeterminada de un bucket
Console
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
En la lista de bucket s, busca el bucket que deseas modificar y haz clic en su menú Ampliado del bucket (
).
Haz clic en Editar clase de almacenamiento predeterminada.
En la ventana de superposición, selecciona la clase de almacenamiento predeterminada nueva que quieres para tu bucket.
Haz clic en Guardar.
Para obtener información sobre cómo ver detalles de errores sobre operaciones fallidas de Cloud Storage en la consola, consulta Solución de problemas.
Línea de comandos
gcloud
Usa el comando gcloud alpha storage buckets update
con la marca --default-storage-class
:
gcloud alpha storage buckets update gs://BUCKET_NAME --default-storage-class=STORAGE_CLASS
Aquí:
BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
.STORAGE_CLASS
es la clase de almacenamiento nueva que deseas para tu bucket. Por ejemplo,nearline
.
La respuesta se ve como el siguiente ejemplo:
Setting default storage class to "nearline" for bucket gs://my-bucket
gsutil
Usa el comando gsutil defstorageclass set
:
gsutil defstorageclass set STORAGE_CLASS gs://BUCKET_NAME
Aquí:
STORAGE_CLASS
es la clase de almacenamiento nueva que deseas para tu bucket. Por ejemplo,nearline
.BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
La respuesta se ve como el siguiente ejemplo:
Setting default storage class to "nearline" for bucket gs://my-bucket
Muestras de código
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C++.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C#.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Go.
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Node.js.
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para PHP.
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Python.
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Ruby.
API de REST
API de JSON
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth. Para obtener instrucciones, consulta Autenticación de la API.
Crea un archivo JSON que contenga la siguiente información:
{ "storageClass": "STORAGE_CLASS" }
Donde
STORAGE_CLASS
es la clase de almacenamiento nueva que deseas para tu bucket. Por ejemplo,nearline
.Usa
cURL
para llamar a la API de JSON con una solicitud de depósitoPATCH
: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"
Aquí:
JSON_FILE_NAME
es la ruta de acceso del archivo JSON que creaste en el paso 2.OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.BUCKET_NAME
es el nombre del depósito correspondiente. Por ejemplo,my-bucket
.
API de XML
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth. Para obtener instrucciones, consulta Autenticación de la API.
Crea un archivo XML que contenga la siguiente información:
<StorageClass>STORAGE_CLASS</StorageClass>
Donde
STORAGE_CLASS
es el nombre de la clase de almacenamiento nueva que deseas para tu bucket. Por ejemplo,nearline
.Usa
cURL
para llamar a la API de XML con una solicitud de depósitoPUT
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?storageClass"
Aquí:
XML_FILE_NAME
es la ruta de acceso del archivo XML que creaste en el paso 2.OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.BUCKET_NAME
es el nombre del depósito correspondiente. Por ejemplo,my-bucket
.
¿Qué sigue?
- Mueve o cambia el nombre de un depósito.
- Borra un depósito.
- Sube un objeto.
- Cambia la clase de almacenamiento de un objeto.
- Administra los ciclos de vida de los objetos.