Account - List Supported Images

Başvuru

Hizmet:: Batch Service

API Sürümü:: 2023-11-01.18.0

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

GET {batchUrl}/supportedimages?api-version=2023-11-01.18.0

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
batchUrl	path	True	string	Tüm Azure Batch hizmet isteklerinin temel URL'si.
api-version	query	True	string	İstemci API Sürümü.
$filter	query		string	OData $filter yan tümcesi. Bu filtreyi oluşturma hakkında daha fazla bilgi için bkz https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-support-images. .
maxresults	query		integer int32	Yanıtta döndürülecek en fazla öğe sayısı. En fazla 1000 sonuç döndürülür.
timeout	query		integer int32	Sunucunun isteği işlemek için harcayabileceği en uzun süre (saniye olarak). Varsayılan değer 30 saniyedir.

İstek Başlığı

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

Name	Tür	Description
client-request-id	string uuid	Çağıranın oluşturduğu istek kimliği, küme ayraçları gibi süsleme içermeyen bir GUID biçimindedir; ö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-rfc1123	İsteğin verildiği saat. İstemci kitaplıkları bunu genellikle geçerli sistem saat saati olarak ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın.

Yanıtlar

Name	Tür	Description
200 OK	AccountListSupportedImagesResult	Desteklenen Sanal Makine Görüntülerinin listesini içeren bir yanıt. Üst Bilgiler client-request-id: string request-id: string ETag: string Last-Modified: string
Other Status Codes	BatchError	Batch hizmetinden gelen hata.

Name

Tür

Description

200 OK

AccountListSupportedImagesResult

Desteklenen Sanal Makine Görüntülerinin listesini içeren bir yanıt.

Üst Bilgiler

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

Other Status Codes

BatchError

Batch hizmetinden gelen hata.

Güvenlik

azure_auth

OAuth 2.0 kimlik doğrulama kodu akışını Microsoft Entra

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

Kapsamlar

Name	Description
user_impersonation	Kullanıcı hesabınızın kimliğine bürünme

Authorization

Tür: apiKey
İçinde: header

Örnekler

Account list node agent skus

Örnek isteği

HTTP

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

Ö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
AccountListSupportedImagesResult	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 eklenen ek bilgilerden oluşan bir öğe.
ErrorMessage	Azure Batch hata yanıtında alınan bir hata iletisi.
ImageInformation	Azure Sanal Makineler Market Görüntüsüne başvuru ve Görüntü hakkında ek bilgiler.
ImageReference	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ü başvurularının listesini almak için 'Desteklenen Görüntüleri Listele' işlemine bakın.
OSType	Görüntünün işletim sistemi türü (örneğin, Windows veya Linux).
VerificationType	Azure Batch hizmetinin Görüntünün ilişkili İşlem Düğümü aracısı SKU'su ile uyumlu olduğunu etkin bir şekilde doğrulayıp doğrulamadığı.

AccountListSupportedImagesResult

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

Name	Tür	Description
odata.nextLink	string	Sonraki sonuç kümesini almak için URL.
value	ImageInformation[]	Desteklenen Sanal Makine Görüntülerinin listesi.

BatchError

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	ErrorMessage	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.
values	BatchErrorDetail[]	Hatayla ilgili ek ayrıntıları içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

Azure Batch hata yanıtına eklenen 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.

ErrorMessage

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

Name	Tür	Description
lang	string	Hata iletisinin dil kodu
value	string	İletinin metni.

ImageInformation

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

Name	Tür	Description
batchSupportEndOfLife	string	Azure Batch hizmetinin Görüntü için Havuz oluşturma isteklerini kabul etmeyi durduracağı zaman.
capabilities	string[]	Görüntünün desteklediği özellikler veya özellikler. Görüntünün her özelliği listelenmez. Bu listedeki özellikler özel ilgi alanı olarak kabul edilir ve genellikle Azure Batch hizmetindeki diğer özelliklerle tümleştirmeyle ilgilidir.
imageReference	ImageReference	Azure Sanal Makinenin Market Görüntüsüne başvuru.
nodeAgentSKUId	string	Görüntünün desteklediği İşlem Düğümü aracısı SKU'sunun kimliği.
osType	OSType	Görüntünün işletim sistemi türü (örneğin, Windows veya Linux).
verificationType	VerificationType	Azure Batch hizmetinin Görüntünün ilişkili İşlem Düğümü aracısı SKU'su ile uyumlu olduğunu etkin bir şekilde doğrulayıp doğrulamadığı.

ImageReference

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ü başvurularının listesini almak için 'Desteklenen Görüntüleri Listele' işlemine bakın.

Name	Tür	Description
exactVersion	string	Düğümü oluşturmak için kullanılan platform görüntüsünün veya market görüntüsünün belirli sürümü. Bu salt okunur alan yalnızca havuz oluşturulurken 'version' için belirtilen değer 'en son' olduğunda 'sürüm'den farklıdır.
offer	string	Azure Sanal Makineler Market Görüntüsünün teklif türü. Örneğin, UbuntuServer veya WindowsServer.
publisher	string	Azure Sanal Makineler Market Görüntüsünün yayımcısı. Örneğin, Canonical veya MicrosoftWindowsServer.
sku	string	Azure Sanal Makineler Market Görüntüsünün SKU'su. Örneğin, 18.04-LTS veya 2019-Datacenter.
version	string	Azure Sanal Makineler Market Görüntüsünün sürümü. Görüntünün 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	Azure İşlem Galerisi Görüntüsünün ARM kaynak tanımlayıcısı. Havuzdaki İşlem Düğümleri bu Görüntü Kimliği kullanılarak oluşturulur. Bu,/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} veya /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName} biçimindedir. Bu özellik, diğer ImageReference özellikleriyle birbirini dışlar. Azure İşlem Galerisi Görüntüsü aynı bölgede çoğaltmalara sahip olmalı ve Azure Batch hesabıyla aynı abonelikte olmalıdır. Görüntü sürümü imageId içinde belirtilmezse en son sürüm kullanılır. Batch İşlem Düğümü aracısının Batch hizmetiyle iletişim kurması için güvenlik duvarı ayarları hakkında bilgi için bkz https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. .

OSType

Görüntünün işletim sistemi türü (örneğin, Windows veya Linux).

Name	Tür	Description
linux	string	Linux işletim sistemi.
windows	string	Windows işletim sistemi.

VerificationType

Azure Batch hizmetinin Görüntünün ilişkili İşlem Düğümü aracısı SKU'su ile uyumlu olduğunu etkin bir şekilde doğrulayıp doğrulamadığı.

Name	Tür	Description
unverified	string	İlişkili İşlem Düğümü aracısı SKU'sunun Görüntü ile ikili uyumluluğu olmalıdır, ancak belirli işlevler doğrulanmamıştır.
verified	string	Görüntünün ilişkili İşlem Düğümü aracısı SKU'su ile uyumlu olması garanti edilir ve tüm Batch özelliklerinin beklendiği gibi çalıştığı onaylanmıştır.

Aracılığıyla paylaş

Account - List Supported Images

URI Parametreleri

İstek Başlığı

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Authorization

Örnekler

Account list node agent skus

Örnek isteği

Örnek yanıt

Tanımlar

AccountListSupportedImagesResult

BatchError

BatchErrorDetail

ErrorMessage

ImageInformation

ImageReference

OSType

VerificationType

Ek kaynaklar