기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Step Functions 워크플로의 상태 시스템 버전
*버전*은 번호가 매겨져 있으며 **변경할 수 없는** 상태 시스템 스냅샷입니다. 해당 상태 시스템에 적용된 최신 버전에서 버전을 게시합니다. 각 버전에는 상태 시스템 ARN과 콜론(:)으로 구분된 버전 번호의 조합인 고유한 Amazon 리소스 이름(ARN)이 있습니다. 다음 예제에서는 상태 시스템 버전 ARN의 형식을 보여줍니다.
```
arn:partition:states:region:account-id:stateMachine:myStateMachine:1
```
상태 시스템 버전을 사용하려면 첫 번째 버전을 게시해야 합니다. 버전을 게시한 후에는 버전 ARN으로 [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html) API 작업을 간접적으로 호출할 수 있습니다. 버전을 편집할 수 없지만 상태 시스템을 업데이트하고 새 버전을 게시할 수 있습니다. 상태 시스템 버전 여러 개를 게시할 수도 있습니다.
![\[버전이 상태 시스템의 변경할 수 없는 스냅샷인 방법을 보여주는 퍼지 예시 다이어그램입니다.\]](http://docs.aws.amazon.com/ko_kr/step-functions/latest/dg/images/versioning-concept.png)
새 상태 시스템 버전을 게시하면 Step Functions에서 버전 번호를 할당합니다. 버전 번호는 1부터 시작하며 새 버전이 나올 때마다 단조롭게 증가합니다. 지정된 상태 시스템에는 버전 번호가 다시 사용되지 않습니다. 상태 시스템 버전 10을 삭제한 다음 새 버전을 게시하면 Step Functions에서 상태 시스템을 버전 11로 게시합니다.
다음 속성은 상태 시스템의 모든 버전에서 동일합니다.
+ 상태 시스템의 모든 버전은 동일한 유형[(표준 또는 Express)](choosing-workflow-type.md)을 공유합니다.
+ 버전 간에 상태 시스템 이름이나 만든 날짜를 변경할 수 없습니다.
+ 태그는 전역적으로 상태 시스템에 적용됩니다. [TagResource](https://docs.aws.amazon.com/step-functions/latest/apireference/API_TagResource.html) 및 [UntagResource](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UntagResource.html) API 작업을 사용하여 상태 시스템의 태그를 관리할 수 있습니다.
상태 시스템에도 각 버전 및 [revision](concepts-cd-aliasing-versioning.md#statemachinerev)에 속하는 속성이 포함되지만 이러한 속성은 두 가지 지정된 버전이나 개정마다 다를 수 있습니다. 이러한 속성에는 [상태 시스템 정의](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-definition), [IAM 역할](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-roleArn), [추적 구성](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-tracingConfiguration) 및 [로깅 구성](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-loggingConfiguration)이 포함됩니다.
## 상태 시스템 버전 게시(콘솔)
상태 시스템 버전을 최대 1,000개까지 게시할 수 있습니다. 이 소프트 한도 증가를 요청하려면 [AWS Management Console](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)의 **지원 센터** 페이지를 사용합니다. 콘솔에서 또는 [DeleteStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineVersion.html) API 작업을 간접적으로 호출하여 사용하지 않는 버전을 수동으로 삭제할 수 있습니다.
**상태 머신 버전 게시하기**
1. [Step Functions 콘솔](https://console.aws.amazon.com/states/home?region=us-east-1#/)을 열고 기존 상태 시스템을 선택합니다.
1. **상태 시스템 세부 정보** 페이지에서 **편집**을 선택합니다.
1. 필요에 따라 상태 시스템 정의를 편집한 다음 **저장**을 선택합니다.
1. **Publish version(버전 게시)**을 선택합니다.
1. (선택 사항) 나타나는 대화 상자의 **설명** 필드에 상태 시스템 버전에 대한 간략한 설명을 입력합니다.
1. **게시**를 선택합니다.
**참고**
새 상태 시스템 버전을 게시하면 Step Functions에서 버전 번호를 할당합니다. 버전 번호는 1부터 시작하며 새 버전이 나올 때마다 단조롭게 증가합니다. 지정된 상태 시스템에는 버전 번호가 다시 사용되지 않습니다. 상태 시스템 버전 10을 삭제한 다음 새 버전을 게시하면 Step Functions에서 상태 시스템을 버전 11로 게시합니다.
## Step Functions API 작업을 사용하여 버전 관리
Step Functions는 상태 시스템 버전을 게시하고 관리하도록 다음 API 작업을 제공합니다.
+ [PublishStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_PublishStateMachineVersion.html) - 상태 시스템의 현재 [revision](concepts-cd-aliasing-versioning.md#statemachinerev)에서 버전을 게시합니다.
+ [UpdateStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html) - 상태 시스템을 업데이트하고 동일한 요청에서 `publish` 파라미터를 `true`로 설정한 경우 새 상태 시스템 버전을 게시합니다.
+ [CreateStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachine.html) - `publish` 파라미터를 `true`로 설정한 경우 상태 시스템의 첫 번째 개정을 게시합니다.
+ [ListStateMachineVersions](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineVersions.html) - 지정된 상태 시스템 ARN의 버전을 나열합니다.
+ [DescribeStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachine.html) - `stateMachineArn`에 지정된 버전 ARN의 상태 시스템 버전 세부 정보를 반환합니다.
+ [DeleteStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineVersion.html) - 상태 시스템 버전을 삭제합니다.
를 `myStateMachine` 사용하여 라는 상태 시스템의 현재 개정에서 새 버전을 게시하려면 `publish-state-machine-version` 명령을 AWS Command Line Interface사용합니다.
```
aws stepfunctions publish-state-machine-version --state-machine-arn arn:aws:states:region:account-id:stateMachine:myStateMachine
```
응답은 `stateMachineVersionArn`을 반환합니다. 예를 들어 이전 명령은 `arn:aws:states:region:account-id:stateMachine:myStateMachine:1`에 대한 응답을 반환합니다.
**참고**
새 상태 시스템 버전을 게시하면 Step Functions에서 버전 번호를 할당합니다. 버전 번호는 1부터 시작하며 새 버전이 나올 때마다 단조롭게 증가합니다. 지정된 상태 시스템에는 버전 번호가 다시 사용되지 않습니다. 상태 시스템 버전 10을 삭제한 다음 새 버전을 게시하면 Step Functions에서 상태 시스템을 버전 11로 게시합니다.
## 콘솔에서 상태 시스템 버전 실행
상태 시스템 버전을 시작하려면 먼저 현재 상태 시스템 [revision](concepts-cd-aliasing-versioning.md#statemachinerev)에서 버전을 게시해야 합니다. 버전을 게시하려면 Step Functions 콘솔을 사용하거나 [PublishStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_PublishStateMachineVersion.html) API 작업을 간접적으로 호출합니다. 선택적 파라미터 `publish`를 사용하여 [UpdateStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachineAlias.html) API 작업을 간접적으로 호출해 상태 시스템을 업데이트하고 해당 버전을 게시할 수도 있습니다.
콘솔을 사용하거나 [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html) API 작업을 간접적으로 호출하고 버전 ARN을 제공하여 버전 실행을 시작할 수 있습니다. [별칭](concepts-state-machine-alias.md)을 사용하여 버전 실행을 시작할 수도 있습니다. [라우팅 구성](concepts-state-machine-alias.md#alias-routing-config)에 따라 별칭에서 트래픽을 특정 버전으로 라우팅합니다.
버전을 사용하지 않고 상태 시스템 실행을 시작하면 Step Functions는 상태 시스템 최신 개정을 실행에 사용합니다. Step Functions에서 실행을 버전과 연결하는 방식은 [실행을 버전 또는 별칭과 연결](execution-alias-version-associate.md) 섹션을 참조하세요.
**상태 시스템 버전을 사용하여 실행 시작하기**
1. [Step Functions 콘솔](https://console.aws.amazon.com/states/home?region=us-east-1#/)을 열고 버전을 하나 이상 게시한 기존 상태 시스템을 선택합니다. 버전을 게시하는 방법은 [상태 시스템 버전 게시(콘솔)](#procedure-create-versions) 섹션을 참조하세요.
1. **상태 시스템 세부 정보** 페이지에서 **버전** 탭을 선택합니다.
1. **버전** 섹션에서 다음을 수행합니다.
1. 실행을 시작할 버전을 선택합니다.
1. **실행 시작**을 선택합니다.
1. (선택 사항) **실행 시작** 대화 상자에 실행 이름을 입력합니다.
1. (선택 사항) 실행 입력을 입력한 다음 **실행 시작**을 선택합니다.