您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

az batch job-schedule

管理 Batch 作业计划。

命令

az batch job-schedule create

将 Batch 作业计划添加到帐户。

az batch job-schedule delete

从指定的帐户中删除作业计划。

az batch job-schedule disable

禁用作业计划。

az batch job-schedule enable

启用作业计划。

az batch job-schedule list

列出指定帐户中的所有作业计划。

az batch job-schedule reset

重置作业计划的属性。 更新的作业规范仅适用于新作业。

az batch job-schedule set

更新作业计划的属性。

az batch job-schedule show

获取有关指定作业计划的信息。

az batch job-schedule stop

终止作业计划。

az batch job-schedule create

将 Batch 作业计划添加到帐户。

az batch job-schedule create [--account-endpoint]
                             [--account-key]
                             [--account-name]
                             [--do-not-run-after]
                             [--do-not-run-until]
                             [--id]
                             [--job-manager-task-command-line]
                             [--job-manager-task-id]
                             [--job-manager-task-resource-files]
                             [--job-max-task-retry-count]
                             [--job-max-wall-clock-time]
                             [--json-file]
                             [--metadata]
                             [--on-all-tasks-complete {noaction, terminatejob}]
                             [--pool-id]
                             [--priority]
                             [--recurrence-interval]
                             [--required-slots]
                             [--start-window]
                             [--subscription]
                             [--uses-task-dependencies]

可选参数

--account-endpoint

Batch 服务终结点。 或者,按环境变量设置:AZURE_BATCH_ENDPOINT。

--account-key

Batch 帐户密钥。 或者,按环境变量设置:AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帐户名称。 或者,按环境变量设置:AZURE_BATCH_ACCOUNT。

--do-not-run-after

在此时间之后,不会在此作业计划下创建作业。 一旦此截止时间过去,并且此作业计划下没有活动的作业,计划就会进入已完成状态。 如果未指定 doNotRunAfter 时间,并且要创建定期作业计划,则作业计划将保持活动状态,直到显式终止它。 预期格式为 ISO-8601 时间戳。

--do-not-run-until

在此作业计划下可创建任何作业的最早时间。 如果未指定 doNotRunUntil 时间,计划将立即准备好创建作业。 预期格式为 ISO-8601 时间戳。

--id

必需。 一个字符串,用于唯一标识帐户中的计划。 该 ID 可以包含字母数字字符(包括连字符和下划线)的任意组合,并且不能包含超过 64 个字符。 ID 保留大小写,不区分 (,也就是说,帐户中可能没有两个 ID,它们仅因大小写) 。

--job-manager-task-command-line

必需。 作业管理器任务的命令行。 命令行不在 shell 下运行,因此无法利用 shell 功能,如环境变量扩展。 若要利用此类功能,应在命令行中调用 shell,例如,使用 Windows 中的"cmd /c MyCommand"或 Linux 中的"/bin/sh -c MyCommand"。 如果命令行引用文件路径,则它应当使用相对于任务 (目录的相对路径) ,或使用 Batch 提供的环境变量 https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables) (。

--job-manager-task-id

必需。 一个字符串,用于唯一标识作业中的作业管理器任务。 该 ID 可以包含字母数字字符(包括连字符和下划线)的任意组合,并且不能包含超过 64 个字符。

--job-manager-task-resource-files

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

--job-max-task-retry-count

可以重试每个任务的最大次数。 如果任务退出代码不为零,Batch 服务将重试该任务。 请注意,此值专门用于控制重试的次数。 Batch 服务将尝试每个任务一次,然后重试次数可能达到此限制。 例如,如果最大重试计数为 3,则 Batch 最多尝试 4 次任务 (次初始尝试,3 次重试) 。 如果最大重试计数为 0,则 Batch 服务不会重试任务。 如果最大重试计数为 -1,Batch 服务将无限制地重试任务。 默认值为 0(不重试)。

--job-max-wall-clock-time

作业可能运行的最大运行时间,从创建作业的时间开始测量。 如果作业未在时间限制内完成,Batch 服务会终止作业以及仍在运行的任何任务。 在这种情况下,终止原因为 MaxWallClockTimeExpiry。 如果未指定此属性,则作业的运行时间没有时间限制。 预期格式为 ISO-8601 持续时间。

--json-file

包含 JSON 格式的云作业计划规范 (格式,以匹配相应的REST API正文) 。 如果指定了此参数,则忽略所有"云作业计划参数"。

--metadata

与作为元数据的计划关联的名称/值对的列表。 Batch 服务不会向元数据分配任何含义;它仅用于使用用户代码。 "key=value"格式的空格分隔值。

--on-all-tasks-complete

当在此计划下创建的作业中所有任务都为已完成时,Batch 服务应执行的操作。 请注意,如果作业不包含任何任务,则所有任务都被视为已完成。 因此,此选项最常用于作业管理器任务;如果要在不使用作业管理器的情况下使用自动作业终止,应首先将 onAllTasksComplete 设置为 noaction,并更新作业属性,以在添加任务后将 onAllTasksComplete 设置为 terminatejob。 默认值为 noaction。

接受的值: noaction, terminatejob
--pool-id

现有池的 ID。 作业的所有任务都将在指定的池中运行。

--priority

在此计划下创建的作业的优先级。 优先级值的范围为 -1000 到 1000,-1000 表示最低优先级,1000 表示最高优先级。 默认值为 0。 此优先级用作"作业计划"下所有作业的默认优先级。 使用更新作业 API 创建作业后,可以更新作业的优先级。

--recurrence-interval

作业计划下两个连续作业的开始时间之间的时间间隔。 在任意给定时间,作业计划下最多只能有一个活动作业。 由于作业计划在任意给定时间下最多只能有一个活动作业,因此,如果是在作业计划下创建新作业,但上一个作业仍在运行,则 Batch 服务在上一个作业完成之前不会创建新作业。 如果上一个作业未在新的 recurrenceInterval 的 startWindow 时段内完成,则不会为此间隔计划任何新作业。 对于定期作业,通常应在 jobSpecification 中指定 jobManagerTask。 如果不使用 jobManagerTask,则需要一个外部进程来监视作业的创建时间,将任务添加到作业并终止为下一个重复周期准备的作业。 默认情况下,计划不会重复:在 doNotRunUntil 时间后的 startWindow 内创建一个作业,一旦该作业完成,计划就会完成。 最小值为 1 分钟。 如果指定较低的值,Batch 服务将拒绝计划并出现错误;如果直接调用 REST API,则 HTTP 状态代码为 400 (错误) 。 预期格式为 ISO-8601 持续时间。

--required-slots

任务运行所需的计划槽数。 默认值为 1。 只有当该节点有足够的可用计划槽时,才能将任务计划为在计算节点上运行。 对于多实例任务,它必须为 1。

--start-window

时间间隔,从计划指示应创建作业的时间开始,必须在该时间间隔内创建作业。 如果未在 startWindow 间隔内创建作业,则"机会"将丢失;在计划的下一个重复周期之前不会创建作业。 如果计划是重复的,并且 startWindow 长于重复间隔,则这等效于无限 startWindow,因为一个 recurrenceInterval 中为"due"的作业不会前滚到下一个重复周期间隔。 默认值为 infinite。 最小值为 1 分钟。 如果指定较低的值,Batch 服务将拒绝计划并出现错误;如果直接调用 REST API,则 HTTP 状态代码为 400 (错误) 。 预期格式为 ISO-8601 持续时间。

--subscription

订阅的名称或 ID。 可以使用 配置默认订阅 az account set -s NAME_OR_ID

--uses-task-dependencies

作业中的任务是否可以定义彼此的依赖关系。 默认值为 false。 如果存在标志,为 True。

az batch job-schedule delete

从指定的帐户中删除作业计划。

删除作业计划时,也会删除该计划下的所有作业和任务。 删除任务时,还会删除计算节点上其工作目录中的所有文件, (将忽略保留期) 。 删除作业计划后,将不再可访问作业计划统计信息,尽管它们仍计入帐户生存期统计信息。

az batch job-schedule delete --job-schedule-id
                             [--account-endpoint]
                             [--account-key]
                             [--account-name]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--subscription]
                             [--yes]

必需参数

--job-schedule-id

要删除的作业计划的 ID。

可选参数

--account-endpoint

Batch 服务终结点。 或者,按环境变量设置:AZURE_BATCH_ENDPOINT。

--account-key

Batch 帐户密钥。 或者,按环境变量设置:AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帐户名称。 或者,按环境变量设置:AZURE_BATCH_ACCOUNT。

--if-match

与客户端已知资源的版本关联的 ETag 值。 仅当资源的服务当前 ETag 与客户端指定的值完全匹配时,才执行该操作。

--if-modified-since

指示客户端已知资源的上次修改时间的时间戳。 仅当服务上的资源自指定时间以来已修改时才执行该操作。

--if-none-match

与客户端已知资源的版本关联的 ETag 值。 仅当资源在服务上的当前 ETag 与客户端指定的值不匹配时,才会执行该操作。

--if-unmodified-since

指示客户端已知资源的上次修改时间的时间戳。 仅当服务上的资源自指定时间以来未修改时才会执行该操作。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

--yes -y

不提示确认。

az batch job-schedule disable

禁用作业计划。

重新启用作业计划之前,不会创建新作业。

az batch job-schedule disable --job-schedule-id
                              [--account-endpoint]
                              [--account-key]
                              [--account-name]
                              [--if-match]
                              [--if-modified-since]
                              [--if-none-match]
                              [--if-unmodified-since]
                              [--subscription]

必需参数

--job-schedule-id

要禁用的作业计划的 ID。

可选参数

--account-endpoint

批处理服务终结点。 或者,通过环境变量设置: AZURE_BATCH_ENDPOINT。

--account-key

Batch 帐户密钥。 或者,通过环境变量设置: AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帐户名称。 或者,通过环境变量设置: AZURE_BATCH_ACCOUNT。

--if-match

与客户端已知资源的版本关联的 ETag 值。 仅当资源的服务当前 ETag 与客户端指定的值完全匹配时,才执行该操作。

--if-modified-since

指示客户端已知资源的上次修改时间的时间戳。 仅当服务上的资源自指定时间以来已修改时才执行该操作。

--if-none-match

与客户端已知资源的版本关联的 ETag 值。 仅当资源在服务上的当前 ETag 与客户端指定的值不匹配时,才会执行该操作。

--if-unmodified-since

指示客户端已知资源的上次修改时间的时间戳。 仅当服务上的资源自指定时间以来未修改时才会执行该操作。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

az batch job-schedule enable

启用作业计划。

az batch job-schedule enable --job-schedule-id
                             [--account-endpoint]
                             [--account-key]
                             [--account-name]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--subscription]

必需参数

--job-schedule-id

要启用的作业计划的 ID。

可选参数

--account-endpoint

批处理服务终结点。 或者,通过环境变量设置: AZURE_BATCH_ENDPOINT。

--account-key

Batch 帐户密钥。 或者,通过环境变量设置: AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帐户名称。 或者,通过环境变量设置: AZURE_BATCH_ACCOUNT。

--if-match

与客户端已知资源的版本关联的 ETag 值。 仅当资源的服务当前 ETag 与客户端指定的值完全匹配时,才执行该操作。

--if-modified-since

指示客户端已知资源的上次修改时间的时间戳。 仅当服务上的资源自指定时间以来已修改时才执行该操作。

--if-none-match

与客户端已知资源的版本关联的 ETag 值。 仅当资源在服务上的当前 ETag 与客户端指定的值不匹配时,才会执行该操作。

--if-unmodified-since

指示客户端已知资源的上次修改时间的时间戳。 仅当服务上的资源自指定时间以来未修改时才会执行该操作。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

az batch job-schedule list

列出指定帐户中的所有作业计划。

az batch job-schedule list [--account-endpoint]
                           [--account-key]
                           [--account-name]
                           [--expand]
                           [--filter]
                           [--query-examples]
                           [--select]
                           [--subscription]

可选参数

--account-endpoint

批处理服务终结点。 或者,通过环境变量设置: AZURE_BATCH_ENDPOINT。

--account-key

Batch 帐户密钥。 或者,通过环境变量设置: AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帐户名称。 或者,通过环境变量设置: AZURE_BATCH_ACCOUNT。

--expand

OData $expand 子句。

--filter

OData $filter 子句。 有关构造此筛选器的详细信息,请参阅 https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-job-schedules

--query-examples

建议 JMESPath 字符串。 可以复制其中一个查询,然后将其粘贴在双引号内,以查看结果。 您可以添加一个或多个位置关键字,以便我们可以根据这些关键字提供建议。

--select

OData $select 子句。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

az batch job-schedule reset

重置作业计划的属性。 更新的作业规范仅适用于新作业。

az batch job-schedule reset --job-schedule-id
                            [--account-endpoint]
                            [--account-key]
                            [--account-name]
                            [--do-not-run-after]
                            [--do-not-run-until]
                            [--if-match]
                            [--if-modified-since]
                            [--if-none-match]
                            [--if-unmodified-since]
                            [--job-manager-task-application-package-references]
                            [--job-manager-task-command-line]
                            [--job-manager-task-environment-settings]
                            [--job-manager-task-id]
                            [--job-manager-task-resource-files]
                            [--job-metadata]
                            [--json-file]
                            [--metadata]
                            [--on-all-tasks-complete {noaction, terminatejob}]
                            [--pool-id]
                            [--priority]
                            [--recurrence-interval]
                            [--required-slots]
                            [--start-window]
                            [--subscription]
                            [--uses-task-dependencies]

必需参数

--job-schedule-id

要更新的作业计划的 ID。

可选参数

--account-endpoint

批处理服务终结点。 或者,通过环境变量设置: AZURE_BATCH_ENDPOINT。

--account-key

Batch 帐户密钥。 或者,通过环境变量设置: AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帐户名称。 或者,通过环境变量设置: AZURE_BATCH_ACCOUNT。

--do-not-run-after

一个时间,在此时间之后,将不会在此作业计划下创建作业。 此计划将在此截止时间结束后立即转换为 "已完成" 状态,并且此作业计划下没有活动的作业。 如果未指定 doNotRunAfter 时间,并且要创建定期作业计划,则作业计划将保持活动状态,直到你显式终止它。 预期格式为 ISO-8601 时间戳。

--do-not-run-until

在此作业计划下可能创建任何作业的最早时间。 如果未指定 doNotRunUntil 时间,则计划会立即开始创建作业。 预期格式为 ISO-8601 时间戳。

--if-match

与客户端已知资源的版本关联的 ETag 值。 仅当资源的服务当前 ETag 与客户端指定的值完全匹配时,才执行该操作。

--if-modified-since

指示客户端已知资源的上次修改时间的时间戳。 仅当服务上的资源自指定时间以来已修改时才执行该操作。

--if-none-match

与客户端已知资源的版本关联的 ETag 值。 仅当资源在服务上的当前 ETag 与客户端指定的值不匹配时,才会执行该操作。

--if-unmodified-since

指示客户端已知资源的上次修改时间的时间戳。 仅当服务上的资源自指定时间以来未修改时才会执行该操作。

--job-manager-task-application-package-references

批处理服务在运行命令行之前将部署到计算节点的应用程序包的列表。 下载应用程序包并将其部署到共享目录,而不是任务工作目录。 因此,如果引用的应用程序包已在计算节点上,并且是最新的,则不会重新下载它;使用计算节点上的现有副本。 如果无法安装引用的应用程序包(例如,由于包已被删除或者下载失败,则该任务将失败)。 采用 "id [#version]" 格式的可选版本的空格分隔应用程序 Id。

--job-manager-task-command-line

必需。 作业管理器任务的命令行。 命令行不在 shell 下运行,因此无法利用 shell 功能,例如环境变量扩展。 如果要利用此类功能,应在命令行中调用 shell,例如,在 Linux 中的 Windows 或 "/bin/sh-c MyCommand" 中使用 "cmd/c MyCommand"。 如果命令行引用文件路径,则它应使用相对路径 (相对于任务工作目录) ,或使用 (批处理提供的环境变量 https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables) 。

--job-manager-task-environment-settings

作业管理器任务的环境变量设置列表。 "键 = 值" 格式的空格分隔值。

--job-manager-task-id

必需。 一个字符串,用于唯一标识作业中的作业管理器任务。 该 ID 可以包含字母数字字符(包括连字符和下划线)的任意组合,并且不能包含超过 64 个字符。

--job-manager-task-resource-files

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

--job-metadata

与此计划下创建的每个作业关联的名称/值对的列表作为元数据。 Batch 服务不会向元数据分配任何含义;它仅用于使用用户代码。 "key=value"格式的空格分隔值。

--json-file

包含 JSON 格式的作业计划更新参数规范 (格式,以匹配相应的REST API正文) 。 如果指定了此参数,则忽略所有"作业计划参数"。

--metadata

与作为元数据的作业计划关联的名称/值对的列表。 如果不指定此元素,它将采用空列表的默认值;实际上,将删除任何现有元数据。 "key=value"格式的空格分隔值。

--on-all-tasks-complete

当在此计划下创建的作业中所有任务都为已完成时,Batch 服务应执行的操作。 请注意,如果作业不包含任何任务,则所有任务都被视为已完成。 因此,此选项最常用于作业管理器任务;如果要在不使用作业管理器的情况下使用自动作业终止,应首先将 onAllTasksComplete 设置为 noaction,并更新作业属性,以在添加任务后将 onAllTasksComplete 设置为 terminatejob。 默认值为 noaction。

接受的值: noaction, terminatejob
--pool-id

现有池的 ID。 作业的所有任务都将在指定的池中运行。

--priority

在此计划下创建的作业的优先级。 优先级值的范围为 -1000 到 1000,-1000 表示最低优先级,1000 表示最高优先级。 默认值为 0。 此优先级用作"作业计划"下所有作业的默认优先级。 使用更新作业 API 创建作业后,可以更新作业的优先级。

--recurrence-interval

作业计划下两个连续作业的开始时间之间的时间间隔。 在任意给定时间,作业计划下最多只能有一个活动作业。 由于作业计划在任意给定时间下最多只能有一个活动作业,因此,如果是在作业计划下创建新作业,但上一个作业仍在运行,则 Batch 服务在上一个作业完成之前不会创建新作业。 如果上一个作业未在新的 recurrenceInterval 的 startWindow 时段内完成,则不会为此间隔计划任何新作业。 对于定期作业,通常应在 jobSpecification 中指定 jobManagerTask。 如果不使用 jobManagerTask,则需要一个外部进程来监视作业的创建时间,将任务添加到作业并终止为下一个重复周期准备的作业。 默认情况下,计划不会重复:在 doNotRunUntil 时间后的 startWindow 内创建一个作业,一旦该作业完成,计划就会完成。 最小值为 1 分钟。 如果指定较低的值,Batch 服务将拒绝计划并出现错误;如果直接调用 REST API,则 HTTP 状态代码为 400 (错误) 。 预期格式为 ISO-8601 持续时间。

--required-slots

任务运行所需的计划槽数。 默认值为 1。 只有当该节点有足够的可用计划槽时,才能将任务计划为在计算节点上运行。 对于多实例任务,它必须为 1。

--start-window

时间间隔,从计划指示应创建作业的时间开始,必须在该时间间隔内创建作业。 如果未在 startWindow 间隔内创建作业,则"机会"将丢失;在计划的下一个重复周期之前不会创建作业。 如果计划是重复的,并且 startWindow 长于重复间隔,则这等效于无限 startWindow,因为一个 recurrenceInterval 中为"due"的作业不会前滚到下一个重复周期间隔。 默认值为 infinite。 最小值为 1 分钟。 如果指定较低的值,Batch 服务将拒绝计划并出现错误;如果直接调用 REST API,则 HTTP 状态代码为 400 (错误) 。 预期格式为 ISO-8601 持续时间。

--subscription

订阅的名称或 ID。 可以使用 配置默认订阅 az account set -s NAME_OR_ID

--uses-task-dependencies

作业中的任务是否可以定义彼此的依赖关系。 默认值为 false。 如果存在标志,为 True。

az batch job-schedule set

更新作业计划的属性。

可以独立更新计划与作业规范,但对其中任一实体的任何更改都将重置该实体的所有属性。

az batch job-schedule set --job-schedule-id
                          [--account-endpoint]
                          [--account-key]
                          [--account-name]
                          [--do-not-run-after]
                          [--do-not-run-until]
                          [--if-match]
                          [--if-modified-since]
                          [--if-none-match]
                          [--if-unmodified-since]
                          [--job-manager-task-application-package-references]
                          [--job-manager-task-command-line]
                          [--job-manager-task-environment-settings]
                          [--job-manager-task-id]
                          [--job-manager-task-resource-files]
                          [--job-metadata]
                          [--json-file]
                          [--metadata]
                          [--on-all-tasks-complete {noaction, terminatejob}]
                          [--pool-id]
                          [--priority]
                          [--recurrence-interval]
                          [--required-slots]
                          [--start-window]
                          [--subscription]
                          [--uses-task-dependencies]

必需参数

--job-schedule-id

要更新的作业计划的 ID。

可选参数

--account-endpoint

Batch 服务终结点。 或者,按环境变量设置:AZURE_BATCH_ENDPOINT。

--account-key

Batch 帐户密钥。 或者,按环境变量设置:AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帐户名称。 或者,按环境变量设置:AZURE_BATCH_ACCOUNT。

--do-not-run-after

在此时间之后,不会在此作业计划下创建作业。 一旦此截止时间过去,并且此作业计划下没有活动的作业,计划就会进入已完成状态。 如果未指定 doNotRunAfter 时间,并且要创建定期作业计划,则作业计划将保持活动状态,直到显式终止它。 预期格式为 ISO-8601 时间戳。

--do-not-run-until

在此作业计划下可创建任何作业的最早时间。 如果未指定 doNotRunUntil 时间,计划将立即准备好创建作业。 预期格式为 ISO-8601 时间戳。

--if-match

与客户端已知的资源版本关联的 ETag 值。 只有在服务上的资源当前 ETag 与客户端指定的值完全匹配时,才执行该操作。

--if-modified-since

一个时间戳,指示客户端已知的资源的上次修改时间。 只有当服务上的资源自指定时间以来已修改时,才执行该操作。

--if-none-match

与客户端已知的资源版本关联的 ETag 值。 只有在服务上的资源当前 ETag 与客户端指定的值不匹配时,才执行该操作。

--if-unmodified-since

一个时间戳,指示客户端已知的资源的上次修改时间。 只有在指定时间后未修改服务上的资源时,才执行该操作。

--job-manager-task-application-package-references

Batch 服务在运行命令行之前将部署到计算节点的应用程序包的列表。 应用程序包将下载并部署到共享目录,而不是任务工作目录。 因此,如果引用的应用程序包已在计算节点上,并且是最新的,则不重新下载它;使用计算节点上的现有副本。 如果无法安装引用的应用程序包,例如,由于包已删除或下载失败,任务将失败。 以空格分隔的应用程序 ID,其可选版本采用"id[#version]"格式。

--job-manager-task-command-line

必需。 作业管理器任务的命令行。 命令行不在 shell 下运行,因此无法利用 shell 功能,如环境变量扩展。 若要利用此类功能,应在命令行中调用 shell,例如,使用 Windows 中的"cmd /c MyCommand"或 Linux 中的"/bin/sh -c MyCommand"。 如果命令行引用文件路径,则它应当使用相对于任务 (目录的相对路径) ,或使用 Batch 提供的环境变量 https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables) (。

--job-manager-task-environment-settings

作业管理器任务的环境变量设置列表。 "key=value"格式的空格分隔值。

--job-manager-task-id

必需。 一个字符串,用于唯一标识作业中的作业管理器任务。 该 ID 可以包含字母数字字符(包括连字符和下划线)的任意组合,并且不能包含超过 64 个字符。

--job-manager-task-resource-files

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

--job-metadata

与在此计划中创建的每个作业关联的名称-值对的列表,作为元数据。 Batch 服务不将任何意义分配给元数据;它仅用于用户代码。 "键 = 值" 格式的空格分隔值。

--json-file

包含 JSON 格式的作业计划修补参数规范的文件 (设置格式,以匹配相应的 REST API 正文) 。 如果指定此参数,则将忽略所有 "作业计划参数"。

--metadata

作为元数据与作业计划关联的名称/值对的列表。 如果未指定此元素,现有元数据将保持不变。 "键 = 值" 格式的空格分隔值。

--on-all-tasks-complete

在此计划中创建的作业中的所有任务都处于 "已完成" 状态时,批处理服务应执行的操作。 请注意,如果作业不包含任务,则所有任务都被视为完成。 因此,此选项通常与作业管理器任务一起使用;如果要在不使用作业管理器的情况下使用自动作业终止,最初应将 onAllTasksComplete 设置为 noaction,并更新作业属性,以便在完成添加任务后,将 onAllTasksComplete 设置为 terminatejob。 默认值为 noaction。

接受的值: noaction, terminatejob
--pool-id

现有池的 id。 作业的所有任务将在指定的池上运行。

--priority

此计划下创建的作业的优先级。 优先级值的范围为 -1000 到 1000,-1000 表示最低优先级,1000 表示最高优先级。 默认值为 0。 此优先级用作作业计划下所有作业的默认优先级。 使用更新作业 API 在创建作业后,可以使用更新作业 API 来更新作业的优先级。

--recurrence-interval

作业计划下两个连续作业的开始时间之间的时间间隔。 在任意给定时间,作业计划最多只能有一个活动作业。 因为在任何给定时间,作业计划在其下最多只能有一个活动作业,因此,如果在作业计划下创建新作业,但上一个作业仍在运行,则在上一个作业完成之前,批处理服务将不会创建新作业。 如果上一个作业未在新 recurrenceInterval 的 startWindow 期内完成,则将不会为该间隔计划新作业。 对于定期作业,通常应在 jobSpecification 中指定 Microsoft.azure.batch.jobmanagertask。 如果不使用 Microsoft.azure.batch.jobmanagertask,则需要一个外部进程来监视作业的创建时间,将任务添加到作业中,并为下一次定期终止准备作业。 默认情况下,计划不会重复:在 doNotRunUntil 时间之后的 startWindow 中创建一个作业,并且该作业完成后,计划将立即完成。 最小值为1分钟。 如果指定较小的值,批处理服务将拒绝出现错误的计划;如果直接调用 REST API,HTTP 状态代码为 400 (请求) 错误。 预期格式为 ISO-8601 持续时间。

--required-slots

任务需要运行的计划槽数。 默认值为 1。 如果该节点具有足够的可用计划槽,则只能计划在计算节点上运行该任务。 对于多实例任务,此项必须为1。

--start-window

时间间隔(从计划指出应创建作业的时间开始),在此时间间隔内必须创建作业。 如果作业未在 startWindow 间隔内创建,则 "机会" 将丢失;在计划的下一次循环之前,将不会创建作业。 如果计划重复,并且 startWindow 比重复间隔更长,则这相当于无限 startWindow,因为一个 recurrenceInterval 中的 "截止" 作业不会结转到下一个重复间隔。 默认值为 infinite。 最小值为1分钟。 如果指定较小的值,批处理服务将拒绝出现错误的计划;如果直接调用 REST API,HTTP 状态代码为 400 (请求) 错误。 预期格式为 ISO-8601 持续时间。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

--uses-task-dependencies

作业中的任务是否可定义彼此之间的依赖关系。 默认值为 false。 请指定 "true" 或 "false" 以更新属性。

az batch job-schedule show

获取有关指定作业计划的信息。

az batch job-schedule show --job-schedule-id
                           [--account-endpoint]
                           [--account-key]
                           [--account-name]
                           [--expand]
                           [--if-match]
                           [--if-modified-since]
                           [--if-none-match]
                           [--if-unmodified-since]
                           [--query-examples]
                           [--select]
                           [--subscription]

必需参数

--job-schedule-id

要获取的作业计划的 ID。

可选参数

--account-endpoint

批处理服务终结点。 或者,通过环境变量设置: AZURE_BATCH_ENDPOINT。

--account-key

Batch 帐户密钥。 或者,通过环境变量设置: AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帐户名称。 或者,通过环境变量设置: AZURE_BATCH_ACCOUNT。

--expand

OData $expand 子句。

--if-match

与客户端已知资源的版本关联的 ETag 值。 仅当资源的服务当前 ETag 与客户端指定的值完全匹配时,才执行该操作。

--if-modified-since

指示客户端已知资源的上次修改时间的时间戳。 仅当服务上的资源自指定时间以来已修改时才执行该操作。

--if-none-match

与客户端已知资源的版本关联的 ETag 值。 仅当资源在服务上的当前 ETag 与客户端指定的值不匹配时,才会执行该操作。

--if-unmodified-since

指示客户端已知资源的上次修改时间的时间戳。 仅当服务上的资源自指定时间以来未修改时才会执行该操作。

--query-examples

建议 JMESPath 字符串。 可以复制其中一个查询,然后将其粘贴在双引号内,以查看结果。 您可以添加一个或多个位置关键字,以便我们可以根据这些关键字提供建议。

--select

OData $select 子句。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

az batch job-schedule stop

终止作业计划。

az batch job-schedule stop --job-schedule-id
                           [--account-endpoint]
                           [--account-key]
                           [--account-name]
                           [--if-match]
                           [--if-modified-since]
                           [--if-none-match]
                           [--if-unmodified-since]
                           [--subscription]

必需参数

--job-schedule-id

要终止的作业计划的 ID。

可选参数

--account-endpoint

批处理服务终结点。 或者,通过环境变量设置: AZURE_BATCH_ENDPOINT。

--account-key

Batch 帐户密钥。 或者,通过环境变量设置: AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帐户名称。 或者,通过环境变量设置: AZURE_BATCH_ACCOUNT。

--if-match

与客户端已知资源的版本关联的 ETag 值。 仅当资源的服务当前 ETag 与客户端指定的值完全匹配时,才执行该操作。

--if-modified-since

指示客户端已知资源的上次修改时间的时间戳。 仅当服务上的资源自指定时间以来已修改时才执行该操作。

--if-none-match

与客户端已知资源的版本关联的 ETag 值。 仅当资源在服务上的当前 ETag 与客户端指定的值不匹配时,才会执行该操作。

--if-unmodified-since

指示客户端已知资源的上次修改时间的时间戳。 仅当服务上的资源自指定时间以来未修改时才会执行该操作。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID