Update Settings V2
All the listed privileges are required -
Privileges | Description |
---|---|
GLOBAL_CONFIG_MANAGEMENT | Caller should have permission to this privilege, to update settings. |
Request
URI
PUT
https://{api_host}//localhost/rest/config/v2/settings
COPY
Request Body
Configuration settings object to be updated.
SettingsUpdateSpecV2 of type(s) application/json
Required
{
"feature_settings": {
"cloud_managed": true
},
"general_settings": {
"application_sso_timeout_minutes": 30,
"application_sso_timeout_policy": "ENABLED",
"block_restricted_clients": false,
"client_idle_session_timeout_minutes": 300,
"client_idle_session_timeout_policy": "NEVER",
"client_max_session_timeout_minutes": 300,
"client_max_session_timeout_policy": "TIMEOUT_AFTER",
"client_session_timeout_minutes": 300,
"console_session_timeout_minutes": 30,
"display_pre_login_message": false,
"display_warning_before_forced_logoff": true,
"enable_automatic_status_updates": true,
"enable_credential_cleanup_for_htmlaccess": false,
"enable_multi_factor_re_authentication": false,
"enable_sending_domain_list": false,
"enable_server_in_single_user_mode": true,
"forced_logoff_message": "The system will shut down shortly. Please save your work.",
"forced_logoff_timeout_minutes": 3,
"hide_domain_list_in_client": true,
"hide_server_information_in_client": false,
"machine_sso_timeout_minutes": 300,
"machine_sso_timeout_policy": "DISABLED_AFTER",
"pre_login_message": "Disclaimer : This server is being monitored for suspicious activity.",
"restricted_client_data_v2": [
{
"block_specific_versions": [
"3.5,4",
"4.0.1"
],
"type": "WINDOWS",
"version": 7.5,
"warn_specific_versions": [
"7.5,4",
"5.0.2"
]
}
],
"restricted_client_message": "The system does not support this version of the Horizon client.",
"restricted_client_warn_message": "This client version is not recommended. Please upgrade to the latest version.",
"store_cal_on_client": false,
"store_cal_on_connection_server": false
},
"security_settings": {
"data_recovery_password_hash": [
"string"
],
"data_recovery_password_hint": "password hint",
"message_security_mode": "ENABLED",
"re_auth_secure_tunnel_after_interruption": true
}
}
Responses
204
No Content
Operation doesn't return any data structure
400
Bad Request
Operation doesn't return any data structure
401
User is not authenticated
Operation doesn't return any data structure
403
Access to the resource is forbidden
Operation doesn't return any data structure
Config Operations
POST
Create Federation Access Group
POST
Create IC Domain Account
POST
Create IM Asset
POST
Create IM Assets
POST
Create IM Stream
POST
Create IM Streams
POST
Create IM Tag
POST
Create IM Tags
POST
Create IM Version
POST
Create IM Versions
POST
Create JWT Authenticator
POST
Create Local Access Group
POST
Create Permissions
POST
Create Role
DELETE
Delete Federation Access Group
DELETE
Delete IC Domain Account
DELETE
Delete IM Asset
DELETE
Delete IM Stream
DELETE
Delete IM Tag
DELETE
Delete IM Version
DELETE
Delete JWT Authenticator
DELETE
Delete Local Access Group
DELETE
Delete Permissions
DELETE
Delete Role
GET
Get Connection Server
GET
Get Environment
GET
Get Environment V2
GET
Get Feature Settings
GET
Get Federation Access Group
GET
Get Federation Access Group V2
GET
Get General Settings
GET
Get General Settings V2
GET
Get IC Domain Account
GET
Get IM Asset
GET
Get IM Stream
GET
Get IM Tag
GET
Get IM Version
GET
Get JWT Authenticator
GET
Get Local Access Group
GET
Get Local Access Group V2
GET
Get Permission
GET
Get Role
GET
Get Security Settings
GET
Get Settings
GET
Get Settings V2
GET
List Connection Servers
GET
List Federation Access Groups
GET
List Federation Access Groups V2
GET
List IC Domain Accounts
GET
List IM Assets
GET
List IM Streams
GET
List IM Tags
GET
List IM Versions
GET
List JWT Authenticators
GET
List Local Access Groups
GET
List Local Access Groups V2
GET
List Permissions
GET
List RCX Servers
GET
List Roles
GET
List Selectable Privileges
GET
List VC Info
GET
List VC Info V2
POST
Mark Datastores For Archival
POST
Register RCX Client
DELETE
Unregister RCX Client
PUT
Update Connection Server
PUT
Update Feature Settings
PUT
Update General Settings
PUT
Update General Settings V2
PUT
Update IC Domain Account
PUT
Update IM Asset
PUT
Update IM Stream
PUT
Update IM Tag
PUT
Update IM Version
PUT
Update JWT Authenticator
PUT
Update RCX Client
PUT
Update Role
PUT
Update Security Settings
PUT
Update Settings
PUT
Update Settings V2