• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Actions AWS Step Functions

|View as Markdown (English)

Cette page fournit une référence pour les actions AWS Step Functions disponibles dans le catalogue des actions de Workflow Automation. Utilisez ces actions pour démarrer, arrêter, relancer, et inspecter les exécutions et les machines à états Step Functions depuis vos définitions de workflow.

Prérequis

Avant d'utiliser les actions AWS Step Functions dans Workflow Automation, assurez-vous d'avoir :

  • Un compte AWS disposant des autorisations appropriées.
  • Informations d'identification AWS configurées (informations d'identification de l'utilisateur IAM, ARN du rôle IAM ou informations d'identification de session).
  • Les autorisations IAM nécessaires pour les opérations Step Functions.

Consultez la section Configurer les identifiants AWS pour savoir comment créer des utilisateurs et des rôles IAM, et configurer des identifiants AWS statiques et de session pour l'intégration aux actions AWS de Workflow Automation.

Autorisations IAM requises

Les autorisations dont vous avez besoin dépendent des actions Step Functions que votre workflow appelle. Utilisez l’exemple ci-dessous comme modèle pour une politique de moindre privilège couvrant les sept actions.

{
  "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>:*"
    }
  ]
}

Important

Remplacez <region> et <account-id> par vos valeurs réelles, et restreignez le Resource à des ARN de machine à états ou d'exécution spécifiques dans la mesure du possible.

Démarrer une exécution Step Functions

L’identifiant de l’action est aws.stepFunctions.startExecution.

Démarre une exécution d’une machine à états AWS Step Functions. En cas de succès, renvoie le executionArn de la nouvelle exécution, que vous pouvez transmettre à aws.stepFunctions.describeExecution pour interroger son statut.

Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.

Saisir

Type

Description

Exemple

awsRoleArn

Chaîne

Facultatif.

ARN du rôle IAM à assumer. Recommandé. Prend le pas sur les informations d’identification basées sur des clés lorsque vous fournissez les deux.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne (secret)

Facultatif.

ID de clé d’accès AWS. Doit être transmis en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne (secret)

Facultatif.

Clé d’accès secrète AWS. Doit être transmis en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne (secret)

Facultatif.

Jeton de session AWS pour les identifiants temporaires. Doit être transmis en tant que secret.

${{ :secrets:awsSessionToken }}

région

Chaîne

Obligatoire.

Région AWS où la machine à états est déployée.

us-east-1

stateMachineArn

Chaîne

Obligatoire.

ARN de la machine à états à exécuter.

arn:aws:states:us-east-1:123456789012:stateMachine:RestartUnhealthyService

name

Chaîne

Facultatif.

Nom de l’exécution. Doit être unique par machine à états. Généré automatiquement en tant qu’UUID s’il est omis. Sur les machines à états

STANDARD

, la réutilisation du nom d’une exécution en cours avec une entrée différente renvoie

ExecutionAlreadyExists

. Sur les machines à états

EXPRESS

, les noms peuvent être réutilisés immédiatement.

incident-42

input

Chaîne

Facultatif.

Chaîne JSON à passer en entrée à l’exécution.

'{"instanceId": "i-0123456789abcdef0"}'

traceHeader

Chaîne

Facultatif.

En-tête de la trace X-Ray à propager dans l’exécution.

Root=1-5e1b2f1a-3c1a1a1a1a1a1a1a1a1a1a1a

selectors

List

Facultatif.

Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "executionArn", "expression": ".response.executionArn"}]

Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.

Sortir

Type

Description

response

Objet

Réponse de l’API AWS Step Functions.

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

success

Booléen

true

en cas de succès,

false

en cas d’échec.

errorMessage

Chaîne

Message d’erreur si l’exécution n’a pas pu démarrer.

null

en cas de succès.

L’exemple suivant démarre une exécution de remédiation et capture l’ARN d’exécution pour les étapes en aval.

Exemple de workflow

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'

Arrêter une exécution Step Functions

L’identifiant de l’action est aws.stepFunctions.stopExecution.

Arrête une exécution Step Functions en cours. AWS marque l’exécution comme ABORTED une fois qu’elle s’arrête.

Important

Cette action est prise en charge uniquement sur les machines d’état STANDARD. Il ne peut pas arrêter les exécutions EXPRESS.

Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.

Saisir

Type

Description

Exemple

awsRoleArn

Chaîne

Facultatif.

ARN du rôle IAM à assumer. Recommandé. Prend le pas sur les informations d’identification basées sur des clés lorsque vous fournissez les deux.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne (secret)

Facultatif.

ID de clé d’accès AWS. Doit être transmis en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne (secret)

Facultatif.

Clé d’accès secrète AWS. Doit être transmis en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne (secret)

Facultatif.

Jeton de session AWS pour les identifiants temporaires. Doit être transmis en tant que secret.

${{ :secrets:awsSessionToken }}

région

Chaîne

Obligatoire.

Région AWS où l’exécution est en cours.

us-east-1

executionArn

Chaîne

Obligatoire.

ARN de l'exécution à arrêter.

arn:aws:states:us-east-1:123456789012:execution:RestartUnhealthyService:incident-42

erreur

Chaîne

Facultatif.

Code d’erreur court décrivant pourquoi l’exécution a été arrêtée.

TimeoutFromWorkflowAutomation

cause

Chaîne

Facultatif.

Explication lisible par un humain de la raison pour laquelle l’exécution a été arrêtée.

Remediation exceeded 10 minute SLA, aborted by workflow

selectors

List

Facultatif.

Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "stopDate", "expression": ".response.stopDate"}]

Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.

Sortir

Type

Description

response

Objet

Réponse de l’API AWS Step Functions.

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

success

Booléen

true

en cas de succès,

false

en cas d’échec.

errorMessage

Chaîne

Message d’erreur si l’arrêt de l’exécution a échoué.

null

en cas de succès.

L’exemple suivant abandonne une exécution qui a dépassé son SLA.

Exemple de workflow

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'

Relancer une exécution Step Functions

L’identifiant de l’action est aws.stepFunctions.redriveExecution.

Relance une exécution Step Functions ayant échoué, ayant expiré ou ayant été abandonnée, en la reprenant à partir du dernier état infructueux sans recommencer depuis le début.

Important

Cette action est prise en charge uniquement sur les machines d’état STANDARD. Une exécution ne peut être relancée que si elle n’a pas SUCCEEDED, si elle se situe dans les 14 jours suivant son achèvement et si elle compte moins de 24 999 événements d’historique.

Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.

Saisir

Type

Description

Exemple

awsRoleArn

Chaîne

Facultatif.

ARN du rôle IAM à assumer. Recommandé. Prend le pas sur les informations d’identification basées sur des clés lorsque vous fournissez les deux.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne (secret)

Facultatif.

ID de clé d’accès AWS. Doit être transmis en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne (secret)

Facultatif.

Clé d’accès secrète AWS. Doit être transmis en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne (secret)

Facultatif.

Jeton de session AWS pour les identifiants temporaires. Doit être transmis en tant que secret.

${{ :secrets:awsSessionToken }}

région

Chaîne

Obligatoire.

Région AWS où l'exécution a eu lieu.

us-east-1

executionArn

Chaîne

Obligatoire.

ARN de l’exécution à relancer.

arn:aws:states:us-east-1:123456789012:execution:RestartUnhealthyService:incident-42

clientToken

Chaîne

Facultatif.

Jeton d’idempotence pour la requête de redrive. Généré automatiquement par le SDK si omis.

a1b2c3d4-e5f6-7890-abcd-ef1234567890

selectors

List

Facultatif.

Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "redriveDate", "expression": ".response.redriveDate"}]

Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.

Sortir

Type

Description

response

Objet

Réponse de l’API AWS Step Functions.

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

success

Booléen

true

en cas de succès,

false

en cas d’échec.

errorMessage

Chaîne

Message d’erreur si le redrive a échoué.

null

en cas de succès.

L'exemple suivant relance une exécution échouée pour la reprendre à partir de son dernier état d'échec.

Exemple de workflow

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'

Décrire une exécution Step Functions

L’identifiant de l’action est aws.stepFunctions.describeExecution.

Renvoie le statut, l’entrée, la sortie et les horodatages d’une exécution Step Functions. Utilisez cette action pour interroger le résultat d’une exécution démarrée par aws.stepFunctions.startExecution.

Important

Cette action prend en charge directement les exécutions de machine d’état STANDARD. Vous ne pouvez décrire que les exécutions EXPRESS qu’une exécution Map Run a réparties.

Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.

Saisir

Type

Description

Exemple

awsRoleArn

Chaîne

Facultatif.

ARN du rôle IAM à assumer. Recommandé. Prend le pas sur les informations d’identification basées sur des clés lorsque vous fournissez les deux.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne (secret)

Facultatif.

ID de clé d’accès AWS. Doit être transmis en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne (secret)

Facultatif.

Clé d’accès secrète AWS. Doit être transmis en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne (secret)

Facultatif.

Jeton de session AWS pour les identifiants temporaires. Doit être transmis en tant que secret.

${{ :secrets:awsSessionToken }}

région

Chaîne

Obligatoire.

Région AWS où l'exécution a eu lieu.

us-east-1

executionArn

Chaîne

Obligatoire.

ARN de l’exécution à décrire.

arn:aws:states:us-east-1:123456789012:execution:RestartUnhealthyService:incident-42

includedData

Énumération

Facultatif.

Contrôle si la définition de l’exécution est renvoyée. Utilisez

METADATA_ONLY

pour ignorer le déchiffrement de la définition lorsque l’autorisation

kms:Decrypt

n’est pas disponible. Par défaut

ALL_DATA

.

ALL_DATA

ou

METADATA_ONLY

selectors

List

Facultatif.

Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "status", "expression": ".response.status"}]

Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.

Sortir

Type

Description

response

Objet

Détails de l’exécution provenant de l’API AWS Step Functions. Sur les exécutions FAILED, TIMED_OUT ou ABORTED, output est absent et l’API renseigne error / cause à la place. redriveStatus indique si l’exécution peut être relancée.

{
  "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

Booléen

true

en cas de succès,

false

en cas d’échec.

errorMessage

Chaîne

Message d’erreur si la requête a échoué.

null

en cas de succès.

L’exemple suivant interroge le statut d’une exécution et capture la sortie pour les étapes en aval.

Exemple de workflow

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'

Lister les exécutions Step Functions

L’identifiant de l’action est aws.stepFunctions.listExecutions.

Répertorie les exécutions d’une machine à états AWS Step Functions ou d’une exécution Map Run, éventuellement filtrées par statut. Les résultats sont triés du plus récent au plus ancien.

Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.

Saisir

Type

Description

Exemple

awsRoleArn

Chaîne

Facultatif.

ARN du rôle IAM à assumer. Recommandé. Prend le pas sur les informations d’identification basées sur des clés lorsque vous fournissez les deux.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne (secret)

Facultatif.

ID de clé d’accès AWS. Doit être transmis en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne (secret)

Facultatif.

Clé d’accès secrète AWS. Doit être transmis en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne (secret)

Facultatif.

Jeton de session AWS pour les identifiants temporaires. Doit être transmis en tant que secret.

${{ :secrets:awsSessionToken }}

région

Chaîne

Obligatoire.

Région AWS dans laquelle lister les exécutions.

us-east-1

stateMachineArn

Chaîne

Facultatif.

ARN de la machine à états dont il faut lister les exécutions. Fournissez ceci ou

mapRunArn

, pas les deux. Les machines à états

EXPRESS

ne peuvent pas être listées directement : utilisez plutôt

mapRunArn

pour lister leurs exécutions enfants à partir d'un Distributed Map.

arn:aws:states:us-east-1:123456789012:stateMachine:RestartUnhealthyService

mapRunArn

Chaîne

Facultatif.

ARN de l’exécution Map dont il faut lister les exécutions enfants. Fournissez ceci ou

stateMachineArn

, pas les deux. Requis lors de l’utilisation de

statusFilter: PENDING_REDRIVE

.

arn:aws:states:us-east-1:123456789012:mapRun:MyStateMachine/abcd1234

statusFilter

Énumération

Facultatif.

Filtrer les exécutions par statut.

PENDING_REDRIVE

nécessite

mapRunArn

.

RUNNING

|

SUCCEEDED

|

FAILED

|

TIMED_OUT

|

ABORTED

|

PENDING_REDRIVE

maxResults

Int

Facultatif.

Nombre maximum d’exécutions à renvoyer. Par défaut 100, maximum 1000.

20

nextToken

Chaîne

Facultatif.

Jeton de pagination du

response.nextToken

d’un appel précédent. Expire après 24 heures.

AQICAHi...

redriveFilter

Énumération

Facultatif.

Filtrer les exécutions selon qu’elles ont été réexécutées.

REDRIVEN

ou

NOT_REDRIVEN

selectors

List

Facultatif.

Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "executions", "expression": ".response.executions"}]

Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.

Sortir

Type

Description

response

Objet

Liste des exécutions provenant de l’API AWS Step Functions. nextToken est présent uniquement lorsque d’autres pages sont disponibles : transmettez-le en tant que nextToken lors d’un appel ultérieur pour récupérer la page suivante.

{
  "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

Booléen

true

en cas de succès,

false

en cas d’échec.

errorMessage

Chaîne

Message d’erreur si la requête a échoué.

null

en cas de succès.

L'exemple suivant liste les exécutions en cours pour une machine à états.

Exemple de workflow

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'

Décrire une machine à états

L’identifiant de l’action est aws.stepFunctions.describeStateMachine.

Renvoie la définition, le rôle IAM, la configuration de logging, le type (STANDARD ou EXPRESS), et le statut d'une machine à états AWS Step Functions.

Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.

Saisir

Type

Description

Exemple

awsRoleArn

Chaîne

Facultatif.

ARN du rôle IAM à assumer. Recommandé. Prend le pas sur les informations d’identification basées sur des clés lorsque vous fournissez les deux.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne (secret)

Facultatif.

ID de clé d’accès AWS. Doit être transmis en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne (secret)

Facultatif.

Clé d’accès secrète AWS. Doit être transmis en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne (secret)

Facultatif.

Jeton de session AWS pour les identifiants temporaires. Doit être transmis en tant que secret.

${{ :secrets:awsSessionToken }}

région

Chaîne

Obligatoire.

Région AWS où la machine à états est déployée.

us-east-1

stateMachineArn

Chaîne

Obligatoire.

ARN de la machine à états à décrire. Accepte également un ARN de version.

arn:aws:states:us-east-1:123456789012:stateMachine:RestartUnhealthyService

includedData

Énumération

Facultatif.

Utilisez

METADATA_ONLY

pour ignorer le renvoi de la définition de la machine d’état et éviter d’avoir besoin de

kms:Decrypt

lorsque la définition est chiffrée par KMS. Par défaut

ALL_DATA

.

ALL_DATA

ou

METADATA_ONLY

selectors

List

Facultatif.

Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "type", "expression": ".response.type"}]

Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.

Sortir

Type

Description

response

Objet

Détails de la machine à états provenant de l’API AWS Step Functions. Le champ type (STANDARD ou EXPRESS) est utile pour la logique de branchement, par exemple pour déterminer si stopExecution ou redriveExecution sont applicables.

{
  "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

Booléen

true

en cas de succès,

false

en cas d’échec.

errorMessage

Chaîne

Message d’erreur si la requête a échoué.

null

en cas de succès.

L’exemple suivant récupère le type et la définition d’une machine à états.

Exemple de workflow

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'

Lister les machines à états

L’identifiant de l’action est aws.stepFunctions.listStateMachines.

Répertorie les machines à états AWS Step Functions dans un compte et une région. Utilisez les entrées de pagination pour récupérer de grands ensembles de résultats.

Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.

Saisir

Type

Description

Exemple

awsRoleArn

Chaîne

Facultatif.

ARN du rôle IAM à assumer. Recommandé. Prend le pas sur les informations d’identification basées sur des clés lorsque vous fournissez les deux.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne (secret)

Facultatif.

ID de clé d’accès AWS. Doit être transmis en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne (secret)

Facultatif.

Clé d’accès secrète AWS. Doit être transmis en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne (secret)

Facultatif.

Jeton de session AWS pour les identifiants temporaires. Doit être transmis en tant que secret.

${{ :secrets:awsSessionToken }}

région

Chaîne

Obligatoire.

Région AWS dans laquelle lister les machines à états.

us-east-1

maxResults

Int

Facultatif.

Nombre maximal de machines à états à retourner. Par défaut 100, maximum 1000.

50

nextToken

Chaîne

Facultatif.

Jeton de pagination du

response.nextToken

d’un appel précédent. Expire après 24 heures.

AQICAHi...

selectors

List

Facultatif.

Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "stateMachines", "expression": ".response.stateMachines"}]

Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.

Sortir

Type

Description

response

Objet

Liste des machines à états de l'API AWS Step Functions. nextToken est présent uniquement lorsque d’autres pages sont disponibles : transmettez-le en tant que nextToken lors d’un appel ultérieur pour récupérer la page suivante.

{
  "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

Booléen

true

en cas de succès,

false

en cas d’échec.

errorMessage

Chaîne

Message d’erreur si la requête a échoué.

null

en cas de succès.

L’exemple suivant liste les machines à états du compte et capture le résultat pour les étapes en aval.

Exemple de workflow

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'

Et ensuite ?

Pour continuer à travailler avec les actions AWS et Workflow Automation, consultez les ressources suivantes.

Droits d'auteur © 2026 New Relic Inc.
RecrutementConditions de servicePolitique DMCAAvis de confidentialitéWebsite TermsAvis de brevetLoi sur l'esclavage moderne

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.