Control Session Host Provisioning - Post

Tjänst:

Desktop Virtualization

API-versionen:

2026-01-01-preview

Kontrollera etableringen av en värdpool.

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

URI-parametrar

Namn	I	Krävs	Typ	Beskrivning
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	Namnet på värdpoolen i den angivna resursgruppen
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begäranarorgan

Namn	Krävs	Typ	Beskrivning
action	True	HostPoolProvisioningAction	Åtgärdstyper för att styra uppdatering av värdpoolen.
cancelMessage		string maxLength: 260	Avbrytmeddelandet som skickas till användaren på sessionsvärden.

Svaren

Namn	Typ	Beskrivning
202 Accepted		Resursåtgärden har godkänts. Headers Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Rinna: implicit
Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/authorize

Scope

Namn	Beskrivning
user_impersonation	personifiera ditt användarkonto

Exempel

SessionHostManagements_ControlSessionHostProvisioning_Post

Exempelförfrågan

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

Exempelsvar

Statuskod:

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

Definitioner

Namn	Beskrivning
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
HostPoolProvisioningAction	Åtgärdstyper för att styra etablering av värdpooler.
HostPoolProvisioningControlParameter	Objekt som innehåller kontrollåtgärd för etablering av värdpool.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Namn	Typ	Beskrivning
info	object	Den ytterligare informationen.
type	string	Typen av ytterligare information.

ErrorDetail

Objekt

Felinformationen.

Namn	Typ	Beskrivning
additionalInfo	ErrorAdditionalInfo[]	Felet ytterligare information.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felet riktas.

ErrorResponse

Objekt

Felsvar

Namn	Typ	Beskrivning
error	ErrorDetail	Felet objektet.

HostPoolProvisioningAction

Uppräkning

Åtgärdstyper för att styra etablering av värdpooler.

Värde	Beskrivning
Cancel	Avbryt etableringen av värdpoolen.

HostPoolProvisioningControlParameter

Objekt

Objekt som innehåller kontrollåtgärd för etablering av värdpool.

Namn	Typ	Beskrivning
action	HostPoolProvisioningAction	Åtgärdstyper för att styra uppdatering av värdpoolen.
cancelMessage	string maxLength: 260	Avbrytmeddelandet som skickas till användaren på sessionsvärden.