Subir y descargar objetos de almacenamiento en proyectos

En esta página se explica cómo subir y descargar objetos a segmentos de almacenamiento aislados de Google Distributed Cloud (GDC) y desde ellos.

Antes de empezar

Un espacio de nombres de proyecto gestiona los recursos de los segmentos en el servidor de la API Management. Debes tener un proyecto para trabajar con segmentos y objetos.

También debes tener los permisos de segmento adecuados para realizar la siguiente operación. Consulta el artículo Conceder acceso a un segmento.

Directrices de nomenclatura de objetos

Sigue estas directrices para nombrar objetos:

  • Usa caracteres UTF-8 al nombrar objetos.
  • El nombre debe tener entre 1 y 55 caracteres.
  • No incluyas información de identificación personal.

Subir objetos a segmentos de almacenamiento

Consola

  1. En el menú de navegación, haz clic en Object Storage.
  2. Haz clic en el nombre del segmento al que quieras subir el objeto.
  3. Opcional: Si quieres crear una carpeta para almacenar el objeto, haz clic en Crear carpeta > introduce un nombre de carpeta > haz clic en Crear.
  4. Haz clic directamente en Subir archivo o ve a la carpeta que acabas de crear y, a continuación, haz clic en Subir archivo.
  5. Selecciona el archivo que quieras y haz clic en Abrir.
  6. Espera a que aparezca el mensaje de confirmación de que la subida se ha completado correctamente.

gdcloud

Para subir un objeto, ejecuta los siguientes comandos:

gdcloud storage cp LOCAL_PATH s3://REMOTE_PATH
gdcloud storage cp s3://FULLY_QUALIFIED_SOURCE_BUCKET_NAME s3://FULLY_QUALIFIED_DESTINATION_BUCKET_NAME
gdcloud storage mv s3://FULLY_QUALIFIED_SOURCE_BUCKET_NAME s3://FULLY_QUALIFIED_DESTINATION_BUCKET_NAME

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

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

gdcloud storage cp *.txt s3://FULLY_QUALIFIED_BUCKET_NAME

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

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

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

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

Realiza subidas por partes para objetos grandes o usa subidas por partes automáticamente cuando tengas que subir un archivo de más de 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 subida de una parte, puedes reiniciarla sin que afecte a ninguna de las otras partes que ya se hayan subido.

Hay dos opciones relacionadas con las subidas por partes:

  • --disable-multipart: inhabilita las subidas por partes para todos los archivos.
  • --multipart-chunk-size-mb=SIZE: establece el tamaño de cada parte de una subida por partes.

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

Descargar objetos de segmentos de almacenamiento

Consola

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

gdcloud

Para obtener objetos del segmento, 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 segmento en el directorio actual, haz lo siguiente:

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

Para descargar el archivo de texto abc.txt de un segmento en el directorio actual, haz lo siguiente:

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

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

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

Ejemplo:

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

A continuación, descarga una versión específica del archivo de texto abc.txt del segmento en el directorio actual:

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

Usar AEADKey personalizado

Para personalizarlo más, puedes crear tu propio AEADKey y usarlo directamente al cifrar objetos en tu segmento. De esta forma, tendrás pleno control sobre la clave de cifrado y no se usará la predeterminada. Sigue los pasos que se indican en el artículo Crear una clave para crear un AEADKey y asegúrate de que esté en el mismo Namespace que el segmento que quieras usar. A continuación, cada vez que envíes la solicitud, asegúrate de que el 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.