gsutil 工具

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

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

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

如需查看完整的指南列表,以了解如何使用 gsutil 完成任务,请参阅 Cloud Storage 操作指南

亲自尝试

如果您是 Google Cloud 新手,请创建一个帐号来评估 Cloud Storage 在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。

免费试用 Cloud Storage

使用入门

要开始使用 gsutil 工具,最好的方法是按照 gsutil 快速入门中的说明进行操作。此快速入门向您展示如何设置 Google Cloud 项目,启用结算,安装 gsutil 以及使用该工具运行基本命令。

如果另一个用户已经设置了 Cloud Storage 帐号,并已将您作为团队成员添加到项目中,或者您已被授予对象或存储分区的访问权限,则您能够以 Cloud SDK 组件的形式获得 gsutil 并使用该工具来访问受保护的数据。您无需激活 Cloud Storage 或设置结算功能。

访问公开数据

如果您只想访问公开数据,请按照访问公开数据中的说明进行操作。按照 gsutil 标签页中的步骤执行操作,您可以立即访问免费提供的、可公开访问的数据;您无需注册 Google 帐号或向 Cloud Storage 进行身份验证即可使用 gsutil 来访问这些数据。

用于访问资源的语法

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

gs://BUCKET_NAME/OBJECT_NAME

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

内置帮助内容

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

您也可以在线访问 gsutil 帮助页面。例如,gsutil cpgsutil options 分别是命令帮助页面和主题帮助页面。

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

gsutil version -l

使用情况统计信息

在安装过程中,您可以选择跟踪使用情况统计信息,以帮助改进 gsutil 工具。如果您以后决定要停用这些使用情况统计信息,请按照相关说明进行操作:

  • 如果您将 gsutil 作为 Cloud SDK 的一部分进行安装,请参阅使用情况统计信息
  • 如果您将 gsutil 作为独立版本进行安装,请删除文件 /.gsutil/analytics-uuid

关于 gsutil

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

限制

  • 将 gsutil 与 Windows 搭配使用时,您无法使用 Ctrl-C 取消当前正在运行的命令。

后续步骤