创建存储组

功能介绍

创建存储组

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v1/{project_id}/data-store-groups

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID 最小长度：1 最大长度：128

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	租户Token 最小长度：1 最大长度：65535

表3 请求Body参数
参数	是否必选	参数类型	描述
name	否	String	存储组名称最小长度：0 最大长度：64
description	否	String	描述最小长度：0 最大长度：1024
warm_data_retention_policy	否	String	温数据老化策略，单位只支持d（天），且只支持整数，如365天则可配置为“365d”，如“365h”或“360.5d”等均不被支持最小长度：0 最大长度：64
cold_data_retention_policy	否	String	冷数据老化策略，单位只支持d（天），且只支持整数，如365天则可配置为“365d”，如“365h”或“360.5d”等均不被支持最小长度：0 最大长度：64

响应参数

状态码： 201

表4 响应Body参数
参数	参数类型	描述
group_id	String	存储组 ID 最小长度：0 最大长度：64
name	String	存储组名称最小长度：0 最大长度：64
description	String	描述最小长度：0 最大长度：1024
warm_data_usage	Long	温数据存储用量最小值：0 最大值：1099511627776
data_store_count	Long	此存储组下存储实例的个数最小值：0 最大值：1024
cold_data_usage	Long	冷数据存储用量最小值：0 最大值：1099511627776
warm_data_retention_policy	String	温数据老化策略，单位只支持d（天），且只支持整数，如365天则可配置为“365d”，如“365h”或“360.5d”等均不被支持最小长度：0 最大长度：64
cold_data_retention_policy	String	冷数据老化策略，单位只支持d（天），且只支持整数，如365天则可配置为“365d”，如“365h”或“360.5d”等均不被支持最小长度：0 最大长度：64
created_time	String	创建时间最小长度：0 最大长度：64
modified_time	String	修改时间最小长度：0 最大长度：64
type	String	存储类型，有资产存储(取值:AssetStorage)、设备存储(取值:DeviceStorage)两种类型最小长度：0 最大长度：64

状态码： 400

表5 响应Body参数
参数	参数类型	描述
error_code	String	错误编码最小长度：0 最大长度：100
error_msg	String	错误消息最小长度：0 最大长度：1024

状态码： 401

表6 响应Body参数
参数	参数类型	描述
error_code	String	错误编码最小长度：0 最大长度：100
error_msg	String	错误消息最小长度：0 最大长度：1024

状态码： 403

表7 响应Body参数
参数	参数类型	描述
error_code	String	错误编码最小长度：0 最大长度：100
error_msg	String	错误消息最小长度：0 最大长度：1024

状态码： 409

表8 响应Body参数
参数	参数类型	描述
error_code	String	错误编码最小长度：0 最大长度：100
error_msg	String	错误消息最小长度：0 最大长度：1024

状态码： 500

表9 响应Body参数
参数	参数类型	描述
error_code	String	错误编码最小长度：0 最大长度：100
error_msg	String	错误消息最小长度：0 最大长度：1024

请求示例

{
  "name" : "dataStoreGroup1",
  "description" : "some description about this group",
  "warm_data_retention_policy" : "7d"
}

响应示例

状态码： 201

Created

{
  "group_id" : "0fba303d-687f-447c-9c54-999156867cf9",
  "name" : "dataStoreGroup1",
  "description" : "some description about this group",
  "data_store_count" : 0,
  "warm_data_retention_policy" : "7d",
  "created_time" : "2020-08-14T23:21:49Z",
  "modified_time" : "2020-08-14T23:21:49Z",
  "type" : "DeviceStorage"
}