Tous les produits
Search
Centre de documentation

:CreateLogStore

Dernière mise à jour :Oct 03, 2026

Crée un Logstore.

Description de l'opération

Description de l'opération

  • 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. Vous devez spécifier le projet dans l'hôte.

  • Créez et obtenez une AccessKey. Pour plus d'informations, consultez Clé d'accès.

L'AccessKey du compte Alibaba Cloud dispose d'un accès complet à toutes les opérations d'API, ce qui présente un risque de sécurité élevé. Créez et utilisez 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 d'accès pour gérer les ressources Simple Log Service. Pour plus d'informations, consultez Créer un utilisateur RAM et accorder des autorisations.

  • Identifiez le nom et la région du projet auquel appartiennent les journaux que vous souhaitez interroger. Pour plus d'informations, consultez Gérer un projet.

  • Vous pouvez créer un maximum de 200 Logstores dans un projet.

  • Les journaux sont supprimés lorsque la période de rétention des données que vous avez configurée expire.

Informations 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 d'une instruction de stratégie d'accès RAM pour accorder aux utilisateurs Resource Access Management (RAM) ou aux rôles RAM les autorisations d'appeler cette opération d'API.

ActionRessource
log:CreateLogStoreacs: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:CreateLogStore

create

*LogStore.

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

  • log:TLSVersion
  • log:Encrypted
Aucune

Syntaxe de la requête

POST /logstores HTTP/1.1

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 de la requête.

logstoreName

string

Oui

Le nom du Logstore. Le nom doit respecter les exigences suivantes :

  • Le nom doit être unique au sein d'un projet.

  • Le nom ne peut contenir que des lettres minuscules, des chiffres, des traits d'union (-) et des traits de soulignement (_).

  • Le nom doit commencer et se terminer par une lettre minuscule ou un chiffre.

  • Le nom doit comporter entre 2 et 63 caractères.

my-logstore

shardCount

integer

Oui

Le nombre de fragments.

Remarque

Cette opération ne prend pas en charge la mise à jour du nombre de fragments. Utilisez l'opération SplitShard ou MergeShards pour modifier le nombre de fragments.

2

ttl

integer

Oui

La période de rétention des données, en jours. Valeurs valides : 1 à 3650. Si vous définissez ce paramètre sur 3650, les données sont conservées de manière permanente (rétention permanente).

1

encrypt_conf EncryptConf

Non

La structure de données de configuration de chiffrement, qui contient les paramètres enable, encrypt_type et user_cmk_info. Pour plus d'informations, consultez EncryptConf.

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": "cn-hangzhou"
    }
}

autoSplit

boolean

Non

Indique si le fractionnement automatique doit être activé. Si cette option est activée, une opération de fractionnement de fragment est déclenchée automatiquement lorsque le trafic d'écriture de journaux dépasse constamment la limite, ce qui améliore le débit d'écriture. Si vous activez le fractionnement automatique, vous devez configurer maxSplitShard (le nombre maximal de fragments après le fractionnement).

true

enable_tracking

boolean

Non

Indique si la fonctionnalité WebTracking doit être activée. Valeur par défaut : false. Utilisez 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.

false

maxSplitShard

integer

Non

Le nombre maximal de fragments après le fractionnement automatique. Valeur minimale : 1. Valeur maximale : 256.

Remarque

Ce paramètre est requis lorsque autoSplit est défini sur true.

64

appendMeta

boolean

Non

Indique si l'adresse IP publique et l'heure de réception du journal doivent être enregistrées. Valeur par défaut : false.

  • true : active l'enregistrement de l'adresse IP publique et de l'heure de réception du journal. 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 l'enregistrement de l'adresse IP publique et de l'heure de réception du journal.

false

telemetryType

string

Non

Le type de données observables. Le type 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 d'un Logstore. Unité : jours. Valeur minimale : 7. La valeur maximale ne peut pas dépasser la valeur de ttl. Par défaut, toutes les données au sein de la période de rétention ttl sont stockées dans le niveau chaud.

Lorsque la durée de stockage des données dépasse la période de rétention des données chaudes que vous avez configurée, les données sont déplacées vers le niveau d'accès peu fréquent (IA). Si 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 l'ensemble complet des fonctionnalités d'analyse de données de Simple Log Service. Adapté à 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 représentent environ la moitié de ceux du type Standard. Ne prend pas en charge l'analyse SQL. Adapté aux scénarios avec de grands volumes de données, de longues périodes de rétention (hebdomadaires, mensuelles ou plus) et sans exigences d'analyse de journaux.

standard

infrequentAccessTTL

integer

Non

Le niveau d'accès peu fréquent (IA). Aucune exigence de durée de stockage minimale. Les données sont déplacées vers le niveau d'archive après au moins 30 jours.

Lorsque la durée de stockage 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, la durée de stockage restante est convertie en stockage 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, archive 60 jours) : {"ttl": 97, "hot_ttl": 7, "infrequentAccessTTL": 30}

  • Scénario 3 (niveau chaud 60 jours, niveau IA 0 jour, archive 60 jours) : {"ttl": 120, "hot_ttl": 60, "infrequentAccessTTL": 0}

30

processorId

string

Non

L'identifiant IngestProcessor.

processor-nginx-parser-001

shardingPolicy ShardingPolicy

Non

La configuration d'écriture par hachage. Lors de l'écriture des données, les journaux sont routés vers les fragments en fonction de la stratégie de hachage configurée. Avant de configurer cela, assurez-vous que les plages de hachage des fragments sont réparties uniformément. Ce paramètre peut affecter le débit d'écriture, configurez-le donc avec prudence.

resourceGroupId

string

Non

L'identifiant du groupe de ressources. S'il est spécifié, le Logstore est associé au groupe de ressources.

rg-xxxxxxxx

enableModify

boolean

Non

É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.