

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

# Amazon SWF의 태그
<a name="swf-dev-adv-tags"></a>

Amazon SWF는 워크플로 실행 태깅 작업을 지원합니다. 이 기능은 리소스가 많을 때 특히 유용합니다.

Amazon SWF는 최대 5개 태그를 사용해 워크플로 실행에 태그를 지정할 수 있습니다. 각 태그는 자유 형식의 문자열로 길이는 최대 256자입니다. 태그를 사용하려는 경우 워크플로 실행 시작 시 태그를 할당해야 합니다. 워크플로 실행을 시작한 후에는 워크플로 실행에 태그를 추가할 수 없고 워크플로 실행에 할당된 태그는 편집하거나 제거할 수 없습니다.

IAM은 태그를 기반으로 Amazon SWF 도메인에 대한 액세스를 제어하는 작업을 지원합니다. 태그를 기반으로 액세스를 제어하려면 IAM 정책의 조건 요소에 태그 정보를 제공하십시오.

## 태그 관리
<a name="manage-tags"></a>

 AWS SDKs를 사용하거나 Amazon SWF API와 직접 상호 작용하여 Amazon Simple Workflow Service 태그를 관리합니다. API를 사용하면 도메인을 등록할 때 태그를 추가하고, 기존 도메인에 대한 태그를 나열하며, 기존 도메인에 대한 태그를 추가하거나 삭제할 수 있습니다.

**참고**  
리소스당 태그는 50개로 제한됩니다. [Amazon SWF의 일반 계정 할당량](swf-dg-limits.md#swf-dg-limits-general) 섹션을 참조하세요
+ [https://docs.aws.amazon.com/amazonswf/latest/apireference/API_RegisterDomain.html](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_RegisterDomain.html)
+ [https://docs.aws.amazon.com/amazonswf/latest/apireference/API_ListTagsForResource.html](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_ListTagsForResource.html)
+ [https://docs.aws.amazon.com/amazonswf/latest/apireference/API_TagResource.html](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_TagResource.html)
+ [https://docs.aws.amazon.com/amazonswf/latest/apireference/API_UntagResource.html](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_UntagResource.html)

자세한 내용은 [Amazon SWF API 작업](swf-dg-using-swf-api.md) 및 [Amazon Simple Workflow Service API 참조](https://docs.aws.amazon.com/amazonswf/latest/apireference/)를 참조하십시오.

## 워크플로 실행에 태그 지정
<a name="swf-dg-tagging"></a>

Amazon SWF를 사용하면 태그를 워크플로 실행과 연결한 다음 이러한 태그를 기반으로 워크플로 실행을 쿼리할 수 있습니다. 가시성 작업을 사용할 때 listi를 필터링할 수 있습니다. 실행에 할당하는 태그를 신중하게 선택하면 태그를 사용하여 의미 있는 목록을 제공할 수 있습니다.

예를 들어, 주문 처리 센터를 여러 개 운영 중이라고 가정해 보겠습니다. 태그를 사용하면 특정 이행 센터에서 발생하는 프로세스를 나열할 수 있습니다. 또는 고객이 다른 유형의 미디어 파일을 변환하는 경우 태그는 비디오, 오디오 및 이미지 파일을 변환할 때 다른 프로세스를 나타낼 수 있습니다.

`StartWorkflowExecution` 작업, `StartChildWorkflowExecution` 결정 또는 `ContinueAsNewWorkflowExecution` 결정을 사용하여 실행을 시작할 때 워크플로 실행에 태그를 최대 5개까지 연결할 수 있습니다. 가시성 작업을 사용하여 워크플로 실행을 나열하거나 계산하는 경우 태그를 기반으로 결과를 필터링할 수 있습니다.

**태그 지정을 사용하려면**

1. 태그 지정 전략을 세웁니다. 비즈니스 요구 사항에 대해 생각해 보고 의미 있는 태그 목록을 만듭니다. 어떤 실행에 어떤 태그가 필요한지 결정합니다. 실행에 태그를 최대 5개까지 할당할 수 있긴 하지만 태그 라이브러리에는 태그가 무제한으로 포함될 수 있습니다. 각 태그는 최대 256자의 모든 문자열 값일 수 있으므로 태그는 거의 모든 비즈니스 개념을 설명할 수 있습니다.

1. 실행을 생성할 때 최대 5개 태그를 사용해 실행에 태그를 지정합니다.

1. `ListOpenWorkflowExecutions`, `ListClosedWorkflowExecutions`, `CountOpenWorkflowExecutions` 및 `CountClosedWorkflowExecutions` 작업으로 *tagFilter* 파라미터를 지정하여 특정 태그로 태그가 지정된 실행을 나열하거나 계산합니다. 작업은 지정된 태그를 기반으로 실행을 필터링합니다.

워크플로 실행에 태그를 연결하면 해당 태그는 실행에 영구히 연결되어 제거할 수 없습니다.

`tagFilter` 파라미터에는 `ListWorkflowExecutions`를 사용해 태그를 하나만 지정할 수 있습니다. 또한 태그 일치는 대/소문자를 구분하고 정확하게 일치하는 항목만 결과를 반환합니다.

다음과 같이 태그가 지정된 실행 2개를 이미 설정했다고 가정해 보겠습니다.


****  

| 실행 이름 | 할당된 태그 | 
| --- | --- | 
| 실행-1 |  Consumer, 2011-February  | 
| 실행-2 |  Wholesale, 2011-March  | 

Consumer 태그에 대해 `ListOpenWorkflowExecutions`에서 반환하는 실행 목록을 필터링할 수 있습니다. `oldestDate` 및 `latestDate` 값은 [Unix Time](https://en.wikipedia.org/wiki/Unix_time) 값으로 지정됩니다.

```
https://swf.us-east-1.amazonaws.com
  RespondDecisionTaskCompleted
  {
    "domain":"867530901",
    "startTimeFilter":{
        "oldestDate":1262332800,
        "latestDate":1325348400
    },
    "tagFilter":{
      "tag":"Consumer"
      }
  }
```

## 태그를 사용하여 도메인에 대한 액세스 제어
<a name="swf-dg-tagging-iam"></a>

IAM에서 Amazon SWF 도메인과 연결된 태그를 참조하여 Amazon Simple Workflow Service 도메인에 대한 액세스를 제어할 수 있습니다.

예를 들어 키가 있는 태그`environment`와 다음 조건이 있는 값을 포함하는 Amazon SWF 도메인을 제한`production`할 수 있습니다.

```
"Condition": {
    "StringEquals": {"aws:ResourceTag/environment": "production"}
}
```

자세한 내용은 다음을 참조하세요.
+ [IAM 태그를 사용한 액세스 제어](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_iam-tags.html)
+ [태그 기반 정책](tag-based-policies.md)