Update Connection Server V2

Update Connection Server V2

All the listed privileges are required -

Privileges Description
GLOBAL_CONFIG_MANAGEMENT Caller should have permission to this privilege, to perform this operation.
Request
URI
PUT
https://{api_host}/rest/config/v2/connection-servers/{id}
COPY
Path Parameters
string
id
Required

id


Request Body
ConnectionServerUpdateSpecV2 of type(s) application/json
Required
{
    "auxillary_external_pcoip_ipv4_address": "127.0.0.1:4172",
    "bypass_app_blast_gateway": false,
    "bypass_pcoip_gateway": true,
    "bypass_tunnel": false,
    "direct_htmlabsg": false,
    "disclose_service_principal_name": false,
    "enable_smart_card_user_name_hint": false,
    "enabled": true,
    "external_appblast_url": "https://cs1.example.com:8443",
    "external_pcoip_url": "127.0.0.1:4172",
    "external_url": "https://cs1.example.com:443",
    "gss_apiinfo": {
        "gss_apienabled": false
    },
    "host_redirection": false,
    "jwt_info": {
        "jwt_authenticator_ids": [
            "42e47f15-aad0-221a-b231-ea4a3a134ec9",
            "d0325b13-2bf1-4fa4-b027-e780004f2d1e"
        ],
        "jwt_support": "DISABLED"
    },
    "ldap_backup_info": {
        "frequency_time": "DAY_1",
        "ldap_backup_folder": "C:\\ProgramData\\VMware\\VDM\\backups",
        "max_number": 10,
        "time_offset": 0
    },
    "logoff_when_remove_smart_card": false,
    "radius_info": {
        "radius_authenticator_id": "d0325b13-2bf1-4fa4-b027-e780004f2d1e",
        "radius_enabled": false,
        "radius_name_mapping": false,
        "radius_sso": false
    },
    "rsa_secure_id_info": {
        "clear_node_secret": false,
        "name_mapping": false,
        "secure_id_enabled": false,
        "security_file_data": "string"
    },
    "saml_info": {
        "saml_authenticator_ids": [
            "42e47f15-aad0-221a-b231-ea4a3a134ec9",
            "d0325b13-2bf1-4fa4-b027-e780004f2d1e"
        ],
        "saml_support": "DISABLED",
        "workspace_one_block_old_clients": false,
        "workspace_one_host_name": "workspaceone.com",
        "workspace_one_mode_enabled": false
    },
    "smart_card_support": "OFF",
    "smart_card_support_for_admin": "OPTIONAL",
    "tags": [
        "tag1",
        "tag2"
    ],
    "unauthenticated_access_info": {
        "block_unsupported_clients": false,
        "client_puzzle_difficulty": 21,
        "default_unauth_user_id": "11bd230b-87ce-3306-a943-810affe7b68a",
        "enabled": false,
        "user_idle_timeout": 10
    }
}
string
auxillary_external_pcoip_ipv4_address
Optional

This can be set only if external_pcoip_url is set and contains a host part that represents an IPv6 address or DNS name. As legacy clients may not support IPv6 or DNS names for external PCoIP URLs, this IPv4 address, if set, will be presented to them as an alternative. The same port will be used and should not be specified. If bypass_pcoip_gateway is set to true, this property will be ignored.

boolean
bypass_app_blast_gateway
Required

Indicates whether a bypassing blast secure gateway is enabled for this connection server instance. If this is set to true, web browsers make direct connections to Horizon machines bypassing connection server.

boolean
bypass_pcoip_gateway
Required

Indicates whether the PCoIP traffic bypasses the secure gateway.

boolean
bypass_tunnel
Required

Indicates whether a secure tunnel on this connection server instance is enabled. If this is set to false, a secure tunnel on this Connection Server instance is enabled and horizon clents can connect to desktop pools through the secure tunnel, which carries RDP and other data over HTTPS. PCoIP and HTML Access connections use separate secure gateways.

boolean
direct_htmlabsg
Optional

Indicates whether only HTML clients use blast secure gateway for this connection server instance. This property will not be set if bypass_appblast_gateway is set to false.

boolean
disclose_service_principal_name
Required

Indicates whether the connection server's service principal name will be sent to the client prior to the user authentication.When set to true Connection Server discloses its service principal name to the client.

boolean
enable_smart_card_user_name_hint
Optional

Indicates whether username hints for smart card is enabled.

boolean
enabled
Required

Indicate whether the connection server is enabled. A disabled connection server will not accept connection requests from Horizon Clients.

string
external_appblast_url
Optional

The Blast External URL enables browser access to Horizon machines through this connection server instance. To enable Blast, you must install HTML Access. The Blast External URL must not be load balanced. If bypass_appblast_gateway is set to true, this property will be ignored.

string
external_pcoip_url
Optional

Horizon Clients use the PCoIP External URL to establish a PCoIP connection through this Connection Server instance. The PCoIP External URL must not be load balanced. If bypass_pcoip_gateway is set to true, this property will be ignored.

string
external_url
Optional

Horizon Clients use the External URL to establish a secure tunnel to this Connection Server instance. If a server name is specified, it must be resolvable by each Horizon Client. The External URL must not be load balanced. If bypass_tunnel is set to true, this property will be ignored.

gss_apiinfo
Required

gss_apiinfo

boolean
host_redirection
Required

Indicates whether connection server supports HTTP host redirection.

jwt_info
Required

jwt_info

ldap_backup_info
Required

ldap_backup_info

boolean
logoff_when_remove_smart_card
Optional

Indicates whether user is logged off on removal of Smart Card.

radius_info
Required

radius_info

rsa_secure_id_info
Required

rsa_secure_id_info

saml_info
Required

saml_info

string
smart_card_support
Required

Indicates whether the smart card is supported for client or not

  • OPTIONAL: Indicates that the SmartCard usage is optional.
  • REQUIRED: Indicates that the SmartCard usage is necessary.
  • OFF: Indicates that the SmartCard usage is not allowed.
Possible values are : OPTIONAL, REQUIRED, OFF,
string
smart_card_support_for_admin
Required

Indicates Smart card authentication configuration for administrators to login.

  • OPTIONAL: Indicates that the SmartCard usage is optional.
  • REQUIRED: Indicates that the SmartCard usage is necessary.
  • OFF: Indicates that the SmartCard usage is not allowed.
Possible values are : OPTIONAL, REQUIRED, OFF,
array of string
tags
Optional

Tags to restrict accessibility to desktop pools through this server.

unauthenticated_access_info
Required

unauthenticated_access_info

Authentication
This operation uses the following authentication methods.
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

404

Not Found

Operation doesn't return any data structure

Config Operations
POST
Add App Volumes Manager
POST
Add App Volumes Manager V2
POST
Assign Farms
POST
Clean
POST
Clear Event Database
POST
Collect
POST
Create Federation Access Group
POST
Create Gateway Access User Or Group
POST
Create GSSAPI Authenticator
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 Message Client
POST
Create Permissions
POST
Create Permissions V2
POST
Create RADIUS Authenticator
POST
Create Role
POST
Create SAML Authenticator
POST
Create Secondary Credential
POST
Create True SSO Connector
POST
Create Unauthenticated Access User
POST
Create Virtual Center
POST
Create Virtual Center V4
POST
Create Virtual Center V5
DELETE
Delete App Volumes Manager
DELETE
Delete App Volumes Manager V2
DELETE
Delete Certificate
DELETE
Delete Federation Access Group
DELETE
Delete Gateway Access User Or Group
DELETE
Delete GSSAPI Authenticator
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 Message Client
DELETE
Delete Permissions
DELETE
Delete Permissions V2
DELETE
Delete RADIUS Authenticator
DELETE
Delete Role
DELETE
Delete SAML Authenticator
DELETE
Delete Secondary Credential
DELETE
Delete True SSO Connector
DELETE
Delete Unauthenticated Access User
POST
Disable Connection Servers
POST
Enable Connection Servers
POST
Export Certificate
POST
Generate CSR
GET
Get Admin Users Or Groups Permissions
GET
Get AD Sites Info
GET
Get Agent Restriction Settings
GET
Get App Volumes Manager
GET
Get App Volumes Manager V2
GET
Get CEIP Info
GET
Get Client Settings
GET
Get Connection Server
GET
Get Connection Server V2
GET
Get Enrollment Server
GET
Get Environment
GET
Get Environment V2
GET
Get Event Database
GET
Get Feature Settings
GET
Get Federation Access Group
GET
Get Federation Access Group V2
GET
Get Gateway
GET
Get General Settings
GET
Get General Settings V2
GET
Get General Settings V3
GET
Get General Settings V4
GET
Get Global Policies
GET
Get GSSAPI Authenticator
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 Message Client
GET
Get Permission
GET
Get Permission V2
GET
Get Preferences
GET
Get Preferences V2
GET
Get Pre Logon Settings
GET
Get RADIUS Authenticator
GET
Get Role
GET
Get SAML Authenticator
GET
Get Secondary Credentials
GET
Get Security Configuration Info
GET
Get Security Settings
GET
Get Security Settings V2
GET
Get Security Settings V3
GET
Get Security Settings V4
GET
Get Settings
GET
Get Settings V2
GET
Get Settings V3
GET
Get Settings V4
GET
Get Settings V5
POST
Get Storage Details
GET
Get Syslog
GET
Get True SSO Connector
GET
Get Unauthenticated Access User
GET
Get Users Or Group Local Summary V2
GET
Get Users Or Group Local Summary V3
GET
Get Users Or Groups Global Summary
GET
Get Virtual Center
GET
Get Virtual Center V4
GET
Get Virtual Center V5
POST
Import Certificate
GET
List App Volumes Managers
GET
List App Volumes Managers V2
GET
List Certificate Infos
GET
List Certificate Infos V2
GET
List Connection Servers
GET
List Connection Servers V2
GET
List Enrollment Servers
GET
List Federation Access Groups
GET
List Federation Access Groups V2
GET
List Gateway Access User Or Group
GET
List Gateways
GET
List GSSAPI Authenticators
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 Licenses
GET
List Licenses V2
GET
List Local Access Groups
GET
List Local Access Groups V2
GET
List Log Collector Tasks
GET
List Message Clients
GET
List Permissions
GET
List Permissions V2
GET
List RADIUS Authenticators
GET
List RCX Servers
GET
List Roles
GET
List SAML Authenticators
GET
List Secondary Credentials
GET
List Selectable Privileges
GET
List True SSO Connectors
GET
List Unauthenticated Access Users
GET
List Users Or Groups Global Summary
GET
List Users Or Groups Local Summary
GET
List Users Or Groups Local Summary V2
GET
List Users Or Groups Local Summary V3
GET
List VC Info
GET
List VC Info V2
GET
List VC Info V3
GET
List VC Info V4
GET
List VC Info V5
POST
Mark Datastores For Archival
POST
Override Certificate
POST
Purge
POST
Push Certificates
POST
Recover Certificates
POST
Register Gateway
POST
Register RCX Client
DELETE
Remove Virtual Center
DELETE
Remove Virtual Center V5
POST
Reset Highest Usage Metrics
POST
Reset Named User Metrics
POST
Set License Key
POST
Set License Mode
POST
Unassign Farms
DELETE
Unregister Gateway
DELETE
Unregister RCX Client
PUT
Update Agent Restriction Settings
PUT
Update App Volumes Manager
PUT
Update App Volumes Manager V2
PUT
Update CEIP Info
PUT
Update Client Settings
PUT
Update Connection Server
PUT
Update Connection Server V2
PUT
Update Event Database
PUT
Update Feature Settings
PUT
Update General Settings
PUT
Update General Settings V2
PUT
Update General Settings V3
PUT
Update General Settings V4
PUT
Update Global Policies
PUT
Update GSSAPI Authenticator
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 Message Client
POST
Updatepassword
PUT
Update Preferences
PUT
Update Preferences V2
PUT
Update RADIUS Authenticator
PUT
Update RCX Client
PUT
Update Role
PUT
Update SAML Authenticator
PUT
Update Security Settings
PUT
Update Security Settings V3
PUT
Update Security Settings V4
PUT
Update Settings
PUT
Update Settings V2
PUT
Update Settings V3
PUT
Update Settings V4
PUT
Update Settings V5
PUT
Update Syslog
PUT
Update True SSO Connector
PUT
Update Virtual Center
PUT
Update Virtual Center V4
PUT
Update Virtual Center V5
POST
Validate AVM Certificate
POST
Validate SAML Certificate
POST
Validate Virtual Center Certificate