gsutil 是一个 Python 应用,该应用可让您通过命令行访问 Cloud Storage。您可以使用 gsutil 完成各种各样的存储分区和对象管理任务,包括:
- 创建和删除存储分区。
- 上传、下载和删除对象。
- 列出存储分区和对象。
- 移动、复制和重命名对象。
- 修改对象和存储分区 ACL。
gsutil 使用 HTTPS 和传输层安全协议 (TLS) 执行所有操作,包括上传和下载。
您应该使用 gsutil 吗?
通常,您应该使用 gcloud storage
命令而不是 gsutil
命令:
gsutil 工具是一个旧版 Cloud Storage CLI,仅进行最低程度的维护。
gcloud storage
命令需要较少的手动优化即可实现最快的上传和下载速率。
迁移到 gcloud CLI
如果您是想要迁移到 gcloud CLI 的 gsutil 用户,则应先通过运行以下命令来检查您是否使用的是独立版 gsutil:
gsutil version -l
如果该命令的结果包含
using cloud sdk: False
,则表示您使用的是独立版 gsutil。如需迁移到 gcloud CLI,请先安装 gcloud CLI。如果命令的结果包含
using cloud sdk: True
,则表示您已经安装了 gcloud CLI。
安装 gcloud CLI 后,您可以像使用 gsutil
命令一样使用 gcloud storage
命令。以下资源可以帮助您入门:
按照使用 gcloud 工具发现对象存储空间快速入门探索
gcloud storage
命令。查看用于运行
gcloud storage
的 Shim,其中记录了gcloud storage
命令中不提供的功能。
用于访问资源的语法
gsutil 使用前缀 gs://
表示 Cloud Storage 中的资源:
gs://BUCKET_NAME/OBJECT_NAME
除了指定确切的资源外,gsutil 还支持在命令中使用通配符。
内置帮助内容
gsutil 包含与每个命令有关的、全面的内置帮助内容以及大量主题,您可以使用 gsutil help
命令列出和读取这些内容。
如需获取有关特定命令或主题的信息,请使用 gsutil help
,后跟预期的命令或主题名称。例如,gsutil help cp
和 gsutil help options
分别是命令帮助页面和主题帮助页面。
如需获取有关 gsutil 安装的信息,请使用 gsutil version 命令:
gsutil version -l
使用情况统计信息
在安装过程中,您可以选择跟踪使用情况统计信息,以帮助改进 gsutil 工具。如果您以后决定要停用这些使用情况统计信息,请参阅使用情况统计信息。
关于 gsutil
gsutil 是一个开源项目。如需下载 gsutil 的开发者版本或志愿帮助开发 gsutil,请访问 GitHub 上的 gsutil 项目。
限制
- 将 gsutil 与 Windows 搭配使用时,您无法通过
Ctrl-C
取消使用-m
全局标志的命令。
后续步骤
- 安装 gsutil。
- 参阅 gsutil Stack Overflow 问题中的社区讨论。