Compute Node - Get
지정된 컴퓨팅 노드에 대한 정보를 가져옵니다.
GET {batchUrl}/pools/{poolId}/nodes/{nodeId}?api-version=2023-11-01.18.0
GET {batchUrl}/pools/{poolId}/nodes/{nodeId}?$select={$select}&timeout={timeout}&api-version=2023-11-01.18.0
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
batch
|
path | True |
string |
모든 Azure Batch 서비스 요청에 대한 기본 URL입니다. |
node
|
path | True |
string |
정보를 가져오려는 컴퓨팅 노드의 ID입니다. |
pool
|
path | True |
string |
컴퓨팅 노드를 포함하는 풀의 ID입니다. |
api-version
|
query | True |
string |
클라이언트 API 버전. |
$select
|
query |
string |
OData $select 절입니다. |
|
timeout
|
query |
integer int32 |
서버에서 요청을 처리하는 데 소요할 수 있는 최대 시간(초)입니다. 기본값은 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 |
컴퓨팅 노드를 포함하는 응답입니다. Headers
|
|
Other Status Codes |
Batch 서비스의 오류입니다. |
보안
azure_auth
OAuth 2.0 인증 코드 흐름 Microsoft Entra
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | 사용자 계정 가장 |
Authorization
Type:
apiKey
In:
header
예제
Node get
Sample Request
GET account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z?api-version=2023-11-01.18.0
Sample Response
{
"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 |
---|---|
Auto |
자동 사용자에 대한 scope |
Auto |
Batch 서비스에서 작업을 실행하는 자동 사용자에 대한 매개 변수를 지정합니다. |
Batch |
Azure Batch 서비스에서 받은 오류 응답입니다. |
Batch |
Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다. |
Certificate |
풀의 컴퓨팅 노드에 설치할 인증서에 대한 참조입니다. |
Certificate |
인증서를 설치할 컴퓨팅 노드의 인증서 저장소 위치입니다. |
Certificate |
컴퓨팅 노드의 사용자 계정이 인증서의 프라이빗 데이터에 액세스할 수 있어야 합니다. |
Compute |
Batch 서비스의 컴퓨팅 노드입니다. |
Compute |
컴퓨팅 노드에 대한 엔드포인트 구성입니다. |
Compute |
컴퓨팅 노드에서 발생한 오류입니다. |
Compute |
컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다. |
Compute |
컴퓨팅 노드의 현재 상태입니다. |
Container |
프라이빗 컨테이너 레지스트리. |
Container |
컨테이너 작업 작업 디렉터리의 위치입니다. |
Elevation |
사용자의 권한 상승 수준입니다. |
Environment |
작업 프로세스에서 설정할 환경 변수입니다. |
Error |
오류의 범주입니다. |
Error |
Azure Batch 오류 응답에서 받은 오류 메시지입니다. |
Image |
Azure Virtual Machines Marketplace 이미지 또는 Azure Compute Gallery 이미지에 대한 참조입니다. Azure Batch 확인된 모든 Azure Marketplace 이미지 참조 목록을 보려면 '지원되는 이미지 나열' 작업을 참조하세요. |
Inbound |
컴퓨팅 노드의 인바운드 엔드포인트입니다. |
Inbound |
엔드포인트의 프로토콜입니다. |
Name |
이름-값 쌍을 나타냅니다. |
Node |
Compute Node 에이전트에 대한 정보입니다. |
Resource |
컴퓨팅 노드에 다운로드할 단일 파일 또는 여러 파일입니다. |
Scheduling |
컴퓨팅 노드를 작업 예약에 사용할 수 있는지 여부입니다. |
Start |
노드가 Azure Batch 서비스에서 풀에 조인하거나 컴퓨팅 노드를 다시 부팅하거나 이미지로 다시 설치할 때 실행되는 작업입니다. |
Start |
컴퓨팅 노드에서 실행되는 StartTask에 대한 정보입니다. |
Start |
컴퓨팅 노드의 StartTask 상태입니다. |
Task |
태스크가 실행 중인 컨테이너에 대한 정보를 포함합니다. |
Task |
작업에 대한 컨테이너 설정입니다. |
Task |
작업 실행에 대한 정보입니다. |
Task |
작업 실행의 결과입니다. |
Task |
작업 실패에 대한 정보입니다. |
Task |
컴퓨팅 노드에서 실행되는 작업에 대한 정보입니다. |
Task |
태스크의 상태입니다. |
User |
작업이 실행되는 사용자 ID의 정의입니다. |
Virtual |
가상 머신의 현재 상태에 대한 정보입니다. |
AutoUserScope
자동 사용자에 대한 scope
Name | 형식 | Description |
---|---|---|
pool |
string |
태스크가 풀의 모든 컴퓨팅 노드에서 만들어지는 공통 자동 사용자 계정으로 실행되도록 지정합니다. |
task |
string |
서비스에서 작업에 대한 새 사용자를 만들어야 한다고 지정합니다. |
AutoUserSpecification
Batch 서비스에서 작업을 실행하는 자동 사용자에 대한 매개 변수를 지정합니다.
Name | 형식 | Description |
---|---|---|
elevationLevel |
자동 사용자의 권한 상승 수준입니다. |
|
scope |
자동 사용자에 대한 scope |
BatchError
Azure Batch 서비스에서 받은 오류 응답입니다.
Name | 형식 | Description |
---|---|---|
code |
string |
오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다. |
message |
사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다. |
|
values |
오류에 대한 추가 세부 정보가 포함된 키-값 쌍의 컬렉션입니다. |
BatchErrorDetail
Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
Name | 형식 | Description |
---|---|---|
key |
string |
Value 속성의 의미를 지정하는 식별자입니다. |
value |
string |
오류 응답에 포함된 추가 정보입니다. |
CertificateReference
풀의 컴퓨팅 노드에 설치할 인증서에 대한 참조입니다.
Name | 형식 | Description |
---|---|---|
storeLocation |
인증서를 설치할 컴퓨팅 노드의 인증서 저장소 위치입니다. |
|
storeName |
string |
인증서를 설치할 컴퓨팅 노드의 인증서 저장소 이름입니다. |
thumbprint |
string |
인증서의 지문입니다. |
thumbprintAlgorithm |
string |
지문이 연결된 알고리즘입니다. sha1이어야 합니다. |
visibility |
컴퓨팅 노드의 사용자 계정이 인증서의 프라이빗 데이터에 액세스할 수 있어야 합니다. |
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 |
컴퓨팅 노드에 설치된 인증서 목록입니다. 경고: 이 속성은 더 이상 사용되지 않으며 2024년 2월 이후에 제거됩니다. 대신 Azure KeyVault 확장을 사용하세요. |
|
endpointConfiguration |
컴퓨팅 노드에 대한 엔드포인트 구성입니다. |
|
errors |
컴퓨팅 노드에서 현재 발생하는 오류 목록입니다. |
|
id |
string |
컴퓨팅 노드의 ID입니다. |
ipAddress |
string |
다른 노드가 이 컴퓨팅 노드와 통신하는 데 사용할 수 있는 IP 주소입니다. |
isDedicated |
boolean |
이 컴퓨팅 노드가 전용 컴퓨팅 노드인지 여부입니다. false이면 컴퓨팅 노드는 스폿/우선 순위가 낮은 컴퓨팅 노드입니다. |
lastBootTime |
string |
컴퓨팅 노드가 마지막으로 시작된 시간입니다. |
nodeAgentInfo |
컴퓨팅 노드 에이전트 버전 및 컴퓨팅 노드가 새 버전으로 업그레이드된 시간에 대한 정보입니다. |
|
recentTasks |
상태가 최근에 변경된 작업 목록입니다. |
|
runningTaskSlotsCount |
integer |
컴퓨팅 노드에서 현재 작업 작업을 실행하는 데 사용되는 총 예약 슬롯 수입니다. 여기에는 작업 관리자 작업 및 일반 작업이 포함되지만 작업 준비, 작업 릴리스 또는 시작 태스크는 포함되지 않습니다. |
runningTasksCount |
integer |
컴퓨팅 노드에서 현재 실행 중인 작업 작업의 총 수입니다. 여기에는 작업 관리자 작업 및 일반 작업이 포함되지만 작업 준비, 작업 릴리스 또는 시작 태스크는 포함되지 않습니다. |
schedulingState |
컴퓨팅 노드를 작업 예약에 사용할 수 있는지 여부입니다. |
|
startTask |
풀에 조인할 때 컴퓨팅 노드에서 실행되도록 지정된 작업입니다. |
|
startTaskInfo |
컴퓨팅 노드에서 StartTask 실행에 대한 런타임 정보입니다. |
|
state |
컴퓨팅 노드의 현재 상태입니다. |
|
stateTransitionTime |
string |
컴퓨팅 노드가 현재 상태를 입력한 시간입니다. |
totalTasksRun |
integer |
컴퓨팅 노드에서 완료된 총 작업 작업 수입니다. 여기에는 작업 관리자 작업 및 일반 작업이 포함되지만 작업 준비, 작업 릴리스 또는 시작 태스크는 포함되지 않습니다. |
totalTasksSucceeded |
integer |
컴퓨팅 노드에서 성공적으로 완료된 총 작업 작업 수(exitCode 0 포함)입니다. 여기에는 작업 관리자 작업 및 일반 작업이 포함되지만 작업 준비, 작업 릴리스 또는 시작 태스크는 포함되지 않습니다. |
url |
string |
컴퓨팅 노드의 URL입니다. |
virtualMachineInfo |
가상 머신의 현재 상태에 대한 정보입니다. |
|
vmSize |
string |
컴퓨팅 노드를 호스트하는 가상 머신의 크기입니다. |
ComputeNodeEndpointConfiguration
컴퓨팅 노드에 대한 엔드포인트 구성입니다.
Name | 형식 | Description |
---|---|---|
inboundEndpoints |
컴퓨팅 노드에서 액세스할 수 있는 인바운드 엔드포인트 목록입니다. |
ComputeNodeError
컴퓨팅 노드에서 발생한 오류입니다.
Name | 형식 | Description |
---|---|---|
code |
string |
컴퓨팅 노드 오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다. |
errorDetails |
컴퓨팅 노드 오류와 관련된 추가 오류 세부 정보 목록입니다. |
|
message |
string |
사용자 인터페이스에 표시하기에 적합한 컴퓨팅 노드 오류를 설명하는 메시지입니다. |
ComputeNodeIdentityReference
컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.
Name | 형식 | Description |
---|---|---|
resourceId |
string |
사용자 할당 ID의 ARM 리소스 ID입니다. |
ComputeNodeState
컴퓨팅 노드의 현재 상태입니다.
Name | 형식 | Description |
---|---|---|
creating |
string |
Batch 서비스는 Azure Compute에서 기본 가상 머신을 얻었지만 아직 풀에 가입하기 시작하지 않았습니다. |
idle |
string |
컴퓨팅 노드가 현재 작업을 실행하고 있지 않습니다. |
leavingpool |
string |
컴퓨팅 노드는 사용자가 명시적으로 풀을 제거했거나 풀의 크기를 조정하거나 자동 크기 조정 중이기 때문에 풀을 종료합니다. |
offline |
string |
컴퓨팅 노드가 현재 태스크를 실행하고 있지 않으며 컴퓨팅 노드에 대한 새 태스크 예약을 사용할 수 없습니다. |
preempted |
string |
우선 순위가 낮은 스폿/낮은 컴퓨팅 노드가 선점되었습니다. 컴퓨팅 노드가 선점되었을 때 실행 중이던 작업은 다른 컴퓨팅 노드를 사용할 수 있게 되면 다시 예약됩니다. |
rebooting |
string |
컴퓨팅 노드가 다시 부팅되고 있습니다. |
reimaging |
string |
컴퓨팅 노드가 다시 이미지화되고 있습니다. |
running |
string |
컴퓨팅 노드에서 하나 이상의 작업(StartTask 이외의)을 실행하고 있습니다. |
starting |
string |
Batch 서비스는 기본 가상 머신에서 시작됩니다. |
starttaskfailed |
string |
컴퓨팅 노드에서 StartTask가 실패하고(모든 재시도가 모두 사용됨) waitForSuccess가 설정됩니다. 컴퓨팅 노드는 작업을 실행하는 데 사용할 수 없습니다. |
unknown |
string |
Batch 서비스가 컴퓨팅 노드와의 접촉을 끊었으며 실제 상태를 알지 못합니다. |
unusable |
string |
오류로 인해 컴퓨팅 노드를 작업 실행에 사용할 수 없습니다. |
waitingforstarttask |
string |
StartTask가 컴퓨팅 노드에서 실행되기 시작했지만 waitForSuccess가 설정되고 StartTask가 아직 완료되지 않았습니다. |
ContainerRegistry
프라이빗 컨테이너 레지스트리.
Name | 형식 | Description |
---|---|---|
identityReference |
사용자 이름 및 암호 대신 Azure Container Registry 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다. |
|
password |
string |
레지스트리 서버에 로그인할 암호입니다. |
registryServer |
string |
레지스트리 URL입니다. |
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 Gallery 이미지에 대한 참조입니다. Azure Batch 확인된 모든 Azure Marketplace 이미지 참조 목록을 보려면 '지원되는 이미지 나열' 작업을 참조하세요.
Name | 형식 | Description |
---|---|---|
exactVersion |
string |
노드를 만드는 데 사용되는 플랫폼 이미지 또는 마켓플레이스 이미지의 특정 버전입니다. 이 읽기 전용 필드는 풀을 만들 때 'version'에 지정된 값이 'latest'인 경우에만 'version'과 다릅니다. |
offer |
string |
Azure Virtual Machines Marketplace 이미지의 제품 유형입니다. |
publisher |
string |
Azure Virtual Machines Marketplace 이미지의 게시자입니다. |
sku |
string |
Azure Virtual Machines Marketplace 이미지의 SKU입니다. |
version |
string |
Azure Virtual Machines Marketplace 이미지의 버전입니다. |
virtualMachineImageId |
string |
Azure Compute Gallery 이미지의 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}은 항상 최신 이미지 버전으로 기본 설정됩니다. |
InboundEndpoint
컴퓨팅 노드의 인바운드 엔드포인트입니다.
Name | 형식 | Description |
---|---|---|
backendPort |
integer |
엔드포인트의 백 엔드 포트 번호입니다. |
frontendPort |
integer |
엔드포인트의 공용 포트 번호입니다. |
name |
string |
엔드포인트의 이름입니다. |
protocol |
엔드포인트의 프로토콜입니다. |
|
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 Node 에이전트의 버전입니다. |
ResourceFile
컴퓨팅 노드에 다운로드할 단일 파일 또는 여러 파일입니다.
Name | 형식 | Description |
---|---|---|
autoStorageContainerName |
string |
자동 스토리지 계정의 스토리지 컨테이너 이름입니다. |
blobPrefix |
string |
Azure Storage 컨테이너에서 Blob을 다운로드할 때 사용할 Blob 접두사입니다. 이름이 지정된 접두사로 시작하는 Blob만 다운로드됩니다. |
fileMode |
string |
8진수 형식의 파일 사용 권한 모드 특성입니다. |
filePath |
string |
작업의 작업 디렉터리를 기준으로 파일을 다운로드할 컴퓨팅 노드의 위치입니다. |
httpUrl |
string |
다운로드할 파일의 URL입니다. |
identityReference |
storageContainerUrl 또는 httpUrl에서 지정한 Azure Blob Storage 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다. |
|
storageContainerUrl |
string |
Azure Blob Storage 내 Blob 컨테이너의 URL입니다. |
SchedulingState
컴퓨팅 노드를 작업 예약에 사용할 수 있는지 여부입니다.
Name | 형식 | Description |
---|---|---|
disabled |
string |
컴퓨팅 노드에는 새 작업이 예약되지 않습니다. 컴퓨팅 노드에서 이미 실행 중인 작업은 완료까지 계속 실행될 수 있습니다. 모든 컴퓨팅 노드는 예약을 사용하도록 설정된 상태로 시작합니다. |
enabled |
string |
작업은 컴퓨팅 노드에서 예약할 수 있습니다. |
StartTask
노드가 Azure Batch 서비스에서 풀에 조인하거나 컴퓨팅 노드를 다시 부팅하거나 이미지로 다시 설치할 때 실행되는 작업입니다.
Name | 형식 | Description |
---|---|---|
commandLine |
string |
StartTask의 명령줄입니다. |
containerSettings |
StartTask가 실행되는 컨테이너에 대한 설정입니다. |
|
environmentSettings |
StartTask에 대한 환경 변수 설정 목록입니다. |
|
maxTaskRetryCount |
integer |
작업을 재시도할 수 있는 최대 횟수입니다. |
resourceFiles |
명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드가 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다. |
|
userIdentity |
StartTask가 실행되는 사용자 ID입니다. |
|
waitForSuccess |
boolean |
컴퓨팅 노드에서 작업을 예약하기 전에 Batch 서비스가 StartTask가 성공적으로 완료될 때까지 기다려야 하는지 여부(즉, 종료 코드 0으로 종료). |
StartTaskInformation
컴퓨팅 노드에서 실행되는 StartTask에 대한 정보입니다.
Name | 형식 | Description |
---|---|---|
containerInfo |
태스크가 실행 중인 컨테이너에 대한 정보입니다. |
|
endTime |
string |
StartTask가 실행을 중지한 시간입니다. |
exitCode |
integer |
StartTask 명령줄에 지정된 프로그램의 종료 코드입니다. |
failureInfo |
작업 실패(있는 경우)를 설명하는 정보입니다. |
|
lastRetryTime |
string |
작업의 재시도가 실행되기 시작한 가장 최근 시간입니다. |
result |
작업 실행의 결과입니다. |
|
retryCount |
integer |
Batch 서비스에서 작업을 다시 시도한 횟수입니다. |
startTime |
string |
StartTask가 실행되기 시작한 시간입니다. |
state |
컴퓨팅 노드의 StartTask 상태입니다. |
StartTaskState
컴퓨팅 노드의 StartTask 상태입니다.
Name | 형식 | Description |
---|---|---|
completed |
string |
StartTask가 종료 코드 0으로 종료되었거나 StartTask가 실패하고 다시 시도 제한에 도달했거나 작업 준비 오류(예: 리소스 파일 다운로드 실패)로 인해 StartTask 프로세스가 실행되지 않았습니다. |
running |
string |
StartTask가 현재 실행 중입니다. |
TaskContainerExecutionInformation
태스크가 실행 중인 컨테이너에 대한 정보를 포함합니다.
Name | 형식 | Description |
---|---|---|
containerId |
string |
컨테이너의 ID입니다. |
error |
string |
컨테이너에 대한 자세한 오류 정보입니다. |
state |
string |
컨테이너의 상태입니다. |
TaskContainerSettings
작업에 대한 컨테이너 설정입니다.
Name | 형식 | Description |
---|---|---|
containerRunOptions |
string |
컨테이너 만들기 명령에 대한 추가 옵션입니다. |
imageName |
string |
태스크가 실행될 컨테이너를 만드는 데 사용할 이미지입니다. |
registry |
컨테이너 이미지를 포함하는 프라이빗 레지스트리입니다. |
|
workingDirectory |
컨테이너 작업 디렉터리의 위치입니다. |
TaskExecutionInformation
작업 실행에 대한 정보입니다.
Name | 형식 | Description |
---|---|---|
containerInfo |
태스크가 실행 중인 컨테이너에 대한 정보입니다. |
|
endTime |
string |
태스크가 완료된 시간입니다. |
exitCode |
integer |
작업 명령줄에 지정된 프로그램의 종료 코드입니다. |
failureInfo |
작업 실패(있는 경우)를 설명하는 정보입니다. |
|
lastRequeueTime |
string |
사용자 요청의 결과로 Batch 서비스에서 태스크를 다시 큐에 추가한 가장 최근 시간입니다. |
lastRetryTime |
string |
작업의 재시도가 실행되기 시작한 가장 최근 시간입니다. |
requeueCount |
integer |
사용자 요청의 결과로 Batch 서비스에서 작업을 다시 큐에 추가한 횟수입니다. |
result |
작업 실행의 결과입니다. |
|
retryCount |
integer |
Batch 서비스에서 작업을 다시 시도한 횟수입니다. |
startTime |
string |
태스크가 실행되기 시작한 시간입니다. |
TaskExecutionResult
작업 실행의 결과입니다.
Name | 형식 | Description |
---|---|---|
failure |
string |
작업을 처리하는 동안 오류가 발생했습니다. 태스크 프로세스가 실행 중이거나 작업 프로세스가 종료된 후 작업 프로세스가 시작되기 전에 오류가 발생했을 수 있습니다. |
success |
string |
작업이 성공적으로 실행되었습니다. |
TaskFailureInformation
작업 실패에 대한 정보입니다.
Name | 형식 | Description |
---|---|---|
category |
작업 오류의 범주입니다. |
|
code |
string |
작업 오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다. |
details |
오류와 관련된 추가 세부 정보 목록입니다. |
|
message |
string |
사용자 인터페이스에 표시하기에 적합한 작업 오류를 설명하는 메시지입니다. |
TaskInformation
컴퓨팅 노드에서 실행되는 작업에 대한 정보입니다.
Name | 형식 | Description |
---|---|---|
executionInfo |
작업 실행에 대한 정보입니다. |
|
jobId |
string |
작업이 속한 작업의 ID입니다. |
subtaskId |
integer |
작업이 다중 instance 작업인 경우 하위 작업의 ID입니다. |
taskId |
string |
작업의 ID입니다. |
taskState |
작업의 현재 상태입니다. |
|
taskUrl |
string |
작업의 URL입니다. |
TaskState
태스크의 상태입니다.
Name | 형식 | Description |
---|---|---|
active |
string |
작업이 큐에 대기 중이며 실행할 수 있지만 현재 컴퓨팅 노드에 할당되지 않았습니다. 작업이 만들어지면, 사용하지 않도록 설정한 후 사용하도록 설정되거나, 실행 실패 후 재시도를 기다리는 경우 이 상태로 들어갑니다. |
completed |
string |
태스크가 성공적으로 완료되었거나 태스크가 실패하고 재시도 한도를 소진했기 때문에 태스크를 더 이상 실행할 수 없습니다. 태스크를 시작하는 동안 오류가 발생했거나 태스크가 종료된 경우에도 작업이 완료된 것으로 표시됩니다. |
preparing |
string |
태스크가 컴퓨팅 노드에 할당되었지만 컴퓨팅 노드에서 필요한 작업 준비 태스크가 완료되길 기다리고 있습니다. 작업 준비 태스크가 성공하면 태스크가 실행 중으로 이동합니다. 작업 준비 태스크가 실패하면 작업이 활성 상태로 돌아가고 다른 컴퓨팅 노드에 할당될 수 있습니다. |
running |
string |
태스크가 컴퓨팅 노드에서 실행 중입니다. 여기에는 리소스 파일 다운로드 또는 태스크에 지정된 패키지 배포와 같은 작업 수준 준비가 포함됩니다. 반드시 작업 명령줄이 실행되기 시작했다는 의미는 아닙니다. |
UserIdentity
작업이 실행되는 사용자 ID의 정의입니다.
Name | 형식 | Description |
---|---|---|
autoUser |
작업이 실행되는 자동 사용자입니다. |
|
username |
string |
작업이 실행되는 사용자 ID의 이름입니다. |
VirtualMachineInfo
가상 머신의 현재 상태에 대한 정보입니다.
Name | 형식 | Description |
---|---|---|
imageReference |
Azure Virtual Machine의 Marketplace 이미지에 대한 참조입니다. |
|
scaleSetVmResourceId |
string |
컴퓨팅 노드의 현재 Virtual Machine Scale Set VM의 리소스 ID입니다. PoolAllocationMode 속성이 'UserSubscription'으로 설정된 Batch 계정을 만든 경우에만 정의됩니다. |