CreateConsumerGroup - Simple Log Service - Centro de documentación de Alibaba Cloud

Descripción de la operación

Notas de uso

El host se compone de un nombre de proyecto y un endpoint de Simple Log Service. Debe especificar un proyecto en el host.
Puede crear hasta 30 grupos de consumidores para un Logstore. El nombre de un grupo de consumidores debe ser único dentro de un proyecto.
Se ha creado y obtenido un par de AccessKey. Para obtener más información, consulte Par de AccessKey.

El par de AccessKey de una cuenta de Alibaba Cloud tiene permisos sobre todas las operaciones de la API. Utilizar estas credenciales para realizar operaciones en Simple Log Service es una operación de alto riesgo. Le recomendamos que utilice un usuario de Resource Access Management (RAM) para llamar a las operaciones de la API o realizar tareas rutinarias de operación y mantenimiento. Para crear un usuario de RAM, inicie sesión en la consola de RAM. Asegúrese de que el usuario de RAM tenga los permisos de administración sobre los recursos de Simple Log Service. Para obtener más información, consulte Crear un usuario de RAM y autorizarlo para acceder a Simple Log Service.

Se ha obtenido la información necesaria para consultar registros. Esta información incluye el nombre del proyecto al que pertenecen los registros, la región del proyecto y el nombre del Logstore al que pertenecen los registros. Para obtener más información, consulte Gestionar un proyecto y Gestionar un Logstore.
Simple Log Service proporciona ejemplos tanto de consumo regular de registros como de consumo de registros basado en grupos de consumidores mediante el SDK de Simple Log Service para Java. Para obtener más información, consulte Consumir datos de registro y Utilizar grupos de consumidores para consumir datos.

Recursos de autenticación

La siguiente tabla describe la información de autorización necesaria para esta operación. Puede agregar esta información al elemento Action de una declaración de política de RAM para otorgar a un usuario de RAM o a un rol de RAM los permisos necesarios para llamar a esta operación.

Acción	Recurso
`log:CreateConsumerGroup`	`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#logstoreName}/consumergroup/{#ConsumerGroup}`

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

log:CreateConsumerGroup

create

*LogStore

acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#logstoreName}/consumergroup/{#ConsumerGroup}

log:TLSVersion

Ninguna

Sintaxis de la solicitud

POST /logstores/{logstore}/consumergroups HTTP/1.1

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
logstore	string	Sí	El nombre del Logstore.	aliyun-test-logstore

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
project	string	Sí	El nombre del proyecto.	aliyun-test-project
body	object	Sí	La información sobre el grupo de consumidores.
consumerGroup	string	Sí	El nombre del grupo de consumidores. El nombre debe ser único dentro de un proyecto.	consumerGroupX
timeout	integer	Sí	El periodo de tiempo de espera. Si el servidor no recibe señales de latido de un consumidor dentro del periodo de tiempo de espera, el servidor elimina el consumidor. Unidad: segundos.	300
order	boolean	Sí	Especifica si se deben consumir los datos en secuencia. Valores válidos: true En un fragmento, los datos se consumen en orden ascendente según el valor del campo __tag__:__receive_time__. Si se divide un fragmento, primero se consumen los datos del fragmento original. Luego, los datos de los nuevos fragmentos se consumen simultáneamente. Si se fusionan fragmentos, primero se consumen los datos de los fragmentos originales. Luego, se consumen los datos del nuevo fragmento. false Los datos de todos los fragmentos se consumen simultáneamente. Si se genera un nuevo fragmento después de dividir un fragmento o de fusionar fragmentos, los datos del nuevo fragmento se consumen inmediatamente.	true

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

Ejemplos

Respuesta exitosa

JSON Formato

{}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.