本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
截止日期云活动详细信息参考
来自 AWS 服务的所有事件都有一组通用字段,其中包含有关事件的元数据,例如作为事件源的 AWS 服务、事件生成时间、事件发生的账户和地区等。有关这些常规字段的定义,请参阅《Amazon EventBridge 用户指南》中的事件结构参考。
此外,每个事件都有一个 detail 字段,其中包该特定事件专有的数据。以下参考资料定义了各种 Deadline Cloud 事件的详细字段。
在使用 EventBridge 选择和管理 Deadline Cloud 事件时,记住以下几点很有用:
-
截止日期云中所有事件的
source字段均设置为aws.deadline。 -
detail-type字段指定事件类型。例如
Fleet Size Recommendation Change。 -
detail字段包含该特定事件专有的数据。
有关构造事件模式以使规则能够匹配 Deadline Cloud 事件的信息,请参阅《Amazon EventBridge 用户指南》中的事件模式。
有关事件及其 EventBridge 处理方式的更多信息,请参阅《Amazon EventBridge 用户指南》中的Amazon EventBridge 事件。
已达到预算阈值事件
您可以使用 “已达到预算阈值” 事件来监控已用预算的百分比。当使用的百分比超过以下阈值时,Deadline Cloud 会发送事件:
-
10、20、30、40、50、60、70、75、80、85、90、95、96、97、98、99、100
随着预算接近上限,Deadline Cloud 发送已达到预算阈值事件的频率会增加。这种频率使您能够在预算接近限额时密切监控预算,并采取措施防止超支。您也可以设置自己的预算阈值。当使用量超过您的自定义阈值时,Deadline Cloud 会发送一个事件。
如果您更改预算金额,则下次 Deadline Cloud 发送 “已达到预算阈值” 事件时,该事件将基于当前使用的预算百分比。例如,如果您在已达到上限的 100 美元预算中加入 50 美元,则下一次 “已达到预算阈值” 事件表明预算为 75%。
以下是 Budget Threshold Reached 事件的详细信息字段。
source和detail-type字段之所以包含在下面,是因为它们包含截止日期云事件的特定值。有关所有事件中包含的其他元数据字段的定义,请参阅《Amazon EventBridge 用户指南》中的事件结构参考。
{ "version": "0", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "detail-type": "Budget Threshold Reached", "source": "aws.deadline", "account": "111122223333", "time": "2017-12-22T18:43:48Z", "region": "aa-example-1", "resources": [], "detail": { "farmId": "farm-12345678900000000000000000000000", "budgetId": "budget-12345678900000000000000000000000", "thresholdInPercent": 0 } }
detail-type-
标识事件的类型。
对于这一事件,此值为
Budget Threshold Reached。 source-
标识生成事件的服务。对于 Deadline Cloud 活动,此值为
aws.deadline。 detail-
包含关于事件信息的 JSON 对象。生成事件的服务决定该字段的内容。
对于此事件,此数据包括:
farmId-
包含任务的农场的标识符。
budgetId-
已达到阈值的预算标识符。
thresholdInPercent-
已使用的预算百分比。
舰队规模建议变更活动
当您将队列配置为使用基于事件的自动扩展时,Deadline Cloud 会发出可用于管理队列的事件。这些事件都包含有关舰队当前规模和请求规模的信息。有关使用 EventBridge 事件和示例 Lambda 函数处理事件的示例,请参阅使用 Deadline 云规模推荐功能https://docs.aws.amazon.com/deadline-cloud/latest/userguide/create-auto-scaling.html#autoscale-ec2-fleet自动扩展您的 Amazon EC2 队列。
发生以下情况时,将发送舰队规模建议更改事件:
-
当建议的舰队规模发生变化且旧FleetSize 机队规模与新舰队规模不同时FleetSize。
-
当服务检测到实际机队规模与建议的舰队规模不匹配时。你可以从 GetFleet 操作响应中的 workerCount 中获得实际的舰队规模。当活动的 Amazon EC2 实例未能注册为 Deadline Cloud 工作者时,可能会发生这种不匹配。
以下是 Fleet Size Recommendation Change 事件的详细信息字段。
source和detail-type字段之所以包含在下面,是因为它们包含截止日期云事件的特定值。有关所有事件中包含的其他元数据字段的定义,请参阅《Amazon EventBridge 用户指南》中的事件结构参考。
{ "version": "0", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "detail-type": "Fleet Size Recommendation Change", "source": "aws.deadline", "account": "111122223333", "time": "2017-12-22T18:43:48Z", "region": "aa-example-1", "resources": [], "detail": { "farmId": "farm-12345678900000000000000000000000", "fleetId": "fleet-12345678900000000000000000000000", "oldFleetSize": 1, "newFleetSize": 5 } }
detail-type-
标识事件的类型。
对于这一事件,此值为
Fleet Size Recommendation Change。 source-
标识生成事件的服务。对于 Deadline Cloud 活动,此值为
aws.deadline。 detail-
包含关于事件信息的 JSON 对象。生成事件的服务决定该字段的内容。
对于此事件,此数据包括:
farmId-
包含任务的农场的标识符。
fleetId-
需要更改大小的舰队的标识符。
oldFleetSize-
舰队目前的规模。
newFleetSize-
建议的舰队新规模。
工作生命周期状态变更事件
当您创建或更新任务时,Deadline Cloud 会设置生命周期状态以显示最近用户发起的操作的状态。
对于任何生命周期状态更改,包括任务创建时,都会发送任务生命周期状态更改事件。
以下是 Job Lifecycle Status Change 事件的详细信息字段。
source和detail-type字段之所以包含在下面,是因为它们包含截止日期云事件的特定值。有关所有事件中包含的其他元数据字段的定义,请参阅《Amazon EventBridge 用户指南》中的事件结构参考。
{ "version": "0", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "detail-type": "Job Lifecycle Status Change", "source": "aws.deadline", "account": "111122223333", "time": "2017-12-22T18:43:48Z", "region": "aa-example-1", "resources": [], "detail": { "farmId": "farm-12345678900000000000000000000000", "queueId": "queue-12345678900000000000000000000000", "jobId": "job-12345678900000000000000000000000", "previousLifecycleStatus": "UPDATE_IN_PROGRESS", "lifecycleStatus": "UPDATE_SUCCEEDED" } }
detail-type-
标识事件的类型。
对于这一事件,此值为
Job Lifecycle Status Change。 source-
标识生成事件的服务。对于 Deadline Cloud 活动,此值为
aws.deadline。 detail-
包含关于事件信息的 JSON 对象。生成事件的服务决定该字段的内容。
对于此事件,此数据包括:
farmId-
包含任务的农场的标识符。
queueId-
包含任务的队列的标识符。
jobId-
作业的标识符。
previousLifecycleStatus-
任务即将离职的生命周期状态。首次提交任务时不包括此字段。
lifecycleStatus-
任务正在进入的生命周期状态。
作业运行状态更改事件
一项工作由许多任务组成。每个任务都有自己的状态。将所有任务的状态组合在一起,以提供作业的总体状态。有关更多信息,请参阅《截止日期云用户指南》中的 De AWS adline Cloud 中的作业状态。
在以下情况下会发送作业运行状态更改事件:
-
组合taskRunStatus字段发生变化。
-
除非任务处于 READY 状态,否则会对该任务进行重新排序。
在以下情况下,不会发送作业运行状态更改事件:
-
首先创建任务。要监控任务的创建,请监控任务生命周期状态更改事件中是否有更改。
-
作业的taskRunStatusCounts字段发生变化,但组合作业任务的运行状态没有变化。
以下是 Job Run Status Change 事件的详细信息字段。
source和detail-type字段之所以包含在下面,是因为它们包含截止日期云事件的特定值。有关所有事件中包含的其他元数据字段的定义,请参阅《Amazon EventBridge 用户指南》中的事件结构参考。
{ "version": "0", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "detail-type": "Job Run Status Change", "source": "aws.deadline", "account": "111122223333", "time": "2017-12-22T18:43:48Z", "region": "aa-example-1", "resources": [], "detail": { "farmId": "farm-12345678900000000000000000000000", "queueId": "queue-12345678900000000000000000000000", "jobId": "job-12345678900000000000000000000000", "previousTaskRunStatus": "RUNNING", "taskRunStatus": "SUCCEEDED", "taskRunStatusCounts": { "PENDING": 0, "READY": 0, "RUNNING": 0, "ASSIGNED": 0, "STARTING": 0, "SCHEDULED": 0, "INTERRUPTING": 0, "SUSPENDED": 0, "CANCELED": 0, "FAILED": 0, "SUCCEEDED": 20, "NOT_COMPATIBLE": 0 } } }
detail-type-
标识事件的类型。
对于这一事件,此值为
Job Run Status Change。 source-
标识生成事件的服务。对于 Deadline Cloud 活动,此值为
aws.deadline。 detail-
包含关于事件信息的 JSON 对象。生成事件的服务决定该字段的内容。
对于此事件,此数据包括:
farmId-
包含任务的农场的标识符。
queueId-
包含任务的队列的标识符。
jobId-
作业的标识符。
previousTaskRunStatus-
任务运行状态为任务即将离开。
taskRunStatus-
作业进入的任务运行状态。
taskRunStatusCounts-
每种状态下任务的数量。
步骤生命周期状态更改事件
当您创建或更新事件时,Deadline Cloud 会设置任务的生命周期状态,以描述最近一次用户发起的操作的状态。
在以下情况下会发送步骤生命周期状态更改事件:
-
步骤更新开始 (UPDATE_IN_PROGRESS)。
-
步骤更新成功完成(UPDATE_SUCCEED)。
-
步骤更新失败(UPDATE_FAILED)。
首次创建该步骤时不会发送事件。要监控步骤创建,请监控任务生命周期状态变更事件中是否有更改。
以下是 Step Lifecycle Status Change 事件的详细信息字段。
source和detail-type字段之所以包含在下面,是因为它们包含截止日期云事件的特定值。有关所有事件中包含的其他元数据字段的定义,请参阅Amazon EventBridge 用户指南中的事件结构参考。
{ "version": "0", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "detail-type": "Step Lifecycle Status Change", "source": "aws.deadline", "account": "111122223333", "time": "2017-12-22T18:43:48Z", "region": "aa-example-1", "resources": [], "detail": { "farmId": "farm-12345678900000000000000000000000", "queueId": "queue-12345678900000000000000000000000", "jobId": "job-12345678900000000000000000000000", "stepId": "step-12345678900000000000000000000000", "previousLifecycleStatus": "UPDATE_IN_PROGRESS", "lifecycleStatus": "UPDATE_SUCCEEDED" } }
detail-type-
标识事件的类型。
对于这一事件,此值为
Step Lifecycle Status Change。 source-
标识生成事件的服务。对于 Deadline Cloud 活动,此值为
aws.deadline。 detail-
包含关于事件信息的 JSON 对象。生成事件的服务决定该字段的内容。
对于此事件,此数据包括:
farmId-
包含任务的农场的标识符。
queueId-
包含任务的队列的标识符。
jobId-
作业的标识符。
stepId-
当前任务步骤的标识符。
previousLifecycleStatus-
该步骤即将退出的生命周期状态。
lifecycleStatus-
该步骤正在进入的生命周期状态。
步骤运行状态更改事件
作业中的每个步骤都由许多任务组成。每个任务都有自己的状态。任务状态组合在一起以提供步骤和任务的总体状态。
在以下情况下会发送步骤运行状态更改事件:
-
合并后的taskRunStatus变化。
-
除非该步骤处于 READY 状态,否则会重新执行该步骤。
在以下情况下不发送事件:
-
首先创建该步骤。要监控步骤创建,请监控任务生命周期状态变更事件中是否有更改。
-
该步骤taskRunStatusCounts发生变化,但组合步骤任务的运行状态没有变化。
以下是 Step Run Status Change 事件的详细信息字段。
source和detail-type字段之所以包含在下面,是因为它们包含截止日期云事件的特定值。有关所有事件中包含的其他元数据字段的定义,请参阅Amazon EventBridge 用户指南中的事件结构参考。
{ "version": "0", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "detail-type": "Step Run Status Change", "source": "aws.deadline", "account": "111122223333", "time": "2017-12-22T18:43:48Z", "region": "aa-example-1", "resources": [], "detail": { "farmId": "farm-12345678900000000000000000000000", "queueId": "queue-12345678900000000000000000000000", "jobId": "job-12345678900000000000000000000000", "stepId": "step-12345678900000000000000000000000", "previousTaskRunStatus": "RUNNING", "taskRunStatus": "SUCCEEDED", "taskRunStatusCounts": { "PENDING": 0, "READY": 0, "RUNNING": 0, "ASSIGNED": 0, "STARTING": 0, "SCHEDULED": 0, "INTERRUPTING": 0, "SUSPENDED": 0, "CANCELED": 0, "FAILED": 0, "SUCCEEDED": 20, "NOT_COMPATIBLE": 0 } } }
detail-type-
标识事件的类型。
对于这一事件,此值为
Step Run Status Change。 source-
标识生成事件的服务。对于 Deadline Cloud 活动,此值为
aws.deadline。 detail-
包含关于事件信息的 JSON 对象。生成事件的服务决定该字段的内容。
对于此事件,此数据包括:
farmId-
包含任务的农场的标识符。
queueId-
包含任务的队列的标识符。
jobId-
作业的标识符。
stepId-
当前任务步骤的标识符。
previousTaskRunStatus-
该步骤将离开的运行状态。
taskRunStatus-
该步骤正在进入的运行状态。
taskRunStatusCounts-
每种状态下步骤的任务数。
任务运行状态更改事件
该runStatus字段会在任务运行时更新。在以下情况下会发送事件:
-
任务的运行状态发生变化。
-
除非任务处于 READY 状态,否则任务会被重新排队。
在以下情况下不发送事件:
-
该任务首先创建。要监控任务创建,请监控任务生命周期状态更改事件中是否有更改。
以下是 Task Run Status Change 事件的详细信息字段。
source和detail-type字段之所以包含在下面,是因为它们包含截止日期云事件的特定值。有关所有事件中包含的其他元数据字段的定义,请参阅Amazon EventBridge 用户指南中的事件结构参考。
{ "version": "0", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "detail-type": "Task Run Status Change", "source": "aws.deadline", "account": "111122223333", "time": "2017-12-22T18:43:48Z", "region": "aa-example-1", "resources": [], "detail": { "farmId": "farm-12345678900000000000000000000000", "queueId": "queue-12345678900000000000000000000000", "jobId": "job-12345678900000000000000000000000", "stepId": "step-12345678900000000000000000000000", "taskId": "task-12345678900000000000000000000000-0", "previousRunStatus": "RUNNING", "runStatus": "SUCCEEDED" } }
detail-type-
标识事件的类型。
对于这一事件,此值为
Fleet Size Recommendation Change。 source-
标识生成事件的服务。对于 Deadline Cloud 活动,此值为
aws.deadline。 detail-
包含关于事件信息的 JSON 对象。生成事件的服务决定该字段的内容。
对于此事件,此数据包括:
farmId-
包含任务的农场的标识符。
queueId-
包含任务的队列的标识符。
jobId-
作业的标识符。
- stepID
-
当前任务步骤的标识符。
taskId-
正在运行的任务的标识符。
previousRunStatus-
任务离开的运行状态。
runStatus-
任务进入的运行状态。