Images - List By Lab Plan
Lekéri a labortervhez csatolt galériák összes képét.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labPlans/{labPlanName}/images?api-version=2023-06-07
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labPlans/{labPlanName}/images?api-version=2023-06-07&$filter={$filter}
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
lab
|
path | True |
string minLength: 1maxLength: 100 |
Annak a labortervnek a neve, amely egyedileg azonosítja azt az erőforráscsoporton belül. Erőforrás-URI-kban és felhasználói felületen használatos. |
resource
|
path | True |
string minLength: 1maxLength: 90 |
Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket. |
subscription
|
path | True |
string minLength: 1 |
A cél-előfizetés azonosítója. |
api-version
|
query | True |
string minLength: 1 |
A művelethez használni kívánt API-verzió. |
$filter
|
query |
string |
A műveletre alkalmazandó szűrő. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
A kérés sikeres volt; a rendszer visszaadja a képek listáját |
|
Other Status Codes |
Az alapértelmezett hibaválasz. |
Példák
listImages
Mintakérelem
GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan/images?api-version=2023-06-07
Mintaválasz
{
"nextLink": null,
"value": [
{
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan/images/image1",
"name": "image1",
"type": "Microsoft.LabServices/Image",
"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": "Windows Server 2019 Datacenter",
"description": "A description of the image",
"osType": "Windows",
"offer": "WindowsServer",
"publisher": "Microsoft",
"sku": "2019-Datacenter",
"version": "2019.0.20190410",
"sharedGalleryId": null,
"enabledState": "Enabled"
}
},
{
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan/images/image2",
"name": "image2",
"type": "Microsoft.LabServices/Image",
"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": "A custom image",
"description": "An example custom image response",
"osType": "Windows",
"offer": null,
"publisher": null,
"sku": null,
"version": null,
"sharedGalleryId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Compute/galleries/sig/images/test-1",
"enabledState": "Enabled"
}
}
]
}
Definíciók
Name | Description |
---|---|
created |
Az erőforrást létrehozó identitás típusa. |
Enable |
A kép használati feltételeinek állapota (engedélyezve = elfogadva, letiltva = nem elfogadott). |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
Hibaválasz |
Image |
Lab services virtuális gép rendszerképe |
Os |
A rendszerkép operációs rendszerének állapota. |
Os |
A rendszerkép operációs rendszerének típusa. |
Paged |
A Lab services virtuálisgép-rendszerképeinek lapozott listája. |
Provisioning |
A rendszerkép aktuális kiépítési állapota. |
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
createdByType
Az erőforrást létrehozó identitás típusa.
Érték | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
EnableState
A kép használati feltételeinek állapota (engedélyezve = elfogadva, letiltva = nem elfogadott).
Érték | Description |
---|---|
Disabled | |
Enabled |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hibacél. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
Image
Lab services virtuális gép rendszerképe
Name | Típus | Alapértelmezett érték | Description |
---|---|---|---|
id |
string |
Az erőforrás teljes erőforrás-azonosítója. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
|
name |
string |
Az erőforrás neve |
|
properties.author |
string |
A kép szerzője. |
|
properties.availableRegions |
string[] |
A kép elérhető régiói a megosztott katalógusban. |
|
properties.description |
string |
A kép leírása. |
|
properties.displayName |
string |
A kép megjelenítendő neve. |
|
properties.enabledState | Disabled |
Engedélyezve van a rendszerkép |
|
properties.iconUrl |
string |
A képikon URL-címe. |
|
properties.offer |
string |
A képhez társított ajánlat azonosítója. |
|
properties.osState |
A rendszerkép operációs rendszerének állapota. |
||
properties.osType |
A rendszerkép operációs rendszerének típusa. |
||
properties.plan |
string |
A rendszerképhez társított Marketplace-csomag azonosítója (nem kötelező). |
|
properties.provisioningState |
A rendszerkép aktuális kiépítési állapota. |
||
properties.publisher |
string |
A kép közzétevőjének azonosítója. |
|
properties.sharedGalleryId |
string minLength: 3maxLength: 2000 |
A megosztott katalógusban lévő kép azonosítója. |
|
properties.sku |
string |
A kép termékváltozata. |
|
properties.termsStatus |
A kép használati feltételeinek állapota (engedélyezve = elfogadva, letiltva = nem elfogadott). |
||
properties.version |
string |
A kép verziója. |
|
systemData |
A kép létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
||
type |
string |
Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
OsState
A rendszerkép operációs rendszerének állapota.
Érték | Description |
---|---|
Generalized |
A rendszerkép nem tartalmaz gép- és felhasználóspecifikus információkat. |
Specialized |
A rendszerkép gép- és felhasználóspecifikus információkat tartalmaz. |
OsType
A rendszerkép operációs rendszerének típusa.
Érték | Description |
---|---|
Linux | |
Windows |
PagedImages
A Lab services virtuálisgép-rendszerképeinek lapozott listája.
Name | Típus | Description |
---|---|---|
nextLink |
string |
A képeredmények következő oldalának lekérésére szolgáló hivatkozás. |
value |
Image[] |
A virtuálisgép-rendszerképek tömboldala. |
ProvisioningState
A rendszerkép aktuális kiépítési állapota.
Érték | Description |
---|---|
Creating |
Az erőforrás létrehozása folyamatban van. |
Deleting |
Az erőforrás törlése folyamatban van. |
Failed |
Az erőforrás előző művelete sikertelen volt, így az erőforrás nem kifogástalan állapotban maradt. |
Locked |
Az erőforrás zárolva van, és a módosítások jelenleg le vannak tiltva. Ennek oka lehet karbantartás vagy ütemezett művelet. Az állapot a zárolási művelet befejeződése után ismét sikeres lesz. |
Succeeded |
Az erőforrás kifogástalan állapotban van a létrehozás vagy a frissítési művelet után. |
Updating |
Új tulajdonságértékek lesznek alkalmazva az erőforrásra. |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
Name | Típus | Description |
---|---|---|
createdAt |
string (date-time) |
Az erőforrás-létrehozás időbélyege (UTC). |
createdBy |
string |
Az erőforrást létrehozó identitás. |
createdByType |
Az erőforrást létrehozó identitás típusa. |
|
lastModifiedAt |
string (date-time) |
Az erőforrás utolsó módosításának időbélyege (UTC) |
lastModifiedBy |
string |
Az erőforrást legutóbb módosító identitás. |
lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |