# Storage Lens グループの使用
<a name="storage-lens-group-tasks"></a>

Amazon S3 ストレージレンズグループは、オブジェクトメタデータに基づくカスタムフィルタを使用してメトリクスを集約します。プレフィックス、サフィックス、オブジェクトタグ、オブジェクトサイズ、オブジェクト経過時間使用して S3 Storage Lens メトリクスを分析およびフィルタリングできます。Amazon S3 ストレージレンズのグループを使用して、Amazon S3 バケット間での使用状況を分類することもできます。その結果、S3 ストレージの理解を深め最適化できるようになります。

Storage Lens グループのデータの視覚化を開始するには、まず [Storage Lens グループを S3 Storage Lens ダッシュボードにアタッチする](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html#storage-lens-groups-attach-dashboard-console)必要があります。Storage Lens グループをダッシュボードで管理する必要がある場合は、ダッシュボードの設定を編集できます。アカウントにどの Storage Lens グループがあるかを確認するには、それらのグループを一覧表示できます。どの Storage Lens グループがダッシュボードにアタッチされているかを確認するには、ダッシュボードの **[Storage Lens グループ]** タブを随時確認できます。既存の Storage Lens グループのスコープを確認または更新するには、その詳細を表示できます。Storage Lens グループを完全に削除することもできます。

権限を管理するために、ユーザー定義の AWS リソースタグを作成して Storage Lens グループに追加できます。AWS リソースタグを使用して、部門、事業内容、またはプロジェクトごとにリソースを分類できます。そうすることで、同じ種類のリソースが多い場合に役立ちます。タグを適用すると、割り当てたタグに基づいて特定の Storage Lens グループをすばやく識別できます。

さらに、Storage Lens グループに AWS リソースタグを追加すると、[属性ベースのアクセス制御 (ABAC](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html)) が有効になります。ABAC は、このケースタグの属性に基づいて権限を定義する認可戦略です。IAM ポリシーでリソースタグを指定する条件を使用して、[AWS リソースへのアクセス](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources)を制御できます。

**Topics**
+ [

# Storage Lens グループの作成
](storage-lens-groups-create.md)
+ [

# S3 Storage Lens グループをダッシュボードにアタッチまたは削除する、またはダッシュボードから S3 Storage Lens グループを削除する
](storage-lens-groups-dashboard-console.md)
+ [

# Storage Lens グループのデータの視覚化
](storage-lens-groups-visualize.md)
+ [

# Storage Lens グループの更新
](storage-lens-groups-update.md)
+ [

# Storage Lens グループによる AWS リソースタグの管理
](storage-lens-groups-manage-tags.md)
+ [

# すべての Storage Lens グループの一覧表示
](storage-lens-groups-list.md)
+ [

# Storage Lens グループ詳細の表示
](storage-lens-groups-view.md)
+ [

# Storage Lens グループの削除
](storage-lens-groups-delete.md)

# Storage Lens グループの作成
<a name="storage-lens-groups-create"></a>

以下の例は、Amazon S3 コンソール AWS Command Line Interface (AWS CLI)、および AWS SDK for Java を使用して Amazon S3 ストレージレンズグループを作成する方法を示しています。

## S3 コンソールの使用
<a name="create-storage-lens-group-console"></a>

**Storage Lens グループを作成するには**

1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。

1. ページ上部にあるナビゲーションバーで、現在表示されている AWS リージョンの名前をクリックします。次に、切り替え先のリージョンを選択します。

1. ナビゲーションペインで、**[Storage Lens グループ]**を選択します。

1. **[Storage Lens グループの作成]** を選択します。

1. **[全般]** で、現在の **[ホームリージョン]** を表示して、**[ストレージレンズグループ名]** を入力します。

1. **[スコープ]** で、Storage Lens グループに適用するためのフィルタを選択します。複数のフィルタを適用するには、フィルタを選択し、**AND** または **OR** 論理演算子を選択します。
   + **[プレフィックス]** フィルタでは、**[プレフィックス]** を選択し、プレフィックス文字列を入力します。複数のプレフィックスを追加するには、**[プレフィックスを追加]** を選択します。プレフィックスを削除するには、削除するボリュームの横にある **[削除]** を選択します。
   + **[オブジェクトタグ]** フィルタでは、**[オブジェクトタグ]** を選択し、オブジェクトのキーと値のペアを入力します。次に、**[タグを追加]** を選択します。タグを削除するには、削除したいタグの横にある**[削除]** を選択します。
   + **[サフィックス]** フィルタでは、**[サフィックス]** を選択し、サフィックス文字列を入力します。複数のサフィックスを追加するには、**[サフィックスを追加]** を選択します。サフィックスを削除するには、削除したいサフィックスの横にある**[削除]** を選択します。
   + **[経過時間]** フィルタでは、オブジェクトの有効期間を日単位で指定します。**[オブジェクトの最短経過時間を指定]** を選択し、オブジェクトの最低経過時間を入力します。次に、**[オブジェクトの最長経過時間を指定]** を選択し、オブジェクトの最長経過時間を入力します。
   + **[サイズ]** フィルタで、オブジェクトサイズの範囲と測定単位を指定します。**[最小オブジェクトサイズを指定]** を選択し、オブジェクトの最小オブジェクトサイズを入力します。**[最大オブジェクトサイズを指定]** を選択し、オブジェクトの最大オブジェクトサイズを入力します。

1. (オプション) AWS リソースタグには、キーと値のペアを追加し、**[タグを追加]** を選択します。

1. **[Storage Lens グループの作成]** を選択します。

## の使用AWS CLI
<a name="create-storage-lens-group-cli"></a>

次の AWS CLI コマンド例は、Storage Lens グループを作成します。このコマンド例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
aws s3control create-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --storage-lens-group=file://./marketing-department.json
```

次の AWS CLI コマンド例は、2 つの AWS リソースタグを持つ Storage Lens グループを作成します。このコマンドの例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
aws s3control create-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --storage-lens-group=file://./marketing-department.json \
--tags Key=k1,Value=v1 Key=k2,Value=v2
```

JSON 設定例については、「[Storage Lens グループの設定](storage-lens-groups.md#storage-lens-groups-configuration)」を参照してください。

## AWS SDK for Java の使用
<a name="create-storage-lens-group-sdk-java"></a>

次の AWS SDK for Java 例は、Storage Lens グループを作成します。この例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

**Example — 1 つのフィルタで Storage Lens グループを作成します。**  
次の例は、`Marketing-Department` という Storage Lens グループを作成します。このグループには、経過時間範囲を `30`～`90` 日で指定するオブジェクト経過時間フィルタがあります。この例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。  

```
package aws.example.s3control;
 
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.MatchObjectAge;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
 
public class CreateStorageLensGroupWithObjectAge {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";
        
        try {
            StorageLensGroupFilter objectAgeFilter = StorageLensGroupFilter.builder()
                    .matchObjectAge(MatchObjectAge.builder()
                            .daysGreaterThan(30)
                            .daysLessThan(90)
                            .build())
                    .build();

            StorageLensGroup storageLensGroup = StorageLensGroup.builder()
                    .name(storageLensGroupName)
                    .filter(objectAgeFilter)
                    .build();

            CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
                    .storageLensGroup(storageLensGroup)
                    .accountId(accountId).build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
        } 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();
        }
    }
}
```

**Example — 複数のフィルタを含む `AND` 演算子を使用して Storage Lens グループを作成します。**  
次の例は、`Marketing-Department` という Storage Lens グループを作成します。このグループ `AND` は演算子を使用して、オブジェクトが**すべて**のフィルタ条件に一致する必要があることを示します。この例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。  

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.MatchObjectAge;
import software.amazon.awssdk.services.s3control.model.MatchObjectSize;
import software.amazon.awssdk.services.s3control.model.S3Tag;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupAndOperator;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;


public class CreateStorageLensGroupWithAndFilter {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            // Create object tags.
            S3Tag tag1 = S3Tag.builder()
                    .key("object-tag-key-1")
                    .value("object-tag-value-1")
                    .build();
            S3Tag tag2 = S3Tag.builder()
                    .key("object-tag-key-2")
                    .value("object-tag-value-2")
                    .build();

            StorageLensGroupAndOperator andOperator = StorageLensGroupAndOperator.builder()
                    .matchAnyPrefix("prefix-1", "prefix-2", "prefix-3/sub-prefix-1")
                    .matchAnySuffix(".png", ".gif", ".jpg")
                    .matchAnyTag(tag1, tag2)
                    .matchObjectAge(MatchObjectAge.builder()
                            .daysGreaterThan(30)
                            .daysLessThan(90).build())
                    .matchObjectSize(MatchObjectSize.builder()
                            .bytesGreaterThan(1000L)
                            .bytesLessThan(6000L).build())
                    .build();

            StorageLensGroupFilter andFilter = StorageLensGroupFilter.builder()
                    .and(andOperator)
                    .build();

            StorageLensGroup storageLensGroup = StorageLensGroup.builder()
                    .name(storageLensGroupName)
                    .filter(andFilter)
                    .build();

            CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
                    .storageLensGroup(storageLensGroup)
                    .accountId(accountId).build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
        } 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();
        }
    }
}
```

**Example — 複数のフィルタを含む `OR` 演算子を使用して Storage Lens グループを作成します。**  
次の例は、`Marketing-Department` という Storage Lens グループを作成します。このグループは、`OR` 演算子を使用してプレフィックスフィルタ (`prefix-1`、`prefix-2`、`prefix3/sub-prefix-1`) または `1000`～`6000` バイトまでのサイズ範囲を持つオブジェクトサイズフィルタを適用します。この例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。  

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.MatchObjectSize;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupOrOperator;

public class CreateStorageLensGroupWithOrFilter {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            StorageLensGroupOrOperator orOperator = StorageLensGroupOrOperator.builder()
                    .matchAnyPrefix("prefix-1", "prefix-2", "prefix-3/sub-prefix-1")
                    .matchObjectSize(MatchObjectSize.builder()
                            .bytesGreaterThan(1000L)
                            .bytesLessThan(6000L)
                            .build())
                    .build();

            StorageLensGroupFilter orFilter = StorageLensGroupFilter.builder()
                    .or(orOperator)
                    .build();

            StorageLensGroup storageLensGroup = StorageLensGroup.builder()
                    .name(storageLensGroupName)
                    .filter(orFilter)
                    .build();

            CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
                    .storageLensGroup(storageLensGroup)
                    .accountId(accountId).build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
        } 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();
        }
    }
}
```

**Example — 1 つのフィルタと 2 つの AWS リソースタグを持つ Storage Lens グループを作成します。**  
次の例は、サフィックスフィルタを持つ `Marketing-Department` という Storage Lens グループを作成します。この例では、Storage Lens グループに 2 AWS つのリソースタグも追加しています。この例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。  

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
import software.amazon.awssdk.services.s3control.model.Tag;

public class CreateStorageLensGroupWithResourceTags {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            // Create AWS resource tags.
            Tag resourceTag1 = Tag.builder()
                    .key("resource-tag-key-1")
                    .value("resource-tag-value-1")
                    .build();
            Tag resourceTag2 = Tag.builder()
                    .key("resource-tag-key-2")
                    .value("resource-tag-value-2")
                    .build();

            StorageLensGroupFilter suffixFilter = StorageLensGroupFilter.builder()
                    .matchAnySuffix(".png", ".gif", ".jpg")
                    .build();

            StorageLensGroup storageLensGroup = StorageLensGroup.builder()
                    .name(storageLensGroupName)
                    .filter(suffixFilter)
                    .build();

            CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
                    .storageLensGroup(storageLensGroup)
                    .tags(resourceTag1, resourceTag2)
                    .accountId(accountId).build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
        } 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();
        }
    }
}
```

JSON 設定例については、「[Storage Lens グループの設定](storage-lens-groups.md#storage-lens-groups-configuration)」を参照してください。

# S3 Storage Lens グループをダッシュボードにアタッチまたは削除する、またはダッシュボードから S3 Storage Lens グループを削除する
<a name="storage-lens-groups-dashboard-console"></a>

Amazon S3 ストレージレンズの高度なティアにアップグレードしたら、[Storage Lens グループ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-overview.html)をダッシュボードにアタッチできます。複数の Storage Lens グループがある場合、目的のグループを含めたり除外したりできます。

Storage Lens グループは、ダッシュボードアカウントの指定されたホームリージョン内に存在している必要があります。Storage Lens グループをダッシュボードに接続すると、48 時間以内にメトリクスのエクスポートで追加の Storage Lens グループの集約データを受け取ります。

**注記**  
Storage Lens グループの集約メトリクスを表示するには、そのデータを Storage Lens ダッシュボードにアタッチする必要があります。Storage Lens グループの JSON 設定ファイルの例については、「[JSON の Storage Lens グループを使用した S3 Storage Lens の設定例](S3LensHelperFilesCLI.md#StorageLensGroupsHelperFilesCLI)」を参照してください。

## S3 コンソールの使用
<a name="storage-lens-groups-attach-dashboard-console"></a>

**Storage Lens グループを Storage Lens ダッシュボードにアタッチするには**

1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。

1. 左ナビゲーションペインの、**[S3 Storage Lens ]** で、**[ダッシュボード]** を選択します。

1. Storage Lens グループをアタッチする Storage Lens ダッシュボードのオプションボタンを選択します。

1. **[編集]** を選択します。

1. **メトリクスの選択**で **[Advanced metrics and recommendations]** (アドバンストメトリクスとレコメンデーション) を選択します。

1. **[Storage Lens グループ集約]** を選択します。
**注記**  
デフォルトでは、**[高度なメトリクス]** も選択されています。ただし、Storage Lens グループのデータを集約する必要がないため、この設定の選択を解除することもできます。

1. **[ストレージレンズグループ集約]** までスクロールし、データ集約に含める、または除外する 1 つまたは複数の Storage Lens グループを指定します。次のフィルタリングオプションを設定できます。
   + 特定の Storage Lens グループを含める場合は、**[Storage Lens グループを含める]** を選択します。**[含めるStorage Lens グループ]** で、Storage Lens グループを選択します。
   + すべての Storage Lens グループを含める場合は、[**ホームリージョンのすべてのStorage Lens グループをこのアカウントに含める**] を選択します。
   + 特定の Storage Lens グループを除外する場合は、**[Storage Lens グループを除外する]** を選択します。**[除外する Storage Lens グループ]** で、除外する Storage Lens グループを選択します。

1. **[Save changes]** (変更の保存) をクリックします。Storage Lens グループを正しく設定していれば、48 時間以内にダッシュボードに追加の Storage Lens グループ集約データが表示されます。

**S3 Storage Lens ダッシュボードから Storage Lens グループを削除するには**

1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。

1. ナビゲーションペインの、**[S3 Storage Lens]** で、**[ダッシュボード]** を選択します。

1. Storage Lens グループを削除する Storage Lens ダッシュボードのオプションボタンを選択します。

1. **[ダッシュボード設定を表示]** を選択します。

1. **[編集]** を選択します。

1. **[メトリクスの選択]** セクションまで下にスクロールします。

1. **[Storage Lens グループ集約]** で、削除する Storage Lens グループの横にある **[X]** を選択します。これにより、Storage Lens グループが削除されます。

   すべての Storage Lens グループをダッシュボードに含めた場合は、**[このアカウントにホームリージョンのすべての Storage Lens グループを含める]** の横にあるチェックボックスをオフにします。

1. **[Save changes]** (変更の保存) をクリックします。
**注記**  
ダッシュボードに設定の更新が反映されるまでに最大 48 時間かかることがあります。

## AWS SDK for Java の使用
<a name="StorageLensGroupsConfigurationJava"></a>

**Example – すべての ストレージレンズグループをダッシュボードにアタッチする**  
次の SDK for Java の例では、アカウント *111122223333* のすべての Storage Lens グループを *DashboardConfigurationId* ダッシュボードにアタッチします。  

```
package aws.example.s3control;


import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.model.AccountLevel;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensGroupLevel;

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

public class CreateDashboardWithStorageLensGroups {
    public static void main(String[] args) {
        String configurationId = "ExampleDashboardConfigurationId";
        String sourceAccountId = "111122223333";

        try {
            StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel();

            AccountLevel accountLevel = new AccountLevel()
                    .withBucketLevel(new BucketLevel())
                    .withStorageLensGroupLevel(storageLensGroupLevel);

            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();
        }
    }
}
```

**Example – 2 つの ストレージレンズグループをダッシュボードにアタッチする**  
次の AWS SDK for Java 例では、2 つのストレージレンズグループ (*StorageLensGroupName1* と *StorageLensGroupName2*) を *ExampleDashboardConfigurationId* ダッシュボードにアタッチします。  

```
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.BucketLevel;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensGroupLevel;
import com.amazonaws.services.s3control.model.StorageLensGroupLevelSelectionCriteria;

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

public class CreateDashboardWith2StorageLensGroups {
    public static void main(String[] args) {
        String configurationId = "ExampleDashboardConfigurationId";
        String storageLensGroupName1 = "StorageLensGroupName1";
        String storageLensGroupName2 = "StorageLensGroupName2";
        String sourceAccountId = "111122223333";

        try {
            StorageLensGroupLevelSelectionCriteria selectionCriteria = new StorageLensGroupLevelSelectionCriteria()
                    .withInclude(
                            "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName1,
                            "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName2);

            System.out.println(selectionCriteria);
            StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel()
                    .withSelectionCriteria(selectionCriteria);

            AccountLevel accountLevel = new AccountLevel()
                    .withBucketLevel(new BucketLevel())
                    .withStorageLensGroupLevel(storageLensGroupLevel);

            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();
        }
    }
}
```

**Example – 除外項目を含むすべてのストレージレンズグループをアタッチする**  
次の SDK for Java 例では、2 つの Storage Lens グループを *ExampleDashboardConfigurationId* ダッシュボードにアタッチします (指定した *StorageLensGroupName1* と *StorageLensGroupName2* を除く):  

```
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.BucketLevel;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensGroupLevel;
import com.amazonaws.services.s3control.model.StorageLensGroupLevelSelectionCriteria;

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

public class CreateDashboardWith2StorageLensGroupsExcluded {
    public static void main(String[] args) {
        String configurationId = "ExampleDashboardConfigurationId";
        String storageLensGroupName1 = "StorageLensGroupName1";
        String storageLensGroupName2 = "StorageLensGroupName2";
        String sourceAccountId = "111122223333";

        try {
            StorageLensGroupLevelSelectionCriteria selectionCriteria = new StorageLensGroupLevelSelectionCriteria()
                    .withInclude(
                            "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName1,
                            "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName2);

            System.out.println(selectionCriteria);
            StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel()
                    .withSelectionCriteria(selectionCriteria);

            AccountLevel accountLevel = new AccountLevel()
                    .withBucketLevel(new BucketLevel())
                    .withStorageLensGroupLevel(storageLensGroupLevel);

            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();
        }
    }
}
```

# Storage Lens グループのデータの視覚化
<a name="storage-lens-groups-visualize"></a>

Storage Lens グループのデータは、[Amazon S3 ストレージレンズダッシュボードにグループをアタッチする](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html#storage-lens-groups-attach-dashboard-console)ことで視覚化できます。ダッシュボード設定の Storage Lens グループ集約に Storage Lens グループを含めてから、Storage Lens グループのデータがダッシュボードに表示されるまでに最大 48 時間かかることがあります。

ダッシュボードの設定が更新されると、新しくアタッチされた Storage Lens グループが **[Storage Lens グループ]** タブの使用可能なリソースのリストに表示されます。データを別の次元でスライスすることで、**[概要]** タブでストレージ使用状況をさらに分析することもできます。例えば、**上位 3 つ**のカテゴリにリストされている項目の 1 つを選択し、**[分析基準]** を選択すると、データを別のディメンションで分割できます。フィルタ自体と同じディメンションを適用することはできません。

**注記**  
Storage Lens グループフィルタとプレフィックスフィルタ、またはその逆は適用できません。また、プレフィックスフィルタを使用して Storage Lens グループをさらに分析することもできません。

Amazon S3 ストレージレンズダッシュボードの [**Storage Lens グループ**] タブを使用して、ダッシュボードにアタッチされている Storage Lens グループのデータ視覚化をカスタマイズできます。ダッシュボードに添付されている一部の Storage Lens グループ、またはすべてのデータを視覚化できます。

S3 Storage Lens のデータを視覚化するときは、次の点に注意してください。
+ S3 Storage Lens は、一致するすべての Storage Lens グループのオブジェクトの使用状況メトリクスを集約します。そのため、オブジェクトが 2 つ以上の Storage Lens グループのフィルタ条件に一致すると、ストレージ使用状況全体で同じオブジェクトの数が繰り返し表示されます。
+ オブジェクトは、Storage Lens グループに含めるフィルタと一致する必要があります。Storage Lens グループに含めるフィルタに一致するオブジェクトがない場合、メトリクスは生成されません。未割り当てのオブジェクトがないかどうかを確認するには、ダッシュボードでアカウントレベルとバケットレベルの合計オブジェクト数を確認します。

# Storage Lens グループの更新
<a name="storage-lens-groups-update"></a>

以下の例は、Amazon S3 ストレージレンズグループを更新する方法を示しています。Amazon S3 コンソール AWS Command Line Interface (AWS CLI)、および AWS SDK for Java を使用して Storage Lens グループを更新できます。

## S3 コンソールの使用
<a name="update-storage-lens-group-console"></a>

**Storage Lens グループを更新するには**

1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。

1. ナビゲーションペインで、**[Storage Lens グループ]**を選択します。

1. **[Storage Lens グループ]** で、更新する Storage Lens グループを選択します。

1. [**スコープ**] で、[**編集**] を選択します。

1. **[スコープ]** ページで、Storage Lens グループに適用するためのフィルタを選択します。**複数のフィルタを適用するには、フィルタを選択し、AND** または **OR** の論理演算子を選択します。
   + **[プレフィックス]** フィルタでは、**[プレフィックス]** を選択し、プレフィックス文字列を入力します。複数のプレフィックスを追加するには、**[プレフィックスを追加]** を選択します。プレフィックスを削除するには、削除するボリュームの横にある **[削除]** を選択します。
   + **[オブジェクトタグ]** フィルタでは、オブジェクトのキーと値のペアを入力します。次に、**[タグの追加]** を選択します。タグを削除するには、削除したいタグの横にある**[削除]** を選択します。
   + **[サフィックス]** フィルタでは、**[サフィックス]** を選択し、サフィックス文字列を入力します。複数のサフィックスを追加するには、**[サフィックスを追加]** を選択します。サフィックスを削除するには、削除したいサフィックスの横にある**[削除]** を選択します。
   + **[経過時間]** フィルタでは、オブジェクトの有効期間を日単位で指定します。**[オブジェクトの最短経過時間を指定]** を選択し、オブジェクトの最低経過時間を入力します。**[オブジェクトの最長経過時間を指定]** を選択し、オブジェクトの最長経過時間を入力します。
   + **[サイズ]** フィルタで、オブジェクトサイズの範囲と測定単位を指定します。**[最小オブジェクトサイズを指定]** を選択し、オブジェクトの最小オブジェクトサイズを入力します。**[最大オブジェクトサイズを指定]** に、オブジェクトの最大オブジェクトサイズを入力します。

1. **[Save changes]** (変更の保存) をクリックします。Storage Lens グループの詳細ページが表示されます。

1. (オプション) 新しい AWS リソースタグを追加する場合は、**[AWS リソースタグ]** セクションまでスクロールし、**[タグを追加]** を選択します。**タグの追加** ページが表示されます。

   新しいキーと値のペアを追加し、**[変更の保存]** を選択します。Storage Lens グループの詳細ページが表示されます。

1. (オプション) 既存の AWS リソースタグを削除する場合は、**[AWS リソースタグ]** セクションまでスクロールし、リソースタグを選択します。その後、**[削除]** をクリックします。**[AWS タグの削除]** ダイアログボックスが表示されます。

   AWS リソースタグを完全に削除するには、もう一度 **[削除]** を選択します。
**注記**  
AWS リソースタグを完全に削除すると、元に戻すことはできません。

## の使用AWS CLI
<a name="update-storage-lens-group-cli"></a>

以下の AWS CLI 例コマンドでは、`marketing-department` という名前の Storage Lens グループの設定の詳細を返します。このコマンド例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。



```
aws s3control get-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --name marketing-department
```

次の AWS CLI 例は、Storage Lens グループを更新します。このコマンド例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
aws s3control update-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --storage-lens-group=file://./marketing-department.json
```

JSON 設定例については、「[Storage Lens グループの設定](storage-lens-groups.md#storage-lens-groups-configuration)」を参照してください。

## AWS SDK for Java の使用
<a name="update-storage-lens-group-sdk-java"></a>

以下の AWS SDK for Java 例では、アカウント `111122223333` の `Marketing-Department` Storage Lens グループの設定の詳細を返します。この例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupResponse;

public class GetStorageLensGroup {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            GetStorageLensGroupRequest getRequest = GetStorageLensGroupRequest.builder()
                    .name(storageLensGroupName)
                    .accountId(accountId).build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            GetStorageLensGroupResponse response = s3ControlClient.getStorageLensGroup(getRequest);
            System.out.println(response);
        } 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();
        }
    }
}
```

以下の例では、アカウント `111122223333` で `Marketing-Department` という名前の Storage Lens グループを更新します。この例では、`.png`、`.gif`、`.jpg`、または `.jpeg` のいずれかのサフィックスに一致するオブジェクトを含むようにダッシュボードスコープを更新します。この例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
import software.amazon.awssdk.services.s3control.model.UpdateStorageLensGroupRequest;

public class UpdateStorageLensGroup {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            // Create updated filter.
            StorageLensGroupFilter suffixFilter = StorageLensGroupFilter.builder()
                    .matchAnySuffix(".png", ".gif", ".jpg", ".jpeg")
                    .build();

            StorageLensGroup storageLensGroup = StorageLensGroup.builder()
                    .name(storageLensGroupName)
                    .filter(suffixFilter)
                    .build();

            UpdateStorageLensGroupRequest updateStorageLensGroupRequest = UpdateStorageLensGroupRequest.builder()
                    .name(storageLensGroupName)
                    .storageLensGroup(storageLensGroup)
                    .accountId(accountId)
                    .build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.updateStorageLensGroup(updateStorageLensGroupRequest);
        } 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();
        }
    }
}
```

JSON 設定例については、「[Storage Lens グループの設定](storage-lens-groups.md#storage-lens-groups-configuration)」を参照してください。

# Storage Lens グループによる AWS リソースタグの管理
<a name="storage-lens-groups-manage-tags"></a>

Amazon S3 ストレージレンズグループはそれぞれ独自の Amazon AWS リソースネーム (ARN) を持つリソースとみなされます。そのため、Storage Lens グループを設定するときに、AWS オプションでグループにリソースタグを追加できます。Storage Lens グループごとに最大 50 個のタグを追加できます。タグ付きの Storage Lens グループを作成するには、`s3:CreateStorageLensGroup` と `s3:TagResource` の権限が必要です。

AWS リソースタグを使用して、部門、事業内容、またはプロジェクトごとにリソースを分類できます。そうすることで、同じ種類のリソースが多い場合に役立ちます。タグを適用すると、割り当てたタグに基づいて特定の Storage Lens グループをすばやく識別できます。また、コストの追跡と割り当てにもタグを使用できます。

さらに、Storage Lens グループに AWS リソースタグを追加すると、[属性ベースのアクセス制御 (ABAC](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html)) が有効になります。ABAC は、このケースタグの属性に基づいて権限を定義する認可戦略です。IAM ポリシーでリソースタグを指定する条件を使用して、[AWS リソースへのアクセス](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources)を制御できます。

タグのキーと値は編集でき、タグはリソースからいつでも削除できます。また、次の点について注意してください:
+ キーとタグの値は大文字と小文字が区別されます。
+ 特定のリソースについて既存のタグと同じキーを持つタグを追加した場合、以前の値は新しい値によって上書きされます。
+ リソースを削除すると、リソースのタグも削除されます。
+ AWS リソースタグにはプライベートデータや機密データを含めないでください。
+ システムタグ (`aws:` で始まるタグキーの場合) はサポートされていません。
+ 各タグキーの長さは 128 文字以下にする必要があります。各タグ値の長さは 256 文字以下にする必要があります。

次の例は、Storage Lens グループで AWS リソースタグを使用する方法を示しています。

**Topics**
+ [

# Storage Lens グループに AWS リソースタグを追加する
](storage-lens-groups-add-tags.md)
+ [

# Storage Lens グループのタグ値の更新
](storage-lens-groups-update-tags.md)
+ [

# Storage Lens グループから AWS リソースタグを削除する
](storage-lens-groups-delete-tags.md)
+ [

# Storage Lens グループのタグの一覧表示
](storage-lens-groups-list-tags.md)

# Storage Lens グループに AWS リソースタグを追加する
<a name="storage-lens-groups-add-tags"></a>

次の例は、Amazon S3 ストレージレンズグループに AWS リソースタグを使用する方法を示しています。Amazon S3 コンソール AWS Command Line Interface (AWS CLI)、および AWS SDK for Java を使用してリソースタグを追加できます。

## S3 コンソールの使用
<a name="storage-lens-groups-add-tags-console"></a>

**Storage Lens グループに AWS リソースタグを追加するには**

1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。

1. ナビゲーションペインで、**[Storage Lens グループ]**を選択します。

1. **[Storage Lens グループ]** で、更新する Storage Lens グループを選択します。

1. **[AWS リソースタグ]** で **[タグを追加]** を選択します。

1. **[タグの追加]** ページで、新しいキーと値のペアを追加します。
**注記**  
既存のタグと同じ新しいタグを追加すると、以前のタグ値は上書きされます。

1. (オプション) 複数の新しいタグを追加するには、**[タグを追加]** を再度選択して新しいエントリを追加し続けます。Storage Lens グループには、最大 50 個の AWS リソースタグを追加できます。

1. (オプション) 新規追加されたエントリを削除する場合は、削除するタグの横にある**[削除]** を選びます。

1. **[Save changes]** (変更の保存) をクリックします。

## の使用AWS CLI
<a name="storage-lens-groups-add-tags-cli"></a>

以下の AWS CLI コマンド例では、`marketing-department` という名前の既存の Storage Lens グループに 2 つのリソースタグを追加しています。このコマンドの例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
aws s3control tag-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/marketing-department \
--region us-east-1 --tags Key=k1,Value=v1 Key=k2,Value=v2
```

## AWS SDK for Java の使用
<a name="storage-lens-groups-add-tags-sdk-java"></a>

以下の AWS SDK for Java 例では、既存の Storage Lens グループに 2 つの AWS リソースタグを追加しています。この例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.Tag;
import software.amazon.awssdk.services.s3control.model.TagResourceRequest;

public class TagResource {
    public static void main(String[] args) {
        String resourceARN = "Resource_ARN";
        String accountId = "111122223333";

        try {
            Tag resourceTag1 = Tag.builder()
                .key("resource-tag-key-1")
                .value("resource-tag-value-1")
                .build();
            Tag resourceTag2 = Tag.builder()
                    .key("resource-tag-key-2")
                    .value("resource-tag-value-2")
                    .build();
            TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
                    .resourceArn(resourceARN)
                    .tags(resourceTag1, resourceTag2)
                    .accountId(accountId)
                    .build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.tagResource(tagResourceRequest);
        } 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();
        }
    }
}
```

# Storage Lens グループのタグ値の更新
<a name="storage-lens-groups-update-tags"></a>

以下の例は、Amazon S3 コンソール、AWS Command Line Interface (AWS CLI)、および AWS SDK for Java を使用して Storage Lens グループを更新する方法を示しています。

## S3 コンソールの使用
<a name="storage-lens-groups-update-tags-console"></a>

**Storage Lens グループの AWS リソースタグを更新するには**

1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。

1. ナビゲーションペインで、**[Storage Lens グループ]**を選択します。

1. **[Storage Lens グループ]** で、更新する Storage Lens グループを選択します。

1. **[AWSリソースタグ]** で、更新するタグを選択します。

1. 更新するキーと値のペアの同じキーを使用して、新しいタグ値を追加します。チェックマークアイコンを選択してタグの値を更新します。
**注記**  
既存のタグと同じ新しいタグを追加すると、以前のタグ値は上書きされます。

1. (オプション) 新しいタグを追加する場合は、**[タグの追加]** を選択して新しいエントリを追加します。**タグの追加** ページが表示されます。

   Storage Lens グループには、最大 50 個の AWS リソースタグを追加できます。新しいタグの追加を完了したら、**[変更の保存]** を選択します。

1. (オプション) 新規追加されたエントリを削除する場合は、削除するタグの横にある**[削除]** を選びます。タグの削除を完了したら、**[タグの保存]** を選択します。

## の使用AWS CLI
<a name="storage-lens-groups-update-tags-cli"></a>

次の AWS CLI コマンド例は、`marketing-department` という名前の Storage Lens グループの 2 つのタグ値を更新します。このコマンドの例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
aws s3control tag-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/marketing-department \
--region us-east-1 --tags Key=k1,Value=v3 Key=k2,Value=v4
```

## AWS SDK for Java の使用
<a name="storage-lens-groups-update-tags-sdk-java"></a>

次の AWS SDK for Java 例では、2 つの Storage Lens グループのタグ値を更新します。この例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.Tag;
import software.amazon.awssdk.services.s3control.model.TagResourceRequest;

public class UpdateTagsForResource {
    public static void main(String[] args) {
        String resourceARN = "Resource_ARN";
        String accountId = "111122223333";

        try {
            Tag updatedResourceTag1 = Tag.builder()
                .key("resource-tag-key-1")
                .value("resource-tag-updated-value-1")
                .build();
            Tag updatedResourceTag2 = Tag.builder()
                    .key("resource-tag-key-2")
                    .value("resource-tag-updated-value-2")
                    .build();
            TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
                    .resourceArn(resourceARN)
                    .tags(updatedResourceTag1, updatedResourceTag2)
                    .accountId(accountId)
                    .build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.tagResource(tagResourceRequest);
        } 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();
        }
    }
}
```

# Storage Lens グループから AWS リソースタグを削除する
<a name="storage-lens-groups-delete-tags"></a>

次の例は、Storage Lens グループから AWS リソースタグを削除する方法を示しています。Amazon S3 コンソール AWS Command Line Interface (AWS CLI)、および AWS SDK for Java を使用してタグを削除できます。

## S3 コンソールの使用
<a name="storage-lens-groups-delete-tags-console"></a>

**Storage Lens グループから AWS リソースタグを削除するには**

1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。

1. ナビゲーションペインで、**[Storage Lens グループ]**を選択します。

1. **[Storage Lens グループ]** で、更新する Storage Lens グループを選択します。

1. **[AWSリソースタグ]** で、削除するキーと値のペアを選択します。

1. **[削除]** を選択します。**[AWSリソースタグの削除]** ダイアログボックスが表示されます。
**注記**  
タグを使用してアクセスを制御すると、関連するリソースに影響を与える可能性があります。タグを完全に削除すると、元に戻すことはできません。

1. **[削除]** を選択してキー値のペアを完全に削除します。

## の使用AWS CLI
<a name="storage-lens-groups-delete-tags-cli"></a>

次の AWS CLI コマンドは、既存の Storage Lens グループから 2 つの AWS リソースタグを削除します。このコマンド例を使用するには、`user input placeholders` を独自の情報に置き換えてください。

```
aws s3control untag-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/Marketing-Department \
--region us-east-1 --tag-keys k1 k2
```

## AWS SDK for Java の使用
<a name="storage-lens-groups-delete-tags-sdk-java"></a>

次の AWS SDK for Java 例では、アカウント `111122223333` で指定した Storage Lens グループの Amazon リソースネーム (ARN) から 2 つの AWS リソースタグを削除します。この例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.UntagResourceRequest;

public class UntagResource {
    public static void main(String[] args) {
        String resourceARN = "Resource_ARN";
        String accountId = "111122223333";

        try {
            String tagKey1 = "resource-tag-key-1";
            String tagKey2 = "resource-tag-key-2";
            UntagResourceRequest untagResourceRequest = UntagResourceRequest.builder()
                    .resourceArn(resourceARN)
                    .tagKeys(tagKey1, tagKey2)
                    .accountId(accountId)
                    .build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.untagResource(untagResourceRequest);
        } 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();
        }
    }
}
```

# Storage Lens グループのタグの一覧表示
<a name="storage-lens-groups-list-tags"></a>

以下の例は、Storage Lens グループに関連付けられている AWS リソースタグを一覧表示する方法を示しています。Amazon S3 コンソール AWS Command Line Interface (AWS CLI)、および AWS SDK for Java を使用してタグを一覧表示できます。

## S3 コンソールの使用
<a name="storage-lens-groups-list-tags-console"></a>

**Storage Lens グループのタグとタグ値のリストを確認するには**

1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。

1. ナビゲーションペインで、**[Storage Lens グループ]**を選択します。

1. **[Storage Lens グループ]** で、対象となる Storage Lens グループを選択します。

1. **[AWS リソースタグ]** セクションまでスクロールダウンします。Storage Lens グループに追加されたすべてのユーザー定義 AWS リソースタグが、そのタグ値とともに一覧表示されます。

## の使用AWS CLI
<a name="storage-lens-group-list-tags-cli"></a>

次の AWS CLI コマンド例では、`marketing-department` という名前の Storage Lens グループの Storage Lens グループタグすべてを一覧表示しています。このコマンドの例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
aws s3control list-tags-for-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/marketing-department \
--region us-east-1
```

## AWS SDK for Java の使用
<a name="storage-lens-group-list-tags-sdk-java"></a>

次の AWS SDK for Java 例では、指定した Storage Lens グループ Amazon リソースネーム (ARN) のStorage Lens グループタグ値を一覧表示しています。この例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.ListTagsForResourceRequest;
import software.amazon.awssdk.services.s3control.model.ListTagsForResourceResponse;

public class ListTagsForResource {
    public static void main(String[] args) {
        String resourceARN = "Resource_ARN";
        String accountId = "111122223333";

        try {
            ListTagsForResourceRequest listTagsForResourceRequest = ListTagsForResourceRequest.builder()
                    .resourceArn(resourceARN)
                    .accountId(accountId)
                    .build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            ListTagsForResourceResponse response = s3ControlClient.listTagsForResource(listTagsForResourceRequest);
            System.out.println(response);
        } 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();
        }
    }
}
```

# すべての Storage Lens グループの一覧表示
<a name="storage-lens-groups-list"></a>

以下の例は、AWS アカウント およびホームリージョン内のすべての Amazon S3 ストレージレンズグループを一覧表示する方法を示しています。これらの例は、Amazon S3 コンソール AWS Command Line Interface (AWS CLI)、および AWS SDK for Java を使用してすべての Storage Lens グループを一覧表示する方法を示しています。

## S3 コンソールの使用
<a name="storage-lens-group-list-console"></a>

**アカウントとホームリージョンのすべての Amazon S3 ストレージレンズグループを一覧表示するには**

1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。

1. ナビゲーションペインで、**[Storage Lens グループ]** を選択します。

1. **Storage Lens グループには**、アカウント内の Storage Lens グループのリストが表示されます。

## の使用AWS CLI
<a name="storage-lens-groups-list-cli"></a>

次の AWS CLI 例では、アカウントのすべての Storage Lens グループを一覧表示しています。このコマンド例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
aws s3control list-storage-lens-groups --account-id 111122223333 \
--region us-east-1
```

## AWS SDK for Java の使用
<a name="storage-lens-groups-list-sdk-java"></a>

次の AWS SDK for Java 例では、アカウント `111122223333` の Storage Lens グループを一覧表示しています。この例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.ListStorageLensGroupsRequest;
import software.amazon.awssdk.services.s3control.model.ListStorageLensGroupsResponse;

public class ListStorageLensGroups {
    public static void main(String[] args) {
        String accountId = "111122223333";

        try {
            ListStorageLensGroupsRequest listStorageLensGroupsRequest = ListStorageLensGroupsRequest.builder()
                    .accountId(accountId)
                    .build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            ListStorageLensGroupsResponse response = s3ControlClient.listStorageLensGroups(listStorageLensGroupsRequest);
            System.out.println(response);
        } 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();
        }
    }
}
```

# Storage Lens グループ詳細の表示
<a name="storage-lens-groups-view"></a>

以下の例は、Amazon S3 ストレージレンズグループ設定の詳細を表示する方法を示しています。Amazon S3 コンソール、AWS Command Line Interface (AWS CLI)、および AWS SDK for Java を使用してこれらの詳細を表示できます。

## S3 コンソールの使用
<a name="view-storage-lens-group-console"></a>



**Storage Lens グループ設定の詳細を表示するには**

1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。

1. ナビゲーションペインで、**[Storage Lens グループ]**を選択します。

1. **[Storage Lens グループ]** で、対象となる Storage Lens グループの横にあるオプションボタンを選択します。

1. **[詳細を表示]** を選択します。これで、Storage Lens グループの詳細を確認できます。

## の使用AWS CLI
<a name="view-storage-lens-group-cli"></a>

次の AWS CLI 例では、Storage Lens グループの設定の詳細を返します。このコマンド例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
aws s3control get-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --name marketing-department
```

## AWS SDK for Java の使用
<a name="view-storage-lens-group-sdk-java"></a>

以下の AWS SDK for Java 例では、アカウント `111122223333` の `Marketing-Department` という Storage Lens グループの設定の詳細を返します。この例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupResponse;

public class GetStorageLensGroup {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            GetStorageLensGroupRequest getRequest = GetStorageLensGroupRequest.builder()
                    .name(storageLensGroupName)
                    .accountId(accountId).build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            GetStorageLensGroupResponse response = s3ControlClient.getStorageLensGroup(getRequest);
            System.out.println(response);
        } 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();
        }
    }
}
```

# Storage Lens グループの削除
<a name="storage-lens-groups-delete"></a>

以下の例は、Amazon S3 コンソール AWS Command Line Interface (AWS CLI)、および AWS SDK for Java を使用して Amazon S3 ストレージレンズグループを削除する方法を示しています。

## S3 コンソールの使用
<a name="delete-storage-lens-group-console"></a>

**Storage Lens グループを削除するには**

1. AWS マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。

1. ナビゲーションペインで、**[Storage Lens グループ]** を選択します。

1. **[Storage Lens グループ]** で、削除する Storage Lens グループの横にあるオプションボタンを選択します。

1. **[削除]** を選択します。**[Storage Lens グループの削除]** ダイアログボックスが表示されます。

1. もう一度 **[削除]** を選択すると、Storage Lens グループが完全に削除されます。
**注記**  
Storage Lens グループを削除すると、復元することはできません。

## の使用AWS CLI
<a name="delete-storage-lens-group-cli"></a>

以下の AWS CLI 例は、`marketing-department` という名前の Storage Lens グループを削除します。このコマンド例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
aws s3control delete-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --name marketing-department
```

## AWS SDK for Java の使用
<a name="delete-storage-lens-group-sdk-java"></a>

以下の AWS SDK for Java 例は、アカウント `111122223333` で `Marketing-Department` という名前の Storage Lens グループを削除します。この例を実行するには、`user input placeholders` をユーザー自身の情報に置き換えます。

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.DeleteStorageLensGroupRequest;

public class DeleteStorageLensGroup {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            DeleteStorageLensGroupRequest deleteStorageLensGroupRequest = DeleteStorageLensGroupRequest.builder()
                    .name(storageLensGroupName)
                    .accountId(accountId).build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.deleteStorageLensGroup(deleteStorageLensGroupRequest);
        } 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();
        }
    }
}
```