Check session host create permissions

Advisory check that the subscription's service principal can provision session host VMs:
VM, NIC, and disk creation, VM extensions, run commands, subnet join, gallery image read,
and host pool registration-token generation. Covers three flows: initial session hosts at
host pool creation (host count greater than zero), POST session-host-deployments, and
autoscale scale-out.

Each required permission is evaluated at exactly the scope the provisioning flow exercises
it against (inherited grants from resource group, subscription, or management group count).

Always returns 200 for a valid request and subscription and never blocks creation:

  • granted: all required actions confirmed at their target scopes.
  • missingPermissions: at least one action could not be confirmed; display the returned message as a warning.
  • unknown: the check itself could not run (transient error); do not show a warning.
Path Params
uuid
required

The subscription ID.

Query Params
string
required
length between 1 and 90
^[-\w.()]{0,89}[-\w()]$

Control-plane resource group containing the host pool. Host pool permissions
(registration-token generation) are evaluated at this scope — relevant when the host
pool lives in a different resource group than the session host VMs.

string
required

ARM resource ID of the subnet session host NICs will join.
Network join permissions are evaluated at this exact scope (inherited grants included).
Must belong to the selected subscription.

string
required

ARM resource ID of the gallery image version used for session host VMs.
Gallery read permissions are evaluated at the image version and its parent image
definition. May belong to a different subscription (shared image galleries).

string
required
length between 1 and 90
^[-\w.()]{0,89}[-\w()]$

Existing Azure resource group the operation deploys into: the control-plane resource
group for host pool creation, the VM deployment resource group for session host creation.

Responses

500

Internal server error.

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json