コンシューマーは、アクティブなステータスを維持するために、サーバーにハートビートを送信します。
操作説明
API の説明
Host は、プロジェクト名と Simple Log Service エンドポイントで構成されます。Host にはプロジェクトを指定する必要があります。
コンシューマーは、接続を維持するために、固定間隔でサーバーにハートビートを送信します。サーバーが指定された期間内にコンシューマーからハートビートを受信しない場合、そのコンシューマーは削除されます。
AccessKey ペアを取得します。詳細については、「AccessKey ペア」をご参照ください。
Alibaba Cloud アカウントの AccessKey ペアは、すべての API 操作に対する権限を持っています。これは高いセキュリティ脅威をもたらします。API 操作の呼び出しや定期的な O&M の実行には、RAM ユーザーを作成して使用することを推奨します。RAM ユーザーは、Simple Log Service リソースを管理する権限を持っている必要があります。詳細については、「RAM ユーザーの作成と権限付与」をご参照ください。
-
プロジェクト名、リージョン、および Logstore 名を取得します。詳細については、「プロジェクトの管理」および「Logstore の管理」をご参照ください。
-
使用者グループ名を取得します。詳細については、「ListConsumerGroup」をご参照ください。
権限付与情報
次の表に、この操作の権限付与情報を示します。この情報を RAM ポリシーの Action 要素に追加して、RAM ユーザーまたは RAM ロールにこの API 操作を呼び出す権限を付与します。
| 操作 | 権限付与ポリシーのリソース |
log:ConsumerGroupHeartBeat | acs:log:${regionId}:${accountId}:project/{#ProjectName}/logstore/{#LogstoreName}/consumergroup/{#ConsumerGroupName} |
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
log:ConsumerGroupHeartBeat |
none |
*All Resource
|
|
なし |
リクエスト構文
POST /logstores/{logstore}/consumergroups/{consumerGroup}?type=heartbeat HTTP/1.1パスパラメータ
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| logstore |
string |
必須 |
Logstore の名前。 |
ali-test-logstore |
| consumerGroup |
string |
必須 |
使用者グループの名前。名前はプロジェクト内で一意である必要があります。 |
consumer_group_test |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| project |
string |
必須 |
プロジェクトの名前。 |
ali-test-project |
| consumer |
string |
必須 |
コンシューマー。 |
consumer_1 |
| body |
array |
必須 |
消費されているシャード ID のリスト。 |
|
|
integer |
任意 |
消費されているシャード ID のリスト。 |
[0] |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
array |
コンシューマーによって消費されるすべてのシャード ID のリスト。 |
||
|
integer |
コンシューマーによって消費されるすべてのシャード ID のリスト。 |
[0] |
例
成功レスポンス
JSONJSON
[
0
]エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。