Compute Node - Get

ComputeNode

包含计算节点的响应。

标头

• client-request-id: string
• request-id: string
• ETag: string
• Last-Modified: string

BatchError

Batch 服务中的错误。

ElevationLevel

自动用户的提升级别。
默认值为 nonAdmin。

AutoUserScope

自动用户的范围
默认值为池。 如果池正在运行 Windows，则应指定任务值（如果需要在任务之间进行更严格的隔离）。 例如，如果任务以可能影响其他任务的方式改变注册表，或者已在池中指定了证书，而该池中不应通过正常任务访问，但应可由 StartTasks 访问。

string

错误的标识符。 代码是固定的，旨在以编程方式使用。

ErrorMessage

描述错误的消息，旨在适合在用户界面中显示。

BatchErrorDetail[]

包含有关错误的更多详细信息的键值对的集合。

string

指定 Value 属性含义的标识符。

string

错误响应附带的其他信息。

CertificateStoreLocation

要在其中安装证书的计算节点上证书存储的位置。
默认值为 currentuser。 此属性仅适用于使用 Windows 计算节点配置的池。 对于 Linux 计算节点，证书存储在 Task 工作目录中的目录中，并向任务提供环境变量AZ_BATCH_CERTIFICATES_DIR以查询此位置。 对于可见性为“remoteUser”的证书，将在用户的主目录中（例如 /home/{user-name}/certs）中创建一个“证书”目录，并将证书置于该目录中。

string

要在其中安装证书的计算节点上的证书存储的名称。
此属性仅适用于使用 Windows 计算节点配置的池。 常见的存储名称包括：My、Root、CA、Trust、Trustallowed、TrustedPeople、TrustedPublisher、AuthRoot、AddressBook，但也可以使用任何自定义存储名称。 默认值为“我的”。

string

证书的指纹。

string

指纹关联的算法。 这必须是 sha1。

CertificateVisibility[]

计算节点上的哪些用户帐户应有权访问证书的专用数据。
可以在此集合中指定多个可见性。 默认值为所有帐户。

string

添加任务以请求在此计算节点上计划任务时传递的标识符。
请注意，这只是软相关性。 如果目标计算节点在计划任务时繁忙或不可用，则任务将在其他位置进行计划。

string (date-time)

此计算节点分配给池的时间。
这是计算节点最初分配的时间，设置后不会更改。 当计算节点被服务治愈或抢占时，它不会更新。

CertificateReference[]

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

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

ComputeNodeEndpointConfiguration

计算节点的终结点配置。

ComputeNodeError[]

计算节点当前遇到的错误列表。

string

计算节点的 ID。
添加到池的每个计算节点都分配有唯一 ID。 每当从池中删除计算节点时，都会删除其所有本地文件，并回收 ID，并可以重新用于新的计算节点。

string

其他节点可用于与此计算节点通信的 IP 地址。
添加到池的每个计算节点都分配有唯一的 IP 地址。 每当从池中删除计算节点时，都会删除其所有本地文件，并回收 IP 地址，并可以重新用于新的计算节点。

boolean

此计算节点是否为专用计算节点。 如果为 false，则计算节点是现成/低优先级计算节点。

string (date-time)

上次启动计算节点的时间。
如果计算节点状态不可用，则此属性可能不存在。

NodeAgentInformation

有关计算节点代理版本以及计算节点升级到新版本的时间的信息。
Batch 计算节点代理是在池中的每个计算节点上运行的程序，并在计算节点上提供 Batch 功能。

TaskInformation[]

最近更改其状态的任务列表。
仅当至少一个任务已在此计算节点上运行，因为该任务已分配给池，此属性才存在。

integer (int32)

当前在计算节点上运行作业任务的计划槽总数。 这包括作业管理器任务和常规任务，但不包括作业准备、作业发布或启动任务。

integer (int32)

计算节点上当前正在运行的作业任务的总数。 这包括作业管理器任务和常规任务，但不包括作业准备、作业发布或启动任务。

SchedulingState

计算节点是否可用于任务计划。

StartTask

指定要在计算节点上运行的任务，因为它加入池。
当在节点上触发恢复操作时，Batch 将重试任务。 恢复操作的示例包括（但不限于）在重新启动运行不正常的节点或计算节点因主机故障而消失时。 由于恢复操作而进行的重试与 maxTaskRetryCount 无关，并且不计入 maxTaskRetryCount。 即使 maxTaskRetryCount 为 0，也可能发生由于恢复操作而导致的内部重试。 因此，所有任务都应是幂等的。 这意味着任务需要容忍中断和重启，而不会导致任何损坏或重复数据。 长时间运行的任务的最佳做法是使用某种形式的检查点。 在某些情况下，即使计算节点未重新启动，StartTask 也可能重新运行。 应特别注意避免 StartTaskss 从 StartTask 工作目录创建分离进程或安装/启动服务，因为这会阻止 Batch 重新运行 StartTask。

StartTaskInformation

有关在计算节点上执行 StartTask 的运行时信息。

ComputeNodeState

计算节点的当前状态。
现成/低优先级计算节点已被抢占。 当计算节点被抢占时在计算节点上运行的任务将在另一个计算节点可用时重新计划。

string (date-time)

计算节点进入其当前状态的时间。

integer (int32)

计算节点上完成的作业任务总数。 这包括作业管理器任务和常规任务，但不包括作业准备、作业发布或启动任务。

integer (int32)

计算节点上成功完成的作业任务总数（带有 exitCode 0）。 这包括作业管理器任务和常规任务，但不包括作业准备、作业发布或启动任务。

string

计算节点的 URL。

VirtualMachineInfo

有关虚拟机的当前状态的信息。

string

托管计算节点的虚拟机的大小。
有关池中虚拟机的可用大小的信息，请参阅为 Azure Batch 池中的计算节点选择 VM 大小（https://free.blessedness.top/azure/batch/batch-pool-vm-sizes）。

InboundEndpoint[]

计算节点上可访问的入站终结点的列表。

string

计算节点错误的标识符。 代码是固定的，旨在以编程方式使用。

NameValuePair[]

与计算节点错误相关的其他错误详细信息的列表。

string

描述计算节点错误的消息，旨在适合在用户界面中显示。

string

用户分配标识的 ARM 资源 ID。

boolean

将此源路径装载为只读模式或不装载。 默认值为 false（读/写模式）。
对于 Linux，如果将此路径装载为读/写模式，这并不意味着容器中的所有用户都具有路径的读/写访问权限，这取决于主机 VM 中的访问。 如果此路径装载为只读，则容器中的所有用户将无法修改路径。

ContainerHostDataPath

装载到容器客户的路径可以选择。

ComputeNodeIdentityReference

对用于访问 Azure 容器注册表（而不是用户名和密码）的用户分配标识的引用。
对与计算节点将使用的 Batch 池关联的用户分配标识的引用。

string

登录到注册表服务器的密码。

string

注册表 URL。
如果省略，则默认值为“docker.io”。

string

要登录到注册表服务器的用户名。

string

环境变量的名称。

string

环境变量的值。

string

错误消息的语言代码

string

消息的文本。

string

社区库映像唯一标识符
此属性与其他属性互斥，可以从社区库映像 GET 调用中提取。

string

用于创建节点的平台映像或市场映像的特定版本。 仅当创建池时为“version”指定的值为“latest”时，此只读字段与“version”不同。

string

Azure 虚拟机市场映像的产品/服务类型。
例如，UbuntuServer 或 WindowsServer。

string

Azure 虚拟机市场映像的发布者。
例如，Canonical 或 MicrosoftWindowsServer。

string

共享库映像唯一标识符
此属性与其他属性互斥，可以从共享库映像 GET 调用中提取。

string

Azure 虚拟机市场映像的 SKU。
例如，18.04-LTS 或 2019-Datacenter。

string

Azure 虚拟机市场映像的版本。
可以指定值“latest”以选择最新版本的映像。 如果省略，则默认值为“latest”。

string

Azure 计算库映像的 ARM 资源标识符。 池中的计算节点将使用此映像 ID 创建。此格式为 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} 或 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}，以始终默认为最新映像版本。
此属性与其他 ImageReference 属性互斥。 Azure 计算库映像必须在同一区域中具有副本，并且必须与 Azure Batch 帐户位于同一订阅中。 如果未在 imageId 中指定映像版本，将使用最新版本。 有关 Batch 计算节点代理与 Batch 服务通信的防火墙设置的信息，请参阅 https://free.blessedness.top/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration。

integer (int32)

终结点的后端端口号。

integer (int32)

终结点的公共端口号。

string

终结点的名称。

InboundEndpointProtocol

终结点的协议。

string

计算节点的公共完全限定域名。

string

计算节点的公共 IP 地址。

string

名称值对中的名称。

string

名称值对中的值。

string (date-time)

计算节点代理在计算节点上更新的时间。
这是计算节点代理最近更新到新版本的时间。

string

在计算节点上运行的 Batch 计算节点代理的版本。
可以根据位于 https://github.com/Azure/Batch/blob/master/changelogs/nodeagent/CHANGELOG.md的计算节点代理发行说明检查此版本号。

string

自动存储帐户中的存储容器名称。
autoStorageContainerName、storageContainerUrl 和 httpUrl 属性互斥，必须指定其中一个属性。

string

从 Azure 存储容器下载 Blob 时要使用的 Blob 前缀。 仅下载名称以指定前缀开头的 blob。
仅当使用 autoStorageContainerName 或 storageContainerUrl 时，该属性才有效。 此前缀可以是部分文件名或子目录。 如果未指定前缀，则会下载容器中的所有文件。

string

以八进制格式的文件权限模式属性。
此属性仅适用于下载到 Linux 计算节点的文件。 如果为将下载到 Windows 计算节点的 resourceFile 指定，将忽略它。 如果未为 Linux 计算节点指定此属性，则会将默认值 0770 应用于该文件。

string

要下载文件（s）的计算节点上相对于任务的工作目录的位置。
如果指定了 httpUrl 属性，则需要 filePath，并描述文件将下载到的路径，包括文件名。 否则，如果指定 autoStorageContainerName 或 storageContainerUrl 属性，则 filePath 是可选的，并且是将文件下载到的目录。 如果 filePath 用作目录，则与输入数据关联的任何目录结构都将完整保留并追加到指定的 filePath 目录。 指定的相对路径不能脱离 Task 的工作目录（例如，使用'..'）。

string

要下载的文件的 URL。
autoStorageContainerName、storageContainerUrl 和 httpUrl 属性互斥，必须指定其中一个属性。 如果 URL 指向 Azure Blob 存储，则必须从计算节点读取该 URL。 可通过三种方法获取 Azure 存储中 Blob 的此类 URL：包括授予对 Blob 的读取权限的共享访问签名（SAS），使用具有读取权限的托管标识，或为 Blob 或其容器设置 ACL 以允许公共访问。

ComputeNodeIdentityReference

对用户分配的标识的引用，用于访问由 storageContainerUrl 或 httpUrl 指定的 Azure Blob 存储
对与计算节点将使用的 Batch 池关联的用户分配标识的引用。

string

Azure Blob 存储中 Blob 容器的 URL。
autoStorageContainerName、storageContainerUrl 和 httpUrl 属性互斥，必须指定其中一个属性。 此 URL 必须可从计算节点读取和列出。 可通过三种方法获取 Azure 存储中容器的此类 URL：包括授予对容器的读取和列表权限的共享访问签名（SAS），使用具有读取和列表权限的托管标识，或为容器设置 ACL 以允许公共访问。

string

StartTask 的命令行。
命令行未在 shell 下运行，因此不能利用 shell 功能（如环境变量扩展）。 如果要利用这些功能，则应在命令行中调用 shell，例如在 Windows 中使用“cmd /c MyCommand”或在 Linux 中使用“/bin/sh -c MyCommand”。 如果命令行引用文件路径，则应使用相对路径（相对于任务工作目录），或使用 Batch 提供的环境变量（https://free.blessedness.top/azure/batch/batch-compute-node-environment-variables）。

TaskContainerSettings

运行 StartTask 的容器的设置。
指定此项后，AZ_BATCH_NODE_ROOT_DIR（节点上的 Azure Batch 目录的根目录）以递归方式映射到容器中，所有任务环境变量都映射到容器中，并在容器中执行 Task 命令行。 在AZ_BATCH_NODE_ROOT_DIR外部容器中生成的文件可能不会反映在主机磁盘上，这意味着 Batch 文件 API 将无法访问这些文件。

EnvironmentSetting[]

StartTask 的环境变量设置列表。

integer (int32)

可以重试任务的最大次数。
如果 Batch 服务退出代码为非零，则重试任务。 请注意，此值专门控制重试次数。 Batch 服务将尝试一次任务，然后可能会重试到此限制。 例如，如果最大重试计数为 3，Batch 将尝试任务最多 4 次（一次初始尝试和 3 次重试）。 如果最大重试计数为 0，Batch 服务不会重试任务。 如果最大重试计数为 -1，Batch 服务将重试任务，但不建议用于启动任务或任何任务。 默认值为 0（无重试）。

ResourceFile[]

Batch 服务在运行命令行之前将下载到计算节点的文件列表。 资源文件列表的最大大小。 超过最大大小时，请求将失败，响应错误代码将为 RequestEntityTooLarge。 如果发生这种情况，则必须减小 ResourceFiles 的集合大小。 这可以使用 .zip 文件、应用程序包或 Docker 容器来实现。
此元素下列出的文件位于任务的工作目录中。

UserIdentity

运行 StartTask 的用户标识。
如果省略，任务将作为任务唯一的非管理用户运行。

boolean

在计划计算节点上的任何任务之前，Batch 服务是否应等待 StartTask 成功完成（即退出代码 0）。
如果 True 且 StartTask 在节点上失败，Batch 服务将重试 StartTask，最大重试计数（maxTaskRetryCount）。 如果任务在所有重试后仍未成功完成，则 Batch 服务会标记节点不可用，并且不会为其计划任务。 可以通过计算节点状态和故障信息详细信息来检测此条件。 如果为 false，Batch 服务不会等待 StartTask 完成。 在这种情况下，在 StartTask 仍在运行时，其他任务可以开始在计算节点上执行;即使 StartTask 失败，新任务将继续在计算节点上计划。 默认值为 true。

TaskContainerExecutionInformation

有关任务正在执行的容器的信息。
仅当任务在容器上下文中运行时，才会设置此属性。

string (date-time)

StartTask 停止运行的时间。
这是 StartTask 最近运行的结束时间（如果该运行已完成（即使该运行失败且重试挂起）。 如果 StartTask 当前正在运行，则此元素不存在。

integer (int32)

StartTask 命令行中指定的程序的退出代码。
仅当 StartTask 处于已完成状态时，才会设置此属性。 通常，进程的退出代码反映了应用程序开发人员为该过程实现的特定约定。 如果使用退出代码值在代码中做出决策，请确保知道应用程序进程使用的退出代码约定。 但是，如果 Batch 服务终止 StartTask（由于超时或用户通过 API 终止），可能会看到操作系统定义的退出代码。

TaskFailureInformation

描述任务失败的信息（如果有）。
仅当任务处于已完成状态且遇到失败时，才会设置此属性。

string (date-time)

最近一次，任务重试开始运行。
仅当重试任务（即 retryCount 为非零）时，此元素才存在。 如果存在，这通常与 startTime 相同，但如果任务因重试以外的原因而重新启动，则可能会有所不同;例如，如果在重试期间重新启动了计算节点，则 startTime 会更新，但 lastRetryTime 不是。

TaskExecutionResult

任务执行的结果。
如果值为“failed”，则可以在 failureInfo 属性中找到失败的详细信息。

integer (int32)

Batch 服务重试任务次数。
重试任务应用程序失败（非零退出代码），预处理错误（无法运行任务），并且不会重试文件上传错误。 Batch 服务将按约束指定的限制重试任务。

string (date-time)

StartTask 开始运行的时间。
每次重新启动或重试任务时，都会重置此值（即，这是 StartTask 开始运行的最新时间）。

StartTaskState

计算节点上 StartTask 的状态。

string

容器的 ID。

string

有关容器的详细错误信息。
这是 Docker 服务的详细错误字符串（如果可用）。 它等效于“docker 检查”返回的错误字段。

string

容器的状态。
这是容器的状态，根据 Docker 服务。 它等效于“docker 检查”返回的状态字段。

ContainerHostBatchBindMountEntry[]

要装载到容器任务的路径。
如果此数组为 null 或不存在，容器任务将在 Windows 中装载整个临时磁盘驱动器（或 Linux 中的AZ_BATCH_NODE_ROOT_DIR）。 如果此数组设置为空，则不会将任何数据路径装载到容器中。

string

容器创建命令的其他选项。
除了 Batch 服务控制的选项外，这些附加选项还作为“docker create”命令的参数提供。

string

用于创建任务将在其中运行容器的映像。
这是完整的映像引用，如指定为“docker pull”。 如果未将标记作为映像名称的一部分提供，则标记“：latest”将用作默认值。

ContainerRegistry

包含容器映像的专用注册表。
如果在创建池时已提供此设置，则可以省略此设置。

ContainerWorkingDirectory

容器任务工作目录的位置。
默认值为“taskWorkingDirectory”。

TaskContainerExecutionInformation

有关任务正在执行的容器的信息。
仅当任务在容器上下文中运行时，才会设置此属性。

string (date-time)

任务完成的时间。
仅当任务处于“已完成”状态时，才会设置此属性。

integer (int32)

任务命令行上指定的程序的退出代码。
仅当任务处于已完成状态时，才会设置此属性。 通常，进程的退出代码反映了应用程序开发人员为该过程实现的特定约定。 如果使用退出代码值在代码中做出决策，请确保知道应用程序进程使用的退出代码约定。 但是，如果 Batch 服务终止任务（由于超时或用户通过 API 终止），可能会看到操作系统定义的退出代码。

TaskFailureInformation

描述任务失败的信息（如果有）。
仅当任务处于已完成状态且遇到失败时，才会设置此属性。

string (date-time)

由于用户请求，Batch 服务最近一次重新排队任务。
仅当 requeueCount 为非零时，才会设置此属性。

string (date-time)

最近一次，任务重试开始运行。
仅当重试任务（即 retryCount 为非零）时，此元素才存在。 如果存在，这通常与 startTime 相同，但如果任务因重试以外的原因而重新启动，则可能会有所不同;例如，如果在重试期间重新启动了计算节点，则 startTime 会更新，但 lastRetryTime 不是。

integer (int32)

由于用户请求，任务已由 Batch 服务重新排队的次数。
当用户从池中删除计算节点（通过调整池大小/缩小池）或禁用作业时，用户可以指定重新排队在计算节点上运行的任务以供执行。 此计数跟踪任务因这些原因重新排队的次数。

TaskExecutionResult

任务执行的结果。
如果值为“failed”，则可以在 failureInfo 属性中找到失败的详细信息。

integer (int32)

Batch 服务重试任务次数。
重试任务应用程序失败（非零退出代码），预处理错误（无法运行任务），并且不会重试文件上传错误。 Batch 服务将按约束指定的限制重试任务。

string (date-time)

任务开始运行的时间。
“Running”对应于运行状态，因此，如果任务指定资源文件或包，则开始时间反映任务开始下载或部署这些文件的时间。 如果任务已重启或重试，则这是任务开始运行的最新时间。 此属性仅适用于处于正在运行或已完成状态的任务。

ErrorCategory

任务错误的类别。

string

任务错误的标识符。 代码是固定的，旨在以编程方式使用。

NameValuePair[]

与错误相关的其他详细信息的列表。

string

描述任务错误的消息，旨在适合在用户界面中显示。

TaskExecutionInformation

有关任务执行的信息。

string

任务所属的作业的 ID。

integer (int32)

如果任务是多实例任务，则子任务的 ID。

string

任务的 ID。

TaskState

任务的当前状态。

string

任务的 URL。

AutoUserSpecification

运行任务的自动用户。
userName 和 autoUser 属性互斥;必须指定一个，但不能同时指定两者。

string

运行任务的用户标识的名称。
userName 和 autoUser 属性互斥;必须指定一个，但不能同时指定两者。

ImageReference

对 Azure 虚拟机市场映像的引用。

string

计算节点的当前虚拟机规模集 VM 的资源 ID。 仅当 Batch 帐户创建时，才将其 poolAllocationMode 属性设置为“UserSubscription”。