Users - List By Lab

Layanan:: Lab Services

Versi API:: 2023-06-07

Mendapatkan semua pengguna untuk lab.
Mengembalikan daftar semua pengguna untuk lab.

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

Dengan parameter opsional:

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
labName	path	True	string minLength: 1 maxLength: 100	Nama lab yang secara unik mengidentifikasinya dalam paket lab yang berisi. Digunakan dalam URI sumber daya.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama ini tidak peka huruf besar/kecil.
subscriptionId	path	True	string minLength: 1	ID langganan target.
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.
$filter	query		string	Filter yang akan diterapkan ke operasi.

Respons

Nama	Jenis	Deskripsi
200 OK	PagedUsers	Permintaan berhasil; respons berisi semua pengguna untuk lab yang diberikan.
Other Status Codes	ErrorResponse	Respons kesalahan default.

Contoh

listUser

Permintaan sampel

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

Respon sampel

Kode status:: 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"
      }
    }
  ]
}

Definisi

Nama	Deskripsi
createdByType	Jenis identitas yang membuat sumber daya.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
InvitationState	Status undangan pengguna lab.
PagedUsers	Daftar pengguna yang di-halaman.
ProvisioningState	Status provisi sumber daya pengguna saat ini.
RegistrationState	Status pendaftaran lab pengguna.
ResourceOperationError	Detail kesalahan kegagalan operasi terbaru pada sumber daya ini
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
User	Pengguna lab yang dapat mendaftar dan menggunakan komputer virtual di dalam lab.

createdByType

Enumeration

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

InvitationState

Enumeration

Status undangan pengguna lab.

Nilai	Deskripsi
NotSent	Undangan belum dikirim.
Sending	Saat ini mengirim undangan.
Sent	Undangan berhasil dikirim.
Failed	Terjadi kesalahan saat mengirim undangan.

PagedUsers

Objek

Daftar pengguna yang di-halaman.

Nama	Jenis	Deskripsi
nextLink	string	Tautan untuk mendapatkan halaman hasil gambar berikutnya.
value	User[]	Halaman array hasil pengguna.

ProvisioningState

Enumeration

Status provisi sumber daya pengguna saat ini.

Nilai	Deskripsi
Creating	Sumber daya sedang dalam proses dibuat.
Updating	Nilai properti baru sedang diterapkan ke sumber daya.
Deleting	Sumber daya sedang dalam proses dihapus.
Succeeded	Sumber daya dalam keadaan sehat setelah operasi pembuatan atau pembaruan.
Failed	Operasi sebelumnya pada sumber daya gagal meninggalkan sumber daya dalam keadaan tidak sehat.
Locked	Sumber daya dikunci dan perubahan saat ini diblokir. Ini bisa disebabkan oleh pemeliharaan atau operasi terjadwal. Status akan kembali berhasil setelah operasi penguncian selesai.

RegistrationState

Enumeration

Status pendaftaran lab pengguna.

Nilai	Deskripsi
NotRegistered	Pengguna telah mendaftar di lab.
Registered	Pengguna belum terdaftar di lab.

ResourceOperationError

Objek

Detail kesalahan kegagalan operasi terbaru pada sumber daya ini

Nama	Jenis	Deskripsi
action	string	Tindakan operasi yang gagal
code	string	Kode yang sesuai dengan jenis kegagalan operasi
message	string	Pesan kegagalan operasi
timestamp	string (date-time)	Tanggalwaktu ketika kesalahan terjadi

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

User

Objek

Pengguna lab yang dapat mendaftar dan menggunakan komputer virtual di dalam lab.

Nama	Jenis	Deskripsi
id	string	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nama sumber daya
properties.additionalUsageQuota	string (duration)	Jumlah waktu kuota penggunaan yang didapat pengguna selain kuota penggunaan lab.
properties.displayName	string	Nama tampilan pengguna, misalnya nama lengkap pengguna.
properties.email	string minLength: 6 maxLength: 254	Alamat email pengguna.
properties.invitationSent	string (date-time)	Tanggal dan waktu ketika pesan undangan dikirim ke pengguna.
properties.invitationState	InvitationState	Status pesan undangan untuk pengguna.
properties.provisioningState	ProvisioningState	Status provisi sumber daya pengguna saat ini.
properties.registrationState	RegistrationState	Status pendaftaran pengguna di dalam lab.
properties.resourceOperationError	ResourceOperationError	Detail kesalahan operasi terakhir yang dilakukan pada rencana lab.
properties.totalUsage	string (duration)	Berapa lama pengguna telah menggunakan komputer virtual mereka di lab ini.
systemData	systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya pengguna.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"