Session Host Provisioning Statuses - Get

Hizmet:

Desktop Virtualization

API Sürümü:

2026-04-01-preview

Belirli bir konak havuzu için oturum ana bilgisayarı sağlama durumunu alın.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	Belirtilen kaynak grubu içindeki konak havuzunun adı
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	SessionHostManagementProvisioningStatus	Azure işlemi başarıyla tamamlandı.
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızı taklit etme

Örnekler

SessionHostManagements_SessionHostProvisioningStatuses_Get

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:

200

{
  "id": "/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/hostPools/hostPool1/sessionHostManagements/default/sessionHostProvisioningStatuses/default",
  "name": "30972f1b-b61d-4fd8-bd34-3dcfa24670f3",
  "status": "Failed",
  "startTime": "2020-10-26T13:45:39.6554616Z",
  "endTime": "2020-10-26T13:45:42.7025301Z",
  "percentComplete": 1,
  "error": {
    "code": "BadArgument",
    "message": "The provided database 'foo' has an invalid username."
  }
}

Tanımlar

Name	Description
CanaryPolicy	Bir oturum ana bilgisayarı sağlama işlemi sırasında bir Canary VM'nin (yapılandırmayı doğrulamak için tek bir VM) sağlanıp sağlanmayacağına ilişkin ilke.
createdByType	Kaynağı oluşturan kimliğin türü.
ErrorAdditionalInfo	Kaynak yönetimi hatasına ilişkin ek bilgiler.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
FailedSessionHostCleanupPolicySHC	Oturum Ana Bilgisayarı sağlama işlemi başarısız olduğunda uygulanması gereken ilke.
HostPoolUpdateConfigurationProperties	Bir konak havuzu güncelleştirmesinin yapılandırmaları.
SessionHostManagement	SessionHostManagement özellikleri için şema.
SessionHostManagementProvisioningOperationProgress	SessionHostManagement Sağlama İşlemi İlerleme Durumu bilgileri.
SessionHostManagementProvisioningOperationStatus	SessionHostManagementUpdate için işlem durumu.
SessionHostManagementProvisioningStatus	SessionHostManagementUpdateStatus özellikleri için şema.
SessionHostManagementProvisioningStatusProperties	sessionHostManagement Sağlama Durumları için özellikler paketi.
SessionHostProvisioningConfigurationProperties	Oturum ana bilgisayarı sağlama işlemleri için yapılandırma.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

CanaryPolicy

Numaralandırma

Bir oturum ana bilgisayarı sağlama işlemi sırasında bir Canary VM'nin (yapılandırmayı doğrulamak için tek bir VM) sağlanıp sağlanmayacağına ilişkin ilke.

Değer	Description
Auto	Canary VM'nin sağlanıp sağlanmayacağına hizmet tarafından karar verildi.
Never	Hiçbir zaman Canary VM'yi sağlamayın.
Always	Her zaman Canary VM'yi sağlayın.

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatasına ilişkin ek bilgiler.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgisi.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

FailedSessionHostCleanupPolicySHC

Numaralandırma

Oturum Ana Bilgisayarı sağlama işlemi başarısız olduğunda uygulanması gereken ilke.

Değer	Description
KeepAll	Hepsini Sakla.
KeepOne	Bir tane sakla.
KeepNone	Hiçbirini tutma.

HostPoolUpdateConfigurationProperties

Nesne

Bir konak havuzu güncelleştirmesinin yapılandırmaları.

Name	Tür	Description
deleteOriginalVm	boolean	Orijinal diskten tasarruf edilip edilmeyeceği. Varsayılan olarak yanlıştır.
logOffDelayMinutes	integer (int32)	Dakika içinde kullanıcıların oturumunu kapatmadan önceki yetkisiz kullanım süresi.
logOffMessage	string maxLength: 260	Oturumun kapatılması için kullanıcıya gönderilen oturum kapatma iletisi. Varsayılan değer boş bir dizedir.
maxVmsRemoved	integer (int32) minimum: 1	Konak havuzu güncelleştirmesi sırasında kaldırılacak en fazla sanal makine sayısı.

SessionHostManagement

Nesne

SessionHostManagement özellikleri için şema.

Name	Tür	Description
id	string (arm-id)	Kaynağın tam nitelikli kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Kaynağın adı
properties.failedSessionHostCleanupPolicy	FailedSessionHostCleanupPolicySHC	Oturum Ana Bilgisayarı sağlama işlemi başarısız olduğunda uygulanması gereken ilke.
properties.provisioning	SessionHostProvisioningConfigurationProperties	Oturum konakları sağlandığında geçerli olan parametreler.
properties.scheduledDateTimeZone	string	içinde tanımlandığı gibi sessionHostManagement işlemleri için saat dilimi https://docs.microsoft.com/dotnet/api/system.timezoneinfo.findsystemtimezonebyid. useLocalTime true ise ayarlanmalıdır.
properties.update	HostPoolUpdateConfigurationProperties	Konak havuzu güncelleştirmesi için parametreler.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

SessionHostManagementProvisioningOperationProgress

Nesne

SessionHostManagement Sağlama İşlemi İlerleme Durumu bilgileri.

Name	Tür	Description
executionStartTime	string (date-time)	sessionHostManagement işleminin oluşturulduğu saat.
finalSessionHostsCount	integer (int32)	Bu sağlama işlemi için konak havuzunun son örnek sayısı.
initialSessionHostsCount	integer (int32)	Bu sağlama işlemi için konak havuzunun ilk örnek sayısı.
sessionHostsCompleted	integer (int32)	sessionHostManagement sağlama işleminde tamamlanan sessionHosts sayısı.
sessionHostsInProgress	integer (int32)	sessionHostManagement sağlama işleminde devam eden sessionHosts sayısı

SessionHostManagementProvisioningOperationStatus

Numaralandırma

SessionHostManagementUpdate için işlem durumu.

Değer	Description
Scheduled	İşlem planlandı.
ValidatingSessionHostProvisioning	İşlem şu anda sağlamayı doğruluyor.
Cancelling	İşlemin iptal edilmesi.
ProvisioningSessionHosts	İşlem şu anda oturum konaklarını sağlıyor.
Succeeded	İşlem başarılı oldu.
Failed	İşlem başarısız oldu.
Canceled	İşlem iptal edilir.

SessionHostManagementProvisioningStatus

Nesne

SessionHostManagementUpdateStatus özellikleri için şema.

Name	Tür	Description
endTime	string (date-time)	İşlemin bitiş saati.
error	ErrorDetail	Varsa, işlem hatasının ayrıntıları.
id	string (arm-id)	Zaman uyumsuz işlem için tam kimlik.
name	string	Zaman uyumsuz işlemin adı.
percentComplete	number (double) minimum: 0 maximum: 100	Tamamlanan işlemin yüzdesi.
properties	SessionHostManagementProvisioningStatusProperties	SessionHost Sağlama Durumu'nun özel özellikleri.
startTime	string (date-time)	İşlemin başlangıç saati.
status	SessionHostManagementProvisioningOperationStatus	İşlem durumu.

SessionHostManagementProvisioningStatusProperties

Nesne

sessionHostManagement Sağlama Durumları için özellikler paketi.

Name	Tür	Description
correlationId	string	Log Analytics için bağıntı kimliği.
progress	SessionHostManagementProvisioningOperationProgress	sessionHostManagement işlemiyle ilgili ilerleme bilgileri.
scheduledDateTime	string (date-time)	Güncelleştirmenin zamanlandığı zaman damgası.
sessionHostManagement	SessionHostManagement	İşlem için kullanılan SessionHostManagement özellikleri.

SessionHostProvisioningConfigurationProperties

Nesne

Oturum ana bilgisayarı sağlama işlemleri için yapılandırma.

Name	Tür	Description
canaryPolicy	CanaryPolicy	Bir oturum ana bilgisayarı sağlama işlemi sırasında bir Canary VM'nin (yapılandırmayı doğrulamak için tek bir VM) sağlanıp sağlanmayacağına ilişkin ilke.
instanceCount	integer (int32) minimum: 1	Konak Havuzunda bulunacak oturum konaklarının sayısı.
setDrainMode	boolean	Sağlama sonrasında oturum ana bilgisayarının boşaltma modunda ayarlanması gerekip gerekmediği.

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturmanın zaman damgası (UTC).
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.