ByCloud Docs

List STS sessions

bycloud iam sts-sessions list [flags]

List active and recent STS (role assumption) sessions for the current organization. Requires `iam:ListSTSSessions` permission.

Options

--active_only

booleanoptional

Only show active (non-expired, non-revoked) sessions

Default: true

--limit

integeroptional

Maximum number of items to return

Default: 20

--marker

stringoptional

ID of the last item from the previous page (for pagination)

--output

(-o)

stringoptional

Output format: text, json, or yaml

Values: "text", "json", "yaml"

Default: "text"

--principal_id

stringoptional

Filter by principal ID (user or service account)

--principal_type

stringoptional

Filter by principal type

Values: "user", "service_account"

--role_id

stringoptional

Filter by role ID

Command

bycloud iam sts-sessions list

Output

ID                              ORGANIZATION_ID                 ROLE_ID                         ROLE_NAME  PRINCIPAL_ID                  
550e8400-e29b-41d4-a716-446655  550e8400-e29b-41d4-a716-446655  550e8400-e29b-41d4-a716-446655  string     550e8400-e29b-41d4-a716-446655
550e8400-e29b-41d4-a716-446655  550e8400-e29b-41d4-a716-446655  550e8400-e29b-41d4-a716-446655  string     550e8400-e29b-41d4-a716-446655