gsutil 工具

gsutil 是一个 Python 应用,该应用可让您通过命令行访问 Cloud Storage。您可以使用 gsutil 完成各种各样的存储分区和对象管理任务,包括:

  • 创建和删除存储分区。
  • 上传、下载和删除对象。
  • 列出存储分区和对象。
  • 移动、复制和重命名对象。
  • 修改对象和存储分区 ACL。

gsutil 使用 HTTPS 和传输层安全协议 (TLS) 执行所有操作,包括上传和下载。

您应该使用 gsutil 吗?

通常,您应该使用 gcloud storage 命令而不是 gsutil 命令:

  • gsutil 工具是一个旧版 Cloud Storage CLI,仅进行最低程度的维护。

  • gsutil 工具不支持使用较新的 Cloud Storage 功能,例如软删除托管式文件夹

  • 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 命令。以下资源可以帮助您入门:

用于访问资源的语法

gsutil 使用前缀 gs:// 表示 Cloud Storage 中的资源:

gs://BUCKET_NAME/OBJECT_NAME

除了指定确切的资源外,gsutil 还支持在命令中使用通配符

内置帮助内容

gsutil 包含与每个命令有关的、全面的内置帮助内容以及大量主题,您可以使用 gsutil help 命令列出和读取这些内容。

如需获取有关特定命令或主题的信息,请使用 gsutil help,后跟预期的命令或主题名称。例如,gsutil help cpgsutil help options 分别是命令帮助页面和主题帮助页面。

如需获取有关 gsutil 安装的信息,请使用 gsutil version 命令:

gsutil version -l

使用情况统计信息

在安装过程中,您可以选择跟踪使用情况统计信息,以帮助改进 gsutil 工具。如果您以后决定要停用这些使用情况统计信息,请参阅使用情况统计信息

关于 gsutil

gsutil 是一个开源项目。如需下载 gsutil 的开发者版本或志愿帮助开发 gsutil,请访问 GitHub 上的 gsutil 项目

限制

  • 将 gsutil 与 Windows 搭配使用时,您无法通过 Ctrl-C 取消使用 -m 全局标志的命令。

后续步骤