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 cp 和 gsutil help options 分别是命令帮助页面和主题帮助页面。

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

gsutil version -l

使用情况统计信息

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

关于 gsutil

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

限制

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

后续步骤