Pools - Enable Pool Auto Scale

서비스:: Batch Service

API 버전:: 2025-06-01

풀에 대해 자동 크기 조정을 사용하도록 설정합니다.
풀에서 크기 조정 작업이 진행 중인 경우 풀에서 자동 크기 조정을 사용하도록 설정할 수 없습니다. 풀의 자동 크기 조정이 현재 비활성화된 경우 요청의 일부로 유효한 자동 크기 조정 수식을 지정해야 합니다. 풀의 자동 크기 조정을 이미 사용하도록 설정한 경우 새 자동 크기 조정 수식 및/또는 새 평가 간격을 지정할 수 있습니다. 동일한 풀에 대해 30초마다 두 번 이상 이 API를 호출할 수 없습니다.

POST {endpoint}/pools/{poolId}/enableautoscale?api-version=2025-06-01

선택적 매개 변수:

POST {endpoint}/pools/{poolId}/enableautoscale?api-version=2025-06-01&timeOut={timeOut}

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 버전입니다.
timeOut	query		integer (int32)	서버에서 요청을 처리하는 데 소요할 수 있는 최대 시간(초)입니다. 기본값은 30초입니다. 만약 값이 30보다 크면 기본값이 대신 사용됩니다."라고 말했습니다.

요청 헤더

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

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를 직접 호출하는 경우 명시적으로 설정합니다.
If-Modified-Since	string (date-time-rfc7231)	클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정된 경우에만 작업이 수행됩니다.
If-Unmodified-Since	string (date-time-rfc7231)	클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정되지 않은 경우에만 작업이 수행됩니다.
If-Match	string	클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에 대한 리소스의 현재 ETag가 클라이언트에서 지정한 값과 정확히 일치하는 경우에만 수행됩니다.
If-None-Match	string	클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에서 리소스의 현재 ETag가 클라이언트에서 지정한 값과 일치하지 않는 경우에만 수행됩니다.

요청 본문

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

Name	형식	Description
autoScaleEvaluationInterval	string (duration)	자동 크기 조정 수식에 따라 풀 크기를 자동으로 조정할 시간 간격입니다. 기본값은 15분입니다. 최소값과 최대값은 각각 5분 및 168시간입니다. 5분 미만 또는 168시간보다 큰 값을 지정하는 경우 Batch 서비스는 잘못된 속성 값 오류로 요청을 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다. 새로운 간격을 지정하면 기존 자동 스케일 평가 일정이 중단되고 새 자동 스케일 평가 일정이 시작되며, 이 요청이 발행된 시점이 시작 시간이 됩니다.
autoScaleFormula	string	풀에서 원하는 수의 컴퓨팅 노드 수에 대한 수식입니다. 기본값은 15분입니다. 최소값과 최대값은 각각 5분 및 168시간입니다. 5분 미만 또는 168시간보다 큰 값을 지정하는 경우 Batch 서비스는 잘못된 속성 값 오류로 요청을 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다. 새로운 간격을 지정하면 기존 자동 스케일 평가 일정이 중단되고 새 자동 스케일 평가 일정이 시작되며, 이 요청이 발행된 시점이 시작 시간이 됩니다.

응답

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

Name

형식

Description

200 OK

요청이 성공했습니다.

헤더

DataServiceId: string
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

예제

Pool enable autoscale

샘플 요청

HTTP

POST {endpoint}/pools/poolId/enableautoscale?api-version=2025-06-01



{
  "autoScaleFormula": "$TargetDedicated=0",
  "autoScaleEvaluationInterval": "PT8M"
}

샘플 응답

상태 코드:: 200

정의

Name	Description
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
BatchErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
BatchPoolEnableAutoScaleOptions	Azure Batch 풀에서 자동 크기 조정을 사용하도록 설정하기 위한 매개 변수입니다.

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

BatchPoolEnableAutoScaleOptions

Object

Azure Batch 풀에서 자동 크기 조정을 사용하도록 설정하기 위한 매개 변수입니다.

Name	형식	Description
autoScaleEvaluationInterval	string (duration)	자동 크기 조정 수식에 따라 풀 크기를 자동으로 조정할 시간 간격입니다. 기본값은 15분입니다. 최소값과 최대값은 각각 5분 및 168시간입니다. 5분 미만 또는 168시간보다 큰 값을 지정하는 경우 Batch 서비스는 잘못된 속성 값 오류로 요청을 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다. 새로운 간격을 지정하면 기존 자동 스케일 평가 일정이 중단되고 새 자동 스케일 평가 일정이 시작되며, 이 요청이 발행된 시점이 시작 시간이 됩니다.
autoScaleFormula	string	풀에서 원하는 수의 컴퓨팅 노드 수에 대한 수식입니다. 기본값은 15분입니다. 최소값과 최대값은 각각 5분 및 168시간입니다. 5분 미만 또는 168시간보다 큰 값을 지정하는 경우 Batch 서비스는 잘못된 속성 값 오류로 요청을 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다. 새로운 간격을 지정하면 기존 자동 스케일 평가 일정이 중단되고 새 자동 스케일 평가 일정이 시작되며, 이 요청이 발행된 시점이 시작 시간이 됩니다.

다음을 통해 공유

Pools - Enable Pool Auto Scale

URI 매개 변수

요청 헤더

요청 본문

응답

보안

OAuth2Auth

범위

예제

Pool enable autoscale

샘플 요청

샘플 응답

정의

BatchError

BatchErrorDetail

BatchErrorMessage

BatchPoolEnableAutoScaleOptions