Control Session Host Provisioning - Post

Szolgáltatás:

Desktop Virtualization

API verzió:

2026-01-01-preview

Gazdagépkészlet kiépítésének szabályozása.

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

URI paraméterek

Név	Ban	Szükséges	Típus	Leírás
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	A gazdagépkészlet neve a megadott erőforráscsoporton belül
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérő Testület

Név	Szükséges	Típus	Leírás
action	True	HostPoolProvisioningAction	Művelettípusok a gazdagépkészlet frissítésének vezérléséhez.
cancelMessage		string maxLength: 260	A munkamenetgazda felhasználójának küldött megszakítási üzenet.

Válaszok

Név	Típus	Leírás
202 Accepted		Az erőforrásművelet elfogadott. Fejlécek Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat.

Típus: oauth2
Flow: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Név	Leírás
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

SessionHostManagements_ControlSessionHostProvisioning_Post

Mintakérés

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"
}

Mintaválasz

Állapotkó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

Meghatározások

Név	Leírás
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
HostPoolProvisioningAction	Művelettípusok a gazdagépkészlet kiépítésének vezérléséhez.
HostPoolProvisioningControlParameter	A gazdagépkészlet kiépítéséhez vezérlőműveletet tartalmazó objektum.

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Név	Típus	Leírás
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Név	Típus	Leírás
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Tárgy

Hibaválasz

Név	Típus	Leírás
error	ErrorDetail	A hibaobjektum.

HostPoolProvisioningAction

Felsorolás

Művelettípusok a gazdagépkészlet kiépítésének vezérléséhez.

Érték	Leírás
Cancel	Szakítsa meg a hostpool kiépítését.

HostPoolProvisioningControlParameter

Tárgy

A gazdagépkészlet kiépítéséhez vezérlőműveletet tartalmazó objektum.

Név	Típus	Leírás
action	HostPoolProvisioningAction	Művelettípusok a gazdagépkészlet frissítésének vezérléséhez.
cancelMessage	string maxLength: 260	A munkamenetgazda felhasználójának küldött megszakítási üzenet.