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

Descripción de la operación

Notas de uso

El host consta de un nombre de proyecto y un endpoint de Simple Log Service. Debe especificar un proyecto en el host.
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. Se recomienda utilizar un usuario RAM para invocar operaciones de la API o realizar tareas rutinarias de O&M. Para crear un usuario RAM, inicie sesión en la consola de RAM. Asegúrese de que el usuario RAM tenga los permisos de administración sobre los recursos de Simple Log Service. Para obtener más información, consulte Crear un usuario RAM y autorizar al usuario RAM a 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 y la región del proyecto. Para obtener más información, consulte Administrar un proyecto.

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 RAM para otorgar a un usuario RAM o a un rol RAM los permisos necesarios para invocar esta operación.

Acción	Recurso
`log:ListLogStores`	`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/*`

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:ListLogStores

get

*LogStore.

acs:log:{#regionId}:{#accountId}:project/{#project}/logstore/*

log:TLSVersion

Ninguna

Sintaxis de la solicitud

GET /logstores HTTP/1.1

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
project	string	Sí	El nombre del proyecto.	ali-test-project
offset	integer	No	La línea desde la que comienza la consulta. Valor predeterminado: 0.	0
size	integer	No	El número de entradas por página. Valor máximo: 500. Valor predeterminado: 200.	10
logstoreName	string	No	El nombre del Logstore. Se admite la coincidencia aproximada. Por ejemplo, si introduce test, se devuelven los Logstores cuyo nombre contiene test.	my-logstore
telemetryType	string	No	El tipo de datos que desea consultar. Valores válidos: None: registros Metrics: métricas	None
mode	string	No	El tipo de Logstore. Valores válidos: standard y query. standard: Logstore estándar. Este tipo de Logstore admite la función de análisis de registros y es adecuado para escenarios como monitoreo en tiempo real y análisis interactivo. También puede utilizar este tipo de Logstore para construir un sistema integral de observabilidad. query: Logstore de consultas. Este tipo de Logstore admite consultas de alto rendimiento. El costo de tráfico de índice de un Logstore de consultas es aproximadamente la mitad que el de un Logstore estándar. Los Logstores de consultas no admiten análisis SQL. Son adecuados para escenarios en los que el volumen de datos es grande, el período de retención de registros es prolongado o no se requiere análisis de registros. Los períodos de retención de semanas o meses se consideran prolongados.	standard

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El cuerpo de la respuesta.
total	integer	El número de Logstores que cumplen con las condiciones de consulta.	2
count	integer	El número de entradas devueltas en la página actual.	2
logstores	array	Los Logstores que cumplen con las condiciones de consulta.	["test-1","test-2"]
	string	La información sobre el Logstore.	test-1,test-2

Ejemplos

Respuesta exitosa

JSON Formato

{
  "total": 2,
  "count": 2,
  "logstores": [
    "test-1,test-2"
  ]
}

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.