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

# 에서 태그 사용 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 값은 할당할 수 없습니다.

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