
# 更新存储
#### 功能介绍
更新存储
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=IoTAnalytics&api=UpdateDataStore)中调试该接口，支持自动认证鉴权。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 | 属性，更新存储时属性只可新增，不可修改或删除原有属性  |
   
 表4Tag 
| 参数          | 是否必选 | 参数类型   | 描述                          |
|:---|:---|:---|:---|
| name        | 否    | String | 标签名称 最小长度：**0** 最大长度：**64** |
| description | 否    | String | 标签描述 最小长度：**0** 最大长度：**64** |
   
 表5Metric 
| 参数          | 是否必选 | 参数类型   | 描述                           |
|:---|:---|:---|:---|
| name        | 否    | String | 指标名称 最小长度：**0** 最大长度：**64**  |
| type        | 否    | String | 指标值类型 最小长度：**0** 最大长度：**64** |
| description | 否    | String | 指标描述 最小长度：**0** 最大长度：**64**  |
| unit        | 否    | String | 指标单位 最小长度：**0** 最大长度：**64**  |
   
 表6Property 
| 参数          | 是否必选 | 参数类型   | 描述                           |
|:---|:---|:---|:---|
| 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**  |
   
 表8Tag 
| 参数          | 参数类型   | 描述                          |
|:---|:---|:---|
| name        | String | 标签名称 最小长度：**0** 最大长度：**64** |
| description | String | 标签描述 最小长度：**0** 最大长度：**64** |
   
 表9Metric 
| 参数          | 参数类型   | 描述                           |
|:---|:---|:---|
| name        | String | 指标名称 最小长度：**0** 最大长度：**64**  |
| type        | String | 指标值类型 最小长度：**0** 最大长度：**64** |
| description | String | 指标描述 最小长度：**0** 最大长度：**64**  |
| unit        | String | 指标单位 最小长度：**0** 最大长度：**64**  |
   
 表10Property 
| 参数          | 参数类型   | 描述                           |
|:---|:---|:---|
| 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 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-iotanalytics/ErrorCode.html)。
