你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Pool interface

包含有关池的信息。

Extends

属性

allocationState

池是否正在调整大小。 注意:此属性不会被序列化。 它只能由服务器填充。

allocationStateTransitionTime

池进入其当前分配状态的时间。 注意:此属性不会被序列化。 它只能由服务器填充。

applicationLicenses

应用程序许可证列表必须是可用 Batch 服务应用程序许可证的子集。 如果请求的许可证不受支持,则池创建将失败。

applicationPackages

对应用程序包引用的更改会影响加入池的所有新计算节点,但在重新启动或重置映像之前,不会影响池中已有的计算节点。 任何给定池上最多有 10 个应用程序包引用。

autoScaleRun

仅当池自动缩放(即使用 autoScaleSettings)时,才会设置此属性。 注意:此属性不会被序列化。 它只能由服务器填充。

certificates

对于 Windows 计算节点,Batch 服务会将证书安装到指定的证书存储和位置。 对于 Linux 计算节点,证书存储在任务工作目录内的目录中,并向任务提供环境变量AZ_BATCH_CERTIFICATES_DIR以查询此位置。 对于具有“remoteUser”可见性的证书,在用户的主目录中创建一个“certs”目录, (例如 /home/{user-name}/certs) ,证书将放置在该目录中。

警告:此属性已弃用,将在 2024 年 2 月之后删除。 请改用 Azure KeyVault 扩展

creationTime

池的创建时间。 注意:此属性不会被序列化。 它只能由服务器填充。

currentDedicatedNodes

池中当前专用计算节点的数量。 注意:此属性不会被序列化。 它只能由服务器填充。

currentLowPriorityNodes

池中当前存在的现成/低优先级计算节点数。 注意:此属性不会被序列化。 它只能由服务器填充。

currentNodeCommunicationMode

确定池如何与 Batch 服务通信。 注意:此属性不会被序列化。 它只能由服务器填充。

deploymentConfiguration

使用 CloudServiceConfiguration 指定应使用 Azure 云服务 (PaaS) 创建节点,而 VirtualMachineConfiguration 使用 Azure 虚拟机 (IaaS) 。

displayName

显示名称不一定是唯一的,可以包含最大长度为 1024 的任何 Unicode 字符。

identity

用于 Batch 池的标识类型。

interNodeCommunication

这会对可分配给池的节点施加限制。 启用此值可以减少请求的节点数在池中分配的机会。 如果未指定,此值默认为“Disabled”。

lastModified

这是池级别数据(例如 targetDedicatedNodes 或 autoScaleSettings)的最后一次更改。 它不考虑节点级更改,例如计算节点更改状态。 注意:此属性不会被序列化。 它只能由服务器填充。

metadata

Batch 服务不赋予元数据任何含义;它仅用于使用用户代码。

mountConfiguration

这支持 Azure 文件存储、NFS、CIFS/SMB 和 Blobfuse。

networkConfiguration

池的网络配置。

provisioningState

池的当前状态。 注意:此属性不会被序列化。 它只能由服务器填充。

provisioningStateTransitionTime

池进入其当前状态的时间。 注意:此属性不会被序列化。 它只能由服务器填充。

resizeOperationStatus

描述当前操作 (是否池 AllocationState 正在调整大小) ,或者如果 AllocationState 为“稳定) ”,则描述以前完成的操作 (。 注意:此属性不会被序列化。 它只能由服务器填充。

resourceTags

要与Azure Batch池关联的用户定义的标记。 指定后,这些标记将传播到与池关联的后备 Azure 资源。 只有在将 poolAllocationMode 属性设置为“UserSubscription”的情况下创建 Batch 帐户时,才能指定此属性。

scaleSettings

定义所需的池大小。 这可以是“fixedScale”,其中指定了请求的 targetDedicatedNodes,也可以是定义定期重新计算的公式的“autoScale”。 如果未指定此属性,池将具有 0 targetDedicatedNodes 的固定规模。

startTask

在 PATCH (更新) 操作中,可以将此属性设置为空对象,以从池中删除启动任务。

targetNodeCommunicationMode

如果省略,默认值为 Default。

taskSchedulingPolicy

如果未指定,则默认值为 spread。

taskSlotsPerNode

默认值为 1。 最大值是池 vmSize 核心数的 4 倍或 256 的较小值。

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 大小。

继承属性

etag

资源的 ETag,用于并发语句。 注意:此属性不会被序列化。 它只能由服务器填充。

id

资源的 ID。 注意:此属性不会被序列化。 它只能由服务器填充。

name

资源的名称。 注意:此属性不会被序列化。 它只能由服务器填充。

type

资源类型。 注意:此属性不会被序列化。 它只能由服务器填充。

属性详细信息

allocationState

池是否正在调整大小。 注意:此属性不会被序列化。 它只能由服务器填充。

allocationState?: 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

用于 Batch 池的标识类型。

identity?: BatchPoolIdentity

属性值

interNodeCommunication

这会对可分配给池的节点施加限制。 启用此值可以减少请求的节点数在池中分配的机会。 如果未指定,此值默认为“Disabled”。

interNodeCommunication?: InterNodeCommunicationState

属性值

lastModified

这是池级别数据(例如 targetDedicatedNodes 或 autoScaleSettings)的最后一次更改。 它不考虑节点级更改,例如计算节点更改状态。 注意:此属性不会被序列化。 它只能由服务器填充。

lastModified?: Date

属性值

Date

metadata

Batch 服务不赋予元数据任何含义;它仅用于使用用户代码。

metadata?: MetadataItem[]

属性值

mountConfiguration

这支持 Azure 文件存储、NFS、CIFS/SMB 和 Blobfuse。

mountConfiguration?: MountConfiguration[]

属性值

networkConfiguration

池的网络配置。

networkConfiguration?: 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

在 PATCH (更新) 操作中,可以将此属性设置为空对象,以从池中删除启动任务。

startTask?: StartTask

属性值

targetNodeCommunicationMode

如果省略,默认值为 Default。

targetNodeCommunicationMode?: NodeCommunicationMode

属性值

taskSchedulingPolicy

如果未指定,则默认值为 spread。

taskSchedulingPolicy?: TaskSchedulingPolicy

属性值

taskSlotsPerNode

默认值为 1。 最大值是池 vmSize 核心数的 4 倍或 256 的较小值。

taskSlotsPerNode?: number

属性值

number

upgradePolicy

描述升级策略 - 自动、手动或滚动。

upgradePolicy?: UpgradePolicy

属性值

userAccounts

将在池中的每个节点上创建的用户帐户列表。

userAccounts?: UserAccount[]

属性值

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

继承属性详细信息

etag

资源的 ETag,用于并发语句。 注意:此属性不会被序列化。 它只能由服务器填充。

etag?: string

属性值

string

继承自ProxyResource.etag

id

资源的 ID。 注意:此属性不会被序列化。 它只能由服务器填充。

id?: string

属性值

string

继承自ProxyResource.id

name

资源的名称。 注意:此属性不会被序列化。 它只能由服务器填充。

name?: string

属性值

string

继承自ProxyResource.name

type

资源类型。 注意:此属性不会被序列化。 它只能由服务器填充。

type?: string

属性值

string

继承自ProxyResource.type