在 project 下创建 logstore。
示例:
POST /logstores
属性名称 | 类型 | 是否必须 | 描述 |
logstoreName | string | 是 | logstore 的名称,在 project 下必须唯一。 |
ttl | integer | 是 | 数据的保存时间,单位为天。 |
shardCount | integer | 是 | 该 logstore 的 shard 数量 |
HTTP状态码 | ErrorCode | ErrorMessage |
400 | LogstoreAlreadyExist | logstore {logstoreName} already exist |
500 | InternalServerError | Specified Server Error Message |
400 | LogstoreInfoInvalid | logstore info is invalid |
400 | ProjectQuotaExceed | Project Quota Exceed |
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
根据您提供的信息,您想要了解如何在阿里云日志服务(Log Service)中通过API创建一个Logstore。下面是一个基于您示例的详细说明和请求示例。
您将通过发送一个HTTP POST请求到阿里云日志服务的API端点来创建一个新的Logstore。这个操作需要您提供Project下的Logstore名称、数据保存时间(TTL)以及Shard数量等参数。
POST https://log.aliyuncs.com/api/v2/projects/{projectName}/logstores
这里的{projectName}
需要替换为您实际的项目名称。
请求体应包含JSON格式的数据,具体如下:
{
"logstoreName": "your_logstore_name",
"ttl": 30,
"shardCount": 3
}
logstoreName
: (必填)您要创建的Logstore的名称,在同一个Project下必须是唯一的。ttl
: (必填)数据的保存时间,单位为天。shardCount
: (必填)该Logstore的Shard数量,用于处理和存储日志数据。确保您的请求包含了阿里云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的基本步骤和示例。如果您在实际操作中遇到问题,建议查阅阿里云官方文档或联系客服获取帮助。