配置和管理存储空间分析情报

本页介绍了如何为资源配置、查看、更新和停用 存储空间智能。

配置存储空间分析情报

本部分介绍了如何为资源配置存储空间智能。

控制台

  1. 在 Google Cloud 控制台中，进入 Cloud Storage 设置页面。

    转到“设置”

  2. 点击配置存储空间分析情报。

  3. 在配置存储空间智能对话框中，选择要为其配置存储空间智能的资源。

  4. 点击继续。

  5. 可选：如需在存储空间智能分析配置中包含或排除特定存储分区，请执行以下操作：

    1. 如需从特定位置中选择存储分区，请使用过滤条件类型菜单。如需包含或排除某个存储分区，请从位置菜单中选择相应位置。如需了解详情，请参阅按地理位置过滤。

    2. 如需按名称选择 Cloud Storage 存储分区，请使用过滤条件类型菜单。如需包含或排除存储分区，请指定存储分区名称的正则表达式，然后点击添加正则表达式。如需了解详情，请参阅按存储分区名称过滤。

  6. 点击启用此配置。

命令行

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. 如需配置存储空间智能功能，请将 gcloud alpha storage intelligence-configs enable 命令与以下标志之一结合使用：

    • --project：为项目配置存储空间智能。该值为项目 ID。例如 my-project。

    • --sub-folder：为文件夹配置存储空间智能功能。该值为文件夹 ID。例如 1234567890。

    • --organization：为组织配置存储空间智能功能。此值为组织 ID。例如 9876546738。

      例如，以下命令会为名为 my-project 的项目配置存储空间智能功能：

      gcloud alpha storage intelligence-configs enable --project=PROJECT_ID

      其中，PROJECT_ID 是项目 ID。

    如需在存储空间智能分析配置中包含或排除特定存储分区，请使用以下任一标志：

    • --exclude-bucket-regexes：要从存储空间智能分析配置中排除的存储分区 ID 正则表达式列表。
    • --include-bucket-regexes：要包含在存储空间智能分析配置中的存储分区 ID 正则表达式列表。

    例如，如需排除名称中包含 colddata 的所有存储分区，请使用以下命令：

    gcloud alpha storage intelligence-configs enable --organization=54343 --exclude-bucket-regexes=colddata.*

    例如，如需排除名为 colddata 的存储分区，请使用以下命令：

    gcloud alpha storage intelligence-configs enable --organization=54343 --exclude-bucket-regexes=colddata

    例如，如需排除名为 colour 或 color 的存储分区，请使用以下命令：

    gcloud alpha storage intelligence-configs enable --organization=my-org --exclude-bucket-regexes=colou?r

    如需在存储空间智能分析配置中根据存储分区的位置包含或排除存储分区，请使用以下任一标志：

    • --exclude-locations：要从存储空间智能配置中排除的位置列表。
    • --include-locations：要包含在存储空间智能配置中的地理位置列表。

    例如：

    gcloud alpha storage intelligence-configs enable --sub-folder=123456 --include-locations=us-east1,us-west1

REST API

JSON API

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

  2. 创建一个包含以下详细信息的 JSON 文件：

    1. name：存储空间智能配置的名称。请采用以下任一格式：
      • 项目：projects/PROJECT_ID/locations/global/intelligenceConfig
      • 文件夹：folders/FOLDER_ID/locations/global/intelligenceConfig
      • 组织：organizations/ORGANIZATION_ID/locations/global/intelligenceConfig

      其中：

      • PROJECT_ID 是 Google Cloud 项目 ID。项目 ID 为字母数字，例如 my-project
      • FOLDER_ID 是 Google Cloud 文件夹 ID。文件夹 ID 是数字，例如 123456789012
      • ORGANIZATION_ID 是 Google Cloud 组织 ID。组织 ID 是数字，例如 123456789012
    2. 配置 editionConfig 字段。如需了解详情，请参阅 版本配置。
    3. 可选：配置 filter 对象。您可以根据 Cloud Storage 位置和存储分区 ID 正则表达式包含或排除存储分区。
        {
      "name":"projects/PROJECT_ID/locations/global/intelligenceConfig",
      "editionConfig":"EDITION_CONFIGURATION",
      "filter":{
        "includedCloudStorageBuckets":{
            "bucketIdRegexes":[
              "INCLUDED_BUCKET_ID_REGEX",
                ...]
        },
        "excludedCloudStorageBuckets":{
            "bucketIdRegexes":[
              "EXCLUDED_BUCKET_ID_REGEX",
                ...]
        },
        "includedCloudStorageLocations":{
            "locations":[
              "INCLUDED_BUCKET_LOCATION",
                ...]
        },
        "excludedCloudStorageLocations":{
            "locations":[
              "EXCLUDED_BUCKET_LOCATION",
                ...]
        }
      }
    }

    其中：

    • PROJECT_ID 是 Google Cloud 项目 ID。项目 ID 为字母数字，例如 my-project。
    • EDITION_CONFIGURATION 是存储空间分析情报的版本配置。
    • 可选：INCLUDED_BUCKET_ID_REGEX 是一个正则表达式，用于指定要包含哪些存储分区 ID。您可以以列表的形式指定一个或多个正则表达式。
    • 可选：EXCLUDED_BUCKET_ID_REGEX 是一个正则表达式，用于指定要排除哪些存储分区 ID。您可以以列表的形式指定一个或多个正则表达式。
    • 可选：INCLUDED_BUCKET_LOCATION 是您希望在存储空间智能分析配置中添加存储分区的位置。您可以以列表的形式指定一个或多个位置。
    • 可选：EXCLUDED_BUCKET_LOCATION 是您要从存储空间智能分析配置中排除存储分区的位置。您可以以列表的形式指定一个或多个位置。

  3. 以下部分介绍了如何为项目、文件夹或组织配置存储空间智能。使用以下任一方法配置存储空间智能。

    为项目配置存储空间分析情报

    使用 cURL，通过请求为项目配置存储空间智能调用 JSON API。

      curl -X POST \
    --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://storage.googleapis.com/v2/projects/PROJECT_ID/locations/global/intelligenceConfig?updateMask=UPDATE_MASK"

    其中：

    • PROJECT_ID 是 Google Cloud 项目 ID。项目 ID 为字母数字，例如 my-project
    • UPDATE_MASK 是此请求要更新的字段名称的逗号分隔列表。这些字段使用 FieldMask 格式，属于 IntelligenceConfig 资源。

    为文件夹配置存储空间分析情报

    使用 cURL 通过为文件夹配置存储空间智能的请求调用 JSON API。

      curl -X POST \
    --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://storage.googleapis.com/v2/folders/FOLDER_ID/locations/global/intelligenceConfig?updateMask=UPDATE_MASK"

    其中：

    • FOLDER_ID 是 Google Cloud 文件夹 ID。文件夹 ID 是数字，例如 123456789012
    • UPDATE_MASK 是此请求要更新的字段名称的逗号分隔列表。这些字段使用 FieldMask 格式，属于 IntelligenceConfig 资源。

    为组织配置存储空间分析情报

    使用 cURL，通过请求为组织配置存储空间智能调用 JSON API。

    curl -X POST \
  --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/v2/organizations/ORGANIZATION_ID/locations/global/intelligenceConfig?updateMask=UPDATE_MASK"

    其中：

    • ORGANIZATION_ID 是 Google Cloud 组织 ID。组织 ID 是数字，例如 79293024087
    • UPDATE_MASK 是此请求要更新的字段名称的逗号分隔列表。这些字段使用 FieldMask 格式，属于 IntelligenceConfig 资源。

查看存储空间分析情报配置

本部分介绍了如何查看资源的存储空间智能分析配置。

控制台

  1. 在 Google Cloud 控制台中，进入 Cloud Storage 设置页面。

    转到“设置”

  2. 选择页面顶部的项目选择器。

  3. 在选择资源对话框中，选择要查看其存储空间智能配置的资源。

如果资源已配置存储空间分析情报，则状态字段会显示 Enabled。对于未配置存储空间分析情报的资源，系统会显示配置存储空间分析情报按钮。

命令行

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. 如需查看资源的存储空间智能配置，请将 gcloud alpha storage intelligence-configs describe 命令与以下标志之一结合使用：

    • --project：查看项目的存储空间智能配置。该值为项目 ID。例如 my-project。

    • --sub-folder：查看文件夹的存储空间智能配置。该值为文件夹 ID。例如 1234567890。

    • --organization：查看组织的存储空间智能分析配置。此值为组织 ID。例如 9876546738。

      例如，以下命令会查看名为 my-project 的项目的存储空间智能分析配置：

      gcloud alpha storage intelligence-configs describe --project=PROJECT_ID

      其中，PROJECT_ID 是 Google Cloud 项目 ID。项目 ID 为字母数字，例如 my-project。

REST API

JSON API

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

  2. 以下部分详细介绍了查看资源的存储空间智能配置的方法。

    查看项目的存储空间智能分析配置

    使用 cURL 通过请求调用 JSON API，以查看项目的存储空间智能配置。

      curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://storage.googleapis.com/v2/projects/PROJECT_ID/locations/global/intelligenceConfig"

    其中：

    PROJECT_ID 是 Google Cloud 项目 ID。项目 ID 为字母数字，例如 my-project。

    查看文件夹的存储空间分析情报配置

    使用 cURL 通过请求调用 JSON API，以查看文件夹的存储空间智能配置。

      curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://storage.googleapis.com/v2/folders/FOLDER_ID/locations/global/intelligenceConfig"

    其中：

    FOLDER_ID 是 Google Cloud 文件夹 ID。文件夹 ID 是数字，例如 123456789012。

    查看组织的存储空间分析情报配置

    使用 cURL 通过请求调用 JSON API，以查看组织的存储空间智能配置。

      curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://storage.googleapis.com/v2/organizations/ORGANIZATION_ID/locations/global/intelligenceConfig"

    其中：

    ORGANIZATION_ID 是 Google Cloud 组织 ID。组织 ID 是数字，例如 79293024087。

更新存储空间分析情报配置

本部分介绍了如何更新资源的存储空间智能配置。

控制台

  1. 在 Google Cloud 控制台中，进入 Cloud Storage 设置页面。

    转到“设置”

  2. 选择页面顶部的项目选择器。

  3. 在选择资源对话框中，选择要更新其存储空间智能配置的资源。

  4. 在概览部分，修改任何可修改的配置选项以满足您的需求。例如，您可以为资源停用存储空间智能功能，或将版本配置更改为 Inherit from parent，或更改存储分区过滤条件。

命令行

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. 如需更新资源的存储空间智能配置，请将 gcloud alpha storage intelligence-configs update 命令与以下标志之一结合使用：

    • --project：更新项目的存储空间智能配置。该值为项目 ID。例如 my-project。

    • --sub-folder：更新文件夹的存储空间智能配置。该值为文件夹 ID。例如 1234567890。

    • --organization：更新组织的存储空间智能配置。此值为组织 ID。例如 9876546738。

      例如，以下命令会更新名为 my-project 的项目的存储空间智能配置：

      gcloud alpha storage intelligence-configs update --project=PROJECT_ID

      其中，PROJECT_ID 是 Google Cloud 项目 ID。项目 ID 为字母数字，例如 my-project。

REST API

JSON API

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

  2. 创建一个包含以下详细信息的 JSON 文件：

    1. name：存储空间智能配置的名称。请采用以下任一格式：
      • 项目：projects/PROJECT_ID/locations/global/intelligenceConfig
      • 文件夹：folders/FOLDER_ID/locations/global/intelligenceConfig
      • 组织：organizations/ORGANIZATION_ID/locations/global/intelligenceConfig

      其中：

      • PROJECT_ID 是 Google Cloud 项目 ID。项目 ID 为字母数字，例如 my-project
      • FOLDER_ID 是 Google Cloud 文件夹 ID。文件夹 ID 是数字，例如 123456789012
      • ORGANIZATION_ID 是 Google Cloud 组织 ID。组织 ID 是数字，例如 123456789012
    2. 配置 editionConfig 字段。如需了解详情，请参阅 版本配置。
    3. 可选：配置 filter 对象。您可以根据 Cloud Storage 位置和存储分区 ID 正则表达式包含或排除存储分区。
        {
      "name":"projects/PROJECT_ID/locations/global/intelligenceConfig",
      "editionConfig":"EDITION_CONFIGURATION",
      "filter":{
        "includedCloudStorageBuckets":{
            "bucketIdRegexes":[
              "INCLUDED_BUCKET_ID_REGEX",
                ...]
        },
        "excludedCloudStorageBuckets":{
            "bucketIdRegexes":[
              "EXCLUDED_BUCKET_ID_REGEX",
                ...]
        },
        "includedCloudStorageLocations":{
            "locations":[
              "INCLUDED_BUCKET_LOCATION",
                ...]
        },
        "excludedCloudStorageLocations":{
            "locations":[
              "EXCLUDED_BUCKET_LOCATION",
                ...]
        }
      }
    }

    其中：

    • PROJECT_ID 是 Google Cloud 项目 ID。项目 ID 为字母数字，例如 my-project。
    • EDITION_CONFIGURATION 是存储空间分析情报的版本配置。
    • 可选：INCLUDED_BUCKET_ID_REGEX 是一个正则表达式，用于指定要包含哪些存储分区 ID。您可以以列表的形式指定一个或多个正则表达式。
    • 可选：EXCLUDED_BUCKET_ID_REGEX 是一个正则表达式，用于指定要排除哪些存储分区 ID。您可以以列表的形式指定一个或多个正则表达式。
    • 可选：INCLUDED_BUCKET_LOCATION 是您希望在存储空间智能分析配置中添加存储分区的位置。您可以以列表的形式指定一个或多个位置。
    • 可选：EXCLUDED_BUCKET_LOCATION 是您要从存储空间智能分析配置中排除存储分区的位置。您可以以列表的形式指定一个或多个位置。

  3. 以下部分介绍了如何更新项目、文件夹或组织的存储空间智能配置。使用以下方法之一更新存储空间智能配置。

    更新项目的存储空间智能配置

    使用 cURL 通过请求调用 JSON API，以更新项目的存储空间智能配置。

     curl -X PATCH \
   --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://storage.googleapis.com/v2/projects/PROJECT_ID/locations/global/intelligenceConfig?updateMask=UPDATE_MASK"

    更新文件夹的存储空间智能配置

    使用 cURL 通过更新文件夹的存储空间智能配置的请求调用 JSON API。

    其中：

    • PROJECT_ID 是 Google Cloud 项目 ID。项目 ID 为字母数字，例如 my-project
    • UPDATE_MASK 是此请求要更新的字段名称的逗号分隔列表。这些字段使用 FieldMask 格式，属于 IntelligenceConfig 资源。

     curl -X PATCH \
   --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://storage.googleapis.com/v2/folders/FOLDER_ID/locations/global/intelligenceConfig?updateMask=UPDATE_MASK"

    其中：

    • FOLDER_ID 是 Google Cloud 文件夹 ID。文件夹 ID 是数字，例如 123456789012
    • UPDATE_MASK 是此请求要更新的字段名称的逗号分隔列表。这些字段使用 FieldMask 格式，属于 IntelligenceConfig 资源。

    更新组织的存储空间分析情报配置

    使用 cURL 通过请求调用 JSON API，以更新组织的存储空间智能配置。

     curl -X PATCH \
   --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://storage.googleapis.com/v2/organizations/ORGANIZATION_ID/locations/global/intelligenceConfig?updateMask=UPDATE_MASK"

    其中：

    • ORGANIZATION_ID 是 Google Cloud 组织 ID。组织 ID 是数字，例如 79293024087
    • UPDATE_MASK 是此请求要更新的字段名称的逗号分隔列表。这些字段使用 FieldMask 格式，属于 IntelligenceConfig 资源。

停用存储空间分析情报

本部分介绍了如何停用存储空间智能。

控制台

  1. 在 Google Cloud 控制台中，进入 Cloud Storage 设置页面。

    转到“设置”

  2. 选择页面顶部的项目选择器。

  3. 在选择资源对话框中，选择要为其停用存储空间智能的资源。

  4. 在概览部分中，点击状态字段旁边的已启用。

  5. 在随即出现的对话框中，输入停用，然后点击停用。

命令行

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. 如需为资源停用存储空间智能配置，请将 gcloud alpha storage intelligence-configs disable 命令与以下标志之一结合使用：

    • --project：为项目停用存储空间智能配置。该值为项目 ID。例如 my-project。

    • --sub-folder：为文件夹停用存储空间智能配置。该值为文件夹 ID。例如 1234567890。

    • --organization：为组织停用存储空间分析情报配置。此值为组织 ID。例如 9876546738。

      例如，以下命令会为名为 my-project 的项目停用存储空间智能分析配置：

      gcloud alpha storage intelligence-configs disable --project=PROJECT_ID

      其中，PROJECT_ID 是 Google Cloud 项目 ID。项目 ID 为字母数字，例如 my-project。

REST API

JSON API

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

  2. 以下部分详细介绍了为资源停用存储空间智能功能的方法。

    为项目停用存储空间智能

    使用 cURL，通过更新项目的存储空间智能请求调用 JSON API。

    curl -X PATCH \
 -H "Content-Type: application/json" \
 -d '{
      "edition_config": "DISABLED"
     }' \
 -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/v2/projects/PROJECT_ID/locations/global/intelligenceConfig?updateMask=edition_config"

    其中：
    PROJECT_ID 是 Google Cloud 项目 ID。项目 ID 为字母数字，例如 my-project。

    为文件夹停用存储空间智能

    使用 cURL 通过更新文件夹的存储空间智能请求调用 JSON API。

    curl -X PATCH \
  -H "Content-Type: application/json" \
  -d '{
    "edition_config": "DISABLED"
  }' \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/v2/folders/FOLDER_ID/locations/global/intelligenceConfig?updateMask=edition_config"

    其中：
    FOLDER_ID 是 Google Cloud 文件夹 ID。文件夹 ID 是数字，例如 123456789012。

    为组织停用存储空间分析情报

    使用 cURL，通过请求为组织停用存储空间智能调用 JSON API。

    curl -X PATCH \
  -H "Content-Type: application/json" \
  -d '{
    "edition_config": "DISABLED"
  }' \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/v2/organizations/ORGANIZATION_ID/locations/global/intelligenceConfig?updateMask=edition_config"

    其中：
    ORGANIZATION_ID 是 Google Cloud 组织 ID。组织 ID 是数字，例如 79293024087。

后续步骤