Cotas

AWS Step Functions coloca cotas nos tamanhos de determinados parâmetros da máquina de estado, como o número de ações da API durante um determinado período de tempo ou o número de máquinas de estado que você pode definir. Embora o objetivo dessas cotas seja impedir que uma máquina de estado mal configurada consuma todos os recursos do sistema, muitas não são fixas.

Para solicitar um aumento da cota de serviço, você pode fazer um dos seguintes procedimentos:

• Abra o console do Service Quotas em https://console.aws.amazon.com/servicequotas/home. Para solicitar um aumento de cota usando o console do Service Quotas, consulte Solicitação de aumento de cota no Guia do Usuário do Service Quotas.

• Use a página Support Center no AWS Management Console para solicitar um aumento de cota para os recursos fornecidos por AWS Step Functions região. Para obter mais informações, consulte Service Quotas do AWS em Referência geral da AWS.

nota

Se determinada etapa da execução da máquina de estado ou da execução de uma atividade demorar muito, você pode configurar o tempo limite de uma máquina de estado para que ela provoque um evento de tempo limite.

Cotas gerais

Cota

Descrição

Nomes no Step Functions

Os nomes das máquinas de estado, execuções e tarefas de atividade não devem exceder oitenta caracteres. Esses nomes devem ser exclusivos para sua conta e AWS região e não devem conter nenhum dos seguintes itens: Espaço em branco Caracteres curinga (? *) Caracteres de colchete (< > { } [ ]) Caracteres especiais (" # % \ ^ | ~ ` $ & , ; : /) caracteres de controle (\\u0000 - \\u001f ou \\u007f - \\u009f). Se sua máquina de estado for do tipo Express, você poderá fornecer o mesmo nome para várias execuções da máquina de estado. O Step Functions gera um ARN de execução exclusivo para cada execução de máquina de estado Express, mesmo que várias execuções tenham o mesmo nome. Step Functions permite criar nomes para máquinas de estado, execuções e atividades, além de rótulos que contenham caracteres não ASCII. Esses nomes não ASCII não funcionam com a Amazon. CloudWatch Para garantir que você possa acompanhar CloudWatch as métricas, escolha um nome que use somente caracteres ASCII.

Cotas relacionadas a contas

Recurso	Cota padrão	Pode ser aumentado para
Número máximo de máquinas de estado registradas	10.000	25.000
Número máximo de atividades registradas	10.000	15.000
Tamanho máximo de solicitação	1 MB por solicitação. Esse é o tamanho total de dados por solicitação de API do Step Functions, incluindo o cabeçalho da solicitação e todos os outros dados associados à solicitação.	Cota fixa
Máximo de execuções abertas por conta	1 milhão de execuções para cada Conta da AWS em cada Região da AWS. Exceder isso causará um erro ExecutionLimitExceeded. Não se aplica aos fluxos de trabalho expressos.	Milhões
Número máximo de Execução de mapas abertos Uma Execução de mapa aberta é uma Execução de mapa que foi iniciada, mas ainda não foi concluída. As corridas de mapas programadas aguardam no MapRunStartedevento até que o número total de execuções de mapas abertas seja menor que a cota padrão de 1000.	1000 Essa cota é aplicável ao estado Mapa distribuído.	Cota fixa
Máximo de redrives de uma Execução de mapa.	1000 Essa cota é aplicável ao estado Mapa distribuído.	Cota fixa
Número máximo de execuções secundárias paralelas do Map Run	10.000	Cota fixa

Cotas relacionadas à tarefa HTTP

Tarefas HTTP têm controle de utilização usando um esquema de bucket de token para manter a largura de banda do serviço Step Functions.

Recurso	Tamanho do bucket	Taxa de reabastecimento por segundo
Tarefa HTTP	300	300

A tabela a seguir lista a cota da duração de uma tarefa HTTP.

Recurso	Cota padrão
Duração da tarefa HTTP A duração de uma tarefa HTTP se refere ao tempo gasto por ela para enviar uma solicitação HTTP e receber uma resposta.	60 segundos Essa é uma cota rígida que não pode ser alterada.

Cotas relacionadas aos controles de utilização de estado

As transições de estados do Step Functions tem seu controle de utilização limitado por meio de um esquema de bucket de token, para manter a largura de banda do serviço. Os fluxos de trabalho padrão e os fluxos de trabalho expressos têm diferentes controles de utilização de transições de estado. As cotas de fluxo de trabalho padrão são cotas flexíveis e podem ser aumentadas.

nota

A limitação na métrica do StateTransition serviço é relatada como ExecutionThrottled na Amazon. CloudWatch Para obter mais informações, consulte a ExecutionThrottled CloudWatch métrica.

	Standard		Express
Métrica de serviço	Tamanho do bucket	Taxa de reabastecimento por segundo	Tamanho do bucket	Taxa de reabastecimento por segundo
StateTransition — No Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon) e na Europa (Irlanda)	5.000	5.000	Ilimitado	Ilimitado
StateTransition — Todas as outras regiões	800	800	Ilimitado	Ilimitado

Cotas relacionadas ao controle de utilização das ações de API

Algumas ações de API do Step Functions têm controle de utilização por meio de um esquema de bucket do token para manter a largura de banda do serviço. Essas cotas são flexíveis e podem ser aumentadas.

nota

As cotas de limitação são por conta, por região. AWS

AWS Step Functions pode aumentar o tamanho do balde e a taxa de recarga a qualquer momento.

	Standard		Express
Nome da API	Tamanho do bucket	Taxa de reabastecimento por segundo	Tamanho do bucket	Taxa de reabastecimento por segundo
StartExecution — No Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon) e na Europa (Irlanda)	1.300	300	6.000	6.000
StartExecution — Todas as outras regiões	800	150	6.000	6.000

Cota relacionada à API TestState

Nome da API	Cota	Pode ser aumentado para
TestState	1 transação por segundo (TPS)	Cota fixa

Outras cotas

Essas cotas são flexíveis e podem ser aumentadas.

	In US East (N. Virginia), US West (Oregon), and Europe (Ireland)		All other regions
Nome da API	Tamanho do bucket	Taxa de reabastecimento por segundo	Tamanho do bucket	Taxa de reabastecimento por segundo
CreateActivity	100	1	100	1
CreateStateMachine	100	1	100	1
DeleteActivity	100	1	100	1
DeleteStateMachine	100	1	100	1
DescribeActivity	200	1	200	1
DescribeExecution	300	15	250	10
DescribeStateMachine	200	20	200	20
DescribeStateMachineForExecution	200	1	200	1
GetActivityTask	3.000	500	1.500	300
GetExecutionHistory	400	20	400	20
ListActivities	100	10	100	5
ListExecutions	200	5	100	2
ListStateMachines	100	5	100	5
ListTagsForResource	100	1	100	1
SendTaskFailure	3.000	500	1.500	300
SendTaskHeartbeat	3.000	500	1.500	300
SendTaskSuccess	3.000	500	1.500	300
StartSyncExecution	As chamadas de API da execução do expresso síncrono não contribuem para os limites existentes de capacidade da conta. O Step Functions fornece a capacidade sob demanda e escala automaticamente com workload sustentada. Os picos na workload podem ser reduzidos até que a capacidade esteja disponível. Se sofrer controle de utilização, tente novamente depois de algum tempo. Para obter informações sobre fluxos de trabalho expressos síncronos, consulte Fluxos de trabalho expresso síncronos e assíncronos.
StopExecution	1.000	200	500	25
TagResource	200	1	200	1
UntagResource	200	1	200	1
UpdateStateMachine	100	1	100	1

Cotas relacionadas a execuções de máquina de estado

A tabela a seguir descreve as cotas relacionadas às execuções de máquinas de estado. As cotas de execução da máquina de estado são cotas fixas que não podem ser alteradas, exceto a cota de tempo de retenção do histórico de execução.

Cota	Padrão	Express
Tempo máximo de execução	1 ano. Se uma execução for executada por mais do que o máximo de 1 ano, ela falhará com um States.Timeout erro e emitirá uma ExecutionsTimedOut CloudWatch métrica.	5 minutos. Se uma execução for executada por mais de 5 minutos no máximo, ela falhará com um States.Timeout erro e emitirá uma ExecutionsTimedOut CloudWatch métrica.
Tamanho máximo do histórico de execução	25 mil eventos em um único histórico de execução de máquina de estado. Se o histórico de execução atingir essa cota, haverá falha na execução. Para evitar isso, consulte Evitar atingir a cota do histórico.	Ilimitada.
Tempo máximo de ociosidade da execução	1 ano (restrito pelo tempo máximo de execução).	5 minutos (restrito pelo tempo máximo de execução).
Tempo de retenção do histórico de execução	90 dias após o encerramento da execução. Após esse tempo, não será mais possível recuperar ou visualizar o histórico de execução. Não há cotas adicionais para o número de execuções encerradas que são retidas pelo Step Functions. Para atender aos requisitos de conformidade, organizacionais ou regulamentares, você pode reduzir o período de retenção do histórico de execução para 30 dias, enviando uma solicitação de cota. Para fazer isso, use o AWS Support Center Console e crie um novo caso. A alteração para reduzir o período de retenção para trinta dias é aplicável a cada conta em uma região.	Para ver o histórico de execução, o registro do Amazon CloudWatch Logs deve ser configurado. Para ter mais informações, consulte Como registrar usando o CloudWatch Logs.
Período redrivable de execução O período Redrivable refere-se ao tempo durante o qual você pode redrive uma determinada execução do fluxo de trabalho padrão. Esse período começa no dia em que uma máquina de estado conclui sua execução.	14 dias. Essa cota fixa é aplicável ao estado Mapa distribuído.	No momento, o Redrive não é compatível com os fluxos de trabalho expressos.

Cotas relacionadas a execuções de tarefas

A tabela a seguir descreve as cotas relacionadas às execuções de tarefas. Todas essas são cotas rígidas que não podem ser alteradas.

Cota	Padrão	Express
Tempo máximo de execução de tarefa	1 ano (restrito pelo tempo máximo de execução)	5 minutos (restrito pelo tempo máximo de execução)
Tempo máximo que o Step Functions mantém uma tarefa na fila	1 ano (restrito pelo tempo máximo de execução)	5 minutos (restrito pelo tempo máximo de execução)
Número máximo de pesquisas de atividade por nome do recurso da Amazon (ARN)	1.000 agentes de sondagem chamando GetActivityTask por ARN. Exceder essa cota resultará neste erro: "The maximum number of workers concurrently polling for activity tasks has been reached." (O número máximo de operadores fazendo a sondagem de tarefas de atividade simultaneamente foi atingido.)	Não se aplica a fluxos de trabalho expressos.
Tamanho máximo de entrada ou saída para uma tarefa, estado ou execução	256 KB de dados como uma cadeia codificada em UTF-8. Essa cota afeta tarefas (atividade, função do Lambda ou serviço integrado), estados ou dados de resultado de execução e dados de entrada ao programar uma tarefa, inserir um estado ou iniciar uma execução.	256 KB de dados como uma cadeia codificada em UTF-8. Essa cota afeta tarefas (atividade, função do Lambda ou serviço integrado), estados ou dados de resultado de execução e dados de entrada ao programar uma tarefa, inserir um estado ou iniciar uma execução.

Cotas relacionadas a versões e aliases

Recurso	Cota padrão
Número máximo de versões publicadas da máquina de estado	Mil para cada máquina de estado. Para solicitar um aumento desse limite flexível, use a página Support Center no AWS Management Console.
Número máximo de aliases de máquinas de estado	Cem para cada máquina de estado. Para solicitar um aumento desse limite flexível, use a página Support Center no AWS Management Console.

Restrições relacionadas à marcação

Esteja ciente dessas restrições ao marcar recursos do Step Functions.

nota

As restrições de marcação não podem ser aumentadas como outras cotas.

Restrição	Descrição
Número máximo de tags por recurso	50
Tamanho máximo da chave	128 caracteres do Unicode em UTF-8
Tamanho máximo do valor	256 caracteres Unicode em UTF-8
Restrição de prefixo	Não use o aws: prefixo nos nomes ou valores das tags porque ele está reservado para AWS uso. Você não pode editar nem excluir nomes ou valores de tag com esse prefixo. As tags com esse prefixo não contam para as tags por cota de recurso.
Restrições de caracteres	As tags só podem conter letras Unicode, números, espaços em branco ou estes símbolos: _ . : / = + - @.