Tous les produits
Search
Centre de documentation

Simple Log Service:update_logstore

Dernière mise à jour :Aug 18, 2026

Met à jour la configuration d'un Logstore, y compris la rétention des données, les niveaux de stockage, le partitionnement et les paramètres de suivi.

Prérequis

Avant d'exécuter cette commande, assurez-vous d'avoir :

Syntaxe

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

Pour les paramètres globaux tels que --access-id, --access-key, --region-endpoint et --format-output, consultez la rubrique Paramètres globaux.

Paramètres

Paramètre

Type

Obligatoire

Exemple

Description

--project_name

String

Oui

aliyun-test-project

Nom du projet. Les projets permettent d'isoler les ressources et de contrôler l'accès. Pour plus d'informations, consultez la rubrique Gérer les projets.

--logstore_name

String

Oui

logstore-a

Nom du Logstore. Il est immuable après la création et doit être unique au sein du projet. Règles de nommage : lettres minuscules, chiffres, traits d'union (-) et underscores (_) ; doit commencer par une lettre minuscule et se terminer par une lettre minuscule ou un chiffre ; longueur comprise entre 3 et 63 caractères.

--ttl

Integer

Non

30

Période totale de rétention des données en jours. Valeurs valides : de 1 à 3650. Définissez la valeur sur 3650 pour un stockage permanent. Lorsque la période de rétention expire, SLS supprime les données expirées. La valeur de --ttl correspond à la somme de --hot_ttl, --infrequent_access_ttl et de la période de rétention du stockage Archive.

--shard_count

Integer

Non

2

Nombre de shards. Bien que la CLI accepte ce paramètre, elle l'ignore silencieusement. Pour ajuster le nombre de shards, utilisez les opérations SplitShard ou MergeShard. Pour plus d'informations, consultez la rubrique Plage de shards.

--enable_tracking

Boolean

Non

true

Active (true) ou désactive (false) WebTracking.

--append_meta

Boolean

Non

false

Enregistre (true) ou ignore (false) les adresses IP publiques des clients.

--auto_split

Boolean

Non

true

Active (true) ou désactive (false) le fractionnement automatique des shards.

--max_split_shard

Integer

Non

64

Nombre maximal de shards pouvant être créés par le fractionnement automatique. Valeurs valides : de 1 à 256. Ce paramètre est requis lorsque --auto_split est défini sur true.

--encrypt_conf

String

Non

--

Configuration de chiffrement sous forme de chaîne JSON. Pour la structure des données, consultez la rubrique EncryptConf.

--telemetry_type

String

Non

None

Type de données observables stockées dans le Logstore. None (par défaut) : journaux. Metrics : données de séries temporelles.

--hot_ttl

Integer

Non

7

Période de rétention pour le niveau de stockage Hot en jours. Minimum : 7. Maximum : la valeur de --ttl. Définissez la valeur sur -1 pour conserver toutes les données dans le stockage Hot. À l'issue de cette période, les données sont transférées vers le niveau Infrequent Access (IA). Règles de transition entre les niveaux de stockage : le passage de Hot à IA nécessite au moins 7 jours dans le stockage Hot ; le passage de IA à Archive nécessite au moins 30 jours dans le stockage IA ; le passage direct de Hot à Archive (en ignorant IA) nécessite au moins 30 jours dans le stockage Hot. Pour plus d'informations, consultez la rubrique Configurer le stockage intelligent par niveaux.

--mode

String

Non

standard

Type de Logstore. standard (par défaut) : Logstore standard. Prend en charge l'analyse des journaux, la surveillance en temps réel et l'analyse interactive. Utilisez ce type pour construire un système d'observabilité complet. query (valeur CLI : lite) : Logstore de requête. Optimisé pour des requêtes haute performance avec environ la moitié du coût de trafic d'indexation. Ne prend pas en charge les instructions SELECT. Idéal pour les grands ensembles de données avec de longues périodes de rétention ou lorsque l'analyse des journaux n'est pas requise. Pour plus d'informations, consultez la rubrique Gérer un Logstore.

--infrequent_access_ttl

Integer

Non

30

Période de rétention pour le niveau IA en jours. Les données doivent rester dans le niveau IA pendant au moins 30 jours avant d'être déplacées vers le niveau de stockage Archive. Pour plus d'informations, consultez la rubrique Configurer le stockage intelligent par niveaux.

Important

Lorsque vous réduisez la valeur de --ttl, SLS supprime toutes les données nouvellement expirées dans un délai d'une heure. Par exemple, si vous modifiez la période de rétention de 5 jours à 1 jour, SLS supprimera les 4 jours précédents de données de journalisation dans l'heure qui suit. L'utilisation du stockage affichée sur la page Détails de l'utilisation de la console SLS sera mise à jour le lendemain.

Important

Le nombre de shards ne peut pas être modifié via la commande update_logstore. La CLI accepte le paramètre --shard_count sans générer d'erreur, mais la valeur est ignorée silencieusement. Pour ajuster le nombre de shards, utilisez les opérations SplitShard ou MergeShard.

Exemples

Définissez la période de rétention des données sur 30 jours et activez WebTracking pour le Logstore logstore-a dans le projet aliyun-test-project :

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

Une commande réussie ne renvoie aucune sortie. Exécutez la commande suivante pour vérifier la mise à jour :

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

Vérifiez que les champs ttl et enable_tracking dans la sortie JSON correspondent aux valeurs que vous avez définies.

Références