通过

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

ComputeNode 类

  • 参考

Batch 服务中的计算节点。

继承
Model
ComputeNode

构造函数

ComputeNode(*, id: str = None, url: str = None, state=None, scheduling_state=None, state_transition_time=None, last_boot_time=None, allocation_time=None, ip_address: str = None, affinity_id: str = None, vm_size: str = None, total_tasks_run: int = None, running_tasks_count: int = None, running_task_slots_count: int = None, total_tasks_succeeded: int = None, recent_tasks=None, start_task=None, start_task_info=None, certificate_references=None, errors=None, is_dedicated: bool = None, endpoint_configuration=None, node_agent_info=None, virtual_machine_info=None, **kwargs)

参数

id
str
必需

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

url
str
必需
state
str 或 ComputeNodeState
必需

现成/低优先级计算节点已被抢占。 当另一个计算节点可用时，计算节点上运行的任务将被重新安排。 可能的值包括：“idle”、“rebooting”、“reimaging”、“running”、“unusable”、“creating”、“starting”、“waitingForStartTask”、“startTask”、“startTaskFailed”、“unknown”、“leavingPool”、“offline”、“preempted”

scheduling_state
str 或 SchedulingState
必需

可能的值包括：“enabled”、“disabled”

state_transition_time
datetime
必需
last_boot_time
datetime
必需

如果计算节点状态不可用，则此属性可能不存在。

allocation_time
datetime
必需

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

ip_address
str
必需

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

affinity_id
str
必需

请注意，这只是一种软相关性。 如果目标计算节点在计划任务时正忙或不可用，则将在其他位置安排该任务。

vm_size
str
必需

有关池中虚拟机的可用大小的信息，请参阅为Azure Batch池中的计算节点选择 VM 大小 (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes) 。

total_tasks_run
int
必需

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

running_tasks_count
int
必需

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

running_task_slots_count
int
必需

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

total_tasks_succeeded
int
必需

成功完成的作业任务总数， (计算节点上的 exitCode 0) 。 这包括作业管理器任务和普通任务，但不包括作业准备、作业发布或启动任务。

recent_tasks
list[TaskInformation]
必需

仅当此计算节点上至少有一个 Task 自分配给池以来，此属性才存在。

start_task
StartTask
必需

指定在计算节点上加入池时运行的任务。

start_task_info
StartTaskInformation
必需

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

certificate_references
list[CertificateReference]
必需

对于 Windows 节点，Batch 服务会将证书安装到指定的证书存储和位置。 对于 Linux 计算节点，证书存储在 Task 工作目录内的目录中，并向 Task 提供环境变量AZ_BATCH_CERTIFICATES_DIR以查询此位置。 对于具有“remoteUser”可见性的证书，在用户的主目录中创建一个“certs”目录， (例如/home/{user-name}/certs) ，证书放置在该目录中。 警告：此属性已弃用，将在 2024 年 2 月之后删除。请改用 Azure KeyVault 扩展 。

errors
list[ComputeNodeError]
必需
is_dedicated
bool
必需

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

endpoint_configuration
ComputeNodeEndpointConfiguration
必需

计算节点的终结点配置。

node_agent_info
NodeAgentInformation
必需

有关计算节点代理版本以及计算节点升级到新版本的时间的信息。

virtual_machine_info
VirtualMachineInfo
必需

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

方法

as_dict

使用 json.dump 返回可以是 JSONify 的 dict。

高级用法可以选择使用回调作为参数：

Key 是 Python 中使用的属性名称。 Attr_desc是元数据的一个听写。 当前包含具有 msrest 类型的“type”和包含 RestAPI 编码密钥的“key”。 Value 是此 对象中的当前值。

返回的字符串将用于序列化密钥。 如果返回类型是列表，则这被视为分层结果 dict。

请参阅此文件中的三个示例：

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

如果需要 XML 序列化，可以传递 kwargs is_xml=True。
deserialize

使用 RestAPI 语法分析 str 并返回模型。
enable_additional_properties_sending
from_dict

使用给定的键提取程序分析 dict 会返回模型。

默认情况下，请考虑密钥提取程序 (rest_key_case_insensitive_extractor、attribute_key_case_insensitive_extractor和last_rest_key_case_insensitive_extractor)

is_xml_model
serialize

返回将从此模型发送到 Azure 的 JSON。

这是 as_dict (full_restapi_key_transformer 的别名 ，keep_readonly=False) 。

如果需要 XML 序列化，可以传递 kwargs is_xml=True。
validate

以递归方式验证此模型，并返回 ValidationError 列表。

as_dict

使用 json.dump 返回可以是 JSONify 的 dict。

高级用法可以选择使用回调作为参数：

Key 是 Python 中使用的属性名称。 Attr_desc是元数据的一个听写。 当前包含具有 msrest 类型的“type”和包含 RestAPI 编码密钥的“key”。 Value 是此 对象中的当前值。

返回的字符串将用于序列化密钥。 如果返回类型是列表，则这被视为分层结果 dict。

请参阅此文件中的三个示例：

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

如果需要 XML 序列化，可以传递 kwargs is_xml=True。

as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)

参数

key_transformer
<xref:function>

密钥转换器函数。

keep_readonly
默认值: True

返回

与 dict JSON 兼容的对象

返回类型

dict

deserialize

使用 RestAPI 语法分析 str 并返回模型。

deserialize(data, content_type=None)

参数

data
str
必需

使用 RestAPI 结构的 str。 默认情况下为 JSON。

content_type
str
默认值: None

默认情况下，如果为 XML，则设置 application/xml。

返回

此模型的实例

例外

DeserializationError if something went wrong

enable_additional_properties_sending 

enable_additional_properties_sending()

from_dict

使用给定的键提取程序分析 dict 会返回模型。

默认情况下，请考虑密钥提取程序 (rest_key_case_insensitive_extractor、attribute_key_case_insensitive_extractor和last_rest_key_case_insensitive_extractor) 

from_dict(data, key_extractors=None, content_type=None)

参数

data
dict
必需

使用 RestAPI 结构的 dict

content_type
str
默认值: None

默认情况下，如果为 XML，则设置 application/xml。

key_extractors
默认值: None

返回

此模型的实例

例外

DeserializationError if something went wrong

is_xml_model 

is_xml_model()

serialize

返回将从此模型发送到 Azure 的 JSON。

这是 as_dict (full_restapi_key_transformer 的别名 ，keep_readonly=False) 。

如果需要 XML 序列化，可以传递 kwargs is_xml=True。

serialize(keep_readonly=False, **kwargs)

参数

keep_readonly
bool
默认值: False

如果要序列化只读属性

返回

与 dict JSON 兼容的对象

返回类型

dict

validate

以递归方式验证此模型，并返回 ValidationError 列表。

validate()

返回

验证错误列表

返回类型

list