Users - List By Lab

Başvuru

Service:: Lab Services

API Version:: 2023-06-07

Laboratuvar için tüm kullanıcıları alın.
Laboratuvar için tüm kullanıcıların listesini döndürür.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labs/{labName}/users?api-version=2023-06-07

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labs/{labName}/users?api-version=2023-06-07&$filter={$filter}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
labName	path	True	string	Laboratuvar planını içeren içinde onu benzersiz olarak tanımlayan laboratuvarın adı. Kaynak URI'lerinde kullanılır.
resourceGroupName	path	True	string	Kaynak grubunun adı. Ad büyük/küçük harfe duyarlı değildir.
subscriptionId	path	True	string	Hedef aboneliğin kimliği.
api-version	query	True	string	Bu işlem için kullanılacak API sürümü.
$filter	query		string	İşleme uygulanacak filtre.

Yanıtlar

Name	Tür	Description
200 OK	PagedUsers	İstek başarılı oldu; yanıt, verilen laboratuvar için tüm kullanıcıları içerir.
Other Status Codes	ErrorResponse	Varsayılan hata yanıtı.

Örnekler

listUser

Sample Request

HTTP

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labs/testlab/users?api-version=2023-06-07

Sample Response

Status code:: 200

{
  "nextLink": null,
  "value": [
    {
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labs/testlab/users/testuser",
      "name": "default",
      "type": "Microsoft.LabServices/User",
      "systemData": {
        "createdBy": "identity123",
        "createdByType": "User",
        "createdAt": "2020-05-01T10:00:00Z",
        "lastModifiedBy": "identity123",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2020-06-01T09:12:28Z"
      },
      "properties": {
        "provisioningState": "Succeeded",
        "displayName": "Test User",
        "email": "testuser@contoso.com",
        "registrationState": "Registered",
        "invitationState": "Sent",
        "totalUsage": "PT10H",
        "additionalUsageQuota": "PT10H"
      }
    }
  ]
}

Tanımlar

Name	Description
createdByType	Kaynağı oluşturan kimliğin türü.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
InvitationState	Laboratuvar kullanıcısı davet durumu.
PagedUsers	Sayfalanmış kullanıcı listesi.
ProvisioningState	Kullanıcı kaynağının geçerli sağlama durumu.
RegistrationState	Kullanıcı laboratuvarı kayıt durumu.
ResourceOperationError	Bu kaynakta en son işlem hatasının hata ayrıntıları
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
User	Laboratuvar içinde sanal makinelere kaydolabilen ve bunları kullanabilen bir laboratuvarın kullanıcısı.

createdByType

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

Name	Tür	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

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

ErrorDetail

Hata ayrıntısı.

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

ErrorResponse

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

InvitationState

Laboratuvar kullanıcısı davet durumu.

Name	Tür	Description
Failed	string	Davet gönderilirken bir hata oluştu.
NotSent	string	Davet gönderilmedi.
Sending	string	Şu anda davet gönderiliyor.
Sent	string	Davet başarıyla gönderildi.

PagedUsers

Sayfalanmış kullanıcı listesi.

Name	Tür	Description
nextLink	string	Görüntü sonuçlarının sonraki sayfasını alma bağlantısı.
value	User[]	Kullanıcı sonuçlarının dizi sayfası.

ProvisioningState

Kullanıcı kaynağının geçerli sağlama durumu.

Name	Tür	Description
Creating	string	Kaynak oluşturulma aşamasındadır.
Deleting	string	Kaynak silinme aşamasında.
Failed	string	Kaynaktaki önceki işlem, kaynağı iyi durumda bırakmada başarısız oldu.
Locked	string	Kaynak kilitli ve değişiklikler şu anda engelleniyor. Bunun nedeni bakım veya zamanlanmış bir işlem olabilir. Kilitleme işlemi tamamlandıktan sonra durum başarılı durumuna geri döner.
Succeeded	string	Kaynak oluşturma veya güncelleştirme işleminden sonra iyi durumda.
Updating	string	Kaynağa yeni özellik değerleri uygulanıyor.

RegistrationState

Kullanıcı laboratuvarı kayıt durumu.

Name	Tür	Description
NotRegistered	string	Kullanıcı laboratuvara kaydolms.
Registered	string	Kullanıcı henüz laboratuvara kaydolmadı.

ResourceOperationError

Bu kaynakta en son işlem hatasının hata ayrıntıları

Name	Tür	Description
action	string	Başarısız olan işlem eylemi
code	string	İşlem hatasının türüne karşılık gelen kod
message	string	İşlem hatası iletisi
timestamp	string	Hatanın oluştuğu tarih saat

systemData

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

Name	Tür	Description
createdAt	string	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string	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 kimliğin türü.

User

Laboratuvar içinde sanal makinelere kaydolabilen ve bunları kullanabilen bir laboratuvarın kullanıcısı.

Name	Tür	Description
id	string	Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Kaynağın adı
properties.additionalUsageQuota	string	Kullanıcının laboratuvar kullanım kotasına ek olarak aldığı kullanım kotası süresi.
properties.displayName	string	Kullanıcının görünen adı, örneğin kullanıcının tam adı.
properties.email	string	Kullanıcının e-posta adresi.
properties.invitationSent	string	Davet iletisinin kullanıcıya gönderildiği tarih ve saat.
properties.invitationState	InvitationState	Kullanıcı için davet iletisinin durumu.
properties.provisioningState	ProvisioningState	Kullanıcı kaynağının geçerli sağlama durumu.
properties.registrationState	RegistrationState	Kullanıcının laboratuvardaki kaydının durumu.
properties.resourceOperationError	ResourceOperationError	Laboratuvar planında yapılan son işlemin hata ayrıntıları.
properties.totalUsage	string	Kullanıcının sanal makinelerini bu laboratuvarda ne kadar süreyle kullandığı.
systemData	systemData	Kullanıcı kaynağının oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"