Todos los productos
Search
Centro de documentos

Simple Log Service:update_logstore

Última actualización: Sep 03, 2026

Actualiza la configuración de un logstore, lo que incluye la retención de datos, los niveles de almacenamiento, la fragmentación y las opciones de seguimiento.

Requisitos previos

Antes de ejecutar este comando, asegúrese de cumplir con lo siguiente:

Sintaxis

aliyunlog log update_logstore \
  --project_name=<value> \
  --logstore_name=<value> \
  [--ttl=<value>] \
  [--enable_tracking=<value>] \
  [--shard_count=<value>] \
  [--append_meta=<value>] \
  [--auto_split=<value>] \
  [--max_split_shard=<value>] \
  [--preserve_storage=<value>] \
  [--encrypt_conf=<value>] \
  [--hot_ttl=<value>] \
  [--mode=<value>] \
  [--telemetry_type=<value>] \
  [--infrequent_access_ttl=<value>]

Para consultar parámetros globales como --access-id, --access-key, --region-endpoint y --format-output, consulte Global parameters.

Parámetros

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

--project_name

String

Sí

aliyun-test-project

Nombre del proyecto. Los proyectos aíslan los recursos y controlan el acceso. Para obtener más información, consulte Manage projects.

--logstore_name

String

Sí

logstore-a

Nombre del logstore. Es inmutable tras su creación y debe ser único dentro del proyecto. Reglas de nomenclatura: letras minúsculas, dígitos, guiones (-) y guiones bajos (_); debe comenzar con una letra minúscula y terminar con una letra minúscula o un dígito; longitud de 3 a 63 caracteres.

--ttl

Integer

No

30

Periodo total de retención de datos en días. Valores válidos: de 1 a 3650. Establezca este valor en 3650 para almacenamiento permanente. Cuando finaliza el periodo de retención, SLS elimina los datos caducados. El valor de --ttl equivale a la suma de --hot_ttl, --infrequent_access_ttl y el periodo de retención del almacenamiento Archive.

--shard_count

Integer

No

2

Número de shards. La CLI acepta este parámetro, pero lo ignora sin notificación. Para ajustar la cantidad de shards, utilice SplitShard o MergeShard. Para obtener más información, consulte Shard range.

--enable_tracking

Boolean

No

true

Habilita (true) o deshabilita (false) WebTracking.

--append_meta

Boolean

No

false

Registra (true) u omite (false) las direcciones IP públicas de los clientes.

--auto_split

Boolean

No

true

Habilita (true) o deshabilita (false) la división automática de shards.

--max_split_shard

Integer

No

64

Cantidad máxima de shards que puede crear la división automática. Valores válidos: de 1 a 256. Este parámetro es obligatorio cuando --auto_split tiene el valor true.

--encrypt_conf

String

No

--

Configuración de cifrado en formato de cadena JSON. Para conocer la estructura de datos, consulte EncryptConf.

--telemetry_type

String

No

None

Tipo de datos observables almacenados en el logstore. None (predeterminado): registros. Metrics: datos de series temporales.

--hot_ttl

Integer

No

7

Periodo de retención para el nivel de almacenamiento caliente (hot storage) en días. Mínimo: 7. Máximo: el valor de --ttl. Establezca este valor en -1 para conservar todos los datos en el almacenamiento caliente. Tras este periodo, los datos se trasladan al nivel Infrequent Access (IA). Reglas de transición entre niveles de almacenamiento: el paso de hot a IA requiere como mínimo 7 días en hot storage; el paso de IA a Archive requiere como mínimo 30 días en IA; el paso directo de hot a Archive (sin pasar por IA) requiere como mínimo 30 días en hot storage. Para obtener más información, consulte Configure intelligent tiered storage.

--mode

String

No

standard

Tipo de logstore. standard (predeterminado): logstore estándar. Admite análisis de registros, monitoreo en tiempo real y análisis interactivo. Utilice este tipo para construir un sistema integral de observability. query (valor en la CLI: lite): logstore de consultas. Optimizado para consultas de alto rendimiento con un costo de tráfico de índice aproximadamente del 50 %. No admite instrucciones SELECT. Resulta ideal para grandes volúmenes de datos con periodos de retención prolongados o cuando no se requiere análisis de registros. Para obtener más información, consulte Manage a Logstore.

--infrequent_access_ttl

Integer

No

30

Periodo de retención para el nivel IA en días. Los datos deben permanecer en el nivel IA durante al menos 30 días antes de pasar al nivel de almacenamiento Archive. Para obtener más información, consulte Configure intelligent tiered storage.

Importante

Al reducir el valor de --ttl, SLS elimina todos los datos recién caducados en un plazo de 1 hora. Por ejemplo, si cambia la retención de 5 días a 1 día, SLS eliminará los registros de los 4 días anteriores dentro de la siguiente hora. El uso de almacenamiento que se muestra en la página Usage Details de la consola de SLS se actualizará al día siguiente.

Importante

No es posible modificar la cantidad de shards mediante update_logstore. La CLI acepta el parámetro --shard_count sin generar errores, pero ignora el valor silenciosamente. Para ajustar el número de shards, utilice SplitShard o MergeShard.

Ejemplos

Establezca el periodo de retención de datos en 30 días y habilite WebTracking para el logstore logstore-a en el proyecto aliyun-test-project:

aliyunlog log update_logstore \
  --project_name="aliyun-test-project" \
  --logstore_name="logstore-a" \
  --ttl=30 \
  --enable_tracking=true

Si el comando se ejecuta correctamente, no genera ninguna salida. Ejecute el siguiente comando para comprobar la actualización:

aliyunlog log get_logstore \
  --project_name="aliyun-test-project" \
  --logstore_name="logstore-a" \
  --format-output=json

Verifique que los campos ttl y enable_tracking en la salida JSON coincidan con los valores que estableció.

Referencias