# 更新 Amazon S3 Storage Lens 存储统计管理工具控制面板
<a name="storage_lens_editing"></a>

 Amazon S3 Storage Lens 存储统计管理工具默认控制面板是 `default-account-dashboard`。此控制面板由 Amazon S3 预配置，可帮助您在控制台上直观显示整个账户的聚合费用和高级指标的汇总见解和趋势。您无法修改原定设置控制面板的配置范围，但是您可以将指标选择从免费指标升级到付费的高级指标和建议，配置可选指标导出，甚至可以禁用原定设置控制面板。无法删除默认控制面板，而只能禁用它。有关更多信息，请参阅 [使用 S3 控制台](storage_lens_console_deleting.md)。

## 使用 S3 控制台
<a name="storage_lens_console_editing"></a>

使用以下步骤在 Amazon S3 控制台中更新 Amazon S3 Storage Lens 存储统计管理工具控制面板。

**步骤 1：更新控制面板并配置常规设置**

1. 登录到 AWS 管理控制台，然后通过以下网址打开 Amazon S3 控制台：[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)。

1. 在左侧导航窗格中，选择 **Storage Lens（Storage Lens 存储统计管理工具）和 Dashboards（控制面板）**。

1. 选择要编辑的控制面板。

1. 选择**查看控制面板配置**。

1. 选择**编辑**。现在，您可以逐个步骤查看控制面板配置。要对任何步骤进行更改，您可以使用左侧导航栏直接单击该步骤。有关如何更新这些步骤的说明，
**注意**  
不能更改以下内容：  
控制面板名称
主区域

1. 在**控制面板**页面的**常规**部分中，您可以更改以下各项：
   + 选择**已启用**或**已禁用**来更新您是否在控制面板中接收每日指标。
   + （可选）您可以选择将**标签**添加到控制面板。您可以使用标签管理控制面板的权限并跟踪 S3 Storage Lens 存储统计管理工具的成本。有关更多信息，请参阅《IAM 用户指南》**中的[使用标签控制对 AWS 资源的访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)以及《AWS Billing 用户指南》**中的[使用 AWS 生成的标签](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tags.html)。
**注意**  
您最多可以在控制面板配置中添加 50 个标签。

1. 选择**下一步**以保存您的更改并继续。

**步骤 2：更新控制面板范围**

1. 在**控制面板范围**部分，更新希望 S3 Storage Lens 存储统计管理工具在控制面板中包括或排除的区域和存储桶。
**注意**  
您可以包括或排除区域和桶。在组织中跨成员账户创建组织级控制面板时，此选项仅限于“区域”。
您最多可以选择 50 个桶来包括或排除。

1. 在所选区域中选择希望 S3 Storage Lens 存储统计管理工具包括或排除的桶。您可以包括或排除桶，但不能同时包括和排除桶。创建组织级控制面板时，此选项不可用。
**注意**  
您可以包括或排除区域和桶。在组织中跨成员账户创建组织级控制面板时，此选项仅限于“区域”。
您最多可以选择 50 个桶来包括或排除。

1. 选择**下一步**以保存您的更改并继续。

**第 3 步：更新 Storage Lens 存储统计管理工具套餐来配置指标选择**

1. 在 **Storage Lens 存储统计管理工具套餐****指标选择**部分，更新要为此控制面板聚合的指标套餐。
**注意**  
如果要从**免费套餐**更新为**高级套餐**，您需要更新**指标聚合**设置。要更新**指标聚合设置**，请参阅**步骤 4：更新指标聚合**。
如果要将 Storage Lens 存储统计管理工具套餐从**高级套餐**更新为**免费套餐**，您需要更新任意**指标聚合**设置。**指标聚合**功能仅适用于**高级套餐**指标类别。

1. 要包括在存储桶级别聚合且可在 14 天内供查询的免费指标，请选择**免费套餐**。

1. 要启用高级指标，请选择**高级套餐**。这些选项包括前缀聚合、Amazon CloudWatch 发布和情境化建议。数据可查询 15 个月。高级指标和建议需要额外付费。有关更多信息，请参阅 [Amazon S3 定价](https://aws.amazon.com/s3/pricing/)。

   有关高级指标和免费指标的更多信息，请参阅[指标选择](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection)。

1. 在**高级指标类别**下，选择您要启用的指标类别：
   + **活动指标**
   + **Detailed status code metrics（详细的状态代码指标**
   + **成本优化指标**
   + **数据保护指标**
   + **性能指标**

   要预览每个类别中包含哪些指标，请使用指标类别复选框列表下方的下拉箭头按钮。有关指标类别的更多信息，请参阅[指标类别](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_types)。要获得指标的完整列表，请参阅 [Amazon S3 Storage Lens 存储统计管理工具指标词汇表](storage_lens_metrics_glossary.md)。

1. 选择或指定**前缀分隔符**来区分每个前缀中的级别。此值用来标识每个前缀级别。Amazon S3 中的默认值为“`/`”字符，但是您的存储结构可能会使用其他分隔符字符。

1. 选择**下一步**以保存您的更改并继续。

**步骤 4：（可选）更新指标聚合**

1. 在**其他指标聚合**下，通过选择以下内容之一来更新要聚合的指标：
   + Prefix aggregation（前缀聚合）
   + Storage Lens 组聚合

1. 如果您启用了**前缀聚合**，请为控制面板指定最小**前缀阈值**和**前缀深度**。然后选择**下一步**以保存并继续。

1. 如果您已启用 **Storage Lens 组聚合**，请选择以下选项之一：
   + **包括 Storage Lens 组**
   + **排除 Storage Lens 组**

1. 当您在聚合中包括 Storage Lens 组时，您可以**包括主区域中的所有 Storage Lens 组**，也可以指定要包括的 Storage Lens 组。

1. 选择**下一步**以保存您的更改并继续。

**步骤 5：（可选）更新指标导出和发布设置**

1. 如果您想在 CloudWatch 控制面板中访问 Storage Lens 存储统计管理工具指标，请在**指标发布**下选择 **CloudWatch 发布**。
**注意**  
前缀级别的指标在 CloudWatch 中不可用。

1. 在**指标导出**下，选择要每天导出的 Storage Lens 存储统计管理工具控制面板数据：
   + **默认指标报告**
   + **扩展前缀指标报告**

1. （可选）如果您选择了**默认指标报告**，则在**默认指标报告**设置中，选择存储桶类型。您可以将报告导出到通用 S3 存储桶或只读 S3 表存储桶。根据所选存储桶类型，更新**通用存储桶目标设置**或**表存储桶目标设置**选项。
**注意**  
**默认指标报告**仅包含在前缀聚合设置中所设定的阈值和深度范围内的前缀。如果您尚未配置前缀聚合，则该阈值将包括最多 100 个按大小计算的最大前缀。
如果您选择指定加密密钥，则必须选择 AWS KMS 密钥（SSE-KMS）或 Amazon S3 托管密钥（SSE-S3）。如果您的目标存储桶策略要求加密，则必须为指标导出提供加密密钥。如果没有加密密钥，导出到 S3 会失败。有关更多信息，请参阅 [使用 AWS KMS key 加密您的指标导出](storage_lens_encrypt_permissions.md)。

1. 选择**下一步**以保存您的更改并继续。

1. （可选）如果您选择了**扩展前缀指标报告**，请在**扩展前缀指标报告**设置中，选择存储桶类型。您可以将报告导出到通用 S3 存储桶或只读 S3 表存储桶。根据所选存储桶类型，更新**通用存储桶目标设置**或**表存储桶目标设置**。
**注意**  
**扩展前缀指标报告**包括在控制面板范围内指定的所有存储桶中的前缀。
如果您选择指定加密密钥，则必须选择 AWS KMS 密钥（SSE-KMS）或 Amazon S3 托管密钥（SSE-S3）。如果您的目标存储桶策略要求加密，则必须为指标导出提供加密密钥。如果没有加密密钥，导出到 S3 会失败。有关更多信息，请参阅 [使用 AWS KMS key 加密您的指标导出](storage_lens_encrypt_permissions.md)。

1. 选择**下一步**以保存您的更改并继续。

**步骤 6：检查并更新控制面板配置**

1. 检查**常规**部分中的设置。选择**编辑**以进行任何更改。

1. 检查**控制面板范围**部分中的设置。选择**编辑**以进行任何更改。

1. 检查 **Storage Lens 存储统计管理工具套餐**部分中的设置。选择**编辑**以进行任何更改。

1. 检查**指标聚合**部分中的设置。选择**编辑**以进行任何更改。

1. 检查**指标导出**部分中的设置。选择**编辑**以进行任何更改。

1. 检查并确认所有控制面板配置设置后，选择**提交**以更新控制面板。

在您成功更新了 Storage Lens 存储统计管理工具控制面板后，您可以在 Storage Lens 存储统计管理工具**控制面板**页面下查看列出更新后控制面板配置。

## 使用 AWS CLI
<a name="S3PutStorageLensConfigurationTagsCLI"></a>

**Example**  
以下示例命令更新 Amazon S3 Storage Lens 存储统计管理工具控制面板配置。要使用这些示例，请将 `user input placeholders` 替换为您自己的信息。  

```
aws s3control put-storage-lens-configuration --account-id=111122223333 --config-id=example-dashboard-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json --tags=file://./tags.json
```

## 使用适用于 Java 的 AWS SDK
<a name="S3UpdateStorageLensConfigurationAdvancedJava"></a>

**Example – 使用高级指标和建议更新默认 Amazon S3 Storage Lens 存储统计管理工具配置**  
以下示例显示了如何在适用于 Java 的 SDK 中使用高级指标和建议来更新默认 S3 Storage Lens 存储统计管理工具配置。  

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.AccountLevel;
import com.amazonaws.services.s3control.model.ActivityMetrics;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.Format;
import com.amazonaws.services.s3control.model.Include;
import com.amazonaws.services.s3control.model.OutputSchemaVersion;
import com.amazonaws.services.s3control.model.PrefixLevel;
import com.amazonaws.services.s3control.model.PrefixLevelStorageMetrics;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.S3BucketDestination;
import com.amazonaws.services.s3control.model.SSES3;
import com.amazonaws.services.s3control.model.SelectionCriteria;
import com.amazonaws.services.s3control.model.StorageLensAwsOrg;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensDataExport;
import com.amazonaws.services.s3control.model.StorageLensDataExportEncryption;
import com.amazonaws.services.s3control.model.StorageLensTag;

import java.util.Arrays;
import java.util.List;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class UpdateDefaultConfigWithPaidFeatures {

    public static void main(String[] args) {
        String configurationId = "default-account-dashboard"; // This configuration ID cannot be modified.
        String sourceAccountId = "111122223333";

        try {
            SelectionCriteria selectionCriteria = new SelectionCriteria()
                    .withDelimiter("/")
                    .withMaxDepth(5)
                    .withMinStorageBytesPercentage(10.0);
            PrefixLevelStorageMetrics prefixStorageMetrics = new PrefixLevelStorageMetrics()
                    .withIsEnabled(true)
                    .withSelectionCriteria(selectionCriteria);
            BucketLevel bucketLevel = new BucketLevel()
                    .withActivityMetrics(new ActivityMetrics().withIsEnabled(true))
                    .withPrefixLevel(new PrefixLevel().withStorageMetrics(prefixStorageMetrics));
            AccountLevel accountLevel = new AccountLevel()
                    .withActivityMetrics(new ActivityMetrics().withIsEnabled(true))
                    .withBucketLevel(bucketLevel);

            StorageLensConfiguration configuration = new StorageLensConfiguration()
                    .withId(configurationId)
                    .withAccountLevel(accountLevel)
                    .withIsEnabled(true);

            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
                    .withStorageLensConfiguration(configuration)
            );

        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
```

要访问 S3 Storage Lens 组或扩展前缀，您必须升级控制面板以使用高级套餐。将收取额外费用。有关免费和高级套餐的更多信息，请参阅[指标选择](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection)。有关 S3 Storage Lens 组的更多信息，请参阅 [使用 S3 Storage Lens 组筛选和汇总指标](storage-lens-groups-overview.md)。