Get User Preference By Id

Get User Preference By Id

This API is used for fetching the details of requested user-preference.

Request
URI
GET
https://{api_host}/tcsa.host.com/tcsa/api/configuration-management/v1/user-preferences/{id}
COPY
Path Parameters
string
id
Required

Unique id, to indentify the user-preference

Query Parameters
boolean
expand
Optional

If set to true, response will also return all other user-preference which is having "id" as "parent_id". Default is false.


Authentication
This operation uses the following authentication methods.
Responses
200

Ok

Returns UserPreferenceExpandedResponse of type(s) application/json
{
    "id": "8019c333-1d64-44df-a957-bbb89703ba6a",
    "sequence_number": 349,
    "primary_term": 1,
    "type": "NOTIFICATION_CONSOLE",
    "assign_to": [
        "Operator"
    ],
    "name": "Default notification console",
    "description": "Detailed description about the user-preference",
    "is_predefined": true,
    "is_default": true,
    "parent_id": "string",
    "data": {},
    "created_by": "admin",
    "create_timestamp": 1660635421552,
    "update_timestamp": 1660635421552,
    "sub_preferences": [
        {
            "id": "8019c333-1d64-44df-a957-bbb89703ba6a",
            "sequence_number": 349,
            "primary_term": 1,
            "type": "NOTIFICATION_CONSOLE",
            "assign_to": [
                "Operator"
            ],
            "name": "Default notification console",
            "description": "Detailed description about the user-preference",
            "is_predefined": true,
            "is_default": true,
            "parent_id": "string",
            "data": {},
            "created_by": "admin",
            "sub_preferences": [
                "UserPreference Object"
            ],
            "create_timestamp": 1660635421552,
            "update_timestamp": 1660635421552
        }
    ]
}
string
id
Optional

The id, uniquely identified the user-preference.

integer
sequence_number
Optional

The seq_no and primary_term together, helps to achieve optimized concurrency control. This two field value, must be sent along with update request, if user want to avoid accidental concurrent changes.

integer
primary_term
Optional

The seq_no and primary_term together, helps to achieve optimized concurrency control. This two field value, must be sent along with update request, if user want to avoid accidental concurrent changes.

string
type
Optional

The type user-preference. The below types are supported.

  1. "NOTIFICATION_CONSOLE"
  2. "NOTIFICATION_SUMMARY_CONSOLE"
  3. "TOPOLOGY_CONSOLE"
  4. "COLORS_PREF"
  5. "LOG_VIEWS"
  6. "BAR_CHARTS"
array of string
assign_to
Optional

The console is assigned to which ROLE. For logged in user , this field value will be populated automatically, but if Admin user wants to assign the console to any ROLE then it needs to be sent in the request payload. Non admin user won't be able assign any ROLE.

string
name
Optional

Display name for the console.

string
description
Optional

This is notification console preference, created for admin.

boolean
is_predefined
Optional

system created user preferences.

boolean
is_default
Optional

used to show default user prefereces for user

string
parent_id
Optional

Parent id of the console. In case of the root, value would be null.

object
data
Optional

This will contain all UI specific user-preference details. This is free object and can contain any thing UI wants to store.

string
created_by
Optional

The user responsible for creation of object.

number
create_timestamp
Optional

Timestamp in epoch milliseconds, notifies the value when user preference is created

number
update_timestamp
Optional

Timestamp in epoch milliseconds, notifies the value when user preference is updated

sub_preferences
Optional

Contains all child preferences. This is optional field and will only be returned when "expand" is set to true in request.


401

Unauthorized

Operation doesn't return any data structure

404

Resource not found

Operation doesn't return any data structure

500

Internal server error

Operation doesn't return any data structure