ByCloud Docs
GuidesCLIAPISDK

List audit logs

bycloud iam audit-logs list [flags]

List audit logs for the current organization with filtering and pagination. Requires `audit:ListLogs` permission.

Options

--action

stringoptional

Filter by action (exact match or prefix with wildcard, e.g., "iam.*")

--actor_id

stringoptional

Filter by actor ID (user or service account)

--actor_type

stringoptional

Filter by actor type

Values: "user", "service_account", "system"

--from

stringoptional

Filter logs from this timestamp (inclusive)

--ip_address

stringoptional

Filter by IP address

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

--resource_id

stringoptional

Filter by resource ID

--resource_type

stringoptional

Filter by resource type

--status

stringoptional

Filter by status

Values: "success", "failure", "denied"

--to

stringoptional

Filter logs until this timestamp (exclusive)

Command

bycloud iam audit-logs list

Output

ID                              TIMESTAMP             ACTOR_ID                        ACTOR_TYPE  ACTOR_NAME
550e8400-e29b-41d4-a716-446655  2024-01-15T10:30:00Z  550e8400-e29b-41d4-a716-446655  user        string    
550e8400-e29b-41d4-a716-446655  2024-01-15T10:30:00Z  550e8400-e29b-41d4-a716-446655  user        string