获取通用文件系统列表(待废弃) - ListSfs30Volumes
功能介绍
该API用于获取用户的通用文件系统列表。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /api/v3.1/storage/sfs30/volumes
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
region |
否 |
String |
参数解释: region名称为可选参数,若提供region则会返回指定region的obs资源列表;若不指定则返回所有region的obs资源列表。 通用文件系统支持的可用区请参考地区和终端节点 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
vpcid |
否 |
String |
参数解释: vpcid为可选参数,若提供vpcid则会返回对指定vpc授权了的通用文件系统资源列表;若不指定则返回通用文件系统全量资源列表。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Cluster-ID |
否 |
String |
集群ID,使用https://Endpoint/uri这种URL格式时必须指定此参数。获取方式请参见如何获取接口URI中参数。 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
获取通用文件系统列表成功 |
错误码
请参见错误码。