Actions, ressources et clés de condition pour AWS Step Functions - Référence de l'autorisation de service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Actions, ressources et clés de condition pour AWS Step Functions

AWS Step Functions (préfixe de service :states) fournit les ressources, actions et clés contextuelles de condition spécifiques au service suivantes à utiliser dans IAM les politiques d'autorisation.

Références :

Actions définies par AWS Step Functions

Vous pouvez spécifier les actions suivantes dans l'Actionélément d'une déclaration de IAM politique. Utilisez des politiques pour accorder des autorisations permettant d'effectuer une opération dans AWS. Lorsque vous utilisez une action dans une politique, vous autorisez ou refusez généralement l'accès à l'APIopération ou à la CLI commande portant le même nom. Toutefois, dans certains cas, une seule action contrôle l'accès à plusieurs opérations. D'autres opérations, quant à elles, requièrent plusieurs actions différentes.

La colonne Types de ressources indique si chaque action prend en charge les autorisations au niveau des ressources. S'il n'y a pas de valeur pour cette colonne, vous devez indiquer toutes les ressources (« * ») dans l'élément Resource de votre déclaration de politique. Si la colonne inclut un type de ressource, vous pouvez spécifier un type ARN de ressource de ce type dans une instruction comportant cette action. Si l'action comporte une ou plusieurs ressources requises, l'appelant doit être autorisé à utiliser l'action avec ces ressources. Les ressources requises sont indiquées dans le tableau par un astérisque (*). Si vous limitez l'accès aux ressources avec l'Resourceélément d'une IAM politique, vous devez inclure un modèle ARN ou pour chaque type de ressource requis. Certaines actions prennent en charge plusieurs types de ressources. Si le type de ressource est facultatif (non indiqué comme obligatoire), vous pouvez choisir d'utiliser l'un, mais pas l'autre.

La colonne Clés de condition inclut des clés que vous pouvez spécifier dans l'élément Condition d'une déclaration de politique. Pour plus d'informations sur les clés de condition associées aux ressources du service, consultez la colonne Clés de condition du tableau des types de ressources.

Note

Les clés de condition des ressources sont répertoriées dans le tableau Types de ressources. Vous pouvez trouver un lien vers le type de ressource qui s'applique à une action dans la colonne Types de ressources (* obligatoire) du tableau Actions. Le type de ressource indiqué dans le tableau Types de ressources inclut la colonne Clés de condition, qui contient les clés de condition de ressource qui s'appliquent à une action dans le tableau Actions.

Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Actions.

Actions Description Niveau d'accès Types de ressources (*obligatoire) Clés de condition Actions dépendantes
CreateActivity Accorde l'autorisation de créer une activité Écriture

activity*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateStateMachine Accorde l'autorisation de créer une machine d'état Écrire

statemachine*

iam:PassRole

states:PublishStateMachineVersion

aws:RequestTag/${TagKey}

aws:TagKeys

CreateStateMachineAlias Accorde l'autorisation de créer un alias de machine d'état Écrire

statemachine*

states:StateMachineQualifier

DeleteActivity Accorde l'autorisation de supprimer une activité Écriture

activity*

DeleteStateMachine Accorde l'autorisation de supprimer une machine d'état Écrire

statemachine*

DeleteStateMachineAlias Accorde l'autorisation de supprimer un alias de machine d'état Écrire

statemachine*

states:StateMachineQualifier

DeleteStateMachineVersion Accorde l'autorisation de supprimer une version de machine d'état Écrire

statemachine*

states:StateMachineQualifier

DescribeActivity Accorde l'autorisation de décrire une activité Lecture

activity*

DescribeExecution Accorde l'autorisation de décrire une exécution Lecture

execution*

express*

DescribeMapRun Accorde l'autorisation de décrire une exécution cartographique Lecture

maprun*

DescribeStateMachine Accorde l'autorisation de décrire une machine d'état Lecture

statemachine*

states:StateMachineQualifier

DescribeStateMachineAlias Accorde l'autorisation de décrire un alias de machine d'état Lecture

statemachine*

states:StateMachineQualifier

DescribeStateMachineForExecution Accorde l'autorisation de décrire la machine d'état d'une exécution Lecture

execution*

GetActivityTask Accorde l'autorisation d'être utilisée par les travailleurs pour récupérer une tâche (avec l'activité spécifiéeARN) dont l'exécution a été planifiée par une machine à états en cours d'exécution Écrire

activity*

GetExecutionHistory Accorde l'autorisation de renvoyer l'historique de l'exécution spécifiée sous la forme d'une liste d'événements Lecture

execution*

InvokeHTTPEndpoint [autorisation uniquement] Accorde l'autorisation d'invoquer l'état de la HTTP tâche Écrire
ListActivities Accorde l'autorisation d'énumérer les activités existantes Liste
ListExecutions Accorde l'autorisation de répertorier les exécutions d'une machine d'état Liste

maprun*

statemachine*

states:StateMachineQualifier

ListMapRuns Accorde l'autorisation de répertorier les exécutions cartographiques d'une exécution Liste

execution*

ListStateMachineAliases Accorde l'autorisation de répertorier les alias d'une machine d'état Liste

statemachine*

states:StateMachineQualifier

ListStateMachineVersions Accorde l'autorisation de répertorier les versions d'une machine d'état Liste

statemachine*

ListStateMachines Accorde l'autorisation de répertorier les machines d'état existantes Liste
ListTagsForResource Accorde l'autorisation de répertorier les tags d'une ressource AWS Step Functions Liste

activity

statemachine

PublishStateMachineVersion Accorde l'autorisation de publier une version de machine d'état Écrire

statemachine*

RedriveExecution Accorde l'autorisation de rediriger une exécution Écrire

execution*

RevealSecrets [autorisation uniquement] Octroie l'autorisation de révéler les données sensibles issues d'une exécution. Lecture
SendTaskFailure Accorde l'autorisation de signaler que la tâche identifiée par l' taskToken échec Écrire
SendTaskHeartbeat Accorde l'autorisation de signaler au service que la tâche représentée par le paramètre spécifié taskToken est toujours en cours d'avancement Écrire
SendTaskSuccess Accorde l'autorisation de signaler que la tâche identifiée par le est taskToken terminée avec succès Écrire
StartExecution Accorde l'autorisation de démarrer l'exécution d'une machine d'état Écriture

statemachine*

states:StateMachineQualifier

StartSyncExecution Accorde l'autorisation de démarrer une machine d'état Synchronous Express Écriture

statemachine*

states:StateMachineQualifier

StopExecution Accorde l'autorisation d'arrêter une exécution Écrire

execution*

TagResource Accorde l'autorisation de baliser une ressource AWS Step Functions Identification

activity

statemachine

aws:TagKeys

aws:RequestTag/${TagKey}

TestState Octroie l'autorisation de tester la définition d'une machine d'état. Écrire

states:RevealSecrets

UntagResource Accorde l'autorisation de supprimer un tag d'une ressource AWS Step Functions Identification

activity

statemachine

aws:TagKeys

UpdateMapRun Accorde l'autorisation de mettre à jour une exécution cartographique Écrire

maprun*

UpdateStateMachine Accorde l'autorisation de mettre à jour une machine d'état Écrire

statemachine*

iam:PassRole

states:PublishStateMachineVersion

aws:RequestTag/${TagKey}

aws:TagKeys

UpdateStateMachineAlias Accorde l'autorisation de mettre à jour un alias de machine d'état Écrire

statemachine*

states:StateMachineQualifier

ValidateStateMachineDefinition Accorde l'autorisation de valider une définition de machine à états Lecture

Types de ressources définis par AWS Step Functions

Les types de ressources suivants sont définis par ce service et peuvent être utilisés dans l'Resourceélément des déclarations de politique d'IAMautorisation. Chaque action du tableau Actions identifie les types de ressources pouvant être spécifiés avec cette action. Un type de ressource peut également définir les clés de condition que vous pouvez inclure dans une politique. Ces clés sont affichées dans la dernière colonne du tableau. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Types de ressources.

Types de ressources ARN Clés de condition
activity arn:${Partition}:states:${Region}:${Account}:activity:${ActivityName}

aws:ResourceTag/${TagKey}

execution arn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}:${ExecutionId}

aws:ResourceTag/${TagKey}

express arn:${Partition}:states:${Region}:${Account}:express:${StateMachineName}:${ExecutionId}:${ExpressId}
statemachine arn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName}

aws:ResourceTag/${TagKey}

statemachineversion arn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName}:${StateMachineVersionId}
statemachinealias arn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName}:${StateMachineAliasName}
maprun arn:${Partition}:states:${Region}:${Account}:mapRun:${StateMachineName}/${MapRunLabel}:${MapRunId}
labelled execution arn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}/${MapRunLabel}:${ExecutionId}
labelled express arn:${Partition}:states:${Region}:${Account}:express:${StateMachineName}/${MapRunLabel}:${ExecutionId}:${ExpressId}

Clés de condition pour AWS Step Functions

AWS Step Functions définit les clés de condition suivantes qui peuvent être utilisées dans l'Conditionélément d'une IAM politique. Vous pouvez utiliser ces clés pour affiner les conditions d'application de la déclaration de politique. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Clés de condition.

Pour afficher les clés de condition globales disponibles pour tous les services, consultez Clés de condition globales disponibles.

Clés de condition Description Type
aws:RequestTag/${TagKey} Filtre l'accès en fonction de la paire de clés et de valeurs d'identification autorisée dans la demande. Chaîne
aws:ResourceTag/${TagKey} Filtre l'accès en fonction de la paire de clé et de valeur d'identification d'une ressource. Chaîne
aws:TagKeys Filtre l'accès en fonction d'une liste de clés d'identification autorisées dans la demande. ArrayOfString
states:HTTPEndpoint Filtre l'accès en fonction du point de terminaison autorisé par l'état de la HTTP tâche dans la demande Chaîne
states:HTTPMethod Filtre l'accès selon la méthode autorisée par l'état de la HTTP tâche dans la demande Chaîne
states:StateMachineQualifier Filtre l'accès en fonction du qualificatif d'une machine à états ARN ArrayOfString