# 更新专属存储池名称 - UpdatePool
#### 功能介绍
更新专属存储池名称
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dss/dss_02_0012.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dss/dss_02_0019.html)。
#### URI
PUT /v1/{project_id}/pools/{dss_id}
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                              |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID。获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-dss/dss_02_0025.html)。 |
| dss_id     | 是    | String | 专属分布式存储池ID。                                                                     |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                        |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
表3请求Body参数 
| 参数   | 是否必选 | 参数类型                                                                    | 描述 |
|:---|:---|:---|:---|
| pool | 否    | [DssUpdatePoolDetail] object |    |
   
 表4DssUpdatePoolDetail 
| 参数   | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| name | 否    | String | 专属存储名字。 |
   
#### 响应参数
**状态码：200**
表5响应Body参数 
| 参数                          | 参数类型    | 描述                                                                                         |
|:---|:---|:---|
| name                        | String  | 专属分布式存储池名称。                                                                                |
| id                          | String  | 专属分布式存储池ID。                                                                                |
| project_id                  | String  | 所属的项目ID。                                                                                   |
| capacity                    | Integer | 申请的专属分布式存储池容量，单位GB。                                                                        |
| type                        | String  | 专属分布式存储池的存储类型。 SAS：高IO专属分布式存储池。 SSD：超高IO专属分布式存储池。                                          |
| status                      | String  | 专属分布式存储池的状态，详细信息请参考[专属分布式存储池状态](https://support.huaweicloud.com/api-dss/dss_02_0023.html)。 |
| availability_zone           | String  | 专属分布式存储池所在AZ。                                                                              |
| created_at                  | String  | 创建时间。                                                                                      |
| total_capacity_gb           | Integer | 总容量。                                                                                       |
| used_capacity_gb            | Integer | 已使用容量。                                                                                     |
| provisioned_capacity_gb     | Integer | 已分配容量。                                                                                     |
| max_over_subscription_ratio | Float   | 超分比。                                                                                       |
   
#### 请求示例
```
PUT https://{endpoint}/v1/{project_id}/pools/{dss_id}
{
  "pool" : {
    "name" : "dss-test"
  }
}
```
#### 响应示例
**状态码：200**
专属存储详情
```
{
  "name" : "dedicatedStorage01",
  "id" : "c950ee97-587c-4f24-8a74-3367e3da570f",
  "project_id" : "63d910f2705a487ebe4e1c274748d9e1",
  "capacity" : 100,
  "type" : "SSD",
  "availability_zone" : "AZ1",
  "status" : "available",
  "created_at" : "2022-12-18T15:57:56.299000",
  "total_capacity_gb" : 1000,
  "used_capacity_gb" : 300,
  "provisioned_capacity_gb" : 700,
  "max_over_subscription_ratio" : "1.0"
}
```
#### 状态码
| 状态码 | 描述     |
|:---|:---|
| 200 | 专属存储详情 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dss/ErrorCode.html)。