Nodes - List Node Extensions

서비스:: Batch Service

API 버전:: 2025-06-01

지정된 풀 내 컴퓨트 노드 확장을 나열합니다.

GET {endpoint}/pools/{poolId}/nodes/{nodeId}/extensions?api-version=2025-06-01

선택적 매개 변수:

GET {endpoint}/pools/{poolId}/nodes/{nodeId}/extensions?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$select={$select}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string (uri)	Batch 계정 엔드포인트(예: https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	확장을 나열하려는 컴퓨트 노드의 ID입니다.
poolId	path	True	string	컴퓨트 노드를 포함하는 풀의 ID입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.
$select	query		string[]	OData $select 절입니다.
maxresults	query		integer (int32) minimum: 1 maximum: 1000	응답에 반환할 최대 항목 수입니다. 최대 1000건의 신청서를 제출할 수 있습니다.
timeOut	query		integer (int32)	서버에서 요청을 처리하는 데 소요할 수 있는 최대 시간(초)입니다. 기본값은 30초입니다. 만약 값이 30보다 크면 기본값이 대신 사용됩니다."라고 말했습니다.

요청 헤더

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

응답

Name	형식	Description
200 OK	BatchNodeVMExtensionListResult	요청이 성공했습니다. 헤더 ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	예기치 않은 오류 응답입니다.

Name

형식

Description

200 OK

BatchNodeVMExtensionListResult

요청이 성공했습니다.

헤더

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

Other Status Codes

BatchError

예기치 않은 오류 응답입니다.

보안

OAuth2Auth

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

범위

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

예제

List compute node extensions

샘플 요청

HTTP

GET {endpoint}/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z/extensions?api-version=2025-06-01

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "instanceView": {
        "name": "batchNodeExtension",
        "statuses": [
          {
            "code": "ProvisioningState/succeeded",
            "level": "Info",
            "displayStatus": "Provisioning succeeded",
            "message": "Enable succeeded: Enabling and starting agent and controller"
          }
        ]
      },
      "vmExtension": {
        "name": "batchNodeExtension",
        "publisher": "Microsoft.Azure.Extensions",
        "type": "CustomScript",
        "typeHandlerVersion": "2.0",
        "autoUpgradeMinorVersion": true
      }
    },
    {
      "instanceView": {
        "name": "customExtension",
        "statuses": [
          {
            "code": "ProvisioningState/succeeded",
            "level": "Info",
            "displayStatus": "Provisioning succeeded",
            "message": "ExtensionOperation:enable. Status:Success"
          }
        ]
      },
      "vmExtension": {
        "name": "customExtension",
        "publisher": "Microsoft.Azure.Geneva",
        "type": "GenevaMonitoring",
        "typeHandlerVersion": "2.0",
        "autoUpgradeMinorVersion": true,
        "enableAutomaticUpgrade": true
      }
    }
  ]
}

정의

Name	Description
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
BatchErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
BatchNodeVMExtension	가상 머신 확장 인스턴스 보기에 대한 구성입니다.
BatchNodeVMExtensionListResult	노드에 컴퓨팅 노드 확장을 나열한 결과입니다.
InstanceViewStatus	인스턴스 뷰 상태입니다.
StatusLevelTypes	레벨 코드.
VMExtension	가상 머신 확장에 대한 구성입니다.
VMExtensionInstanceView	vm 확장 인스턴스 뷰입니다.

BatchError

Object

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

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

BatchErrorDetail

Object

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

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

BatchErrorMessage

Object

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

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

BatchNodeVMExtension

Object

가상 머신 확장 인스턴스 보기에 대한 구성입니다.

Name	형식	Description
instanceView	VMExtensionInstanceView	vm 확장 인스턴스 뷰입니다.
provisioningState	string	가상 머신 확장 프로그램의 프로비저닝 상태입니다.
vmExtension	VMExtension	가상 머신 확장 프로그램입니다.

BatchNodeVMExtensionListResult

Object

노드에 컴퓨팅 노드 확장을 나열한 결과입니다.

Name	형식	Description
odata.nextLink	string (uri)	다음 결과 집합을 가져올 URL입니다.
value	BatchNodeVMExtension[]	컴퓨트 노드 확장 목록입니다.

InstanceViewStatus

Object

인스턴스 뷰 상태입니다.

Name	형식	Description
code	string	상태 코드입니다.
displayStatus	string	현지화된 상태의 라벨입니다.
level	StatusLevelTypes	레벨 코드.
message	string	상세한 상태 메시지.
time	string (date-time)	상태의 시간입니다.

StatusLevelTypes

열거형

레벨 코드.

값	Description
Error	오류
Info	Info
Warning	경고

VMExtension

Object

가상 머신 확장에 대한 구성입니다.

Name	형식	Description
autoUpgradeMinorVersion	boolean	배포 시 사용할 수 있는 경우 확장에서 최신 부 버전을 사용해야 하는지 여부를 나타냅니다. 그러나 배포된 후에는 이 속성이 true로 설정되어 있더라도 재배포하지 않는 한 확장은 부 버전을 업그레이드하지 않습니다.
enableAutomaticUpgrade	boolean	사용 가능한 최신 버전의 확장이 있는 경우 플랫폼에서 확장을 자동으로 업그레이드해야 하는지 여부를 나타냅니다.
name	string	가상 머신 확장의 이름입니다.
protectedSettings	object	확장에는 protectedSettings 또는 protectedSettingsFromKeyVault 또는 보호된 설정이 전혀 포함될 수 없습니다.
provisionAfterExtensions	string[]	확장명 컬렉션입니다. 이 확장을 프로비전해야 하는 확장 이름 컬렉션입니다.
publisher	string	확장 처리기 게시자의 이름입니다.
settings	object	확장에 대한 JSON 형식의 공용 설정입니다.
type	string	연장 유형.
typeHandlerVersion	string	스크립트 처리기의 버전입니다.

VMExtensionInstanceView

Object

vm 확장 인스턴스 뷰입니다.

Name	형식	Description
name	string	VM 확장 인스턴스 뷰의 이름입니다.
statuses	InstanceViewStatus[]	리소스 상태 정보입니다.
subStatuses	InstanceViewStatus[]	리소스 상태 정보입니다.

다음을 통해 공유

Nodes - List Node Extensions

URI 매개 변수

요청 헤더

응답

보안

OAuth2Auth

범위

예제

List compute node extensions

샘플 요청

샘플 응답

정의

BatchError

BatchErrorDetail

BatchErrorMessage

BatchNodeVMExtension

BatchNodeVMExtensionListResult

InstanceViewStatus

StatusLevelTypes

VMExtension

VMExtensionInstanceView