Host Pools - Get

Get a host pool.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}?api-version=2024-04-03

URI Parameters

Name In Required Type Description
hostPoolName
path True

string

The name of the host pool within the specified resource group

Regex pattern: ^[A-Za-z0-9@.\-_ ]*$

resourceGroupName
path True

string

The name of the resource group. The name is case insensitive.

subscriptionId
path True

string

uuid

The ID of the target subscription. The value must be an UUID.

api-version
query True

string

The API version to use for this operation.

Responses

Name Type Description
200 OK

HostPool

Successfully retrieved host pool.

Other Status Codes

CloudError

Automation error response describing why the operation failed.

Examples

HostPool_Get

Sample request

GET https://management.azure.com/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/hostPools/hostPool1?api-version=2024-04-03

Sample response

{
  "name": "hostPool1",
  "id": "/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/hostPools/hostPool1",
  "type": "/Microsoft.DesktopVirtualization/hostPools",
  "location": "centralus",
  "tags": {
    "key1": "value1",
    "key2": "value2"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "objectId": "7877fb31-4bde-49fd-9df3-c046e0ec5325",
    "friendlyName": "friendly",
    "description": "des1",
    "hostPoolType": "Pooled",
    "personalDesktopAssignmentType": "Automatic",
    "customRdpProperty": null,
    "maxSessionLimit": 999999,
    "loadBalancerType": "BreadthFirst",
    "validationEnvironment": null,
    "ring": null,
    "registrationInfo": {
      "expirationTime": "2008-09-22T14:01:54.9571247Z",
      "token": "token",
      "registrationTokenOperation": "Update"
    },
    "vmTemplate": "{json:json}",
    "ssoadfsAuthority": "https://adfs",
    "ssoClientId": "client",
    "ssoClientSecretKeyVaultPath": "https://keyvault/secret",
    "ssoSecretType": "SharedKey",
    "preferredAppGroupType": "Desktop",
    "startVMOnConnect": false,
    "cloudPcResource": false,
    "agentUpdate": {
      "type": "Scheduled",
      "useSessionHostLocalTime": false,
      "maintenanceWindowTimeZone": "Alaskan Standard Time",
      "maintenanceWindows": [
        {
          "hour": 7,
          "dayOfWeek": "Friday"
        },
        {
          "hour": 8,
          "dayOfWeek": "Saturday"
        }
      ]
    }
  }
}
{
  "error": {
    "code": "hostPoolDoesNotExist",
    "message": "Host Pool Does Not Exist"
  }
}

Definitions

Name Description
AgentUpdateProperties

The session host configuration for updating agent, monitoring agent, and stack component.

CloudError

Cloud error object.

CloudErrorProperties

Cloud error object properties.

createdByType

The type of identity that created the resource.

DayOfWeek

Day of the week.

HostPool

Represents a HostPool definition.

HostpoolPublicNetworkAccess

Enabled allows this resource to be accessed from both public and private networks, Disabled allows this resource to only be accessed via private endpoints

HostPoolType

HostPool type for desktop.

Identity
LoadBalancerType

The type of the load balancer.

MaintenanceWindowProperties

Maintenance window starting hour and day of week.

PersonalDesktopAssignmentType

PersonalDesktopAssignment type for HostPool.

Plan
PreferredAppGroupType

The type of preferred application group type, default to Desktop Application Group

PrivateEndpoint

The private endpoint resource.

PrivateEndpointConnection

The private endpoint connection resource.

PrivateEndpointConnectionProvisioningState

The current provisioning state.

PrivateEndpointServiceConnectionStatus

The private endpoint connection status.

PrivateLinkServiceConnectionState

A collection of information about the state of the connection between service consumer and provider.

RegistrationInfo

Represents a RegistrationInfo definition.

RegistrationTokenOperation

The type of resetting the token.

ResourceIdentityType

The identity type.

SessionHostComponentUpdateType

The type of maintenance for session host components.

Sku
SkuTier

This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT.

SSOSecretType

The type of single sign on Secret Type.

systemData

Metadata pertaining to creation and last modification of the resource.

AgentUpdateProperties

The session host configuration for updating agent, monitoring agent, and stack component.

Name Type Description
maintenanceWindowTimeZone

string

Time zone for maintenance as defined in https://docs.microsoft.com/en-us/dotnet/api/system.timezoneinfo.findsystemtimezonebyid?view=net-5.0. Must be set if useLocalTime is true.

maintenanceWindows

MaintenanceWindowProperties[]

List of maintenance windows. Maintenance windows are 2 hours long.

type

SessionHostComponentUpdateType

The type of maintenance for session host components.

useSessionHostLocalTime

boolean

Whether to use localTime of the virtual machine.

CloudError

Cloud error object.

Name Type Description
error

CloudErrorProperties

Cloud error object properties.

CloudErrorProperties

Cloud error object properties.

Name Type Description
code

string

Error code

message

string

Error message indicating why the operation failed.

createdByType

The type of identity that created the resource.

Name Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

DayOfWeek

Day of the week.

Name Type Description
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

HostPool

Represents a HostPool definition.

Name Type Description
etag

string

The etag field is not required. If it is provided in the response body, it must also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.

id

string

Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

Identity

kind

string

Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type. E.g. ApiApps are a kind of Microsoft.Web/sites type. If supported, the resource provider must validate and persist this value.

location

string

The geo-location where the resource lives

managedBy

string

The fully qualified resource ID of the resource that manages this resource. Indicates if this resource is managed by another Azure resource. If this is present, complete mode deployment will not delete the resource if it is removed from the template since it is managed by another resource.

name

string

The name of the resource

plan

Plan

properties.agentUpdate

AgentUpdateProperties

The session host configuration for updating agent, monitoring agent, and stack component.

properties.appAttachPackageReferences

string[]

List of App Attach Package links.

properties.applicationGroupReferences

string[]

List of applicationGroup links.

properties.cloudPcResource

boolean

Is cloud pc resource.

properties.customRdpProperty

string

Custom rdp property of HostPool.

properties.description

string

Description of HostPool.

properties.friendlyName

string

Friendly name of HostPool.

properties.hostPoolType

HostPoolType

HostPool type for desktop.

properties.loadBalancerType

LoadBalancerType

The type of the load balancer.

properties.maxSessionLimit

integer

The max session limit of HostPool.

properties.objectId

string

ObjectId of HostPool. (internal use)

properties.personalDesktopAssignmentType

PersonalDesktopAssignmentType

PersonalDesktopAssignment type for HostPool.

properties.preferredAppGroupType

PreferredAppGroupType

The type of preferred application group type, default to Desktop Application Group

properties.privateEndpointConnections

PrivateEndpointConnection[]

List of private endpoint connection associated with the specified resource

properties.publicNetworkAccess

HostpoolPublicNetworkAccess

Enabled allows this resource to be accessed from both public and private networks, Disabled allows this resource to only be accessed via private endpoints

properties.registrationInfo

RegistrationInfo

The registration info of HostPool.

properties.ring

integer

The ring number of HostPool.

properties.ssoClientId

string

ClientId for the registered Relying Party used to issue WVD SSO certificates.

properties.ssoClientSecretKeyVaultPath

string

Path to Azure KeyVault storing the secret used for communication to ADFS.

properties.ssoSecretType

SSOSecretType

The type of single sign on Secret Type.

properties.ssoadfsAuthority

string

URL to customer ADFS server for signing WVD SSO certificates.

properties.startVMOnConnect

boolean

The flag to turn on/off StartVMOnConnect feature.

properties.validationEnvironment

boolean

Is validation environment.

properties.vmTemplate

string

VM template for sessionhosts configuration within hostpool.

sku

Sku

systemData

systemData

Metadata pertaining to creation and last modification of the resource.

tags

object

Resource tags.

type

string

The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

HostpoolPublicNetworkAccess

Enabled allows this resource to be accessed from both public and private networks, Disabled allows this resource to only be accessed via private endpoints

Name Type Description
Disabled

string

Enabled

string

EnabledForClientsOnly

string

EnabledForSessionHostsOnly

string

HostPoolType

HostPool type for desktop.

Name Type Description
BYODesktop

string

Users assign their own machines, load balancing logic remains the same as Personal. PersonalDesktopAssignmentType must be Direct.

Personal

string

Users will be assigned a SessionHost either by administrators (PersonalDesktopAssignmentType = Direct) or upon connecting to the pool (PersonalDesktopAssignmentType = Automatic). They will always be redirected to their assigned SessionHost.

Pooled

string

Users get a new (random) SessionHost every time it connects to the HostPool.

Identity

Name Type Description
principalId

string

The principal ID of resource identity. The value must be an UUID.

tenantId

string

The tenant ID of resource. The value must be an UUID.

type

ResourceIdentityType

The identity type.

LoadBalancerType

The type of the load balancer.

Name Type Description
BreadthFirst

string

DepthFirst

string

Persistent

string

MaintenanceWindowProperties

Maintenance window starting hour and day of week.

Name Type Description
dayOfWeek

DayOfWeek

Day of the week.

hour

integer

The update start hour of the day. (0 - 23)

PersonalDesktopAssignmentType

PersonalDesktopAssignment type for HostPool.

Name Type Description
Automatic

string

Direct

string

Plan

Name Type Description
name

string

A user defined name of the 3rd Party Artifact that is being procured.

product

string

The 3rd Party artifact that is being procured. E.g. NewRelic. Product maps to the OfferID specified for the artifact at the time of Data Market onboarding.

promotionCode

string

A publisher provided promotion code as provisioned in Data Market for the said product/artifact.

publisher

string

The publisher of the 3rd Party Artifact that is being bought. E.g. NewRelic

version

string

The version of the desired product/artifact.

PreferredAppGroupType

The type of preferred application group type, default to Desktop Application Group

Name Type Description
Desktop

string

None

string

RailApplications

string

PrivateEndpoint

The private endpoint resource.

Name Type Description
id

string

The ARM identifier for private endpoint.

PrivateEndpointConnection

The private endpoint connection resource.

Name Type Description
id

string

Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

The name of the resource

properties.groupIds

string[]

The group ids for the private endpoint resource.

properties.privateEndpoint

PrivateEndpoint

The private endpoint resource.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

A collection of information about the state of the connection between service consumer and provider.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

The provisioning state of the private endpoint connection resource.

systemData

systemData

Azure Resource Manager metadata containing createdBy and modifiedBy information.

type

string

The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

The current provisioning state.

Name Type Description
Creating

string

Deleting

string

Failed

string

Succeeded

string

PrivateEndpointServiceConnectionStatus

The private endpoint connection status.

Name Type Description
Approved

string

Pending

string

Rejected

string

PrivateLinkServiceConnectionState

A collection of information about the state of the connection between service consumer and provider.

Name Type Description
actionsRequired

string

A message indicating if changes on the service provider require any updates on the consumer.

description

string

The reason for approval/rejection of the connection.

status

PrivateEndpointServiceConnectionStatus

Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service.

RegistrationInfo

Represents a RegistrationInfo definition.

Name Type Description
expirationTime

string

Expiration time of registration token.

registrationTokenOperation

RegistrationTokenOperation

The type of resetting the token.

token

string

The registration token base64 encoded string.

RegistrationTokenOperation

The type of resetting the token.

Name Type Description
Delete

string

None

string

Update

string

ResourceIdentityType

The identity type.

Name Type Description
SystemAssigned

string

SessionHostComponentUpdateType

The type of maintenance for session host components.

Name Type Description
Default

string

Agent and other agent side components are delivery schedule is controlled by WVD Infra.

Scheduled

string

TenantAdmin have opted in for Scheduled Component Update feature.

Sku

Name Type Description
capacity

integer

If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted.

family

string

If the service has different generations of hardware, for the same SKU, then that can be captured here.

name

string

The name of the SKU. E.g. P3. It is typically a letter+number code

size

string

The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code.

tier

SkuTier

This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT.

SkuTier

This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT.

Name Type Description
Basic

string

Free

string

Premium

string

Standard

string

SSOSecretType

The type of single sign on Secret Type.

Name Type Description
Certificate

string

CertificateInKeyVault

string

SharedKey

string

SharedKeyInKeyVault

string

systemData

Metadata pertaining to creation and last modification of the resource.

Name Type Description
createdAt

string

The timestamp of resource creation (UTC).

createdBy

string

The identity that created the resource.

createdByType

createdByType

The type of identity that created the resource.

lastModifiedAt

string

The timestamp of resource last modification (UTC)

lastModifiedBy

string

The identity that last modified the resource.

lastModifiedByType

createdByType

The type of identity that last modified the resource.