Nodes - List Nodes

서비스:: Batch Service

API 버전:: 2025-06-01

지정된 풀 내의 컴퓨트 노드를 나열합니다.

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

선택적 매개 변수:

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string (uri)	Batch 계정 엔드포인트(예: https://batchaccount.eastus2.batch.azure.com).
poolId	path	True	string	컴퓨트 노드를 나열하려는 풀의 ID입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.
$filter	query		string	OData $filter 절입니다. 이 필터 구성에 대한 자세한 내용은 .를 참조하세요 https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-nodes-in-a-pool.
$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	BatchNodeListResult	요청이 성공했습니다. 헤더 ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	예기치 않은 오류 응답입니다.

Name

형식

Description

200 OK

BatchNodeListResult

요청이 성공했습니다.

헤더

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

예제

Node list

샘플 요청

HTTP

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

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "id": "tvm-1695681911_1-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T22:22:27.2236818Z",
      "lastBootTime": "2025-11-22T22:22:24.4634125Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_1-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T22:22:27.2236818Z",
        "endTime": "2025-11-22T22:22:27.567189Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    },
    {
      "id": "tvm-1695681911_2-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T19:37:31.4285526Z",
      "lastBootTime": "2025-11-22T19:37:28.623369Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_2-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T19:37:31.4285526Z",
        "endTime": "2025-11-22T19:37:31.838028Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    },
    {
      "id": "tvm-1695681911_3-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_3-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T19:36:51.0013378Z",
      "lastBootTime": "2025-11-22T19:36:48.21721Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_3-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T19:36:51.0013378Z",
        "endTime": "2025-11-22T19:36:51.2363447Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    }
  ]
}

정의

Name	Description
AutoUserScope	AutoUserScope 열거
AutoUserSpecification	Azure Batch 작업을 실행하는 자동 사용자에 대한 옵션을 지정합니다.
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
BatchErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
BatchErrorSourceCategory	배치 오류출처 카테고리 열거
BatchNode	Batch 서비스의 컴퓨팅 노드입니다.
BatchNodeAgentInfo	Batch Compute 노드 에이전트는 풀의 각 컴퓨팅 노드에서 실행되며 컴퓨팅 노드에서 Batch 기능을 제공하는 프로그램입니다.
BatchNodeEndpointConfiguration	컴퓨팅 노드에 대한 엔드포인트 구성입니다.
BatchNodeError	컴퓨팅 노드에서 발생한 오류입니다.
BatchNodeIdentityReference	컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.
BatchNodeListResult	풀에 컴퓨팅 노드를 나열한 결과입니다.
BatchNodeState	BatchNodeState 열거
BatchStartTask	Batch는 노드에서 복구 작업이 트리거될 때 작업을 다시 시도합니다. 복구 작업의 예로는 비정상 노드가 다시 부팅되거나 호스트 오류로 인해 컴퓨팅 노드가 사라진 경우(제한되지 않음) 등이 있습니다. 복구 작업으로 인한 재시도는 maxTaskRetryCount와 독립적이며 계산되지 않습니다. maxTaskRetryCount가 0이더라도 복구 작업으로 인한 내부 재시도가 발생할 수 있습니다. 이 때문에 모든 작업은 idempotent여야 합니다. 즉, 작업이 손상되거나 중복된 데이터를 유발하지 않고 중단되고 다시 시작되는 것을 허용해야 합니다. 장기 실행 작업의 모범 사례는 일종의 검사점을 사용하는 것입니다. 경우에 따라 컴퓨팅 노드가 다시 부팅되지 않은 경우에도 StartTask가 다시 실행될 수 있습니다. 중단 프로세스를 만들거나 StartTask 작업 디렉터리에서 서비스를 설치/시작하는 StartTasks를 방지하기 위해 특별히 주의해야 합니다. 이렇게 하면 Batch가 StartTask를 다시 실행할 수 없게 됩니다.
BatchStartTaskInfo	컴퓨팅 노드에서 실행되는 StartTask에 대한 정보입니다.
BatchStartTaskState	BatchStartTaskState 열거
BatchTaskContainerExecutionInfo	태스크가 실행 중인 컨테이너에 대한 정보를 포함합니다.
BatchTaskContainerSettings	작업에 대한 컨테이너 설정입니다.
BatchTaskExecutionInfo	작업 실행에 대한 정보입니다.
BatchTaskExecutionResult	BatchTaskExecutionResult는 열거됩니다
BatchTaskFailureInfo	작업 실패에 대한 정보입니다.
BatchTaskInfo	컴퓨팅 노드에서 실행되는 태스크에 대한 정보입니다.
BatchTaskState	배치 작업 상태 열거
BatchVmImageReference	Azure Virtual Machines Marketplace 이미지 또는 Azure Compute 갤러리 이미지에 대한 참조입니다. Azure Batch에서 확인된 모든 Azure Marketplace 이미지 참조 목록을 얻으려면 '지원되는 이미지 목록' 작업을 참조하세요.
ContainerHostBatchBindMountEntry	작업 컨테이너에 탑재할 경로 및 탑재 모드의 항목입니다.
ContainerHostDataPath	컨테이너 태스크의 컨테이너에 탑재될 경로입니다.
ContainerRegistryReference	프라이빗 컨테이너 레지스트리입니다.
ContainerWorkingDirectory	ContainerWorkingDirectory enums
ElevationLevel	고도 수준 열거
EnvironmentSetting	작업 프로세스에서 설정할 환경 변수입니다.
InboundEndpoint	컴퓨팅 노드의 인바운드 엔드포인트입니다.
InboundEndpointProtocol	InboundEndpointProtocol 열거
NameValuePair	이름-값 쌍을 나타냅니다.
ResourceFile	컴퓨팅 노드에 다운로드할 단일 파일 또는 여러 파일입니다.
SchedulingState	상태 열거 스케줄링
UserIdentity	작업이 실행되는 사용자 ID의 정의입니다. userName 또는 autoUser 속성을 지정하지만 둘 다 지정하지는 않습니다.
VirtualMachineInfo	가상 머신의 현재 상태에 대한 정보입니다.

AutoUserScope

열거형

AutoUserScope 열거

값	Description
task	서비스가 해당 작업에 대해 새로운 사용자를 생성하도록 명시합니다.
pool	작업이 풀 내 모든 컴퓨트 노드에서 생성되는 공통 자동 사용자 계정으로 실행되도록 지정합니다.

AutoUserSpecification

Object

Azure Batch 작업을 실행하는 자동 사용자에 대한 옵션을 지정합니다.

Name	형식	Description
elevationLevel	ElevationLevel	자동 사용자의 권한 상승 수준입니다. 기본값은 nonAdmin입니다.
scope	AutoUserScope	자동 사용자에 대한 범위입니다. 기본값은 풀입니다. 풀이 Windows를 실행하는 경우 작업 간에 더 엄격한 격리가 필요한 경우 작업 값을 지정해야 합니다. 예를 들어 작업이 다른 작업에 영향을 줄 수 있는 방식으로 레지스트리를 변경하는 경우입니다.

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	메시지의 텍스트입니다.

BatchErrorSourceCategory

열거형

배치 오류출처 카테고리 열거

값	Description
usererror	이 오류는 설정 오류와 같은 사용자 문제에서 비롯됩니다.
servererror	이 오류는 내부 서버 문제로 인해 발생했습니다.

BatchNode

Object

Batch 서비스의 컴퓨팅 노드입니다.

Name	형식	Description
affinityId	string	이 컴퓨팅 노드에서 작업을 예약하도록 요청하는 작업을 추가할 때 전달할 수 있는 식별자입니다. 이것은 단지 부드러운 선호도입니다. 작업이 예약될 때 대상 컴퓨팅 노드가 사용 중이거나 사용할 수 없는 경우 작업은 다른 곳에서 예약됩니다.
allocationTime	string (date-time)	이 컴퓨팅 노드가 풀에 할당된 시간입니다. 컴퓨팅 노드가 처음 할당되고 설정된 후에는 변경되지 않는 시간입니다. 컴퓨팅 노드가 서비스를 복구하거나 선점할 때 업데이트되지 않습니다.
endpointConfiguration	BatchNodeEndpointConfiguration	컴퓨팅 노드에 대한 엔드포인트 구성입니다.
errors	BatchNodeError[]	컴퓨팅 노드에서 현재 발생하는 오류 목록입니다.
id	string	컴퓨팅 노드의 ID입니다. 풀에 추가된 모든 컴퓨팅 노드에는 고유한 ID가 할당됩니다. 컴퓨팅 노드가 풀에서 제거될 때마다 모든 로컬 파일이 삭제되고 ID가 회수되고 새 컴퓨팅 노드에 다시 사용할 수 있습니다.
ipAddress	string	다른 노드가 이 컴퓨팅 노드와 통신하는 데 사용할 수 있는 IP 주소입니다. 풀에 추가된 모든 컴퓨팅 노드에는 고유한 IP 주소가 할당됩니다. 컴퓨팅 노드가 풀에서 제거될 때마다 모든 로컬 파일이 삭제되고 IP 주소가 회수되고 새 컴퓨팅 노드에 다시 사용할 수 있습니다.
ipv6Address	string	다른 노드가 이 컴퓨팅 노드와 통신하는 데 사용할 수 있는 IPv6 주소입니다. 풀에 추가된 모든 컴퓨팅 노드에는 고유한 IP 주소가 할당됩니다. 컴퓨팅 노드가 풀에서 제거될 때마다 모든 로컬 파일이 삭제되고 IP 주소가 회수되고 새 컴퓨팅 노드에 다시 사용할 수 있습니다. 풀이 IPv6에 대해 구성되지 않은 경우 이 속성이 표시되지 않습니다.
isDedicated	boolean	이 컴퓨팅 노드가 전용 컴퓨팅 노드인지 여부입니다. false이면 컴퓨팅 노드는 스폿/우선 순위가 낮은 컴퓨팅 노드입니다.
lastBootTime	string (date-time)	컴퓨팅 노드가 마지막으로 시작된 시간입니다. 컴퓨팅 노드 상태를 사용할 수 없는 경우 이 속성이 없을 수 있습니다.
nodeAgentInfo	BatchNodeAgentInfo	컴퓨팅 노드 에이전트 버전 및 컴퓨팅 노드가 새 버전으로 업그레이드된 시간에 대한 정보입니다.
recentTasks	BatchTaskInfo[]	최근 상태가 변경된 작업 목록입니다. 이 속성은 풀에 할당된 이후 이 컴퓨팅 노드에서 하나 이상의 작업이 실행된 경우에만 존재합니다.
runningTaskSlotsCount	integer (int32)	컴퓨팅 노드에서 현재 작업 작업을 실행하는 데 사용되는 총 일정 슬롯 수입니다. 여기에는 작업 관리자 작업 및 일반 작업이 포함되지만 작업 준비, 작업 릴리스 또는 시작 태스크는 포함되지 않습니다.
runningTasksCount	integer (int32)	컴퓨팅 노드에서 현재 실행 중인 작업 작업의 총 수입니다. 여기에는 작업 관리자 작업 및 일반 작업이 포함되지만 작업 준비, 작업 릴리스 또는 시작 태스크는 포함되지 않습니다.
schedulingState	SchedulingState	컴퓨팅 노드를 작업 예약에 사용할 수 있는지 여부입니다.
startTask	BatchStartTask	풀에 조인할 때 컴퓨팅 노드에서 실행하도록 지정된 작업입니다.
startTaskInfo	BatchStartTaskInfo	컴퓨팅 노드에서 StartTask 실행에 대한 런타임 정보입니다.
state	BatchNodeState	컴퓨팅 노드의 현재 상태입니다.
stateTransitionTime	string (date-time)	컴퓨팅 노드가 현재 상태를 입력한 시간입니다.
totalTasksRun	integer (int32)	컴퓨팅 노드에서 완료된 총 작업 작업 수입니다. 여기에는 작업 관리자 작업 및 일반 작업이 포함되지만 작업 준비, 작업 릴리스 또는 시작 태스크는 포함되지 않습니다.
totalTasksSucceeded	integer (int32)	컴퓨팅 노드에서 성공적으로 완료된 총 작업 작업 수(exitCode 0 포함)입니다. 여기에는 작업 관리자 작업 및 일반 작업이 포함되지만 작업 준비, 작업 릴리스 또는 시작 태스크는 포함되지 않습니다.
url	string (uri)	컴퓨팅 노드의 URL입니다.
virtualMachineInfo	VirtualMachineInfo	가상 머신의 현재 상태에 대한 정보입니다.
vmSize	string	컴퓨팅 노드를 호스팅하는 가상 머신의 크기입니다. 풀에서 사용 가능한 가상 머신 크기에 대한 자세한 내용은 Azure Batch 풀의 컴퓨팅 노드에 대한 VM 크기 선택(https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes)을 참조하세요.

BatchNodeAgentInfo

Object

Batch Compute 노드 에이전트는 풀의 각 컴퓨팅 노드에서 실행되며 컴퓨팅 노드에서 Batch 기능을 제공하는 프로그램입니다.

Name	형식	Description
lastUpdateTime	string (date-time)	컴퓨트 노드 에이전트가 컴퓨트 노드에서 업데이트된 시간입니다. 이번이 컴퓨트 노드 에이전트가 새 버전으로 업데이트된 가장 최근의 사례입니다.
version	string	컴퓨트 노드에서 실행되는 배치 컴퓨트 노드 에이전트 버전입니다. 이 버전 번호는 Compute Node 에이전트 릴리스 노트 https://github.com/Azure/Batch/blob/master/changelogs/nodeagent/CHANGELOG.md와 대조하여 확인할 수 있습니다.

BatchNodeEndpointConfiguration

Object

컴퓨팅 노드에 대한 엔드포인트 구성입니다.

Name	형식	Description
inboundEndpoints	InboundEndpoint[]	컴퓨트 노드에서 접근 가능한 인바운드 엔드포인트 목록입니다.

BatchNodeError

Object

컴퓨팅 노드에서 발생한 오류입니다.

Name	형식	Description
code	string	컴퓨트 노드 오류에 대한 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
errorDetails	NameValuePair[]	컴퓨트 노드 오류와 관련된 추가 오류 세부 사항 목록입니다.
message	string	사용자 인터페이스에서 표시하기에 적합하도록 설계된 컴퓨트 노드 오류를 설명하는 메시지입니다.

BatchNodeIdentityReference

Object

컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.

Name	형식	Description
resourceId	string (arm-id)	사용자 할당 ID의 ARM 리소스 ID입니다.

BatchNodeListResult

Object

풀에 컴퓨팅 노드를 나열한 결과입니다.

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

BatchNodeState

열거형

BatchNodeState 열거

값	Description
idle	컴퓨트 노드는 현재 작업을 실행하고 있지 않습니다.
rebooting	컴퓨트 노드가 재부팅 중입니다.
reimaging	컴퓨트 노드가 재이미징 중입니다.
running	컴퓨트 노드는 하나 이상의 작업(StartTask 제외)을 실행하고 있습니다.
unusable	컴퓨트 노드는 오류 때문에 작업 실행에 사용할 수 없습니다.
creating	배치 서비스는 Azure Compute로부터 기본 가상 머신을 확보했지만, 아직 풀에 합류하기 시작하지 않았습니다.
starting	배치 서비스는 기본 가상 머신에서 시작됩니다.
waitingforstarttask	StartTask는 컴퓨트 노드에서 실행을 시작했지만, waitForSuccess가 설정되어 있고 StartTask는 아직 완료되지 않았습니다.
starttaskfailed	StartTask가 Compute Node에서 실패했고(모든 재시도가 소진됨), waitForSuccess가 설정되어 있습니다. 컴퓨트 노드는 작업 실행에 사용할 수 없습니다.
unknown	배치 서비스는 컴퓨트 노드와의 연결이 끊겼으며, 노드의 진짜 상태를 알지 못합니다.
leavingpool	컴퓨트 노드가 풀을 떠나고 있는데, 이는 사용자가 명시적으로 풀을 제거했거나 풀이 크기를 조정하거나 자동 스케일링하기 때문입니다.
offline	컴퓨트 노드는 현재 작업을 실행하고 있지 않으며, 컴퓨트 노드에 대한 새로운 작업 스케줄링이 비활성화되어 있습니다.
preempted	우선 순위가 낮은 스폿/낮은 컴퓨팅 노드가 선점되었습니다. 컴퓨팅 노드가 선점되었을 때 실행 중이던 작업은 다른 컴퓨팅 노드를 사용할 수 있게 되면 다시 예약됩니다.
upgradingos	컴퓨트 노드는 OS 업그레이드 작업을 진행 중입니다.
deallocated	컴퓨트 노드가 해제됩니다.
deallocating	컴퓨트 노드가 분리 중입니다.

BatchStartTask

Object

Batch는 노드에서 복구 작업이 트리거될 때 작업을 다시 시도합니다. 복구 작업의 예로는 비정상 노드가 다시 부팅되거나 호스트 오류로 인해 컴퓨팅 노드가 사라진 경우(제한되지 않음) 등이 있습니다. 복구 작업으로 인한 재시도는 maxTaskRetryCount와 독립적이며 계산되지 않습니다. maxTaskRetryCount가 0이더라도 복구 작업으로 인한 내부 재시도가 발생할 수 있습니다. 이 때문에 모든 작업은 idempotent여야 합니다. 즉, 작업이 손상되거나 중복된 데이터를 유발하지 않고 중단되고 다시 시작되는 것을 허용해야 합니다. 장기 실행 작업의 모범 사례는 일종의 검사점을 사용하는 것입니다. 경우에 따라 컴퓨팅 노드가 다시 부팅되지 않은 경우에도 StartTask가 다시 실행될 수 있습니다. 중단 프로세스를 만들거나 StartTask 작업 디렉터리에서 서비스를 설치/시작하는 StartTasks를 방지하기 위해 특별히 주의해야 합니다. 이렇게 하면 Batch가 StartTask를 다시 실행할 수 없게 됩니다.

Name	형식	Description
commandLine	string	StartTask의 명령줄입니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: Windows에서 "cmd /c MyCommand"를 사용하거나 Linux에서 "/bin/sh -c MyCommand"). 명령줄이 파일 경로를 참조하는 경우 상대 경로(작업 작업 디렉터리를 기준으로)를 사용하거나 Batch 제공 환경 변수(https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables)를 사용해야 합니다.
containerSettings	BatchTaskContainerSettings	StartTask가 실행되는 컨테이너 설정입니다. 이 명령이 지정되면, 노드 내 Azure 배치 디렉터리의 루트인 AZ_BATCH_NODE_ROOT_DIR 아래 모든 디렉터리가 재귀적으로 컨테이너에 매핑되고, 모든 작업 환경 변수도 컨테이너에 매핑되며, 컨테이너 내에서 작업 명령줄이 실행됩니다. AZ_BATCH_NODE_ROOT_DIR 외부에서 생성된 컨테이너 파일은 호스트 디스크에 반영되지 않을 수 있어, 배치 파일 API가 해당 파일에 접근할 수 없습니다.
environmentSettings	EnvironmentSetting[]	StartTask에 대한 환경 변수 설정 목록입니다.
maxTaskRetryCount	integer (int32)	작업을 재시도할 수 있는 최대 횟수입니다. Batch 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도합니다. 이 값은 특히 재시도 횟수를 제어합니다. Batch 서비스는 작업을 한 번 시도한 다음 이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 태스크를 최대 4번(초기 시도 1회, 재시도 3회)을 시도합니다. 최대 재시도 횟수가 0이면 Batch 서비스가 작업을 다시 시도하지 않습니다. 최대 재시도 횟수가 -1인 경우 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 그러나 시작 작업이나 작업에는 권장되지 않습니다. 기본값은 0(재시도 안 됨)입니다.
resourceFiles	ResourceFile[]	명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드는 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다. 이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다.
userIdentity	UserIdentity	StartTask가 실행되는 사용자 신원입니다. 만약 이 옵션을 누락할 경우, 해당 작업은 해당 작업에 고유한 비관리자 사용자로 실행됩니다.
waitForSuccess	boolean	Batch 서비스가 Compute 노드에서 작업을 예약하기 전에 StartTask가 성공적으로 완료될 때까지 대기해야 하는지 여부(즉, 종료 코드 0으로 종료). True이고 StartTask가 노드에서 실패하는 경우 Batch 서비스는 StartTask를 최대 다시 시도 횟수(maxTaskRetryCount)까지 다시 시도합니다. 모든 재시도 후에도 작업이 성공적으로 완료되지 않은 경우 Batch 서비스는 노드를 사용할 수 없음으로 표시하고 작업을 예약하지 않습니다. 이 조건은 컴퓨팅 노드 상태 및 오류 정보 세부 정보를 통해 검색할 수 있습니다. false이면 Batch 서비스는 StartTask가 완료될 때까지 기다리지 않습니다. 이 경우 StartTask가 계속 실행되는 동안 다른 태스크가 컴퓨팅 노드에서 실행을 시작할 수 있습니다. StartTask가 실패하더라도 컴퓨팅 노드에서 새 작업이 계속 예약됩니다. 기본값은 true입니다.

BatchStartTaskInfo

Object

컴퓨팅 노드에서 실행되는 StartTask에 대한 정보입니다.

Name	형식	Description
containerInfo	BatchTaskContainerExecutionInfo	작업이 실행되는 컨테이너에 대한 정보입니다. 이 속성은 작업이 컨테이너 컨텍스트에서 실행될 때만 설정됩니다.
endTime	string (date-time)	StartTask가 실행을 멈춘 시점입니다. 이 시간은 StartTask의 최근 실행이 완료된 경우(실패하고 재시도가 대기 중이라도) 종료 시간입니다. StartTask가 현재 실행 중이라면 이 요소는 존재하지 않습니다.
exitCode	integer (int32)	StartTask 명령줄에 지정된 프로그램의 종료 코드입니다. 이 속성은 StartTask가 완료된 상태일 때만 설정됩니다. 일반적으로 프로세스의 종료 코드는 해당 프로세스에 대해 애플리케이션 개발자가 구현한 특정 관례를 반영합니다. 출구 코드 값을 사용해 코드를 결정할 때는 애플리케이션 프로세스에서 사용하는 출구 코드 규칙을 반드시 알고 있어야 합니다. 하지만 배치 서비스가 StartTask를 종료하면(타임아웃이나 API를 통한 사용자 종료) 운영체제에서 정의한 종료 코드를 볼 수 있습니다.
failureInfo	BatchTaskFailureInfo	작업 실패에 대한 정보가 있다면. 이 속성은 작업이 완료 상태에 있고 실패를 겪었을 때만 설정됩니다.
lastRetryTime	string (date-time)	가장 최근에 과제 재시도가 실행되기 시작한 시점입니다. 이 요소는 작업이 다시 시도될 때만 존재합니다(예: retryCount가 0이 아닙니다). 만약 존재한다면, 이는 일반적으로 startTime과 동일하지만, 작업이 재시작된 경우에는 재시도가 아닌 다른 이유로 다를 수 있습니다; 예를 들어, 재시도 중에 컴퓨트 노드가 재부팅되었다면 startTime은 업데이트되지만 lastRetryTime은 업데이트되지 않습니다.
result	BatchTaskExecutionResult	과제 실행의 결과입니다. 값이 '실패'라면, 실패 세부 사항은 failureInfo 속성에서 확인할 수 있습니다.
retryCount	integer (int32)	배치 서비스가 작업을 재시도한 횟수. 작업 애플리케이션 실패(0이 아닌 종료 코드)는 재시도하고, 전처리 오류(작업 실행 불가), 파일 업로드 오류는 재시도하지 않습니다. 배치 서비스는 제약 조건에 따라 작업(Task)을 다시 시도합니다.
startTime	string (date-time)	StartTask가 실행되기 시작한 시간입니다. 이 값은 작업이 재시작되거나 재시도될 때마다(즉, StartTask가 실행을 시작한 가장 최근 시점)마다 초기화됩니다.
state	BatchStartTaskState	컴퓨트 노드의 StartTask 상태입니다.

BatchStartTaskState

열거형

BatchStartTaskState 열거

값	Description
running	StartTask는 현재 실행 중입니다.
completed	StartTask가 종료 코드 0으로 종료되었거나, StartTask가 실패했는데 재시도 한계에 도달했거나, StartTask 프로세스가 작업 준비 오류(예: 리소스 파일 다운로드 실패)로 실행되지 않았을 때입니다.

BatchTaskContainerExecutionInfo

Object

태스크가 실행 중인 컨테이너에 대한 정보를 포함합니다.

Name	형식	Description
containerId	string	컨테이너의 ID입니다.
error	string	컨테이너에 대한 자세한 오류 정보. 이 문자열은 Docker 서비스에서 제공하는 상세한 오류 문자열입니다. 이는 "docker inspect"에서 반환되는 오류 필드와 동등합니다.
state	string	컨테이너 상태. 이것이 Docker 서비스에 따른 컨테이너 상태입니다. 이는 "docker inspect"에서 반환되는 상태 필드와 동등합니다.

BatchTaskContainerSettings

Object

작업에 대한 컨테이너 설정입니다.

Name	형식	Description
containerHostBatchBindMounts	ContainerHostBatchBindMountEntry[]	컨테이너 작업에 탑재할 경로입니다. 이 배열이 null이거나 없는 경우 컨테이너 작업은 전체 임시 디스크 드라이브를 창에 탑재합니다(또는 Linux의 AZ_BATCH_NODE_ROOT_DIR). 이 배열이 비어 있는 것으로 설정된 경우 데이터 경로를 컨테이너에 탑재하지 않습니다.
containerRunOptions	string	컨테이너 만들기 명령에 대한 추가 옵션입니다. 이러한 추가 옵션은 Batch 서비스에서 제어하는 옵션 외에도 "docker create" 명령에 대한 인수로 제공됩니다.
imageName	string	Task가 실행될 컨테이너를 생성하는 데 사용할 이미지입니다. 이것이 "docker pull"에 명시된 전체 이미지 참조입니다. 이미지 이름에 태그가 제공되지 않은 경우, 기본값으로 ":latest" 태그가 사용됩니다.
registry	ContainerRegistryReference	컨테이너 이미지를 포함하는 개인 레지스트리입니다. 이 설정은 풀 생성 시 이미 제공되어 있다면 생략할 수 있습니다.
workingDirectory	ContainerWorkingDirectory	컨테이너 작업 작업 디렉터리의 위치입니다. 기본값은 'taskWorkingDirectory'입니다.

BatchTaskExecutionInfo

Object

작업 실행에 대한 정보입니다.

Name	형식	Description
containerInfo	BatchTaskContainerExecutionInfo	작업이 실행되는 컨테이너에 대한 정보입니다. 이 속성은 작업이 컨테이너 컨텍스트에서 실행될 때만 설정됩니다.
endTime	string (date-time)	과제가 완료된 시간. 이 속성은 작업이 완료 상태일 때만 설정됩니다.
exitCode	integer (int32)	작업 명령줄에 지정된 프로그램의 종료 코드입니다. 이 속성은 작업이 완료된 상태일 때만 설정됩니다. 일반적으로 프로세스의 종료 코드는 해당 프로세스에 대해 애플리케이션 개발자가 구현한 특정 관례를 반영합니다. 출구 코드 값을 사용해 코드를 결정할 때는 애플리케이션 프로세스에서 사용하는 출구 코드 규칙을 반드시 알고 있어야 합니다. 하지만 배치 서비스가 타임아웃이나 API를 통한 사용자 종료로 인해 작업을 종료할 경우, 운영체제에서 정의한 종료 코드를 볼 수 있습니다.
failureInfo	BatchTaskFailureInfo	작업 실패에 대한 정보가 있다면. 이 속성은 작업이 완료 상태에 있고 실패를 겪었을 때만 설정됩니다.
lastRequeueTime	string (date-time)	사용자 요청의 결과로 배치 서비스가 작업을 재대열에 넣은 가장 최근 시점입니다. 이 속성은 requeueCount가 0이 아닐 때만 설정됩니다.
lastRetryTime	string (date-time)	가장 최근에 과제 재시도가 실행되기 시작한 시점입니다. 이 요소는 작업이 다시 시도될 때만 존재합니다(예: retryCount가 0이 아닙니다). 만약 존재한다면, 이는 일반적으로 startTime과 동일하지만, 작업이 재시작된 경우에는 재시도가 아닌 다른 이유로 다를 수 있습니다; 예를 들어, 재시도 중에 컴퓨트 노드가 재부팅되었다면 startTime은 업데이트되지만 lastRetryTime은 업데이트되지 않습니다.
requeueCount	integer (int32)	사용자 요청의 결과로 배치 서비스가 작업을 재대기열에 넣은 횟수입니다. 사용자가 풀에서 컴퓨트 노드를 제거(풀 크기 조정/축소)하거나 작업이 비활성화될 때, 컴퓨트 노드에서 실행 중인 작업을 실행을 위해 다시 큐잉하도록 지정할 수 있습니다. 이 카운트는 이러한 이유로 작업이 몇 번 다시 대기열에 올랐는지를 추적합니다.
result	BatchTaskExecutionResult	과제 실행의 결과입니다. 값이 '실패'라면, 실패 세부 사항은 failureInfo 속성에서 확인할 수 있습니다.
retryCount	integer (int32)	배치 서비스가 작업을 재시도한 횟수. 작업 애플리케이션 실패(0이 아닌 종료 코드)는 재시도하고, 전처리 오류(작업 실행 불가), 파일 업로드 오류는 재시도하지 않습니다. 배치 서비스는 제약 조건에 따라 작업(Task)을 다시 시도합니다.
startTime	string (date-time)	과제가 시작된 시간. 'Running'은 실행 상태에 해당하므로, 작업이 리소스 파일이나 패키지를 지정하면 시작 시간은 해당 파일을 다운로드하거나 배포하기 시작한 시점을 반영합니다. 작업이 재시작되거나 재시도된 경우, 이 시점이 작업이 실행을 시작한 가장 최근의 시간입니다. 이 속성은 실행 중이거나 완료된 상태의 작업에만 적용됩니다.

BatchTaskExecutionResult

열거형

BatchTaskExecutionResult는 열거됩니다

값	Description
success	과제는 성공적으로 진행되었다.
failure	과제 처리 중에 오류가 발생했습니다. 실패는 작업 프로세스가 실행되기 전, 실행 중이거나 작업 프로세스가 종료된 후에 발생했을 수 있습니다.

BatchTaskFailureInfo

Object

작업 실패에 대한 정보입니다.

Name	형식	Description
category	BatchErrorSourceCategory	작업 오류의 범주.
code	string	작업 오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
details	NameValuePair[]	오류와 관련된 추가 세부사항 목록입니다.
message	string	작업 오류를 설명하는 메시지로, 사용자 인터페이스에서 표시하기에 적합하도록 설계되었습니다.

BatchTaskInfo

Object

컴퓨팅 노드에서 실행되는 태스크에 대한 정보입니다.

Name	형식	Description
executionInfo	BatchTaskExecutionInfo	과제 수행에 관한 정보.
jobId	string	그 작업이 속한 작업의 ID.
subtaskId	integer (int32)	멀티 인스턴스 작업이라면 서브태스크의 ID입니다.
taskId	string	과제의 ID.
taskState	BatchTaskState	현재 과제의 상태입니다.
taskUrl	string (uri)	작업 URL입니다.

BatchTaskState

열거형

배치 작업 상태 열거

값	Description
active	작업은 대기열에 저장되어 있고 실행이 가능하지만, 현재 컴퓨트 노드에 할당되어 있지 않습니다. 작업은 생성되었을 때, 비활성화 후 활성화되었을 때, 또는 실패한 실행 후 재시도를 기다리는 상태에 들어갑니다.
preparing	작업은 컴퓨트 노드에 할당되었지만, 컴퓨트 노드에서 필요한 작업 준비 작업이 완료되기를 기다리고 있습니다. 작업 준비 작업이 성공하면 작업은 실행 단계로 넘어갑니다. 작업 준비 작업이 실패하면 작업은 다시 활성 상태로 돌아가 다른 컴퓨트 노드에 할당될 자격이 생깁니다.
running	이 작업은 컴퓨트 노드에서 실행됩니다. 여기에는 리소스 파일 다운로드나 작업에 지정된 패키지 배포와 같은 작업 수준의 준비가 포함되며, 반드시 작업 명령줄이 실행을 시작했다는 의미는 아닙니다.
completed	과제는 더 이상 실행 자격이 없는데, 이는 보통 과제가 성공적으로 완료되었거나, 실패한 후 재시도 한도를 모두 소진했기 때문입니다. 작업 실행 중 오류가 발생하거나 작업이 종료되었을 때도 완료로 표시됩니다.

BatchVmImageReference

Object

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

Name	형식	Description
communityGalleryImageId	string	커뮤니티 갤러리 이미지 고유 식별자. 이 속성은 다른 속성과 함께 사용할 수 없으며 커뮤니티 갤러리 이미지 GET 호출에서 가져올 수 있습니다.
exactVersion	string	노드를 생성하는 데 사용된 플랫폼 이미지 또는 마켓플레이스 이미지의 특정 버전입니다. 이 읽기 전용 필드는 풀이 생성될 때 지정된 '버전' 값이 '최신'일 때만 '버전'과 다릅니다.
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'입니다.
virtualMachineImageId	string (arm-id)	Azure Compute 갤러리 이미지의 ARM 리소스 식별자입니다. 풀 내 컴퓨트 노드는 이 이미지 ID를 사용하여 생성됩니다. 이는 항상 최신 이미지 버전을 기본값으로 사용하는 /subscriptions/{subscriptionId}/resourceGroups/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} 또는 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} 형태로 항상 최신 이미지 버전을 기본값으로 사용합니다. 이 속성은 다른 ImageReference 속성과 상호 배타적입니다. Azure Compute Gallery 이미지는 동일한 지역에 복제본을 가져야 하며, Azure 배치 계정과 동일한 구독에 있어야 합니다. imageId에 이미지 버전이 명시되어 있지 않으면 최신 버전을 사용합니다. 배치 컴퓨트 노드 에이전트가 배치 서비스와 통신할 때 방화벽 설정에 관한 정보는 .를 참조하세요 https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration.

ContainerHostBatchBindMountEntry

Object

작업 컨테이너에 탑재할 경로 및 탑재 모드의 항목입니다.

Name	형식	Description
isReadOnly	boolean	이 원본 경로를 읽기 전용 모드로 탑재합니다. 기본값은 false(읽기/쓰기 모드)입니다. Linux의 경우 이 경로를 읽기/쓰기 모드로 탑재하는 경우 컨테이너의 모든 사용자가 경로에 대한 읽기/쓰기 액세스 권한을 가지는 것은 아니며 호스트 VM의 액세스에 따라 달라집니다. 이 경로가 읽기 전용으로 탑재된 경우 컨테이너 내의 모든 사용자가 경로를 수정할 수 없습니다.
source	ContainerHostDataPath	컨테이너 고객에게 탑재할 경로는 선택할 수 있습니다.

ContainerHostDataPath

열거형

컨테이너 태스크의 컨테이너에 탑재될 경로입니다.

값	Description
Shared	파일을 공유하는 다중 인스턴스 작업의 경로입니다.
Startup	시작 작업의 경로입니다.
VfsMounts	경로에는 이 노드에 탑재된 모든 가상 파일 시스템이 포함됩니다.
Task	작업 경로입니다.
JobPrep	작업 준비 작업 경로입니다.
Applications	애플리케이션 경로입니다.

ContainerRegistryReference

Object

프라이빗 컨테이너 레지스트리입니다.

Name	형식	Description
identityReference	BatchNodeIdentityReference	사용자 이름 및 암호 대신 Azure Container Registry에 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다.
password	string (password)	레지스트리 서버에 로그인할 암호입니다.
registryServer	string (uri)	레지스트리 URL입니다. 생략하면 기본값은 "docker.io"입니다.
username	string	레지스트리 서버에 로그인할 사용자 이름입니다.

ContainerWorkingDirectory

열거형

ContainerWorkingDirectory enums

값	Description
taskWorkingDirectory	표준 배치 서비스 작업 작업 디렉터리를 사용하세요. 이 디렉터리에는 배치가 채워진 작업 자원 파일을 포함할 것입니다.
containerImageDefault	컨테이너 이미지에 정의된 작업 디렉터리를 사용하세요. 이 디렉터리에는 배치가 다운로드한 자원 파일이 포함되지 않을 수 있으니 주의하세요.

ElevationLevel

열거형

고도 수준 열거

값	Description
nonadmin	사용자는 상승된 액세스 권한이 없는 표준 사용자입니다.
admin	사용자는 상승된 액세스 권한을 가진 사용자이며 전체 관리자 권한으로 작동합니다.

EnvironmentSetting

Object

작업 프로세스에서 설정할 환경 변수입니다.

Name	형식	Description
name	string	환경 변수의 이름입니다.
value	string	환경 변수의 값입니다.

InboundEndpoint

Object

컴퓨팅 노드의 인바운드 엔드포인트입니다.

Name	형식	Description
backendPort	integer (int32)	엔드포인트의 백엔드 포트 번호입니다.
frontendPort	integer (int32)	엔드포인트의 공개 포트 번호입니다.
name	string	엔드포인트의 이름입니다.
protocol	InboundEndpointProtocol	엔드포인트의 프로토콜입니다.
publicFQDN	string	컴퓨트 노드의 공개 완전 자격 도메인 이름입니다.
publicIPAddress	string	컴퓨트 노드의 공인 IP 주소입니다.

InboundEndpointProtocol

열거형

InboundEndpointProtocol 열거

값	Description
tcp	엔드포인트에 TCP를 사용합니다.
udp	엔드포인트에 UDP를 사용합니다.

NameValuePair

Object

이름-값 쌍을 나타냅니다.

Name	형식	Description
name	string	이름-값 쌍 안에 있는 이름.
value	string	이름-값 쌍의 값입니다.

ResourceFile

Object

컴퓨팅 노드에 다운로드할 단일 파일 또는 여러 파일입니다.

Name	형식	Description
autoStorageContainerName	string	자동 저장 계정의 저장 컨테이너 이름입니다. autoStorageContainerName, storageContainerUrl 및 httpUrl 속성은 상호 배타적이며 그 중 하나를 지정해야 합니다.
blobPrefix	string	Azure Storage 컨테이너에서 Blob을 다운로드할 때 사용할 Blob 접두사입니다. 이름이 지정된 접두사로 시작하는 Blob만 다운로드됩니다. 이 속성은 autoStorageContainerName 또는 storageContainerUrl을 사용하는 경우에만 유효합니다. 이 접두사는 부분 파일 이름 또는 하위 디렉터리일 수 있습니다. 접두사를 지정하지 않으면 컨테이너의 모든 파일이 다운로드됩니다.
fileMode	string	8진수 형식의 파일 사용 권한 모드 특성입니다. 이 속성은 Linux Compute Nodes에 다운로드되는 파일에만 적용됩니다. 리소스파일이 Windows 컴퓨트 노드에 다운로드되는 경우에는 무시됩니다. 이 속성이 Linux 컴퓨트 노드에 명시되어 있지 않으면, 파일에 기본값 0770이 적용됩니다.
filePath	string	작업을 수행하는 디렉터리에 대해 파일을 다운로드할 컴퓨트 노드의 위치입니다. httpUrl 속성을 지정하면 filePath가 필요하며 파일 이름을 포함하여 파일을 다운로드할 경로를 설명합니다. 그렇지 않으면 autoStorageContainerName 또는 storageContainerUrl 속성이 지정된 경우 filePath는 선택 사항이며 파일을 다운로드할 디렉터리입니다. filePath가 디렉터리로 사용되는 경우 입력 데이터와 이미 연결된 모든 디렉터리 구조가 전체로 유지되고 지정된 filePath 디렉터리에 추가됩니다. 지정된 상대 경로는 작업의 작업 디렉터리를 벗어날 수 없습니다(예: '..' 사용).
httpUrl	string (uri)	다운로드할 파일의 URL입니다. autoStorageContainerName, storageContainerUrl 및 httpUrl 속성은 상호 배타적이며 그 중 하나를 지정해야 합니다. URL이 Azure Blob Storage를 가리키는 경우 컴퓨팅 노드에서 읽을 수 있어야 합니다. Azure Storage에서 Blob에 대한 이러한 URL을 가져오는 세 가지 방법이 있습니다. Blob에 대한 읽기 권한을 부여하는 SAS(공유 액세스 서명)를 포함하거나, 읽기 권한이 있는 관리 ID를 사용하거나, 공용 액세스를 허용하도록 Blob 또는 해당 컨테이너에 대한 ACL을 설정합니다.
identityReference	BatchNodeIdentityReference	storageContainerUrl 또는 httpUrl로 지정한 Azure Blob 저장소에 접근하기 위해 사용하는 사용자 지정 신원에 대한 참조입니다.
storageContainerUrl	string (uri)	Azure Blob Storage 내 Blob 컨테이너의 URL입니다. autoStorageContainerName, storageContainerUrl 및 httpUrl 속성은 상호 배타적이며 그 중 하나를 지정해야 합니다. 이 URL은 컴퓨팅 노드에서 읽을 수 있고 나열할 수 있어야 합니다. Azure Storage에서 컨테이너에 대한 이러한 URL을 가져오는 세 가지 방법이 있습니다. 컨테이너에 대한 읽기 및 목록 권한을 부여하는 SAS(공유 액세스 서명)를 포함하거나, 읽기 및 목록 권한이 있는 관리 ID를 사용하거나, 공용 액세스를 허용하도록 컨테이너에 대한 ACL을 설정합니다.

SchedulingState

열거형

상태 열거 스케줄링

값	Description
enabled	작업은 컴퓨트 노드에서 스케줄링할 수 있습니다.
disabled	컴퓨트 노드에는 새로운 작업이 스케줄링되지 않습니다. 컴퓨트 노드에서 이미 실행 중인 작업도 완료될 때까지 실행할 수 있습니다. 모든 컴퓨트 노드는 스케줄링이 활성화된 상태로 시작합니다.

UserIdentity

Object

작업이 실행되는 사용자 ID의 정의입니다. userName 또는 autoUser 속성을 지정하지만 둘 다 지정하지는 않습니다.

Name	형식	Description
autoUser	AutoUserSpecification	작업이 실행되는 자동 사용자입니다. userName 및 autoUser 속성은 상호 배타적입니다. 둘 다 지정해야 하지만 둘 다 지정하지는 않습니다.
username	string	작업이 실행되는 사용자 신원의 이름입니다. userName 및 autoUser 속성은 상호 배타적입니다. 둘 다 지정해야 하지만 둘 다 지정하지는 않습니다.

VirtualMachineInfo

Object

가상 머신의 현재 상태에 대한 정보입니다.

Name	형식	Description
imageReference	BatchVmImageReference	Azure 가상 머신의 마켓플레이스 이미지에 대한 참조입니다.
scaleSetVmResourceId	string	컴퓨트 노드의 현재 가상 머신 스케일 세트 VM의 자원 ID입니다. 배치 계정이 poolAllocationMode 속성으로 'UserSubscription'으로 설정된 상태에서만 정의됩니다.

다음을 통해 공유

Nodes - List Nodes

URI 매개 변수

요청 헤더

응답

보안

OAuth2Auth

범위

예제

Node list

샘플 요청

샘플 응답

정의

AutoUserScope

AutoUserSpecification

BatchError

BatchErrorDetail

BatchErrorMessage

BatchErrorSourceCategory

BatchNode

BatchNodeAgentInfo

BatchNodeEndpointConfiguration

BatchNodeError

BatchNodeIdentityReference

BatchNodeListResult

BatchNodeState

BatchStartTask

BatchStartTaskInfo

BatchStartTaskState

BatchTaskContainerExecutionInfo

BatchTaskContainerSettings

BatchTaskExecutionInfo

BatchTaskExecutionResult

BatchTaskFailureInfo

BatchTaskInfo

BatchTaskState

BatchVmImageReference

ContainerHostBatchBindMountEntry

ContainerHostDataPath

ContainerRegistryReference

ContainerWorkingDirectory

ElevationLevel

EnvironmentSetting

InboundEndpoint

InboundEndpointProtocol

NameValuePair

ResourceFile

SchedulingState

UserIdentity

VirtualMachineInfo