すべてのプロダクト
Search

このプロダクト

    IoT Platform:CreateTopicRouteTable

    ドキュメントセンター

    IoT Platform:CreateTopicRouteTable

    最終更新日:Apr 17, 2025

    トピック間のメッセージルーティング関係を確立します。

    制限

    • ソース トピックに対して最大 100 個の宛先トピックを指定できます。
    • ソース トピックが属するデバイスはアクティブ化されている必要があります。
    • ソース トピックと宛先トピックはカスタム トピックのみをサポートします。
    • 各 Alibaba Cloud アカウントは、最大 50 クエリ/秒（QPS）を実行できます。
      説明 Alibaba Cloud アカウントの RAM ユーザーは、アカウントのクォータを共有します。

    デバッグ

    Alibaba Cloud は、API の使用を簡素化するために OpenAPI Explorer を提供しています。OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。OpenAPI Explorer は、さまざまな SDK 用の操作のサンプルコードを動的に生成します。

    リクエストパラメーター

    パラメーター型必須例説明
    ActionStringはいCreateTopicRouteTable

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

    DstTopic.NRepeatListはい/x7aWKW9****/deviceNameTest1/user/add

    宛先トピックのリスト。SrcTopic パラメーターで指定されたソース トピックに、宛先トピックがサブスクライブします。宛先トピックを 1 つだけ指定する場合でも、配列データ型を使用します。例：DstTopic.1=/x7aWKW9****/deviceNameTest1/user/add および DstTopic.2=/x7aWKW9****/deviceNameTest2/user/delete。

    SrcTopicStringはい/x7aWKW9****/testDataToDataHub/user/update

    ソース トピック。例：SrcTopic=/x7aWKW9 ****** /testDataToDataHub/user/update。

    IotInstanceIdStringいいえiot-cn-0pp1n8t****

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

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

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

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

    レスポンスパラメーター

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

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

    ErrorMessageStringiot.system.SystemException

    呼び出しが失敗した場合に返されるエラーメッセージ。

    FailureTopicsList["/2Fx7aWKW9****/FdeviceNameTest2/user/delete"]

    呼び出しが失敗した場合に返されるトピックのリスト。

    IsAllSucceedBooleantrue

    トピック間のすべてのメッセージルーティング関係が確立されているかどうかを示します。

    • true: トピック間のすべてのメッセージルーティング関係が確立されています。
    • false: トピック間のすべてのメッセージルーティング関係が確立されているわけではありません。
    RequestIdStringFCC27691-9151-4B93-9622-9C90F30542EC

    リクエストの ID。

    SuccessBooleantrue

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

    • true: 呼び出しは成功しました。
    • false: 呼び出しは失敗しました。

    例

    リクエストの例

    https://iot.cn-shanghai.aliyuncs.com/?Action=CreateTopicRouteTable
&SrcTopic=%2Fx7aWKW9****%2FtestDataToDataHub%2Fuser%2Fupdate
&DstTopic.1=%2Fx7aWKW9****%2FdeviceNameTest1%2Fuser%2Fadd
&DstTopic.2=%2Fx7aWKW9****%2FdeviceNameTest2%2Fuser%2Fdelete
&<共通リクエストパラメーター>

    成功レスポンスの例

    XML 形式

    <CreateTopicRouteTableResponse>
  <RequestId>32B9828A-25DD-48E2-8E26-D1664B341940</RequestId>
  <FailureTopics></FailureTopics>
  <Success>true</Success>
</CreateTopicRouteTableResponse>

    JSON 形式

    {
    "RequestId": "32B9828A-25DD-48E2-8E26-D1664B341940",
    "FailureTopics": {
        "Topic": []
    },
    "Success": true
}

    エラーコード

    エラーコードの一覧については、API エラーセンターをご覧ください。