Pools - List Supported Images

Hizmet:: Batch Service

API Sürümü:: 2025-06-01

Azure Batch hizmeti tarafından desteklenen tüm Sanal Makine Görüntülerini listeler.

GET {endpoint}/supportedimages?api-version=2025-06-01

İsteğe bağlı parametrelerle:

GET {endpoint}/supportedimages?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$filter={$filter}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string (uri)	Batch hesabı uç noktası (örneğin: https://batchaccount.eastus2.batch.azure.com).
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.
$filter	query		string	OData $filter yan tümcesi. Bu filtrenin oluşturulması hakkında daha fazla bilgi için bkz.https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-support-images
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Yanıtta döndürülecek en fazla öğe sayısı. En fazla 1000 başvuru iade edilebilir.
timeOut	query		integer (int32)	Sunucunun isteği işlemek için harcayabileceği en uzun süre (saniye cinsinden). Varsayılan değer 30 saniyedir. Değer 30'dan büyükse, varsayılan kullanılacaktır.".

İstek Başlığı

Name	Tür	Description
client-request-id	string	Arayan tarafından oluşturulan istek kimliği, küme ayraçları gibi süslemesi olmayan bir GUID biçiminde, örneğin 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Sunucunun yanıtta client-request-id döndürip döndürmeyeceği.
ocp-date	string (date-time-rfc7231)	İsteğin verildiği saat. İstemci kitaplıkları bunu genellikle geçerli sistem saat saatine ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın.

Yanıtlar

Name	Tür	Description
200 OK	BatchAccountListSupportedImagesResult	İstek başarılı oldu. Üst Bilgiler ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Beklenmeyen bir hata yanıtı.

Name

Tür

Description

200 OK

BatchAccountListSupportedImagesResult

İstek başarılı oldu.

Üst Bilgiler

ETag: string
Last-Modified: string
client-request-id: string
request-id: string

Other Status Codes

BatchError

Beklenmeyen bir hata yanıtı.

Güvenlik

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Kapsamlar

Name	Description
https://batch.core.windows.net//.default

Örnekler

Account list node agent skus

Örnek isteği

HTTP

GET {endpoint}/supportedimages?api-version=2025-06-01

Örnek yanıt

Durum kodu:: 200

{
  "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"
    }
  ]
}

Tanımlar

Name	Description
BatchAccountListSupportedImagesResult	Desteklenen Sanal Makine Görüntülerini listelemenin sonucu.
BatchError	Azure Batch hizmetinden alınan bir hata yanıtı.
BatchErrorDetail	Azure Batch hata yanıtına dahil edilen ek bilgilerden oluşan bir öğe.
BatchErrorMessage	Azure Batch hata yanıtında bir hata iletisi alındı.
BatchSupportedImage	Azure Sanal Makineler Market Görüntüsüne yönelik bir başvuru ve Görüntü hakkında ek bilgiler.
BatchVmImageReference	Azure Sanal Makineler Market Görüntüsüne veya Azure İşlem Galerisi Görüntüsüne başvuru. Azure Batch tarafından doğrulanan tüm Azure Market Görüntüsü başvurularının listesini almak için ' Desteklenen Görüntüleri Listele' işlemine bakın.
ImageVerificationType	ImageVerificationType enums
OSType	OSType enums

BatchAccountListSupportedImagesResult

Nesne

Desteklenen Sanal Makine Görüntülerini listelemenin sonucu.

Name	Tür	Description
odata.nextLink	string (uri)	Bir sonraki sonuç kümesini almak için URL.
value	BatchSupportedImage[]	Desteklenen Sanal Makine Görüntüleri listesi.

BatchError

Nesne

Azure Batch hizmetinden alınan bir hata yanıtı.

Name	Tür	Description
code	string	Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
message	BatchErrorMessage	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.
values	BatchErrorDetail[]	Hata hakkında ek ayrıntılar içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

Nesne

Azure Batch hata yanıtına dahil edilen ek bilgilerden oluşan bir öğe.

Name	Tür	Description
key	string	Value özelliğinin anlamını belirten tanımlayıcı.
value	string	Hata yanıtına eklenen ek bilgiler.

BatchErrorMessage

Nesne

Azure Batch hata yanıtında bir hata iletisi alındı.

Name	Tür	Description
lang	string	Hata mesajının dil kodu.
value	string	İletinin metni.

BatchSupportedImage

Nesne

Azure Sanal Makineler Market Görüntüsüne yönelik bir başvuru ve Görüntü hakkında ek bilgiler.

Name	Tür	Description
batchSupportEndOfLife	string (date-time)	Azure Batch servisinin Image için Havuz istekleri oluşturma isteklerini kabul etmeyi durduracağı zaman.
capabilities	string[]	Görüntünün desteklediği yetenekler veya özellikler. Görüntünün her yeteneği listelenmemiştir. Bu listedeki yetenekler özel ilgi alanı olarak kabul edilir ve genellikle Azure Batch hizmetindeki diğer özelliklerle entegrasyonla ilgilidir.
imageReference	BatchVmImageReference	Azure Virtual Machine'in Marketplace Image'ine referans.
nodeAgentSKUId	string	Image'in desteklediği Compute Node ajanı SKU'nun kimliği.
osType	OSType	Görüntünün işletim sistemi türü (örneğin Windows veya Linux).
verificationType	ImageVerificationType	Azure Batch servisinin Image'in ilgili Compute Node ajanı SKU ile uyumlu olup olmadığını aktif olarak doğrulayıp doğrulamayacağı.

BatchVmImageReference

Nesne

Azure Sanal Makineler Market Görüntüsüne veya Azure İşlem Galerisi Görüntüsüne başvuru. Azure Batch tarafından doğrulanan tüm Azure Market Görüntüsü başvurularının listesini almak için ' Desteklenen Görüntüleri Listele' işlemine bakın.

Name	Tür	Description
communityGalleryImageId	string	Topluluk galerisi görseli benzersiz tanımlayıcı. Bu özellik diğer özelliklerle birbirini dışlar ve topluluk galerisi görüntüsü GET çağrısından getirilebilir.
exactVersion	string	Düğümü oluşturmak için kullanılan platform görselinin veya pazar yeri görgesinin özel versiyonu. Bu yalnızca okunabilir alan, havuz oluşturulduğunda 'sürüm' için belirtilen değer 'verim' ise 'sürüm'den farklıdır.
offer	string	Azure Virtual Machines Marketplace Image'in teklif türü. Örneğin, UbuntuServer veya WindowsServer.
publisher	string	Azure Virtual Machines Marketplace Image'in yayıncısı. Örneğin, Canonical veya MicrosoftWindowsServer.
sharedGalleryImageId	string	Paylaşılan galeri görseli benzersiz tanımlayıcı. Bu özellik diğer özelliklerle birbirini dışlar ve paylaşılan galeri görüntüsü GET çağrısından getirilebilir.
sku	string	Azure Virtual Machines Marketplace Image'in SKU'su. Örneğin, 18.04-LTS veya 2019-Datacenter.
version	string	Azure Virtual Machines Marketplace Image'in versiyonu. Bir Görselin en son sürümünü seçmek için 'en son' değeri belirtilebilir. Atlanırsa, varsayılan değer 'en son' olur.
virtualMachineImageId	string (arm-id)	Azure İşlem Galerisi Görüntüsünün ARM kaynak tanımlayıcısı. Havuzdaki hesaplama düğümleri bu Görsel Kimliği kullanılarak oluşturulacaktır. Bu, /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} veya /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} biçimindedir ve her zaman en son resim sürümüne geçebilirsiniz. Bu özellik, diğer ImageReference özellikleriyle birbirini dışlar. Azure Compute Gallery Image'in aynı bölgede replikaları olmalı ve Azure Batch hesabıyla aynı abonelikte olması gerekir. Eğer imageId'de görüntü sürümü belirtilmemişse, en son sürüm kullanılır. Batch Compute Node ajanının Batch servisiyle iletişim kurması için güvenlik duvarı ayarları hakkında bilgi için bkz.https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration

ImageVerificationType

Numaralandırma

ImageVerificationType enums

Değer	Description
verified	Görüntü, ilgili Compute Node ajanı SKU ile uyumlu olacağı garanti ediliyor ve tüm Batch özelliklerinin beklendiği gibi çalıştığı doğrulanmıştır.
unverified	İlgili Compute Node ajanı SKU, Image ile ikili uyumlu olmalıdır, ancak belirli işlevler doğrulanmamıştır.

OSType

Numaralandırma

OSType enums

Değer	Description
linux	Linux işletim sistemi.
windows	Windows işletim sistemi.

Aracılığıyla paylaş

Pools - List Supported Images

URI Parametreleri

İstek Başlığı

Yanıtlar

Güvenlik

OAuth2Auth

Kapsamlar

Örnekler

Account list node agent skus

Örnek isteği

Örnek yanıt

Tanımlar

BatchAccountListSupportedImagesResult

BatchError

BatchErrorDetail

BatchErrorMessage

BatchSupportedImage

BatchVmImageReference

ImageVerificationType

OSType