更新时间：2025-11-25 GMT+08:00
创建Ticket - CreateTickets
功能介绍
创建Ticket。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
POST /v1/{project_id}/tickets
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释： 项目ID。获取方法请参见获取项目ID。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释： 用户Token。通过调用IAM服务获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
embed_id |
是 |
String |
参数解释： 嵌入分析id。 取值范围： 不涉及 |
|
user_id |
是 |
String |
参数解释： 用户id。 取值范围： 不涉及 |
|
group_ids |
否 |
Array of strings |
参数解释： 用户组id列表。 取值范围： 不涉及 |
|
ticket_num |
否 |
Integer |
参数解释： ticket使用次数。 取值范围： 不涉及 |
|
session_auto_renew |
否 |
Boolean |
参数解释： 是否允许session自动延期。 取值范围： 不涉及 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
ticket |
String |
参数解释： 生成的ticket。 取值范围： 不涉及 |
请求示例
创建ticket。
POST https://{endpoint}/v1/{project_id}/tickets
{
"user_id" : "aaa18eb155xxxxxxxxxxxxxxxxxxx",
"ticket_num" : 1000,
"embed_id" : "8e59605cxxxxxxxxxxxx"
}
响应示例
状态码：200
创建ticket成功。
{
"ticket" : "dea43d00388xxxxxxxxxxxxxx"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
创建ticket成功。 |
错误码
请参见错误码。
父主题： Ticket管理
