Control Session Host Provisioning - Post

Služba:

Desktop Virtualization

Verze rozhraní API:

2026-01-01-preview

Řízení zřizování fondu hostitelů.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/sessionHostManagements/default/controlSessionHostProvisioning?api-version=2026-01-01-preview

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	Název fondu hostitelů v rámci určené skupiny prostředků
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
action	True	HostPoolProvisioningAction	Typy akcí pro řízení aktualizace fondu hostitelů.
cancelMessage		string maxLength: 260	Zpráva o zrušení odeslaná uživateli na hostiteli relace.

Odpovědi

Name	Typ	Description
202 Accepted		Akceptovala se operace prostředku. Hlavičky Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

SessionHostManagements_ControlSessionHostProvisioning_Post

Ukázkový požadavek

HTTP

POST https://management.azure.com/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/hostPools/hostPool1/sessionHostManagements/default/controlSessionHostProvisioning?api-version=2026-01-01-preview

{
  "action": "Cancel",
  "cancelMessage": "Cancel host pool provisioning"
}

Ukázková odpověď

Stavový kód:

202

Location: https://management.azure.com/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/hostPools/hostPool1/sessionHostManagements/default/operationResults/ed5d502c-acaa-42ec-ad61-0d8488a9fd1d
Retry-After: 60

Definice

Name	Description
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
HostPoolProvisioningAction	Typy akcí pro řízení zřizování fondu hostitelů.
HostPoolProvisioningControlParameter	Objekt obsahující řídicí akci pro zřizování fondu hostitelů.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

HostPoolProvisioningAction

Výčet

Typy akcí pro řízení zřizování fondu hostitelů.

Hodnota	Description
Cancel	Zrušte zřizování fondu hostitelů.

HostPoolProvisioningControlParameter

Objekt

Objekt obsahující řídicí akci pro zřizování fondu hostitelů.

Name	Typ	Description
action	HostPoolProvisioningAction	Typy akcí pro řízení aktualizace fondu hostitelů.
cancelMessage	string maxLength: 260	Zpráva o zrušení odeslaná uživateli na hostiteli relace.