Skip to main content
FuseFuse
IntegrationsAwsActions

List IAM roles

List IAM role summaries with optional path prefix and opaque cursor pagination. Requires iam:ListRoles.

Agent markdown

iam.roles.list · AWS · v1

Details

Risk
Read
Idempotency
Safe
Availability
Default
Exposure
REST, SDK, MCP
MCP hints
readOnly=true, destructive=false, idempotent=true, openWorld=true

Scopes

  • iam:ListRoles

Input

Input schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
path_prefixstringNominLength 1; maxLength 512; pattern ^/$|^/[\x21-\x7e]+/$
page_sizeintegerNominimum 1; maximum 1000
cursorstringNominLength 1; maxLength 16384; pattern ^(?!.*://)[^\x00-\x1f\x7f]+$

Output

Output schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
rolesarray<object>YesmaxItems 1000
roles[]objectYesadditionalProperties false
roles[].namestringYesminLength 1; maxLength 64; pattern ^[A-Za-z0-9_+=,.@-]+$
roles[].idstringYesminLength 1; maxLength 128
roles[].arnstringYesminLength 20; maxLength 2048; pattern ^arn:aws:.+$
roles[].pathstringYesminLength 1; maxLength 512; pattern ^/$|^/[\x21-\x7e]+/$
roles[].created_atstringYesminLength 1; maxLength 64
next_cursorstringNominLength 1; maxLength 16384; pattern ^(?!.*://)[^\x00-\x1f\x7f]+$

Raw schema

Input
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "path_prefix": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "pattern": "^/$|^/[\\x21-\\x7e]+/$"
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16384,
      "pattern": "^(?!.*://)[^\\x00-\\x1f\\x7f]+$"
    }
  }
}
Output
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "roles": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "pattern": "^[A-Za-z0-9_+=,.@-]+$"
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          },
          "arn": {
            "type": "string",
            "minLength": 20,
            "maxLength": 2048,
            "pattern": "^arn:aws:.+$"
          },
          "path": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "pattern": "^/$|^/[\\x21-\\x7e]+/$"
          },
          "created_at": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          }
        },
        "required": [
          "name",
          "id",
          "arn",
          "path",
          "created_at"
        ]
      },
      "maxItems": 1000
    },
    "next_cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16384,
      "pattern": "^(?!.*://)[^\\x00-\\x1f\\x7f]+$"
    }
  },
  "required": [
    "roles"
  ]
}