기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 에서 보고서 그룹에 태그 지정 AWS CodeBuild
*태그*는 사용자 또는가 AWS 리소스에 AWS 할당하는 사용자 지정 속성 레이블입니다. 각 AWS 태그에는 두 부분이 있습니다.
+ **태그 키(예: `CostCenter`, `Environment`, `Project` 또는 `Secret`). 태그 키는 대소문자를 구별합니다.
+ **태그 값(예: `111122223333`, `Production` 또는 팀 이름)으로 알려진 선택적 필드. 태그 값을 생략하는 것은 빈 문자열을 사용하는 것과 같습니다. 태그 키처럼 태그 값은 대/소문자를 구별합니다.
태그 키와 태그 값을 합해서 키 값 페어라고 합니다. 보고서 그룹에 포함할 수 있는 태그 수 제한 및 태그 키 및 값에 대한 제한은 [태그](limits.md#tag-limits) 단원을 참조하십시오.
태그는 AWS 리소스를 식별하고 구성하는 데 도움이 됩니다. 많은 AWS 서비스가 태그 지정을 지원하므로 다른 서비스의 리소스에 동일한 태그를 할당하여 리소스가 관련이 있음을 나타낼 수 있습니다. 예를 들어 Amazon S3 버킷에 할당한 것과 동일한 태그를 CodeBuild 보고서 그룹에 할당할 수 있습니다. 태그 사용에 대한 자세한 내용은 [태그 지정 모범 사례](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf) 백서를 참조하십시오.
CodeBuild에서 기본 리소스는 보고서 그룹 및 프로젝트입니다. CodeBuild 콘솔, AWS CLI, CodeBuild APIs 또는 AWS SDKs 사용하여 보고서 그룹의 태그를 추가, 관리 및 제거할 수 있습니다. 태그로 보고서 그룹을 식별, 구성 및 추적하는 것 외에도 IAM 정책의 태그를 사용하여 보고서 그룹을 보고 상호 작용할 수 있는 사용자를 제어할 수 있습니다. 태그 기반 액세스 정책의 예는 [태그를 사용하여 AWS CodeBuild 리소스에 대한 액세스 제어](auth-and-access-control-using-tags.md) 단원을 참조하세요.
**Topics**
+ [보고서 그룹에 태그 추가](how-to-tag-report-group-add.md)
+ [보고서 그룹의 태그 보기](how-to-tag-report-group-list.md)
+ [보고서 그룹의 태그 편집](how-to-tag-report-group-update.md)
+ [보고서 그룹에서 태그 제거](how-to-tag-report-group-delete.md)
# 보고서 그룹에 태그 추가
보고서 그룹에 태그를 추가하면 AWS 리소스를 식별 및 구성하고 리소스에 대한 액세스를 관리하는 데 도움이 될 수 있습니다. 먼저 보고서 그룹에 하나 이상의 태그(키-값 페어)를 추가합니다. 보고서 그룹에 태그 수에 대한 제한이 있음을 알아두십시오. 키 및 값 필드에서 사용할 수 있는 문자에 대한 제한이 있습니다. 자세한 내용은 [태그](limits.md#tag-limits) 단원을 참조하십시오. 태그가 생성된 후 해당 태그를 기준으로 보고서 그룹에 대한 액세스를 관리하는 IAM 정책을 생성할 수 있습니다. CodeBuild 콘솔 또는를 사용하여 보고서 그룹에 태그를 AWS CLI 추가할 수 있습니다.
**중요**
보고서 그룹에 태그를 추가하면 해당 보고서 그룹에 대한 액세스에 영향을 줄 수 있습니다. 보고서 그룹에 태그를 추가하기 전에 보고서 그룹과 같은 리소스에 대한 액세스를 제어하는 태그를 사용할 수도 있는 모든 IAM 정책을 검토하세요. 태그 기반 액세스 정책의 예는 [태그를 사용하여 AWS CodeBuild 리소스에 대한 액세스 제어](auth-and-access-control-using-tags.md) 단원을 참조하세요.
보고서 그룹을 생성할 때 보고서 그룹에 태그를 추가하는 방법에 대한 자세한 내용은 [보고서 그룹 만들기(콘솔)](report-group-create.md#test-report-group-create-console) 단원을 참조하십시오.
**Topics**
+ [보고서 그룹에 태그 추가(콘솔)](#how-to-tag-report-group-add-console)
+ [보고서 그룹에 태그 추가(AWS CLI)](#how-to-tag-report-group-add-cli)
## 보고서 그룹에 태그 추가(콘솔)
CodeBuild 콘솔을 사용하여 CodeBuild 보고서 그룹에 하나 이상의 태그를 추가할 수 있습니다.
1. [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/)에서 CodeBuild 콘솔을 엽니다.
1. **보고서 그룹**에서 태그를 추가할 보고서 그룹의 이름을 선택합니다.
1. 탐색 창에서 **설정**을 선택합니다.
1. 보고서 그룹에 추가된 태그가 없는 경우 **태그 추가**를 선택합니다. **편집**을 선택한 다음 **태그 추가**를 선택할 수도 있습니다.
1. **키**에 태그 이름을 입력합니다. **값**에 태그의 선택적 값을 추가할 수 있습니다.
1. (선택 사항) 다른 태그를 추가하려면 다시 **태그 추가**를 선택합니다.
1. 태그 추가를 마쳤으면 **제출**을 선택합니다.
## 보고서 그룹에 태그 추가(AWS CLI)
보고서 그룹을 생성할 때 보고서 그룹에 태그를 추가하려면 [보고서 그룹 생성(CLI)](report-group-create.md#test-report-group-create-cli) 단원을 참조하십시오. `CreateReportGroup.json`에서 태그를 추가합니다.
기존 보고서 그룹에 태그를 추가하려면 [보고서 그룹 업데이트(CLI)](report-group-export-settings.md#update-report-group-cli) 단원을 참조하고 `UpdateReportGroupInput.json`에서 태그를 추가하십시오.
이 단계에서는 사용자가 이미 AWS CLI 의 최신 버전을 설치했거나 현재 버전으로 업데이트했다고 가정합니다. 자세한 정보는 [AWS Command Line Interface설치](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) 섹션을 참조하세요.
# 보고서 그룹의 태그 보기
태그는 AWS 리소스를 식별 및 구성하고 리소스에 대한 액세스를 관리하는 데 도움이 될 수 있습니다. 태그 사용에 대한 자세한 내용은 [태그 지정 모범 사례](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf) 백서를 참조하십시오. 태그 기반 액세스 정책의 예는 [Deny or allow actions on report groups based on resource tags](auth-and-access-control-using-tags.md#report-group-tag-policy-example) 단원을 참조하세요.
## 보고서 그룹의 태그 보기(콘솔)
CodeBuild 콘솔을 사용하여 CodeBuild 보고서 그룹과 연결된 태그를 볼 수 있습니다.
1. [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/)에서 CodeBuild 콘솔을 엽니다.
1. **보고서 그룹**에서 태그를 보려는 보고서 그룹의 이름을 선택합니다.
1. 탐색 창에서 **설정**을 선택합니다.
## 보고서 그룹의 태그 보기(AWS CLI)
다음 단계에 따라 AWS CLI 를 사용하여 보고서 그룹의 AWS 태그를 봅니다. 태그가 추가되지 않은 경우 반환된 목록은 비어 있습니다.
1. 콘솔 또는 AWS CLI 를 사용하여 보고서 그룹의 ARN을 찾습니다. 해당 ARN을 기록해 둡니다.
------
#### [ AWS CLI ]
다음 명령을 실행합니다.
```
aws list-report-groups
```
이 명령은 다음과 유사한 JSON 형식의 정보를 반환합니다.
```
{
"reportGroups": [
"arn:aws:codebuild:region:123456789012:report-group/report-group-1",
"arn:aws:codebuild:region:123456789012:report-group/report-group-2",
"arn:aws:codebuild:region:123456789012:report-group/report-group-3"
]
}
```
보고서 그룹 ARN은 보고서 그룹의 ARN을 식별하는 데 사용할 수 있는 이름으로 끝납니다.
------
#### [ Console ]
1. [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/)에서 CodeBuild 콘솔을 엽니다.
1. **보고서 그룹**에서 보려는 태그가 있는 보고서 그룹의 이름을 선택합니다.
1. **구성**에서 보고서 그룹의 ARN을 찾습니다.
------
1. 다음 명령을 실행합니다. `--report-group-arns` 파라미터에 대해 기록한 ARN을 사용합니다.
```
aws codebuild batch-get-report-groups --report-group-arns arn:aws:codebuild:region:123456789012:report-group/report-group-name
```
성공하면 이 명령은 다음과 유사한 `tags` 섹션이 포함된 JSON 형식의 정보를 반환합니다.
```
{
...
"tags": {
"Status": "Secret",
"Project": "TestBuild"
}
...
}
```
# 보고서 그룹의 태그 편집
보고서 그룹과 연결된 태그에 대한 값을 변경할 수 있습니다. 또한, 키 이름을 변경할 수 있습니다. 이는 현재 태그를 제거하고 새 이름 및 다른 키와 동일한 값을 가진 다른 태그를 추가하는 것과 동일합니다. 키 및 값 필드에서 사용할 수 있는 문자에 대한 제한이 있음을 알아두십시오. 자세한 내용은 [태그](limits.md#tag-limits) 단원을 참조하십시오.
**중요**
보고서 그룹의 태그를 편집하면 해당 보고서 그룹에 대한 액세스에 영향을 줄 수 있습니다. 보고서 그룹에 대한 태그의 이름(키) 또는 값을 편집하기 전에 보고서 그룹과 같은 리소스에 대한 액세스를 제어하는 태그의 키 또는 값을 사용할 수도 있는 모든 IAM 정책을 검토하세요. 태그 기반 액세스 정책의 예는 [Deny or allow actions on report groups based on resource tags](auth-and-access-control-using-tags.md#report-group-tag-policy-example) 단원을 참조하세요.
## 보고서 그룹의 태그 편집(콘솔)
CodeBuild 콘솔을 사용하여 CodeBuild 보고서 그룹과 연결된 태그를 편집할 수 있습니다.
1. [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/)에서 CodeBuild 콘솔을 엽니다.
1. **보고서 그룹**에서 태그를 편집할 보고서 그룹의 이름을 선택합니다.
1. 탐색 창에서 **설정**을 선택합니다.
1. **편집**을 선택합니다.
1. 다음 중 하나를 수행하세요.
+ 태그를 변경하려면 **키**에 새 이름을 입력합니다. 태그 이름을 변경하는 것은 태그를 제거하고 새 키 이름의 새 태그를 추가하는 것과 동일합니다.
+ 태그 값을 변경하려면 새 값을 입력합니다. 값을 어떤 것으로도 변경하지 않으려면 현재 값을 삭제하고 필드를 비워둡니다.
1. 태그 편집을 마쳤으면 **제출**을 선택합니다.
## 보고서 그룹의 태그 편집(AWS CLI)
보고서 그룹에서 태그를 추가, 변경 또는 삭제하려면 [보고서 그룹 업데이트(CLI)](report-group-export-settings.md#update-report-group-cli) 단원을 참조하십시오. `UpdateReportGroupInput.json`에서 태그를 업데이트합니다.
# 보고서 그룹에서 태그 제거
보고서 그룹과 연결된 태그를 하나 이상 제거할 수 있습니다. 태그를 제거해도 해당 태그와 연결된 다른 AWS 리소스에서 태그는 삭제되지 않습니다.
**중요**
보고서 그룹의 태그를 제거하면 해당 보고서 그룹에 대한 액세스에 영향을 줄 수 있습니다. 보고서 그룹에서 태그를 제거하기 전에 보고서 그룹과 같은 리소스에 대한 액세스를 제어하는 태그의 키 또는 값을 사용할 수도 있는 모든 IAM 정책을 검토하세요. 태그 기반 액세스 정책의 예는 [태그를 사용하여 AWS CodeBuild 리소스에 대한 액세스 제어](auth-and-access-control-using-tags.md) 단원을 참조하세요.
## 보고서 그룹에서 태그 제거(콘솔)
CodeBuild 콘솔을 사용하면 태그와 CodeBuild 보고서 그룹 간의 연결을 제거할 수 있습니다.
1. [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/)에서 CodeBuild 콘솔을 엽니다.
1. **보고서 그룹**에서 태그를 제거할 보고서 그룹의 이름을 선택합니다.
1. 탐색 창에서 **설정**을 선택합니다.
1. **편집**을 선택합니다.
1. 제거할 태그를 찾은 다음 **태그 제거**를 선택합니다.
1. 태그 제거를 마쳤으면 **제출**을 선택합니다.
## 보고서 그룹에서 태그 제거(AWS CLI)
다음 단계에 따라 AWS CLI 를 사용하여 CodeBuild 보고서 그룹에서 태그를 제거합니다. 태그를 제거하면 태그는 삭제되지 않고 태그와 보고서 그룹 간의 연결만 제거됩니다.
**참고**
CodeBuild 보고서 그룹을 삭제하면 삭제된 보고서 그룹에서 모든 태그 연결이 제거됩니다. 보고서 그룹을 삭제하기 전에 태그를 제거할 필요가 없습니다.
보고서 그룹에서 하나 이상의 태그를 삭제하려면 [보고서 그룹의 태그 편집(AWS CLI)](how-to-tag-report-group-update.md#how-to-tag-report-group-update-cli) 단원을 참조하십시오. 삭제하려는 태그가 포함되지 않은 업데이트된 태그 목록으로 JSON 형식 데이터의 `tags` 섹션을 업데이트합니다. 모든 태그를 삭제하려면 `tags` 섹션을 다음과 같이 업데이트하십시오.
```
"tags: []"
```