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

Simple Log Service:create_consumer_group

最終更新日:Sep 06, 2024

指定されたLogstoreのコンシューマーグループを作成します。

リクエスト構文

aliyunlog log create_consumer_group --project=<value> --logstore=<value> --consumer_group=<value> --timeout=<value> [--in_order=<value>] [--access-id=<value>] [--access-key=<value>] [--sts-token=<value>] [--region-endpoint=<value>] [--client-name=<value>] [--jmes-filter=<value>] [--format-output=<value>] [--decode-output=<value>]

リクエストパラメーター

次の表に、create_consumer_groupコマンドに必要なパラメーターと具体的なパラメーターを示します。

パラメーター

データ型

必須

説明

-- プロジェクト

String

課金されます

aliyun-test-project

プロジェクトの名前。

-- logstore

String

課金されます

logstore-a

ログストアの名前

-- consumer_group

String

課金されます

consumer-グループ-1

消費者グループの名前です。 名前はプロジェクト内で一意である必要があります。

-- timeout

Integer

課金されます

300

タイムアウト期間。 単位は秒です。

コンシューマーは、接続を確立するために定期的にハートビートをLog Serviceに送信します。 Log Serviceがタイムアウト期間内にコンシューマーによって送信されたハートビートを受信しない場合、Log Serviceはコンシューマーによって占有されているリソースを解放します。

-- in_order

ブール値

課金されません

true

シャードからデータを順番に消費するかどうかを指定します。 有効な値:

  • true: シャード内のデータは順番に消費されます。 シャードが分割されると、元のシャードのデータが最初に消費されます。 その後、新しいシャードのデータが同時に消費されます。

  • false (デフォルト値): シャード内のデータはランダムに消費されます。

Log Serviceコマンドラインインターフェイス (CLI) のグローバルパラメーターの詳細については、「グローバルパラメーター」をご参照ください。

  • デフォルトのアカウントを使用して、Logstore-aという名前のlogstoreのコンシューマーグループを作成します。 サンプルリクエスト:

    aliyunlog log create_consumer_group --project="aliyun-test-project" --logstore="logstore-a" --consumer_group="consumer-group-1" --timeout="300" --in_order=true
  • 作成したコンシューマグループを照会します。 サンプルリクエスト:

    aliyunlog log list_consumer_group --project="aliyun-test-project" --logstore="logstore-a"

    レスポンス例:

    [
      {
        "name": "consumer-group-1",
        "order": true,
        "timeout": 300
      }
    ]

エラーコード

エラーメッセージが返された場合は、関連するAPI操作のエラーコードに基づいてエラーを修正します。 詳細については、エラーコードをご参照ください。

API リファレンス

CreateConsumerGroup