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

# AWS IoT SiteWise 리소스에 태그 지정
<a name="tag-resources"></a>

 AWS IoT SiteWise 리소스에 태그를 지정하면 조직 자산을 효율적으로 분류, 관리 및 검색할 수 있는 강력한 방법이 제공됩니다. 키-값 페어로 구성된 태그를 할당하면 리소스에 설명 메타데이터를 연결할 수 있습니다. 태그의 메타데이터를 사용하여 작업을 간소화할 수 있습니다. 예를 들어 풍력 발전소 시나리오에서 태그를 사용하면 위치, 용량 및 운영 상태와 같은 특정 속성으로 터빈에 레이블을 지정하여 AWS IoT SiteWise내에서 빠르게 식별하고 관리할 수 있습니다.

태그를 AWS Identity and Access Management (IAM) 정책과 통합하면 조건부 액세스 규칙을 정의하여 보안 및 운영 제어가 향상됩니다. 즉, 특정 태그가 있는 사용자만 지정할 수 있습니다. 예를 들어 특정 역할 또는 부서로 태그가 지정된 사람만 특정 리소스에 액세스하거나 이를 수정할 수 있습니다.

# 에서 태그 사용 AWS IoT SiteWise
<a name="tag-basics"></a>

태그를 사용하여 용도, 소유자, 환경 또는 사용 사례에 맞는 기타 분류별로 AWS IoT SiteWise 리소스를 분류합니다. 동일한 유형의 리소스가 많은 경우, 할당한 태그를 기준으로 특정 리소스를 빠르게 식별할 수 있습니다.

각 태그는 키와 사용자가 지정하는 선택적 값으로 구성됩니다. 예를 들어 지원하는 산업 프로세스에 따라 자산 모델을 추적하기 위해 자산 모델에 대한 일련의 태그를 설정할 수 있습니다. 관리하는 각 유형의 리소스에 맞는 태그 키 세트를 개발하는 것이 좋습니다. 일관된 태그 키 세트를 사용하면 리소스를 보다 쉽게 관리할 수 있습니다.

## 로 태그 지정 AWS Management Console
<a name="tags-console"></a>

의 **태그 편집기**는 모든 AWS 서비스의 리소스에 대한 태그를 생성하고 관리할 수 있는 중앙 통합 방법을 AWS Management Console 제공합니다. 자세한 내용은 * AWS 리소스 태그 지정 및* [태그 편집기 사용 설명서의 태그 편집기 시작하기](https://docs.aws.amazon.com/tag-editor/latest/userguide/gettingstarted.html)를 참조하세요.

## AWS IoT SiteWise API로 태그 지정
<a name="tags-api"></a>

 AWS IoT SiteWise API는 태그도 사용합니다. 태그를 생성하기 전에 태그 지정에 대한 제한 사항을 유의하세요. 자세한 내용은 *AWS 일반 참조*의 [태그 이름 지정 및 사용 규칙](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html#tag-conventions)을 참조하세요.
+ 리소스를 만들 때 태그를 추가하려면 리소스의 `tags` 속성에서 태그를 정의합니다.
+ 기존 리소스에 태그를 추가하거나 태그 값을 업데이트하려면 [TagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_TagResource.html) 작업을 사용합니다.
+ 리소스에서 태그를 제거하려면 [UntagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UntagResource.html) 작업을 사용합니다.
+ 리소스와 연결된 태그를 검색하려면 [ListTagsForResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListTagsForResource.html) 작업을 사용하거나, 해당 리소스를 설명하고 `tags` 속성을 검사합니다.

다음 표에는 AWS IoT SiteWise API를 사용하여 태그를 지정할 수 있는 리소스와 해당 `Create` 및 `Describe` 작업이 나와 있습니다.


**태그 지정 가능한 AWS IoT SiteWise 리소스**  

| Resource | 작업 생성 | 작업 설명 | 
| --- | --- | --- | 
| 자산 모델 또는 구성 요소 모델 | [CreateAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModel.html) | [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html) | 
| 자산 | [CreateAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAsset.html) | [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) | 
| SiteWise Edge 게이트웨이 | [CreateGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateGateway.html) | [DescribeGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeGateway.html) | 
| Portal | [CreatePortal](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreatePortal.html) | [DescribePortal](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribePortal.html) | 
| Project | [CreateProject](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateProject.html) | [DescribeProject](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeProject.html) | 
| 대시보드 | [CreateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateDashboard.html) | [DescribeDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeDashboard.html) | 
| 액세스 정책 | [CreateAccessPolicy](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAccessPolicy.html) | [DescribeAccessPolicy](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAccessPolicy.html) | 
| 시계열 | [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) | [DescribeTimeSeries](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeTimeSeries.html) | 

의 경우 `[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)`자산 모델 및 자산을 생성하기 AWS IoT SiteWise 전에 산업 데이터를 로 보내도록 데이터 소스를 구성할 수 있습니다. AWS IoT SiteWise 는 자동으로 데이터 스트림을 생성하여 장비에서 원시 데이터 스트림을 수신합니다. 자세한 내용은 [데이터 수집 관리](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/data-streams.html)를 참조하세요.

다음 작업을 사용하여 태그 지정이 가능한 리소스의 태그를 보고 관리합니다.
+ [TagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_TagResource.html) – 리소스에 태그를 추가하거나 기존 태그의 값을 업데이트합니다.
+ [ListTagsForResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListTagsForResource.html) – 리소스의 태그를 나열합니다.
+ [UntagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UntagResource.html) – 리소스에서 태그를 제거합니다.

언제든지 리소스에서 태그를 추가하거나 제거할 수 있습니다. 기존 태그 키의 값을 업데이트하려면 동일한 키와 원하는 새로운 값을 포함한 태그를 리소스에 추가합니다. 이 작업은 이전 값을 새 값으로 바꿉니다. 빈 문자열을 태그 값으로 할당할 수 있지만 null 값은 할당할 수 없습니다.

리소스를 삭제하면 리소스에 연결된 모든 태그도 제거됩니다.

# IAM 정책에 태그 사용
<a name="tags-iam"></a>

IAM 정책에서 리소스 태그를 사용하여 사용자 액세스 및 권한을 제어합니다. 예를 들어, 정책은 사용자가 특정 태그가 연결된 리소스만 생성하도록 허용할 수 있습니다. 또한 정책은 사용자가 특정 태그가 있는 리소스를 생성하거나 수정하는 것을 제한할 수 있습니다.

**참고**  
태그를 사용하여 리소스에 대한 사용자의 액세스를 허용하거나 거부하는 경우, 동일한 리소스에 대한 사용자의 태그 추가 또는 제거 권한을 거부해야 합니다. 그러지 않으면 사용자가 제한을 우회하여 태그를 수정함으로써 리소스에 대한 액세스 권한을 얻을 수 있습니다.

정책 설명의 `Condition` 요소(`Condition` 블록이라고도 함)에 다음 조건 컨텍스트 키와 값을 사용할 수 있습니다.

`aws:ResourceTag/tag-key: tag-value`  
특정 태그가 있는 리소스에 대한 작업을 허용하거나 거부합니다.

`aws:RequestTag/tag-key: tag-value`  
태그 지정이 가능한 리소스를 만들거나 수정할 때 특정 태그를 사용하거나 사용하지 않도록 요구합니다.

`aws:TagKeys: [tag-key, ...]`  
태그 지정이 가능한 리소스를 만들거나 수정할 때 특정 태그 키 집합을 사용하거나 사용하지 않도록 요구합니다.

**참고**  
IAM 정책의 조건 컨텍스트 키 및 값은 태그 지정 가능한 리소스가 필수 파라미터인 작업에만 적용됩니다. 예를 들어 [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)에 대해 태그 기반의 조건부 액세스를 설정할 수 있습니다. 이 요청에서 태그 지정 가능한 리소스를 참조하지 않으므로 [PutLoggingOptions](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutLoggingOptions.html)에 대해 태그 기반의 조건부 액세스를 설정할 수 없습니다.

자세한 내용은 IAM 사용 설명서의 [AWS 리소스 태그를 사용하여 리소스에 대한 액세스 제어](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) 및 IAM JSON 정책 참조를 참조하세요. [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies.html) ** 

**태그를 사용하는 IAM 정책의 예**
+ [태그를 기반으로 AWS IoT SiteWise 자산 보기](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-asset-tags)