AWSStepFunctionsReadOnlyAccess

ReaderAWS managedActivePermissions reviewedShow on map Compare

Summary

An access policy for providing a user/role/etc read only access to the AWS StepFunctions service.

Permissions imported from the AWS Managed Policy Reference Guide; other sections pending editorial review.

Identity

ARN: arn:aws:iam::aws:policy/AWSStepFunctionsReadOnlyAccess
Default version: v4
Created: 2017-01-11
Last edited: 2024-04-26
Services: states

Control-plane actions (15)

By access level: 7 List, 8 Read.

Control-plane actions by service
Service	Granted	Access levels and limits	Granted by
Step Functions	15 of 37	7 List, 8 Read; 0 restricted, 0 conditional	states:DescribeActivity, states:DescribeExecution, states:DescribeMapRun, states:DescribeStateMachine, states:DescribeStateMachineAlias, states:DescribeStateMachineForExecution, states:GetExecutionHistory, states:ListActivities, states:ListExecutions, states:ListMapRuns, states:ListStateMachineAliases, states:ListStateMachineVersions and 3 more

Step Functions: 15 actions

states:DescribeActivity (Read)
states:DescribeExecution (Read)
states:DescribeMapRun (Read)
states:DescribeStateMachine (Read)
states:DescribeStateMachineAlias (Read)
states:DescribeStateMachineForExecution (Read)
states:GetExecutionHistory (Read)
states:ListActivities (List)
states:ListExecutions (List)
states:ListMapRuns (List)
states:ListStateMachineAliases (List)
states:ListStateMachineVersions (List)
states:ListStateMachines (List)
states:ListTagsForResource (List)
states:ValidateStateMachineDefinition (Read)

Data-plane actions (0)

By access level: none.

This policy grants no actions in this plane.

Excluded and conditional actions

No patterns are excluded by NotAction or Deny statements.

Resource scope and attachment

Resource scope across granted actions: all-resources.

Can be attached: Yes, to users, groups and roles.

Why this tier

Grants only List and Read actions.

Guidance

Pending editorial review. The permission data on this page comes straight from AWS; this section will be filled in once a reviewed guide exists.

Same service

Same domain

Frequently asked questions

Pending editorial review. The permission data on this page comes straight from AWS; this section will be filled in once a reviewed guide exists.

Policy JSON

Download policy.json

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "ReadOnlyAccess",
      "Effect": "Allow",
      "Action": [
        "states:ListStateMachines",
        "states:ListActivities",
        "states:DescribeStateMachine",
        "states:DescribeStateMachineForExecution",
        "states:ListExecutions",
        "states:DescribeExecution",
        "states:GetExecutionHistory",
        "states:DescribeActivity",
        "states:ListTagsForResource",
        "states:DescribeMapRun",
        "states:ListMapRuns",
        "states:DescribeStateMachineAlias",
        "states:ListStateMachineAliases",
        "states:ListStateMachineVersions",
        "states:ValidateStateMachineDefinition"
      ],
      "Resource": "*"
    }
  ]
}

Version history

Current version v4, edited by AWS on 2024-04-26. Version history is recorded from 2026-11-11. Earlier versions are in the IAM console under Policy versions.

Attach snippets

AWS CLI

aws iam attach-role-policy --role-name ROLE_NAME --policy-arn arn:aws:iam::aws:policy/AWSStepFunctionsReadOnlyAccess
aws iam attach-user-policy --user-name USER_NAME --policy-arn arn:aws:iam::aws:policy/AWSStepFunctionsReadOnlyAccess
aws iam attach-group-policy --group-name GROUP_NAME --policy-arn arn:aws:iam::aws:policy/AWSStepFunctionsReadOnlyAccess

CloudFormation

Resources:
  ExampleRole:
    Type: AWS::IAM::Role
    Properties:
      AssumeRolePolicyDocument: {}  # replace with your trust policy
      ManagedPolicyArns:
        - arn:aws:iam::aws:policy/AWSStepFunctionsReadOnlyAccess

Terraform

resource "aws_iam_role_policy_attachment" "awsstepfunctionsreadonlyaccess" {
  role       = aws_iam_role.example.name
  policy_arn = "arn:aws:iam::aws:policy/AWSStepFunctionsReadOnlyAccess"
}

CDK (TypeScript)

role.addManagedPolicy(
  iam.ManagedPolicy.fromAwsManagedPolicyName("AWSStepFunctionsReadOnlyAccess"),
);

Sources

Pending editorial review. No editorial sources are listed yet.