

# 콘솔과 API를 사용하여 Amazon S3 스토리지 렌즈 작업
<a name="S3LensExamples"></a>

Amazon S3 스토리지 렌즈는 객체 스토리지 사용 및 활동에 대한 조직 전반의 가시성을 확보하는 데 사용할 수 있는 클라우드 스토리지 분석 기능입니다. S3 스토리지 렌즈 지표를 사용하여 조직 전반의 스토리지 용량 또는 가장 빠르게 증가하는 버킷과 접두사 등의 요약 인사이트를 생성할 수 있습니다. 또한 S3 스토리지 렌즈 지표를 사용하여 비용 최적화 기회를 식별하고, 데이터 보호 및 보안 모범 사례를 구현하고, 애플리케이션 워크로드의 성능을 개선할 수 있습니다. 예를 들어 S3 수명 주기 규칙이 없는 버킷을 식별하여 7일이 넘게 경과한 미완료 멀티파트 업로드를 만료시킬 수 있습니다. 또한 S3 복제 또는 S3 버전 관리 사용과 같은 데이터 보호 모범 사례를 따르지 않는 버킷을 식별할 수 있습니다. S3 스토리지 렌즈는 또한 지표를 분석해 스토리지 비용을 최적화하고 데이터 보호에 대한 모범 사례를 적용하는 데 사용할 수 있는 상황별 권장 사항을 제공합니다.

S3 스토리지 렌즈는 지표를 집계하고 Amazon S3 콘솔 **버킷** 페이지의 **계정 스냅샷** 섹션에 이 정보를 표시합니다. S3 Storage Lens는 또한 인사이트와 추세를 시각화하고, 이상치에 플래그를 지정하고, 스토리지 비용 최적화와 데이터 보호 모범 사례 적용을 위한 권장 사항을 수신하는 데 사용할 수 있는 대화형 대시보드를 제공합니다. 대시보드에 있는 드릴다운 옵션을 통해 조직, 계정, AWS 리전, 스토리지 클래스, 버킷, 접두사 또는 스토리지 렌즈 그룹 수준에서 인사이트를 생성하거나 시각화할 수 있습니다. CSV 또는 Parquet 형식의 일일 지표 보고서를 범용 S3 버킷으로 보내거나 지표를 AWS 관리형 S3 테이블 버킷으로 직접 내보낼 수도 있습니다.

**참고**  
Storage Lens는 [S3 범용 버킷](UsingBucket.md)에 대한 지표만 집계합니다.

이 섹션에는 S3 스토리지 렌즈 구성을 생성하고 업데이트하고 보는 예제 그리고 해당 기능과 관련된 작업을 수행하는 예제가 포함되어 있습니다. 사용자가AWS Organizations에서 S3 스토리지 렌즈를 사용하는 경우, 이러한 예제에서 해당 사용 사례도 볼 수 있습니다. 예제에서 자리 표시자 값을 바꿉니다.

**Topics**
+ [Amazon S3 Storage Lens 대시보드 만들기](storage_lens_creating_dashboard.md)
+ [Amazon S3 Storage Lens 대시보드 업데이트](storage_lens_editing.md)
+ [Amazon S3 Storage Lens 대시보드 비활성화](storage_lens_disabling.md)
+ [Amazon S3 Storage Lens 대시보드 삭제](storage_lens_deleting.md)
+ [Amazon S3 Storage Lens 대시보드 나열](storage_lens_list_dashboard.md)
+ [Amazon S3 Storage Lens 대시보드 구성 세부 정보 보기](storage_lens_viewing.md)
+ [S3 Storage Lens로 AWS 리소스 태그 관리](storage-lens-groups-manage-tags-dashboard.md)
+ [Amazon S3 스토리지 렌즈 사용을 위한 도우미 파일](S3LensHelperFilesCLI.md)

# Amazon S3 Storage Lens 대시보드 만들기
<a name="storage_lens_creating_dashboard"></a>

AWS Organizations의 조직 또는 계정 내의 특정 AWS 리전이나 버킷으로 범위를 지정할 수 있는 추가 S3 Storage Lens 사용자 지정 대시보드를 만들 수 있습니다.

**참고**  
대시보드 구성을 업데이트하는 경우 올바르게 표시하거나 시각화하는 데 최장 48시간이 걸릴 수 있습니다.

## S3 콘솔 사용
<a name="storage_lens_console_creating"></a>

다음 단계에 따라 Amazon S3 콘솔에서 Amazon S3 스토리지 렌즈 대시보드를 생성합니다.

**1단계: 일반 설정 구성**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.

1. 페이지 상단의 탐색 모음에서 현재 표시된 AWS 리전의 이름을 선택합니다. 그런 다음 전환하려는 리전을 선택합니다.

1. 왼쪽 탐색 창의 **S3 스토리지 렌즈**에서 **대시보드**를 선택합니다.

1. **대시보드 생성**을 선택합니다.

1. **대시보드(Dashboard)** 페이지의 **일반(General)** 섹션에서 다음을 수행합니다.

   1. 대시보드의 **홈 리전**을 확인합니다. 홈 리전은 이 Storage Lens 대시보드에 대한 구성 및 지표가 저장되는 AWS 리전입니다.

   1. 대시보드 이름을 입력합니다.

      대시보드 이름은 65자 미만이어야 하며 특수 문자나 공백을 포함할 수 없습니다.
**참고**  
대시보드를 생성한 후에는 이 대시보드 이름을 변경할 수 없습니다.

   1. 대시보드에 업데이트된 일일 지표를 표시하려면 **활성화됨**을 선택합니다.

   1. (선택 사항) 대시보드에 **태그**를 추가하도록 선택할 수 있습니다. 태그를 사용하여 대시보드에 대한 권한을 관리하고 S3 스토리지 렌즈에 대한 비용을 추적할 수 있습니다. 자세한 내용은 *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가 대시보드에 포함하거나 제외할 리전과 버킷을 선택합니다.

1. S3 스토리지 렌즈에 포함하거나 제외하도록 사용자가 선택한 리전에서 버킷을 선택합니다. 버킷을 포함하거나 제외할 수 있지만, 둘 다 할 수는 없습니다. 조직 수준의 대시보드를 생성할 때는 이 옵션을 사용할 수 없습니다.
**참고**  
리전과 버킷을 포함하거나 제외할 수 있습니다. 이 옵션은 조직의 구성원 계정에서 조직 수준의 대시보드를 생성할 때만 리전으로 제한됩니다.
포함하거나 제외할 버킷을 최대 50개까지 선택할 수 있습니다.

1. **다음**을 선택하여 변경 사항을 저장하고 계속합니다.

**3단계: Storage Lens 티어 선택**

1. **Storage Lens 티어** 섹션에서 이 대시보드에 대해 집계할 기능 티어를 선택합니다.

   1. 버킷 수준에서 집계되고 14일 동안 쿼리에 사용할 수 있는 무료 지표를 포함하려면 **무료 티어**를 선택합니다.

   1. 고급 지표를 활성화하려면 **고급 티어**를 선택합니다. 이러한 옵션에는 접두사 또는 Storage Lens 그룹 집계, Amazon CloudWatch 게시, 확장된 접두사 보고서 및 컨텍스트 권장 사항이 포함됩니다. 데이터는 15개월 동안 쿼리에 사용할 수 있습니다. 고급 지표 및 권장 사항에는 추가 비용이 부과됩니다. 자세한 내용은 [Amazon S3 요금](https://aws.amazon.com/s3/pricing/)을 참조하십시오.

      고급 지표 및 무료 지표에 대한 자세한 내용은 [지표 선택](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection) 섹션을 참조하십시오.

1. **고급 지표 범주**에서 활성화하려는 지표 범주를 선택합니다.
   + **활동 지표**
   + **세부 상태 코드 지표**
   + **비용 최적화 지표**
   + **데이터 보호 지표**
   + **성능 지표**

   각 범주에 포함되는 지표를 미리 보려면 지표 범주 확인란 목록 아래의 드롭다운 화살표 버튼을 사용합니다. 비용 범주에 관한 자세한 내용은 [지표 범주](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_types) 섹션을 참조하십시오. 전체 지표 목록은 [Amazon S3 스토리지 렌즈 지표 용어집](storage_lens_metrics_glossary.md) 섹션을 참조하세요.

1. **접두사 구분 기호**를 선택하거나 지정하여 각 접두사 내의 수준을 구분합니다. 이 값은 각 접두사 수준을 식별하는 데 사용되는 값입니다. Amazon S3의 기본값은 ‘`/`‘ 문자이지만, 사용자 스토리지 구조에서 다른 구분 기호를 사용할 수 있습니다.

1. **다음**을 선택하여 변경 사항을 저장하고 계속합니다.

**4단계: (선택 사항) 지표 집계 선택**

1. **추가 지표 집계**에서 집계할 지표를 선택합니다.
   + 접두사 집계(Prefix aggregation)
   + Storage Lens 그룹 집계

1. **접두사 집계**를 활성화한 경우 대시보드의 최소 **접두사 임계값**과 **접두사 깊이**를 지정합니다. 그런 뒤에 **다음**을 선택하여 저장하고 계속합니다.
**참고**  
**접두사 깊이** 설정은 심층 S3 Storage Lens가 객체 접두사를 분석할 계층 수준 수를 결정하며, 최대 제한은 10개 수준입니다. **접두사 임계값**은 접두사가 Storage Lens 지표에 포함되기 전에 표시해야 하는 총 스토리지의 최소 백분율을 지정합니다.

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. (선택 사항) **기본 지표 보고서**를 선택한 경우 **기본 지표 보고서** 설정에서 버킷 유형을 선택합니다. 보고서를 범용 Amazon S3 버킷 또는 AWS 관리형 S3 테이블 버킷으로 내보낼 수 있습니다. 선택한 버킷 유형에 따라 **범용 버킷 대상 설정** 또는 **테이블 버킷 대상 설정** 옵션을 업데이트합니다.
**참고**  
**기본 지표 보고서**에는 접두사 집계 설정에서 설정된 임계값 및 깊이 내에 있는 접두사만 포함됩니다.  
암호화 키 지정을 선택한 경우, AWS KMS 키(SSE-KMS) 또는 Amazon S3 관리형 키(SSE-S3) 중 하나를 선택해야 합니다. 대상 버킷 정책에 암호화가 필요한 경우 지표 내보내기를 위한 암호화 키를 제공해야 합니다. 암호화 키가 없으면 S3로 내보내기가 실패합니다. 자세한 내용은 [AWS KMS key를 사용하여 지표 내보내기 암호화](storage_lens_encrypt_permissions.md) 섹션을 참조하세요.

1. (선택 사항) **확장된 접두사 지표 보고서**를 선택한 경우 **확장된 접두사 지표 보고서** 설정에서 버킷 유형을 선택합니다. 보고서를 범용 Amazon S3 버킷 또는 읽기 전용 S3 테이블 버킷으로 내보낼 수 있습니다. 선택한 버킷 유형에 따라 **범용 버킷 대상 설정** 또는 **테이블 버킷 대상 설정**을 업데이트합니다.
**참고**  
**확장된 접두사 지표 보고서**에는 대시보드 범위에 지정된 선택한 모든 버킷의 접두사 깊이 50까지의 모든 접두사가 포함됩니다.  
암호화 키 지정을 선택한 경우, AWS KMS 키(SSE-KMS) 또는 Amazon S3 관리형 키(SSE-S3) 중 하나를 선택해야 합니다. 대상 버킷 정책에 암호화가 필요한 경우 지표 내보내기를 위한 암호화 키를 제공해야 합니다. 암호화 키가 없으면 S3로 내보내기가 실패합니다. 자세한 내용은 [AWS KMS key를 사용하여 지표 내보내기 암호화](storage_lens_encrypt_permissions.md) 섹션을 참조하세요.

1. **다음**을 선택하여 변경 사항을 저장하고 계속합니다.

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
```

**Example**  
다음 예제 명령에서는 태그가 없는 Amazon S3 Storage Lens 구성을 만듭니다. 이러한 예제를 사용하려면 `user input placeholders`를 실제 정보로 대체하세요.  

```
aws s3control put-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json
```

## Java용 AWS SDK 사용
<a name="S3CreateandUpdateStorageLensConfigurationJava"></a>

**Example – Amazon S3 Storage Lens 구성 만들기 및 업데이트**  
다음 예제에서는 SDK for Java에서 Amazon S3 Storage Lens 구성을 만들고 업데이트합니다.  

```
package aws.example.s3control;

import software.amazon.awssdk.awscore.exception.AwsServiceException;
import software.amazon.awssdk.core.exception.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.AccountLevel;
import software.amazon.awssdk.services.s3control.model.ActivityMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedCostOptimizationMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedDataProtectionMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedPerformanceMetrics;
import software.amazon.awssdk.services.s3control.model.BucketLevel;
import software.amazon.awssdk.services.s3control.model.CloudWatchMetrics;
import software.amazon.awssdk.services.s3control.model.DetailedStatusCodesMetrics;
import software.amazon.awssdk.services.s3control.model.Format;
import software.amazon.awssdk.services.s3control.model.Include;
import software.amazon.awssdk.services.s3control.model.OutputSchemaVersion;
import software.amazon.awssdk.services.s3control.model.PrefixLevel;
import software.amazon.awssdk.services.s3control.model.PrefixLevelStorageMetrics;
import software.amazon.awssdk.services.s3control.model.PutStorageLensConfigurationRequest;
import software.amazon.awssdk.services.s3control.model.S3BucketDestination;
import software.amazon.awssdk.services.s3control.model.SSES3;
import software.amazon.awssdk.services.s3control.model.SelectionCriteria;
import software.amazon.awssdk.services.s3control.model.StorageLensAwsOrg;
import software.amazon.awssdk.services.s3control.model.StorageLensConfiguration;
import software.amazon.awssdk.services.s3control.model.StorageLensDataExport;
import software.amazon.awssdk.services.s3control.model.StorageLensDataExportEncryption;
import software.amazon.awssdk.services.s3control.model.StorageLensExpandedPrefixesDataExport;
import software.amazon.awssdk.services.s3control.model.StorageLensTableDestination;
import software.amazon.awssdk.services.s3control.model.StorageLensTag;

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

public class CreateAndUpdateDashboard {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        String exportAccountId = "Destination Account ID";
        String exportBucketArn = "arn:aws:s3:::destBucketName"; // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration.
        String awsOrgARN = "arn:aws:organizations::123456789012:organization/o-abcdefgh";
        Format exportFormat = Format.CSV;

        try {
            SelectionCriteria selectionCriteria = SelectionCriteria.builder()
                    .delimiter("/")
                    .maxDepth(5)
                    .minStorageBytesPercentage(10.0)
                    .build();

            PrefixLevelStorageMetrics prefixStorageMetrics = PrefixLevelStorageMetrics.builder()
                    .isEnabled(true)
                    .selectionCriteria(selectionCriteria)
                    .build();

            BucketLevel bucketLevel = BucketLevel.builder()
                    .activityMetrics(ActivityMetrics.builder().isEnabled(true).build())
                    .advancedCostOptimizationMetrics(AdvancedCostOptimizationMetrics.builder().isEnabled(true).build())
                    .advancedDataProtectionMetrics(AdvancedDataProtectionMetrics.builder().isEnabled(true).build())
                    .advancedPerformanceMetrics(AdvancedPerformanceMetrics.builder().isEnabled(true).build())
                    .detailedStatusCodesMetrics(DetailedStatusCodesMetrics.builder().isEnabled(true).build())
                    .prefixLevel(PrefixLevel.builder().storageMetrics(prefixStorageMetrics).build())
                    .build();

            AccountLevel accountLevel = AccountLevel.builder()
                    .activityMetrics(ActivityMetrics.builder().isEnabled(true).build())
                    .advancedCostOptimizationMetrics(AdvancedCostOptimizationMetrics.builder().isEnabled(true).build())
                    .advancedPerformanceMetrics(AdvancedPerformanceMetrics.builder().isEnabled(true).build())
                    .advancedDataProtectionMetrics(AdvancedDataProtectionMetrics.builder().isEnabled(true).build())
                    .detailedStatusCodesMetrics(DetailedStatusCodesMetrics.builder().isEnabled(true).build())
                    .bucketLevel(bucketLevel)
                    .build();

            Include include = Include.builder()
                    .buckets(Arrays.asList("arn:aws:s3:::bucketName"))
                    .regions(Arrays.asList("us-west-2"))
                    .build();

            StorageLensDataExportEncryption exportEncryption = StorageLensDataExportEncryption.builder()
                    .sses3(SSES3.builder().build())
                    .build();

            S3BucketDestination s3BucketDestination = S3BucketDestination.builder()
                    .accountId(exportAccountId)
                    .arn(exportBucketArn)
                    .encryption(exportEncryption)
                    .format(exportFormat)
                    .outputSchemaVersion(OutputSchemaVersion.V_1)
                    .prefix("Prefix")
                    .build();

            StorageLensTableDestination s3TablesDestination = StorageLensTableDestination.builder()
                    .encryption(exportEncryption)
                    .isEnabled(true)
                    .build();

            CloudWatchMetrics cloudWatchMetrics = CloudWatchMetrics.builder()
                    .isEnabled(true)
                    .build();

            StorageLensDataExport dataExport = StorageLensDataExport.builder()
                    .cloudWatchMetrics(cloudWatchMetrics)
                    .s3BucketDestination(s3BucketDestination)
                    .storageLensTableDestination(s3TablesDestination)
                    .build();

            StorageLensAwsOrg awsOrg = StorageLensAwsOrg.builder()
                    .arn(awsOrgARN)
                    .build();

            StorageLensExpandedPrefixesDataExport expandedPrefixesDataExport = StorageLensExpandedPrefixesDataExport.builder()
                    .s3BucketDestination(s3BucketDestination)
                    .storageLensTableDestination(s3TablesDestination)
                    .build();

            StorageLensConfiguration configuration = StorageLensConfiguration.builder()
                    .id(configurationId)
                    .accountLevel(accountLevel)
                    .include(include)
                    .dataExport(dataExport)
                    .awsOrg(awsOrg)
                    .expandedPrefixesDataExport(expandedPrefixesDataExport)
                    .prefixDelimiter("/")
                    .isEnabled(true)
                    .build();

            List<StorageLensTag> tags = Arrays.asList(
                    StorageLensTag.builder().key("key-1").value("value-1").build(),
                    StorageLensTag.builder().key("key-2").value("value-2").build()
            );

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();

            s3ControlClient.putStorageLensConfiguration(PutStorageLensConfigurationRequest.builder()
                    .accountId(sourceAccountId)
                    .configId(configurationId)
                    .storageLensConfiguration(configuration)
                    .tags(tags)
                    .build()
            );

        } catch (AwsServiceException 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 스토리지 렌즈 사용에 대한 자세한 내용은 [S3 Storage Lens 그룹을 사용하여 지표 필터링 및 집계](storage-lens-groups-overview.md) 섹션을 참조하십시오.

# 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 스토리지 렌즈 대시보드를 업데이트하려면 다음 단계를 따르십시오.

**1단계: 대시보드 업데이트 및 일반 설정 구성**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **스토리지 렌즈, Dashboards**(스토리지 렌즈, 대시보드)를 선택합니다.

1. 편집하려는 대시보드를 선택합니다.

1. **대시보드 구성 보기**를 선택합니다.

1. **편집**을 선택합니다. 이제 대시보드 구성을 단계별로 검토할 수 있습니다. 단계를 변경하려면 왼쪽 탐색을 사용하여 단계를 직접 클릭하면 됩니다. 이러한 단계를 업데이트하는 방법에 대한 지침은 다음을 참조하세요.
**참고**  
다음 항목은 변경할 수 없습니다.  
대시보드 이름
홈 리전

1. **대시보드** 페이지의 **일반** 섹션에서 다음을 변경합니다.
   + **활성화됨** 또는 **비활성화됨**을 선택하여 대시보드에서 일일 지표를 수신하는지 여부를 업데이트합니다.
   + (선택 사항) 대시보드에 **태그**를 추가하도록 선택할 수 있습니다. 태그를 사용하여 대시보드에 대한 권한을 관리하고 S3 스토리지 렌즈에 대한 비용을 추적할 수 있습니다. 자세한 내용은 *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 스토리지 렌즈에 포함하거나 제외하도록 사용자가 선택한 리전에서 버킷을 선택합니다. 버킷을 포함하거나 제외할 수 있지만, 둘 다 할 수는 없습니다. 조직 수준의 대시보드를 생성할 때는 이 옵션을 사용할 수 없습니다.
**참고**  
리전과 버킷을 포함하거나 제외할 수 있습니다. 이 옵션은 조직의 구성원 계정에서 조직 수준의 대시보드를 생성할 때만 리전으로 제한됩니다.
포함하거나 제외할 버킷을 최대 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. **고급 지표 범주**에서 활성화하려는 지표 범주를 선택합니다.
   + **활동 지표**
   + **세부 상태 코드 지표**
   + **비용 최적화 지표**
   + **데이터 보호 지표**
   + **성능 지표**

   각 범주에 포함되는 지표를 미리 보려면 지표 범주 확인란 목록 아래의 드롭다운 화살표 버튼을 사용합니다. 비용 범주에 관한 자세한 내용은 [지표 범주](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_types) 섹션을 참조하십시오. 전체 지표 목록은 [Amazon S3 스토리지 렌즈 지표 용어집](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 구성 업데이트**  
다음 예제에서는 SDK for Java에서 고급 지표 및 권장 사항으로 기본 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 스토리지 렌즈 사용에 대한 자세한 내용은 [S3 Storage Lens 그룹을 사용하여 지표 필터링 및 집계](storage-lens-groups-overview.md) 섹션을 참조하십시오.

# Amazon S3 Storage Lens 대시보드 비활성화
<a name="storage_lens_disabling"></a>

Amazon S3 콘솔에서 Amazon S3 Storage Lens 대시보드를 비활성화할 수 있습니다. 대시보드를 비활성화하면 나중에 지표를 생성할 수 없습니다. 다시 활성화하면 쉽게 재시작할 수 있도록 비활성화된 대시보드가 여전히 구성 정보를 보존합니다. 사용 중지된 대시보드는 쿼리에 더 이상 사용할 수 없을 때까지 기록 데이터를 유지합니다.

# S3 콘솔 사용
<a name="storage_lens_console_disabling"></a>

Amazon S3 콘솔에서 Amazon S3 Storage Lens 대시보드를 비활성화하려면 다음 단계를 따르세요.

**Amazon S3 Storage Lens 대시보드를 비활성화하려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **Storage Lens**(스토리지 렌즈), **Dashboards**(대시보드)를 선택합니다.

1. **대시보드(Dashboards)** 목록에서 사용 중지할 대시보드를 선택한 후, 목록 맨 위에서 **사용 중지(Disable)**를 선택합니다.

1. 확인 페이지에서 텍스트 필드에 대시보드 이름을 입력하여 대시보드를 비활성화하겠다고 확인한 후 **확인**을 선택합니다.

# Amazon S3 Storage Lens 대시보드 삭제
<a name="storage_lens_deleting"></a>

기본 대시보드는 삭제할 수 없습니다. 그러나 비활성화는 가능합니다. 생성한 대시보드를 삭제하기 전에 다음을 고려하십시오.
+ 대시보드를 삭제하는 대신, 대시보드를 *사용 중지*하여 나중에 다시 사용 설정하도록 설정할 수 있습니다. 자세한 내용은 [S3 콘솔 사용](storage_lens_console_disabling.md) 섹션을 참조하세요.
+ 대시보드를 삭제하면 대시보드와 연결된 모든 구성 설정이 삭제됩니다.
+ 대시보드를 삭제하면 모든 기록 지표 데이터를 사용할 수 없게 됩니다. 이 기록 데이터는 여전히 15개월 동안 보존됩니다. 이 데이터에 다시 액세스하려면 삭제된 리전과 동일한 홈 리전에서 이름이 같은 대시보드를 생성합니다.

# S3 콘솔 사용
<a name="storage_lens_console_deleting"></a>

Amazon S3 콘솔에서 Amazon S3 Storage Lens 대시보드를 삭제할 수 있습니다. 그러나 대시보드를 삭제하면 나중에 지표를 생성할 수 없습니다.

**Amazon S3 스토리지 렌즈 대시보드 삭제**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **스토리지 렌즈**(스토리지 렌즈), **Dashboards**(대시보드)를 선택합니다.

1. **대시보드(Dashboards)** 목록에서 삭제할 대시보드를 선택한 후, 목록 맨 위에서 **삭제(Delete)**를 선택합니다.

1. **대시보드 삭제** 페이지에서 텍스트 필드에 대시보드 이름을 입력하여 대시보드를 삭제하겠다고 확인합니다. 그 다음 **확인**을 선택합니다.

# AWS CLI 사용
<a name="storage_lens_cli_deleting"></a>

**Example**  
 다음 예제에서는 S3 Storage Lens 구성을 삭제합니다. 이러한 예제를 사용하려면 `user input placeholders`를 실제 정보로 대체하세요.  

```
aws s3control delete-storage-lens-configuration --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id
```

## Java용 AWS SDK 사용
<a name="S3DeleteStorageLensConfigurationJava"></a>

**Example – Amazon S3 Storage Lens 대시보드 구성 삭제**  
다음 예제에서는 SDK for Java를 사용하여 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.DeleteStorageLensConfigurationRequest;

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

public class DeleteDashboard {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.deleteStorageLensConfiguration(new DeleteStorageLensConfigurationRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
            );
        } 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();
        }
    }
}
```

# Amazon S3 Storage Lens 대시보드 나열
<a name="storage_lens_list_dashboard"></a>

 

# S3 콘솔 사용
<a name="storage_lens_console_listing"></a>

**S3 Storage Lens 대시보드를 나열하려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **Storage Lens**로 이동합니다.

1. **대시보드**를 선택합니다. 이제 AWS 계정에서 대시보드를 볼 수 있습니다.

## AWS CLI 사용
<a name="S3ListStorageLensConfigurationsCLI"></a>

**Example**  
다음 예제 명령은 AWS 계정에 있는 S3 Storage Lens 대시보드를 나열합니다. 이러한 예시를 사용하려면 `user input placeholders`를 실제 정보로 대체하십시오.  

```
aws s3control list-storage-lens-configurations --account-id=222222222222 --region=us-east-1 --next-token=abcdefghij1234
```

**Example**  
아래 예제에서는 다음 토큰이 없는 S3 Storage Lens 구성을 나열합니다. 이러한 예제를 사용하려면 `user input placeholders`를 실제 정보로 대체하세요.  

```
aws s3control list-storage-lens-configurations --account-id=222222222222 --region=us-east-1
```

## Java용 AWS SDK 사용
<a name="S3ListStorageLensConfigurationsJava"></a>

**Example – S3 Storage Lens 대시보드 구성 나열**  
다음 예제에서는 SDK for Java에 S3 Storage Lens 구성을 나열하는 방법을 보여줍니다. 이 예제를 사용하려면 `user input placeholders`를 사용자의 정보로 대체합니다." 각 예제 설명에  

```
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.ListStorageLensConfigurationEntry;
import com.amazonaws.services.s3control.model.ListStorageLensConfigurationsRequest;

import java.util.List;

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

public class ListDashboard {

    public static void main(String[] args) {
        String sourceAccountId = "111122223333";
        String nextToken = "nextToken";

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

            final List<ListStorageLensConfigurationEntry> configurations =
                    s3ControlClient.listStorageLensConfigurations(new ListStorageLensConfigurationsRequest()
                            .withAccountId(sourceAccountId)
                            .withNextToken(nextToken)
                    ).getStorageLensConfigurationList();

            System.out.println(configurations.toString());
        } 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();
        }
    }
}
```

# Amazon S3 Storage Lens 대시보드 구성 세부 정보 보기
<a name="storage_lens_viewing"></a>

Amazon S3 콘솔, AWS CLI, SDK for Java에서 Amazon S3 Storage Lens 대시보드를 볼 수 있습니다.

# S3 콘솔 사용
<a name="storage_lens_console_viewing"></a>

**S3 Storage Lens 대시보드 구성 세부 정보를 보려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **Storage Lens**로 이동합니다.

1. **대시보드**를 선택합니다.

1. **대시보드** 목록에서 보고자 하는 대시보드를 클릭합니다. 이제 Storage Lens 대시보드의 세부 정보를 확인합니다.

## AWS CLI 사용
<a name="S3ListStorageLensConfigurationsCLI"></a>

**Example**  
다음 예제에서는 구성 세부 정보를 볼 수 있도록 S3 Storage Lens 구성을 검색합니다. 이러한 예제를 사용하려면 `user input placeholders`를 실제 정보로 대체하세요.  

```
aws s3control get-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1
```

## Java용 AWS SDK 사용
<a name="S3GetStorageLensConfigurationJava"></a>

**Example - S3 Storage Lens 구성 검색 및 보기**  
다음 예제에서는 구성 세부 정보를 볼 수 있도록 SDK for Java에서 S3 Storage Lens 구성을 검색하는 방법을 보여줍니다. 이 예제를 사용하려면 `user input placeholders`를 사용자의 정보로 대체합니다.  

```
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.GetStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.GetStorageLensConfigurationResult;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;

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

public class GetDashboard {

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

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

            final StorageLensConfiguration configuration =
                    s3ControlClient.getStorageLensConfiguration(new GetStorageLensConfigurationRequest()
                            .withAccountId(sourceAccountId)
                            .withConfigId(configurationId)
                    ).getStorageLensConfiguration();

            System.out.println(configuration.toString());
        } 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로 AWS 리소스 태그 관리
<a name="storage-lens-groups-manage-tags-dashboard"></a>

각 Amazon S3 Storage Lens 대시보드는 고유한 Amazon 리소스 이름(ARN)을 갖고 있는 AWS 리소스로 계산됩니다. 따라서 Storage Lens 대시보드를 구성할 때 필요에 따라 대시보드에 AWS 리소스 태그를 추가할 수 있습니다. 각 Storage Lens 대시보드에 최대 50개의 태그를 추가할 수 있습니다. 태그가 있는 Storage Lens 대시보드를 만들려면 다음과 같은 [S3 Storage Lens 권한](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_iam_permissions.html)이 있어야 합니다.
+ `s3:ListStorageLensConfigurations`
+ `s3:GetStorageLensConfiguration`
+ `s3:GetStorageLensConfigurationTagging`
+ `s3:PutStorageLensConfiguration`
+ ` s3:PutStorageLensConfigurationTagging`

AWS 리소스 태그를 사용하여 부서, 사업부 또는 프로젝트에 따라 리소스를 분류할 수 있습니다. 이는 동일한 유형의 리소스가 많을 때 유용합니다. 태그를 적용하면 지정한 태그를 기반으로 특정 S3 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-add-tags.md)
+ [스토리지 렌즈 대시보드의 AWS 리소스 태그 검색](storage-lens-get-tags.md)
+ [Storage Lens 대시보드 태그 업데이트](storage-lens-update-tags.md)
+ [S3 Storage Lens 대시보드에서 AWS 리소스 태그 삭제](storage-lens-dashboard-delete-tags.md)

# Storage Lens 대시보드에 AWS 리소스 태그 추가
<a name="storage-lens-add-tags"></a>

다음 예제에서는 S3 Storage Lens 대시보드에 AWS 리소스 태그를 추가하는 방법을 보여줍니다. Amazon S3 콘솔, AWS Command Line Interface(AWS CLI) 및 AWS SDK for Java을 사용하여 리소스 태그를 추가할 수 있습니다.

## S3 콘솔 사용
<a name="storage-lens-add-tags-console"></a>

**Storage Lens 대시보드에 AWS 리소스 태그를 추가하려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 왼쪽 탐색 패널의 **Storage Lens**로 이동합니다.

1. **대시보드**를 선택합니다.

1. 업데이트하려는 Storage Lens 대시보드의 라디오 버튼을 선택합니다. 그런 다음 **편집(Edit)**을 선택합니다.

1. **일반**에서 **태그 추가**를 선택합니다.

1. **태그 추가** 페이지에서 새 키-값 쌍을 추가합니다.
**참고**  
기존 태그와 동일한 키가 있는 새 태그를 추가하면 이전 태그 값을 덮어씁니다.

1. (선택 사항) 새 태그를 두 개 이상 추가하려면 **태그 추가**를 다시 선택하여 새 항목을 계속 추가합니다. Storage Lens 대시보드에 최대 50개의 AWS 리소스 태그를 추가할 수 있습니다.

1. (선택 사항) 새로 추가된 항목을 제거하려면 제거하려는 태그 옆의 **제거**를 선택합니다.

1. **변경 사항 저장**을 선택합니다.

## AWS CLI 사용
<a name="storage-lens-add-tags-cli"></a>

**Example**  
다음 예제 명령은 S3 Storage Lens 대시보드 구성에 태그를 추가합니다. 이러한 예제를 사용하려면 `user input placeholders`를 실제 정보로 대체하세요.  

```
aws s3control put-storage-lens-configuration-tagging --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id --tags=file://./tags.json
```

## Java용 AWS SDK 사용
<a name="storage-lens-add-tags-sdk-java"></a>

다음 예제에서는 SDK for Java의 Amazon S3 Storage Lens 구성에 태그를 추가합니다. 이 예제를 사용하려면 `user input placeholders`를 사용자의 정보로 대체합니다.

**Example - 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.PutStorageLensConfigurationTaggingRequest;
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 PutDashboardTagging {

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

        try {
            List<StorageLensTag> tags = Arrays.asList(
                    new StorageLensTag().withKey("key-1").withValue("value-1"),
                    new StorageLensTag().withKey("key-2").withValue("value-2")
            );

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

            s3ControlClient.putStorageLensConfigurationTagging(new PutStorageLensConfigurationTaggingRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
                    .withTags(tags)
            );
        } 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();
        }
    }
}
```

# 스토리지 렌즈 대시보드의 AWS 리소스 태그 검색
<a name="storage-lens-get-tags"></a>

다음 예제에서는 S3 Storage Lens 대시보드의 AWS 리소스 태그를 검색하는 방법을 보여줍니다. Amazon S3 콘솔, AWS Command Line Interface(AWS CLI) 및 AWS SDK for Java를 사용하여 리소스 태그를 가져올 수 있습니다.

# S3 콘솔 사용
<a name="storage-lens-get-tags-console"></a>

**Storage Lens 대시보드의 AWS 리소스 태그를 검색하려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **Storage Lens**로 이동합니다.

1. **대시보드**를 선택합니다.

1. 보려는 Storage Lens 대시보드 구성의 라디오 버튼을 선택합니다. 그런 다음 **대시보드 구성 보기**를 선택합니다.

1. **태그**에서 대시보드와 연결된 태그를 검토합니다.

1. (선택 사항) 새 태그를 추가하려면 **편집**을 선택합니다. 그런 다음 **태그 추가**를 선택합니다. **태그 추가** 페이지에서 새 키-값 쌍을 추가합니다.
**참고**  
기존 태그와 동일한 키가 있는 새 태그를 추가하면 이전 태그 값을 덮어씁니다.

1. (선택 사항) 새로 추가된 항목을 제거하려면 제거하려는 태그 옆의 **제거**를 선택합니다.

1. **변경 사항 저장**을 선택합니다.

## AWS CLI 사용
<a name="storage-lens-get-tags-cli"></a>

**Example**  
다음 예제 명령은 S3 Storage Lens 대시보드 구성에 대한 태그를 검색합니다. 이러한 예제를 사용하려면 `user input placeholders`를 실제 정보로 대체하세요.  

```
aws s3control get-storage-lens-configuration-tagging --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id --tags=file://./tags.json
```

## Java용 AWS SDK 사용
<a name="S3GetStorageLensConfigurationTaggingJava"></a>

**Example – S3 Storage Lens 대시보드 구성에 대한 태그 가져오기**  
다음 예제에서는 SDK for Java에서 S3 Storage Lens 대시보드 구성에 대한 태그를 검색하는 방법을 보여줍니다. 이 예제를 사용하려면 `user input placeholders`를 사용자의 정보로 대체합니다.  

```
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.DeleteStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.GetStorageLensConfigurationTaggingRequest;
import com.amazonaws.services.s3control.model.StorageLensTag;

import java.util.List;

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

public class GetDashboardTagging {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            final List<StorageLensTag> s3Tags = s3ControlClient
                    .getStorageLensConfigurationTagging(new GetStorageLensConfigurationTaggingRequest()
                            .withAccountId(sourceAccountId)
                            .withConfigId(configurationId)
                    ).getTags();

            System.out.println(s3Tags.toString());
        } 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-update-tags"></a>

다음 예제는 Amazon S3 콘솔, AWS Command Line Interface(AWS CLI) 및 AWS SDK for Java을 사용하여 Storage Lens 대시보드 태그를 업데이트하는 방법을 보여줍니다.

## S3 콘솔 사용
<a name="storage-lens-dashboard-update-tags-console"></a>

**Storage Lens 대시보드의 AWS 리소스 태그를 업데이트하려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **Storage Lens**로 이동합니다.

1. **대시보드**를 선택합니다.

1. 보려는 Storage Lens 대시보드 구성의 라디오 버튼을 선택합니다. 그런 다음 **대시보드 구성 보기**를 선택합니다.

1. **태그**에서 대시보드와 연결된 태그를 검토합니다.

1. (선택 사항) 새 태그를 추가하려면 **편집**을 선택합니다. 그런 다음 **태그 추가**를 선택합니다. **태그 추가** 페이지에서 새 키-값 쌍을 추가합니다.
**참고**  
기존 태그와 동일한 키가 있는 새 태그를 추가하면 이전 태그 값을 덮어씁니다.

1. (선택 사항) 새로 추가된 항목을 제거하려면 제거하려는 태그 옆의 **제거**를 선택합니다.

1. **변경 사항 저장**을 선택합니다.

## AWS CLI 사용
<a name="storage-lens-dashboard-update-tags-cli"></a>

**Example**  
다음 예제 명령은 기존 Amazon S3 Storage Lens 대시보드 구성에 태그를 추가하거나 교체합니다. 이러한 예제를 사용하려면 `user input placeholders`를 실제 정보로 대체하세요.  

```
aws s3control put-storage-lens-configuration-tagging --account-id=111122223333 --config-id=example-dashboard-configuration-id --region=us-east-1 --config-id=your-configuration-id
```

## Java용 AWS SDK 사용
<a name="storage-lens-dashboard-update-tags-sdk-java"></a>

다음 AWS SDK for Java 예제는 기존 Storage Lens 대시보드의 AWS 리소스 태그를 업데이트합니다. 이 예제를 사용하려면 `user input placeholders`를 사용자의 정보로 대체합니다.

**Example - 기존 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.PutStorageLensConfigurationTaggingRequest;
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 PutDashboardTagging {

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

        try {
            List<StorageLensTag> tags = Arrays.asList(
                    new StorageLensTag().withKey("key-1").withValue("value-1"),
                    new StorageLensTag().withKey("key-2").withValue("value-2")
            );

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

            s3ControlClient.putStorageLensConfigurationTagging(new PutStorageLensConfigurationTaggingRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
                    .withTags(tags)
            );
        } 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 대시보드에서 AWS 리소스 태그 삭제
<a name="storage-lens-dashboard-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 Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **Storage Lens**로 이동합니다.

1. **대시보드**를 선택합니다.

1. 보려는 Storage Lens 대시보드 구성의 라디오 버튼을 선택합니다. 그런 다음 **대시보드 구성 보기**를 선택합니다.

1. **태그**에서 대시보드와 연결된 태그를 검토합니다.

1. 제거할 태그 옆에 있는 **제거**를 선택합니다.

1. **변경 사항 저장**을 선택합니다.

## AWS CLI 사용
<a name="storage-lens-dashboard-delete-tags-cli"></a>

다음 AWS CLI 명령은 기존 Storage Lens 대시보드에서 AWS 리소스 태그를 삭제합니다. 이 예 명령을 사용하려면 `user input placeholders`를 실제 정보로 대체하세요.

**Example**  

```
aws s3control delete-storage-lens-configuration-tagging --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1
```

## Java용 AWS SDK 사용
<a name="storage-lens-dashboard-delete-tags-sdk-java"></a>

다음 AWS SDK for Java 예제에서는 `111122223333` 계정에 지정한 Amazon 리소스 이름(ARN)을 사용하여 Storage Lens 대시보드에서 AWS 리소스 태그를 삭제합니다. 이 예제를 사용하려면 `user input placeholders`를 사용자의 정보로 대체합니다.

**Example - 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.DeleteStorageLensConfigurationTaggingRequest;

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

public class DeleteDashboardTagging {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.deleteStorageLensConfigurationTagging(new DeleteStorageLensConfigurationTaggingRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
            );
        } 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();
        }
    }
}
```

# Amazon S3 스토리지 렌즈 사용을 위한 도우미 파일
<a name="S3LensHelperFilesCLI"></a>

예제에 다음 JSON 파일과 키 입력을 사용하십시오.

## JSON의 S3 스토리지 렌즈 예제 구성
<a name="S3LensHelperFilesSampleConfigurationCLI"></a>

**Example `config.json`**  
`config.json` 파일에는 S3 스토리지 렌즈 조직 수준의 *고급 지표 및 권장 사항* 구성에 대한 세부 정보가 들어 있습니다. 다음 예시를 사용하려면 `user input placeholders`를 실제 정보로 대체하십시오.  
고급 지표 및 권장 사항에 대해서는 추가 요금이 부과됩니다. 자세한 내용은 [고급 지표 및 권장 사항](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_basics_metrics_recommendations.html#storage_lens_basics_metrics_selection)을 참조하십시오.

```
{
  "Id": "SampleS3StorageLensConfiguration", //Use this property to identify your S3 Storage Lens configuration.
  "AwsOrg": { //Use this property when enabling S3 Storage Lens for AWS Organizations.
    "Arn": "arn:aws:organizations::123456789012:organization/o-abcdefgh"
  },
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "DetailedStatusCodesMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
        "IsEnabled":true
      },
      "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
      },
      "AdvancedCostOptimizationMetrics": {
        "IsEnabled":true
      },
      "DetailedStatusCodesMetrics": {
        "IsEnabled":true
      },
      "PrefixLevel":{
        "StorageMetrics":{
          "IsEnabled":true,
          "SelectionCriteria":{
            "MaxDepth":5,
            "MinStorageBytesPercentage":1.25,
            "Delimiter":"/"
          }
        }
      }
    }
  },
  "Exclude": { //Replace with "Include" if you prefer to include Regions.
    "Regions": [
      "eu-west-1"
    ],
    "Buckets": [ //This attribute is not supported for AWS Organizations-level configurations.
      "arn:aws:s3:::amzn-s3-demo-source-bucket"
    ]
  },
  "IsEnabled": true, //Whether the configuration is enabled
  "DataExport": { //Details about the metrics export
    "S3BucketDestination": {
      "OutputSchemaVersion": "V_1",
      "Format": "CSV", //You can add "Parquet" if you prefer.
      "AccountId": "111122223333",
      "Arn": "arn:aws:s3:::
amzn-s3-demo-destination-bucket", // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration. 
      "Prefix": "prefix-for-your-export-destination",
      "Encryption": {
        "SSES3": {}
      }
    },
    "CloudWatchMetrics": {
      "IsEnabled": true
    }
  }
}
```

## JSON의 Storage Lens 그룹을 사용한 S3 Storage Lens 예제 구성
<a name="StorageLensGroupsHelperFilesCLI"></a>

**Example `config.json`**  

`config.json` 파일에는 스토리지 렌즈 그룹을 사용할 때 스토리지 렌즈 구성에 적용하려는 세부 정보가 들어 있습니다. 예제를 사용하려면 `user input placeholders`를 실제 정보로 대체하십시오.

모든 Storage Lens 그룹을 대시보드에 연결하려면 다음 구문으로 Storage Lens 구성을 업데이트하십시오.

```
{
  "Id": "ExampleS3StorageLensConfiguration",
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
      "IsEnabled":true
      },
    "StorageLensGroupLevel": {},
  "IsEnabled": true
}
```

Storage Lens 대시보드 구성(*slg-1* 및 *slg-2*)에 Storage Lens 그룹을 두 개만 포함하려면 다음 구문을 사용하십시오.

```
{
  "Id": "ExampleS3StorageLensConfiguration",
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
      "IsEnabled":true
      },
   "StorageLensGroupLevel": {
        "SelectionCriteria": {
            "Include": [
                "arn:aws:s3:us-east-1:111122223333:storage-lens-group/slg-1",
                "arn:aws:s3:us-east-1:444455556666:storage-lens-group/slg-2"
            ]
    },
  "IsEnabled": true
}
```

특정 Storage Lens 그룹만 대시보드 구성에 연결되지 않도록 제외하려면 다음 구문을 사용하십시오.

```
{
  "Id": "ExampleS3StorageLensConfiguration",
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
      "IsEnabled":true
      },
   "StorageLensGroupLevel": {
        "SelectionCriteria": {
            "Exclude": [
                "arn:aws:s3:us-east-1:111122223333:storage-lens-group/slg-1",
                "arn:aws:s3:us-east-1:444455556666:storage-lens-group/slg-2"
            ]
    },
  "IsEnabled": true
}
```

## JSON의 S3 스토리지 렌즈 예제 태그 구성
<a name="S3LensHelperFilesSampleConfigurationTagsCLI"></a>

**Example `tags.json`**  
`tags.json` 파일에는 S3 스토리지 렌즈 구성에 적용하려는 태그가 들어 있습니다. 이 예제를 사용하려면 `user input placeholders`를 사용자의 정보로 대체합니다.  

```
[
    {
        "Key": "key1",
        "Value": "value1"
    },
    {
        "Key": "key2",
        "Value": "value2"
    }
]
```

## S3 스토리지 렌즈 예제 구성 IAM 권한
<a name="S3LensHelperFilesSampleConfigurationIAMPermissionsCLI"></a>

**Example `permissions.json` - 특정 대시보드 이름**  
이 정책 예시에서는 대시보드 이름이 지정된 S3 스토리지 렌즈 IAM `permissions.json` 파일을 보여줍니다. *`value1`*, `us-east-1`, `your-dashboard-name` 및 `example-account-id`를 실제 값으로 바꾸십시오.    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetStorageLensConfiguration",
                "s3:DeleteStorageLensConfiguration",
                "s3:PutStorageLensConfiguration"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/key1": "value1"
                }
            },
            "Resource": "arn:aws:s3:us-east-1:111122223333:storage-lens/your-dashboard-name"
        }
    ]
}
```

**Example `permissions.json` - 특정 대시보드 이름 없음**  
이 정책 예시에서는 대시보드 이름이 지정되지 않은 S3 스토리지 렌즈 IAM `permissions.json` 파일을 보여줍니다. *`value1`*, `us-east-1` 및 `example-account-id`를 사용자의 값으로 대체합니다.    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetStorageLensConfiguration",
                "s3:DeleteStorageLensConfiguration",
                "s3:PutStorageLensConfiguration"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/key1": "value1"
                }
            },
            "Resource": "arn:aws:s3:us-east-1:111122223333:storage-lens/*"
        }
    ]
}
```