調(diào)用RefreshDeviceCredential更新設(shè)備的訪(fǎng)問(wèn)憑證。
接口說(shuō)明
- 本接口的單用戶(hù) QPS 限制為 500 次/秒。超過(guò)限制，API 調(diào)用會(huì)被限流，這可能會(huì)影響您的業(yè)務(wù)，請(qǐng)合理調(diào)用。更多信息，請(qǐng)參見(jiàn) QPS 限制。
- 每成功調(diào)用一次 RefreshDeviceCredential 接口，都會(huì)計(jì)算為一次消息 TPS，從而影響您的計(jì)費(fèi)。詳細(xì)信息，請(qǐng)參見(jiàn)計(jì)費(fèi)說(shuō)明。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
當(dāng)前API暫無(wú)授權(quán)信息透出。
請(qǐng)求參數(shù)
| 名稱(chēng) | 類(lèi)型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ClientId | string | 是 | 需要更新訪(fǎng)問(wèn)憑證的設(shè)備的 Client ID。 | GID_test@@@test |
| InstanceId | string | 是 | 云消息隊(duì)列 MQTT 版實(shí)例的 ID，一定要和客戶(hù)端實(shí)際使用的實(shí)例 ID 匹配。您可以在控制臺(tái)實(shí)例詳情頁(yè)面獲取該 ID。 | post-cn-0pp12gl**** |
說(shuō)明
更多參數(shù)說(shuō)明請(qǐng)參見(jiàn)公共參數(shù)和服務(wù)接入點(diǎn)。
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "E4581CCF-62AF-44D9-B5B4-D1DBDC0F****",
"DeviceCredential": {
"UpdateTime": 1605541382000,
"DeviceAccessKeyId": "DC.Z5fXh9sRRVufyLi6wo****",
"CreateTime": 1605541382000,
"InstanceId": "post-cn-0pp12gl****",
"DeviceAccessKeySecret": "DC.BJMkn4eMQJK2vaApTS****",
"ClientId": "GID_test@@@test"
}
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 400 | ApplyTokenOverFlow | You have applied for tokens too many times. Please try again later. | 申請(qǐng)Token頻率過(guò)高，系統(tǒng)限流，請(qǐng)重試。 |
| 400 | CheckAccountInfoFailed | An error occurred while checking the account information by the STS token. | 解析STS Token賬號(hào)信息失敗。 |
| 400 | InstancePermissionCheckFailed | An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings. | 實(shí)例權(quán)限校驗(yàn)失敗，請(qǐng)確認(rèn)MQTT實(shí)例的所屬關(guān)系以及授權(quán)策略。 |
| 400 | ParameterCheckFailed | An error occurred while validating the parameters. The parameters may be missing or invalid. | 參數(shù)校驗(yàn)失敗，可能缺失或者傳入值非法。 |
| 400 | PermissionCheckFailed | An error occurred while validating the resource permissions. Please check the account that created the instance, topic, and GroupId, and check their permission settings. | 資源權(quán)限校驗(yàn)失敗，請(qǐng)檢查實(shí)例、Topic和Group ID的所屬權(quán)限和授權(quán)策略。 |
| 400 | InvalidParameter.%s | An error occurred while validating the parameter. The parameter may be missing or invalid. | 參數(shù)校驗(yàn)失敗，可能缺失或者傳入值非法。 |
| 404 | ApiNotSupport | The specified API is not supported. | 當(dāng)前接口不支持，請(qǐng)檢查。 |
| 500 | InternalError | An error occurred while processing your request. Try again later. | MQTT后端服務(wù)異常，請(qǐng)重試。 |
| 500 | SystemOverFlow | An error occurred while processing your request. Please try again. | 系統(tǒng)限流，請(qǐng)重試。 |
訪(fǎng)問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|
暫無(wú)變更歷史