---
title: "List user actions"
method: GET
path: "/cloud/v1/user_actions"
tags: ["User Actions"]
---

# List user actions

`GET /cloud/v1/user_actions`

Retrieve user action log for one client or a set of projects

## Query parameters

- `action_type` CloudActionType[] — User action type. Several options can be specified.
- `api_group` string[] — API group that requested action belongs to. Several options can be specified.
- `from_timestamp` string, date-time — ISO formatted datetime string. Starting timestamp from which user actions are requested
- `limit` integer — Optional. Limit the number of returned items
- `offset` integer — Optional. Offset value is used to exclude the first set of records from the result
- `order_by` 'asc' | 'desc'
- `project_id` integer[] — Project ID. Several options can be specified.
- `region_id` integer[] — Region ID. Several options can be specified.
- `resource_id` string[] — Resource ID. Several options can be specified.
- `search_field` string — Extra search field for common object properties such as name, IP address, or other, depending on the `resource_type`
- `sorting` 'asc' | 'desc'
- `source_user_ips` string[] — Originating IP address of the client making the request. Several options can be specified.
- `to_timestamp` string, date-time — ISO formatted datetime string. Ending timestamp until which user actions are requested
- `user_agents` string[] — User-Agent string identifying the client making the request. Several options can be specified.

## Response `200`

OK

- UserActionCollectionSerializer
  - `count` integer, required — Number of objects
  - `results` UserActionSerializer[], required — Objects
    - `acknowledged` boolean, required — User action log was successfully received by its subscriber in case there is one
    - `action_data` object, nullable, required — Additional information about the action
    - `action_type` 'activate' | 'attach' | 'change_logging_resources' | 'create' | 'create_access_rule' | 'deactivate' | 'delete' | 'delete_access_rule' | 'delete_metadata' | 'detach' | 'disable_logging' | 'disable_portsecurity' | 'download' | 'enable_logging' | 'enable_portsecurity' | 'failover' | 'put_into_servergroup' | 'reboot' | 'reboot_hard' | 'rebuild' | 'regenerate_credentials' | 'remove_from_servergroup' | 'replace' | 'replace_metadata' | 'resize' | 'resume' | 'retype' | 'revert' | 'scale_down' | 'scale_up' | 'start' | 'stop' | 'suspend' | 'update' | 'update_metadata' | 'upgrade', required
    - `api_group` 'ai_cluster' | 'caas_container' | 'caas_key' | 'caas_pull_secret' | 'dbaas_postgres' | 'ddos_profile' | 'faas_function' | 'faas_key' | 'faas_namespace' | 'file_shares' | 'floating_ip' | 'image' | 'inference_at_the_edge' | 'instance' | 'instance_isolation' | 'k8s_cluster' | 'k8s_cluster_template' | 'k8s_pool' | 'laas' | 'laas_topic' | 'lb_health_monitor' | 'lb_l7policy' | 'lb_l7rule' | 'lblistener' | 'lbpool' | 'lbpool_member' | 'lifecycle_policy' | 'lifecycle_policy_volume_member' | 'loadbalancer' | 'network' | 'port' | 'project' | 'quota_limit_request' | 'registry' | 'reservation' | 'reserved_fixed_ip' | 'role' | 'router' | 'secret' | 'securitygroup' | 'securitygrouprule' | 'servergroup' | 'shared_flavor' | 'shared_image' | 'shared_network' | 'snapshot' | 'snapshot_schedule' | 'ssh_key' | 'subnet' | 'user' | 'vip_ip_addresses' | 'volume', required — API group
    - `client_id` integer, nullable, required — Client ID of the user.
    - `email` string, email, nullable, required — User email address
    - `id` string, required — User action ID
    - `is_complete` boolean, required — User action was filled with all necessary information. If false, then something went wrong during user action creation or update
    - `issued_by_user_id` integer, nullable, required — User ID who issued the token that made the request
    - `project_id` integer, nullable, required — Project ID
    - `region_id` integer, nullable, required — Region ID
    - `resources` UserActionResourceSerializer[], required — Resources
      - `resource_body` object, nullable — Free-form object, resource body.
      - `resource_id` string, required — Resource ID
      - `resource_type` 'caas_container' | 'caas_key' | 'caas_pull_secret' | 'dbaas_postgres' | 'ddos_profile' | 'external_ip' | 'faas_function' | 'faas_key' | 'faas_namespace' | 'file_shares' | 'floating_ip' | 'gpu_baremetal_server' | 'gpu_virtual_server' | 'gpuai_cluster' | 'image' | 'inference_api_key' | 'inference_application' | 'inference_instance' | 'inference_registry_credentials' | 'inference_secret' | 'instance' | 'ipu_cluster' | 'k8s_cluster' | 'k8s_cluster_template' | 'k8s_pool' | 'laas' | 'laas_topic' | 'lb_health_monitor' | 'lb_l7policy' | 'lb_l7rule' | 'lblistener' | 'lbpool' | 'lbpool_member' | 'lifecycle_policy' | 'lifecycle_policy_volume_member' | 'loadbalancer' | 'network' | 'port' | 'project' | 'quota_limit_request' | 'registry' | 'registry_repository' | 'registry_repository_artifact' | 'registry_repository_tag' | 'registry_user' | 'registry_user_sercret' | 'reservation' | 'role' | 'router' | 'secret' | 'securitygroup' | 'securitygrouprule' | 'servergroup' | 'shared_flavor' | 'shared_image' | 'shared_network' | 'snapshot' | 'snapshot_schedule' | 'ssh_key' | 'subnet' | 'token' | 'user' | 'virtual_gpu_cluster' | 'volume', required — Resource type
      - `search_field` string, nullable — Often used property for filtering actions. It can be a name, IP address, or other property, depending on the `resource_type`
    - `source_user_ip` string, nullable, required — User IP that made the request
    - `task_id` string, nullable, required — Task ID
    - `timestamp` string, date-time, required — Datetime. Action timestamp
    - `token_id` integer, nullable, required — Token ID
    - `total_price` UserActionResourcePriceSerializer, required
      - `currency_code` string, nullable, required — Currency code (3 letter code per ISO 4217)
      - `price_per_hour` number, nullable, required — Total price VAT inclusive per hour
      - `price_per_month` number, nullable, required — Total price VAT inclusive per month (30 days)
      - `price_status` 'error' | 'hide' | 'show', required
    - `user_agent` string, nullable, required — User-Agent that made the request
    - `user_id` integer, required — User ID

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)