En esta página, se muestra cómo subir y descargar objetos a buckets de almacenamiento de dispositivos 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 administración. 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 Otorgar acceso al bucket.
Para ejecutar comandos en el servidor de la API de administración, accede y genera el archivo kubeconfig para el servidor de la API de administración si no tienes uno.
Lineamientos para asignar nombres de objetos
Usa los siguientes lineamientos para asignar nombres a los objetos:
- Usa caracteres UTF-8 cuando asignes nombres a los objetos.
- Evita incluir cualquier tipo de 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 de varias partes para objetos grandes o usa cargas de varias partes automáticamente cuando tengas un archivo para subir que sea más grande que 15 MB. En ese caso, el archivo se divide en varias partes, y cada parte tiene un tamaño 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 de varias partes para todos los archivos.--multipart-chunk-size-mb=SIZE: Establece el tamaño de cada fragmento de una carga de varias partes.
Los archivos más grandes que SIZE se suben automáticamente como varias partes de varios subprocesos. Los archivos más pequeños se suben con el método tradicional. SIZE está en megabytes. El tamaño predeterminado del fragmento es de 15 MB. El tamaño mínimo permitido del 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 a 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 .