AWS Step Functions
개발자 안내서

제한

AWS Step Functions은 특정 기간 동안 실행할 수 있는 API 작업의 수나 정의할 수 있는 실행 머신의 수 등 특정 상태 시스템 파라미터의 크기에 제한을 둡니다. 잘못 구성된 상태 시스템이 시스템의 리소스를 모두 사용하지 않도록 하기 위해 이러한 제한이 설계된 것이지만 하드 제한은 아닙니다.

참고

상태 시스템 실행이나 활동 실행의 특정 단계가 너무 오래 걸리는 경우 상태 시스템 시간 제한을 구성하여 시간 초과 이벤트를 발생시킬 수 있습니다.

일반 제한

한도 설명

Step Functions의 이름

상태 시스템, 실행 이름 및 활동 이름은 1–80자 길이여야 하고 해당 계정과 리전에 고유해야 하며 다음을 포함해서는 안 됩니다.

  • 공백

  • 와일드카드 문자 (? *)

  • 괄호 문자(< > { } [ ])

  • 특수 문자 (: ; , \ | ^ ~ $ # % & ` ")

  • 제어 문자(\\u0000 - \\u001f 또는 \\u007f - \\u009f).

Step Functions를 통해 비 ASCII 문자를 포함하는 상태 머신, 실행 및 활동 이름을 생성할 수 있습니다. 이러한 비 ASCII 이름은 Amazon CloudWatch에서는 유효하지 않습니다. CloudWatch 지표를 추적할 수 있도록 하려면 ASCII 문자만 사용하는 이름을 선택하십시오.

계정과 관련된 제한

한도 설명

등록된 활동 최대 수

10,000개

등록된 상태 시스템 최대 수 10,000개

최대 API 작업 수

흔치 않은 급증 시기 외에도, 매우 짧은 기간에 많은 수의 API 작업이 발생하는 경우 애플리케이션을 조정할 수 있습니다.

최대 요청 크기

요청당 1MB. Step Functions API 요청당 전체 데이터 크기로, 요청 헤더 및 그 밖의 모든 연결된 요청 데이터를 포함합니다.

상태 시스템 실행과 관련된 제한

한도 설명

최대 열린 실행 수

1,000,000. 이 제한을 초과하면 ExecutionLimitExceeded 오류가 발생합니다.

최대 실행 시간

1년. 실행 제한 기간인 1년 넘게 실행할 경우 States.Timeout 오류와 함께 실패하고 ExecutionsTimedout CloudWatch 지표를 내보냅니다.

최대 실행 기록 크기

25,000개의 이벤트. 실행 내역이 이 한도에 도달할 경우 실행은 실패합니다. 이를 피하려면 내역 한도 도달 방지 단원을 참조하십시오.

최대 실행 유휴 시간

1년(실행 시간 제한에 따라 제한됨)

최대 실행 기록 보관 시간

90일. 이 기간이 지나면 실행 내역을 더 이상 검색하거나 볼 수 없습니다. Step Functions에서 보유하는 닫힌 실행 수에 대한 추가 제한은 없습니다.

작업 실행과 관련된 제한

한도 설명

최대 작업 실행 시간

1년(실행 시간 제한에 따라 제한됨)

Step Functions가 대기열에 작업을 유지하는 최대 시간

1년(실행 시간 제한에 따라 제한됨)

ARN 당 최대 활동 poller

Amazon 리소스 이름 당 GetActivityTask를 호출하는 1,000 폴러. 이 제한 결과를 초과하면 "활동 작업의 polling이 작업의 최대 수에 도달했습니다" 오류가 나타납니다.

작업, 상태 또는 실행에 대한 최대 입력 또는 결과 데이터 크기

32,768자. 이 제한 값은 작업의 일정을 지정하거나 상태로 전환하거나 실행을 시작할 대 작업(활동이나 Lambda 함수), 상태 또는 실행 결과 데이터 및 입력 데이터에 영향을 줍니다.

API 작업 조절과 관련된 제한

서비스 대역폭을 유지하기 위해 토큰 버킷을 사용하여 일부 Step Functions API 작업이 조절됩니다.

참고

조절은 계정 당 리전 당에 따라 제한됩니다. AWS Step Functions는 버킷 크기 및 다시 채우기 속도 모두 언제라도 증가시킬 수 있습니다. 비용을 제한하기 위해 이러한 조절에 의존하지 마십시오.

API 이름 버킷 크기 초당 다시 채우기 속도
CreateActivity 100 1
CreateStateMachine 100 1
DeleteActivity 100 1
DeleteStateMachine 100 1
DescribeActivity 200 1
DescribeExecution 200 2
DescribeStateMachine 200 1
DescribeStateMachineForExecution 100 1
GetActivityTask 1,000 25
GetExecutionHistory 250 5
ListActivities 100 1
ListExecutions 100 2
ListStateMachines 100 1
SendTaskFailure 1,000 25
SendTaskHeartbeat 1,000 25
SendTaskSuccess 1,000 25
StartExecution 미국 동부(버지니아 북부), 미국 서부(오레곤) 및 EU(아일랜드)에서 1000 200
StartExecution기타 모든 리전 500 25
StopExecution 미국 동부(버지니아 북부), 미국 서부(오레곤) 및 EU(아일랜드)에서 1000 200
StopExecution기타 모든 리전 500 25
UpdateStateMachine 200 1

상태 조절과 관련된 제한

서비스 대역폭을 유지하기 위해 토큰 버킷 체계를 사용하여 Step Functions 상태 변환이 조절됩니다.

참고

StateTransition 서비스 측정치의 조절이 CloudWatch에서 ExecutionThrottled로 보고됩니다. 자세한 내용은 ExecutionThrottled CloudWatch 지표를 참조하십시오.

서비스 지표 버킷 크기 초당 다시 채우기 속도

StateTransition미국 동부(버지니아 북부), 미국 서부(오레곤) 및 EU(아일랜드)

5000

1000

StateTransition기타 모든 리전

800

400

태그 지정에 관련된 제한

Step Functions 리소스에 태그를 지정할 때는 이러한 제한에 주의하십시오.

참고

다른 제한과 마찬가지로 태그 지정 제한을 증가시킬 수 없습니다.

제한 설명

리소스당 최대 태그 수

50

최대 키 길이

UTF-8 형식의 유니코드 문자 128자

최대 값 길이

UTF-8 형식의 유니코드 문자 256자

접두사 제한

태그 이름이나 값에서 aws: 접두사는 사용하지 마십시오. 이 단어는 AWS용으로 예약되어 있습니다. 이 접두사가 지정된 태그 이름이나 값은 편집하거나 삭제할 수 없습니다. 이 접두사가 지정된 태그는 리소스당 태그 수 제한에 포함되지 않습니다.

문자 제한

태그에는 유니코드 문자, 숫자, 공백 또는 _ . : / = + - @ 등의 기호만 포함될 수 있습니다.

제한 증가 요청

AWS Management 콘솔의 지원 센터 페이지에서 AWS Step Functions가 리전별로 제공하는 리소스에 대한 제한을 늘려달라고 요청할 수 있습니다. 자세한 내용은 AWS General Reference에서 제한 증가를 요청하려면을 참조하십시오.