创建应用模板
功能介绍
应用服务器可调用此接口为创建批量处理任务,对多个设备进行批量操作。当前支持批量软固件升级、批量创建设备、批量删除设备、批量冻结、批量解冻、批量下发同步命令、批量下发异步命令。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
app_id |
是 |
String |
应用ID 最小长度:4 最大长度:32 |
app_name |
否 |
String |
应用名称 最小长度:4 最大长度:64 |
description |
否 |
String |
应用描述 最小长度:1 最大长度:255 |
app_type |
是 |
String |
应用类型 最小长度:1 最大长度:64 |
响应参数
状态码: 201
参数 |
参数类型 |
描述 |
---|---|---|
app_id |
String |
应用模板ID 最小长度:1 最大长度:64 |
description |
String |
应用描述 最小长度:0 最大长度:256 |
app_type |
String |
应用类型 最小长度:0 最大长度:64 |
provider_type |
String |
应用来源 最小长度:0 最大长度:64 |
create_time |
String |
创建时间 最小长度:0 最大长度:256 |
update_time |
String |
最后一次修改时间 最小长度:0 最大长度:256 |
请求示例
POST https://{endpoint}/v3/{project_id}/apps { "app_id" : "test-app", "app_name" : "test-app", "description" : "this is a test app", "app_type" : "CloudService" }
响应示例
状态码: 201
Created
{ "app_id" : "string", "description" : "string", "app_type" : "string", "provider_type" : "string", "create_time" : "string", "update_time" : "string" }
状态码
状态码 |
描述 |
---|---|
201 |
Created |
400 |
BAD REQUEST |
401 |
Unauthorized |
403 |
FORBIDDEN |
500 |
Internal Server Error |
错误码
请参见错误码。