すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:PublishThingModel

最終更新日:Apr 17, 2025

プロダクトの Thing Specification Language(TSL)モデルを公開します。

使用方法

プロダクトが公開されている場合、この操作を呼び出す前に、CancelReleaseProduct 操作を呼び出してプロダクトの公開を停止する必要があります。

QPS 制限

この API 操作は、アカウントごとに 1 秒あたり最大 5 回呼び出すことができます。

説明

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

デバッグ

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

リクエストパラメーター

パラメーター

タイプ

必須

説明

Action

String

はい

PublishThingModel

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

ProductKey

String

はい

a1BwAGV****

プロダクトの ProductKey。

ProductKey は、IoT Platform コンソールの [プロダクト] ページで確認できます。また、QueryProductList 操作を呼び出すことによっても ProductKey を取得できます。

IotInstanceId

String

いいえ

iot_instc_pu****_c*-v64********

インスタンス ID。インスタンス ID は、IoT Platform コンソールの 概要 タブで確認できます。

重要
  • インスタンスに ID がある場合は、このパラメーターを指定する必要があります。このパラメーターを指定しないと、リクエストは失敗します。

  • IoT Platform コンソールに 概要 ページまたはインスタンス ID が表示されない場合は、このパラメーターを指定する必要はありません。

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

ResourceGroupId

String

いいえ

rg-acfm4l5tcwd****

リソースグループ ID。

重要

IoT Platform は、インスタンスごとのみリソースグループ管理をサポートしています。 ResourceGroupId パラメーターは無効です。このパラメーターを指定する必要はありません。

ModelVersion

String

いいえ

v1.0.0

TSL モデルのバージョン番号。

バージョン番号は 1 ~ 16 文字で、文字、数字、ピリオド(.)を含めることができます。

Description

String

いいえ

Second version

TSL モデルバージョンの説明。

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

レスポンスパラメーター

パラメーター

タイプ

説明

Code

String

iot.system.SystemException

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

ErrorMessage

String

A system exception occurred.

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

RequestId

String

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

リクエスト ID。

Success

Boolean

true

リクエストが成功したかどうかを示します。有効な値:

  • true

  • false

リクエストの例

https://iot.cn-shanghai.aliyuncs.com/?Action=PublishThingModel
&ProductKeySource=a1rYuVF****
&ModelVersion=V1.0.0
&<Common request parameters>

成功レスポンスの例

XML 形式

<PublishThingModelResponse>
  <RequestId>5252CC6E-9E4B-4DB1-B1D8-7EEA190A5B3E</RequestId>
  <Success>true</Success>
</PublishThingModelResponse>

JSON 形式

{
  "RequestId": "5252CC6E-9E4B-4DB1-B1D8-7EEA190A5B3E",
  "Success": true
}

エラーコード

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