仅适用于边缘设备的 API,适用于 Amazon IoT SiteWise 边缘设备 - Amazon IoT SiteWise
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

仅适用于边缘设备的 API,适用于 Amazon IoT SiteWise 边缘设备

除了边缘上可用的 Amazon IoT SiteWise API,还有边缘特定的 API。这些边缘特定的 API 如下所述。

身份验证

从 SiteWise Edge 网关获取证书。您需要添加本地用户或使用 LDAP 或 Linux 用户群体连接到您的系统。有关添加用户的更多信息,请参阅 LDAPLinux 用户群体

请求语法

POST /authenticate HTTP/1.1 Content-type: application/json { "username": "string", "password": "string", "authMechanism": "string" }

URI 请求参数

该请求不使用任何 URI 参数。

Request body

请求接受采用 JSON 格式的以下数据。

username

用于验证请求调用的用户名。

类型:字符串

必需:是

password

请求凭证的用户密码。

类型:字符串

必需:是

authMechanism

在主机中验证此用户的身份验证方法。

类型:字符串

有效值:ldaplinuxwinnt

必需:是

响应语法

HTTP/1.1 200 Content-type: application/json { "accessKeyId": "string", "secretAccessKey": "string", "sessionToken": "string", "region": "edge" }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

以下数据以 JSON 格式返回。

accessKeyId

用于标识临时安全凭证的访问密钥 ID。

长度限制:最小长度为 16。长度上限为 128。

模式:[\w]*

secretAccessKey

用于签署请求的秘密访问密钥。

类型:字符串

sessionToken

用户必须传递给服务 API 才能使用临时凭证的令牌。

类型:字符串

region

您针对 API 调用的目标区域。

类型:常量 — edge

错误

IllegalArgumentException

由于提供的正文文件格式错误,请求被拒绝。错误消息描述了具体的错误。

HTTP 状态代码:400

AccessDeniedException

根据当前的身份提供商,用户无有效凭证。错误消息描述了身份验证机制。

HTTP 状态代码:403

TooManyRequestsException

该请求已达到身份验证尝试次数上限。错误消息包含等待进行新身份验证尝试的时间。

HTTP 状态代码:429