Account - List Supported Images

참조

서비스:: Batch Service

API 버전:: 2024-07-01.20.0

Azure Batch 서비스에서 지원하는 모든 Virtual Machine 이미지를 나열합니다.

GET {batchUrl}/supportedimages?api-version=2024-07-01.20.0

선택적 매개 변수:

GET {batchUrl}/supportedimages?$filter={$filter}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.0

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
batchUrl	path	True	string	모든 Azure Batch 서비스 요청에 대한 기본 URL입니다.
api-version	query	True	string	클라이언트 API 버전입니다.
$filter	query		string	OData $filter 절입니다. 이 필터를 생성하는 방법에 대한 자세한 내용은 https://docs.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-support-images참조하세요.
maxresults	query		integer int32	응답에 반환할 최대 항목 수입니다. 최대 1000 결과가 반환됩니다.
timeout	query		integer int32	서버에서 요청을 처리하는 데 소요할 수 있는 최대 시간(초)입니다. 기본값은 30초입니다. 값이 30보다 크면 기본값이 대신 사용됩니다.

요청 헤더

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

Name	형식	Description
client-request-id	string uuid	9C4D50EE-2D56-4CD3-8152-34347DC9F2B0과 같은 장식이 없는 GUID 형식의 호출자 생성 요청 ID입니다.
return-client-request-id	boolean	서버가 응답에서 client-request-id를 반환해야 하는지 여부입니다.
ocp-date	string date-time-rfc1123	요청이 발급된 시간입니다. 클라이언트 라이브러리는 일반적으로 이를 현재 시스템 클록 시간으로 설정합니다. REST API를 직접 호출하는 경우 명시적으로 설정합니다.

응답

Name	형식	Description
200 OK	AccountListSupportedImagesResult	지원되는 Virtual Machine 이미지 목록을 포함하는 응답입니다. 헤더 client-request-id: string request-id: string ETag: string Last-Modified: string
Other Status Codes	BatchError	Batch 서비스의 오류입니다.

Name

형식

Description

200 OK

AccountListSupportedImagesResult

지원되는 Virtual Machine 이미지 목록을 포함하는 응답입니다.

헤더

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

Other Status Codes

BatchError

Batch 서비스의 오류입니다.

보안

azure_auth

Microsoft Entra OAuth 2.0 인증 코드 흐름

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

Authorization

형식: apiKey
In(다음 안에): header

예제

Account list node agent skus

샘플 요청

HTTP

GET account.region.batch.azure.com/supportedimages?api-version=2024-07-01.20.0

샘플 응답

상태 코드:: 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"
    }
  ]
}

정의

Name	Description
AccountListSupportedImagesResult	지원되는 Virtual Machine 이미지를 나열한 결과입니다.
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
ErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
ImageInformation	Azure Virtual Machines Marketplace 이미지에 대한 참조 및 이미지에 대한 추가 정보입니다.
ImageReference	Azure Virtual Machines Marketplace 이미지 또는 Azure Compute 갤러리 이미지에 대한 참조입니다. Azure Batch에서 확인된 모든 Azure Marketplace 이미지 참조 목록을 보려면 '지원되는 이미지 나열' 작업을 참조하세요.
OSType	이미지의 운영 체제 유형(예: Windows 또는 Linux)입니다.
VerificationType	Azure Batch 서비스가 이미지가 연결된 Compute Node 에이전트 SKU와 호환되는지를 적극적으로 확인합니다.

AccountListSupportedImagesResult

지원되는 Virtual Machine 이미지를 나열한 결과입니다.

Name	형식	Description
odata.nextLink	string	다음 결과 집합을 가져올 URL입니다.
value	ImageInformation[]	지원되는 Virtual Machine 이미지 목록입니다.

BatchError

Azure Batch 서비스에서 받은 오류 응답입니다.

Name	형식	Description
code	string	오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
message	ErrorMessage	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
values	BatchErrorDetail[]	오류에 대한 추가 세부 정보가 포함된 키-값 쌍의 컬렉션입니다.

BatchErrorDetail

Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.

Name	형식	Description
key	string	Value 속성의 의미를 지정하는 식별자입니다.
value	string	오류 응답에 포함된 추가 정보입니다.

ErrorMessage

Azure Batch 오류 응답에서 받은 오류 메시지입니다.

Name	형식	Description
lang	string	오류 메시지의 언어 코드
value	string	메시지의 텍스트입니다.

ImageInformation

Azure Virtual Machines Marketplace 이미지에 대한 참조 및 이미지에 대한 추가 정보입니다.

Name	형식	Description
batchSupportEndOfLife	string	Azure Batch 서비스가 이미지에 대한 풀 만들기 요청 수락을 중지하는 시간입니다.
capabilities	string[]	이미지에서 지원하는 기능 또는 기능입니다. 이미지의 모든 기능이 나열되지는 않습니다. 이 목록의 기능은 특별한 관심으로 간주되며 일반적으로 Azure Batch 서비스의 다른 기능과의 통합과 관련이 있습니다.
imageReference	ImageReference	Azure Virtual Machine의 Marketplace 이미지에 대한 참조입니다.
nodeAgentSKUId	string	이미지가 지원하는 컴퓨팅 노드 에이전트 SKU의 ID입니다.
osType	OSType	이미지의 운영 체제 유형(예: Windows 또는 Linux)입니다.
verificationType	VerificationType	Azure Batch 서비스가 이미지가 연결된 Compute Node 에이전트 SKU와 호환되는지를 적극적으로 확인합니다.

ImageReference

Azure Virtual Machines Marketplace 이미지 또는 Azure Compute 갤러리 이미지에 대한 참조입니다. Azure Batch에서 확인된 모든 Azure Marketplace 이미지 참조 목록을 보려면 '지원되는 이미지 나열' 작업을 참조하세요.

Name	형식	Description
communityGalleryImageId	string	커뮤니티 갤러리 이미지 고유 식별자 이 속성은 다른 속성과 함께 사용할 수 없으며 커뮤니티 갤러리 이미지 GET 호출에서 가져올 수 있습니다.
exactVersion	string	노드를 만드는 데 사용되는 플랫폼 이미지 또는 마켓플레이스 이미지의 특정 버전입니다. 이 읽기 전용 필드는 풀을 만들 때 'version'에 지정된 값이 'latest'인 경우에만 'version'와 다릅니다.
offer	string	Azure Virtual Machines Marketplace 이미지의 제품 유형입니다. 예를 들어 UbuntuServer 또는 WindowsServer입니다.
publisher	string	Azure Virtual Machines Marketplace 이미지의 게시자입니다. 예를 들어 Canonical 또는 MicrosoftWindowsServer입니다.
sharedGalleryImageId	string	공유 갤러리 이미지 고유 식별자 이 속성은 다른 속성과 함께 사용할 수 없으며 공유 갤러리 이미지 GET 호출에서 가져올 수 있습니다.
sku	string	Azure Virtual Machines Marketplace 이미지의 SKU입니다. 예를 들어 18.04-LTS 또는 2019-Datacenter입니다.
version	string	Azure Virtual Machines Marketplace 이미지의 버전입니다. 'latest' 값을 지정하여 최신 버전의 이미지를 선택할 수 있습니다. 생략하면 기본값은 'latest'입니다.
virtualMachineImageId	string	Azure Compute 갤러리 이미지의 ARM 리소스 식별자입니다. 이 이미지 ID를 사용하여 풀의 컴퓨팅 노드를 만듭니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} 형식입니다. 또는 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}은 항상 최신 이미지 버전으로 기본값을 지정합니다. 이 속성은 다른 ImageReference 속성과 함께 사용할 수 없습니다. Azure Compute 갤러리 이미지는 동일한 지역에 복제본이 있어야 하며 Azure Batch 계정과 동일한 구독에 있어야 합니다. imageId에 이미지 버전을 지정하지 않으면 최신 버전이 사용됩니다. Batch 컴퓨팅 노드 에이전트가 Batch 서비스와 통신하는 방화벽 설정에 대한 자세한 내용은 https://docs.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration참조하세요.

OSType

이미지의 운영 체제 유형(예: Windows 또는 Linux)입니다.

Name	형식	Description
linux	string	Linux 운영 체제입니다.
windows	string	Windows 운영 체제입니다.

VerificationType

Azure Batch 서비스가 이미지가 연결된 Compute Node 에이전트 SKU와 호환되는지를 적극적으로 확인합니다.

Name	형식	Description
unverified	string	연결된 Compute Node 에이전트 SKU는 이미지와 이진 호환성이 있어야 하지만 특정 기능이 확인되지 않았습니다.
verified	string	이미지는 연결된 컴퓨팅 노드 에이전트 SKU와 호환되도록 보장되며 모든 Batch 기능이 예상대로 작동하도록 확인되었습니다.

다음을 통해 공유

Account - List Supported Images

URI 매개 변수

요청 헤더

응답

보안

azure_auth

범위

Authorization

예제

Account list node agent skus

샘플 요청

샘플 응답

정의

AccountListSupportedImagesResult

BatchError

BatchErrorDetail

ErrorMessage

ImageInformation

ImageReference

OSType

VerificationType

추가 리소스