开发者社区 问答 正文

CreateLogstore是什么?


在 project 下创建 logstore。
示例:


POST /logstores


请求语法






请求参数

属性名称类型是否必须描述
logstoreNamestringlogstore 的名称,在 project 下必须唯一。
ttlinteger数据的保存时间,单位为天。
shardCountinteger该 logstore 的 shard 数量


请求头


CreateLogstore 接口无特有请求头,关于 Log Service API 的公共请求头请参考 公共请求头

响应头


CreateLogstore 接口无特有响应头,关于 Log Service API 的公共响应头请参考 公共响应头

响应元素


HTTP 状态码返回 200。

错误码


除了返回 Log Service API 的 通用错误码,还可能返回如下特有错误码:
HTTP状态码ErrorCodeErrorMessage
400LogstoreAlreadyExistlogstore {logstoreName} already exist
500InternalServerErrorSpecified Server Error Message
400LogstoreInfoInvalidlogstore info is invalid
400ProjectQuotaExceedProject Quota Exceed


细节描述


创建过程中 quota 如果非法,则会创建不成功。

示例



请求示例:



展开
收起
轩墨 2017-10-23 13:53:31 1946 分享 版权
阿里云 AI 助理回答

根据您提供的信息,您想要了解如何在阿里云日志服务(Log Service)中通过API创建一个Logstore。下面是一个基于您示例的详细说明和请求示例。

请求概述

您将通过发送一个HTTP POST请求到阿里云日志服务的API端点来创建一个新的Logstore。这个操作需要您提供Project下的Logstore名称、数据保存时间(TTL)以及Shard数量等参数。

请求URL

POST https://log.aliyuncs.com/api/v2/projects/{projectName}/logstores

这里的{projectName}需要替换为您实际的项目名称。

请求体(Request Body)

请求体应包含JSON格式的数据,具体如下:

{
  "logstoreName": "your_logstore_name",
  "ttl": 30,
  "shardCount": 3
}
  • logstoreName: (必填)您要创建的Logstore的名称,在同一个Project下必须是唯一的。
  • ttl: (必填)数据的保存时间,单位为天。
  • shardCount: (必填)该Logstore的Shard数量,用于处理和存储日志数据。

请求头(Request Headers)

确保您的请求包含了阿里云API调用所需的公共请求头,如认证信息(AccessKeyId, Signature, Timestamp等)。具体的构造方法可以参考阿里云API签名文档。

响应

成功创建Logstore后,HTTP状态码应返回200 OK。如果遇到错误,响应中会包含相应的错误码和错误消息,例如LogstoreAlreadyExist表示Logstore已存在,ProjectQuotaExceed表示项目配额超出等。

示例请求

以下是一个使用cURL命令行工具发送请求的示例,假设您已经设置好了阿里云API的AccessKey ID和AccessKey Secret,并且计算了Signature等必要头部信息:

curl -X POST \
     'https://log.aliyuncs.com/api/v2/projects/your_project_name/logstores' \
     -H 'Content-Type: application/json' \
     -H 'x-log-bodyrawsize: 60' \
     -H 'Authorization: YOUR_AUTHORIZATION_HEADER' \
     -d '{"logstoreName":"example_logstore","ttl":30,"shardCount":3}'

请记得替换your_project_name和计算正确的YOUR_AUTHORIZATION_HEADER值。

以上就是通过API在阿里云Log Service中创建Logstore的基本步骤和示例。如果您在实际操作中遇到问题,建议查阅阿里云官方文档或联系客服获取帮助。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答
问答分类:
API
问答地址: