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

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

仅限 Edge APIs ,适用于边缘设备 Amazon IoT SiteWise

除了边缘上可用的之外,还有一些特定于边缘的。 Amazon IoT SiteWise APIs 这些边缘特定的内容如下 APIs 所述。

身份验证

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

请求语法

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

URI 请求参数

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

请求正文

请求接受采用 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 才能使用临时凭证的令牌。

类型:字符串

区域

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

类型:常量 — edge

错误

IllegalArgumentException

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

HTTP 状态代码:400

AccessDeniedException

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

HTTP 状态代码:403

TooManyRequestsException

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

HTTP 状态代码:429