文档首页/ 专属分布式存储服务 DSS/ API参考/ API说明/ DSS管理/ 更新专属存储池名称 - UpdatePool
更新时间:2025-11-24 GMT+08:00
分享

更新专属存储池名称 - UpdatePool

功能介绍

更新专属存储池名称

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项

URI

PUT /v1/{project_id}/pools/{dss_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。获取方法请参见获取项目ID

dss_id

String

专属分布式存储池ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

pool

DssUpdatePoolDetail object

表4 DssUpdatePoolDetail

参数

是否必选

参数类型

描述

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

专属分布式存储池的状态,详细信息请参考专属分布式存储池状态

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

专属存储详情

错误码

请参见错误码

相关文档