Labs - List By Subscription
Rufen Sie alle Labs für ein Abonnement ab.
Gibt eine Liste aller Labs für ein Abonnement zurück.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.LabServices/labs?api-version=2023-06-07
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.LabServices/labs?api-version=2023-06-07&$filter={$filter}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
subscription
|
path | True |
string |
Hierbei handelt es sich um die ID des Zielabonnements. |
api-version
|
query | True |
string |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
$filter
|
query |
string |
Der Filter, der auf den Vorgang angewendet werden soll. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die Anforderung war erfolgreich; response enthält alle Labs für das angegebene Abonnement. |
|
Other Status Codes |
Die Standardfehlerantwort. |
Beispiele
listLabs
Sample Request
GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.LabServices/labs?api-version=2023-06-07
Sample Response
{
"nextLink": null,
"value": [
{
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labs/testlab",
"name": "testlabplan",
"type": "Microsoft.LabServices/Lab",
"location": "westus",
"systemData": {
"createdBy": "identity123",
"createdByType": "User",
"createdAt": "2020-05-01T10:00:00Z",
"lastModifiedBy": "identity123",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-06-01T09:12:28Z"
},
"properties": {
"provisioningState": "Succeeded",
"connectionProfile": {
"webSshAccess": "None",
"webRdpAccess": "None",
"clientSshAccess": "Public",
"clientRdpAccess": "Public"
},
"autoShutdownProfile": {
"shutdownOnDisconnect": "Enabled",
"shutdownWhenNotConnected": "Enabled",
"shutdownOnIdle": "UserAbsence",
"disconnectDelay": "PT5M",
"noConnectDelay": "PT5M",
"idleDelay": "PT5M"
},
"securityProfile": {
"registrationCode": "fAkEcodE",
"openAccess": "Disabled"
},
"networkProfile": {
"subnetId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
},
"virtualMachineProfile": {
"createOption": "TemplateVM",
"imageReference": {
"offer": "WindowsServer",
"publisher": "Microsoft",
"sku": "2019-Datacenter",
"version": "2019.0.20190410"
},
"osType": "Windows",
"sku": {
"name": "Medium",
"capacity": 20
},
"additionalCapabilities": {
"installGpuDrivers": "Disabled"
},
"usageQuota": "PT10H",
"useSharedPassword": "Disabled",
"adminUser": {
"username": "test-user"
}
},
"title": "Test Lab",
"description": "This is a test lab.",
"labPlanId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan",
"state": "Draft"
}
}
]
}
Definitionen
Name | Beschreibung |
---|---|
Auto |
Profil zum Behandeln des Herunterfahrens virtueller Computer. |
Connection |
Verbindungsprofil für die Verbindungsherstellung von Benutzern mit virtuellen Labcomputern. |
Connection |
Die aktivierte Zugriffsebene für Den Webzugriff über SSH. |
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Create |
Gibt an, aus welchen lab-VMs erstellt werden. |
Credentials |
Anmeldeinformationen für einen Benutzer auf einer Lab-VM. |
Enable |
Gibt an, ob das Herunterfahren beim Trennen aktiviert ist. |
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
Image |
Bildreferenzinformationen. Wird im VM-Profil verwendet. |
Lab |
Die Labressource. |
Lab |
Profil für den Umgang mit Netzwerken für Labs. |
Lab |
Der Status eines virtuellen Computers. |
Os |
Der Betriebssystemtyp des Images |
Paged |
Ausgelagerte Liste der Labs. |
Provisioning |
Aktueller Bereitstellungsstatus des Labs. |
Resource |
Fehlerdetails des letzten Vorgangsfehlers für diese Ressource |
Roster |
Das Verwaltungsprofil für die Lab-Benutzerliste. |
Security |
Das Lab-Sicherheitsprofil. |
shutdown |
Definiert, ob der virtuelle Computer im Leerlauf heruntergefahren werden soll, und die Kriterien für die Leerlauferkennung. |
Sku |
Die Ressourcenmodelldefinition, die die SKU darstellt |
Sku |
Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst über mehrere Ebenen verfügt, aber für einen PUT nicht erforderlich ist. |
system |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
Virtual |
Die zusätzlichen Funktionen für eine Lab-VM. |
Virtual |
Die Konfiguration des virtuellen Basiscomputers für ein Lab. |
AutoShutdownProfile
Profil zum Behandeln des Herunterfahrens virtueller Computer.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
disconnectDelay |
string |
Die Zeitspanne, in der eine VM ausgeführt wird, nachdem ein Benutzer die Verbindung getrennt hat, wenn dieses Verhalten aktiviert ist. |
|
idleDelay |
string |
Die Zeitspanne, die eine VM im Leerlauf hält, bevor sie heruntergefahren wird, wenn dieses Verhalten aktiviert ist. |
|
noConnectDelay |
string |
Die Dauer, in der eine VM ausgeführt wird, bevor sie heruntergefahren wird, wenn keine Verbindung hergestellt wird und dieses Verhalten aktiviert ist. |
|
shutdownOnDisconnect | Disabled |
Gibt an, ob das Herunterfahren beim Trennen aktiviert ist. |
|
shutdownOnIdle | None |
Gibt an, ob ein virtueller Computer heruntergefahren wird, wenn er sich für einen bestimmten Zeitraum im Leerlauf befindet. |
|
shutdownWhenNotConnected | Disabled |
Gibt an, ob ein virtueller Computer heruntergefahren wird, wenn er nach einem bestimmten Zeitraum nicht mehr verbunden wurde. |
ConnectionProfile
Verbindungsprofil für die Verbindungsherstellung von Benutzern mit virtuellen Labcomputern.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
clientRdpAccess | None |
Die aktivierte Zugriffsebene für den Clientzugriff über RDP. |
|
clientSshAccess | None |
Die aktivierte Zugriffsebene für den Clientzugriff über SSH. |
|
webRdpAccess | None |
Die aktivierte Zugriffsebene für Den Webzugriff über RDP. |
|
webSshAccess | None |
Die aktivierte Zugriffsebene für Den Webzugriff über SSH. |
ConnectionType
Die aktivierte Zugriffsebene für Den Webzugriff über SSH.
Name | Typ | Beschreibung |
---|---|---|
None |
string |
|
Private |
string |
|
Public |
string |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Name | Typ | Beschreibung |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
CreateOption
Gibt an, aus welchen lab-VMs erstellt werden.
Name | Typ | Beschreibung |
---|---|---|
Image |
string |
Ein Image wird verwendet, um alle virtuellen Computer für Labbenutzer zu erstellen. Wenn diese Option festgelegt ist, wird keine Vorlagen-VM erstellt. |
TemplateVM |
string |
Eine Vorlagen-VM wird verwendet, um alle virtuellen Computer für Labbenutzer zu erstellen. |
Credentials
Anmeldeinformationen für einen Benutzer auf einer Lab-VM.
Name | Typ | Beschreibung |
---|---|---|
password |
string |
Das Kennwort für den Benutzer. Dies ist für templateVM createOption erforderlich. |
username |
string |
Der Benutzername, der bei der Anmeldung bei Lab-VMs verwendet werden soll. |
EnableState
Gibt an, ob das Herunterfahren beim Trennen aktiviert ist.
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ErrorAdditionalInfo
Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Zusätzliche Informationen. |
type |
string |
Typ der zusätzlichen Informationen. |
ErrorDetail
Die Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Fehlerinformationen. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
ImageReference
Bildreferenzinformationen. Wird im VM-Profil verwendet.
Name | Typ | Beschreibung |
---|---|---|
exactVersion |
string |
Die tatsächliche Version des Images nach der Verwendung. |
id |
string |
Imageressourcen-ID |
offer |
string |
Das Imageangebot, falls zutreffend. |
publisher |
string |
Der Imageherausgeber |
sku |
string |
Die Image-SKU |
version |
string |
Die bei der Erstellung angegebene Imageversion. |
Lab
Die Labressource.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Der geografische Standort, an dem sich die Ressource befindet |
name |
string |
Der Name der Ressource |
properties.autoShutdownProfile |
Die Konfiguration für das automatische Herunterfahren der Ressource für das Lab. Dadurch wird gesteuert, ob Aktionen für Ressourcen ausgeführt werden, die sich im Leerlauf befinden. |
|
properties.connectionProfile |
Das Verbindungsprofil für das Lab. Dadurch werden Einstellungen wie der Webzugriff auf Labressourcen oder ob RDP- oder SSH-Ports geöffnet sind, gesteuert. |
|
properties.description |
string |
Die Beschreibung des Labs. |
properties.labPlanId |
string |
Die ID des Labplans. Wird während der Ressourcenerstellung verwendet, um Standardwerte bereitzustellen, und fungiert als Berechtigungscontainer, wenn ein Lab über labs.azure.com erstellt wird. Das Festlegen einer labPlanId für ein vorhandenes Lab bietet organization.. |
properties.networkProfile |
Das Netzwerkprofil für das Lab, das in der Regel über einen Labplan angewendet wird. Dieses Profil kann nicht geändert werden, nachdem ein Lab erstellt wurde. |
|
properties.provisioningState |
Aktueller Bereitstellungsstatus des Labs. |
|
properties.resourceOperationError |
Fehlerdetails des letzten Vorgangs, der im Lab ausgeführt wurde. |
|
properties.rosterProfile |
Das Verwaltungsprofil für die Lab-Benutzerliste. |
|
properties.securityProfile |
Das Lab-Sicherheitsprofil. |
|
properties.state |
Der Labzustand. |
|
properties.title |
string |
Der Titel des Labs. |
properties.virtualMachineProfile |
Das Profil, das zum Erstellen von virtuellen Labcomputern verwendet wird. |
|
systemData |
Metadaten, die sich auf die Erstellung und letzte Änderung des Labs beziehen. |
|
tags |
object |
Ressourcentags. |
type |
string |
Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
LabNetworkProfile
Profil für den Umgang mit Netzwerken für Labs.
Name | Typ | Beschreibung |
---|---|---|
loadBalancerId |
string |
Die Ressourcen-ID des externen Lastenausgleichs |
publicIpId |
string |
Die ressourcen-ID der externen öffentlichen IP-Adresse |
subnetId |
string |
Die Ressourcen-ID des externen Subnetzes |
LabState
Der Status eines virtuellen Computers.
Name | Typ | Beschreibung |
---|---|---|
Draft |
string |
Das Lab befindet sich derzeit im Entwurf (wurde nicht veröffentlicht). |
Published |
string |
Das Lab wurde veröffentlicht. |
Publishing |
string |
Das Lab wird veröffentlicht. |
Scaling |
string |
Das Lab wird skaliert. |
Syncing |
string |
Das Lab synchronisiert Benutzer. |
OsType
Der Betriebssystemtyp des Images
Name | Typ | Beschreibung |
---|---|---|
Linux |
string |
|
Windows |
string |
PagedLabs
Ausgelagerte Liste der Labs.
Name | Typ | Beschreibung |
---|---|---|
nextLink |
string |
Der Link zum Abrufen der nächsten Seite der Bildergebnisse. |
value |
Lab[] |
Die Arrayseite der Labergebnisse. |
ProvisioningState
Aktueller Bereitstellungsstatus des Labs.
Name | Typ | Beschreibung |
---|---|---|
Creating |
string |
Die Ressource wird gerade erstellt. |
Deleting |
string |
Die Ressource wird gerade gelöscht. |
Failed |
string |
Beim vorherigen Vorgang für die Ressource ist ein Fehler aufgetreten, und die Ressource wurde in einem fehlerhaften Zustand belassen. |
Locked |
string |
Die Ressource ist gesperrt, und Änderungen werden derzeit blockiert. Dies kann auf eine Wartung oder einen geplanten Betrieb zurückzuführen sein. Nach Abschluss des Sperrvorgangs wechselt der Status zurück zu "erfolgreich". |
Succeeded |
string |
Die Ressource befindet sich nach dem Erstellungs- oder Aktualisierungsvorgang in einem fehlerfreien Zustand. |
Updating |
string |
Neue Eigenschaftswerte werden auf die Ressource angewendet. |
ResourceOperationError
Fehlerdetails des letzten Vorgangsfehlers für diese Ressource
Name | Typ | Beschreibung |
---|---|---|
action |
string |
Die fehlgeschlagene Vorgangsaktion |
code |
string |
Der Code, der dem Typ des Vorgangsfehlers entspricht |
message |
string |
Meldung zum Vorgangsfehler |
timestamp |
string |
Datetime des Fehlers |
RosterProfile
Das Verwaltungsprofil für die Lab-Benutzerliste.
Name | Typ | Beschreibung |
---|---|---|
activeDirectoryGroupId |
string |
Die AAD-Gruppen-ID, aus der diese Labliste aufgefüllt wird. Durch diesen Satz wird der AAD-Synchronisierungsmodus aktiviert. |
lmsInstance |
string |
Der Basis-URI, der die lms-instance. |
ltiClientId |
string |
Die eindeutige ID des Azure Lab Services-Tools in lms. |
ltiContextId |
string |
Der eindeutige Kontextbezeichner für das Lab im lms. |
ltiRosterEndpoint |
string |
Der URI des Namens- und Rollendienstendpunkts im lms für die Klasse, die an dieses Lab angefügt ist. |
SecurityProfile
Das Lab-Sicherheitsprofil.
Name | Typ | Beschreibung |
---|---|---|
openAccess |
Gibt an, ob sich ein beliebiger Oder nur ein angegebener Benutzer bei einem Lab registrieren kann. |
|
registrationCode |
string |
Der Registrierungscode für das Lab. |
shutdownOnIdleMode
Definiert, ob der virtuelle Computer im Leerlauf heruntergefahren werden soll, und die Kriterien für die Leerlauferkennung.
Name | Typ | Beschreibung |
---|---|---|
LowUsage |
string |
Der virtuelle Computer wird als Leerlauf betrachtet, wenn der Benutzer abwesend ist und der Ressourcenverbrauch (CPU und Datenträger) gering ist. |
None |
string |
Der virtuelle Computer wird nicht heruntergefahren, wenn er sich im Leerlauf befindet. |
UserAbsence |
string |
Der virtuelle Computer wird als Leerlauf betrachtet, wenn keine Tastatur- oder Mauseingabe vorhanden ist. |
Sku
Die Ressourcenmodelldefinition, die die SKU darstellt
Name | Typ | Beschreibung |
---|---|---|
capacity |
integer |
Wenn die SKU horizontales/horizontales Hochskalieren unterstützt, sollte die Kapazitäts-Ganzzahl eingeschlossen werden. Wenn horizontales/in für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. |
family |
string |
Wenn der Dienst über unterschiedliche Hardwaregenerationen für dieselbe SKU verfügt, kann dies hier erfasst werden. |
name |
string |
Der Name der SKU. Beispiel: P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode. |
size |
string |
Die SKU-Größe. Wenn das Namensfeld die Kombination aus Ebene und einem anderen Wert ist, wäre dies der eigenständige Code. |
tier |
Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst über mehrere Ebenen verfügt, aber für einen PUT nicht erforderlich ist. |
SkuTier
Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst über mehrere Ebenen verfügt, aber für einen PUT nicht erforderlich ist.
Name | Typ | Beschreibung |
---|---|---|
Basic |
string |
|
Free |
string |
|
Premium |
string |
|
Standard |
string |
systemData
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
Name | Typ | Beschreibung |
---|---|---|
createdAt |
string |
Der Zeitstempel der Ressourcenerstellung (UTC). |
createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
lastModifiedAt |
string |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
VirtualMachineAdditionalCapabilities
Die zusätzlichen Funktionen für eine Lab-VM.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
installGpuDrivers | Disabled |
Kennzeichnen Sie die Vorinstallation dedizierter GPU-Treiber. |
VirtualMachineProfile
Die Konfiguration des virtuellen Basiscomputers für ein Lab.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
additionalCapabilities |
Zusätzliche VM-Funktionen. |
||
adminUser |
Anmeldeinformationen für den Administratorbenutzer auf dem virtuellen Computer. |
||
createOption |
Gibt an, aus welchen lab-VMs erstellt werden. |
||
imageReference |
Die Imagekonfiguration für lab-VMs. |
||
nonAdminUser |
Anmeldeinformationen für den Benutzer ohne Administratorrechte auf dem virtuellen Computer, sofern vorhanden. |
||
osType |
Der Betriebssystemtyp des Images |
||
sku |
Die SKU für das Lab. Definiert den Typ der virtuellen Computer, die im Lab verwendet werden. |
||
usageQuota |
string |
Das anfängliche Kontingent, das jedem Labbenutzer zugewiesen wird. Muss eine Zeitspanne zwischen 0 und 9999 Stunden sein. |
|
useSharedPassword | Disabled |
Wenn Sie diese Option aktivieren, wird für alle Benutzer-VMs dasselbe Kennwort verwendet. |