本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 截止日期云活动详情参考来自 AWS 服务的所有事件都有一组公共字段，其中包含有关事件的元数据，例如作为事件来源的 AWS 服务、事件的生成时间、事件发生的账户和区域等。有关这些常规字段的定义，请参阅《Amazon EventBridge 用户指南》**中的[事件结构参考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。此外，每个事件都有一个 `detail` 字段，其中包该特定事件专有的数据。以下参考文献定义了各种 Deadline Cloud 事件的详细信息字段。在使用 EventBridge 选择和管理 Deadline Cloud 事件时，请记住以下几点： + 来自 Deadline Cloud 的所有事件的`source`字段设置为`aws.deadline`。 + `detail-type` 字段指定事件类型。例如 `Fleet Size Recommendation Change`。 + `detail` 字段包含该特定事件专有的数据。有关构建事件模式以使规则与 Deadline Cloud 事件相匹配的信息，请参阅*Amazon EventBridge 用户指南*中的[事件模式](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)。有关事件及其 EventBridge 处理方式的更多信息，请参阅《*Amazon EventBridge 用户指南*》中的[Amazon EventBridge 事件](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)。 **Topics** + [已达到预算阈值事件](#event-detail-budget-threshold-reached) + [舰队规模建议变更事件](#event-detail-fleet-size-recommendation-change) + [Job 生命周期状态更改事件](#event-detail-job-lifecycle-status-change) + [Job 运行状态更改事件](#event-detail-job-run-status-change) + [步骤生命周期状态更改事件](#event-detail-step-lifecycle-status-change) + [Step Run 状态更改事件](#event-detail-step-run-status-change) + [任务运行状态更改事件](#event-detail-task-run-status-change) ## 已达到预算阈值事件您可以使用 “已达到预算阈值” 事件来监控已使用的预算百分比。当使用的百分比超过以下阈值时，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`字段，是因为它们包含 Deadline Cloud 事件的特定值。有关所有事件中包含的其他元数据字段的定义，请参阅*Amazon EventBridge 用户指南*中的[事件结构参考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。 ``` { "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 函数来处理事件的示例，请参阅使用 De [adline Cloud 规模推荐功能自动扩展您的 Amazon EC2 队列](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/create-auto-scaling.html#autoscale-ec2-fleet)。发生以下情况时，将发送舰队规模建议更改事件： + 当建议的舰队规模发生变化 oldFleetSize 并且与之不同时 newFleetSize。 + 当服务检测到实际舰队规模与建议的舰队规模不匹配时。您可以从 GetFleet 操作响应中的 workerCount 中获取实际的舰队规模。当活跃的 Amazon EC2 实例未能注册为 Deadline Cloud 工作程序时，可能会发生这种情况。以下是 `Fleet Size Recommendation Change` 事件的详细信息字段。之所以包含`source`和`detail-type`字段，是因为它们包含 Deadline Cloud 事件的特定值。有关所有事件中包含的其他元数据字段的定义，请参阅*Amazon EventBridge 用户指南*中的[事件结构参考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。 ``` { "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` 舰队的推荐新规模。 ## Job 生命周期状态更改事件当您创建或更新任务时，Deadline Cloud 会将生命周期状态设置为显示用户最近启动的操作的状态。对于任何生命周期状态更改（包括作业的创建时间），都会发送作业生命周期状态更改事件。以下是 `Job Lifecycle Status Change` 事件的详细信息字段。之所以包含`source`和`detail-type`字段，是因为它们包含 Deadline Cloud 事件的特定值。有关所有事件中包含的其他元数据字段的定义，请参阅*Amazon EventBridge 用户指南*中的[事件结构参考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。 ``` { "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` 任务正在进入的生命周期状态。 ## Job 运行状态更改事件一项作业由许多任务组成。每项任务都有一个状态。将所有任务的状态合并在一起，得出作业的总体状态。有关更多信息，请参阅 Deadline [Cloud *用户指南中的 Deadlin AWS e Cloud* 中的作业状态](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/jobs-states.html)。在以下情况下会发送作业运行状态更改事件： + 组合[taskRunStatus](#job-run-status-change-field-5)字段会发生变化。 + 除非作业处于 READY 状态，否则该作业将重新排队。在以下情况下，不会发送作业运行状态更改事件： + 作业是首次创建的。要监控作业的创建，请监控作业生命周期状态更改事件的更改。 + 作业的[taskRunStatusCounts](#job-run-status-change-field-6)字段会发生变化，但合并的作业任务运行状态不会改变。以下是 `Job Run Status Change` 事件的详细信息字段。之所以包含`source`和`detail-type`字段，是因为它们包含 Deadline Cloud 事件的特定值。有关所有事件中包含的其他元数据字段的定义，请参阅*Amazon EventBridge 用户指南*中的[事件结构参考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。 ``` { "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\$1IN\$1PROGRESS）。 + 步骤更新成功完成（UPDATE\$1SUCCELEDED）。 + 步骤更新失败（UPDATE\$1FAILED）。首次创建步骤时不会发送事件。要监控步骤的创建，请监控 Job 生命周期状态更改事件的更改。以下是 `Step Lifecycle Status Change` 事件的详细信息字段。之所以包含`source`和`detail-type`字段，是因为它们包含 Deadline Cloud 事件的特定值。有关所有事件中包含的其他元数据字段的定义，请参阅*Amazon EventBridge 用户指南*中的[事件结构参考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。 ``` { "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` 步骤正在进入的生命周期状态。 ## Step Run 状态更改事件作业中的每个步骤都由许多任务组成。每项任务都有一个状态。将任务状态组合在一起，以提供步骤和作业的总体状态。在以下情况下会发送步骤运行状态更改事件： + 合并后的[taskRunStatus](#step-run-status-change-field-6)变化。 + 除非该步骤处于 READY 状态，否则该步骤将重新排队。在以下情况下不会发送事件： + 步骤是首先创建的。要监控步骤的创建，请监控 Job 生命周期状态更改事件的更改。 + 步骤会[taskRunStatusCounts](#step-run-status-change-field-7)发生变化，但组合步骤任务的运行状态不会改变。以下是 `Step Run Status Change` 事件的详细信息字段。之所以包含`source`和`detail-type`字段，是因为它们包含 Deadline Cloud 事件的特定值。有关所有事件中包含的其他元数据字段的定义，请参阅*Amazon EventBridge 用户指南*中的[事件结构参考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。 ``` { "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](#task-run-status-change-field-7)字段将在任务运行时更新。在以下情况下会发送事件： + 任务的运行状态会发生变化。 + 除非任务处于 READY 状态，否则该任务将重新排队。在以下情况下不会发送事件： + 任务首先创建。要监控任务的创建，请监控 Job 生命周期状态更改事件是否有更改。以下是 `Task Run Status Change` 事件的详细信息字段。之所以包含`source`和`detail-type`字段，是因为它们包含 Deadline Cloud 事件的特定值。有关所有事件中包含的其他元数据字段的定义，请参阅*Amazon EventBridge 用户指南*中的[事件结构参考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。 ``` { "version": "0", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "detail-type": "Task Run Status Change", "source": "aws.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` 任务正在进入的运行状态。