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

Get User Preferences By Query

Description

This API is used for getting user-preferences based on query parameters. If no query parameter is passed then, API will return all available user-preferences for requested user.

Request

Request

URL

URL


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

Query Parameters

Query Parameters

string
include Optional

This will contain comma seperated string values. If the “include” field is passed, the result will contain only the requested field name. The “id” and “name” will be return always irrespective of include fields.


string
parent_id Optional

Id of the parent user-preference. When parent_id is used as query filter, the API will return all user-preference for which the parent_id matches.


string
type Optional

The type user-preference. can query multiple types by comma (,) separted string


Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns array of UserPreference 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
}
string
name Required

Display name for the console.


string
type Required

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.


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

The user responsible for creation of object.


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

This object represent children of user-preference.


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

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


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

Was this page helpful?