# S3 Storage Lens 그룹을 사용하여 지표 필터링 및 집계
Amazon S3 Storage Lens 그룹은 객체 메타데이터를 기반으로 사용자 지정 필터를 사용하여 지표를 집계합니다. Storage Lens 그룹을 사용하면 연령별 객체 분포, 가장 일반적인 파일 유형 등과 같은 데이터의 특성을 자세히 살펴볼 수 있습니다. 예를 들어 객체 태그별로 지표를 필터링하여 가장 빠르게 성장하는 데이터 세트를 식별하거나 객체 크기 및 기간을 기준으로 스토리지를 시각화하여 스토리지 아카이브 전략을 수립할 수 있습니다. 따라서 Amazon Storage Lens 그룹은 S3 스토리지를 더 잘 이해하고 최적화하는 데 도움이 됩니다.
Storage Lens 그룹을 사용하면 접두사, 접미사, [객체 태그](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html), 객체 크기 또는 객체 수명과 같은 객체 메타데이터를 사용하여 S3 Storage Lens 지표를 분석하고 필터링할 수 있습니다. 이러한 필터를 조합하여 적용할 수도 있습니다. Storage Lens 그룹을 S3 Storage Lens 대시보드에 연결하면 Amazon S3 Storage Lens 그룹별로 집계된 S3 Storage Lens 지표를 대시보드에서 직접 볼 수 있습니다.
예를 들어, 객체 크기나 사용 기간 범위를 기준으로 지표를 필터링하여 스토리지의 어느 부분이 소형 객체로 구성되어 있는지 확인할 수도 있습니다. 그런 다음 이 정보를 S3 Intelligent-Tiering 또는 S3 Lifecycle과 함께 사용하여 비용 및 스토리지 최적화를 위해 소형 객체를 다른 스토리지 클래스로 전환할 수 있습니다.
**Topics**
+ [S3 스토리지 렌즈 그룹 작동 방식](storage-lens-groups.md)
+ [Storage Lens 그룹 사용](storage-lens-group-tasks.md)
# S3 스토리지 렌즈 그룹 작동 방식
Storage Lens 그룹을 사용하면 객체 메타데이터를 기반으로 하는 사용자 지정 필터를 사용하여 지표를 집계할 수 있습니다. 사용자 지정 필터를 정의할 때 접두사, 접미사, 객체 태그, 객체 크기, 객체 수명 또는 이러한 사용자 지정 필터의 조합을 사용할 수 있습니다. Storage Lens 그룹을 만들 때 단일 필터 또는 여러 필터 조건을 포함할 수도 있습니다. 필터 조건을 여러 개 지정하려면 `And` 또는 `Or` 논리 연산자를 사용합니다.
Storage Lens 그룹을 만들고 구성하면 Storage Lens 그룹 자체가 그룹을 연결하는 대시보드에서 사용자 지정 필터 역할을 합니다. 그런 다음 대시보드에서 Storage Lens 그룹 필터를 사용하여 그룹에서 정의한 사용자 지정 필터를 기반으로 스토리지 지표를 가져올 수 있습니다.
S3 Storage Lens 대시보드에서 Storage Lens 그룹의 데이터를 보려면 그룹을 만든 후 그룹을 대시보드에 연결해야 합니다. Storage Lens 그룹이 Storage Lens 대시보드에 연결되면 대시보드는 48시간 이내에 스토리지 사용 지표를 수집합니다. 그런 다음 Storage Lens 대시보드에서 이 데이터를 시각화하거나 지표 내보내기를 통해 내보낼 수 있습니다. Storage Lens 그룹을 대시보드에 연결하는 것을 잊어버리면 Storage Lens 그룹 데이터가 캡처되거나 표시되지 않습니다.
**참고**
S3 Storage Lens 그룹을 만들면 AWS 리소스가 생성됩니다. 따라서 각 Storage Lens 그룹에는 고유한 Amazon 리소스 이름(ARN)이 있으며, [이를 S3 Storage Lens 대시보드에 연결하거나 S3 Storage Lens 대시보드에서 제외](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html)할 때 지정할 수 있습니다.
Storage Lens 그룹이 대시보드에 연결되어 있지 않은 경우 Storage Lens 그룹을 만드는 데 추가 요금이 발생하지 않습니다.
S3 Storage Lens는 일치하는 모든 Storage Lens 그룹에 속한 객체의 사용량 지표를 집계합니다. 따라서 객체가 두 개 이상의 Storage Lens 그룹에 대한 필터 조건과 일치하면 스토리지 사용량 전체에서 동일한 객체에 대한 반복 횟수가 표시됩니다.
지원되는 AWS 리전 목록에서 지정된 홈 리전의 계정 수준에서 Storage Lens 그룹을 만들 수 있습니다. 그런 다음 대시보드가 동일한 AWS 계정 및 홈 리전에 있는 한 Storage Lens 그룹을 여러 Storage Lens 대시보드에 연결할 수 있습니다. 각 AWS 계정에서 홈 리전마다 최대 50개의 Storage Lens 그룹을 만들 수 있습니다.
Amazon S3 콘솔, AWS Command Line Interface(AWS CLI), AWS SDK 또는 Amazon S3 REST API를 사용하여 S3 스토리지 렌즈 그룹을 만들고 관리할 수 있습니다.
**Topics**
+ [Storage Lens 그룹 집계 지표 보기](#storage-lens-group-aggregation)
+ [스토리지 렌즈 그룹 권한](#storage-lens-group-permissions)
+ [Storage Lens 그룹 구성](#storage-lens-groups-configuration)
+ [AWS 리소스 태그](#storage-lens-group-resource-tags)
+ [Storage Lens 그룹 지표 내보내기](#storage-lens-groups-metrics-export)
## Storage Lens 그룹 집계 지표 보기
Storage Lens 그룹을 대시보드에 연결하여 Storage Lens 그룹의 집계된 지표를 볼 수 있습니다. 연결하려는 Storage Lens 그룹은 대시보드 계정의 지정된 홈 리전 내에 있어야 합니다.
Storage Lens 그룹을 대시보드에 연결하려면 대시보드 구성의 **Storage Lens 그룹 집계** 섹션에서 그룹을 지정해야 합니다. Storage Lens 그룹이 여러 개 있는 경우 **Storage Lens 그룹 집계** 결과를 필터링하여 원하는 그룹만 포함하거나 제외할 수 있습니다. 대시보드에 그룹을 연결하는 방법에 대한 자세한 내용은 [대시보드에 S3 Storage Lens 그룹 연결 또는 제거](storage-lens-groups-dashboard-console.md)를 참조하십시오.
그룹을 연결하면 48시간 이내에 대시보드에 추가 Storage Lens 그룹 집계 데이터가 표시됩니다.
**참고**
Storage Lens 그룹의 집계된 지표를 보려면 그룹을 S3 Storage Lens 대시보드에 연결해야 합니다.
## 스토리지 렌즈 그룹 권한
스토리지 렌즈 그룹을 사용하려면 S3 스토리지 렌즈 그룹 작업에 액세스할 수 있도록 AWS Identity and Access Management(IAM)에 특정 권한이 있어야 합니다. 이러한 권한을 부여하려면 자격 증명 기반 IAM 정책을 사용할 수 있습니다. 이 정책을 IAM 사용자, 그룹 또는 역할에 연결하여 권한을 부여할 수 있습니다. 이러한 권한에는 Storage Lens 그룹을 만들거나 삭제하고, 구성을 보거나, 태그를 관리하는 기능이 포함될 수 있습니다.
권한을 부여하는 IAM 사용자 또는 역할은 Storage Lens 그룹을 만들거나 소유한 계정에 속해야 합니다.
Storage Lens 그룹을 사용하고 Storage Lens 그룹 지표를 보려면 먼저 S3 Storage Lens를 사용할 수 있는 적절한 권한이 있어야 합니다. 자세한 내용은 [Amazon S3 Storage Lens 권한 설정](storage_lens_iam_permissions.md) 섹션을 참조하십시오.
S3 Storage Lens 그룹을 만들고 관리하려면 수행하려는 작업에 따라 다음과 같은 IAM 권한이 있어야 합니다.
| 작업 | IAM 권한 |
| --- | --- |
| 새 Storage Lens 그룹 만들기 | `s3:CreateStorageLensGroup` |
| 태그를 사용하여 새 Storage Lens 그룹 만들기 | `s3:CreateStorageLensGroup`, `s3:TagResource` |
| 기존 Storage Lens 그룹 업데이트 | `s3:UpdateStorageLensGroup` |
| Storage Lens 그룹 구성의 세부 정보 반환 | `s3:GetStorageLensGroup` |
| 홈 리전의 모든 Storage Lens 그룹 나열 | `s3:ListStorageLensGroups` |
| Storage Lens 그룹 삭제 | `s3:DeleteStorageLensGroup` |
| Storage Lens 그룹에 추가된 태그 나열 | `s3:ListTagsForResource` |
| 기존 Storage Lens 그룹의 Storage Lens 그룹 태그 추가 또는 업데이트 | `s3:TagResource` |
| Storage Lens 그룹에서 태그 삭제 | `s3:UntagResource` |
다음은 Storage Lens 그룹을 만드는 계정에서 IAM 정책을 구성하는 방법의 예입니다. 이 정책을 사용하려면 `us-east-1`을 Storage Lens 그룹이 위치한 홈 리전으로 바꾸십시오. `111122223333`을 AWS 계정 ID로 바꾸고 `example-storage-lens-group`을 Storage Lens 그룹의 이름으로 바꾸십시오. 이러한 권한을 모든 Storage Lens 그룹에 적용하려면 `example-storage-lens-group`을 `*`로 바꾸십시오.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "EXAMPLE-Statement-ID",
"Effect": "Allow",
"Action": [
"s3:CreateStorageLensGroup",
"s3:UpdateStorageLensGroup",
"s3:GetStorageLensGroup",
"s3:ListStorageLensGroups",
"s3:DeleteStorageLensGroup,
"s3:TagResource",
"s3:UntagResource",
"s3:ListTagsForResource"
],
"Resource": "arn:aws:s3:us-east-1:111122223333:storage-lens-group/example-storage-lens-group"
}
]
}
```
S3 스토리지 렌즈 권한에 대한 자세한 내용은 [Amazon S3 Storage Lens 권한 설정](storage_lens_iam_permissions.md) 섹션을 참조하십시오. IAM 정책 언어에 대한 자세한 내용은 [Amazon S3의 정책 및 권한](access-policy-language-overview.md)를 참조하십시오.
## Storage Lens 그룹 구성
### S3 Storage Lens 그룹 이름
대시보드에 연결할 그룹을 쉽게 결정할 수 있도록 Storage Lens 그룹에 용도를 나타내는 이름을 지정하는 것이 좋습니다. [Storage Lens 그룹을 대시보드에 연결](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html)하려면 대시보드 구성의 **Storage Lens 그룹 집계** 섹션에서 그룹을 지정해야 합니다.
스토리지 렌즈 그룹 이름은 계정 내에서 고유해야 합니다. 64자를 넘지 않아야 하며, 문자(a\$1z, A\$1Z), 숫자(0\$19), 하이픈(`-`) 및 밑줄(`_`)만 포함할 수 있습니다.
### 홈 리전
홈 리전은 Storage Lens 그룹이 만들어지고 유지되는 AWS 리전입니다. Storage Lens 그룹은 Amazon S3 Storage Lens 대시보드와 동일한 홈 리전에 만들어집니다. Storage Lens 그룹 구성 및 지표도 이 리전에 저장됩니다. 홈 리전에 최대 50개의 Storage Lens 그룹을 만들 수 있습니다.
Storage Lens 그룹을 만든 후에는 홈 리전을 편집할 수 없습니다.
### 범위
Storage Lens 그룹에 객체를 포함하려면 해당 객체가 Amazon S3 Storage Lens 대시보드의 범위 내에 있어야 합니다. Storage Lens 대시보드의 범위는 S3 Storage Lens 대시보드 구성의 **대시보드 범위**에 포함한 버킷에 따라 결정됩니다.
객체에 다양한 필터를 사용하여 Storage Lens 그룹의 범위를 정의할 수 있습니다. S3 Storage Lens 대시보드에서 이러한 Storage Lens 그룹 지표를 보려면 객체가 Storage Lens 그룹에 포함된 필터와 일치해야 합니다. 예를 들어 Storage Lens 그룹에 접두사 `marketing`과 접미사 `.png`가 있는 객체가 포함되어 있지만 해당 기준과 일치하는 객체가 없다고 가정해 보겠습니다. 이 경우 이 Storage Lens 그룹의 지표는 일일 지표 내보내기에서 생성되지 않으며 이 그룹의 지표는 대시보드에 표시되지 않습니다.
### 필터
S3 Storage Lens 그룹에서는 다음 필터를 사용할 수 있습니다.
+ **접두사** - 포함된 객체의 [접두사](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html)를 지정합니다. 접두사는 객체 키 이름의 시작 부분에 있는 문자열입니다. 예를 들어, **접두사** 필터의 `images` 값에는 `images/`, `images-marketing` 및 `images/production` 접두사 중 하나가 있는 객체가 포함됩니다. 접두사의 최대 길이는 1,024바이트입니다.
+ **접미사** - 포함된 객체의 접미사(예: `.png`, `.jpeg` 또는 `.csv`)를 지정합니다. 접미사의 최대 길이는 1,024바이트입니다.
+ **객체 태그** - 필터링 기준으로 사용할 [객체 태그](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html) 목록을 지정합니다. 태그 키는 유니코드 128자를 초과할 수 없으며 태그 값은 유니코드 256자를 초과할 수 없습니다. 객체 태그 값 필드를 비워 두면 S3 Storage Lens 그룹은 객체를 태그 값이 비어 있는 다른 객체하고만 매칭한다는 점에 유의하세요.
+ **수명** - 포함된 객체의 객체 연령 범위를 일 단위로 지정합니다. 정수만 지원됩니다.
+ **크기** - 포함된 객체의 객체 크기 범위를 바이트 단위로 지정합니다. 정수만 지원됩니다. 허용되는 최대값은 50TB입니다.
### Storage Lens 그룹 객체 태그
최대 10개의 객체 태그 필터를 포함하는 [Storage Lens 그룹을 만들](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-create.html) 수 있습니다. 다음 예제는 `Marketing-Department`라는 이름의 Storage Lens 그룹에 대한 필터로 두 개의 객체 태그 키-값 페어를 포함합니다. 이 예제를 사용하려면 `Marketing-Department`를 그룹 이름으로 바꾸고, `object-tag-key-1`, `object-tag-value-1` 등을 필터링하려는 객체 태그 키-값 페어로 바꿉니다.
```
{
"Name": "Marketing-Department",
"Filter": {
"MatchAnyTag":[
{
"Key": "object-tag-key-1",
"Value": "object-tag-value-1"
},
{
"Key": "object-tag-key-2",
"Value": "object-tag-value-2"
}
]
}
}
```
### 논리 연산자(`And` 또는 `Or`)
Storage Lens 그룹에 여러 필터 조건을 포함하려면 논리 연산자(`And`또는`Or`)를 사용할 수 있습니다. 다음 예제에서 `Marketing-Department`라는 이름의 Storage Lens 그룹에는 `Prefix`, `ObjectAge`, `ObjectSize` 필터를 포함하는 `And` 연산자가 있습니다. `And` 연산자가 사용되므로 이러한 필터 조건을 **모두** 충족하는 객체만 Storage Lens 그룹의 범위에 포함됩니다.
이 예제를 사용하려면 `user input placeholders`를 필터링 기준으로 사용할 값으로 바꾸십시오.
```
{
"Name": "Marketing-Department",
"Filter": {
"And": {
"MatchAnyPrefix": [
"prefix-1",
"prefix-2",
"prefix-3/sub-prefix-1"
],
"MatchObjectAge": {
"DaysGreaterThan": 10,
"DaysLessThan": 60
},
"MatchObjectSize": {
"BytesGreaterThan": 10,
"BytesLessThan": 60
}
}
}
}
```
**참고**
필터의 조건 중 **하나와** 일치하는 객체를 포함하려면 이 예제에서 `And` 논리 연산자를 `Or` 논리 연산자로 바꾸십시오.
## AWS 리소스 태그
각 S3 Storage Lens 그룹은 고유한 Amazon 리소스 이름(ARN)이 있는 AWS 리소스로 간주됩니다. 따라서 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 그룹 지표 내보내기
S3 Storage Lens 그룹 지표는 Storage Lens 그룹이 연결된 대시보드에 대한 [Amazon S3 Storage Lens 지표 내보내기](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_understanding_metrics_export_schema.html)에 포함됩니다. Storage Lens 지표 내보내기 기능에 대한 일반 정보는 [데이터 내보내기를 사용하여 Amazon S3 스토리지 렌즈 지표 보기](storage_lens_view_metrics_export.md)를 참조하십시오.
Storage Lens 그룹의 지표 내보내기에는 Storage Lens 그룹을 연결한 대시보드의 범위 내에 있는 모든 S3 Storage Lens 지표가 포함됩니다. 내보내기에는 Storage Lens 그룹에 대한 추가 지표 데이터도 포함됩니다.
Storage Lens 그룹을 만든 후에는 그룹이 연결된 대시보드의 지표 내보내기를 구성할 때 선택한 버킷으로 매일 지표 내보내기가 전송됩니다. 첫 번째 지표 내보내기를 받는 데 최장 48시간이 걸릴 수 있습니다.
일일 내보내기에서 지표를 생성하려면 객체가 Storage Lens 그룹에 포함하는 필터와 일치해야 합니다. Storage Lens 그룹에 포함한 필터와 일치하는 객체가 없는 경우 지표가 생성되지 않습니다. 하지만 객체가 두 개 이상의 Storage Lens 그룹과 일치하는 경우 해당 객체가 지표 내보내기에 표시될 때 각 그룹별로 별도로 나열됩니다.
대시보드에 대한 지표 내보내기의 `record_type` 열에서 다음 값 중 하나를 찾아 Storage Lens 그룹의 지표를 식별할 수 있습니다.
+ `STORAGE_LENS_GROUP_BUCKET`
+ `STORAGE_LENS_GROUP_ACCOUNT`
`record_value` 열에는 Storage Lens 그룹(예: `arn:aws:s3:us-east-1:111122223333:storage-lens-group/Marketing-Department`)의 리소스 ARN이 표시됩니다.
# Storage Lens 그룹 사용
Amazon S3 Storage Lens는 객체 메타데이터를 기반으로 사용자 지정 필터를 사용하여 지표를 집계합니다. 접두사, 접미사, 객체 태그, 객체 크기 또는 객체 수명을 사용하여 S3 Storage Lens 지표를 분석하고 필터링할 수 있습니다. Amazon S3 Storage Lens 3 버킷에서 사용량을 분류할 수도 있습니다. 따라서 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 리소스 태그를 사용하여 부서, 사업부 또는 프로젝트에 따라 리소스를 분류할 수 있습니다. 이는 동일한 유형의 리소스가 많을 때 유용합니다. 태그를 적용하면 지정한 태그를 기반으로 특정 스토리지 렌즈 그룹을 빠르게 식별할 수 있습니다.
또한 스토리지 렌즈 그룹에 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 그룹 연결 또는 제거](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 그룹 만들기
다음 예제는 Amazon S3 콘솔, AWS Command Line Interface(AWS CLI) 및 AWS SDK for Java를 사용하여 Amazon S3 Storage Lens 그룹을 만드는 방법을 보여줍니다.
## S3 콘솔 사용
**Storage Lens 그룹을 만들려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.
1. 페이지 상단의 탐색 모음에서 현재 표시된 AWS 리전의 이름을 선택합니다. 그런 다음 전환하려는 리전을 선택합니다.
1. 왼쪽 탐색 창에서 **스토리지 렌즈 그룹**을 선택합니다.
1. **Storage Lens 그룹 생성**을 선택합니다.
1. **일반**에서 **홈 리전**을 확인하고 **Storage Lens 그룹 이름**을 입력합니다.
1. **범위**에서 Storage Lens 그룹에 적용하려는 필터를 선택합니다. 여러 필터를 적용하려면 필터를 선택한 다음 **AND** 또는 **OR** 논리 연산자를 선택합니다.
+ **접두사** 필터의 경우 **접두사**를 선택하고 접두사 문자열을 입력합니다. 여러 접두사를 추가하려면 **접두사 추가**를 선택합니다. 접두사를 제거하려면 제거할 접두사 옆에 있는 **제거**를 선택합니다.
+ **객체 태그** 필터의 경우 **객체 태그**를 선택하고 객체의 키-값 쌍을 입력합니다. 그런 다음 **태그 추가**를 선택합니다. 태그를 제거하려면 제거하려는 태그 옆에 있는 **제거**를 선택합니다.
+ **접미사** 필터의 경우 **접미사**를 선택하고 접미사 문자열을 입력합니다. 접미사를 여러 개 추가하려면 **접미사 추가**를 선택합니다. 접미사를 제거하려면 제거할 지문 옆에 있는 **제거**를 선택합니다.
+ **연령** 필터의 경우 객체 연령 범위를 일 단위로 지정합니다. **최소 객체 연령 지정**을 선택하고 최소 객체 연령을 입력합니다. 그런 다음 **최대 객체 연령 지정**을 선택하고 최대 객체 수명을 입력합니다.
+ **크기** 필터의 경우 객체 크기 범위와 측정 단위를 지정합니다. **최소 객체 크기 지정**을 선택하고 최소 객체 크기를 입력합니다. **최대 객체 크기 지정**을 선택하고 최대 객체 크기를 입력합니다.
1. (선택 사항) AWS 리소스 태그의 경우 키-값 쌍을 추가한 다음 **태그 추가**를 선택합니다.
1. **Storage Lens 그룹 생성**을 선택합니다.
## AWS CLI 사용
다음 예시 AWS CLI 명령은 스토리지 렌즈 그룹을 생성합니다. 이 예시 명령을 사용하려면 `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 명령은 두 개의 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) 섹션을 참조하십시오.
## Java용 AWS SDK 사용
다음 AWS SDK for Java 예제에서는 Storage Lens 그룹을 생성합니다. 이 예제를 사용하려면 `user input placeholders`를 사용자의 정보로 대체합니다.
**Example - 단일 필터를 사용하여 Storage Lens 그룹 만들기**
다음 예제에서는 `Marketing-Department`라는 이름의 스토리지 렌즈 그룹을 만듭니다. 이 그룹에는 연령 범위를 `30`\$1`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`라는 이름의 스토리지 렌즈 그룹을 만듭니다. 이 그룹은 `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`라는 이름의 스토리지 렌즈 그룹을 만듭니다. 이 그룹은 `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 - 단일 필터와 두 개의 AWS 리소스 태그를 사용하여 Storage Lens 그룹을 만듭니다.**
다음 예제에서는 접미사 필터가 있는 `Marketing-Department`라는 이름의 Storage Lens 그룹을 만듭니다. 또한 이 예제는 Storage Lens 그룹에 두 개의 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 그룹 연결 또는 제거
Amazon S3 Storage Lens의 고급 티어로 업그레이드한 후 [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 콘솔 사용
**Storage Lens 그룹을 Storage Lens 대시보드에 연결하는 방법**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.
1. 왼쪽 탐색 창의 **스토리지 렌즈**에서 **대시보드**를 선택합니다.
1. Storage Lens 그룹을 연결하려는 Storage Lens 대시보드의 옵션 버튼을 선택합니다.
1. **편집**을 선택합니다.
1. **지표 선택(Metrics selection)**에서 **고급 지표 및 권장 사항(Advanced metrics and recommendations)**을 선택합니다.
1. **Storage Lens 그룹 집계**를 선택합니다.
**참고**
기본적으로 **고급 지표**도 선택됩니다. 하지만 Storage Lens 그룹 데이터를 집계하는 데 필요하지 않으므로 이 설정을 선택 취소할 수도 있습니다.
1. **Storage Lens 그룹 집계**까지 아래로 스크롤하여 데이터 집계에 포함하거나 제외하려는 Storage Lens 그룹 또는 그룹을 지정합니다. 다음 필터링 옵션을 사용할 수 있습니다.
+ 특정 Storage Lens 그룹을 포함하려면 **Storage Lens 그룹 포함**을 선택합니다. **포함할 Storage Lens 그룹**에서 Storage Lens 그룹을 선택합니다.
+ 모든 Storage Lens 그룹을 포함하려면 **이 계정에서 홈 리전의 모든 Storage Lens 그룹 포함**을 선택합니다.
+ 특정 Storage Lens 그룹을 제외하려면 **Storage Lens 그룹 제외**를 선택합니다. **제외할 Storage Lens 그룹**에서 제외하려는 Storage Lens 그룹을 선택합니다.
1. **변경 사항 저장**을 선택합니다. Storage Lens 그룹을 올바르게 구성한 경우 48시간 내에 대시보드에 추가 Storage Lens 그룹 집계 데이터가 표시됩니다.
**S3 Storage Lens 대시보드에서 Storage Lens 그룹을 제거하려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.
1. 왼쪽 탐색 창의 **스토리지 렌즈**에서 **대시보드**를 선택합니다.
1. Storage Lens 그룹을 제거하려는 Storage Lens 대시보드의 옵션 버튼을 선택합니다.
1. **대시보드 구성 보기**를 선택합니다.
1. **편집**을 선택합니다.
1. 아래로 스크롤하여 **지표 선택** 섹션을 찾습니다.
1. **Storage Lens 그룹 집계**에서 제거하려는 Storage Lens 그룹 옆의 **X**를 선택합니다. 그러면 Storage Lens 그룹이 제거됩니다.
대시보드에 모든 Storage Lens 그룹을 포함한 경우 **이 계정에 홈 리전의 모든 Storage Lens 그룹 포함** 옆의 확인란을 선택 취소하십시오.
1. **변경 사항 저장**을 선택합니다.
**참고**
대시보드에 구성 업데이트가 반영되는 데 최장 48시간이 걸립니다.
## Java용 AWS SDK 사용
**Example - 모든 Storage Lens 그룹을 대시보드에 연결**
다음 Java용 SDK 예제는 계정 *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개의 Storage Lens 그룹을 대시보드에 연결**
다음 AWS SDK for Java 예제는 두 개의 Storage Lens 그룹(*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 - 제외 항목 이외의 모든 Storage Lens 그룹 연결**
다음 Java용 SDK 예제는 지정된 두 개의 그룹(*StorageLensGroupName1* and *StorageLensGroupName2*)을 제외한 모든 Storage Lens 그룹을 *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 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 그룹 데이터 시각화하기
[Amazon 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 그룹 데이터가 대시보드에 표시되는 데 최장 48시간이 걸릴 수 있습니다.
대시보드 구성이 업데이트되면 새로 연결된 모든 Storage Lens 그룹이 **Storage Lens 그룹** 탭 아래의 사용 가능한 리소스 목록에 나타납니다. **개요** 탭에서 데이터를 다른 차원으로 분할하여 스토리지 사용량을 더 자세히 분석할 수도 있습니다. 예를 들어 **상위 3개** 범주에 나열된 항목 중 하나를 선택하고 **분석 기준**을 선택하여 데이터를 다른 차원으로 분할할 수 있습니다. 필터 자체와 동일한 차원을 적용할 수는 없습니다.
**참고**
Storage Lens 그룹 필터를 접두사 필터와 함께 적용하거나 그 반대로 적용할 수 없습니다. 또한 프리픽스 필터를 사용하여 Storage Lens 그룹을 더 자세히 분석할 수 없습니다.
Amazon S3 Storage Lens 대시보드의 **Storage Lens 그룹** 탭을 사용하여 대시보드에 연결된 Storage Lens 그룹의 데이터 시각화를 사용자 지정할 수 있습니다. 대시보드에 연결된 일부 Storage Lens 그룹 또는 모든 Storage Lens 그룹의 데이터를 시각화할 수 있습니다.
S3 Storage Lens 대시보드의 Storage Lens 그룹 데이터를 시각화할 때는 다음 사항에 유의하십시오.
+ S3 Storage Lens는 일치하는 모든 Storage Lens 그룹에 속한 객체의 사용량 지표를 집계합니다. 따라서 객체가 두 개 이상의 Storage Lens 그룹에 대한 필터 조건과 일치하면 스토리지 사용량 전체에서 동일한 객체에 대한 반복 횟수가 표시됩니다.
+ 객체는 Storage Lens 그룹에 포함된 필터와 일치해야 합니다. Storage Lens 그룹에 포함한 필터와 일치하는 객체가 없으면 지표가 생성되지 않습니다. 할당되지 않은 객체가 있는지 확인하려면 대시보드의 계정 수준 및 버킷 수준에서 총 객체 수를 확인하십시오.
# Storage Lens 그룹 업데이트
다음 예제에서는 Amazon S3 스토리지 렌즈 그룹을 업데이트하는 방법을 보여줍니다. Amazon S3 콘솔, AWS Command Line Interface(AWS CLI) 및 AWS SDK for Java을 사용하여 Storage Lens 그룹을 업데이트할 수 있습니다.
## S3 콘솔 사용
**Storage Lens 그룹을 업데이트하려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **스토리지 렌즈 그룹**을 선택합니다.
1. **스토리지 렌즈 그룹**에서 업데이트하려는 스토리지 렌즈 그룹을 선택합니다.
1. **범위**에서 **편집**을 선택합니다.
1. **범위** 페이지에서 Storage Lens 그룹에 적용하려는 필터를 선택합니다. 여러 필터를 적용하려면 필터를 선택하고 **AND** 또는 **OR** 논리 연산자를 선택합니다.
+ **접두사** 필터의 경우 **접두사**를 선택하고 접두사 문자열을 입력합니다. 여러 접두사를 추가하려면 **접두사 추가**를 선택합니다. 접두사를 제거하려면 제거할 접두사 옆에 있는 **제거**를 선택합니다.
+ **객체 태그** 필터에 객체의 키-값 페어를 입력합니다. 그런 다음 **태그 추가**를 선택합니다. 태그를 제거하려면 제거하려는 태그 옆에 있는 **제거**를 선택합니다.
+ **접미사** 필터의 경우 **접미사**를 선택하고 접미사 문자열을 입력합니다. 접미사를 여러 개 추가하려면 **접미사 추가**를 선택합니다. 접미사를 제거하려면 제거할 지문 옆에 있는 **제거**를 선택합니다.
+ **연령** 필터의 경우 객체 연령 범위를 일 단위로 지정합니다. **최소 객체 연령 지정**을 선택하고 최소 객체 연령을 입력합니다. **최대 객체 연령 지정**에는 최대 객체 연령을 입력합니다.
+ **크기** 필터의 경우 객체 크기 범위와 측정 단위를 지정합니다. **최소 객체 크기 지정**을 선택하고 최소 객체 크기를 입력합니다. **최대 객체 크기 지정**에는 최대 객체 크기를 입력합니다.
1. **변경 사항 저장**을 선택합니다. Storage Lens 그룹에 대한 세부 정보 페이지가 나타납니다.
1. (선택 사항) 새 AWS 리소스 태그를 추가하려면 **AWS 리소스 태그** 섹션으로 스크롤한 다음 **태그 추가**를 선택합니다. **태그 추가** 페이지가 나타납니다.
새 키-값 페어를 추가한 다음 **변경 내용 저장**을 선택합니다. Storage Lens 그룹에 대한 세부 정보 페이지가 나타납니다.
1. (선택 사항) 기존 AWS 리소스 태그를 제거하려면 **AWS 리소스 태그** 섹션으로 스크롤하여 리소스 태그를 선택합니다. 그런 다음 **삭제**를 선택합니다. **AWS 태그 삭제** 대화 상자가 나타납니다.
AWS 리소스 태그를 영구 삭제하려면 **삭제**를 다시 선택합니다.
**참고**
AWS 리소스 태그를 영구 삭제한 후에는 복원할 수 없습니다.
## AWS CLI 사용
다음 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) 섹션을 참조하십시오.
## Java용 AWS SDK 사용
다음 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 리소스 태그 관리
각 Amazon S3 Storage Lens 그룹은 고유한 Amazon 리소스 이름(ARN)을 갖고 있는 AWS 리소스로 계산됩니다. 따라서 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 리소스 태그 추가
다음 예제에서는 Amazon S3 Storage Lens 그룹에 AWS 리소스 태그를 추가하는 방법을 보여줍니다. Amazon S3 콘솔, AWS Command Line Interface(AWS CLI) 및 AWS SDK for Java을 사용하여 리소스 태그를 추가할 수 있습니다.
## S3 콘솔 사용
**Storage Lens 그룹에 AWS 리소스 태그를 추가하려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **스토리지 렌즈 그룹**을 선택합니다.
1. **Storage Lens 그룹**에서 업데이트하려는 Storage Lens 그룹을 선택합니다.
1. **AWS 리소스 태그** 아래에서 **태그 추가**를 선택합니다.
1. **태그 추가** 페이지에서 새 키-값 쌍을 추가합니다.
**참고**
기존 태그와 동일한 키가 있는 새 태그를 추가하면 이전 태그 값을 덮어씁니다.
1. (선택 사항) 새 태그를 두 개 이상 추가하려면 **태그 추가**를 다시 선택하여 새 항목을 계속 추가합니다. Storage Lens 그룹에 최대 50개의 AWS 리소스 태그를 추가할 수 있습니다.
1. (선택 사항) 새로 추가된 항목을 제거하려면 제거하려는 태그 옆의 **제거**를 선택합니다.
1. **변경 사항 저장**을 선택합니다.
## AWS CLI 사용
다음 예제 AWS CLI 명령은 `marketing-department`라는 이름의 기존 Storage Lens 그룹에 두 개의 리소스 태그를 추가합니다. 이 예시 명령을 사용하려면 `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
```
## Java용 AWS SDK 사용
다음 AWS SDK for Java 예제에서는 기존 Storage Lens 그룹에 두 개의 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 그룹 태그 값 업데이트
다음 예제는 Amazon S3 콘솔, AWS Command Line Interface(AWS CLI) 및 AWS SDK for Java을 사용하여 Storage Lens 그룹 태그 값을 업데이트하는 방법을 보여줍니다.
## S3 콘솔 사용
**Storage Lens 그룹의 AWS 리소스 태그를 업데이트하려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **스토리지 렌즈 그룹**을 선택합니다.
1. **Storage Lens 그룹**에서 업데이트하려는 Storage Lens 그룹을 선택합니다.
1. **AWS 리소스** 태그에서 업데이트하려는 태그를 선택합니다.
1. 업데이트하려는 키-값 페어와 동일한 키를 사용하여 새 태그 값을 추가합니다. 확인 표시 아이콘을 선택하여 태그 값을 업데이트합니다.
**참고**
기존 태그와 동일한 키가 있는 새 태그를 추가하면 이전 태그 값을 덮어씁니다.
1. (선택 사항) 새 태그를 추가하려면 **태그 추가**를 선택하여 새 항목을 추가합니다. **태그 추가** 페이지가 나타납니다.
Storage Lens 그룹에 최대 50개의 AWS 리소스 태그를 추가할 수 있습니다. 새 태그 추가가 완료되면 **변경 사항 저장**을 선택합니다.
1. (선택 사항) 새로 추가된 항목을 제거하려면 제거하려는 태그 옆의 **제거**를 선택합니다. 태그 제거를 마쳤으면 **변경 사항 저장**을 선택합니다.
## AWS CLI 사용
다음 예제 AWS CLI 명령은 `marketing-department`라는 이름의 Storage Lens 그룹에 대한 두 개의 태그 값을 업데이트합니다. 이 예시 명령을 사용하려면 `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
```
## Java용 AWS SDK 사용
다음 AWS SDK for Java 예제에서는 두 개의 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 리소스 태그 삭제
다음 예제에서는 Storage Lens 그룹에서 AWS 리소스 태그를 삭제하는 방법을 보여줍니다. Amazon S3 콘솔, AWS Command Line Interface(AWS CLI) 및 AWS SDK for Java를 사용하여 태그를 삭제할 수 있습니다.
## S3 콘솔 사용
**Storage Lens 그룹에서 AWS 리소스 태그를 삭제하려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **스토리지 렌즈 그룹**을 선택합니다.
1. **Storage Lens 그룹**에서 업데이트하려는 Storage Lens 그룹을 선택합니다.
1. **AWS 리소스 태그** 아래에서 삭제하려는 키-값 페어를 선택합니다.
1. **삭제**를 선택합니다. **AWS 리소스 태그 삭제** 대화 상자가 나타납니다.
**참고**
태그를 사용하여 액세스를 제어하는 경우 이 작업을 진행하면 관련 리소스에 영향이 미칠 수 있습니다. 영구 삭제한 태그는 복원할 수 없습니다.
1. **삭제**를 선택하여 키-값 페어를 영구적으로 삭제합니다.
## AWS CLI 사용
다음 AWS CLI 명령은 기존 Storage Lens 그룹에서 두 개의 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
```
## Java용 AWS SDK 사용
다음 AWS SDK for Java 예제에서는 Storage Lens 그룹 Amazon 리소스 이름(ARN)에서 계정 `111122223333`에서 지정한 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 그룹 태그 목록
다음 예는 Storage Lens 그룹과 관련된 AWS 리소스 태그를 나열하는 방법을 보여줍니다. Amazon S3 콘솔, AWS Command Line Interface(AWS CLI) 및 AWS SDK for Java을 사용하여 태그를 나열할 수 있습니다.
## S3 콘솔 사용
**Storage Lens 그룹의 태그 및 태그 값 목록을 검토하려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **스토리지 렌즈 그룹**을 선택합니다.
1. **Storage Lens 그룹**에서 관심 있는 Storage Lens 그룹을 선택합니다.
1. 아래로 스크롤하여 **AWS 리소스 태그** 섹션으로 이동합니다. Storage Lens 그룹에 추가된 모든 사용자 정의 AWS 리소스 태그가 해당 태그 값과 함께 나열됩니다.
## AWS CLI 사용
다음 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
```
## Java용 AWS SDK 사용
다음 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 그룹 목록
다음 예제에서는 AWS 계정 및 홈 리전 내의 모든 Amazon S3 Storage Lens 그룹을 나열하는 방법을 보여줍니다. 이 예제는 Amazon S3 콘솔, AWS Command Line Interface(AWS CLI) 및 AWS SDK for Java를 사용하여 모든 Storage Lens 그룹을 나열하는 방법을 보여줍니다.
## S3 콘솔 사용
**계정 및 홈 리전의 모든 Storage Lens 그룹을 나열하려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **스토리지 렌즈 그룹**을 선택합니다.
1. **Storage Lens 그룹** 아래에 계정의 Storage Lens 그룹 목록이 표시됩니다.
## AWS CLI 사용
다음 AWS CLI 예제는 계정의 모든 Storage Lens 그룹을 나열합니다. 이 예시 명령을 사용하려면 `user input placeholders`를 실제 정보로 대체하십시오.
```
aws s3control list-storage-lens-groups --account-id 111122223333 \
--region us-east-1
```
## Java용 AWS SDK 사용
다음 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 그룹 세부 정보 보기
다음 예제는 Amazon S3 Storage Lens 그룹 구성 세부 정보를 보는 방법을 보여줍니다. Amazon S3 콘솔, AWS Command Line Interface(AWS CLI) 및 AWS SDK for Java를 사용하여 이러한 세부 정보를 볼 수 있습니다.
## S3 콘솔 사용
**Storage Lens 그룹 구성 세부 정보를 보려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **스토리지 렌즈 그룹**을 선택합니다.
1. **스토리지 렌즈 그룹**에서 관심 있는 스토리지 렌즈 그룹 옆의 옵션 버튼을 선택합니다.
1. **세부 정보 보기**를 선택합니다. 이제 Storage Lens 그룹의 세부 정보를 검토합니다.
## AWS CLI 사용
다음 AWS CLI 예제는 Storage Lens 그룹의 구성 세부 정보를 반환합니다. 이 예시 명령을 사용하려면 `user input placeholders`를 실제 정보로 대체하십시오.
```
aws s3control get-storage-lens-group --account-id 111122223333 \
--region us-east-1 --name marketing-department
```
## Java용 AWS SDK 사용
다음 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 그룹 삭제
다음 예제는 Amazon S3 콘솔, AWS Command Line Interface(AWS CLI) 및 AWS SDK for Java을 사용하여 Amazon S3 Storage Lens 그룹을 삭제하는 방법을 보여줍니다.
## S3 콘솔 사용
**Storage Lens 그룹을 삭제하려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **스토리지 렌즈 그룹**을 선택합니다.
1. **Storage Lens 그룹**에서 삭제할 Storage Lens 그룹 옆에 있는 옵션 버튼을 선택합니다.
1. **삭제**를 선택합니다. **Storage Lens 그룹 삭제** 대화 상자가 표시됩니다.
1. Storage Lens 그룹을 영구 삭제하려면 **삭제**를 다시 선택합니다.
**참고**
Storage Lens 그룹을 삭제한 후에는 복원할 수 없습니다.
## AWS CLI 사용
다음 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
```
## Java용 AWS SDK 사용
다음 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();
}
}
}
```