文档首页/ IoT数据分析 IoTA/ API参考/ API列表/ 存储管理/ 更新存储
更新时间：2023-02-01 GMT+08:00
查看PDF
分享

更新存储

功能介绍

更新存储

调试

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

URI

PUT /v1/{project_id}/data-stores/{data_store_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目 ID

最小长度：1

最大长度：128

data_store_id

是

String

存储 ID

最小长度：1

最大长度：64

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

租户Token

最小长度：1

最大长度：65535
表3 请求Body参数

参数

是否必选

参数类型

描述

name

否

String

存储名称

最小长度：0

最大长度：64

tags

否

Array of Tag objects

标签，更新存储时标签只可新增，不可修改或删除原有标签

metrics

否

Array of Metric objects

指标

properties

否

Array of Property objects

属性，更新存储时属性只可新增，不可修改或删除原有属性
表4 Tag

参数

是否必选

参数类型

描述

name

否

String

标签名称

最小长度：0

最大长度：64

description

否

String

标签描述

最小长度：0

最大长度：64
表5 Metric

参数

是否必选

参数类型

描述

name

否

String

指标名称

最小长度：0

最大长度：64

type

否

String

指标值类型

最小长度：0

最大长度：64

description

否

String

指标描述

最小长度：0

最大长度：64

unit

否

String

指标单位

最小长度：0

最大长度：64
表6 Property

参数

是否必选

参数类型

描述

name

否

String

属性名称

最小长度：0

最大长度：64

type

否

String

属性值类型

最小长度：0

最大长度：64

description

否

String

属性描述

最小长度：0

最大长度：64

unit

否

String

属性单位

最小长度：0

最大长度：64

响应参数

状态码： 200

表7 响应Body参数

参数

参数类型

描述

data_store_id

String

存储 ID

最小长度：0

最大长度：64

name

String

存储名称

最小长度：0

最大长度：64

group_id

String

存储 ID

最小长度：0

最大长度：64

tags

Array of Tag objects

标签

metrics

Array of Metric objects

指标

properties

Array of Property objects

属性

created_time

String

创建时间

最小长度：0

最大长度：64

modified_time

String

更新时间

最小长度：0

最大长度：64
表8 Tag

参数

参数类型

描述

name

String

标签名称

最小长度：0

最大长度：64

description

String

标签描述

最小长度：0

最大长度：64
表9 Metric

参数

参数类型

描述

name

String

指标名称

最小长度：0

最大长度：64

type

String

指标值类型

最小长度：0

最大长度：64

description

String

指标描述

最小长度：0

最大长度：64

unit

String

指标单位

最小长度：0

最大长度：64
表10 Property

参数

参数类型

描述

name

String

属性名称

最小长度：0

最大长度：64

type

String

属性值类型

最小长度：0

最大长度：64

description

String

属性描述

最小长度：0

最大长度：64

unit

String

属性单位

最小长度：0

最大长度：64

状态码： 400

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

最小长度：0

最大长度：100

error_msg

String

错误消息

最小长度：0

最大长度：1024

状态码： 401

表12 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

最小长度：0

最大长度：100

error_msg

String

错误消息

最小长度：0

最大长度：1024

状态码： 403

表13 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

最小长度：0

最大长度：100

error_msg

String

错误消息

最小长度：0

最大长度：1024

状态码： 404

表14 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

最小长度：0

最大长度：100

error_msg

String

错误消息

最小长度：0

最大长度：1024

状态码： 409

表15 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

最小长度：0

最大长度：100

error_msg

String

错误消息

最小长度：0

最大长度：1024

状态码： 500

表16 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

最小长度：0

最大长度：100

error_msg

String

错误消息

最小长度：0

最大长度：1024

请求示例

{
  "name" : "SmokeDetector_Storage",
  "tags" : [ {
    "name" : "device_id"
  }, {
    "name" : "category"
  } ],
  "properties" : [ {
    "name" : "temperature",
    "type" : "double"
  } ]
}

响应示例

状态码： 200

OK

{
  "data_store_id" : "47fc262a-5cce-4a47-a17d-392498d36948",
  "name" : "SmokeDetector_Storage",
  "group_id" : "0fba303d-687f-447c-9c54-999156867cf9",
  "tags" : [ {
    "name" : "device_id"
  }, {
    "name" : "category"
  } ],
  "properties" : [ {
    "name" : "temperature",
    "type" : "double"
  } ],
  "created_time" : "2020-08-14T23:21:49Z",
  "modified_time" : "2020-08-14T23:21:49Z"
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

409

Conflict

500

Internal Server Error

错误码

请参见错误码。

父主题： 存储管理

相关文档