기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon OpenSearch Ingestion 파이프라인 태그 지정
<a name="tag-pipeline"></a>

태그를 사용하면 Amazon OpenSearch Service 도메인에 임의 정보를 할당할 수 있으므로 해당 정보를 분류하고 필터링할 수 있습니다. *태그*는 사용자가 할당하거나가 AWS 리소스에 AWS 할당하는 메타데이터 레이블입니다. 각 태그는 *키*와 *값*으로 구성됩니다. 사용자가 할당하는 태그에 대해 키와 값을 정의합니다. 예를 들어 키를 `stage`로 정의하고 리소스 하나의 값을 `test`로 정의할 수 있습니다.

태그는 다음을 지원합니다.
+  AWS 리소스를 식별하고 구성합니다. 많은 AWS 서비스가 태그 지정을 지원하므로 다른 서비스의 리소스에 동일한 태그를 할당하여 리소스가 관련이 있음을 나타낼 수 있습니다. 예를 들어 Amazon OpenSearch Service 도메인에 할당하는 것과 동일한 태그를 OpenSearch Serverless 컬렉션에 할당할 수 있습니다.
+  AWS 비용을 추적합니다. AWS 결제 및 비용 관리 대시보드에서 이러한 태그를 활성화합니다.는 태그를 AWS 사용하여 비용을 분류하고 월별 비용 할당 보고서를 제공합니다. 자세한 내용은 [AWS Billing 사용 설명서](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/)의 [비용 할당 태그 사용](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)을 참조하세요.
+ 속성 기반 액세스 제어를 사용하여 파이프라인에 대한 액세스를 제한합니다. 예제 정책과 자세한 내용은 IAM 사용 설명서의 [태그 키를 기반으로 액세스 제어](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-tag-keys) 섹션을 참조하세요.

에서는 파이프라인이 기본 리소스입니다. OpenSearch Service 콘솔, AWS CLI, OpenSearch Ingestion APIs 또는 AWS SDKs를 사용하여 파이프라인에서 태그를 추가, 관리 및 제거할 수 있습니다.

**Topics**
+ [필요한 권한](#pipeline-tag-permissions)
+ [태그 작업(콘솔)](#tag-pipeline-console)
+ [태그 작업(AWS CLI)](#tag-pipeline-cli)

## 필요한 권한
<a name="pipeline-tag-permissions"></a>

OpenSearch Ingestion은 파이프라인에 태그를 지정하는 데 다음 AWS Identity and Access Management Access Analyzer (IAM) 권한을 사용합니다.
+ `osis:TagResource`
+ `osis:ListTagsForResource`
+ `osis:UntagResource`

각 권한에 대한 자세한 내용은 *서비스 권한 부여 참조*에서 [OpenSearch Ingestion에 대한 작업, 리소스 및 조건 키](https://docs.aws.amazon.com/service-authorization/latest/reference/list_opensearchingestionservice.html)에 대한 액션, 리소스 및 조건 키를 참조하세요.

## 태그 작업(콘솔)
<a name="tag-pipeline-console"></a>

콘솔은 도메인에 태그를 지정하는 가장 간단한 방법입니다.

****태그를 만들려면****

1. [https://console.aws.amazon.com/aos/osis/home](https://console.aws.amazon.com/aos/osis/home#osis/ingestion-pipelines) Amazon OpenSearch Service 콘솔에 로그인합니다. 파이프라인 페이지에 표시됩니다.

1. 태그를 추가할 파이프라인을 선택한 다음 **태그** 탭으로 이동합니다.

1. [**관리(Manage)**], [**새 태그 추가(Add new tag)**]를 선택합니다.

1. 태그 키와 선택 값을 입력합니다.

1. **저장**을 선택합니다.

태그를 삭제하려면 동일한 단계를 따르고 [**태그 관리(Manage tags)**] 페이지에서 [**제거(Remove)**]를 선택합니다.

콘솔을 사용한 태그 작업에 대한 자세한 내용은 *AWS 관리 콘솔 시작 안내서*에서 [Tag Editor](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html)를 참조하세요.

## 태그 작업(AWS CLI)
<a name="tag-pipeline-cli"></a>

를 사용하여 파이프라인에 태그를 지정하려면 `TagResource` 요청을 AWS CLI보냅니다.

```
aws osis tag-resource
  --arn arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline 
  --tags Key=service,Value=osis Key=source,Value=otel
```

`UntagResource` 명령을 사용하여 파이프라인에서 태그를 제거합니다.

```
aws osis untag-resource
  --arn arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline
  --tag-keys service
```

`ListTagsForResource` 명령을 사용하여 파이프라인의 기존 태그를 확인합니다.

```
aws osis list-tags-for-resource
  --arn arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline
```