En esta página, se muestra cómo subir y descargar objetos a los buckets de almacenamiento del dispositivo aislado 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
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
El siguiente comando sube todos los archivos de texto del directorio local a un bucket:
gdcloud storage cp *.txt s3://BUCKET
El siguiente comando sube varios archivos del directorio local a un bucket:
gdcloud storage cp abc1.txt abc2.txt s3://BUCKET
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://BUCKET --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
Para obtener objetos del bucket, haz lo siguiente:
gdcloud storage cp s3://BUCKET/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://BUCKET/*.txt .
Para descargar el archivo de texto abc.txt
de un bucket a tu directorio actual, haz lo siguiente:
gdcloud storage cp s3://BUCKET/abc.txt .
Para descargar una versión anterior del archivo, primero enumera todas las versiones del archivo:
gdcloud storage ls s3://BUCKET/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://BUCKET/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .