G-g-core
User Actions

List user actions

Changed on

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

get/cloud/v1/user_actions

Request

  • Base URL
    https://api.gcore.com
  • URL
    https://api.gcore.com/cloud/v1/user_actions
  • Auth
    HTTP apikey

Query parameters

action_typeCloudActionType[]

User action type. Several options can be specified.

[
  "activate",
  "delete"
]
api_groupstring[]

API group that requested action belongs to. Several options can be specified.

[
  "ai_cluster",
  "image"
]
from_timestampstring date-time

ISO formatted datetime string. Starting timestamp from which user actions are requested

Example:2019-11-14T10:30:32Z
limitinteger

Optional. Limit the number of returned items

Example:1000
offsetinteger

Optional. Offset value is used to exclude the first set of records from the result

order_by'asc' | 'desc'

Sorting by timestamp. Oldest first, or most recent first

project_idinteger[]

Project ID. Several options can be specified.

[
  1,
  2,
  3
]
region_idinteger[]

Region ID. Several options can be specified.

[
  1,
  2,
  3
]
resource_idstring[]

Resource ID. Several options can be specified.

search_fieldstring

Extra search field for common object properties such as name, IP address, or other, depending on the resource_type

Example:default
sorting'asc' | 'desc'

(DEPRECATED Use 'order_by' instead) Sorting by timestamp. Oldest first, or most recent first

source_user_ipsstring[]

Originating IP address of the client making the request. Several options can be specified.

[
  "203.0.113.42",
  "192.168.1.100"
]
to_timestampstring date-time

ISO formatted datetime string. Ending timestamp until which user actions are requested

Example:2019-11-14T10:30:32Z
user_agentsstring[]

User-Agent string identifying the client making the request. Several options can be specified.

[
  "Mozilla/5.0",
  "MyApp/1.0.0"
]

Response

OK

countinteger required

Number of objects

Example response

{
  "count": 1,
  "results": [
    {
      "acknowledged": true,
      "api_group": "project",
      "client_id": 10,
      "email": "user@example.com",
      "id": "123",
      "is_complete": true,
      "issued_by_user_id": 222324,
      "project_id": 1,
      "region_id": 4,
      "resources": [
        {
          "resource_body": {
            "key": "value"
          },
          "resource_id": "1234",
          "resource_type": "project",
          "search_field": "name"
        }
      ],
      "source_user_ip": "1.2.3.4",
      "task_id": "1bdcc138-e716-41ff-ad8d-3477a7ac6d14",
      "timestamp": "2019-11-14T10:30:32+00:00",
      "token_id": 192021,
      "total_price": {
        "currency_code": "USD",
        "price_per_hour": 0.01,
        "price_per_month": 7.2
      },
      "user_agent": "Mozilla/5.0",
      "user_id": 789
    }
  ]
}

Changes

  • a2b772345f3aRevision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 2cb8e0be6c72Revision changes
    • warning

      added the new get_certificate enum value to the // response property for the response status

    • warning

      added the new get_console enum value to the // response property for the response status

    • warning

      added the new get_kubeconfig enum value to the // response property for the response status

    • warning

      added the new get_logs enum value to the // response property for the response status

    • warning

      added the new slurm enum value to the // response property for the response status

    • warning

      added the new slurm_cluster enum value to the //// response property for the response status

    • warning

      added the new slurm_node_set enum value to the //// response property for the response status

    • info

      added the enum value get_certificate to the property items/ of the query request parameter action_type

    • info

      added the enum value get_console to the property items/ of the query request parameter action_type

    • info

      added the enum value get_kubeconfig to the property items/ of the query request parameter action_type

    • info

      added the enum value get_logs to the property items/ of the query request parameter action_type

    • info

      added the enum value slurm to the property items/ of the query request parameter api_group