# Amazon S3 ストレージレンズダッシュボードの更新
Amazon S3 ストレージレンズのデフォルトダッシュボードは `default-account-dashboard` です。このダッシュボードは Amazon S3 によって事前定義されており、無料のメトリクスおよび高度なメトリクスをアカウント全体で集計し、その概要と傾向をコンソール上で可視化するのに役立ちます。デフォルトダッシュボードのスコープ設定を変更することはできませんが、メトリクスの選択を無料メトリクスから有料の高度なメトリクスとレコメンデーションにアップグレードしたり、オプションのメトリクスエクスポートを構成したり、デフォルトダッシュボードを無効にすることは可能です。デフォルトのダッシュボードは削除できません。また、無効にすることのみが可能です。詳細については、「[S3 コンソールの使用](storage_lens_console_deleting.md)」を参照してください。
## S3 コンソールの使用
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]** (ストレージレンズ)、[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 ストレージレンズでダッシュボードに含める、または除外するリージョンとバケットを更新します。
**注記**
リージョンとバケットを、含めるか除外するかの選択が可能です。組織内のメンバーアカウント間で組織レベルのダッシュボードを作成する場合には、このオプションはリージョンのみに対し使用できます。
含めるか除外するバケットは最大 50 個まで選択できます。
1. S3 Storage Lens で含める、または除外するバケットを、選択したリージョンの中で選択します。バケットを含めるか除外するかの設定は可能ですが、両方を同時に設定することはできません。このオプションは、組織レベルのダッシュボードを作成するときには使用できません。
**注記**
リージョンとバケットを、含めるか除外するかの選択が可能です。組織内のメンバーアカウント間で組織レベルのダッシュボードを作成する場合には、このオプションはリージョンのみに対し使用できます。
含めるか除外するバケットは最大 50 個まで選択できます。
1. **[次へ]** を選択して変更を保存し、続行します。
**ステップ 3: ストレージレンズ階層を更新するメトリクスの選択を設定する**
1. **[ストレージレンズ階層]** **[メトリクスの選択]** セクションで、このダッシュボードで集計するメトリクスの階層を更新します。
**注記**
**[無料階層]** から **[アドバンスト階層]** に更新する場合は、**[メトリクスの集約]** 設定を更新する必要があります。**[メトリクスの集約設定]** を更新するには、「**ステップ 4: メトリクスの集約を更新する**」を参照してください。
ストレージレンズ階層を **[アドバンスト階層]** から **[無料階層]** に更新する場合は、**[メトリクスの集約]** 設定を更新する必要はありません。**[メトリクスの集約]** 機能は、**[アドバンスト階層]** メトリクスカテゴリにのみ適用されます。
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. **[その他のメトリクスの集約]** で、次のいずれかを選択して、集約するメトリクスを更新します。
+ プレフィックス集約
+ Storage Lens グループ集約
1. **[プレフィックス集約]** を有効にしている場合は、ダッシュボードの最小 **[プレフィックスのしきい値]** と **[プレフィックスの深さ]** を指定します。**[次へ]** を選択して保存し、続行します。
1. **[ストレージレンズグループ集約]** を有効にしている場合は、次のいずれかを選択します。
+ **ストレージレンズグループを含める**
+ **ストレージレンズグループを除外**
1. ストレージレンズグループを集約に含める場合、**ホームリージョン内のすべてのストレージレンズグループを含める**か、含めるストレージレンズグループを指定できます。
1. **[次へ]** を選択して変更を保存し、続行します。
**ステップ 5: (オプション) メトリクスのエクスポートと公開の設定を更新する**
1. CloudWatch ダッシュボードのストレージレンズメトリクスにアクセスする場合は、**[メトリクスの公開]** で、**[CloudWatch の公開]** を選択します。
**注記**
プレフィックスレベルのメトリクスは CloudWatch では使用できません。
1. **[メトリクスのエクスポート]** で、毎日エクスポートするストレージレンズダッシュボードデータを選択します。
+ **デフォルトのメトリクスレポート**
+ **拡張プレフィックスメトリクスレポート**
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. **[ストレージレンズ階層]** セクションで、設定を確認します。変更があれば **[編集]** をクリックします。
1. **[メトリクスの集約]** セクションで、設定を確認します。変更があれば **[編集]** をクリックします。
1. **[メトリクスのエクスポート]** セクションで、設定を確認します。変更があれば **[編集]** をクリックします。
1. すべてのダッシュボード設定を確認して確定したら、**[送信]** を選択してダッシュボードを更新します。
新しいストレージレンズダッシュボードを正常に更新したら、更新されたダッシュボード設定をストレージレンズ **[ダッシュボード]** ページの下に表示できます。
## の使用AWS CLI
**Example**
次のコマンド例では、Amazon S3 ストレージレンズダッシュボード設定を更新します。これらの例を使用するには、`{{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}}
```
## AWS SDK for Java の使用
**Example – 高度なメトリクスと推奨を使用して Amazon S3 ストレージレンズ設定を更新する**
次の例は、SDK for Java の高度なメトリクスと推奨を使用してデフォルトの S3 ストレージレンズ設定を更新する方法を示しています。
```
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_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection)」を参照してください。S3 Storage Lens グループの詳細については、「[S3 ストレージレンズグループを使用したメトリクスのフィルタリングと集計](storage-lens-groups-overview.md)」を参照してください。