Acciones de AWS Step Functions

Esta página proporciona una referencia de las acciones de AWS Step Functions disponibles en el catálogo de acciones de automatización del flujo de trabajo. Utilice estas acciones para iniciar, detener, reimpulsar e inspeccionar las ejecuciones de Step Functions y las máquinas de estado desde las definiciones del flujo de trabajo.

Requisitos previos

Antes de usar las acciones de AWS Step Functions en la automatización del flujo de trabajo, asegúrese de tener:

Una cuenta de AWS con las licencias adecuadas.
Credenciales de AWS configuradas (credenciales de usuario de IAM, ARN de rol de IAM o credenciales de sesión).
Los permisos de IAM necesarios para las operaciones de Step Functions.

Consulte Configurar credenciales de AWS para obtener información sobre cómo crear usuarios y roles de IAM, y configurar credenciales de AWS estáticas y de sesión para la integración con las acciones de AWS de automatización de flujos de trabajo.

Licencias IAM requeridos

Los permisos que necesita dependen de las acciones de Step Functions a las que llame el flujo de trabajo. Use el siguiente ejemplo como plantilla para una política de privilegios mínimos que cubra las siete acciones.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:StartExecution",
        "states:StopExecution",
        "states:RedriveExecution",
        "states:DescribeExecution",
        "states:ListExecutions",
        "states:DescribeStateMachine",
        "states:ListStateMachines"
      ],
      "Resource": "arn:aws:states:<region>:<account-id>:*"
    }
  ]
}

Importante

Reemplace <region> y <account-id> con los valores reales y restrinja Resource a los ARN de máquina de estado o de ejecución específicos donde sea posible.

Iniciar una ejecución de Step Functions

El identificador de la acción es aws.stepFunctions.startExecution.

Inicia una ejecución de una máquina de estado de AWS Step Functions. Si se realiza correctamente, devuelve el executionArn de la nueva ejecución, que puede pasar a aws.stepFunctions.describeExecution para consultar su estado.

La siguiente tabla describe todos los campos de entrada disponibles para esta acción.

Aporte	Tipo	Descripción	Ejemplo
awsRoleArn	Cadena	Opcional. ARN del rol de IAM a asumir. Recomendado. Tiene prioridad sobre las credenciales basadas en claves cuando se proporcionan ambas.	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	Cadena (secreta)	Opcional. ID de clave de acceso de AWS. Debe pasarse como un secreto.	`${{ :secrets:awsAccessKeyId }}`
awsSecretAccessKey	Cadena (secreta)	Opcional. Clave de acceso secreta de AWS. Debe pasarse como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
awsSessionToken	Cadena (secreta)	Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como un secreto.	`${{ :secrets:awsSessionToken }}`
región	Cadena	Requerido. Región de AWS donde está desplegada la máquina de estado.	`us-east-1`
stateMachineArn	Cadena	Requerido. ARN de la máquina de estado a ejecutar.	`arn:aws:states:us-east-1:123456789012:stateMachine:RestartUnhealthyService`
nombre	Cadena	Opcional. Nombre de ejecución. Debe ser único por máquina de estado. Se genera automáticamente como un UUID si se omite. En las máquinas de estado `STANDARD` , reutilizar el nombre de una ejecución en curso con una entrada diferente devuelve `ExecutionAlreadyExists` . En las máquinas de estado `EXPRESS` , los nombres se pueden reutilizar inmediatamente.	`incident-42`
entrada	Cadena	Opcional. Cadena JSON para pasar como entrada a la ejecución.	`'{"instanceId": "i-0123456789abcdef0"}'`
traceHeader	Cadena	Opcional. Encabezado de rastreo de X-Ray para propagar en la ejecución.	`Root=1-5e1b2f1a-3c1a1a1a1a1a1a1a1a1a1a1a`
selectors	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "executionArn", "expression": ".response.executionArn"}]`

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción	Tipo	Descripción
response	Objeto	Respuesta de la API de AWS Step Functions. `{ "executionArn": "arn:aws:states:us-east-1:123456789012:execution:RestartUnhealthyService:incident-42", "startDate": "2026-08-24T09:00:00.000Z" }`
success	Booleano	`true` en caso de éxito, `false` en caso de falla.
errorMessage	Cadena	Mensaje de error si la ejecución no se pudo iniciar. `null` en caso de éxito.

Producción

Tipo

Descripción

response

Objeto

Respuesta de la API de AWS Step Functions.

{
  "executionArn": "arn:aws:states:us-east-1:123456789012:execution:RestartUnhealthyService:incident-42",
  "startDate": "2026-08-24T09:00:00.000Z"
}

success

Booleano

true

en caso de éxito,

false

en caso de falla.

errorMessage

Cadena

Mensaje de error si la ejecución no se pudo iniciar.

null

en caso de éxito.

El siguiente ejemplo inicia una ejecución de corrección y captura el ARN de ejecución para los pasos posteriores.

Ejemplo de flujo de trabajo
name: start-sfn-remediation description: 'Starts a Step Functions remediation execution' workflowInputs: arnRole: type: String stateMachineArn: type: String incidentId: type: String steps: - name: startRemediation type: action action: aws.stepFunctions.startExecution version: '1' inputs: awsRoleArn: ${{ .workflowInputs.arnRole }} region: us-east-1 stateMachineArn: ${{ .workflowInputs.stateMachineArn }} name: incident-${{ .workflowInputs.incidentId }} input: '{"incidentId": "${{ .workflowInputs.incidentId }}"}' selectors: - name: executionArn expression: '.response.executionArn'

Ejemplo de flujo de trabajo

name: start-sfn-remediation
description: 'Starts a Step Functions remediation execution'

workflowInputs:
  arnRole:
    type: String
  stateMachineArn:
    type: String
  incidentId:
    type: String

steps:
  - name: startRemediation
    type: action
    action: aws.stepFunctions.startExecution
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      stateMachineArn: ${{ .workflowInputs.stateMachineArn }}
      name: incident-${{ .workflowInputs.incidentId }}
      input: '{"incidentId": "${{ .workflowInputs.incidentId }}"}'
      selectors:
        - name: executionArn
          expression: '.response.executionArn'

Detener una ejecución de Step Functions

El identificador de la acción es aws.stepFunctions.stopExecution.

Detiene una ejecución de Step Functions en curso. AWS marca la ejecución como ABORTED una vez que se detiene.

Importante

Esta acción solo es compatible con las máquinas de estado STANDARD. No puede detener EXPRESS ejecuciones.

La siguiente tabla describe todos los campos de entrada disponibles para esta acción.

Aporte	Tipo	Descripción	Ejemplo
awsRoleArn	Cadena	Opcional. ARN del rol de IAM a asumir. Recomendado. Tiene prioridad sobre las credenciales basadas en claves cuando se proporcionan ambas.	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	Cadena (secreta)	Opcional. ID de clave de acceso de AWS. Debe pasarse como un secreto.	`${{ :secrets:awsAccessKeyId }}`
awsSecretAccessKey	Cadena (secreta)	Opcional. Clave de acceso secreta de AWS. Debe pasarse como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
awsSessionToken	Cadena (secreta)	Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como un secreto.	`${{ :secrets:awsSessionToken }}`
región	Cadena	Requerido. Región de AWS donde se está ejecutando la ejecución.	`us-east-1`
executionArn	Cadena	Requerido. ARN de la ejecución a detener.	`arn:aws:states:us-east-1:123456789012:execution:RestartUnhealthyService:incident-42`
error	Cadena	Opcional. Código de error corto que describe por qué se detuvo la ejecución.	`TimeoutFromWorkflowAutomation`
causa	Cadena	Opcional. Explicación legible por humanos de por qué se detuvo la ejecución.	`Remediation exceeded 10 minute SLA, aborted by workflow`
selectors	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "stopDate", "expression": ".response.stopDate"}]`

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción	Tipo	Descripción
response	Objeto	Respuesta de la API de AWS Step Functions. `{ "stopDate": "2026-08-24T09:15:30.000Z" }`
success	Booleano	`true` en caso de éxito, `false` en caso de falla.
errorMessage	Cadena	Mensaje de error si falló la detención de la ejecución. `null` en caso de éxito.

Producción

Tipo

Descripción

response

Objeto

Respuesta de la API de AWS Step Functions.

{
  "stopDate": "2026-08-24T09:15:30.000Z"
}

success

Booleano

true

en caso de éxito,

false

en caso de falla.

errorMessage

Cadena

Mensaje de error si falló la detención de la ejecución.

null

en caso de éxito.

El siguiente ejemplo aborta una ejecución que ha superado el SLA.

Ejemplo de flujo de trabajo
`name: abort-stuck-sfn-run description: 'Aborts a Step Functions execution that exceeded its SLA' workflowInputs: arnRole: type: String executionArn: type: String steps: - name: abortStuckRun type: action action: aws.stepFunctions.stopExecution version: '1' inputs: awsRoleArn: ${{ .workflowInputs.arnRole }} region: us-east-1 executionArn: ${{ .workflowInputs.executionArn }} error: 'TimeoutFromWorkflowAutomation' cause: 'Remediation exceeded 10 minute SLA, aborted by workflow'`

Ejemplo de flujo de trabajo

name: abort-stuck-sfn-run
description: 'Aborts a Step Functions execution that exceeded its SLA'

workflowInputs:
  arnRole:
    type: String
  executionArn:
    type: String

steps:
  - name: abortStuckRun
    type: action
    action: aws.stepFunctions.stopExecution
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      executionArn: ${{ .workflowInputs.executionArn }}
      error: 'TimeoutFromWorkflowAutomation'
      cause: 'Remediation exceeded 10 minute SLA, aborted by workflow'

Reimpulsar una ejecución de Step Functions

El identificador de la acción es aws.stepFunctions.redriveExecution.

Reimpulsa una ejecución de Step Functions fallida, con tiempo de espera agotado o cancelada, reanudándola desde el último estado no exitoso sin comenzar de nuevo desde el principio.

Importante

Esta acción solo es compatible con las máquinas de estado STANDARD. Una ejecución solo se puede reimpulsar si no ha SUCCEEDED, está dentro de los 14 días posteriores a su finalización y tiene menos de 24 999 eventos de historial.

La siguiente tabla describe todos los campos de entrada disponibles para esta acción.

Aporte	Tipo	Descripción	Ejemplo
awsRoleArn	Cadena	Opcional. ARN del rol de IAM a asumir. Recomendado. Tiene prioridad sobre las credenciales basadas en claves cuando se proporcionan ambas.	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	Cadena (secreta)	Opcional. ID de clave de acceso de AWS. Debe pasarse como un secreto.	`${{ :secrets:awsAccessKeyId }}`
awsSecretAccessKey	Cadena (secreta)	Opcional. Clave de acceso secreta de AWS. Debe pasarse como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
awsSessionToken	Cadena (secreta)	Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como un secreto.	`${{ :secrets:awsSessionToken }}`
región	Cadena	Requerido. Región de AWS donde se realizó la ejecución.	`us-east-1`
executionArn	Cadena	Requerido. ARN de la ejecución que se va a reimpulsar.	`arn:aws:states:us-east-1:123456789012:execution:RestartUnhealthyService:incident-42`
clientToken	Cadena	Opcional. Token de idempotencia para la solicitud de redrive. Autogenerado por el SDK si se omite.	`a1b2c3d4-e5f6-7890-abcd-ef1234567890`
selectors	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "redriveDate", "expression": ".response.redriveDate"}]`

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción	Tipo	Descripción
response	Objeto	Respuesta de la API de AWS Step Functions. `{ "redriveDate": "2026-08-24T09:20:00.000Z" }`
success	Booleano	`true` en caso de éxito, `false` en caso de falla.
errorMessage	Cadena	Mensaje de error si el redrive falló. `null` en caso de éxito.

Producción

Tipo

Descripción

response

Objeto

Respuesta de la API de AWS Step Functions.

{
  "redriveDate": "2026-08-24T09:20:00.000Z"
}

success

Booleano

true

en caso de éxito,

false

en caso de falla.

errorMessage

Cadena

Mensaje de error si el redrive falló.

null

en caso de éxito.

El siguiente ejemplo reimpulsa una ejecución fallida para reanudarla desde su último estado no exitoso.

Ejemplo de flujo de trabajo
`name: retry-failed-sfn-execution description: 'Redrives a failed Step Functions execution from its last unsuccessful state' workflowInputs: arnRole: type: String executionArn: type: String steps: - name: retryFailedRemediation type: action action: aws.stepFunctions.redriveExecution version: '1' inputs: awsRoleArn: ${{ .workflowInputs.arnRole }} region: us-east-1 executionArn: ${{ .workflowInputs.executionArn }} selectors: - name: redriveDate expression: '.response.redriveDate'`

Ejemplo de flujo de trabajo

name: retry-failed-sfn-execution
description: 'Redrives a failed Step Functions execution from its last unsuccessful state'

workflowInputs:
  arnRole:
    type: String
  executionArn:
    type: String

steps:
  - name: retryFailedRemediation
    type: action
    action: aws.stepFunctions.redriveExecution
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      executionArn: ${{ .workflowInputs.executionArn }}
      selectors:
        - name: redriveDate
          expression: '.response.redriveDate'

Describir una ejecución de Step Functions

El identificador de la acción es aws.stepFunctions.describeExecution.

Devuelve el estado, la entrada, la salida y los timestamp para una ejecución de Step Functions. Utilice esta acción para sondear el resultado de una ejecución iniciada por aws.stepFunctions.startExecution.

Importante

Esta acción admite STANDARD ejecuciones de máquinas de estado directamente. Solo puede describir EXPRESS ejecuciones que despachó un Map Run.

La siguiente tabla describe todos los campos de entrada disponibles para esta acción.

Aporte	Tipo	Descripción	Ejemplo
awsRoleArn	Cadena	Opcional. ARN del rol de IAM a asumir. Recomendado. Tiene prioridad sobre las credenciales basadas en claves cuando se proporcionan ambas.	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	Cadena (secreta)	Opcional. ID de clave de acceso de AWS. Debe pasarse como un secreto.	`${{ :secrets:awsAccessKeyId }}`
awsSecretAccessKey	Cadena (secreta)	Opcional. Clave de acceso secreta de AWS. Debe pasarse como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
awsSessionToken	Cadena (secreta)	Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como un secreto.	`${{ :secrets:awsSessionToken }}`
región	Cadena	Requerido. Región de AWS donde se realizó la ejecución.	`us-east-1`
executionArn	Cadena	Requerido. ARN de la ejecución a describir.	`arn:aws:states:us-east-1:123456789012:execution:RestartUnhealthyService:incident-42`
includedData	Enumeración	Opcional. Controla si se devuelve la definición de la ejecución. Utilice `METADATA_ONLY` para omitir el descifrado de la definición cuando el permiso `kms:Decrypt` no esté disponible. Por defecto es `ALL_DATA` .	`ALL_DATA` o `METADATA_ONLY`
selectors	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "status", "expression": ".response.status"}]`

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción	Tipo	Descripción
response	Objeto	Detalles de la ejecución de la API de AWS Step Functions. En las ejecuciones `FAILED`, `TIMED_OUT` o `ABORTED`, `output` está ausente y la API completa `error` / `cause` en su lugar. `redriveStatus` indica si la ejecución se puede reimpulsar. `{ "executionArn": "arn:aws:states:us-east-1:123456789012:execution:RestartUnhealthyService:incident-42", "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:RestartUnhealthyService", "name": "incident-42", "status": "SUCCEEDED", "startDate": "2026-08-24T09:00:00.000Z", "stopDate": "2026-08-24T09:02:15.000Z", "input": "{\"incidentId\": \"42\"}", "output": "{\"result\": \"resolved\"}", "redriveCount": 0, "redriveStatus": "NOT_REDRIVABLE" }`
success	Booleano	`true` en caso de éxito, `false` en caso de falla.
errorMessage	Cadena	Mensaje de error si la solicitud falló. `null` en caso de éxito.

Producción

Tipo

Descripción

response

Objeto

Detalles de la ejecución de la API de AWS Step Functions. En las ejecuciones FAILED, TIMED_OUT o ABORTED, output está ausente y la API completa error / cause en su lugar. redriveStatus indica si la ejecución se puede reimpulsar.

{
  "executionArn": "arn:aws:states:us-east-1:123456789012:execution:RestartUnhealthyService:incident-42",
  "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:RestartUnhealthyService",
  "name": "incident-42",
  "status": "SUCCEEDED",
  "startDate": "2026-08-24T09:00:00.000Z",
  "stopDate": "2026-08-24T09:02:15.000Z",
  "input": "{\"incidentId\": \"42\"}",
  "output": "{\"result\": \"resolved\"}",
  "redriveCount": 0,
  "redriveStatus": "NOT_REDRIVABLE"
}

success

Booleano

true

en caso de éxito,

false

en caso de falla.

errorMessage

Cadena

Mensaje de error si la solicitud falló.

null

en caso de éxito.

El siguiente ejemplo sondea el estado de una ejecución y captura la salida para los pasos posteriores.

Ejemplo de flujo de trabajo
`name: check-sfn-execution-status description: 'Polls the status and output of a Step Functions execution' workflowInputs: arnRole: type: String executionArn: type: String steps: - name: checkStatus type: action action: aws.stepFunctions.describeExecution version: '1' inputs: awsRoleArn: ${{ .workflowInputs.arnRole }} region: us-east-1 executionArn: ${{ .workflowInputs.executionArn }} selectors: - name: status expression: '.response.status' - name: output expression: '.response.output'`

Ejemplo de flujo de trabajo

name: check-sfn-execution-status
description: 'Polls the status and output of a Step Functions execution'

workflowInputs:
  arnRole:
    type: String
  executionArn:
    type: String

steps:
  - name: checkStatus
    type: action
    action: aws.stepFunctions.describeExecution
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      executionArn: ${{ .workflowInputs.executionArn }}
      selectors:
        - name: status
          expression: '.response.status'
        - name: output
          expression: '.response.output'

Listar ejecuciones de Step Functions

El identificador de la acción es aws.stepFunctions.listExecutions.

Enumera las ejecuciones de una máquina de estado de AWS Step Functions o una ejecución de mapa, opcionalmente filtradas por estado. Los resultados se ordenan con los más recientes primero.

La siguiente tabla describe todos los campos de entrada disponibles para esta acción.

Aporte	Tipo	Descripción	Ejemplo
awsRoleArn	Cadena	Opcional. ARN del rol de IAM a asumir. Recomendado. Tiene prioridad sobre las credenciales basadas en claves cuando se proporcionan ambas.	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	Cadena (secreta)	Opcional. ID de clave de acceso de AWS. Debe pasarse como un secreto.	`${{ :secrets:awsAccessKeyId }}`
awsSecretAccessKey	Cadena (secreta)	Opcional. Clave de acceso secreta de AWS. Debe pasarse como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
awsSessionToken	Cadena (secreta)	Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como un secreto.	`${{ :secrets:awsSessionToken }}`
región	Cadena	Requerido. Región de AWS en la que enumerar las ejecuciones.	`us-east-1`
stateMachineArn	Cadena	Opcional. ARN de la máquina de estado cuyas ejecuciones se van a enumerar. Proporcione esto o `mapRunArn` , no ambos. Las máquinas de estado `EXPRESS` no se pueden enumerar directamente —en su lugar, use `mapRunArn` para enumerar sus ejecuciones secundarias desde un mapa distribuido.	`arn:aws:states:us-east-1:123456789012:stateMachine:RestartUnhealthyService`
mapRunArn	Cadena	Opcional. ARN de la ejecución de mapa cuyas ejecuciones secundarias enumerar. Proporcione esto o `stateMachineArn` , no ambos. Requerido al usar `statusFilter: PENDING_REDRIVE` .	`arn:aws:states:us-east-1:123456789012:mapRun:MyStateMachine/abcd1234`
statusFilter	Enumeración	Opcional. Filtre las ejecuciones por estado. `PENDING_REDRIVE` requiere `mapRunArn` .	`RUNNING` \| `SUCCEEDED` \| `FAILED` \| `TIMED_OUT` \| `ABORTED` \| `PENDING_REDRIVE`
resultados máximos	En t	Opcional. Número máximo de ejecuciones que se devolverán. El valor predeterminado es 100, el máximo es 1000.	`20`
nextToken	Cadena	Opcional. Token de paginación del `response.nextToken` de una llamada anterior. Caduca después de 24 horas.	`AQICAHi...`
redriveFilter	Enumeración	Opcional. Filtre las ejecuciones según si se han reimpulsado.	`REDRIVEN` o `NOT_REDRIVEN`
selectors	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "executions", "expression": ".response.executions"}]`

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción	Tipo	Descripción
response	Objeto	Lista de ejecuciones de la API de AWS Step Functions. `nextToken` está presente solo cuando hay más páginas disponibles —páselo como `nextToken` en una llamada posterior para recuperar la siguiente página. `{ "executions": [ { "executionArn": "arn:aws:states:us-east-1:123456789012:execution:RestartUnhealthyService:incident-42", "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:RestartUnhealthyService", "name": "incident-42", "status": "RUNNING", "startDate": "2026-08-24T09:00:00.000Z" } ], "nextToken": null }`
success	Booleano	`true` en caso de éxito, `false` en caso de falla.
errorMessage	Cadena	Mensaje de error si la solicitud falló. `null` en caso de éxito.

Producción

Tipo

Descripción

response

Objeto

Lista de ejecuciones de la API de AWS Step Functions. nextToken está presente solo cuando hay más páginas disponibles —páselo como nextToken en una llamada posterior para recuperar la siguiente página.

{
  "executions": [
    {
      "executionArn": "arn:aws:states:us-east-1:123456789012:execution:RestartUnhealthyService:incident-42",
      "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:RestartUnhealthyService",
      "name": "incident-42",
      "status": "RUNNING",
      "startDate": "2026-08-24T09:00:00.000Z"
    }
  ],
  "nextToken": null
}

success

Booleano

true

en caso de éxito,

false

en caso de falla.

errorMessage

Cadena

Mensaje de error si la solicitud falló.

null

en caso de éxito.

El siguiente ejemplo enumera las ejecuciones actualmente en curso para una máquina de estado.

Ejemplo de flujo de trabajo
`name: find-running-sfn-executions description: 'Lists running executions for a state machine' workflowInputs: arnRole: type: String stateMachineArn: type: String steps: - name: findRunningExecutions type: action action: aws.stepFunctions.listExecutions version: '1' inputs: awsRoleArn: ${{ .workflowInputs.arnRole }} region: us-east-1 stateMachineArn: ${{ .workflowInputs.stateMachineArn }} statusFilter: RUNNING maxResults: 20 selectors: - name: executions expression: '.response.executions'`

Ejemplo de flujo de trabajo

name: find-running-sfn-executions
description: 'Lists running executions for a state machine'

workflowInputs:
  arnRole:
    type: String
  stateMachineArn:
    type: String

steps:
  - name: findRunningExecutions
    type: action
    action: aws.stepFunctions.listExecutions
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      stateMachineArn: ${{ .workflowInputs.stateMachineArn }}
      statusFilter: RUNNING
      maxResults: 20
      selectors:
        - name: executions
          expression: '.response.executions'

Describir una máquina de estado

El identificador de la acción es aws.stepFunctions.describeStateMachine.

Devuelve la definición, el rol de IAM, la configuración de registro, el tipo (STANDARD o EXPRESS) y el estado de una máquina de estado de AWS Step Functions.

La siguiente tabla describe todos los campos de entrada disponibles para esta acción.

Aporte	Tipo	Descripción	Ejemplo
awsRoleArn	Cadena	Opcional. ARN del rol de IAM a asumir. Recomendado. Tiene prioridad sobre las credenciales basadas en claves cuando se proporcionan ambas.	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	Cadena (secreta)	Opcional. ID de clave de acceso de AWS. Debe pasarse como un secreto.	`${{ :secrets:awsAccessKeyId }}`
awsSecretAccessKey	Cadena (secreta)	Opcional. Clave de acceso secreta de AWS. Debe pasarse como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
awsSessionToken	Cadena (secreta)	Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como un secreto.	`${{ :secrets:awsSessionToken }}`
región	Cadena	Requerido. Región de AWS donde está desplegada la máquina de estado.	`us-east-1`
stateMachineArn	Cadena	Requerido. ARN de la máquina de estado que se va a describir. También acepta un ARN de versión.	`arn:aws:states:us-east-1:123456789012:stateMachine:RestartUnhealthyService`
includedData	Enumeración	Opcional. Utilice `METADATA_ONLY` para omitir la devolución de la definición de la máquina de estado y evitar necesitar `kms:Decrypt` cuando la definición está cifrada con KMS. Por defecto es `ALL_DATA` .	`ALL_DATA` o `METADATA_ONLY`
selectors	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "type", "expression": ".response.type"}]`

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción	Tipo	Descripción
response	Objeto	Detalles de la máquina de estado de la API de AWS Step Functions. El campo `type` (`STANDARD` o `EXPRESS`) es útil para la lógica de ramificación —por ejemplo, para determinar si `stopExecution` o `redriveExecution` son aplicables. `{ "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:RestartUnhealthyService", "name": "RestartUnhealthyService", "status": "ACTIVE", "definition": "{\"StartAt\": \"RestartTask\", \"States\": {...}}", "roleArn": "arn:aws:iam::123456789012:role/StepFunctionsExecutionRole", "type": "STANDARD", "creationDate": "2026-01-15T00:00:00.000Z" }`
success	Booleano	`true` en caso de éxito, `false` en caso de falla.
errorMessage	Cadena	Mensaje de error si la solicitud falló. `null` en caso de éxito.

Producción

Tipo

Descripción

response

Objeto

Detalles de la máquina de estado de la API de AWS Step Functions. El campo type (STANDARD o EXPRESS) es útil para la lógica de ramificación —por ejemplo, para determinar si stopExecution o redriveExecution son aplicables.

{
  "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:RestartUnhealthyService",
  "name": "RestartUnhealthyService",
  "status": "ACTIVE",
  "definition": "{\"StartAt\": \"RestartTask\", \"States\": {...}}",
  "roleArn": "arn:aws:iam::123456789012:role/StepFunctionsExecutionRole",
  "type": "STANDARD",
  "creationDate": "2026-01-15T00:00:00.000Z"
}

success

Booleano

true

en caso de éxito,

false

en caso de falla.

errorMessage

Cadena

Mensaje de error si la solicitud falló.

null

en caso de éxito.

El siguiente ejemplo recupera el tipo y la definición de una máquina de estado.

Ejemplo de flujo de trabajo
name: get-sfn-state-machine-type description: 'Retrieves the type and definition of a state machine' workflowInputs: arnRole: type: String stateMachineArn: type: String steps: - name: getDefinition type: action action: aws.stepFunctions.describeStateMachine version: '1' inputs: awsRoleArn: ${{ .workflowInputs.arnRole }} region: us-east-1 stateMachineArn: ${{ .workflowInputs.stateMachineArn }} selectors: - name: type expression: '.response.type' - name: definition expression: '.response.definition'

Ejemplo de flujo de trabajo

name: get-sfn-state-machine-type
description: 'Retrieves the type and definition of a state machine'

workflowInputs:
  arnRole:
    type: String
  stateMachineArn:
    type: String

steps:
  - name: getDefinition
    type: action
    action: aws.stepFunctions.describeStateMachine
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      stateMachineArn: ${{ .workflowInputs.stateMachineArn }}
      selectors:
        - name: type
          expression: '.response.type'
        - name: definition
          expression: '.response.definition'

Enumerar máquinas de estado

El identificador de la acción es aws.stepFunctions.listStateMachines.

Enumera las máquinas de estado de AWS Step Functions en una cuenta y región. Use entradas de paginación para recuperar conjuntos de resultados grandes.

La siguiente tabla describe todos los campos de entrada disponibles para esta acción.

Aporte	Tipo	Descripción	Ejemplo
awsRoleArn	Cadena	Opcional. ARN del rol de IAM a asumir. Recomendado. Tiene prioridad sobre las credenciales basadas en claves cuando se proporcionan ambas.	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	Cadena (secreta)	Opcional. ID de clave de acceso de AWS. Debe pasarse como un secreto.	`${{ :secrets:awsAccessKeyId }}`
awsSecretAccessKey	Cadena (secreta)	Opcional. Clave de acceso secreta de AWS. Debe pasarse como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
awsSessionToken	Cadena (secreta)	Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como un secreto.	`${{ :secrets:awsSessionToken }}`
región	Cadena	Requerido. Región de AWS en la que enumerar las máquinas de estado.	`us-east-1`
resultados máximos	En t	Opcional. Número máximo de máquinas de estado a devolver. El valor predeterminado es 100, el máximo es 1000.	`50`
nextToken	Cadena	Opcional. Token de paginación del `response.nextToken` de una llamada anterior. Caduca después de 24 horas.	`AQICAHi...`
selectors	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "stateMachines", "expression": ".response.stateMachines"}]`

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción	Tipo	Descripción
response	Objeto	Lista de máquinas de estado de la API de AWS Step Functions. `nextToken` está presente solo cuando hay más páginas disponibles —páselo como `nextToken` en una llamada posterior para recuperar la siguiente página. `{ "stateMachines": [ { "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:RestartUnhealthyService", "name": "RestartUnhealthyService", "type": "STANDARD", "creationDate": "2026-01-15T00:00:00.000Z" } ], "nextToken": null }`
success	Booleano	`true` en caso de éxito, `false` en caso de falla.
errorMessage	Cadena	Mensaje de error si la solicitud falló. `null` en caso de éxito.

Producción

Tipo

Descripción

response

Objeto

Lista de máquinas de estado de la API de AWS Step Functions. nextToken está presente solo cuando hay más páginas disponibles —páselo como nextToken en una llamada posterior para recuperar la siguiente página.

{
  "stateMachines": [
    {
      "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:RestartUnhealthyService",
      "name": "RestartUnhealthyService",
      "type": "STANDARD",
      "creationDate": "2026-01-15T00:00:00.000Z"
    }
  ],
  "nextToken": null
}

success

Booleano

true

en caso de éxito,

false

en caso de falla.

errorMessage

Cadena

Mensaje de error si la solicitud falló.

null

en caso de éxito.

El siguiente ejemplo enumera las máquinas de estado en la cuenta y captura el resultado para los pasos posteriores.

Ejemplo de flujo de trabajo
`name: discover-sfn-state-machines description: 'Lists state machines in the account' workflowInputs: arnRole: type: String steps: - name: discoverStateMachines type: action action: aws.stepFunctions.listStateMachines version: '1' inputs: awsRoleArn: ${{ .workflowInputs.arnRole }} region: us-east-1 maxResults: 50 selectors: - name: stateMachines expression: '.response.stateMachines'`

Ejemplo de flujo de trabajo

name: discover-sfn-state-machines
description: 'Lists state machines in the account'

workflowInputs:
  arnRole:
    type: String

steps:
  - name: discoverStateMachines
    type: action
    action: aws.stepFunctions.listStateMachines
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      maxResults: 50
      selectors:
        - name: stateMachines
          expression: '.response.stateMachines'

Que sigue

Para continuar trabajando con las acciones de AWS y la automatización del flujo de trabajo, consulte los siguientes recursos.

Configuración de credenciales de AWS: configure los roles de IAM y las claves de acceso para usarlos con las acciones de AWS.
AWS Execute API: llamada API a cualquier API de AWS directamente cuando no haya una acción dedicada disponible.
Ejemplos de flujos de trabajo: consulte ejemplos de flujos de trabajo del mundo real utilizando acciones de AWS.

Te ofrecemos esta traducción automática para facilitar la lectura.

Requisitos previos.css-21sua1{background:none;border:none;width:0;padding:0;}

Licencias IAM requeridos

Importante

Iniciar una ejecución de Step Functions

Detener una ejecución de Step Functions

Importante

Reimpulsar una ejecución de Step Functions

Importante

Describir una ejecución de Step Functions

Importante

Listar ejecuciones de Step Functions

Describir una máquina de estado

Enumerar máquinas de estado

Que sigue

Requisitos previos