截止日期云活动详情参考 - 截止日期云

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

截止日期云活动详情参考

来自 AWS 服务的所有事件都有一组公共字段,其中包含有关事件的元数据,例如作为事件来源的 AWS 服务、事件的生成时间、事件发生的账户和区域等。有关这些常规字段的定义,请参阅《Amazon EventBridge 用户指南》中的事件结构参考

此外,每个事件都有一个 detail 字段,其中包该特定事件专有的数据。以下参考文献定义了各种 Deadline Cloud 事件的详细信息字段。

在使用 EventBridge 选择和管理 Deadline Cloud 事件时,请记住以下几点:

  • 来自 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字段,是因为它们包含 Deadline Cloud 事件的特定值。有关所有事件中包含的其他元数据字段的定义,请参阅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 Cl oud 规模推荐功能自动扩展您的亚马逊 EC2 舰队

发生以下情况时,将发送舰队规模建议更改事件:

  • 当建议的舰队规模发生变化 oldFleetSize 并且与之不同时 newFleetSize。

  • 当服务检测到实际舰队规模与建议的舰队规模不匹配时。您可以从 GetFleet 操作响应中的 workerCount 中获取实际的舰队规模。当活动的 Amazon EC2 实例无法注册为 Deadline Cloud 工作线程时,可能会发生这种情况。

以下是 Fleet Size Recommendation Change 事件的详细信息字段。

之所以包含sourcedetail-type字段,是因为它们包含 Deadline Cloud 事件的特定值。有关所有事件中包含的其他元数据字段的定义,请参阅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

舰队的推荐新规模。

Job 生命周期状态更改事件

当您创建或更新任务时,Deadline Cloud 会将生命周期状态设置为显示用户最近启动的操作的状态。

对于任何生命周期状态更改(包括作业的创建时间),都会发送作业生命周期状态更改事件。

以下是 Job Lifecycle Status Change 事件的详细信息字段。

之所以包含sourcedetail-type字段,是因为它们包含 Deadline Cloud 事件的特定值。有关所有事件中包含的其他元数据字段的定义,请参阅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

任务正在进入的生命周期状态。

Job 运行状态更改事件

一项作业由许多任务组成。每项任务都有一个状态。将所有任务的状态合并在一起,得出作业的总体状态。有关更多信息,请参阅 Deadline Cloud 用户指南中的 Deadlin AWS e Cloud 中的作业状态

在以下情况下会发送作业运行状态更改事件:

  • 组合taskRunStatus字段会发生变化。

  • 除非作业处于 READY 状态,否则该作业将重新排队。

在以下情况下,不会发送作业运行状态更改事件:

  • 作业是首次创建的。要监控作业的创建,请监控作业生命周期状态更改事件的更改。

  • 作业的taskRunStatusCounts字段会发生变化,但合并的作业任务运行状态不会改变。

以下是 Job Run Status Change 事件的详细信息字段。

之所以包含sourcedetail-type字段,是因为它们包含 Deadline Cloud 事件的特定值。有关所有事件中包含的其他元数据字段的定义,请参阅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_SUCEEDED)。

  • 步骤更新失败(UPDATE_FAILED)。

首次创建步骤时不会发送事件。要监控步骤的创建,请监控 Job 生命周期状态更改事件的更改。

以下是 Step Lifecycle Status Change 事件的详细信息字段。

之所以包含sourcedetail-type字段,是因为它们包含 Deadline Cloud 事件的特定值。有关所有事件中包含的其他元数据字段的定义,请参阅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

步骤正在进入的生命周期状态。

Step Run 状态更改事件

作业中的每个步骤都由许多任务组成。每项任务都有一个状态。将任务状态组合在一起,以提供步骤和作业的总体状态。

在以下情况下会发送步骤运行状态更改事件:

  • 合并后的taskRunStatus变化。

  • 除非该步骤处于 READY 状态,否则该步骤将重新排队。

在以下情况下不会发送事件:

  • 步骤是首先创建的。要监控步骤的创建,请监控 Job 生命周期状态更改事件的更改。

  • 步骤会taskRunStatusCounts发生变化,但组合步骤任务的运行状态不会改变。

以下是 Step Run Status Change 事件的详细信息字段。

之所以包含sourcedetail-type字段,是因为它们包含 Deadline Cloud 事件的特定值。有关所有事件中包含的其他元数据字段的定义,请参阅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 状态,否则该任务将重新排队。

在以下情况下不会发送事件:

  • 任务首先创建。要监控任务的创建,请监控 Job 生命周期状态更改事件的更改。

以下是 Task Run Status Change 事件的详细信息字段。

之所以包含sourcedetail-type字段,是因为它们包含 Deadline Cloud 事件的特定值。有关所有事件中包含的其他元数据字段的定义,请参阅Amazon EventBridge 用户指南中的事件结构参考

{ "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

任务正在进入的运行状态。