すべてのプロダクト
Search

このプロダクト

    Marketplace:QueryDevice

    ドキュメントセンター

    Marketplace:QueryDevice

    最終更新日:Mar 26, 2025

    重要

    免責事項

    このページに掲載されているすべてのコンテンツは、Tuya (HK) Limited によって提供されていることにご注意ください。Alibaba Cloud は、そのようなコンテンツの真正性または正確性について、明示的または黙示的に表明または保証するものではなく、Tuya (HK) Limited が提供する製品および/またはサービスの状態、品質、耐久性、性能、信頼性、商品性、特定の目的への適合性、または権利の非侵害についても一切保証するものではありません。

    この操作を呼び出して、指定されたプロダクトのデバイスリストをクエリします。

    リクエストパラメーター

    名前

    タイプ

    必須

    サンプル値

    説明

    Action

    String

    はい

    QueryDevice

    システム定義パラメーター。値: QueryDevice。

    ProductKey

    String

    はい

    A1BwAGV * * * *

    クエリ対象のデバイスが属するプロダクトの ProductKey です。

    PageSize

    Integer

    いいえ

    10

    返された結果の各ページに表示されるレコード数を指定します。最大値は 50 です。デフォルト値は 10 です。

    CurrentPage

    Integer

    いいえ

    1

    返された結果のどのページを表示するかを指定します。デフォルト値は 1 です。

    NextToken

    String

    いいえ

    TGlzdFJlc291cm * * *

    次のページの識別子。最初のクエリでは渡す必要はありません。後続のクエリでは、前のクエリの戻り値から が必要です。 × の値が 10,000 を超える場合は、 を渡す必要があります。そうしないと、データが返されません。 NextToken場合ページサイズX [現在のページ]値が 10,000 より大きい場合は、NextToken。それ以外の場合は、データが返されません。

    注記: API を呼び出すときは、このトピックで説明されている API 固有のリクエストパラメーターに加えて、共通のリクエストパラメーターも渡す必要があります。共通のリクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

    戻りデータ

    名前

    タイプ

    サンプル値

    説明

    Code

    String

    Iot.system.SystemException

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

    Data

    DeviceInfo の配列

    呼び出しが成功した場合、デバイス情報リスト () を返します。 DeviceInfo)。

    DeviceInfo

    DeviceName

    String

    Light

    デバイス名。

    DeviceSecret

    String

    No * * * *

    デバイスキー。

    DeviceStatus

    String

    Online

    デバイス ステータス。値: ●オンライン: 機器がオンラインです。 ●オフライン: デバイスがオフラインです。 ●未アクティブ化: デバイスがアクティブ化されていません。 ●無効: デバイスが無効になっています。

    DeviceType

    String

    Lighting

    デバイスが属するプロダクトのカテゴリ。

    GmtCreate

    String

    Wed, 20-Feb-2019 02:16:09 GMT

    デバイスの作成時刻 (GMT 形式)。

    GmtModified

    String

    Wed, 20-Feb-2019 02:16:09 GMT

    デバイス情報が最後に更新された時刻 (GMT 形式)。

    IoTID

    String

    **** 00100

    デバイス ID。IoT プラットフォームがデバイスに発行した ID。デバイスの一意の識別子。

    Nickname

    String

    Intelligent lamp equipment

    デバイスのニックネーム。

    ProductKey

    String

    A1BwAGV * * * *

    デバイスが属するプロダクトの ProductKey。

    UtcCreate

    String

    2019-02-20 T02:16:09.000Z

    デバイスの作成時刻 (UTC 形式)。

    UtcModified

    String

    2019-02-20 T02:16:09.000Z

    デバイス情報が最後に更新された時刻 (UTC 形式)。

    ErrorMessage

    String

    System Exception

    呼び出しが失敗した場合に返されるエラー情報。

    NextToken

    String

    TGlzdFJlc291cm * * *

    次のページの識別子です。次のリクエストで渡して、次のページのデータを取得できます。NextToken の値が null の場合は、次のページのデータがないことを示します。

    Page

    Integer

    1

    現在のページ番号。

    PageCount

    Integer

    1

    ページの総数。

    PageSize

    Integer

    10

    1 ページあたりに表示されるデバイスの数。

    RequestID

    String

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

    このリクエストに対して生成された一意の識別子。

    Success

    Boolean

    True

    呼び出しが成功したかどうか。 ●True : 呼び出しは成功しました。 ●False : 呼び出しは失敗しました。

    Total

    Integer

    2

    デバイスの総数。

    例

    リクエスト例

    curl 'https://si-d6e8d812acb848958054.tuyacloud.com:8686/?Action=QueryDevice&SignatureNonce=32e7a9cdcb744116a594040fff3bdf42&AccessKeyId=xMr9wgwXQLhv5AUa65o03mcD&SignatureMethod=HMAC-SHA1&Timestamp=2024-11-19T08%3A35%3A11Z&ProductKey=k1ymv1DuLfE&Signature=Om8wdBXCHymhxBOhNQPThcmj3Vg%3D'

    正常な戻り値の例

    {
  "PageCount": 1,
  "NextToken":"TGlzdFJlc291cm***", // 次のページのトークン
  "Data": {
    "DeviceInfo": [
      {
        "DeviceId": "Av8NGHGtwPrH9BYG****", // デバイスID
        "DeviceName": "Av8NGHGtwPrH9BYGLMBi", // デバイス名
        "ProductKey": "a1dafDE****", // プロダクトキー
        "DeviceSecret": "d7GYhf5hfcPHDe1bXSd3n9MjO1G3****", // デバイスシークレット
        "UtcModified": "2019-02-20T02:16:09.000Z", // 最終更新日時 (UTC)
        "GmtCreate": "Wed, 20-Feb-2019 02:16:09 GMT", // 作成日時 (GMT)        "UtcCreate": "2019-02-20T02:16:09.000Z", // 作成日時 (UTC)
        "GmtModified": "Wed, 20-Feb-2019 02:16:09 GMT", // 最終更新日時 (GMT)
        "IotId": "Av8NGHGtwPrH9BYGLMBi00****", // IoT ID
        "DeviceStatus": "UNACTIVE", // デバイスステータス
        "Nickname": "SensorInShanghai" // ニックネーム
      }, 
      {
        "DeviceId": "zNIcSmWQ9BPJlmkj****", // デバイスID
        "DeviceName": "zNIcSmWQ9BPJlmkjn3H1", // デバイス名
        "ProductKey": "a1dafDE****", // プロダクトキー
        "DeviceSecret": "C27XXmC18yLIEDXvUj6FSlvgO7ag****", // デバイスシークレット
        "UtcModified": "2019-02-20T02:16:09.000Z", // 最終更新日時 (UTC)
        "GmtCreate": "Wed, 20-Feb-2019 02:16:09 GMT", // 作成日時 (GMT)
        "UtcCreate": "2019-02-20T02:16:09.000Z", // 作成日時 (UTC)
        "GmtModified": "Wed, 20-Feb-2019 02:16:09 GMT", // 最終更新日時 (GMT)
        "IotId": "zNIcSmWQ9BPJlmkjn3H100****", // IoT ID
        "DeviceStatus": "UNACTIVE", // デバイスステータス
        "Nickname": "DriverInShanghai" // ニックネーム
      }
    ]
  }, 
  "Page": 1, // 現在のページ番号
  "PageSize": 10, // 1ページあたりのデバイス数
  "RequestId": "CD9E5F99-A095-4A05-9256-D924EA3075E8", // リクエストID
  "Success": true, // 呼び出しが成功したかどうか
  "Total": 2 // デバイスの総数
}