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:
Activated Simple Log Service (SLS)
Installed y configured la CLI de SLS
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 |
|
|
String |
Sí |
|
Nombre del proyecto. Los proyectos aíslan los recursos y controlan el acceso. Para obtener más información, consulte Manage projects. |
|
|
String |
Sí |
|
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 ( |
|
|
Integer |
No |
|
Periodo total de retención de datos en días. Valores válidos: de 1 a 3650. Establezca este valor en |
|
|
Integer |
No |
|
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. |
|
|
Boolean |
No |
|
Habilita ( |
|
|
Boolean |
No |
|
Registra ( |
|
|
Boolean |
No |
|
Habilita ( |
|
|
Integer |
No |
|
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 |
|
|
String |
No |
-- |
Configuración de cifrado en formato de cadena JSON. Para conocer la estructura de datos, consulte EncryptConf. |
|
|
String |
No |
|
Tipo de datos observables almacenados en el logstore. |
|
|
Integer |
No |
|
Periodo de retención para el nivel de almacenamiento caliente (hot storage) en días. Mínimo: |
|
|
String |
No |
|
Tipo de logstore. |
|
|
Integer |
No |
|
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. |
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.
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
Error codes -- solución de problemas para llamadas a API con errores
UpdateLogStore API -- API REST subyacente para este comando
Manage a Logstore by using Java SDK y Manage a Logstore by using Python SDK -- alternativas mediante SDK
Alibaba Cloud OpenAPI Explorer for SLS -- integración común con SDK