全部产品
Search
文档中心

Simple Log Service:create_consumer_group

更新时间:Jul 06, 2025

Membuat grup konsumen untuk Logstore yang ditentukan.

Sintaks permintaan

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>]

Parameter permintaan

Tabel berikut menjelaskan parameter yang diperlukan dan spesifik dari perintah create_consumer_group.

Parameter

Tipe

Diperlukan

Contoh

Deskripsi

--project

String

Ya

aliyun-test-project

Nama proyek.

--logstore

String

Ya

logstore-a

Nama Logstore.

--consumer_group

String

Ya

consumer-group-1

Nama grup konsumen. Nama harus unik dalam sebuah proyek.

--timeout

Integer

Ya

300

Periode timeout. Satuan: detik.

Konsumen mengirimkan sinyal denyut jantung ke Layanan Log secara berkala untuk membangun koneksi. Jika Layanan Log tidak menerima sinyal denyut jantung yang dikirim oleh konsumen dalam periode timeout, Layanan Log melepaskan sumber daya yang digunakan oleh konsumen.

--in_order

Boolean

Tidak

true

Menentukan apakah akan mengonsumsi data secara berurutan dari shard. Nilai valid:

  • true: Data di shard dikonsumsi secara berurutan. Jika shard dibagi, data di shard asli dikonsumsi terlebih dahulu. Kemudian, data di shard baru dikonsumsi pada saat yang sama.

  • false (nilai default): Data di shard dikonsumsi secara acak.

Untuk informasi tentang parameter global dari antarmuka baris perintah (CLI) Layanan Log, lihat Parameter Global.

Contoh

  • Gunakan akun default untuk membuat grup konsumen untuk Logstore bernama logstore-a. Contoh permintaan:

    aliyunlog log create_consumer_group --project="aliyun-test-project" --logstore="logstore-a" --consumer_group="consumer-group-1" --timeout="300" --in_order=true
  • Kueri grup konsumen yang dibuat. Contoh permintaan:

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

    Contoh respons:

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

Kode kesalahan

Jika pesan kesalahan dikembalikan, perbaiki kesalahan berdasarkan kode kesalahan dari operasi API terkait. Untuk informasi lebih lanjut, lihat Kode Kesalahan.

Referensi API

CreateConsumerGroup