快速入门:使用 gsutil 工具

本页面介绍了如何使用 gsutil 命令行工具执行 Cloud Storage 中的基本任务。

您在 Cloud Storage 中产生的费用取决于所使用的资源。在本快速入门中,所使用 Cloud Storage 资源的价值通常不到 $0.01 USD。

准备工作

  1. 登录您的 Google 帐号。

    如果您还没有 Google 帐号,请注册新帐号

  2. In the GCP Console, go to the Manage resources page and create a project.

    Go to the Manage resources page

  3. 确保您的项目已启用结算功能。

    了解如何启用结算功能

  4. 安装 Cloud SDK。

    出现提示时,请选择您在上面创建的项目。

  5. 安装 Python 2.7

    如果您使用的是 Windows,并且在安装 Cloud SDK 时保留选中了相关复选框,则系统会自动完成此操作。

创建存储分区

存储分区是 Cloud Storage 中用于存放数据的基本容器。

要创建存储分区,请执行以下操作:

  1. 打开一个终端窗口。
  2. 使用 gsutil mb 命令创建一个存储分区并为其指定一个唯一的名称:
    gsutil mb -l us-east1 gs://my-awesome-bucket/
    

    在上述命令中,使用了名为“my-awesome-bucket”的存储分区。您必须选择您自己的全局唯一存储分区名称。

    如果成功,此命令会返回以下内容:

    Creating gs://my-awesome-bucket/...
    
  3. 您刚刚创建了一个存储分区,现在可以在其中存储您的内容了!

上传对象到存储分区中

猫咪图片。

  1. 右键点击上面的图像并将其保存到计算机上的某个位置(例如桌面上)。

  2. 使用 gsutil cp 命令将图像从保存位置复制到您创建的存储分区中:

    gsutil cp Desktop/kitten.png gs://my-awesome-bucket

    如果操作成功,此命令会返回以下内容:

    Copying file://Desktop/kitten.png [Content-Type=image/png]...
    Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
    Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

    您刚刚在存储分区中存储了一个对象。

从存储分区下载对象

  1. 使用 gsutil cp 命令将存储在存储分区中的图像下载到计算机上的某个位置(例如桌面上):

    gsutil cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png

    如果操作成功,此命令会返回以下内容:

    Copying gs://my-awesome-bucket/kitten.png...
    Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
    Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB

    您刚刚从存储分区中下载了某个内容。

将对象复制到存储分区中的文件夹

  1. 使用 gsutil cp 命令创建文件夹并将图像复制到文件夹中:

    gsutil cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png

    如果操作成功,此命令会返回以下内容:

    Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
    Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB

    您刚刚将对象复制到存储分区内的新文件夹中。

列出存储分区或文件夹的内容

  1. 使用 gsutil ls 命令列出存储分区顶层的内容:

    gsutil ls gs://my-awesome-bucket

    如果操作成功,该命令将返回类似于以下内容的消息:

    gs://my-awesome-bucket/kitten.png
    gs://my-awesome-bucket/just-a-folder/

    您刚刚看到了存储分区顶层的内容。

列出对象的详细信息

  1. 使用 gsutil ls 命令和 -l 标志来获取对象的一些相关详情:

    gsutil ls -l gs://my-awesome-bucket/kitten.png

    如果操作成功,该命令将返回类似于以下内容的消息:

    2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
    TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)

    您刚刚获得了有关对象大小和创建日期的信息。

使您的对象可被公开访问

  1. 使用 gsutil acl ch 命令向所有用户授予存储在存储分区中的对象的读取权限:

    gsutil acl ch -u AllUsers:R gs://my-awesome-bucket/kitten.png

    如果操作成功,此命令会返回以下内容:

    Updated ACL on gs://my-awesome-bucket/kitten.png

    现在,任何人都可以获取您的对象。

  2. 要移除此权限,请使用以下命令:

    gsutil acl ch -d AllUsers gs://my-awesome-bucket/kitten.png

    如果操作成功,此命令会返回以下内容:

    Updated ACL on gs://my-awesome-bucket/kitten.png

    您已移除此对象的公开访问权限。

向某人授予您的存储分区的访问权限

  1. 使用 gsutil iam ch 命令向特定电子邮件地址授予存储分区中的对象的读取和写入权限:

    gsutil iam ch user:jane@gmail.com:objectCreator,objectViewer gs://my-awesome-bucket

    如果未返回错误,则表示此命令已成功执行。

    现在,别人可以向您的存储分区写入内容,以及查看该存储分区中的内容。

  2. 要移除此权限,请使用以下命令:

    gsutil iam ch -d user:jane@gmail.com:objectCreator,objectViewer gs://my-awesome-bucket

    如果未返回错误,则表示此命令已成功执行。

    您已移除用户在此存储分区上的访问权限。

删除对象

  1. 使用 gsutil rm 命令删除对象:

    gsutil rm gs://my-awesome-bucket/kitten.png

    如果操作成功,此命令会返回以下内容:

    Removing gs://my-awesome-bucket/kitten.png...

    对象的这一副本不再存储在 Cloud Storage 中(尽管您在文件夹 just-a-folder/ 中创建的副本仍然存在)。

清理

为避免系统因本快速入门中使用的资源向您的 GCP 帐号收取费用,请执行以下操作:

  1. 打开终端窗口(如果尚未打开)。
  2. 使用带有 -r 标志的 gsutil rm command 删除存储分区及存储分区中的所有内容:

    gsutil rm -r gs://my-awesome-bucket

    如果操作成功,该命令将返回类似于以下内容的消息:

    Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
    Removing gs://my-awesome-bucket/...

    您的存储分区及其内容将被删除。

后续步骤

此页内容是否有用?请给出您的反馈和评价:

发送以下问题的反馈:

此网页
Cloud Storage
需要帮助?请访问我们的支持页面