Todos los productos
Search
Centro de documentos

Simple Log Service:create_consumer_group

Última actualización: Sep 02, 2026

Crea un grupo de consumidores para un logstore especificado.

Sintaxis de la solicitud

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

Parámetros de la solicitud

Parámetros específicos del comando create_consumer_group.

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

--project

String

Sí

aliyun-test-project

Nombre del proyecto.

--logstore

String

Sí

logstore-a

Nombre del logstore.

--consumer_group

String

Sí

consumer-group-1

Nombre del grupo de consumidores. Debe ser único dentro del proyecto.

--timeout

Integer

Sí

300

Periodo de tiempo de espera. Unidad: segundos.

Los consumidores envían latidos periódicos a Log Service. Si no se recibe ningún latido durante este periodo, Log Service libera los recursos del consumidor.

--in_order

Boolean

No

true

Indica si se consumen los datos del shard en secuencia. Valores válidos:

  • true: los datos del shard se consumen en secuencia. Tras una división de shard, primero se consume el shard original y luego los nuevos shards se consumen simultáneamente.

  • false (predeterminado): los datos del shard se consumen sin garantizar un orden específico.

Para obtener información sobre los parámetros globales de la interfaz de línea de comandos (CLI) de Log Service, consulte Global parameters.

Ejemplos

  • Cree un grupo de consumidores para logstore-a con la cuenta predeterminada:

    aliyunlog log create_consumer_group --project="aliyun-test-project" --logstore="logstore-a" --consumer_group="consumer-group-1" --timeout="300" --in_order=true
  • Consulte el grupo de consumidores:

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

    Respuesta de ejemplo:

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

Códigos de error

Si se devuelve un mensaje de error, corrija el problema según los códigos de error de la operación API correspondiente. Para más información, consulte Error codes.

Referencia de la API

CreateConsumerGroup