UpdateLogStore - - Centre de documentation Alibaba Cloud

Met à jour les attributs d'un Logstore.

Description de l'opération

Avant de mettre à jour un Logstore, appelez l'opération GetLogStore pour obtenir la configuration actuelle du Logstore. Modifiez la configuration selon vos besoins et transmettez-la en tant que paramètres à l'opération UpdateLogStore.
L'hôte (Host) dans la syntaxe de la requête se compose du nom du projet et du point de terminaison de Simple Log Service. Spécifiez le projet dans l'hôte.
Une paire de clés AccessKey a été créée et obtenue. Pour plus d'informations, consultez Paire de clés AccessKey.

La paire de clés AccessKey d'un compte Alibaba Cloud dispose des autorisations d'accès à toutes les opérations d'API. Cela présente un risque de sécurité élevé. Nous vous recommandons de créer et d'utiliser un utilisateur Resource Access Management (RAM) pour appeler des opérations d'API ou effectuer des opérations de maintenance courantes. L'utilisateur RAM doit disposer des autorisations requises sur les ressources EPS de Simple Log Service. Pour plus d'informations, consultez Créer un utilisateur RAM et l'autoriser.

Vous avez déterminé le nom du projet, la région et le nom du Logstore pour les journaux que vous souhaitez interroger. Pour plus d'informations, consultez Gérer un projet et Gérer un Logstore.

Des journaux d'opérations sont générés lorsque vous appelez cette opération.

Ressources d'authentification

Le tableau suivant répertorie les informations d'autorisation pour cette opération d'API. Vous pouvez ajouter ces informations à l'élément Action dans une instruction de stratégie d'accès RAM pour accorder à un utilisateur Resource Access Management (RAM) ou à un rôle RAM les autorisations nécessaires pour appeler cette opération d'API.

Action	Ressource
`log:UpdateLogStore`	`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}`

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

log:UpdateLogStore

update

*LogStore

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

log:TLSVersion
log:Encrypted

Aucune

Syntaxe de la requête

PUT /logstores/{logstore} HTTP/1.1

Paramètres de chemin

Paramètre	Type	Requis	Description	Exemple
logstore	string	Oui	Le nom du Logstore.	test-logstore

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
project	string	Oui	Le nom du projet.	ali-test-project
body	object	Oui	Les paramètres du corps de la requête.
logstoreName	string	Oui	Le nom du Logstore.	test-logstore
shardCount `deprecated`	integer	Non	Le nombre de fragments. Remarque Cette opération ne prend pas en charge la mise à jour du nombre de fragments. Vous pouvez modifier le nombre de fragments uniquement en appelant l'opération SplitShard ou MergeShards.	2
ttl	integer	Oui	La période de rétention des données. Unité : jours. Valeurs valides : 1 à 3650. Une valeur de 3650 indique une rétention permanente.	30
encrypt_conf	EncryptConf	Non	La configuration du chiffrement. Le chiffrement est désactivé par défaut. Exemple 1 (activer le chiffrement par défaut) : `{ "enable": true, "encrypt_conf": "default" }` Exemple 2 (activer le chiffrement BYOK) : `{ "enable": true, "encrypt_conf": "default", "user_cmk_info": { "cmk_key_id": "xxxxx", "arn": "acs:ram::112340000000:role/rolename", "region": "ap-southeast-1" } }`
autoSplit	boolean	Non	Indique si le fractionnement automatique doit être activé. Une fois cette fonctionnalité activée, un fragment est automatiquement divisé lorsque le trafic d'écriture dépasse continuellement la limite, ce qui améliore la capacité d'écriture. Vous devez définir maxSplitShard (le nombre maximal de fragments après le fractionnement) lorsque vous activez le fractionnement automatique.	true
enable_tracking	boolean	Non	Indique si la fonctionnalité WebTracking doit être activée. Valeur par défaut : false. Vous pouvez utiliser la fonctionnalité WebTracking pour collecter et analyser les données de comportement des utilisateurs dans les navigateurs ou les mini-programmes, telles que les pages vues, les historiques d'achat et le temps passé sur le site. true : active WebTracking. false : désactive WebTracking.	false
appendMeta	boolean	Non	Indique si l'adresse IP publique et l'heure d'arrivée du journal doivent être enregistrées. Valeur par défaut : false. true : active la fonctionnalité. Une fois cette fonctionnalité activée, Simple Log Service ajoute automatiquement l'adresse IP publique de l'appareil source du journal et l'heure à laquelle le journal arrive sur le serveur au champ Tag du journal. false : désactive la fonctionnalité.	false
maxSplitShard	integer	Non	Le nombre maximal de fragments pour le fractionnement automatique. Valeur minimale : 1. Valeur maximale : 256. Remarque Ce paramètre est requis lorsque autoSplit est défini sur true.	64
telemetryType `deprecated`	string	Non	Le type de données observables. La valeur par défaut est les données de journal. Valeurs valides : None : données de journal. Il s'agit de la valeur par défaut. Metrics : données de séries chronologiques.	None
hot_ttl	integer	Non	La période de rétention des données dans le niveau chaud du Logstore. Unité : jours. Valeur minimale : 7. La valeur ne peut pas dépasser la valeur de ttl. Par défaut, toutes les données comprises dans la période de rétention sont stockées dans le niveau chaud. Une fois que la durée de stockage des données dépasse la période de rétention des données chaudes configurée, les données sont déplacées vers le niveau d'accès peu fréquent (IA). Lorsque vous activez le niveau IA, la période de rétention des données chaudes doit être d'au moins 7 jours. Pour plus d'informations, consultez Hiérarchisation intelligente. Exemples : Scénario 1 (niveau chaud uniquement, 30 jours) : `{"ttl": 30}` ou `{"ttl": 30, "hot_ttl": 30}` Scénario 2 (niveau chaud 7 jours, niveau IA 23 jours) : `{"ttl": 30, "hot_ttl": 7}`	60
mode	string	Non	Simple Log Service fournit deux types de Logstores : Standard et Query. standard : prend en charge les capacités d'analyse de données tout-en-un de Simple Log Service. Ce type est adapté aux scénarios tels que la surveillance en temps réel, l'analyse interactive et la création de systèmes d'observabilité complets. query : prend en charge les requêtes hautes performances. Les frais de trafic d'index sont environ la moitié de ceux du type Standard. Cependant, l'analyse SQL n'est pas prise en charge. Ce type est adapté aux scénarios avec de grands volumes de données, de longues périodes de stockage (semaines ou mois) et aucune exigence d'analyse de journaux.	standard
infrequentAccessTTL	integer	Non	Niveau d'accès peu fréquent (IA). Aucune durée de stockage minimale n'est requise. Les données doivent être stockées pendant au moins 30 jours avant d'être déplacées vers le niveau d'archive. Lorsque la période de rétention des journaux dépasse la somme de la période de rétention du niveau chaud et de la période de rétention du niveau IA, le temps de stockage restant est converti en stockage de niveau d'archive. Exemples : Scénario 1 (niveau chaud 7 jours, niveau IA 23 jours) : `{"ttl": 30, "hot_ttl": 7}` Scénario 2 (niveau chaud 7 jours, niveau IA 30 jours, niveau d'archive 60 jours) : `{"ttl": 97, "hot_ttl": 7, "infrequentAccessTTL": 30}` Scénario 3 (niveau chaud 60 jours, niveau IA 0 jour, niveau d'archive 60 jours) : `{"ttl": 120, "hot_ttl": 60, "infrequentAccessTTL": 0}`	30
shardingPolicy	ShardingPolicy	Non	La configuration d'écriture basée sur le hachage. Lorsque des données sont écrites, les journaux sont routés vers des fragments en fonction de la stratégie de hachage configurée. Avant de configurer ce paramètre, assurez-vous que les plages de hachage des fragments sont réparties uniformément. Cette configuration peut affecter la capacité d'écriture. Procédez avec prudence.

Éléments de réponse

Élément

Type

Description

Exemple

Exemples

JSON format

{}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.