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 |
|
|
String |
Oui |
|
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. |
|
|
String |
Oui |
|
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 ( |
|
|
Integer |
Non |
|
Période totale de rétention des données en jours. Valeurs valides : de 1 à 3650. Définissez la valeur sur |
|
|
Integer |
Non |
|
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. |
|
|
Boolean |
Non |
|
Active ( |
|
|
Boolean |
Non |
|
Enregistre ( |
|
|
Boolean |
Non |
|
Active ( |
|
|
Integer |
Non |
|
Nombre maximal de shards pouvant être créés par le fractionnement automatique. Valeurs valides : de 1 à 256. Ce paramètre est requis lorsque |
|
|
String |
Non |
-- |
Configuration de chiffrement sous forme de chaîne JSON. Pour la structure des données, consultez la rubrique EncryptConf. |
|
|
String |
Non |
|
Type de données observables stockées dans le Logstore. |
|
|
Integer |
Non |
|
Période de rétention pour le niveau de stockage Hot en jours. Minimum : |
|
|
String |
Non |
|
Type de Logstore. |
|
|
Integer |
Non |
|
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. |
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.
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
Codes d'erreur -- dépannage des appels API ayant échoué
API UpdateLogStore -- API REST sous-jacente pour cette commande
Gérer un Logstore à l'aide du SDK Java et Gérer un Logstore à l'aide du SDK Python -- alternatives SDK
Explorateur OpenAPI Alibaba Cloud pour SLS -- intégration SDK courante