TransformClientId - IoT Platform - Alibaba Cloud ドキュメントセンター

デバイスに複数の ClientID が含まれている場合、不正なログインを防ぐために、デバイスの有効な ClientID を指定します。この API 操作は、事前登録不要の製品ごとの一意の証明書認証に適用されます。

使用方法

QueryClientIds 操作を呼び出して、デバイスの ClientID を表示できます。

制限

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

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

デバッグ

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

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
Action	String	はい	TransformClientId	実行する操作。値を TransformClientId に設定します。
ClientId	String	はい	9rSz********UNMWj33f000112	デバイスの ClientID。
IotId	String	はい	BXPV9Ks3bxwM9fD****0000101	デバイスの ID。
IotInstanceId	String	いいえ	iot-02****43	インスタンスの ID。インスタンス ID は、IoT Platform コンソールの概要ページで確認できます。重要インスタンスに ID がある場合は、このパラメーターを設定する必要があります。このパラメーターを設定しないと、呼び出しは失敗します。インスタンスに概要ページまたは ID がない場合は、このパラメーターを設定する必要はありません。詳細については、「概要」をご参照ください。

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

レスポンスパラメーター

パラメーター	タイプ	例	説明
Code	String	Success	レスポンスコード。値 Success は、呼び出しが成功したことを示します。その他の値は、エラーが発生したことを示します。エラーコードの詳細については、「エラーコード」をご参照ください。
ErrorMessage	String	request parameter error	呼び出しが失敗した場合に返されるエラーメッセージ。
RequestId	String	89F22330-BAEE-**-**-41BA46D6E267	リクエストの ID。
Success	Boolean	true	呼び出しが成功したかどうかを示します。 true: 呼び出しは成功しました。 false: 呼び出しは失敗しました。

例

リクエストの例

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=TransformClientId
&ClientId=9rSz********UNMWj33f000112
&IotId=BXPV9Ks3bxwM9fD****0000101
&<共通リクエストパラメーター>

成功レスポンスの例

XML 形式

<TransformClientIdResponse>
  <RequestId>89F22330-BAEE-****-****-41BA46D6E267</RequestId>
  <Code>Success</Code>
  <Success>true</Success>
</TransformClientIdResponse>

JSON 形式

{
    "RequestId": "89F22330-BAEE-****-****-41BA46D6E267",
    "Code": "Success",
    "Success": true
}

エラーコード

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