View a markdown version of this page

截止日期云活动详细信息参考 - 截止日期云

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

截止日期云活动详细信息参考

来自 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 事件的详细信息字段。

sourcedetail-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 事件的详细信息字段。

sourcedetail-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 事件的详细信息字段。

sourcedetail-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 事件的详细信息字段。

sourcedetail-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 事件的详细信息字段。

sourcedetail-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 事件的详细信息字段。

sourcedetail-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 事件的详细信息字段。

sourcedetail-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

任务进入的运行状态。