すべてのプロダクト
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
}

エラーコード

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