Megosztás a következőn keresztül:


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
labPlanName
path True

string

minLength: 1
maxLength: 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.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

subscriptionId
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

PagedImages

A kérés sikeres volt; a rendszer visszaadja a képek listáját

Other Status Codes

ErrorResponse

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
createdByType

Az erőforrást létrehozó identitás típusa.

EnableState

A kép használati feltételeinek állapota (engedélyezve = elfogadva, letiltva = nem elfogadott).

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

Image

Lab services virtuális gép rendszerképe

OsState

A rendszerkép operációs rendszerének állapota.

OsType

A rendszerkép operációs rendszerének típusa.

PagedImages

A Lab services virtuálisgép-rendszerképeinek lapozott listája.

ProvisioningState

A rendszerkép aktuális kiépítési állapota.

systemData

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

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hibacél.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

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

EnableState

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

OsState

A rendszerkép operációs rendszerének állapota.

properties.osType

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

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: 3
maxLength: 2000

A megosztott katalógusban lévő kép azonosítója.

properties.sku

string

A kép termékváltozata.

properties.termsStatus

EnableState

A kép használati feltételeinek állapota (engedélyezve = elfogadva, letiltva = nem elfogadott).

properties.version

string

A kép verziója.

systemData

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

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

createdByType

Az erőforrást legutóbb módosító identitás típusa.