Control Session Host Provisioning - Post

Usługa:: Desktop Virtualization

Wersja interfejsu API:: 2026-04-01-preview

Kontroluj aprowizację puli hostów.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	Nazwa puli hostów w określonej grupie zasobów
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Wymagane	Typ	Opis
action	True	HostPoolProvisioningAction	Typy akcji do kontrolowania aktualizacji puli hostów.
cancelMessage		string maxLength: 260	Komunikat o anulowaniu wysłany do użytkownika na hoście sesji.

Odpowiedzi

Nazwa	Typ	Opis
202 Accepted		Zaakceptowano operację zasobu. Nagłówki Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Nazwa

Typ

Opis

202 Accepted

Zaakceptowano operację zasobu.

Nagłówki

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	podszywaj się pod konto użytkownika

Przykłady

SessionHostManagements_ControlSessionHostProvisioning_Post

Przykładowe żądanie

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-04-01-preview

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

Przykładowa odpowiedź

Kod stanu:: 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?api-version=2026-04-01-preview
Retry-After: 60

Definicje

Nazwa	Opis
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
HostPoolProvisioningAction	Typy akcji służące do kontrolowania aprowizacji puli hostów.
HostPoolProvisioningControlParameter	Obiekt zawierający akcję kontrolną dla aprowizacji puli hostów.

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Cel błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

HostPoolProvisioningAction

Wyliczenie

Typy akcji służące do kontrolowania aprowizacji puli hostów.

Wartość	Opis
Cancel	Anuluj aprowizację puli hostów.

HostPoolProvisioningControlParameter

Objekt

Obiekt zawierający akcję kontrolną dla aprowizacji puli hostów.

Nazwa	Typ	Opis
action	HostPoolProvisioningAction	Typy akcji do kontrolowania aktualizacji puli hostów.
cancelMessage	string maxLength: 260	Komunikat o anulowaniu wysłany do użytkownika na hoście sesji.