与组件生命周期交互

使用组件生命周期 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 才会发送更新通知。默认行为是通知组件。有关更多信息，请参阅创建部署以及您在调用CreateDeployment操作时可以提供的DeploymentComponentUpdatePolicy对象。

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

事件消息类型：ComponentUpdatePolicyEvents

请求

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

响应

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

DeferComponentUpdate

确认或推迟您发现的组件更新SubscribeToComponentUpdates。您可以指定在组件是否准备好让组件更新继续进行之前等待的时间。您也可以使用此操作告诉 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必须使用的最低版本。

请求

此操作的请求具有以下参数：

响应

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