更新时间:2023-02-01 GMT+08:00
分享

更新存储

功能介绍

更新存储

调试

您可以在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

错误码

请参见错误码

分享:

    相关文档

    相关产品