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.
Roles obligatorios
Para obtener los permisos necesarios para cambiar la clase de almacenamiento de un bucket, pídele a tu administrador que te otorgue el rol de IAM de Administrador de almacenamiento (roles/storage.admin
) en el bucket.
Este rol predefinido contiene los permisos necesarios para cambiar la clase de almacenamiento de un bucket. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
storage.buckets.get
- Este permiso solo es necesario si planeas usar la consola de Google Cloud para ejecutar las instrucciones en esta página.
storage.buckets.list
- Este permiso solo es necesario si planeas usar la consola de Google Cloud para ejecutar las instrucciones en esta página.
storage.buckets.update
También puedes obtener estos permisos con roles personalizados.
Para obtener instrucciones para otorgar roles a los buckets, consulta Usa IAM con buckets.
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 buckets, haz clic en el nombre del bucket cuya clase de almacenamiento deseas cambiar.
En la página de detalles del bucket haz clic en la pestaña Configuración.
Haz clic en el ícono Cambiar (edit) para ver la Configuración predeterminada de la clase de almacenamiento.
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 acerca de operaciones fallidas de Cloud Storage en la consola de Google Cloud, consulta Solución de problemas.
Línea de comandos
Usa el comando gcloud storage buckets update
con la marca --default-storage-class
:
gcloud storage buckets update gs://BUCKET_NAME --default-storage-class=STORAGE_CLASS
Donde:
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
Bibliotecas cliente
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C++.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C#.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Go.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Java.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Node.js.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage PHP.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Python.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Ruby.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
API de REST
API de JSON
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization
.Crea un archivo JSON que contenga la siguiente información:
{ "storageClass": "STORAGE_CLASS" }
Donde
STORAGE_CLASS
es la nueva clase de almacenamiento que deseas para tu bucket. Por ejemplo,nearline
Usa
cURL
para llamar a la API de JSON con una solicitud 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=storageClass"
Donde:
JSON_FILE_NAME
es la ruta de acceso del archivo JSON que creaste en el paso 2.BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
API de XML
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization
.Crea un archivo XML que contenga la siguiente información:
<StorageClass>STORAGE_CLASS</StorageClass>
Donde
STORAGE_CLASS
es el nombre de la nueva clase de almacenamiento que deseas para tu bucket. Por ejemplo,nearline
.Usa
cURL
para llamar a la API de XML con una solicitud de bucketPUT
con alcance de?storageClass
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-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.BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
.
¿Qué sigue?
- Mueve o cambia el nombre de un bucket.
- Sube un objeto.
- Cambia la clase de almacenamiento de un objeto.
- Administra los ciclos de vida de los objetos.
- Obtén información sobre la administración automática de clases de almacenamiento con Autoclass.