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

AMQP サーバー側サブスクリプションを使用する場合、コンシューマーグループの累積メッセージをクリアします。

制限

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

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

デバッグ

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

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
Action	String	Yes	ResetConsumerGroupPosition	実行する操作。値を ResetConsumerGroupPosition に設定します。
GroupId	String	Yes	nJRaJPn5U1JITGf******	CreateConsumerGroup 操作を呼び出してコンシューマーグループを作成した後、コンシューマーグループ ID が返されます。QueryConsumerGroupList 操作を呼び出して、グループ名でコンシューマーグループ ID をクエリできます。また、IoT Platform コンソールに移動し、[ルール] > [サーバー側サブスクリプション] > [コンシューマーグループ] を選択して、コンシューマーグループ ID を表示することもできます。
IotInstanceId	String	No	iot-cn-0pp1n8t****	インスタンスの ID。IoT Platform コンソールの [概要] ページでインスタンスの [ID] を表示できます。重要インスタンスに ID がある場合は、このパラメーターを設定する必要があります。このパラメーターを設定しないと、呼び出しは失敗します。インスタンスに [概要] ページまたは ID がない場合は、このパラメーターを設定する必要はありません。詳細については、「概要」をご参照ください。

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

レスポンスパラメーター

パラメーター	タイプ	例	説明
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=ResetConsumerGroupPosition
&GroupId=nJRaJPn5U1JITGf******
&<Common request parameters>

成功レスポンスの例

XML 形式

<ResetConsumerGroupPositionResponse>
       <RequestId>73B9DF43-7780-47DE-8BED-077729D28BD2</RequestId>
       <Success>true</Success>
</ResetConsumerGroupPositionResponse>

JSON 形式

{
  "RequestId": "73B9DF43-7780-47DE-8BED-077729D28BD2",
  "Success": true
}

エラーコード

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