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

# API 요약
<a name="swf-dev-iam.api"></a>

이 단원에서는 IAM 정책을 사용해 액터가 각 API 및 의사 API를 사용하여 Amazon SWF 리소스에 액세스하는 방식을 제어할 수 있는 방법을 간략하게 설명합니다.
+ `RegisterDomain` 및 `ListDomains`를 제외한 모든 작업에서 도메인 리소스에 대한 권한을 표시해 계정의 도메인 일부 또는 전부에 대한 액세스를 허용 또는 거부할 수 있습니다.
+ 정규 API 멤버에 대한 권한을 허용하거나 거부할 수 있고, `[RespondDecisionTaskCompleted](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_RespondDecisionTaskCompleted.html)` 호출 권한을 부여하여 의사 API 멤버에 대한 권한을 허용 또는 거부할 수 있습니다.
+ 조건을 사용해 일부 파라미터의 허용 가능한 값을 제한할 수 있습니다.

다음 단원에서는 정규 및 의사 API의 각 멤버에 대해 제한할 수 있는 파라미터를 나열하고, 연결된 키를 제공하고, 도메인 액세스를 제어할 수 있는 방법에 대한 제한 사항을 설명합니다.

## 일반 API
<a name="swf-dev-iam.api.regular"></a>

이 단원에서는 정규 API 멤버를 나열하고, 제한할 수 있는 파라미터와 연결된 키에 대해 간략하게 설명합니다. 또한 도메인 액세스를 제어할 수 있는 방법에 대한 제한 사항을 설명합니다.

`[CountClosedWorkflowExecutions](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_CountClosedWorkflowExecutions.html)`
+ `tagFilter.tag` – 문자열 제약. 키는 `swf:tagFilter.tag`입니다.
+ `typeFilter.name` – 문자열 제약. 키는 `swf:typeFilter.name`입니다.
+ `typeFilter.version` – 문자열 제약. 키는 `swf:typeFilter.version`입니다.

**참고**  
`CountClosedWorkflowExecutions`에서는 `typeFilter`와 `tagFilter`를 함께 사용할 수 없습니다.

`[CountOpenWorkflowExecutions](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_CountOpenWorkflowExecutions.html)`
+ `tagFilter.tag` – 문자열 제약. 키는 `swf:tagFilter.tag`입니다.
+ `typeFilter.name` – 문자열 제약. 키는 `swf:typeFilter.name`입니다.
+ `typeFilter.version` – 문자열 제약. 키는 `swf:typeFilter.version`입니다.

**참고**  
`CountOpenWorkflowExecutions`에서는 `typeFilter`와 `tagFilter`를 함께 사용할 수 없습니다.

`[CountPendingActivityTasks](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_CountPendingActivityTasks.html)`
+ `taskList.name` – 문자열 제약. 키는 `swf:taskList.name`입니다.

`[CountPendingDecisionTasks](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_CountPendingDecisionTasks.html)`
+ `taskList.name` – 문자열 제약. 키는 `swf:taskList.name`입니다.

`[DeleteActivityType](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_DeleteActivityType.html)`
+ `activityType.name` – 문자열 제약. 키는 `swf:activityType.name`입니다.
+ `activityType.version` – 문자열 제약. 키는 `swf:activityType.version`입니다.

`[DeprecateActivityType](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_DeprecateActivityType.html)`
+ `activityType.name` – 문자열 제약. 키는 `swf:activityType.name`입니다.
+ `activityType.version` – 문자열 제약. 키는 `swf:activityType.version`입니다.

`[DeprecateDomain](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_DeprecateDomain.html)`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`[DeleteWorkflowType](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_DeleteWorkflowType.html)`
+ `workflowType.name` – 문자열 제약. 키는 `swf:workflowType.name`입니다.
+ `workflowType.version` – 문자열 제약. 키는 `swf:workflowType.version`입니다.

`[DeprecateWorkflowType](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_DeprecateWorkflowType.html)`
+ `workflowType.name` – 문자열 제약. 키는 `swf:workflowType.name`입니다.
+ `workflowType.version` – 문자열 제약. 키는 `swf:workflowType.version`입니다.

`[DescribeActivityType](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_DescribeActivityType.html)`
+ `activityType.name` – 문자열 제약. 키는 `swf:activityType.name`입니다.
+ `activityType.version` – 문자열 제약. 키는 `swf:activityType.version`입니다.

`[DescribeDomain](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_DescribeDomain.html)`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`[DescribeWorkflowExecution](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_DescribeWorkflowExecution.html)`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`[DescribeWorkflowType](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_DescribeWorkflowType.html)`
+ `workflowType.name` – 문자열 제약. 키는 `swf:workflowType.name`입니다.
+ `workflowType.version` – 문자열 제약. 키는 `swf:workflowType.version`입니다.

`[GetWorkflowExecutionHistory](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_GetWorkflowExecutionHistory.html)`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`[ListActivityTypes](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_ListActivityTypes.html)`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`[ListClosedWorkflowExecutions](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_ListClosedWorkflowExecutions.html)`
+ `tagFilter.tag` – 문자열 제약. 키는 `swf:tagFilter.tag`입니다.
+ `typeFilter.name` – 문자열 제약. 키는 `swf:typeFilter.name`입니다.
+ `typeFilter.version` – 문자열 제약. 키는 `swf:typeFilter.version`입니다.

**참고**  
`ListClosedWorkflowExecutions`에서는 `typeFilter`와 `tagFilter`를 함께 사용할 수 없습니다.

`[ListDomains](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_ListDomains.html)`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`[ListOpenWorkflowExecutions](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_ListOpenWorkflowExecutions.html)`
+ `tagFilter.tag` – 문자열 제약. 키는 `swf:tagFilter.tag`입니다.
+ `typeFilter.name` – 문자열 제약. 키는 `swf:typeFilter.name`입니다.
+ `typeFilter.version` – 문자열 제약. 키는 `swf:typeFilter.version`입니다.

**참고**  
`ListOpenWorkflowExecutions`에서는 `typeFilter`와 `tagFilter`를 함께 사용할 수 없습니다.

`[ListWorkflowTypes](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_ListWorkflowTypes.html)`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`[PollForActivityTask](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_PollForActivityTask.html)`
+ `taskList.name` – 문자열 제약. 키는 `swf:taskList.name`입니다.

`[PollForDecisionTask](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_PollForDecisionTask.html)`
+ `taskList.name` – 문자열 제약. 키는 `swf:taskList.name`입니다.

`[RecordActivityTaskHeartbeat](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_RecordActivityTaskHeartbeat.html)`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`[RegisterActivityType](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_RegisterActivityType.html)`
+ `defaultTaskList.name` – 문자열 제약. 키는 `swf:defaultTaskList.name`입니다.
+ `name` – 문자열 제약. 키는 `swf:name`입니다.
+ `version` – 문자열 제약. 키는 `swf:version`입니다.

`[RegisterDomain](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_RegisterDomain.html)`
+ `name` – 등록 중인 도메인의 이름으로, 이 작업의 리소스로 사용할 수 있습니다.

`[RegisterWorkflowType](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_RegisterWorkflowType.html)`
+ `defaultTaskList.name` – 문자열 제약. 키는 `swf:defaultTaskList.name`입니다.
+ `name` – 문자열 제약. 키는 `swf:name`입니다.
+ `version` – 문자열 제약. 키는 `swf:version`입니다.

`[RequestCancelWorkflowExecution](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_RequestCancelWorkflowExecution.html)`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`[RespondActivityTaskCanceled](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_RespondActivityTaskCanceled.html)`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`[RespondActivityTaskCompleted](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_RespondActivityTaskCompleted.html)`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`[RespondActivityTaskFailed](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_RespondActivityTaskFailed.html)`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`[RespondDecisionTaskCompleted](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_RespondDecisionTaskCompleted.html)`
+ `decisions.member.N` – 의사 API 권한을 통해 간접적으로 제한됩니다. 자세한 내용은 [의사 API](#swf-dev-iam.api.pseudo)을 참조하세요.

`[SignalWorkflowExecution](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_SignalWorkflowExecution.html)`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`[StartWorkflowExecution](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_StartWorkflowExecution.html)`
+ `tagList.member.0` – 문자열 제약. 키는 `swf:tagList.member.0`입니다.
+ `tagList.member.1` – 문자열 제약. 키는 `swf:tagList.member.1`입니다.
+ `tagList.member.2` – 문자열 제약. 키는 `swf:tagList.member.2`입니다.
+ `tagList.member.3` – 문자열 제약. 키는 `swf:tagList.member.3`입니다.
+ `tagList.member.4` – 문자열 제약. 키는 `swf:tagList.member.4`입니다.
+ `taskList.name` – 문자열 제약. 키는 `swf:taskList.name`입니다.
+ `workflowType.name` – 문자열 제약. 키는 `swf:workflowType.name`입니다.
+ `workflowType.version` – 문자열 제약. 키는 `swf:workflowType.version`입니다.

**참고**  
태그는 다섯 개까지 제한할 수 있습니다.

`[TerminateWorkflowExecution](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_TerminateWorkflowExecution.html)`
+ 이 작업의 파라미터는 제한할 수 없습니다.

## 의사 API
<a name="swf-dev-iam.api.pseudo"></a>

이 단원에는 `[RespondDecisionTaskCompleted](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_RespondDecisionTaskCompleted.html)`에 포함된 결정을 나타내는 의사 API의 멤버 목록이 나옵니다. `RespondDecisionTaskCompleted`를 사용하도록 권한을 부여한 경우 정책은 정규 API와 동일한 방식으로 의사 API의 멤버에 대한 권한을 표현할 수 있습니다. 하나 이상의 파라미터에 대해 조건을 설정해 의사 API의 일부 멤버를 추가로 제한할 수 있습니다. 이 단원에서는 의사 API 멤버 목록을 나열하고, 제한할 수 있는 파라미터와 연결된 키에 대해 간략하게 설명합니다.

**참고**  
`aws:SourceIP`, `aws:UserAgent` 및 `aws:SecureTransport` 키는 의사 API에 사용할 수 없습니다. 의도한 보안 정책에서 이러한 키가 의사 API에 대한 액세스를 제어하도록 요구하면 `RespondDecisionTaskCompleted` 작업과 함께 해당 키를 사용할 수 있습니다.

`CancelTimer`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`CancelWorkflowExecution`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`CompleteWorkflowExecution`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`ContinueAsNewWorkflowExecution`
+ `tagList.member.0` – 문자열 제약. 키는 `swf:tagList.member.0`입니다.
+ `tagList.member.1` – 문자열 제약. 키는 `swf:tagList.member.1`입니다.
+ `tagList.member.2` – 문자열 제약. 키는 `swf:tagList.member.2`입니다.
+ `tagList.member.3` – 문자열 제약. 키는 `swf:tagList.member.3`입니다.
+ `tagList.member.4` – 문자열 제약. 키는 `swf:tagList.member.4`입니다.
+ `taskList.name` – 문자열 제약. 키는 `swf:taskList.name`입니다.
+ `workflowTypeVersion` – 문자열 제약. 키는 `swf:workflowTypeVersion`입니다.

**참고**  
태그는 다섯 개까지 제한할 수 있습니다.

`FailWorkflowExecution`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`RecordMarker`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`RequestCancelActivityTask`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`RequestCancelExternalWorkflowExecution`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`ScheduleActivityTask`
+ `activityType.name` – 문자열 제약. 키는 `swf:activityType.name`입니다.
+ `activityType.version` – 문자열 제약. 키는 `swf:activityType.version`입니다.
+ `taskList.name` – 문자열 제약. 키는 `swf:taskList.name`입니다.

`SignalExternalWorkflowExecution`
+ 이 작업의 파라미터는 제한할 수 없습니다.

`StartChildWorkflowExecution`
+ `tagList.member.0` – 문자열 제약. 키는 `swf:tagList.member.0`입니다.
+ `tagList.member.1` – 문자열 제약. 키는 `swf:tagList.member.1`입니다.
+ `tagList.member.2` – 문자열 제약. 키는 `swf:tagList.member.2`입니다.
+ `tagList.member.3` – 문자열 제약. 키는 `swf:tagList.member.3`입니다.
+ `tagList.member.4` – 문자열 제약. 키는 `swf:tagList.member.4`입니다.
+ `taskList.name` – 문자열 제약. 키는 `swf:taskList.name`입니다.
+ `workflowType.name` – 문자열 제약. 키는 `swf:workflowType.name`입니다.
+ `workflowType.version` – 문자열 제약. 키는 `swf:workflowType.version`입니다.

**참고**  
태그는 다섯 개까지 제한할 수 있습니다.

`StartTimer`
+ 이 작업의 파라미터는 제한할 수 없습니다.