Pool - Enable Auto Scale
풀에 대해 자동 크기 조정을 사용하도록 설정합니다.
풀에서 크기 조정 작업이 진행 중인 경우 풀에서 자동 크기 조정을 사용하도록 설정할 수 없습니다. 풀의 자동 크기 조정을 현재 사용하지 않도록 설정한 경우 요청의 일부로 유효한 자동 크기 조정 수식을 지정해야 합니다. 풀의 자동 크기 조정을 이미 사용하도록 설정한 경우 새 자동 크기 조정 수식 및/또는 새 평가 간격을 지정할 수 있습니다. 30초마다 두 번 이상 동일한 풀에 대해 이 API를 호출할 수 없습니다.
POST {batchUrl}/pools/{poolId}/enableautoscale?api-version=2023-11-01.18.0POST {batchUrl}/pools/{poolId}/enableautoscale?timeout={timeout}&api-version=2023-11-01.18.0URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
batch
|
path | True |
string |
모든 Azure Batch 서비스 요청에 대한 기본 URL입니다. |
|
pool
|
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를 직접 호출하는 경우 명시적으로 설정합니다. |
|
| If-Match |
string |
클라이언트에 알려진 리소스 버전과 연결된 ETag 값입니다. 이 작업은 서비스에서 리소스의 현재 ETag가 클라이언트에서 지정한 값과 정확히 일치하는 경우에만 수행됩니다. |
|
| If-None-Match |
string |
클라이언트에 알려진 리소스 버전과 연결된 ETag 값입니다. 이 작업은 서비스에서 리소스의 현재 ETag가 클라이언트에서 지정한 값과 일치하지 않는 경우에만 수행됩니다. |
|
| If-Modified-Since |
string date-time-rfc1123 |
클라이언트에 알려진 리소스의 마지막 수정 시간을 나타내는 타임스탬프입니다. 작업은 지정된 시간 이후 서비스의 리소스가 수정된 경우에만 수행됩니다. |
|
| If-Unmodified-Since |
string date-time-rfc1123 |
클라이언트에 알려진 리소스의 마지막 수정 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정되지 않은 경우에만 작업이 수행됩니다. |
요청 본문
Media Types: "application/json; odata=minimalmetadata"
| Name | 형식 | Description |
|---|---|---|
| autoScaleEvaluationInterval |
string |
자동 크기 조정 수식에 따라 풀 크기를 자동으로 조정할 시간 간격입니다. |
| autoScaleFormula |
string |
풀에서 원하는 수의 컴퓨팅 노드 수에 대한 수식입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
Batch 서비스에 대한 요청이 성공했습니다. 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
예제
Pool enable autoscale
Sample Request
POST account.region.batch.azure.com/pools/poolId/enableautoscale?api-version=2023-11-01.18.0
{
"autoScaleFormula": "$TargetDedicated=0",
"autoScaleEvaluationInterval": "PT8M"
}
Sample Response
정의
| Name | Description |
|---|---|
|
Batch |
Azure Batch 서비스에서 받은 오류 응답입니다. |
|
Batch |
Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다. |
|
Error |
Azure Batch 오류 응답에서 받은 오류 메시지입니다. |
|
Pool |
풀에서 자동 크기 조정을 사용하도록 설정하는 옵션입니다. |
BatchError
Azure Batch 서비스에서 받은 오류 응답입니다.
| Name | 형식 | Description |
|---|---|---|
| code |
string |
오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다. |
| message |
사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다. |
|
| values |
오류에 대한 추가 세부 정보가 포함된 키-값 쌍의 컬렉션입니다. |
BatchErrorDetail
Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
| Name | 형식 | Description |
|---|---|---|
| key |
string |
Value 속성의 의미를 지정하는 식별자입니다. |
| value |
string |
오류 응답에 포함된 추가 정보입니다. |
ErrorMessage
Azure Batch 오류 응답에서 받은 오류 메시지입니다.
| Name | 형식 | Description |
|---|---|---|
| lang |
string |
오류 메시지의 언어 코드 |
| value |
string |
메시지의 텍스트입니다. |
PoolEnableAutoScaleParameter
풀에서 자동 크기 조정을 사용하도록 설정하는 옵션입니다.
| Name | 형식 | Description |
|---|---|---|
| autoScaleEvaluationInterval |
string |
자동 크기 조정 수식에 따라 풀 크기를 자동으로 조정할 시간 간격입니다. |
| autoScaleFormula |
string |
풀에서 원하는 수의 컴퓨팅 노드 수에 대한 수식입니다. |