Crear y gestionar carpetas administradas

En esta guía, se describe cómo crear, enumerar y borrar carpetas administradas.

Antes de comenzar

Antes de empezar, asegúrate de tener el rol de Identity and Access Management (IAM) necesaria para crear y administrar carpetas administradas y habilitar el acceso uniforme a nivel de bucket.

Obtén los roles necesarios

Para obtener los permisos que necesitas a fin de crear y administrar carpetas administradas, pídele a tu administrador que te otorgue el rol de IAM de Administrador de carpetas de almacenamiento (roles/storage.folderAdmin) para el bucket.

Este rol predefinido contiene los permisos necesarios para crear y administrar carpetas administradas. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

  • storage.managedfolders.create
  • storage.managedfolders.delete
  • storage.managedfolders.get
  • storage.managedfolders.list
  • storage.objects.list
    • Este permiso solo es necesario si deseas validar las carpetas administradas recién creadas.

También puedes obtener estos permisos con otros roles predefinidos o roles personalizados.

Para obtener más información sobre cómo otorgar roles en los buckets, consulta Usa IAM con buckets.

Habilitar el acceso uniforme a nivel de bucket

Si aún no lo hiciste, habilita el acceso uniforme a nivel de bucket.

Cree una carpeta administrada

Console

Cuando usas la consola de Google Cloud, creas carpetas administradas con la conversión de carpetas simuladas. En los siguientes pasos, se describe cómo crear una carpeta simulada y convertirla en una carpeta administrada.

  1. En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. En la lista de buckets, haz clic en el nombre del bucket en el que deseas crear las carpetas administradas.

  3. En la página Detalles del bucket, haz clic en Crear carpeta para crear una carpeta nueva. Si la carpeta que deseas convertir en una carpeta administrada ya existe, ve al paso en el que se describe cómo acceder al menú Más opciones .

  4. En el campo Nombre, escribe el nombre de tu carpeta. Para obtener consideraciones de nombres, consulta Nombres de carpetas administradas.

  5. Haz clic en Crear.

    La carpeta que acabas de crear aparecerá en el panel Navegador de carpetas.

  6. En el panel Navegador de carpetas, haz clic en el menú Más opciones junto con la carpeta que deseas convertir en una carpeta administrada y haz clic en Acceso de edición.

    Aparecerá el cuadro de diálogo Crear carpeta administrada.

  7. Haz clic en Adjuntar carpeta administrada.

    Tu carpeta se convierte en una carpeta administrada. Aparecerá el panel Permisos para MANAGED_FOLDER_NAME, que muestra las políticas de IAM en la carpeta por principal y rol. Para crear políticas de IAM nuevas, consulta Configura una política de IAM en una carpeta administrada.

Línea de comandos

Para crear una carpeta administrada, ejecuta el comando gcloud storage managed-folders create:

gcloud storage managed-folders create gs://BUCKET_NAME/MANAGED_FOLDER_NAME

Donde:

  • BUCKET_NAME es el nombre del bucket en el que deseas crear una carpeta administrada. Por ejemplo, my-bucket

  • MANAGED_FOLDER_NAME es el nombre de la carpeta administrada que deseas crear. Por ejemplo, my-managed-folder/

Para confirmar que se creó la carpeta administrada, ejecuta el comando gcloud storage managed-folders describe:

gcloud storage managed-folders describe gs://BUCKET_NAME/MANAGED_FOLDER_NAME

Donde:

  • BUCKET_NAME es el nombre del bucket en el que creaste una carpeta administrada.

  • MANAGED_FOLDER_NAME es el nombre de la carpeta administrada que creaste.

API de REST

API de JSON

  1. Tener la gcloud CLI instalada e inicializadaa fin de generar un token de acceso para el encabezado Authorization.

    Como alternativa, puedes crear un token de acceso con OAuth 2.0 Playground y, luego, incluirlo en el encabezado Authorization.

  2. Usa cURL para llamar a la API de JSON con una solicitud de ManagedFolder POST:

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-d '{ "name": "MANAGED_FOLDER_NAME" }' \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders"

    Donde:

    • BUCKET_NAME es el nombre del bucket en el que deseas crear una carpeta administrada. Por ejemplo, my-bucket.

    • MANAGED_FOLDER_NAME es el nombre de la carpeta administrada que deseas crear. Por ejemplo, my-managed-folder/

Enumera carpetas administradas

Console

  1. En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. En el panel Navegador de carpetas, usa el nodo de activar o desactivar para expandir la lista de carpetas dentro de tu bucket.

Una lista muestra las carpetas simuladas y administradas de tu bucket.

Línea de comandos

Para enumerar las carpetas administradas, ejecuta el comando gcloud storage managed-folders list:

gcloud storage managed-folders list gs://BUCKET_NAME

Donde:

  • BUCKET_NAME es el nombre del depósito que contiene las carpetas administradas que deseas enumerar. Por ejemplo, my-bucket

Ten en cuenta que también puedes especificar una ruta de acceso a la carpeta en lugar de un nombre de bucket. Por ejemplo:

gcloud storage managed-folders list gs://my-bucket/folder/

API de REST

API de JSON

  1. Tener la gcloud CLI instalada e inicializadaa fin de generar un token de acceso para el encabezado Authorization.

    Como alternativa, puedes crear un token de acceso con OAuth 2.0 Playground y, luego, incluirlo en el encabezado Authorization.

  2. Usa cURL para llamar a la API de JSON con una solicitud para enumerar las carpetas administradas:

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders"

    BUCKET_NAME es el nombre del bucket que contiene las carpetas administradas que deseas enumerar. Por ejemplo, my-bucket.

Mover una carpeta administrada

Console

  1. Crea una carpeta administrada nueva en el bucket de destino.

  2. Copia las políticas de IAM de la carpeta administrada original en el bucket de origen a la carpeta administrada nueva en el bucket de destino.

  3. Copia los objetos de la carpeta administrada original en el bucket de origen a la nueva carpeta administrada en el bucket de destino.

  4. Borra la carpeta administrada original del bucket de origen.

Línea de comandos

Para mover las carpetas administradas y los objetos que contienen, ejecuta el comando gcloud storage mv con la opción --include-managed-folders:

gcloud storage mv --include-managed-folders gs://SOURCE_BUCKET_NAME/MANAGED_FOLDER_NAME gs://DESTINATION_BUCKET_NAME/MANAGED_FOLDER_NAME

Donde:

  • SOURCE_BUCKET es el nombre de tu bucket original. Por ejemplo: my-source-bucket`.

  • DESTINATION_BUCKET es el nombre del bucket al que mueves tu carpeta administrada. Por ejemplo, my-destination-bucket

  • MANAGED_FOLDER_NAME es el nombre de la carpeta administrada que mueves. Por ejemplo, my-managed-folder/

API de REST

API de JSON

Para mover las carpetas administradas de un bucket a otro, completa los siguientes pasos:

  1. Crea una carpeta administrada nueva en el bucket de destino.

  2. Copia las políticas de IAM desde la carpeta administrada original en el bucket de origen a la nueva carpeta administrada en el bucket de destino.

  3. Copia los objetos de la carpeta administrada original en el bucket de origen a la nueva carpeta administrada en el bucket de destino.

  4. Borra la carpeta administrada original del bucket de origen.

Borra una carpeta administrada

Console

  1. En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. En la página Detalles del bucket , haz clic en el ícono Más opciones junto con la carpeta administrada que deseas borrar.

  3. Haz clic en Borrar carpeta.

  4. Para confirmar que deseas borrar la carpeta administrada, escribe DELETE en el campo Borrar.

  5. Haz clic en Borrar.

    La carpeta administrada y su contenido, incluidos los objetos almacenados y otras carpetas administradas, se borran de tu bucket de Cloud Storage.

Línea de comandos

Para borrar una carpeta administrada y los objetos que contiene, ejecuta el comando gcloud storage rm:

gcloud storage rm -r gs://BUCKET_NAME/MANAGED_FOLDER_NAME

Donde:

  • BUCKET_NAME es el nombre del bucket que contiene la carpeta administrada que deseas borrar. Por ejemplo, my-bucket

  • MANAGED_FOLDER_NAME es el nombre de la carpeta administrada que deseas borrar. Por ejemplo, my-managed-folder/

API de REST

API de JSON

Para borrar una carpeta administrada, primero debes borrar los objetos dentro de la carpeta administrada.

  1. Tener la gcloud CLI instalada e inicializadapara generar un token de acceso para el encabezado Authorization.

    Como alternativa, puedes crear un token de acceso con OAuth 2.0 Playground y, luego, incluirlo en el encabezado Authorization.

  2. Usa cURL para llamar a la API de JSON con una solicitud de ManagedFolder DELETE:

    curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders/MANAGED_FOLDER_NAME"

    Donde:

    • BUCKET_NAME es el nombre del bucket que contiene la carpeta administrada que deseas borrar. Por ejemplo, my-bucket.

    • MANAGED_FOLDER_NAME es el nombre de la carpeta administrada que deseas borrar. Por ejemplo, my-managed-folder/

    De forma predeterminada, las carpetas administradas deben estar vacías antes de que puedan borrarse. Para borrar una carpeta administrada que no esté vacía, incluye allowNonEmpty=true como parámetro de consulta en tu solicitud.

Soluciona problemas

Si deseas obtener ayuda para crear y administrar carpetas administradas, consulta la página de solución de problemas.

Próximos pasos