列出存储桶 IP 过滤规则

本页面介绍了如何列出存储桶 IP 过滤规则。通过列出存储桶 IP 过滤规则操作，您可以检查存储桶是否已启用 IP 过滤或已停用 IP 过滤。如果您需要查看有关允许的特定网络来源的信息，请使用获取存储桶 IP 过滤规则操作。

所需的角色

如需获得列出存储桶 IP 过滤规则所需的权限，请让您的管理员为您授予存储桶的 Storage Admin (roles/storage.admin) 角色。此角色包含列出存储桶 IP 过滤规则所需的 storage.buckets.list 权限。

您还可以通过自定义角色获取此权限。您也可以使用其他预定义角色来获取此权限。要查看哪些角色与哪些权限相关联，请参阅适用于 Cloud Storage 的 IAM 角色。

如需了解如何授予项目角色，请参阅管理对项目的访问权限。

列出存储桶 IP 过滤规则

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud Storage 存储桶页面。

    进入“存储桶”

  2. 在存储桶列表中，点击要更新的存储桶的名称。

  3. 在存储桶详情页面上，点击配置标签页。

  4. 在权限部分中，前往 IP 过滤。然后，点击 修改 IP 过滤配置。

    IP 过滤页面会显示以下详细信息：

    • 相应存储桶的 IP 过滤状态。
    • 服务代理是否配置为绕过 IP 过滤条件验证。
    • 是否允许从跨组织 VPC 网络进行访问。
    • 所有已配置的 IP 过滤规则。

gcloud

  1. 验证您是否已安装 Google Cloud CLI 526.0.0 版或更高版本：

    gcloud version | head -n1

  2. 如果您安装的是早期 gcloud CLI 版本，请更新版本：

    gcloud components update --version=526.0.0

  3. 如需列出存储桶 IP 过滤规则，请在开发环境中运行 gcloud storage buckets describe 命令：

    gcloud storage buckets describe gs://BUCKET_NAME --format="default(ip_filter_config)"

    其中：

    BUCKET_NAME 是您的存储桶的名称。 例如 my-bucket。

JSON API

  1. 安装并初始化 gcloud CLI，以便为 Authorization 标头生成访问令牌。

  2. 使用 cURL，通过 List Bucket 请求调用 JSON API：

    curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage./storage/v1/b?project=PROJECT_ID"

    其中：

    PROJECT_ID 是包含您要列出的存储桶的项目的 ID，例如 my-project。

    响应如下例所示：

    {
  "kind": "storage#buckets",
  "items":
        {
        "kind": "storage#bucket",
        "selfLink": "https://www.googleapis.com/storage/v1/b/my-bucket1",
        "id": "my-bucket1",
        "name": "my-bucket1",
        "projectNumber": "123456789012",
        ...
          },
        "ipFilter": {
          "mode": "Disabled"
         }
        {
        "kind": "storage#bucket",
        "selfLink": "https://www.googleapis.com/storage/v1/b/my-bucket2",
        "id": "my-bucket2",
        "name": "my-bucket2",
        "projectNumber": "123456789013",
        ...
        },
        "ipFilter": {
          "mode": "Enabled"
        }
},

后续步骤