[{"label":"Latest (V1)","version":"latest"}]
horizon-cloud-nextgen

Get Entitlement Deprecated

Description

Get entitlement record by id

Request

Request

URL

URL


get
https://cloud.vmwarehorizon.com/portal/v1/entitlements/{id}
Copy

Path Parameters

Path Parameters

string
id Required

id


Query Parameters

Query Parameters

string
org_id Optional

org_id


Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK returns Entitlement of type */*
{
	"applications": [
		{
			"displayName": "Google Chrome",
			"icons": {
				"key": {
					"height": 0,
					"iconHash": "string",
					"icondata": "string",
					"path": "string",
					"width": 0
				}
			},
			"id": "string",
			"name": "Chrome",
			"orgId": "0123456789",
			"os": "Windows",
			"path": "c:\\app\\chrome.exe",
			"publisher": "VMware Inc",
			"registeredExtensions": {
				"extensions": [
					{
						"friendlyName": "string",
						"value": "string"
					}
				],
				"otherFileType": [
					{
						"friendlyName": "string",
						"type": "string",
						"value": "string"
					}
				]
			},
			"streamId": "string",
			"templateIds": [
				"string"
			],
			"version": "1.0.0",
			"versionId": "string"
		}
	],
	"connectionAffinity": "NEAREST_SITE",
	"createdAt": "string",
	"description": "entitlement description",
	"enableSSO": false,
	"entitlementType": "DESKTOP",
	"groupIds": [
		"group-id-1 | group-id-2"
	],
	"homesiteMappings": {
		"key": "site-id-2 | site-id-1"
	},
	"id": "ent-id-12345",
	"location": "US",
	"name": "entitlement-123",
	"orgId": "0123456789",
	"powerPolicy": {
		"enabled": false,
		"min": 2,
		"minUnit": "PERCENTAGE",
		"modelVersion": 0,
		"occupancyPresetMode": "BALANCED",
		"powerOffProtectTimeMins": 30,
		"powerSchedules": [
			{
				"allDay": false,
				"endTime": "17:00",
				"min": 5,
				"modelVersion": 0,
				"name": "VmwareWeekdaySchedule",
				"occursOn": 31,
				"startTime": "08:00",
				"timeZone": "Asia/Tokyo"
			}
		]
	},
	"preferredClientType": "HORIZON_CLIENT",
	"protocols": [
		{
			"defaultProtocol": false,
			"name": "BLAST"
		}
	],
	"reportedCapacity": {
		"consumedVMs": 0,
		"freeSessions": 0,
		"maxVMs": 0,
		"provisionedSessions": 0,
		"provisionedVMs": 0,
		"usedSessions": 0
	},
	"requireHomesite": true,
	"scope": "ALL_SITES",
	"templateType": "MULTI_SESSION",
	"templates": [
		{
			"activeDirectoryId": "string",
			"avAgentInstalled": false,
			"clientAccessLicenseApplicable": false,
			"dataCenterId": "datacenter-1",
			"delete": false,
			"disabled": false,
			"disassociateAction": "FORCEFUL",
			"edgeDeploymentId": "string",
			"id": "template-1",
			"imageReference": {
				"modelVersion": 0,
				"streamId": "string",
				"versionId": "string"
			},
			"location": "string",
			"name": "string",
			"orgId": "string",
			"powerPolicy": {
				"enabled": false,
				"min": 2,
				"minUnit": "PERCENTAGE",
				"modelVersion": 0,
				"occupancyPresetMode": "BALANCED",
				"powerOffProtectTimeMins": 30,
				"powerSchedules": [
					{
						"allDay": false,
						"endTime": "17:00",
						"min": 5,
						"modelVersion": 0,
						"name": "VmwareWeekdaySchedule",
						"occursOn": 31,
						"startTime": "08:00",
						"timeZone": "Asia/Tokyo"
					}
				]
			},
			"providerInstance": {
				"id": "0123456789"
			},
			"templateType": "DEDICATED"
		}
	],
	"updatedAt": "string",
	"userIds": [
		"user-id-1 | user-id-2"
	]
}
string
entitlementType Required

Entitlement type

Possible values are: APPLICATIONDESKTOPDESKTOP_APPLICATION


array of Template
templates Required

List of templates


string
templateType Required

Template type - templates added to the entitlement must match this value

Possible values are: DEDICATEDFLOATINGMULTI_SESSIONRDSHWVD


array of Protocol
protocols Required

List of supported desktop protocols


string as ^[a-zA-Z][a-zA-Z0-9\- ]+$
name Required

Entitlement name


array of ApplicationItem
applications Optional

List of applications


array of string
groupIds Optional

List of entitled user groups - requires group ID returned from IAM


map of string
homesiteMappings Optional

Map to store UsersId or GroupId with their preferred homesite Id


string
id Optional

Entitlement ID


string
location Optional

Location that is mapped with Org Id


boolean
enableSSO Optional

Enable SSO on this entitlement.


string
orgId Optional

Org ID that owns this entitlement


powerPolicy Optional

Power policy Spec


string
preferredClientType Optional

Preferred Client Type

Possible values are: BROWSERHORIZON_CLIENT


string
description Optional

Entitlement description


reportedCapacity Optional

boolean
requireHomesite Optional

Flag to specify home site restriction is enabled or not


string
scope Optional

Scope - use first preferred homesite or all preferred home sites

Possible values are: ALL_SITESWITHIN_SITE


string as date-time
createdAt Optional

Time when the entitlement was created


string
connectionAffinity Optional

Connection Affinity - rule to be used while brokering the entitlement

Possible values are: HOME_SITENEAREST_SITE


string as date-time
updatedAt Optional

Time when the entitlement was updated


array of string
userIds Optional

List of entitled users - requires user ID returned from IAM

Errors

Errors

401

Unauthorized


403

Forbidden


404

Not found

Code Samples

Code Samples

cURL Command

curl https://cloud.vmwarehorizon.com/portal/v1/entitlements/{id}


[{"label":"Latest (V1)","version":"latest"}]
horizon-cloud-nextgen
Feedback

Was this page helpful?