本页面介绍如何将对象上传到 Google Distributed Cloud (GDC) 气隙设备存储分区以及如何从该存储分区下载对象。
准备工作
项目命名空间用于管理管理 API 服务器中的存储桶资源。您 必须拥有项目才能使用 存储分区和对象。
您还必须拥有相应的存储桶权限才能执行以下操作。请参阅授予存储桶访问权限。
如需针对管理 API 服务器运行命令，请登录并生成管理 API 服务器的 kubeconfig 文件（如果您还没有该文件）。
对象命名准则
请按照以下准则为对象命名：
- 为对象命名时，请使用 UTF-8 字符。
- 请勿包含任何个人身份信息 (PII)。
将对象上传到存储分区
如需上传对象，请运行以下命令：
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
以下命令会将本地目录中的所有文本文件上传到存储桶：
gdcloud storage cp *.txt s3://BUCKET
以下命令会将本地目录中的多个文件上传到存储桶：
gdcloud storage cp abc1.txt abc2.txt s3://BUCKET
如需将文件夹上传到存储桶，请使用 --recursive 选项复制整个目录树。以下命令会上传目录树 dir：
gdcloud storage cp dir s3://BUCKET --recursive
对于大型对象，请执行分段上传；或者，当您要上传的文件大于 15 MB 时，请自动使用分段上传。 在这种情况下，文件会拆分为多个部分，每个部分的大小为 15 MB。 最后一部分较小。每个部分都会单独上传，并在传输完成后在目标位置重建。
如果某个部分的上传失败，您可以重新开始上传，而不会影响已上传的其他任何部分。
以下是与分段上传相关的两个选项：
--disable-multipart：停用所有文件的分段上传。--multipart-chunk-size-mb=SIZE：设置分段上传的每个分块的大小。
大于 SIZE 的文件会自动以 多线程分段方式上传。较小的文件则使用传统方法上传。SIZE 以兆字节为单位。默认分块大小为 15 MB。允许的最小分块大小为 5 MB，最大分块大小为 5 GB。
从存储分区下载对象
如需从存储桶获取对象，请执行以下操作：
gdcloud storage cp s3://BUCKET/OBJECT LOCAL_FILE_TO_SAVE
如需将存储桶中的所有文本文件下载到当前目录，请执行以下操作：
gdcloud storage cp s3://BUCKET/*.txt .
如需将存储桶中的文本文件 abc.txt 下载到当前目录，请执行以下操作：
gdcloud storage cp s3://BUCKET/abc.txt .
如需下载文件的旧版本，请先列出文件的所有版本：
gdcloud storage ls s3://BUCKET/abc.txt --all-versions
输出示例：
s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND
s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND
s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3
然后，将存储桶中的特定版本的文本文件 abc.txt 下载到当前目录：
gdcloud storage cp s3://BUCKET/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .