文档首页/ 云容器引擎 CCE/ API参考/ 历史API/ 存储管理/ 获取通用文件系统列表(待废弃) - ListSfs30Volumes
更新时间:2025-12-19 GMT+08:00
分享

获取通用文件系统列表(待废弃) - ListSfs30Volumes

功能介绍

该API用于获取用户的通用文件系统列表。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /api/v3.1/storage/sfs30/volumes

表1 Query参数

参数

是否必选

参数类型

描述

region

String

参数解释

region名称为可选参数,若提供region则会返回指定region的obs资源列表;若不指定则返回所有region的obs资源列表。

通用文件系统支持的可用区请参考地区和终端节点

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

vpcid

String

参数解释

vpcid为可选参数,若提供vpcid则会返回对指定vpc授权了的通用文件系统资源列表;若不指定则返回通用文件系统全量资源列表。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Cluster-ID

String

集群ID,使用https://Endpoint/uri这种URL格式时必须指定此参数。获取方式请参见如何获取接口URI中参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

Name

String

参数解释:

通用文件系统名称

取值范围:

不涉及

CreationDate

String

参数解释:

通用文件系统创建时间

取值范围:

不涉及

Location

String

参数解释:

通用文件系统所在可用区

取值范围:

不涉及

请求示例

获取用户的通用文件系统列表

GET /api/v3.1/storage/sfs30/volumes

[ {
  "Name" : "xxxxxxxxxxxxx",
  "CreationDate" : "2025-12-08T06:59:27.088Z",
  "Location" : "cn-north-7"
} ]

响应示例

状态码:200

获取通用文件系统列表成功

[ {
  "Name" : "xxxxxxxxxxxxx",
  "CreationDate" : "2025-12-08T06:59:27.088Z",
  "Location" : "cn-north-7"
} ]

状态码

状态码

描述

200

获取通用文件系统列表成功

错误码

请参见错误码

相关文档