Usar Autoclass (original) (raw)

Ir al contenido principal

Usar Autoclass

Descripción general

En esta página se explica cómo habilitar, inhabilitar y comprobar el estado de la función Autoclass, que se configura en un segmento de Cloud Storage.

Roles obligatorios

Para obtener los permisos que necesitas para configurar y gestionar Autoclass en un segmento, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Storage (roles/storage.admin) en el segmento. Este rol predefinido contiene los permisos necesarios para configurar y gestionar Autoclass en un bucket. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

También puedes obtener estos permisos con roles personalizados.

Para obtener información sobre cómo conceder roles en los segmentos, consulta Definir y gestionar políticas de gestión de identidades y accesos en segmentos.

Configurar Autoclass en un segmento

Para configurar Autoclass en un contenedor, siga estas instrucciones:

Consola

  1. En la Google Cloud consola, ve a la página Segmentos de Cloud Storage.
    Ir a Contenedores
  2. En la lista de segmentos, haga clic en el nombre del segmento que quiera.
  3. En la página Detalles del segmento, haga clic en la pestaña Configuración.
  4. Haga clic en el icono Editar() de Clase de almacenamiento predeterminada.
  5. En la ventana superpuesta, selecciona Autoclass para habilitar Autoclass. Para inhabilitar Autoclass, selecciona Definir una clase predeterminada y, a continuación, selecciona una clase de almacenamiento predeterminada para el contenedor.
  6. Haz clic en Confirmar.
  7. Para cambiar la clase de almacenamiento de un terminal de un cubo que tenga Autoclass habilitado, haga clic en el icono Editar () de Clases incluidas y, a continuación, en Confirmar en la ventana superpuesta que aparece.

Línea de comandos

Usa el comando gcloud storage buckets update con las marcas adecuadas:

gcloud storage buckets update gs://BUCKET_NAME --default-storage-class=DEFAULT_CLASS AUTOCLASS_FLAG

Donde:

Si la solicitud se hace correctamente, la respuesta será similar a la del siguiente ejemplo:

Updating gs://my-bucket/... Completed 1

Bibliotecas de cliente

C++

Para obtener más información, consulta ladocumentación de referencia de la API C++ de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

C#

Para obtener más información, consulta ladocumentación de referencia de la API C# de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Go

Para obtener más información, consulta ladocumentación de referencia de la API Go de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Java

Para obtener más información, consulta ladocumentación de referencia de la API Java de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Node.js

Para obtener más información, consulta ladocumentación de referencia de la API Node.js de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

PHP

Para obtener más información, consulta ladocumentación de referencia de la API PHP de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Python

Para obtener más información, consulta ladocumentación de referencia de la API Python de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Ruby

Para obtener más información, consulta ladocumentación de referencia de la API Ruby de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

APIs REST

API JSON

  1. Tener gcloud CLI instalado e inicializado, lo que te permite generar un token de acceso para el encabezado Authorization.
  2. Crea un archivo JSON que contenga la siguiente información:
    {
    "storageClass": "DEFAULT_CLASS",
    "autoclass": {
    "enabled": BOOLEAN,
    "terminalStorageClass":TERMINAL_CLASS
    }
    }
    Donde:
    • DEFAULT_CLASS define los metadatos de la clase de almacenamiento del segmento. Al habilitar Autoclass, STANDARD es el único valor válido y es obligatorio si el segmento usa una clase de almacenamiento diferente.
    • BOOLEAN para habilitar Autoclass o false para inhabilitarlo.true
    • TERMINAL_CLASS es laclase de almacenamiento de terminal que se debe usar cuando Autoclass está habilitado.
  3. Usa cURL para llamar a la API JSON con una solicitud de PATCHcontenedor:
    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"
    Donde:
    • JSON_FILE_NAME es la ruta del archivo JSON que has creado en el paso 2.
    • BUCKET_NAME es el nombre del segmento correspondiente. Por ejemplo, my-bucket.

API XML

Esta función no se puede gestionar a través de la API XML. Usa la Google Cloud consola u otra herramienta.

Ver el estado de Autoclass de un cubo

Para ver el estado de Autoclass de un segmento concreto, sigue estos pasos:

Consola

  1. En la Google Cloud consola, ve a la página Segmentos de Cloud Storage.
    Ir a Contenedores
  2. Haga clic en el nombre del segmento cuyo estado quiera consultar.
  3. Haz clic en la pestaña Configuration (Configuración).
  4. El estado de Autoclass se muestra en el campo Clase de almacenamiento predeterminada.
    Si Autoclass está habilitado, el campo muestra Gestionado con Autoclass y el campo Clases incluidas muestra las clases de almacenamiento entre las que pueden cambiar los objetos.

Línea de comandos

Usa el comando gcloud storage buckets describe con la marca --format:

gcloud storage buckets describe gs://BUCKET_NAME --format="default(autoclass)"

Donde BUCKET_NAME es el nombre del contenedor cuyo estado quieres ver. Por ejemplo, my-bucket.

Si la solicitud se hace correctamente, la respuesta será similar a la del siguiente ejemplo:

autoclass: enabled: true terminalStorageClass: ARCHIVE terminalStorageClassUpdateTime: '2023-02-10T16:11:02.384000+00:00' toggleTime: '2022-11-09T16:01:40.775000+00:00'

Bibliotecas de cliente

C++

Para obtener más información, consulta ladocumentación de referencia de la API C++ de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

C#

Para obtener más información, consulta ladocumentación de referencia de la API C# de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Go

Para obtener más información, consulta ladocumentación de referencia de la API Go de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Java

Para obtener más información, consulta ladocumentación de referencia de la API Java de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Node.js

Para obtener más información, consulta ladocumentación de referencia de la API Node.js de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

PHP

Para obtener más información, consulta ladocumentación de referencia de la API PHP de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Python

Para obtener más información, consulta ladocumentación de referencia de la API Python de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Ruby

Para obtener más información, consulta ladocumentación de referencia de la API Ruby de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

APIs REST

API JSON

  1. Tener gcloud CLI instalado e inicializado, lo que te permite generar un token de acceso para el encabezado Authorization.
  2. Usa cURL para llamar a la API JSON con una solicitud GET Bucket que incluya el campo autoclass:
    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=autoclass"
    Donde BUCKET_NAME es el nombre del segmento correspondiente. Por ejemplo, my-bucket.
    Si el segmento tiene Autoclass habilitado, la respuesta será similar a la del siguiente ejemplo:
    {
    "autoclass": {
    "enabled": "BOOLEAN",
    "toggleTime": "DATETIME",
    "terminalStorageClass": "STORAGE_CLASS",
    "terminalStorageClassUpdateTime": "DATETIME"
    },
    }

API XML

Esta función no se puede gestionar a través de la API XML. Usa la Google Cloud consola u otra herramienta.

Siguientes pasos

A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.

Última actualización: 2025-12-10 (UTC).