此页面由 Cloud Translation API 翻译。

配置和管理存储空间分析情报
使用集合让一切井井有条根据您的偏好保存内容并对其进行分类。

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

配置存储空间分析情报

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

所需的角色

如需获得配置存储空间智能所需的权限，请让您的管理员向您授予 Google Cloud 资源层次结构（项目、文件夹和组织）的以下任一 IAM 角色：

Owner (roles/owner)
Storage Admin (roles/storage.admin)

这些角色包含 storage.intelligenceConfigs.update 权限，而配置存储空间分析情报需要此权限。
您还可以通过自定义角色获取此权限。您也可以使用其他预定义角色来获取此权限。要查看哪些角色与哪些权限相关联，请参阅适用于 Cloud Storage 的 IAM 角色。

如需授予、更改或撤消对项目、文件夹和组织的访问权限，请参阅管理对项目、文件夹和组织的访问权限。

控制台

在 Google Cloud 控制台中，前往“存储空间智能”配置页面。

前往“配置”
点击配置存储空间分析情报。
在配置存储空间分析对话框中，选择要为哪个资源配置存储空间分析。
点击继续。
可选：如需在存储空间分析情报配置中包含或排除特定存储分区，请执行以下操作：
1. 如需从特定位置中选择存储分区，请使用过滤条件类型菜单。如需包含或排除存储分区，请从位置菜单中选择相应位置。如需了解详情，请参阅按地理位置过滤。
2. 如需按名称选择 Cloud Storage 存储分区，请使用过滤条件类型菜单。如需包含或排除存储分区，请指定存储分区名称的正则表达式，然后点击添加正则表达式。如需了解详情，请参阅按存储分区名称过滤。
点击启用此配置。

命令行

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.
如需配置存储空间智能功能，请将 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：要从 Storage Intelligence 配置中排除的存储分区 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

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

创建一个包含以下详细信息的 JSON 文件：
1. 配置 editionConfig 字段。如需了解详情，请参阅版本配置。
2. 可选：配置 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 是 Storage Intelligence 版本配置。
- 可选：INCLUDED_BUCKET_ID_REGEX 是一个正则表达式，用于指定要包含哪些存储分区 ID。您可以以列表的形式指定一个或多个正则表达式。
- 可选：EXCLUDED_BUCKET_ID_REGEX 是一个正则表达式，用于指定要排除哪些存储分区 ID。您可以以列表的形式指定一个或多个正则表达式。
- 可选：INCLUDED_BUCKET_LOCATION 是您要将存储分区添加到存储空间分析情报配置中的位置。您可以以列表的形式指定一个或多个位置。
- 可选：EXCLUDED_BUCKET_LOCATION 是您要从存储空间分析情报配置中排除存储分区的位置。您可以以列表的形式指定一个或多个位置。
以下部分介绍了如何使用 REST API 为项目、文件夹或组织配置存储空间智能。您还可以使用 REST API 配置 Storage Intelligence 30 天入门级试用。使用以下任一方法配置 Storage Intelligence 或 Storage Intelligence 30 天入门级试用。

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

使用 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 资源的一部分。

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

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

所需的角色

如需获得查看存储空间智能配置所需的权限，请让您的管理员向您授予 Google Cloud 资源层次结构（项目、文件夹和组织）的以下任一 IAM 角色：

Owner (roles/owner)
Storage Admin (roles/storage.admin)

这些角色包含 storage.intelligenceConfigs.get 权限，而查看存储空间智能配置需要此权限。
您还可以通过自定义角色获取此权限。您也可以使用其他预定义角色来获取此权限。要查看哪些角色与哪些权限相关联，请参阅适用于 Cloud Storage 的 IAM 角色。

如需授予、更改或撤消对项目、文件夹和组织的访问权限，请参阅管理对项目、文件夹和组织的访问权限。

控制台

在 Google Cloud 控制台中，前往“存储空间智能”配置页面。

前往“配置”
选择页面顶部的项目选择器。
在选择资源对话框中，选择要查看其存储空间分析情报配置的资源。

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

命令行

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.
如需查看资源的存储空间智能配置，请将 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

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

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

查看项目的 Storage Intelligence 配置

使用 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。

查看文件夹的 Storage Intelligence 配置

使用 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。

查看组织的 Storage Intelligence 配置

使用 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。

更新 Storage Intelligence 配置

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

所需的角色

如需获得更新存储空间智能配置所需的权限，请让您的管理员向您授予 Google Cloud 资源层次结构（项目、文件夹和组织）的以下任一 IAM 角色：

Owner (roles/owner)
Storage Admin (roles/storage.admin)

这些角色包含 storage.intelligenceConfigs.update 权限，而更新存储空间分析情报配置需要此权限。
您还可以通过自定义角色获取此权限。您也可以使用其他预定义角色来获取此权限。要查看哪些角色与哪些权限相关联，请参阅适用于 Cloud Storage 的 IAM 角色。

如需授予、更改或撤消对项目、文件夹和组织的访问权限，请参阅管理对项目、文件夹和组织的访问权限。

控制台

在 Google Cloud 控制台中，前往“存储空间智能”配置页面。

前往“配置”
选择页面顶部的项目选择器。
在选择资源对话框中，选择要更新存储空间分析情报配置的资源。
在概览部分，根据您的需求修改任何可修改的配置选项。例如，您可以为资源停用存储空间智能功能，或将版本配置更改为 Inherit from parent，或更改存储分区过滤条件。

命令行

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.
如需更新资源的存储空间智能配置，请将 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

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

创建一个包含以下详细信息的 JSON 文件：
1. 配置 editionConfig 字段。如需了解详情，请参阅版本配置。
2. 可选：配置 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 是 Storage Intelligence 版本配置。
- 可选：INCLUDED_BUCKET_ID_REGEX 是一个正则表达式，用于指定要包含哪些存储分区 ID。您可以以列表的形式指定一个或多个正则表达式。
- 可选：EXCLUDED_BUCKET_ID_REGEX 是一个正则表达式，用于指定要排除哪些存储分区 ID。您可以以列表的形式指定一个或多个正则表达式。
- 可选：INCLUDED_BUCKET_LOCATION 是您要将存储分区添加到存储空间分析情报配置中的位置。您可以以列表的形式指定一个或多个位置。
- 可选：EXCLUDED_BUCKET_LOCATION 是您要从存储空间分析情报配置中排除存储分区的位置。您可以以列表的形式指定一个或多个位置。
以下部分介绍了如何更新项目、文件夹或组织的存储空间智能配置。使用以下方法之一更新存储空间智能配置。

更新项目的存储空间分析配置

使用 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 资源的一部分。

停用存储空间分析情报

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

所需的角色

如需获得停用存储空间智能功能所需的权限，请让您的管理员向您授予 Google Cloud 资源层次结构（项目、文件夹和组织）的以下任一 IAM 角色：

Owner (roles/owner)
Storage Admin (roles/storage.admin)

这些角色包含 storage.intelligenceConfigs.update 权限，而停用存储空间智能需要此权限。
您还可以通过自定义角色获取此权限。您也可以使用其他预定义角色来获取此权限。要查看哪些角色与哪些权限相关联，请参阅适用于 Cloud Storage 的 IAM 角色。

如需授予、更改或撤消对项目、文件夹和组织的访问权限，请参阅管理对项目、文件夹和组织的访问权限。

控制台

在 Google Cloud 控制台中，前往“存储空间智能”配置页面。

前往“配置”
选择页面顶部的项目选择器。
在选择资源对话框中，选择要为哪些资源停用存储空间分析情报。
在概览部分中，点击状态字段旁边的已启用。
在随即显示的对话框中，输入停用，然后点击停用。

命令行

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.
如需为资源停用存储空间智能配置，请将 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

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

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

为项目停用 Storage Intelligence

使用 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。

后续步骤

了解以下内容：

配置和管理存储空间分析情报 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

配置存储空间分析情报

所需的角色

控制台

命令行

REST API

JSON API

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

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

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

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

所需的角色

控制台

命令行

REST API

JSON API

查看项目的 Storage Intelligence 配置

查看文件夹的 Storage Intelligence 配置

查看组织的 Storage Intelligence 配置

更新 Storage Intelligence 配置

所需的角色

控制台

命令行

REST API

JSON API

更新项目的存储空间分析配置

更新文件夹的存储空间分析情报配置

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

停用存储空间分析情报

所需的角色

控制台

命令行

REST API

JSON API

为项目停用 Storage Intelligence

为文件夹停用存储空间分析情报

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

后续步骤

配置和管理存储空间分析情报
使用集合让一切井井有条根据您的偏好保存内容并对其进行分类。