Account - List Supported Images

Felsorolja az Azure Batch szolgáltatás által támogatott összes virtuálisgép-rendszerképet.

GET {batchUrl}/supportedimages?api-version=2023-11-01.18.0
GET {batchUrl}/supportedimages?$filter={$filter}&maxresults={maxresults}&timeout={timeout}&api-version=2023-11-01.18.0

URI-paraméterek

Name In Kötelező Típus Description
batchUrl
path True

string

Az összes Azure Batch szolgáltatáskérés alap URL-címe.

api-version
query True

string

Ügyfél API-verziója.

$filter
query

string

Egy OData $filter záradék. A szűrő felépítésével kapcsolatos további információkért lásd: https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-support-images.

maxresults
query

integer

int32

A válaszban visszaadandó elemek maximális száma. A rendszer legfeljebb 1000 eredményt ad vissza.

timeout
query

integer

int32

A kérés feldolgozásának maximális időtartama másodpercben. Az alapértelmezett érték 30 mp.

Kérelem fejléce

Media Types: "application/json; odata=minimalmetadata"

Name Kötelező Típus Description
client-request-id

string

uuid

A hívó által generált kérési identitás, olyan GUID formátumban, amely nem rendelkezik díszítéssel, például kapcsos zárójelekkel, például 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Azt határozza meg, hogy a kiszolgálónak vissza kell-e küldenie a válaszban szereplő client-request-id azonosítót.

ocp-date

string

date-time-rfc1123

A kérelem kiállításának időpontja. Az ügyfélkódtárak ezt általában az aktuális rendszeróraidőre állítják be; állítsa be explicit módon, ha a REST API-t közvetlenül hívja meg.

Válaszok

Name Típus Description
200 OK

AccountListSupportedImagesResult

A támogatott virtuálisgép-rendszerképek listáját tartalmazó válasz.

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
Other Status Codes

BatchError

A Batch szolgáltatás hibája.

Biztonság

azure_auth

Microsoft Entra OAuth 2.0 hitelesítési kódfolyamata

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation A felhasználói fiók megszemélyesítése

Authorization

Type: apiKey
In: header

Példák

Account list node agent skus

Sample Request

GET account.region.batch.azure.com/supportedimages?api-version=2023-11-01.18.0


Sample Response

{
  "value": [
    {
      "nodeAgentSKUId": "batch.node.centos 7",
      "imageReference": {
        "publisher": "OpenLogic",
        "offer": "CentOS",
        "sku": "7.2",
        "version": "latest"
      },
      "verificationType": "verified",
      "capabilities": [
        "DockerCompatible",
        "NvidiaTeslaDriverInstalled"
      ],
      "osType": "linux"
    },
    {
      "nodeAgentSKUId": "batch.node.centos 7",
      "imageReference": {
        "publisher": "OpenLogic",
        "offer": "CentOS",
        "sku": "7.1",
        "version": "latest"
      },
      "verificationType": "unverified",
      "osType": "linux",
      "batchSupportEndOfLife": "2019-11-01T00:00:00.0Z"
    },
    {
      "nodeAgentSKUId": "batch.node.debian 8",
      "imageReference": {
        "publisher": "Credativ",
        "offer": "Debian",
        "sku": "8",
        "version": "latest"
      },
      "verificationType": "verified",
      "osType": "linux"
    },
    {
      "nodeAgentSKUId": "batch.node.windows amd64",
      "imageReference": {
        "publisher": "MicrosoftWindowsServer",
        "offer": "WindowsServer",
        "sku": "2012-R2-Datacenter",
        "version": "latest"
      },
      "verificationType": "verified",
      "osType": "windows"
    },
    {
      "nodeAgentSKUId": "batch.node.windows amd64",
      "imageReference": {
        "publisher": "MicrosoftWindowsServer",
        "offer": "WindowsServer",
        "sku": "2012-Datacenter",
        "version": "latest"
      },
      "verificationType": "verified",
      "osType": "windows"
    }
  ]
}

Definíciók

Name Description
AccountListSupportedImagesResult

A támogatott virtuálisgép-rendszerképek listázásának eredménye.

BatchError

Hibaválasz érkezett a Azure Batch szolgáltatástól.

BatchErrorDetail

Egy Azure Batch hibaválaszban szereplő további információk egy eleme.

ErrorMessage

Hibaüzenet érkezett egy Azure Batch hibaválaszban.

ImageInformation

Hivatkozás az Azure Virtual Machines Marketplace rendszerképére és a rendszerképre vonatkozó további információkra.

ImageReference

Hivatkozás egy Azure Virtual Machines Marketplace-rendszerképre vagy egy Azure Compute Gallery-rendszerképre. A Azure Batch által ellenőrzött Azure Marketplace képhivatkozások listájának megtekintéséhez tekintse meg a "Támogatott képek listázása" műveletet.

OSType

A lemezkép operációs rendszerének típusa (például Windows vagy Linux).

VerificationType

Azt, hogy a Azure Batch szolgáltatás aktívan ellenőrzi-e, hogy a rendszerkép kompatibilis-e a társított Számítási csomópont ügynök termékváltozatával.

AccountListSupportedImagesResult

A támogatott virtuálisgép-rendszerképek listázásának eredménye.

Name Típus Description
odata.nextLink

string

A következő találatkészlet lekéréséhez tartozó URL-cím.

value

ImageInformation[]

A támogatott virtuálisgép-rendszerképek listája.

BatchError

Hibaválasz érkezett a Azure Batch szolgáltatástól.

Name Típus Description
code

string

A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.

message

ErrorMessage

A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.

values

BatchErrorDetail[]

Kulcs-érték párok gyűjteménye, amely további részleteket tartalmaz a hibáról.

BatchErrorDetail

Egy Azure Batch hibaválaszban szereplő további információk egy eleme.

Name Típus Description
key

string

Egy azonosító, amely az Érték tulajdonság jelentését adja meg.

value

string

A hibaválaszban szereplő további információk.

ErrorMessage

Hibaüzenet érkezett egy Azure Batch hibaválaszban.

Name Típus Description
lang

string

A hibaüzenet nyelvkódja

value

string

Az üzenet szövege.

ImageInformation

Hivatkozás az Azure Virtual Machines Marketplace rendszerképére és a rendszerképre vonatkozó további információkra.

Name Típus Description
batchSupportEndOfLife

string

Az az idő, amikor a Azure Batch szolgáltatás nem fogadja el a rendszerképhez tartozó készlet létrehozására vonatkozó kéréseket.

capabilities

string[]

A kép által támogatott képességek vagy funkciók.
A rendszerkép nem minden képessége szerepel a listában. A listában szereplő képességek különleges érdeklődésnek minősülnek, és általában az Azure Batch szolgáltatás más funkcióival való integrációhoz kapcsolódnak.

imageReference

ImageReference

Az Azure-beli virtuális gép Marketplace-rendszerképére mutató hivatkozás.

nodeAgentSKUId

string

A Számítási csomópont ügynök termékváltozatának azonosítója, amelyet a rendszerkép támogat.

osType

OSType

A lemezkép operációs rendszerének típusa (például Windows vagy Linux).

verificationType

VerificationType

Azt, hogy a Azure Batch szolgáltatás aktívan ellenőrzi-e, hogy a rendszerkép kompatibilis-e a társított Számítási csomópont ügynök termékváltozatával.

ImageReference

Hivatkozás egy Azure Virtual Machines Marketplace-rendszerképre vagy egy Azure Compute Gallery-rendszerképre. A Azure Batch által ellenőrzött Azure Marketplace képhivatkozások listájának megtekintéséhez tekintse meg a "Támogatott képek listázása" műveletet.

Name Típus Description
exactVersion

string

A csomópont létrehozásához használt platformrendszerkép vagy piactéri rendszerkép adott verziója. Ez az írásvédett mező csak akkor különbözik a "verzió" mezőtől, ha a készlet létrehozásakor a "verzió" érték a "legújabb" volt.

offer

string

Az Azure Virtual Machines Marketplace-rendszerkép ajánlattípusa.
Például: UbuntuServer vagy WindowsServer.

publisher

string

Az Azure Virtual Machines Marketplace-rendszerkép közzétevője.
Például: Canonical vagy MicrosoftWindowsServer.

sku

string

Az Azure Virtual Machines Marketplace-rendszerkép termékváltozata.
Például: 18.04-LTS vagy 2019-Datacenter.

version

string

Az Azure Virtual Machines Marketplace-rendszerkép verziója.
A rendszerkép legújabb verziójának kiválasztásához megadható a "latest" (legújabb) érték. Ha nincs megadva, az alapértelmezett érték a "latest".

virtualMachineImageId

string

Az Azure Compute Gallery rendszerképének ARM-erőforrásazonosítója. A készlet számítási csomópontjai ezzel a rendszerkép-azonosítóval jönnek létre. Ez a /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} vagy /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName} formában jelenik meg, mindig a legújabb rendszerképverzióra alapértelmezettként.
Ez a tulajdonság kölcsönösen kizárja a többi ImageReference tulajdonságot. Az Azure Compute-katalógus rendszerképének replikáinak ugyanabban a régióban kell lenniük, és ugyanabban az előfizetésben kell lenniük, mint a Azure Batch-fióknak. Ha a rendszerkép verziója nincs megadva az imageId azonosítóban, a rendszer a legújabb verziót használja. A Batch számítási csomópont ügynökének a Batch szolgáltatással való kommunikációjának tűzfalbeállításaival kapcsolatos információkért lásd: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

OSType

A lemezkép operációs rendszerének típusa (például Windows vagy Linux).

Name Típus Description
linux

string

A Linux operációs rendszer.

windows

string

A Windows operációs rendszer.

VerificationType

Azt, hogy a Azure Batch szolgáltatás aktívan ellenőrzi-e, hogy a rendszerkép kompatibilis-e a társított Számítási csomópont ügynök termékváltozatával.

Name Típus Description
unverified

string

A társított Számítási csomópont ügynök termékváltozatának bináris kompatibilitással kell rendelkeznie a rendszerképpel, de a rendszer nem igazolt bizonyos funkciókat.

verified

string

A rendszerkép garantáltan kompatibilis a társított Számítási csomópont ügynök termékváltozatával, és minden Batch-funkció a várt módon működik.