該接口用于創建定向分組。

使用說明

僅新版定向服務菜單支持定向分組功能,如果您使用的是舊版定向服務菜單,無法使用該接口。更多信息,請參見定向服務

調試

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

請求參數

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

系統規定參數。取值:AddDirectionalGroup

GroupName String 測試分組

給定向分組設置一個名稱。

分組名稱支持中文、英文、數字及下劃線(_),長度不超過30個字符。

返回數據

名稱 類型 示例值 描述
Data Long 6

定向分組ID。

請記錄定向分組ID,后續調用其他接口,例如調用AddDirectionalCard給定向分組里導入物聯網卡時需填入定向分組ID。

RequestId String E4F94B97-1D64-4080-BFD2-67461667AA43

請求ID,阿里云為該請求生成的標識符。

ErrorMessage String 系統異常

調用失敗時,返回的錯誤信息。

Success Boolean true

是否調用成功。

  • true:調用成功。
  • false:調用失敗。
LocalizedMessage String InstanceId cannot be empty.

根據當前所在地展示對應語言的錯誤提示。

Code String 200

接口返回碼。

  • 200:調用成功。
  • 其他:調用失敗。錯誤碼詳情,請參見錯誤碼

示例

請求示例

http(s)://linkcard.aliyuncs.com/?Action=AddDirectionalGroup
&GroupName=測試分組
&公共請求參數

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<AddDirectionalGroupResponse>
    <RequestId>E4F94B97-1D64-4080-BFD2-67461667AA43</RequestId>
    <ErrorMessage>系統異常</ErrorMessage>
    <Success>true</Success>
    <LocalizedMessage>InstanceId cannot be empty.</LocalizedMessage>
    <Code>200</Code>
</AddDirectionalGroupResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "E4F94B97-1D64-4080-BFD2-67461667AA43",
  "ErrorMessage" : "系統異常",
  "Success" : true,
  "LocalizedMessage" : "InstanceId cannot be empty.",
  "Code" : "200"
}