你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Pool - Evaluate Auto Scale
获取在池上评估自动缩放公式的结果。
此 API 主要用于验证自动缩放公式,因为它只是返回结果而不将公式应用于池。 池必须启用自动缩放才能评估公式。
POST {batchUrl}/pools/{poolId}/evaluateautoscale?api-version=2024-07-01.20.0
POST {batchUrl}/pools/{poolId}/evaluateautoscale?timeout={timeout}&api-version=2024-07-01.20.0
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
batch
|
path | True |
string |
所有 Azure Batch 服务请求的基本 URL。 |
pool
|
path | True |
string |
要对其计算自动缩放公式的池的 ID。 |
api-version
|
query | True |
string |
客户端 API 版本。 |
timeout
|
query |
integer int32 |
服务器处理请求的最长时间(以秒为单位)。 默认值为 30 秒。 如果该值大于 30,则改用默认值。 |
请求头
Media Types: "application/json; odata=minimalmetadata"
名称 | 必需 | 类型 | 说明 |
---|---|---|---|
client-request-id |
string uuid |
调用方生成的请求标识,采用不带大括号的 GUID 形式,例如 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0。 |
|
return-client-request-id |
boolean |
服务器是否应在响应中返回 client-request-id。 |
|
ocp-date |
string date-time-rfc1123 |
发出请求的时间。 客户端库通常将此设置为当前的系统时钟时间;如果直接调用 REST API,请显式设置它。 |
请求正文
Media Types: "application/json; odata=minimalmetadata"
名称 | 必需 | 类型 | 说明 |
---|---|---|---|
autoScaleFormula | True |
string |
池中所需计算节点数的公式。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
包含自动缩放评估结果的响应。 标头
|
|
Other Status Codes |
Batch 服务中的错误。 |
安全性
azure_auth
Microsoft Entra OAuth 2.0 身份验证代码流
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
Authorization
类型:
apiKey
在:
header
示例
Pool evaluate autoscale
示例请求
POST account.region.batch.azure.com/pools/poolId/evaluateautoscale?api-version=2024-07-01.20.0
{
"autoScaleFormula": "$TargetDedicated=1"
}
示例响应
{
"timestamp": "2016-11-22T19:39:28.5246331Z",
"results": "$TargetDedicated=1;$NodeDeallocationOption=requeue"
}
定义
名称 | 说明 |
---|---|
Auto |
池自动缩放公式执行的结果和错误。 |
Auto |
执行或评估池自动缩放公式时发生的错误。 |
Batch |
从 Azure Batch 服务收到的错误响应。 |
Batch |
Azure Batch 错误响应中包含的附加信息项。 |
Error |
Azure Batch 错误响应中收到的错误消息。 |
Name |
表示名称/值对。 |
Pool |
用于评估池上的自动缩放公式的选项。 |
AutoScaleRun
池自动缩放公式执行的结果和错误。
名称 | 类型 | 说明 |
---|---|---|
error |
如果评估失败,在池中评估自动缩放公式时遇到错误的详细信息。 |
|
results |
string |
自动缩放公式计算中使用的所有变量的最终值。 |
timestamp |
string |
上次计算自动缩放公式的时间。 |
AutoScaleRunError
执行或评估池自动缩放公式时发生的错误。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
自动缩放错误的标识符。 代码是固定的,旨在以编程方式使用。 |
message |
string |
描述自动缩放错误的消息,旨在适合在用户界面中显示。 |
values |
与自动缩放错误相关的其他错误详细信息的列表。 |
BatchError
从 Azure Batch 服务收到的错误响应。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误的标识符。 代码是固定的,旨在以编程方式使用。 |
message |
描述错误的消息,旨在适合在用户界面中显示。 |
|
values |
包含有关错误的更多详细信息的键值对的集合。 |
BatchErrorDetail
Azure Batch 错误响应中包含的附加信息项。
名称 | 类型 | 说明 |
---|---|---|
key |
string |
指定 Value 属性含义的标识符。 |
value |
string |
错误响应附带的其他信息。 |
ErrorMessage
Azure Batch 错误响应中收到的错误消息。
名称 | 类型 | 说明 |
---|---|---|
lang |
string |
错误消息的语言代码 |
value |
string |
消息的文本。 |
NameValuePair
表示名称/值对。
名称 | 类型 | 说明 |
---|---|---|
name |
string |
名称值对中的名称。 |
value |
string |
名称值对中的值。 |
PoolEvaluateAutoScaleParameter
用于评估池上的自动缩放公式的选项。
名称 | 类型 | 说明 |
---|---|---|
autoScaleFormula |
string |
池中所需计算节点数的公式。 |