你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Pool interface
包含有关池的信息。
- 扩展
属性
allocation |
池是否正在调整大小。 注意:此属性不会被序列化。 它只能由服务器填充。 |
allocation |
池进入其当前分配状态的时间。 注意:此属性不会被序列化。 它只能由服务器填充。 |
application |
应用程序许可证列表必须是可用 Batch 服务应用程序许可证的子集。 如果请求的许可证不受支持,则池创建将失败。 |
application |
对应用程序包引用的更改会影响加入池的所有新计算节点,但在重新启动或重置映像之前,不会影响池中已有的计算节点。 任何给定池上最多有 10 个应用程序包引用。 |
auto |
仅当池自动缩放(即使用 autoScaleSettings)时,才会设置此属性。 注意:此属性不会被序列化。 它只能由服务器填充。 |
certificates | 对于 Windows 计算节点,Batch 服务会将证书安装到指定的证书存储和位置。 对于 Linux 计算节点,证书存储在任务工作目录内的目录中,并向任务提供环境变量AZ_BATCH_CERTIFICATES_DIR以查询此位置。 对于具有“remoteUser”可见性的证书,在用户的主目录中创建一个“certs”目录, (例如 /home/{user-name}/certs) ,证书将放置在该目录中。 警告:此属性已弃用,将在 2024 年 2 月之后删除。 请改用 Azure KeyVault 扩展 。 |
creation |
池的创建时间。 注意:此属性不会被序列化。 它只能由服务器填充。 |
current |
池中当前专用计算节点的数量。 注意:此属性不会被序列化。 它只能由服务器填充。 |
current |
池中当前存在的现成/低优先级计算节点数。 注意:此属性不会被序列化。 它只能由服务器填充。 |
current |
确定池如何与 Batch 服务通信。 注意:此属性不会被序列化。 它只能由服务器填充。 |
deployment |
使用 CloudServiceConfiguration 指定应使用 Azure 云服务 (PaaS) 创建节点,而 VirtualMachineConfiguration 使用 Azure 虚拟机 (IaaS) 。 |
display |
显示名称不一定是唯一的,可以包含最大长度为 1024 的任何 Unicode 字符。 |
identity | 用于 Batch 池的标识类型。 |
inter |
这会对可分配给池的节点施加限制。 启用此值可以减少请求的节点数在池中分配的机会。 如果未指定,此值默认为“Disabled”。 |
last |
这是池级别数据(例如 targetDedicatedNodes 或 autoScaleSettings)的最后一次更改。 它不考虑节点级更改,例如计算节点更改状态。 注意:此属性不会被序列化。 它只能由服务器填充。 |
metadata | Batch 服务不赋予元数据任何含义;它仅用于使用用户代码。 |
mount |
这支持 Azure 文件存储、NFS、CIFS/SMB 和 Blobfuse。 |
network |
池的网络配置。 |
provisioning |
池的当前状态。 注意:此属性不会被序列化。 它只能由服务器填充。 |
provisioning |
池进入其当前状态的时间。 注意:此属性不会被序列化。 它只能由服务器填充。 |
resize |
描述当前操作 (是否池 AllocationState 正在调整大小) ,或者如果 AllocationState 为“稳定) ”,则描述以前完成的操作 (。 注意:此属性不会被序列化。 它只能由服务器填充。 |
resource |
要与Azure Batch池关联的用户定义的标记。 指定后,这些标记将传播到与池关联的后备 Azure 资源。 只有在将 poolAllocationMode 属性设置为“UserSubscription”的情况下创建 Batch 帐户时,才能指定此属性。 |
scale |
定义所需的池大小。 这可以是“fixedScale”,其中指定了请求的 targetDedicatedNodes,也可以是定义定期重新计算的公式的“autoScale”。 如果未指定此属性,池将具有 0 targetDedicatedNodes 的固定规模。 |
start |
在 PATCH (更新) 操作中,可以将此属性设置为空对象,以从池中删除启动任务。 |
target |
如果省略,默认值为 Default。 |
task |
如果未指定,则默认值为 spread。 |
task |
默认值为 1。 最大值是池 vmSize 核心数的 4 倍或 256 的较小值。 |
upgrade |
描述升级策略 - 自动、手动或滚动。 |
user |
将在池中的每个节点上创建的用户帐户列表。 |
vm |
有关使用 cloudServiceConfiguration) 创建的云服务池 (池的可用虚拟机大小的信息,请参阅云服务 (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/) 的大小。 Batch 支持除 ExtraSmall 以外的所有云服务 VM 大小。 有关使用 virtualMachineConfiguration) 创建的虚拟机市场 (池的映像的池的可用 VM 大小的信息,请参阅 虚拟机 (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) 或 虚拟机 (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/) 的大小。 Batch 支持除STANDARD_A0和具有高级存储 (STANDARD_GS、STANDARD_DS和STANDARD_DSV2系列) 以外的所有 Azure VM 大小。 |
继承属性
etag | 资源的 ETag,用于并发语句。 注意:此属性不会被序列化。 它只能由服务器填充。 |
id | 资源的 ID。 注意:此属性不会被序列化。 它只能由服务器填充。 |
name | 资源的名称。 注意:此属性不会被序列化。 它只能由服务器填充。 |
type | 资源类型。 注意:此属性不会被序列化。 它只能由服务器填充。 |
属性详细信息
allocationState
allocationStateTransitionTime
池进入其当前分配状态的时间。 注意:此属性不会被序列化。 它只能由服务器填充。
allocationStateTransitionTime?: Date
属性值
Date
applicationLicenses
应用程序许可证列表必须是可用 Batch 服务应用程序许可证的子集。 如果请求的许可证不受支持,则池创建将失败。
applicationLicenses?: string[]
属性值
string[]
applicationPackages
对应用程序包引用的更改会影响加入池的所有新计算节点,但在重新启动或重置映像之前,不会影响池中已有的计算节点。 任何给定池上最多有 10 个应用程序包引用。
applicationPackages?: ApplicationPackageReference[]
属性值
autoScaleRun
仅当池自动缩放(即使用 autoScaleSettings)时,才会设置此属性。 注意:此属性不会被序列化。 它只能由服务器填充。
autoScaleRun?: AutoScaleRun
属性值
certificates
对于 Windows 计算节点,Batch 服务会将证书安装到指定的证书存储和位置。 对于 Linux 计算节点,证书存储在任务工作目录内的目录中,并向任务提供环境变量AZ_BATCH_CERTIFICATES_DIR以查询此位置。 对于具有“remoteUser”可见性的证书,在用户的主目录中创建一个“certs”目录, (例如 /home/{user-name}/certs) ,证书将放置在该目录中。
警告:此属性已弃用,将在 2024 年 2 月之后删除。 请改用 Azure KeyVault 扩展 。
certificates?: CertificateReference[]
属性值
creationTime
池的创建时间。 注意:此属性不会被序列化。 它只能由服务器填充。
creationTime?: Date
属性值
Date
currentDedicatedNodes
池中当前专用计算节点的数量。 注意:此属性不会被序列化。 它只能由服务器填充。
currentDedicatedNodes?: number
属性值
number
currentLowPriorityNodes
池中当前存在的现成/低优先级计算节点数。 注意:此属性不会被序列化。 它只能由服务器填充。
currentLowPriorityNodes?: number
属性值
number
currentNodeCommunicationMode
确定池如何与 Batch 服务通信。 注意:此属性不会被序列化。 它只能由服务器填充。
currentNodeCommunicationMode?: NodeCommunicationMode
属性值
deploymentConfiguration
使用 CloudServiceConfiguration 指定应使用 Azure 云服务 (PaaS) 创建节点,而 VirtualMachineConfiguration 使用 Azure 虚拟机 (IaaS) 。
deploymentConfiguration?: DeploymentConfiguration
属性值
displayName
显示名称不一定是唯一的,可以包含最大长度为 1024 的任何 Unicode 字符。
displayName?: string
属性值
string
identity
interNodeCommunication
这会对可分配给池的节点施加限制。 启用此值可以减少请求的节点数在池中分配的机会。 如果未指定,此值默认为“Disabled”。
interNodeCommunication?: InterNodeCommunicationState
属性值
lastModified
这是池级别数据(例如 targetDedicatedNodes 或 autoScaleSettings)的最后一次更改。 它不考虑节点级更改,例如计算节点更改状态。 注意:此属性不会被序列化。 它只能由服务器填充。
lastModified?: Date
属性值
Date
metadata
mountConfiguration
这支持 Azure 文件存储、NFS、CIFS/SMB 和 Blobfuse。
mountConfiguration?: MountConfiguration[]
属性值
networkConfiguration
provisioningState
池的当前状态。 注意:此属性不会被序列化。 它只能由服务器填充。
provisioningState?: PoolProvisioningState
属性值
provisioningStateTransitionTime
池进入其当前状态的时间。 注意:此属性不会被序列化。 它只能由服务器填充。
provisioningStateTransitionTime?: Date
属性值
Date
resizeOperationStatus
描述当前操作 (是否池 AllocationState 正在调整大小) ,或者如果 AllocationState 为“稳定) ”,则描述以前完成的操作 (。 注意:此属性不会被序列化。 它只能由服务器填充。
resizeOperationStatus?: ResizeOperationStatus
属性值
resourceTags
要与Azure Batch池关联的用户定义的标记。 指定后,这些标记将传播到与池关联的后备 Azure 资源。 只有在将 poolAllocationMode 属性设置为“UserSubscription”的情况下创建 Batch 帐户时,才能指定此属性。
resourceTags?: {[propertyName: string]: string}
属性值
{[propertyName: string]: string}
scaleSettings
定义所需的池大小。 这可以是“fixedScale”,其中指定了请求的 targetDedicatedNodes,也可以是定义定期重新计算的公式的“autoScale”。 如果未指定此属性,池将具有 0 targetDedicatedNodes 的固定规模。
scaleSettings?: ScaleSettings
属性值
startTask
targetNodeCommunicationMode
taskSchedulingPolicy
taskSlotsPerNode
默认值为 1。 最大值是池 vmSize 核心数的 4 倍或 256 的较小值。
taskSlotsPerNode?: number
属性值
number
upgradePolicy
userAccounts
vmSize
有关使用 cloudServiceConfiguration) 创建的云服务池 (池的可用虚拟机大小的信息,请参阅云服务 (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/) 的大小。 Batch 支持除 ExtraSmall 以外的所有云服务 VM 大小。 有关使用 virtualMachineConfiguration) 创建的虚拟机市场 (池的映像的池的可用 VM 大小的信息,请参阅 虚拟机 (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) 或 虚拟机 (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/) 的大小。 Batch 支持除STANDARD_A0和具有高级存储 (STANDARD_GS、STANDARD_DS和STANDARD_DSV2系列) 以外的所有 Azure VM 大小。
vmSize?: string
属性值
string