本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 更新 Amazon S3 Storage Lens 儀表板
Amazon S3 Storage Lens 預設儀表板為 `default-account-dashboard`。此儀表板是由 Amazon S3 預先設定，可協助您在主控台上以視覺化方式呈現整個帳戶彙總的免費和進階指標的摘要洞見和趨勢。您無法修改預設儀表板的組態範圍，但您可以將指標選項從免費指標升級為付費進階指標和建議、設定選用指標匯出，甚至停用預設儀表板。預設儀表板無法刪除，且只能停用。如需詳細資訊，請參閱[使用 S3 主控台](storage_lens_console_deleting.md)。
## 使用 S3 主控台
使用下列步驟在 Amazon S3 主控台上更新 Amazon S3 Storage Lens 儀表板。
**步驟 1：更新您的儀表板並設定一般設定**
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 的 Amazon S3 主控台。
1. 在左導覽窗格中，選擇 **Storage Lens, Dashboards** (Storage Lens、儀表板)。
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 個月的時間可用於查詢。進階指標和建議會有額外的費用。如需詳細資訊，請參閱 [Simple Storage Service (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. **在其他指標彙總**下，選擇下列其中一項來更新要彙總的指標：
+ 字首彙總
+ 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
**注意**
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
**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 開發套件
**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)。