与组件生命周期交互

使用组件生命周期 IPC 服务可以执行以下操作：

最低 SDK 版本

下表列出了与组件生命周期交互时必须使用的 Amazon IoT Device SDK 最低版本。

授权

要暂停或恢复自定义组件中的其它组件，必须定义允许组件管理其它组件的授权策略。有关定义授权策略的信息，请参阅授权组件执行IPC操作。

组件生命周期管理的授权策略具有以下属性。

IPC 服务标识符：aws.greengrass.ipc.lifecycle

授权策略示例

您可以参考以下授权策略示例，帮助您为组件配置授权策略。

{
  "accessControl": {
    "aws.greengrass.ipc.lifecycle": {
      "com.example.MyLocalLifecycleComponent:lifecycle:1": {
        "policyDescription": "Allows access to pause/resume all components.",
        "operations": [
          "aws.greengrass#PauseComponent",
          "aws.greengrass#ResumeComponent"
        ],
        "resources": [
          "*"
        ]
      }
    }
  }
}

UpdateState

更新核心设备上的组件状态。

请求

此操作的请求包含以下参数：

响应

此操作在其响应中未提供任何信息。

SubscribeToComponentUpdates

订阅即可在 Amazon IoT Greengrass Core 软件更新组件之前接收通知。该通知指定了在更新过程中 Nucleus 是否会重启。

只有当部署的组件更新策略指定通知组件时，Nucleus 才会发送更新通知。默认行为是通知组件。有关更多信息，请参阅创建部署，以及您在调用 CreateDeployment 操作时可以提供的 DeploymentComponentUpdatePolicy 对象。

此操作是一种订阅操作，您可以在其中订阅事件消息流。要使用此操作，请定义一个流响应处理程序，其中包含处理事件消息、错误和流关闭的函数。有关更多信息，请参阅 订阅IPC活动直播。

事件消息类型：ComponentUpdatePolicyEvents

请求

此操作的请求没有任何参数。

响应

此操作的响应包含以下信息：

DeferComponentUpdate

确认或推迟使用 SubscribeToComponentUpdates 发现的组件更新。您可以指定在 Nucleus 再次检查组件是否准备好让组件更新继续之前等待的时长。您也可以使用此操作告知 Nucleus 您的组件已准备好进行更新。

如果某个组件未响应组件更新通知，则 Nucleus 会按您在部署组件更新策略中指定的时间等待。超时之后，Nucleus 继续部署。组件更新超时默认值为 60 秒。有关更多信息，请参阅创建部署，以及您在调用 CreateDeployment 操作时可以提供的 DeploymentComponentUpdatePolicy 对象。

请求

此操作的请求包含以下参数：

响应

此操作在其响应中未提供任何信息。

PauseComponent

Greengrass Nucleus 组件的 v2.4.0 及更高版本中提供了此功能。Amazon IoT Greengrass 目前不支持在 Windows 核心设备上使用此功能。

暂停核心设备上的组件进程。要恢复组件，请使用 ResumeComponent 操作。

只能暂停通用组件。如果您尝试暂停任何其它类型的组件，则此操作将引发 InvalidRequestError。

此操作不会暂停组件依赖关系或依赖于您暂停的组件的组件。当暂停依赖于另一个组件的组件时，请考虑这种行为，因为依赖组件在暂停依赖关系时可能会遇到问题。

当您重启或关闭已暂停的组件时（例如通过部署），Greengrass nucleus 会恢复该组件并运行其关闭生命周期。有关重启组件的更多信息，请参阅 RestartComponent。

最低 SDK 版本

下表列出了暂停和恢复组件时必须使用的 Amazon IoT Device SDK 最低版本。

请求

此操作的请求包含以下参数：

响应

此操作在其响应中未提供任何信息。

ResumeComponent

Greengrass Nucleus 组件的 v2.4.0 及更高版本中提供了此功能。Amazon IoT Greengrass 目前不支持在 Windows 核心设备上使用此功能。

恢复核心设备上的组件进程。要暂停组件，请使用 PauseComponent 操作。

您只能恢复已暂停的组件。如果您尝试恢复未暂停的组件，则此操作将引发 InvalidRequestError。

最低 SDK 版本

下表列出了暂停和恢复组件时必须使用的 Amazon IoT Device SDK 最低版本。

请求

此操作的请求包含以下参数：

响应

此操作在其响应中未提供任何信息。