En esta página se explica cómo subir y descargar objetos a y desde los buckets de almacenamiento del dispositivo air-gapped de Google Distributed Cloud (GDC).
Antes de empezar
Un espacio de nombres de proyecto gestiona los recursos de los contenedores en el servidor de la API Management. Debes tener un proyecto para trabajar con segmentos y objetos.
También debe tener los permisos de contenedor adecuados para realizar la siguiente operación. Consulta Conceder acceso a un contenedor.
Directrices de nomenclatura de objetos
Sigue estas directrices para asignar nombres a los objetos:
- Usa caracteres UTF-8 al asignar nombres a los objetos.
- No incluyas información personal identificable.
Subir objetos a segmentos 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 segmento:
gdcloud storage cp *.txt s3://BUCKET
El siguiente comando sube varios archivos del directorio local a un contenedor:
gdcloud storage cp abc1.txt abc2.txt s3://BUCKET
Para subir una carpeta a un contenedor, usa la opción --recursive para copiar todo el árbol de directorios. El siguiente comando sube el árbol de directorios dir:
gdcloud storage cp dir s3://BUCKET --recursive
Realiza subidas en varias partes de objetos grandes o usa subidas en varias partes automáticamente cuando tengas que subir un archivo de más de 15 MB. En ese caso, el archivo se dividirá en varias partes, cada una de ellas 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 las demás partes que ya se hayan subido.
Hay dos opciones relacionadas con las subidas multiparte:
--disable-multipart: inhabilita las subidas multiparte de todos los archivos.--multipart-chunk-size-mb=SIZE: define el tamaño de cada fragmento de una subida multiparte.
Los archivos de más de SIZE se suben automáticamente como archivos multiparte multihilo. Los archivos más pequeños se suben con el método tradicional. SIZE está en megabytes. El tamaño predeterminado de los fragmentos es de 15 MB. El tamaño mínimo permitido de los fragmentos es de 5 MB y el máximo, de 5 GB.
Descargar objetos de los contenedores de almacenamiento
Para obtener objetos del segmento:
gdcloud storage cp s3://BUCKET/OBJECT LOCAL_FILE_TO_SAVE
Para descargar todos los archivos de texto de un segmento en tu directorio actual, haz lo siguiente:
gdcloud storage cp s3://BUCKET/*.txt .
Para descargar el archivo de texto abc.txt de un segmento en tu directorio actual, haz lo siguiente:
gdcloud storage cp s3://BUCKET/abc.txt .
Para descargar una versión anterior del archivo, primero debes enumerar todas las versiones del archivo:
gdcloud storage ls s3://BUCKET/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 tu directorio actual:
gdcloud storage cp s3://BUCKET/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .