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

实现 C2C 连接器接口操作

的托管集成 AWS IoT Device Management 定义了您 AWS Lambda 必须处理的四个操作才有资格成为连接器。您的 C2C 连接器必须实现以下每项操作：

的托管集成 AWS IoT Device Management 始终通过操作调用带有 JSON 字符串负载的 Lambda 函数。 AWS Lambda invokeFunction请求操作必须在每个请求负载中包含一个operationName字段。有关更多信息，请参阅 AWS Lambda API 参考中的调用。

每次调用超时设置为两秒，如果调用失败，则将重试五次。

您为连接器实现的 Lambda 将operationName从请求有效负载中解析一个，并实现相应的功能以映射到第三方云：

public ConnectorResponse handleRequest(final ConnectorRequest request) 
        throws OperationFailedException {
    Operation operation;
    try {
        operation = Operation.valueOf(request.payload().operationName());
    } catch (IllegalArgumentException ex) {
        throw new ValidationException(
           "Unknown operation '%s'".formatted(request.payload().operationName()), 
           ex
        );
    }

    return switch (operation) {
        case ActivateUser -> activateUserManager.activateUser(request);
        case DiscoverDevices -> deviceDiscoveryManager.listDevices(request);
        case SendCommand -> sendCommandManager.sendCommand(request);
        case DeactivateUser -> deactivateUser.deactivateUser(request);
    };
}

以下示例详细介绍了来自托管集成的通用连接器请求，其中包含每个必需接口的公共字段。从示例中，您可以看到既有请求标头，又有请求负载。请求标头在每个操作接口中都很常见。

{
 	"header": {
 		"auth": { 
 			"token": “ashriu32yr97feqy7afsaf”, 
 			"type": “OAuth2.0"
 		}
 	},
 	"payload":{
 		"operationName": "AWS.SendCommand",
 		"operationVersion": "1.0",
 		"connectorId": “exampleId”,
 	…
 	}
}

默认请求标头

默认标题字段如下所示。

{
    "header": {
        "auth": {                 
            "token": string,    // end user's Access Token
            "type": ENUM ["OAuth2.0"], 
        }
    }
}

连接器托管的任何 API 都必须处理以下标头参数：

请求负载

除了常用标头外，每个请求都将有一个有效负载。虽然此有效载荷对每种操作类型都有唯一的字段，但每个有效载荷都有一组默认字段，这些字段将始终存在。

默认响应标头

每项ACK操作都将通过 AWS IoT Device Management 的托管集成进行响应，以确认您的 C2C 连接器已收到请求并开始处理请求。以下是上述回复的通用示例：

{
 	"header":{
 		"responseCode": 200 
 	},
 	"payload":{
 		"responseMessage": “Example response!”
 	}
}

每个操作响应都必须具有以下通用标头：

{
    "header": {
        "responseCode": Integer
    }
}

下表列出了默认的响应标头：

在本文档中描述的各种连接器接口和 API 架构中，都有一个responseMessage或Message字段。这是一个可选字段，用于 C2C 连接器 Lambda 来响应有关请求及其执行的任何上下文。最好是，任何导致状态码之外的错误都200应包含描述错误的消息值。

使用 API 响应 C2C 连接器操作请求 SendConnectorEvent

的托管集成要求 AWS IoT Device Management 您的连接器在每个 and 操作中都以异步方式运行AWS.SendCommand。AWS.DiscoverDevices这意味着对这些操作的初始响应只是 “确认” 您的 C2C 连接器已收到请求。

使用 SendConnectorEvent API，您的连接器应将以下列表中的事件类型发送到 for and operations，以及主动设备事件（例如手动开启和关闭灯光）。AWS.DiscoverDevices AWS.SendCommand要阅读有关这些事件类型及其用例的详细说明，请参阅实施 AWS。 DiscoverDevices 操作实施 AWS。 SendCommand 操作、和使用 SendConnectorEvent API 发送设备事件。

例如，如果您的 C2C 连接器收到DiscoverDevices请求，则 AWS IoT Device Management 的托管集成希望它与上面定义的响应格式同步响应。然后，您必须使用中实施 AWS。 DiscoverDevices 操作定义的请求结构为 DEVICE_DISCOVERY 事件调用 SendConnectorEvent API。API 调用可以在任何您有权访问 C2C 连接器 AWS 账户 Lambda 凭证的地方进行。SendConnectorEvent在 AWS IoT Device Management 的托管集成收到此事件之前，设备发现流程才会成功。