該接口用于給物聯網卡添加標簽。

調試

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

請求參數

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

系統規定參數。取值:AddTagsToCard

Iccid String 89860321******15668

物聯網卡的ICCID。

您可在物聯網卡上查看ICCID,或者在物聯網SIM服務控制臺的卡管理頁面查看ICCID。

TagNameList Array of String 測試標簽

標簽名稱。

參數為空或者空集合的時候代表從卡上刪除所有標簽。

如標簽不存在,則會自動創建該標簽并打標。

返回數據

名稱 類型 示例值 描述
Code String 200

接口返回碼。

200:表示成功。 其它:表示錯誤碼。錯誤碼詳情,請參見錯誤碼。

Data Array of data

該卡已有標簽的集合。

TagName String 測試標簽

標簽名稱。

TagId String 14

標簽ID。

ErrorMessage String InstanceId cannot be empty.

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

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

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

Success Boolean true

是否調用成功。

true:調用成功。 false:調用失敗。

示例

請求示例

http(s)://[Endpoint]/?Action=AddTagsToCard
&Iccid=89860321******15668
&TagNameList=["測試標簽"]
&公共請求參數

正常返回示例

XML格式

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

<AddTagsToCardResponse>
    <Code>200</Code>
    <Data>
        <TagName>測試標簽</TagName>
        <TagId>14</TagId>
    </Data>
    <ErrorMessage>InstanceId cannot be empty.</ErrorMessage>
    <RequestId>E4F94B97-1D64-4080-BFD2-67461667AA43</RequestId>
    <Success>true</Success>
</AddTagsToCardResponse>

JSON格式

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

{
  "Code" : "200",
  "Data" : [ {
    "TagName" : "測試標簽",
    "TagId" : "14"
  } ],
  "ErrorMessage" : "InstanceId cannot be empty.",
  "RequestId" : "E4F94B97-1D64-4080-BFD2-67461667AA43",
  "Success" : true
}