Compute Node - Get

참조

서비스:: Batch Service

API 버전:: 2024-07-01.20.0

지정된 컴퓨팅 노드에 대한 정보를 가져옵니다.

GET {batchUrl}/pools/{poolId}/nodes/{nodeId}?api-version=2024-07-01.20.0

선택적 매개 변수:

GET {batchUrl}/pools/{poolId}/nodes/{nodeId}?$select={$select}&timeout={timeout}&api-version=2024-07-01.20.0

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
batchUrl	path	True	string	모든 Azure Batch 서비스 요청에 대한 기본 URL입니다.
nodeId	path	True	string	정보를 가져오려는 컴퓨팅 노드의 ID입니다.
poolId	path	True	string	컴퓨팅 노드를 포함하는 풀의 ID입니다.
api-version	query	True	string	클라이언트 API 버전입니다.
$select	query		string	OData $select 절입니다.
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	ComputeNode	컴퓨팅 노드를 포함하는 응답입니다. 헤더 client-request-id: string request-id: string ETag: string Last-Modified: string
Other Status Codes	BatchError	Batch 서비스의 오류입니다.

Name

형식

Description

200 OK

ComputeNode

컴퓨팅 노드를 포함하는 응답입니다.

헤더

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

예제

Node get

샘플 요청

HTTP

GET account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z?api-version=2024-07-01.20.0

샘플 응답

상태 코드:: 200

{
  "id": "tvm-1695681911_2-20161122t193202z",
  "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z",
  "state": "idle",
  "schedulingState": "enabled",
  "stateTransitionTime": "2016-11-22T19:37:31.4285526Z",
  "lastBootTime": "2016-11-22T19:37:28.623369Z",
  "allocationTime": "2016-11-22T19:32:02.8155319Z",
  "ipAddress": "1.1.1.1",
  "affinityId": "TVM:tvm-1695681911_2-20161122t193202z",
  "vmSize": "small",
  "totalTasksRun": 0,
  "totalTasksSucceeded": 0,
  "runningTasksCount": 0,
  "isDedicated": true,
  "startTask": {
    "commandLine": "cmd /c echo hello",
    "userIdentity": {
      "autoUser": {
        "scope": "task",
        "elevationLevel": "nonadmin"
      }
    },
    "maxTaskRetryCount": 0,
    "waitForSuccess": false
  },
  "startTaskInfo": {
    "state": "completed",
    "startTime": "2016-11-22T19:37:31.4285526Z",
    "endTime": "2016-11-22T19:37:31.838028Z",
    "exitCode": 0,
    "retryCount": 0
  },
  "nodeAgentInfo": {
    "version": "1.2.0.0",
    "lastUpdateTime": "2016-11-22T19:37:28.623369Z"
  }
}

정의

Name	Description
AutoUserScope	자동 사용자에 대한 범위
AutoUserSpecification	Batch 서비스에서 작업을 실행하는 자동 사용자에 대한 매개 변수를 지정합니다.
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
CertificateReference	풀의 컴퓨팅 노드에 설치할 인증서에 대한 참조입니다.
CertificateStoreLocation	인증서를 설치할 컴퓨팅 노드의 인증서 저장소 위치입니다.
CertificateVisibility	컴퓨팅 노드의 사용자 계정이 인증서의 프라이빗 데이터에 액세스할 수 있어야 합니다.
ComputeNode	Batch 서비스의 컴퓨팅 노드입니다.
ComputeNodeEndpointConfiguration	컴퓨팅 노드에 대한 엔드포인트 구성입니다.
ComputeNodeError	컴퓨팅 노드에서 발생한 오류입니다.
ComputeNodeIdentityReference	컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.
ComputeNodeState	컴퓨팅 노드의 현재 상태입니다.
ContainerHostBatchBindMountEntry	작업 컨테이너에 탑재할 경로 및 탑재 모드의 항목입니다.
ContainerHostDataPath	컨테이너 태스크의 컨테이너에 탑재될 경로입니다.
ContainerRegistry	프라이빗 컨테이너 레지스트리입니다.
ContainerWorkingDirectory	컨테이너 작업 디렉터리의 위치입니다.
ElevationLevel	사용자의 권한 상승 수준입니다.
EnvironmentSetting	작업 프로세스에서 설정할 환경 변수입니다.
ErrorCategory	오류의 범주입니다.
ErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
ImageReference	Azure Virtual Machines Marketplace 이미지 또는 Azure Compute 갤러리 이미지에 대한 참조입니다. Azure Batch에서 확인된 모든 Azure Marketplace 이미지 참조 목록을 보려면 '지원되는 이미지 나열' 작업을 참조하세요.
InboundEndpoint	컴퓨팅 노드의 인바운드 엔드포인트입니다.
InboundEndpointProtocol	엔드포인트의 프로토콜입니다.
NameValuePair	이름-값 쌍을 나타냅니다.
NodeAgentInformation	Compute Node 에이전트에 대한 정보입니다.
ResourceFile	컴퓨팅 노드에 다운로드할 단일 파일 또는 여러 파일입니다.
SchedulingState	컴퓨팅 노드를 작업 예약에 사용할 수 있는지 여부입니다.
StartTask	노드가 Azure Batch 서비스에서 풀에 조인하거나 컴퓨팅 노드를 다시 부팅하거나 이미지로 다시 설치할 때 실행되는 작업입니다.
StartTaskInformation	컴퓨팅 노드에서 실행되는 StartTask에 대한 정보입니다.
StartTaskState	컴퓨팅 노드의 StartTask 상태입니다.
TaskContainerExecutionInformation	태스크가 실행 중인 컨테이너에 대한 정보를 포함합니다.
TaskContainerSettings	작업에 대한 컨테이너 설정입니다.
TaskExecutionInformation	작업 실행에 대한 정보입니다.
TaskExecutionResult	작업 실행의 결과입니다.
TaskFailureInformation	작업 실패에 대한 정보입니다.
TaskInformation	컴퓨팅 노드에서 실행되는 태스크에 대한 정보입니다.
TaskState	작업의 상태입니다.
UserIdentity	작업이 실행되는 사용자 ID의 정의입니다.
VirtualMachineInfo	가상 머신의 현재 상태에 대한 정보입니다.

AutoUserScope

자동 사용자에 대한 범위

Name	형식	Description
pool	string	태스크가 풀의 모든 컴퓨팅 노드에서 생성되는 공통 자동 사용자 계정으로 실행되도록 지정합니다.
task	string	서비스에서 Task에 대한 새 사용자를 만들어야 임을 지정합니다.

AutoUserSpecification

Batch 서비스에서 작업을 실행하는 자동 사용자에 대한 매개 변수를 지정합니다.

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

BatchError

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

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

BatchErrorDetail

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

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

CertificateReference

풀의 컴퓨팅 노드에 설치할 인증서에 대한 참조입니다.

Name	형식	Description
storeLocation	CertificateStoreLocation	인증서를 설치할 컴퓨팅 노드의 인증서 저장소 위치입니다. 기본값은 currentuser입니다. 이 속성은 Windows 컴퓨팅 노드로 구성된 풀에만 적용됩니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 AZ_BATCH_CERTIFICATES_DIR 환경 변수는 이 위치를 쿼리하기 위해 태스크에 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다.
storeName	string	인증서를 설치할 컴퓨팅 노드의 인증서 저장소 이름입니다. 이 속성은 Windows 컴퓨팅 노드로 구성된 풀에만 적용됩니다. 일반적인 저장소 이름에는 My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook 등이 있지만 사용자 지정 저장소 이름도 사용할 수 있습니다. 기본값은 My입니다.
thumbprint	string	인증서의 지문입니다.
thumbprintAlgorithm	string	지문이 연결된 알고리즘입니다. sha1이어야 합니다.
visibility	CertificateVisibility[]	컴퓨팅 노드의 사용자 계정이 인증서의 프라이빗 데이터에 액세스할 수 있어야 합니다. 이 컬렉션에서 둘 이상의 표시 유형을 지정할 수 있습니다. 기본값은 모든 계정입니다.

CertificateStoreLocation

인증서를 설치할 컴퓨팅 노드의 인증서 저장소 위치입니다.

Name	형식	Description
currentuser	string	인증서는 CurrentUser 인증서 저장소에 설치해야 합니다.
localmachine	string	인증서는 LocalMachine 인증서 저장소에 설치해야 합니다.

CertificateVisibility

컴퓨팅 노드의 사용자 계정이 인증서의 프라이빗 데이터에 액세스할 수 있어야 합니다.

Name	형식	Description
remoteuser	string	인증서는 사용자가 컴퓨팅 노드에 원격으로 액세스하는 사용자 계정에 표시되어야 합니다.
starttask	string	인증서는 StartTask가 실행되는 사용자 계정에 표시됩니다. AutoUser 범위가 StartTask 및 작업 모두에 대한 풀인 경우 이 인증서도 작업에 표시됩니다.
task	string	인증서는 작업 작업이 실행되는 사용자 계정에 표시되어야 합니다.

ComputeNode

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

Name	형식	Description
affinityId	string	이 컴퓨팅 노드에서 작업을 예약하도록 요청하는 작업을 추가할 때 전달할 수 있는 식별자입니다. 이것은 단지 부드러운 선호도입니다. 작업이 예약될 때 대상 컴퓨팅 노드가 사용 중이거나 사용할 수 없는 경우 작업은 다른 곳에서 예약됩니다.
allocationTime	string	이 컴퓨팅 노드가 풀에 할당된 시간입니다. 컴퓨팅 노드가 처음 할당되고 설정된 후에는 변경되지 않는 시간입니다. 컴퓨팅 노드가 서비스를 복구하거나 선점할 때 업데이트되지 않습니다.
certificateReferences	CertificateReference[]	컴퓨팅 노드에 설치된 인증서 목록입니다. Windows 노드의 경우 Batch 서비스는 지정된 인증서 저장소 및 위치에 인증서를 설치합니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 AZ_BATCH_CERTIFICATES_DIR 환경 변수는 이 위치를 쿼리하기 위해 태스크에 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다. 경고: 이 속성은 더 이상 사용되지 않으며 2024년 2월 이후에 제거됩니다. 대신 Azure KeyVault 확장 사용하세요.
endpointConfiguration	ComputeNodeEndpointConfiguration	컴퓨팅 노드에 대한 엔드포인트 구성입니다.
errors	ComputeNodeError[]	컴퓨팅 노드에서 현재 발생하는 오류 목록입니다.
id	string	컴퓨팅 노드의 ID입니다. 풀에 추가된 모든 컴퓨팅 노드에는 고유한 ID가 할당됩니다. 컴퓨팅 노드가 풀에서 제거될 때마다 모든 로컬 파일이 삭제되고 ID가 회수되고 새 컴퓨팅 노드에 다시 사용할 수 있습니다.
ipAddress	string	다른 노드가 이 컴퓨팅 노드와 통신하는 데 사용할 수 있는 IP 주소입니다. 풀에 추가된 모든 컴퓨팅 노드에는 고유한 IP 주소가 할당됩니다. 컴퓨팅 노드가 풀에서 제거될 때마다 모든 로컬 파일이 삭제되고 IP 주소가 회수되고 새 컴퓨팅 노드에 다시 사용할 수 있습니다.
isDedicated	boolean	이 컴퓨팅 노드가 전용 컴퓨팅 노드인지 여부입니다. false이면 컴퓨팅 노드는 스폿/우선 순위가 낮은 컴퓨팅 노드입니다.
lastBootTime	string	컴퓨팅 노드가 마지막으로 시작된 시간입니다. 컴퓨팅 노드 상태를 사용할 수 없는 경우 이 속성이 없을 수 있습니다.
nodeAgentInfo	NodeAgentInformation	컴퓨팅 노드 에이전트 버전 및 컴퓨팅 노드가 새 버전으로 업그레이드된 시간에 대한 정보입니다. Batch Compute 노드 에이전트는 풀의 각 컴퓨팅 노드에서 실행되며 컴퓨팅 노드에서 Batch 기능을 제공하는 프로그램입니다.
recentTasks	TaskInformation[]	최근 상태가 변경된 작업 목록입니다. 이 속성은 풀에 할당된 이후 이 컴퓨팅 노드에서 하나 이상의 작업이 실행된 경우에만 존재합니다.
runningTaskSlotsCount	integer	컴퓨팅 노드에서 현재 작업 작업을 실행하는 데 사용되는 총 일정 슬롯 수입니다. 여기에는 작업 관리자 작업 및 일반 작업이 포함되지만 작업 준비, 작업 릴리스 또는 시작 태스크는 포함되지 않습니다.
runningTasksCount	integer	컴퓨팅 노드에서 현재 실행 중인 작업 작업의 총 수입니다. 여기에는 작업 관리자 작업 및 일반 작업이 포함되지만 작업 준비, 작업 릴리스 또는 시작 태스크는 포함되지 않습니다.
schedulingState	SchedulingState	컴퓨팅 노드를 작업 예약에 사용할 수 있는지 여부입니다.
startTask	StartTask	풀에 조인할 때 컴퓨팅 노드에서 실행하도록 지정된 작업입니다. Batch는 노드에서 복구 작업이 트리거될 때 작업을 다시 시도합니다. 복구 작업의 예로는 비정상 노드가 다시 부팅되거나 호스트 오류로 인해 컴퓨팅 노드가 사라진 경우(제한되지 않음) 등이 있습니다. 복구 작업으로 인한 재시도는 maxTaskRetryCount와 독립적이며 계산되지 않습니다. maxTaskRetryCount가 0이더라도 복구 작업으로 인한 내부 재시도가 발생할 수 있습니다. 이 때문에 모든 작업은 idempotent여야 합니다. 즉, 작업이 손상되거나 중복된 데이터를 유발하지 않고 중단되고 다시 시작되는 것을 허용해야 합니다. 장기 실행 작업의 모범 사례는 일종의 검사점을 사용하는 것입니다. 경우에 따라 컴퓨팅 노드가 다시 부팅되지 않은 경우에도 StartTask가 다시 실행될 수 있습니다. 중단 프로세스를 만들거나 StartTask 작업 디렉터리에서 서비스를 설치/시작하는 StartTasks를 방지하기 위해 특별히 주의해야 합니다. 이렇게 하면 Batch가 StartTask를 다시 실행할 수 없게 됩니다.
startTaskInfo	StartTaskInformation	컴퓨팅 노드에서 StartTask 실행에 대한 런타임 정보입니다.
state	ComputeNodeState	컴퓨팅 노드의 현재 상태입니다. 우선 순위가 낮은 스폿/낮은 컴퓨팅 노드가 선점되었습니다. 컴퓨팅 노드가 선점되었을 때 실행 중이던 작업은 다른 컴퓨팅 노드를 사용할 수 있게 되면 다시 예약됩니다.
stateTransitionTime	string	컴퓨팅 노드가 현재 상태를 입력한 시간입니다.
totalTasksRun	integer	컴퓨팅 노드에서 완료된 총 작업 작업 수입니다. 여기에는 작업 관리자 작업 및 일반 작업이 포함되지만 작업 준비, 작업 릴리스 또는 시작 태스크는 포함되지 않습니다.
totalTasksSucceeded	integer	컴퓨팅 노드에서 성공적으로 완료된 총 작업 작업 수(exitCode 0 포함)입니다. 여기에는 작업 관리자 작업 및 일반 작업이 포함되지만 작업 준비, 작업 릴리스 또는 시작 태스크는 포함되지 않습니다.
url	string	컴퓨팅 노드의 URL입니다.
virtualMachineInfo	VirtualMachineInfo	가상 머신의 현재 상태에 대한 정보입니다.
vmSize	string	컴퓨팅 노드를 호스팅하는 가상 머신의 크기입니다. 풀에서 사용 가능한 가상 머신 크기에 대한 자세한 내용은 Azure Batch 풀(https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes)에서 컴퓨팅 노드에 대한 VM 크기 선택을 참조하세요.

ComputeNodeEndpointConfiguration

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

Name	형식	Description
inboundEndpoints	InboundEndpoint[]	컴퓨팅 노드에서 액세스할 수 있는 인바운드 엔드포인트 목록입니다.

ComputeNodeError

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

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

ComputeNodeIdentityReference

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

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

ComputeNodeState

컴퓨팅 노드의 현재 상태입니다.

Name	형식	Description
creating	string	Batch 서비스는 Azure Compute에서 기본 가상 머신을 얻었지만 아직 풀에 조인하기 시작하지 않았습니다.
deallocated	string	컴퓨팅 노드의 할당이 취소되었습니다.
deallocating	string	컴퓨팅 노드의 할당이 취소되었습니다.
idle	string	컴퓨팅 노드가 현재 작업을 실행하고 있지 않습니다.
leavingpool	string	컴퓨팅 노드는 사용자가 명시적으로 풀을 제거했거나 풀의 크기 조정 또는 자동 크기 조정 때문에 풀을 종료합니다.
offline	string	컴퓨팅 노드가 현재 태스크를 실행하고 있지 않으며 컴퓨팅 노드에 대한 새 태스크 예약을 사용할 수 없습니다.
preempted	string	우선 순위가 낮은 스폿/낮은 컴퓨팅 노드가 선점되었습니다. 컴퓨팅 노드가 선점되었을 때 실행 중이던 작업은 다른 컴퓨팅 노드를 사용할 수 있게 되면 다시 예약됩니다.
rebooting	string	컴퓨팅 노드가 다시 부팅되고 있습니다.
reimaging	string	컴퓨팅 노드가 이미지로 다시 설치됩니다.
running	string	컴퓨팅 노드에서 하나 이상의 작업(StartTask 이외의)을 실행하고 있습니다.
starting	string	Batch 서비스가 기본 가상 머신에서 시작됩니다.
starttaskfailed	string	Compute 노드에서 StartTask가 실패하고(모든 재시도가 모두 사용됨) waitForSuccess가 설정되었습니다. 컴퓨팅 노드는 작업을 실행하는 데 사용할 수 없습니다.
unknown	string	Batch 서비스가 Compute 노드와의 접촉을 끊었으며 해당 실제 상태를 알지 못합니다.
unusable	string	오류로 인해 컴퓨팅 노드를 작업 실행에 사용할 수 없습니다.
upgradingos	string	컴퓨팅 노드가 OS 업그레이드 작업을 진행 중입니다.
waitingforstarttask	string	StartTask가 컴퓨팅 노드에서 실행되기 시작했지만 waitForSuccess가 설정되었으며 StartTask가 아직 완료되지 않았습니다.

ContainerHostBatchBindMountEntry

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

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

ContainerHostDataPath

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

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

ContainerRegistry

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

Name	형식	Description
identityReference	ComputeNodeIdentityReference	사용자 이름 및 암호 대신 Azure Container Registry에 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다. 컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.
password	string	레지스트리 서버에 로그인할 암호입니다.
registryServer	string	레지스트리 URL입니다. 생략하면 기본값은 "docker.io"입니다.
username	string	레지스트리 서버에 로그인할 사용자 이름입니다.

ContainerWorkingDirectory

컨테이너 작업 디렉터리의 위치입니다.

Name	형식	Description
containerImageDefault	string	컨테이너 이미지에 정의된 작업 디렉터리를 사용합니다. 이 디렉터리에는 Batch에서 다운로드한 리소스 파일이 포함되지 않습니다.
taskWorkingDirectory	string	Batch로 채워진 작업 리소스 파일을 포함하는 표준 Batch 서비스 작업 디렉터리를 사용합니다.

ElevationLevel

사용자의 권한 상승 수준입니다.

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

EnvironmentSetting

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

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

ErrorCategory

오류의 범주입니다.

Name	형식	Description
servererror	string	이 오류는 내부 서버 문제로 인해 발생합니다.
usererror	string	오류는 잘못된 구성과 같은 사용자 문제로 인해 발생합니다.

ErrorMessage

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

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

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://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration참조하세요.

InboundEndpoint

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

Name	형식	Description
backendPort	integer	엔드포인트의 백 엔드 포트 번호입니다.
frontendPort	integer	엔드포인트의 공용 포트 번호입니다.
name	string	엔드포인트의 이름입니다.
protocol	InboundEndpointProtocol	엔드포인트의 프로토콜입니다.
publicFQDN	string	컴퓨팅 노드의 퍼블릭 정규화된 도메인 이름입니다.
publicIPAddress	string	컴퓨팅 노드의 공용 IP 주소입니다.

InboundEndpointProtocol

엔드포인트의 프로토콜입니다.

Name	형식	Description
tcp	string	엔드포인트에 TCP를 사용합니다.
udp	string	엔드포인트에 UDP를 사용합니다.

NameValuePair

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

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

NodeAgentInformation

Compute Node 에이전트에 대한 정보입니다.

Name	형식	Description
lastUpdateTime	string	컴퓨팅 노드 에이전트가 컴퓨팅 노드에서 업데이트된 시간입니다. 컴퓨팅 노드 에이전트가 새 버전으로 업데이트된 가장 최근의 시간입니다.
version	string	컴퓨팅 노드에서 실행되는 Batch Compute 노드 에이전트의 버전입니다. 이 버전 번호는 https://github.com/Azure/Batch/blob/master/changelogs/nodeagent/CHANGELOG.md있는 Compute Node 에이전트 릴리스 정보에 대해 확인할 수 있습니다.

ResourceFile

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

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

SchedulingState

컴퓨팅 노드를 작업 예약에 사용할 수 있는지 여부입니다.

Name	형식	Description
disabled	string	컴퓨팅 노드에는 새 작업이 예약되지 않습니다. 컴퓨팅 노드에서 이미 실행 중인 작업은 완료될 수 있습니다. 모든 컴퓨팅 노드는 예약을 사용하도록 설정하여 시작합니다.
enabled	string	컴퓨팅 노드에서 작업을 예약할 수 있습니다.

StartTask

노드가 Azure Batch 서비스에서 풀에 조인하거나 컴퓨팅 노드를 다시 부팅하거나 이미지로 다시 설치할 때 실행되는 작업입니다.

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	TaskContainerSettings	StartTask가 실행되는 컨테이너에 대한 설정입니다. 이 옵션을 지정하면 AZ_BATCH_NODE_ROOT_DIR 아래의 모든 디렉터리(노드의 Azure Batch 디렉터리 루트)가 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되고, 작업 명령줄이 컨테이너에서 실행됩니다. AZ_BATCH_NODE_ROOT_DIR 외부 컨테이너에서 생성된 파일은 호스트 디스크에 반영되지 않을 수 있습니다. 즉, Batch 파일 API가 해당 파일에 액세스할 수 없습니다.
environmentSettings	EnvironmentSetting[]	StartTask에 대한 환경 변수 설정 목록입니다.
maxTaskRetryCount	integer	작업을 재시도할 수 있는 최대 횟수입니다. Batch 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도합니다. 이 값은 특히 재시도 횟수를 제어합니다. Batch 서비스는 작업을 한 번 시도한 다음 이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 태스크를 최대 4번(초기 시도 1회, 재시도 3회)을 시도합니다. 최대 재시도 횟수가 0이면 Batch 서비스가 작업을 다시 시도하지 않습니다. 최대 재시도 횟수가 -1인 경우 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 그러나 시작 작업이나 작업에는 권장되지 않습니다. 기본값은 0(재시도 안 됨)입니다.
resourceFiles	ResourceFile[]	명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드는 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다. 이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다.
userIdentity	UserIdentity	StartTask가 실행되는 사용자 ID입니다. 생략하면 태스크가 작업에 고유한 비관리 사용자로 실행됩니다.
waitForSuccess	boolean	Batch 서비스가 Compute 노드에서 작업을 예약하기 전에 StartTask가 성공적으로 완료될 때까지 대기해야 하는지 여부(즉, 종료 코드 0으로 종료). True이고 StartTask가 노드에서 실패하는 경우 Batch 서비스는 StartTask를 최대 다시 시도 횟수(maxTaskRetryCount)까지 다시 시도합니다. 모든 재시도 후에도 작업이 성공적으로 완료되지 않은 경우 Batch 서비스는 노드를 사용할 수 없음으로 표시하고 작업을 예약하지 않습니다. 이 조건은 컴퓨팅 노드 상태 및 오류 정보 세부 정보를 통해 검색할 수 있습니다. false이면 Batch 서비스는 StartTask가 완료될 때까지 기다리지 않습니다. 이 경우 StartTask가 계속 실행되는 동안 다른 태스크가 컴퓨팅 노드에서 실행을 시작할 수 있습니다. StartTask가 실패하더라도 컴퓨팅 노드에서 새 작업이 계속 예약됩니다. 기본값은 true입니다.

StartTaskInformation

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

Name	형식	Description
containerInfo	TaskContainerExecutionInformation	태스크가 실행 중인 컨테이너에 대한 정보입니다. 이 속성은 태스크가 컨테이너 컨텍스트에서 실행되는 경우에만 설정됩니다.
endTime	string	StartTask가 실행을 중지한 시간입니다. 실행이 완료된 경우(해당 실행이 실패하고 다시 시도가 보류 중인 경우에도) StartTask의 가장 최근 실행 종료 시간입니다. StartTask가 현재 실행 중인 경우에는 이 요소가 없습니다.
exitCode	integer	StartTask 명령줄에 지정된 프로그램의 종료 코드입니다. 이 속성은 StartTask가 완료된 상태인 경우에만 설정됩니다. 일반적으로 프로세스의 종료 코드는 해당 프로세스에 대해 애플리케이션 개발자가 구현한 특정 규칙을 반영합니다. 종료 코드 값을 사용하여 코드에서 결정을 내리는 경우 애플리케이션 프로세스에서 사용하는 종료 코드 규칙을 알고 있어야 합니다. 그러나 Batch 서비스가 StartTask를 종료하는 경우(시간 제한 또는 API를 통한 사용자 종료로 인해) 운영 체제 정의 종료 코드가 표시될 수 있습니다.
failureInfo	TaskFailureInformation	작업 실패(있는 경우)를 설명하는 정보입니다. 이 속성은 작업이 완료된 상태이고 오류가 발생한 경우에만 설정됩니다.
lastRetryTime	string	작업의 재시도가 실행되기 시작한 가장 최근의 시간입니다. 이 요소는 Task가 다시 시도된 경우에만 존재합니다(예: retryCount가 0이 아닌 경우). 있는 경우 일반적으로 startTime과 동일하지만 재시도 이외의 이유로 작업을 다시 시작한 경우 다를 수 있습니다. 예를 들어 다시 시도하는 동안 컴퓨팅 노드가 다시 부팅된 경우 startTime은 업데이트되지만 lastRetryTime은 업데이트되지 않습니다.
result	TaskExecutionResult	작업 실행의 결과입니다. 값이 'failed'이면 failureInfo 속성에서 오류의 세부 정보를 찾을 수 있습니다.
retryCount	integer	Batch 서비스에서 태스크를 다시 시도한 횟수입니다. 작업 응용 프로그램 오류(0이 아닌 종료 코드)는 다시 시도되고, 사전 처리 오류(작업을 실행할 수 없음) 및 파일 업로드 오류가 다시 시도되지 않습니다. Batch 서비스는 제약 조건에 지정된 제한까지 태스크를 다시 시도합니다.
startTime	string	StartTask가 실행되기 시작한 시간입니다. 이 값은 작업이 다시 시작되거나 다시 시도될 때마다 다시 설정됩니다(즉, StartTask가 실행되기 시작한 가장 최근 시간입니다).
state	StartTaskState	컴퓨팅 노드의 StartTask 상태입니다.

StartTaskState

컴퓨팅 노드의 StartTask 상태입니다.

Name	형식	Description
completed	string	StartTask가 종료 코드 0으로 종료되었거나 StartTask가 실패하고 다시 시도 제한에 도달했거나 작업 준비 오류(예: 리소스 파일 다운로드 실패)로 인해 StartTask 프로세스가 실행되지 않았습니다.
running	string	StartTask가 현재 실행 중입니다.

TaskContainerExecutionInformation

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

Name	형식	Description
containerId	string	컨테이너의 ID입니다.
error	string	컨테이너에 대한 자세한 오류 정보입니다. 사용 가능한 경우 Docker 서비스의 자세한 오류 문자열입니다. "docker inspect"에서 반환하는 오류 필드와 동일합니다.
state	string	컨테이너의 상태입니다. Docker 서비스에 따라 컨테이너의 상태입니다. "docker inspect"에서 반환하는 상태 필드와 동일합니다.

TaskContainerSettings

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

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

TaskExecutionInformation

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

Name	형식	Description
containerInfo	TaskContainerExecutionInformation	태스크가 실행 중인 컨테이너에 대한 정보입니다. 이 속성은 태스크가 컨테이너 컨텍스트에서 실행되는 경우에만 설정됩니다.
endTime	string	태스크가 완료된 시간입니다. 이 속성은 작업이 완료된 상태인 경우에만 설정됩니다.
exitCode	integer	작업 명령줄에 지정된 프로그램의 종료 코드입니다. 이 속성은 작업이 완료된 상태인 경우에만 설정됩니다. 일반적으로 프로세스의 종료 코드는 해당 프로세스에 대해 애플리케이션 개발자가 구현한 특정 규칙을 반영합니다. 종료 코드 값을 사용하여 코드에서 결정을 내리는 경우 애플리케이션 프로세스에서 사용하는 종료 코드 규칙을 알고 있어야 합니다. 그러나 Batch 서비스가 작업(시간 제한 또는 API를 통한 사용자 종료로 인해)을 종료하는 경우 운영 체제 정의 종료 코드가 표시될 수 있습니다.
failureInfo	TaskFailureInformation	작업 실패(있는 경우)를 설명하는 정보입니다. 이 속성은 작업이 완료된 상태이고 오류가 발생한 경우에만 설정됩니다.
lastRequeueTime	string	사용자 요청의 결과로 Batch 서비스에서 태스크를 다시 큐에 저장한 가장 최근 시간입니다. 이 속성은 requeueCount가 0이 아닌 경우에만 설정됩니다.
lastRetryTime	string	작업의 재시도가 실행되기 시작한 가장 최근의 시간입니다. 이 요소는 Task가 다시 시도된 경우에만 존재합니다(예: retryCount가 0이 아닌 경우). 있는 경우 일반적으로 startTime과 동일하지만 재시도 이외의 이유로 작업을 다시 시작한 경우 다를 수 있습니다. 예를 들어 다시 시도하는 동안 컴퓨팅 노드가 다시 부팅된 경우 startTime은 업데이트되지만 lastRetryTime은 업데이트되지 않습니다.
requeueCount	integer	사용자 요청의 결과로 Batch 서비스에서 작업을 다시 큐에 대기한 횟수입니다. 사용자가 풀의 크기 조정/축소를 통해 풀에서 컴퓨팅 노드를 제거하거나 작업을 사용하지 않도록 설정할 때 사용자는 컴퓨팅 노드에서 실행 중인 작업을 실행하기 위해 다시 큐에 추가되도록 지정할 수 있습니다. 이 개수는 이러한 이유로 작업이 다시 큐에 지정된 횟수를 추적합니다.
result	TaskExecutionResult	작업 실행의 결과입니다. 값이 'failed'이면 failureInfo 속성에서 오류의 세부 정보를 찾을 수 있습니다.
retryCount	integer	Batch 서비스에서 태스크를 다시 시도한 횟수입니다. 작업 응용 프로그램 오류(0이 아닌 종료 코드)는 다시 시도되고, 사전 처리 오류(작업을 실행할 수 없음) 및 파일 업로드 오류가 다시 시도되지 않습니다. Batch 서비스는 제약 조건에 지정된 제한까지 태스크를 다시 시도합니다.
startTime	string	태스크가 실행되기 시작한 시간입니다. '실행 중'은 실행 중 상태에 해당하므로 태스크에서 리소스 파일 또는 패키지를 지정하는 경우 시작 시간은 태스크가 다운로드 또는 배포를 시작한 시간을 반영합니다. 작업을 다시 시작하거나 다시 시도한 경우 태스크가 실행되기 시작한 가장 최근 시간입니다. 이 속성은 실행 중이거나 완료된 상태에 있는 작업에 대해서만 존재합니다.

TaskExecutionResult

작업 실행의 결과입니다.

Name	형식	Description
failure	string	작업을 처리하는 동안 오류가 발생했습니다. 태스크 프로세스가 시작되기 전, 작업 프로세스가 실행되는 동안 또는 작업 프로세스가 종료된 후에 오류가 발생했을 수 있습니다.
success	string	작업이 성공적으로 실행되었습니다.

TaskFailureInformation

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

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

TaskInformation

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

Name	형식	Description
executionInfo	TaskExecutionInformation	작업 실행에 대한 정보입니다.
jobId	string	작업이 속한 작업의 ID입니다.
subtaskId	integer	작업이 다중 인스턴스 작업인 경우 하위 작업의 ID입니다.
taskId	string	작업의 ID입니다.
taskState	TaskState	작업의 현재 상태입니다.
taskUrl	string	작업의 URL입니다.

TaskState

작업의 상태입니다.

Name	형식	Description
active	string	작업이 큐에 대기되고 실행할 수 있지만 현재 컴퓨팅 노드에 할당되지 않았습니다. 태스크는 생성될 때, 사용하지 않도록 설정한 후 사용하도록 설정되거나, 실행이 실패한 후 재시도를 기다리고 있을 때 이 상태로 들어갑니다.
completed	string	태스크가 성공적으로 완료되었거나 태스크가 성공적으로 완료되고 재시도 한도가 소진되었으므로 태스크를 더 이상 실행할 수 없습니다. 태스크를 시작하는 동안 오류가 발생했거나 태스크가 종료된 경우에도 작업이 완료된 것으로 표시됩니다.
preparing	string	태스크가 컴퓨팅 노드에 할당되었지만 컴퓨팅 노드에서 필요한 작업 준비 태스크가 완료될 때까지 기다리고 있습니다. 작업 준비 태스크가 성공하면 태스크가 실행 중으로 이동합니다. 작업 준비 태스크가 실패하면 태스크가 활성 상태로 돌아가서 다른 컴퓨팅 노드에 할당될 수 있습니다.
running	string	태스크가 컴퓨팅 노드에서 실행되고 있습니다. 여기에는 리소스 파일 다운로드 또는 태스크에 지정된 패키지 배포와 같은 작업 수준 준비가 포함됩니다. 태스크 명령줄이 실행되기 시작했다는 의미는 아닙니다.

UserIdentity

작업이 실행되는 사용자 ID의 정의입니다.

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

VirtualMachineInfo

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

Name	형식	Description
imageReference	ImageReference	Azure Virtual Machine의 Marketplace 이미지에 대한 참조입니다.
scaleSetVmResourceId	string	컴퓨팅 노드의 현재 Virtual Machine Scale Set VM의 리소스 ID입니다. Batch 계정이 poolAllocationMode 속성을 'UserSubscription'으로 설정하여 만든 경우에만 정의됩니다.

다음을 통해 공유

Compute Node - Get

URI 매개 변수

요청 헤더

응답

보안

azure_auth

범위

Authorization

예제

Node get

샘플 요청

샘플 응답

정의

AutoUserScope

AutoUserSpecification

BatchError

BatchErrorDetail

CertificateReference

CertificateStoreLocation

CertificateVisibility

ComputeNode

ComputeNodeEndpointConfiguration

ComputeNodeError

ComputeNodeIdentityReference

ComputeNodeState

ContainerHostBatchBindMountEntry

ContainerHostDataPath

ContainerRegistry

ContainerWorkingDirectory

ElevationLevel

EnvironmentSetting

ErrorCategory

ErrorMessage

ImageReference

InboundEndpoint

InboundEndpointProtocol

NameValuePair

NodeAgentInformation

ResourceFile

SchedulingState

StartTask

StartTaskInformation

StartTaskState

TaskContainerExecutionInformation

TaskContainerSettings

TaskExecutionInformation

TaskExecutionResult

TaskFailureInformation

TaskInformation

TaskState

UserIdentity

VirtualMachineInfo

추가 리소스