从 gsutil 过渡到 gcloud storage

gcloud storage(正式版)是建议用于与 Cloud Storage 交互的命令行工具。本页面通过介绍两种工具之间的主要差异和命令映射,来帮助您从 gsutil 过渡到 gcloud storage。如需详细了解 gcloud storage 工具,请参阅 gcloud storage 参考文档

如需了解如何安装并开始使用 Google Cloud CLI,请参阅安装 Google Cloud CLI

行为差异

以下部分介绍了 gsutilgcloud storage 之间的行为差异。

并行调用

gcloud storage 不支持同时从不同终端运行 CLI 的多个实例。

并行处理

gcloud storage 支持并行处理。

通配符处理

gcloud storage 会简化多个星号。如果您连续使用三个或更多星号 (***),该工具会将它们视为一个星号 (*)。

分层命名空间存储桶的处理

gcloud storage 可用于创建和管理启用了分层命名空间的存储桶。

输出格式

gcloud storagegsutil 命令的输出格式不同。虽然日志记录格式等细微更改可能不会对您造成影响,但错误消息和数据列表中的更显著差异可能会破坏自动化脚本。

如果您具有依赖于解析 gsutil 命令输出的脚本,则应在转换这些脚本之前,先查看并更新它们以适应 gcloud storage 格式。

等效的 gcloud 命令

除了少数几个例外,所有现有的 gsutil 命令在 gcloud storage 中都有等效的命令。您可以访问参考文档或运行 gcloud storage --help 以获得完整的 gcloud storage 命令列表。下表简要概述了常用 gsutil 命令的变化。

操作 gsutil 命令 gcloud storage 命令
管理访问控制列表 (ACL)
gsutil acl get
gsutil acl set
gsutil acl ch
gcloud storage RESOURCE describe --format="multi(acl:format=json)"
gcloud storage RESOURCE update --acl-file=ACL_FILE_PATH
gcloud storage RESOURCE update --add-acl-grant=