[{"label":"Latest (2.0.1)","version":"latest"}]
telco-cloud-service-assurance

Get User Preference By ID

Description

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

Request

Request

URL

URL


get
https://{api_host}tcsa.host.com/tcsa/api/configuration-management/v1/user-preferences/{id}
Copy

Path Parameters

Path Parameters

string
id Required

Unique id, to indentify the user-preference


Query Parameters

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

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns UserPreferenceExpandedResponse of type application/json
{
    "create_timestamp": 1660635421552,
    "created_by": "admin",
    "description": "Detailed description about the user-preference",
    "id": "8019c333-1d64-44df-a957-bbb89703ba6a",
    "is_default": true,
    "is_predefined": true,
    "name": "Default notification console",
    "parent_id": "",
    "primary_term": 1,
    "sequence_number": 349,
    "type": "NOTIFICATION_CONSOLE",
    "update_timestamp": 1660635421552
}
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.


number
create_timestamp Optional

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


string
created_by Optional

The user responsible for creation of object.


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
description Optional

This is notification console preference, created for admin.


string
id Optional

The id, uniquely identified the user-preference.


boolean
is_default Optional

used to show default user prefereces for user


boolean
is_predefined Optional

system created user preferences.


string
name Optional

Display name for the console.


string
parent_id Optional

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


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.


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.


array of UserPreference
sub_preferences Optional

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


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”


number
update_timestamp Optional

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

Errors

Errors

401

Unauthorized


404

Resource not found


500

Internal server error

Code Samples

Code Samples

cURL Command

curl https://{api_host}tcsa.host.com/tcsa/api/configuration-management/v1/user-preferences/{id}


Feedback

Was this page helpful?