すべてのプロダクト
Search

このプロダクト

    IoT Platform:UpdateProductTags

    ドキュメントセンター

    IoT Platform:UpdateProductTags

    最終更新日:Apr 17, 2025

    プロダクトタグを更新します。

    使用方法

    1 回の呼び出しで最大 10 個のタグを更新できます。

    重要 タグキーとタグ値を指定する必要があります。指定しないと、呼び出しは失敗します。タグ値の説明については、このトピックの「リクエストパラメーター」セクションをご参照ください。

    QPS 制限

    各 Alibaba Cloud アカウントは、毎秒最大 500 クエリ/秒（QPS）を実行できます。

    説明 Alibaba Cloud アカウントの Resource Access Management（RAM）ユーザーは、アカウントのクォータを共有します。

    デバッグ

    OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

    リクエストパラメーター

    パラメータータイプ必須例説明
    ActionStringはいUpdateProductTags

    実行する操作。値を UpdateProductTags に設定します。

    ProductKeyStringはいa1BwAGV****

    プロダクトの ProductKey。ProductKey は、IoT Platform がプロダクトに発行する GUID です。IoT Platform コンソールを使用するか、QueryProductList 操作を呼び出して、現在のアカウント内のすべてのプロダクトに関する情報を表示できます。

    IotInstanceIdStringいいえiot_instc_pu****_c*-v64********

    インスタンスの ID。IoT Platform コンソールの 概要 ページでインスタンスの ID を表示できます。

    重要
    • インスタンスに ID がある場合は、このパラメーターに ID を指定する必要があります。指定しないと、呼び出しは失敗します。
    • インスタンスに対して 概要 ページまたは ID が生成されていない場合は、このパラメーターを設定する必要はありません。

    詳細については、「概要」をご参照ください。

    ProductTag.N.TagValueStringいいえ202

    プロダクトタグの新しい値。各タグ値の長さは 1 ～ 128 文字で、文字、数字、アンダースコア（_）、ハイフン（-）を含めることができます。

    ProductTag.N.TagKeyStringいいえroom

    プロダクトタグのキー。各キーの長さは 1 ～ 30 文字で、文字、数字、ピリオド（.）を含めることができます。

    説明 指定する各タグキーは既に存在している必要があります。指定する各タグ値は一意である必要があります。

    上記の操作固有のリクエストパラメーターに加えて、この操作を呼び出すときは、共通のリクエストパラメーターを指定する必要があります。詳細については、「共通リクエストパラメーター」をご参照ください。

    レスポンスパラメーター

    パラメータータイプ例説明
    CodeStringiot.system.SystemException

    呼び出しが失敗した場合に返されるエラーコード。詳細については、「エラーコード」をご参照ください。

    ErrorMessageStringシステム例外が発生しました。

    リクエストが失敗した場合に返されるエラーメッセージ。

    InvalidProductTagsProductTag の配列

    呼び出しが失敗した場合に返される無効なプロダクトタグ。ProductTag パラメーターに詳細が含まれています。

    ProductTag
    TagKeyStringroom

    タグのキー。

    TagValueString123

    タグの値。

    RequestIdStringE55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

    リクエストの ID。

    SuccessBooleantrue

    呼び出しが成功したかどうかを示します。

    • true
    • false

    例

    リクエストの例

    https://iot.cn-shanghai.aliyuncs.com/?Action=UpdateProductTags
&ProductKey=a1h7knJ****
&ProductTag.1.TagKey=first
&ProductTag.1.TagValue=value1
&ProductTag.2.TagKey=second
&ProductTag.2.TagValue=value2
&<共通リクエストパラメーター>

    成功レスポンスの例

    XML 形式

    <UpdateProductTagsResponse>
      <RequestId>57b144cf-09fc-4916-a272-a62902d5b207</RequestId>
      <Success>true</Success>
</UpdateProductTagsResponse>

    JSON 形式

    {
  "RequestId": "92586B4B-FF78-494A-A22C-368E4293FBB7",
  "Success": true
}

    エラーコード

    エラーコードのリストについては、「サービスエラーコード」をご参照ください。