調用ApplyRoamingJoinPermission申請泛在憑證。

限制說明

  • 單阿里云賬號的泛在憑證數量為一個。
  • 單阿里云賬號調用該接口的每秒請求數（QPS）最大限制為5。
說明 RAM用戶共享阿里云賬號配額。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 ApplyRoamingJoinPermission

系統規定參數。取值：ApplyRoamingJoinPermission。

ClassMode String 是 A

泛在憑證所采用的LoRaWAN Class模式。取值：A、B、C。
FreqBandPlanGroupId Long 是 102

泛在憑證所采用的頻段ID。取值：

  • 102：CN470異頻。
  • 101：CN470同頻。
  • 201：AS923同頻。
JoinPermissionName String 是 泛在憑證1

泛在憑證名稱，支持中文、英文字母、數字和下劃線（_），長度限制4～30個字符，一個中文占兩個字符。
RxDelay Long 否 1

Class A的接收窗口延遲時間，取值范圍1s~15s。
DataRate Long 否 4

當ClassMode取值為B時，設置期望下行速率，取值范圍0~5。

調用API時，除了本文介紹的該API的特有請求參數，還需傳入公共請求參數。公共請求參數說明，請參見公共參數文檔。

返回數據

名稱 類型 示例值 描述
Data String 1234

泛在憑證的ID。
RequestId String 89EF6CAA-958F-F32C-BE45-FE003C6DE097

阿里云為該請求生成的唯一標識符。
Success Boolean true

是否調用成功。返回值：

  • true：調用成功。
  • false：調用失敗。

示例

請求示例

http(s)://linkwan.cn-shanghai.aliyuncs.com/?Action=ApplyRoamingJoinPermission
&ClassMode=A
&FreqBandPlanGroupId=102
&JoinPermissionName=泛在憑證1
&<公共請求參數>

正常返回示例

XML格式 

<RequestId>89EF6CAA-958F-F32C-BE45-FE003C6DE097</RequestId>
<Success>true</Success>
<Data>123</Data>

JSON格式 

{
    "RequestId": "89EF6CAA-958F-F32C-BE45-FE003C6DE097",
    "Success": true,
    "Data": "123"
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 ForbiddenByRam User not authorized to operate on the specified resource, or this API does not support RAM. 用戶沒有執行該操作所需要的RAM權限。
400 ForbiddenByRiskControl This operation cannot be performed because of security risks. 存在安全風險，無法執行該操作
400 NonExistent The specified resource does not exist. 要操作的資源不存在。
400 ExceedRoamingJoinPermissionLimit The maximum number of roaming join permissions is exceeded. 超出漫游憑證系統限額
400 JoinPermissionNameDuplicated The specified join permission name already exists. 入網憑證名稱重復
400 InvalidName The specified name is invalid. 名稱不合法
400 InvalidFreqBandPlan The frequency band plan is invalid. 頻段計劃不可用

訪問錯誤中心查看更多錯誤碼。