
# 接口调用示例
本节通过调用LTS的API创建日志组。
![](https://support.huaweicloud.com/api-lts/public_sys-resources/note_3.0-zh-cn.png)
通过IAM获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。
#### 涉及API
当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加"X-Auth-Token"到业务接口请求消息头中。
- IAM获取token的API。
- LTS创建日志组的API。
 
#### 具体步骤
1. Token认证，具体操作请参考[构造请求](https://support.huaweicloud.com/api-lts/lts_api_0004.html)。
2. 发送"POST /v2/{project_id}/groups"。
3. 在Request Header中增加"Content-Type"和"X-Auth-Token"。
4. 在Request Body中传入参数如下：
   ```
   POST /v2/{project_id}/groups 
   { 
   "log_group_name":"test001", //日志组名称(必填，String)
   "ttl_in_days":"7",  // 日志过期时间(默认，int)
   }
   ```
   请求响应成功后，返回已创建日志组的信息。
   ```
   { 
   "log_group_id":"2a0089e4-3001-11e9-9e9d-286ed48xxx", //日志组id（String）
   }
   ```
   若请求失败，则会返回错误码及对应的错误信息说明，详情请参考：[错误码](https://support.huaweicloud.com/api-lts/ErrorCode.html)。
   
 
