Subir y descargar objetos de almacenamiento

En esta página, se muestra cómo subir y descargar objetos a buckets de almacenamiento aislados de Google Distributed Cloud (GDC).

Antes de comenzar

Un espacio de nombres del proyecto administra los recursos del bucket en el servidor de la API de Management. Debes tener un proyecto para trabajar con buckets y objetos.

También debes tener los permisos de bucket adecuados para realizar la siguiente operación. Consulta Cómo otorgar acceso al bucket.

Lineamientos para asignar nombres de objetos

Usa los siguientes lineamientos para asignar nombres a los objetos:

  • Usa caracteres UTF-8 cuando nombres objetos.
  • Evita incluir información de identificación personal (PII).

Sube objetos a buckets de almacenamiento

Console

  1. En el menú de navegación, haz clic en Object Storage.
  2. Haz clic en el nombre del bucket en el que deseas subir el objeto.
  3. Opcional: Si deseas crear una carpeta para almacenar tu objeto, haz clic en Crear carpeta > ingresa un nombre para la carpeta > haz clic en Crear.
  4. Haz clic directamente en Subir archivo o navega a la carpeta que acabas de crear y, luego, haz clic en Subir archivo.
  5. Selecciona el archivo deseado y haz clic en Abrir.
  6. Espera el mensaje de confirmación que indica que la carga se realizó correctamente.

CLI

Para subir un objeto, ejecuta los siguientes comandos:

gdcloud storage cp LOCAL_PATH s3://REMOTE_PATH
gdcloud storage cp s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH
gdcloud storage mv s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH

Los siguientes comandos requieren FULLY_QUALIFIED_BUCKET_NAME. Usa el comando GET o DESCRIBE de la sección Ver configuración del bucket para obtener el nombre completamente calificado del bucket.

El siguiente comando sube todos los archivos de texto del directorio local a un bucket:

gdcloud storage cp *.txt s3://FULLY_QUALIFIED_BUCKET_NAME

El siguiente comando sube varios archivos del directorio local a un bucket:

gdcloud storage cp abc1.txt abc2.txt s3://FULLY_QUALIFIED_BUCKET_NAME

Para subir una carpeta a un bucket, usa la opción --recursive para copiar un árbol de directorios completo. El siguiente comando sube el árbol de directorios dir:

gdcloud storage cp dir s3://FULLY_QUALIFIED_BUCKET_NAME --recursive

Realiza cargas multiparte para objetos grandes o usa cargas multiparte automáticamente cuando tengas un archivo para subir que supere los 15 MB. En ese caso, el archivo se divide en varias partes, cada una de 15 MB. La última parte es más pequeña. Cada parte se sube por separado y se reconstruye en el destino cuando se completa la transferencia.

Si falla la carga de una parte, puedes reiniciarla sin afectar ninguna de las otras partes que ya se subieron.

Existen dos opciones relacionadas con las cargas de varias partes:

  • --disable-multipart: Inhabilita las cargas multiparte para todos los archivos.
  • --multipart-chunk-size-mb=SIZE: Establece el tamaño de cada fragmento de una carga de varias partes.

Los archivos de más de SIZE se suben automáticamente como archivos de varias partes y subprocesos. Los archivos más pequeños se suben con el método tradicional. SIZE está en megabytes. El tamaño de fragmento predeterminado es de 15 MB. El tamaño mínimo permitido de fragmento es de 5 MB y el máximo es de 5 GB.

Descarga objetos de buckets de almacenamiento

Console

  1. En el menú de navegación, haz clic en Object Storage.
  2. Haz clic en el nombre del bucket que contiene los objetos.
  3. Selecciona la casilla de verificación junto al nombre del objeto que deseas descargar.
  4. Haz clic en Descargar.

CLI

Para obtener objetos del bucket, haz lo siguiente:

gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/OBJECT LOCAL_FILE_TO_SAVE

Para descargar todos los archivos de texto de un bucket en tu directorio actual, haz lo siguiente:

gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/*.txt .

Para descargar el archivo de texto abc.txt de un bucket a tu directorio actual, haz lo siguiente:

gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/abc.txt .

Para descargar una versión anterior del archivo, primero enumera todas las versiones del archivo:

gdcloud storage ls s3://FULLY_QUALIFIED_BUCKET_NAME/abc.txt --all-versions

Resultado de ejemplo:

s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND
s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND
s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3

Luego, descarga una versión específica del archivo de texto abc.txt del bucket a tu directorio actual:

gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .

Usa AEADKey personalizada

Para una mayor personalización, puedes crear tu propia AEADKey y usarla directamente cuando encriptes objetos en tu bucket. Esto te brinda control total sobre la clave de encriptación, lo que te permite omitir la predeterminada. Sigue los pasos en Crea una clave para crear una nueva AEADKey y asegúrate de que esté en el mismo Namespace que el bucket que deseas usar. Luego, cada vez que envíes la solicitud, asegúrate de que HEADER esté configurado con x-amz-server-side-encryption: SSE-KMS y x-amz-server-side-encryption-aws-kms-key-id: NAMESPACE_NAME/AEADKey_NAME.