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.
| Action | Ressource |
log:CreateLogStore | 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
|
log:CreateLogStore |
create |
*LogStore.
|
|
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 :
|
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 Exemple 1 (activer le chiffrement par défaut) :
Exemple 2 (activer le chiffrement BYOK) : |
|
| 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.
|
false |
| telemetryType |
string |
Non |
Le type de données observables. Le type par défaut est les données de journal. Valeurs valides :
|
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 :
|
60 |
| mode |
string |
Non |
Simple Log Service fournit deux types de Logstores : Standard et Query.
|
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 :
|
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.