Tous les produits
Search
Centre de documentation

Simple Log Service:create_consumer_group

Dernière mise à jour :Aug 18, 2026

Crée un groupe de consommateurs pour un Logstore spécifié.

Syntaxe de la requête

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

Paramètres de la requête

Paramètres spécifiques à la commande create_consumer_group.

Parameter

Type

Required

Example

Description

--project

String

Yes

aliyun-test-project

Nom du projet.

--logstore

String

Yes

logstore-a

Nom du Logstore.

--consumer_group

String

Yes

consumer-group-1

Nom du groupe de consommateurs. Doit être unique au sein du projet.

--timeout

Integer

Yes

300

Délai d'expiration. Unité : secondes.

Les consommateurs envoient des signaux de présence périodiques à Log Service. Si aucun signal n'est reçu durant cette période, Log Service libère les ressources du consommateur.

--in_order

Boolean

No

true

Indique si les données des shards sont consommées dans l'ordre. Valeurs valides :

  • true : Les données des shards sont consommées séquentiellement. Après une division de shard, le shard d'origine est consommé en premier, puis les nouveaux shards sont consommés simultanément.

  • false (par défaut) : Les données des shards sont consommées sans garantie d'ordre.

Pour plus d'informations sur les paramètres globaux de l'interface de ligne de commande (CLI) Log Service, consultez Paramètres globaux.

Exemples

  • Créez un groupe de consommateurs pour logstore-a avec le compte par défaut :

    aliyunlog log create_consumer_group --project="aliyun-test-project" --logstore="logstore-a" --consumer_group="consumer-group-1" --timeout="300" --in_order=true
  • Interrogez le groupe de consommateurs :

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

    Exemple de réponse :

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

Codes d'erreur

Si un message d'erreur s'affiche, corrigez l'erreur en vous basant sur les codes d'erreur de l'opération API associée. Pour plus d'informations, consultez Codes d'erreur.

Référence API

CreateConsumerGroup