다음을 통해 공유


Pool - Evaluate Auto Scale

풀에서 자동 크기 조정 수식을 평가한 결과를 가져옵니다.
이 API는 풀에 수식을 적용하지 않고 결과를 반환하기 때문에 주로 자동 크기 조정 수식의 유효성을 검사하기 위한 것입니다. 수식을 평가하려면 풀에 자동 크기 조정을 사용하도록 설정해야 합니다.

POST {batchUrl}/pools/{poolId}/evaluateautoscale?api-version=2023-11-01.18.0
POST {batchUrl}/pools/{poolId}/evaluateautoscale?timeout={timeout}&api-version=2023-11-01.18.0

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
batchUrl
path True

string

모든 Azure Batch 서비스 요청에 대한 기본 URL입니다.

poolId
path True

string

자동 크기 조정 수식을 평가할 풀의 ID입니다.

api-version
query True

string

클라이언트 API 버전.

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를 직접 호출하는 경우 명시적으로 설정합니다.

요청 본문

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

Name 필수 형식 Description
autoScaleFormula True

string

풀에서 원하는 수의 컴퓨팅 노드 수에 대한 수식입니다.
수식의 유효성이 검사되고 결과가 계산되지만 풀에는 적용되지 않습니다. 풀에 수식을 적용하려면 '풀에서 자동 크기 조정 사용'을 선택합니다. 이 수식을 지정하는 방법에 대한 자세한 내용은 Azure Batch 풀()에서 자동으로 컴퓨팅 노드 크기 조정을https://azure.microsoft.com/en-us/documentation/articles/batch-automatic-scaling 참조하세요.

응답

Name 형식 Description
200 OK

AutoScaleRun

자동 크기 조정 평가 결과를 포함하는 응답입니다.

헤더

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

BatchError

Batch 서비스의 오류입니다.

보안

azure_auth

OAuth 2.0 인증 코드 흐름 Microsoft Entra

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

범위

Name Description
user_impersonation 사용자 계정 가장

Authorization

형식: apiKey
In(다음 안에): header

예제

Pool evaluate autoscale

샘플 요청

POST account.region.batch.azure.com/pools/poolId/evaluateautoscale?api-version=2023-11-01.18.0



{
  "autoScaleFormula": "$TargetDedicated=1"
}

샘플 응답

{
  "timestamp": "2016-11-22T19:39:28.5246331Z",
  "results": "$TargetDedicated=1;$NodeDeallocationOption=requeue"
}

정의

Name Description
AutoScaleRun

풀 자동 크기 조정 수식 실행의 결과 및 오류입니다.

AutoScaleRunError

풀 자동 크기 조정 수식을 실행하거나 평가할 때 발생한 오류입니다.

BatchError

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

BatchErrorDetail

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

ErrorMessage

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

NameValuePair

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

PoolEvaluateAutoScaleParameter

풀에서 자동 크기 조정 수식을 평가하는 옵션입니다.

AutoScaleRun

풀 자동 크기 조정 수식 실행의 결과 및 오류입니다.

Name 형식 Description
error

AutoScaleRunError

평가에 실패한 경우 풀에서 자동 크기 조정 수식을 평가하는 동안 발생한 오류에 대한 세부 정보입니다.

results

string

자동 크기 조정 수식의 계산에 사용되는 모든 변수의 최종 값입니다.
각 변수 값은 $variable=value 형식으로 반환되고 변수는 세미콜론으로 구분됩니다.

timestamp

string

자동 크기 조정 수식이 마지막으로 평가된 시간입니다.

AutoScaleRunError

풀 자동 크기 조정 수식을 실행하거나 평가할 때 발생한 오류입니다.

Name 형식 Description
code

string

자동 크기 조정 오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다.

message

string

사용자 인터페이스에 표시하기에 적합한 자동 크기 조정 오류를 설명하는 메시지입니다.

values

NameValuePair[]

자동 크기 조정 오류와 관련된 추가 오류 세부 정보 목록입니다.

BatchError

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

Name 형식 Description
code

string

오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다.

message

ErrorMessage

사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.

values

BatchErrorDetail[]

오류에 대한 추가 세부 정보가 포함된 키-값 쌍의 컬렉션입니다.

BatchErrorDetail

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

Name 형식 Description
key

string

Value 속성의 의미를 지정하는 식별자입니다.

value

string

오류 응답에 포함된 추가 정보입니다.

ErrorMessage

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

Name 형식 Description
lang

string

오류 메시지의 언어 코드

value

string

메시지의 텍스트입니다.

NameValuePair

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

Name 형식 Description
name

string

이름-값 쌍의 이름입니다.

value

string

이름-값 쌍의 값입니다.

PoolEvaluateAutoScaleParameter

풀에서 자동 크기 조정 수식을 평가하는 옵션입니다.

Name 형식 Description
autoScaleFormula

string

풀에서 원하는 수의 컴퓨팅 노드 수에 대한 수식입니다.
수식의 유효성이 검사되고 결과가 계산되지만 풀에는 적용되지 않습니다. 풀에 수식을 적용하려면 '풀에서 자동 크기 조정 사용'을 선택합니다. 이 수식을 지정하는 방법에 대한 자세한 내용은 Azure Batch 풀()에서 자동으로 컴퓨팅 노드 크기 조정을https://azure.microsoft.com/en-us/documentation/articles/batch-automatic-scaling 참조하세요.