Get Connection Server V2

Get Connection Server V2

At least one of the listed privileges is required -

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

id


Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns ConnectionServerInfoV2 of type(s) */*
{
    "auxillary_external_pcoip_ipv4_address": "127.0.0.1:4172",
    "bypass_app_blast_gateway": false,
    "bypass_pcoip_gateway": true,
    "bypass_tunnel": false,
    "cluster_name": "Cluster-CS1",
    "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",
    "fips_mode_enabled": false,
    "fqhn": "cs1.example.com",
    "gss_apiinfo": {
        "allow_receiving_ntlm": false,
        "gss_apiauthenticator_id": "42e47f15-aad0-221a-b231-ea4a3a134ec9",
        "gss_apienabled": false
    },
    "has_blast_gateway_support": true,
    "has_pcoip_gateway_support": true,
    "host_redirection": false,
    "id": "d0325b13-2bf1-4fa4-b027-e780004f2d1e",
    "ip_mode": "IPv4",
    "jwt_info": {
        "jwt_authenticator_ids": [
            "42e47f15-aad0-221a-b231-ea4a3a134ec9",
            "d0325b13-2bf1-4fa4-b027-e780004f2d1e"
        ],
        "jwt_support": "DISABLED"
    },
    "ldap_backup_info": {
        "backup_in_progress": false,
        "frequency_time": "DAY_1",
        "last_ldap_backup_status": "OK",
        "last_ldap_backup_time": 1652079610000,
        "ldap_backup_folder": "C:\\ProgramData\\VMware\\VDM\\backups",
        "max_number": 10,
        "time_offset": 0
    },
    "load_balancer_hosts": [
        "10.217.68.253",
        "10.217.68.254"
    ],
    "local_connection_server": true,
    "logoff_when_remove_smart_card": false,
    "message_security_enhanced_mode_supported": false,
    "msg_security_public_key": "MIHwMIGoBgcqhkjOOAQBMIGcAkEA/KaCzo4Syrom78z3EQ5SbbB4sF7ey80etKII864WF64B81uRpH5t9jQTxeEu0Imbz\r\nRMqzVDZkVG9xD7nN1kuFwIVAJYu3cw2nLqOuyYO5rahJtk0bjjFAkBnhHGyepz0TukaScUUfbGpqvJE8FpDTWSGkx0tFCcbn\r\njUDC3H9c9oXkGmzLik1Yw4cIGI1TQ2iCmxBblC+eUykA0MAAkBTVayCjCDm9x1oPkzxvlRrn2ZJWJPnEAMvxnyBOA8rJ/uD0BkQ/iSV/Q3HoR5Mkwc/mMeMuo9VpLK0wgb0BUZ9",
    "name": "cs1.example.com",
    "radius_info": {
        "radius_authenticator_id": "d0325b13-2bf1-4fa4-b027-e780004f2d1e",
        "radius_enabled": false,
        "radius_name_mapping": false,
        "radius_sso": false
    },
    "router_ssl_thumbprints": [
        "d9:46:70:13:d1:1c:37:47:ba:c7:5f:9b:55:fc:e7:48:9b:1e:4b:ef:6c:62:bf:e7:0b:43:69:31:29:c0:b9:fa#SHA_256",
        "74:84:31:a5:86:ce:b8:f6:f7:f4:8b:d5:de:b6:a9:f9:be:ce:62:06:7a:01:d8:f9:d1:19:ce:9b:2d:bf:e2:2c#SHA_256"
    ],
    "rsa_secure_id_info": {
        "clear_node_secret": false,
        "name_mapping": false,
        "secure_id_enabled": false,
        "security_file_uploaded": false
    },
    "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
    },
    "server_url": "https://cs1.example.com:443",
    "smart_card_support": "OPTIONAL",
    "smart_card_support_for_admin": "OFF",
    "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
    },
    "version": "8.6.0-19754208"
}
string
auxillary_external_pcoip_ipv4_address
Optional

This is 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 not be set.

boolean
bypass_app_blast_gateway
Optional

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
Optional

Indicates whether the PCoIP traffic bypasses the secure gateway.

boolean
bypass_tunnel
Optional

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.

string
cluster_name
Optional

Cluster name.

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
Optional

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
Optional

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 not be set.

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 not be set.

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 not be set.

boolean
fips_mode_enabled
Optional

Indicates whether this server has FIPS mode enabled.

string
fqhn
Optional

Fully qualified host name.

gss_apiinfo
Optional

gss_apiinfo

boolean
has_blast_gateway_support
Optional

Indicates whether Blast gateway is supported or not.

boolean
has_pcoip_gateway_support
Optional

Indicates whether PCoIP gateway is supported or not.

boolean
host_redirection
Optional

Indicates whether connection server supports HTTP host redirection.

string
id
Optional

Unique Id of the Connection Server.

string
ip_mode
Optional

Indicates the Connection Server IP environment.

  • IPv4: The ip mode is IPv4.
  • IPv6: The ip mode is IPv6.
Possible values are : IPv4, IPv6,
jwt_info
Optional

jwt_info

ldap_backup_info
Optional

ldap_backup_info

array of string
load_balancer_hosts
Optional

List of load balancer host names or IP address.

boolean
local_connection_server
Optional

Indicates whether this is the local connection server that handled the connection server service request.

boolean
logoff_when_remove_smart_card
Optional

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

boolean
message_security_enhanced_mode_supported
Optional

Indicates whether ENHANCED message security mode is currently supported by this Connection Server.

string
msg_security_public_key
Optional

The JMS message security public key.

string
name
Optional

Name of the Connection Server.

radius_info
Optional

radius_info

array of string
router_ssl_thumbprints
Optional

The JMS router SSL thumbprints

rsa_secure_id_info
Optional

rsa_secure_id_info

saml_info
Optional

saml_info

string
server_url
Optional

General URL for the connection server.

string
smart_card_support
Optional

Smart Card support option.

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

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
Optional

unauthenticated_access_info

string
version
Optional

Version attribute to indicate functionalities supported by current connection server.


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
Back Up
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
POST
Generate Download UR Ls
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 Feature Settings V2
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 General Settings V5
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 Log Levels
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 Security Settings V5
GET
Get Settings
GET
Get Settings V2
GET
Get Settings V3
GET
Get Settings V4
GET
Get Settings V5
GET
Get Settings V6
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 Group Local Summary V4
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 Users Or Groups Local Summary V4
GET
List VC Info
GET
List VC Info V2
GET
List VC Info V3
GET
List VC Info V4
GET
List VC Info V5
GET
List VC Info V6
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
PUT
Set Log Levels
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 Feature Settings V2
PUT
Update General Settings
PUT
Update General Settings V2
PUT
Update General Settings V3
PUT
Update General Settings V4
PUT
Update General Settings V5
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 Security Settings V5
PUT
Update Settings
PUT
Update Settings V2
PUT
Update Settings V3
PUT
Update Settings V4
PUT
Update Settings V5
PUT
Update Settings V6
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