You need to enable JavaScript to run this app.
文档中心
文件存储 vePFS

文件存储 vePFS

复制全文
下载 pdf
挂载服务
DescribeMountServices - 查询挂载服务
复制全文
下载 pdf
DescribeMountServices - 查询挂载服务
调用 DescribeMountServices 接口,查询挂载服务详情。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值:DescribeMountServices​
要执行的操作,取值:DescribeMountServices。​
​
Version string 必选 示例值:2022-01-01​
API的版本,取值:2022-01-01。​
​
Filters object[] 可选 示例值:详情请参见请求示例。​
挂载服务查询过滤器。​
Key string 必选 示例值:Status​
根据特性筛选指定特征的实例。支持筛选的参数如下:​
  • Status:根据挂载服务状态精确筛选,支持多选,使用半角逗号(,)分隔。​
  • FileSystemId:根据文件系统 ID 精确筛选。​
  • MountServiceName:根据挂载服务名称模糊筛选,不支持多选。​
  • MountServiceId:根据挂载服务 ID 精确筛选。​
​
Value string 必选 示例值:Running​
筛选项目的值。​
​
​
OrderBy string 可选 示例值:CreateTimeDesc​
挂载服务排序方式,取值说明如下:​
  • CreateTimeDesc:按照挂载服务的创建时间降序。​
  • CreateTimeAsc:按照挂载服务的创建时间降序。​
  • NameDesc:按照挂载服务的名称升序。​
  • NameAsc:按照挂载服务的名称升序。​
​
PageSize integer 可选 示例值:10​
每页记录数。取值为 1~100 间的整数,默认值为10。​
​
PageNumber integer 可选 示例值:1​
挂载服务信息列表的页码,取值为不超过 Integer 数据类型的最大值,起始值为 1。​
​
Project string 可选 示例值:default​
项目名。​
​
LanguageCode string 可选 示例值:zh​
显示的语言类型,取值说明如下:​
  • zh:中文。​
  • en:英文。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
TotalCount integer 示例值:2​
挂载服务个数。​
​
MountServices object[] 示例值:详情请参见返回示例。​
挂载点详情。​
Nodes object[] 示例值:详情请参见返回示例。​
客户端管理节点列表。​
NodeId string 示例值:i-yclmdnskx838df3y****​
ECS 实例 ID。​
​
DefaultPassword string 示例值:948E4=9@2Jbq****​
ECS 实例初始登录密码。​
​
​
VpcId string 示例值:vpc-13fz0iip9nlds3n6nu4fi****​
私有网络 ID。​
​
Status string 示例值:Running​
挂载服务状态,说明如下:​
  • Creating:创建中。​
  • CreateError:创建失败。​
  • Running:运行中。​
  • Updating:更新中。​
  • UpdateError:更新失败。​
  • Deleting:删除中。​
  • DeleteError:删除失败。​
  • Deleted:已删除。​
  • Attaching:绑定中。​
  • AttachError:绑定失败。​
  • Detaching:解绑中。​
  • DetachError:解绑失败。​
  • Stopped:关停。​
  • Error:错误。​
​
ZoneId string 示例值:cn-beijing-b​
可用区 ID。​
​
Project string 示例值:default​
挂载服务所属项目。​
​
RegionId string 示例值:cn-beijing​
地域信息。​
​
SubnetId string 示例值:subnet-13fz1bsbrsw743n6nu47c****​
子网 ID。​
​
ZoneName string 示例值:华北2(北京)-可用区B​
可用区名称。​
​
AccountId string 示例值:210015****​
用户 ID。​
​
CreateTime string 示例值:2023-07-18T17:10:03+08:00​
创建时间。​
​
VersionNumber string 示例值:1.4.1​
挂载服务版本号。​
​
MountServiceId string 示例值:mount-94eb****​
挂载服务 ID。​
​
SecurityGroupId string 示例值:sg-mioirewk8zcw5smt1ba8****​
客户端网卡安全组 ID。​
​
MountServiceName string 示例值:mountservice​
挂载服务名称。​
​
AttachFileSystems object[] 示例值:详情请参见返回示例。​
挂载实例信息。​
Status string 示例值:Attached​
绑定状态,说明如下:​
  • Attaching:绑定中。​
  • AttachError:绑定失败。​
  • Attached:已绑定。​
  • Detaching:解绑中。​
  • DetachError:解绑失败。​
​
AccountId string 示例值:210015****​
火山引擎账户 ID。​
​
CustomerPath string 示例值:/vepfs-test​
用户挂载路径。​
​
FileSystemId string 示例值:vepfs-cnbjbf3c46b6****​
文件系统 ID。​
​
FileSystemName string 示例值:lltest​
文件系统名称。​
​
​
​
PageSize integer 示例值:10​
每页记录数。取值为 1~100 间的整数,默认值为 10。​
​
PageNumber integer 示例值:1​
挂载服务信息列表的页码,取值为不超过 Integer 数据类型的最大值,起始值为 1。​
​
​
​
请求示例​
​
POST /?Action=DescribeMountServices&Version=2022-01-01 HTTP/1.1​
Host: https://api.volcengine.com/api-explorer/?action=DescribeMountServices&groupName=%E6%96%87%E4%BB%B6%E7%B3%BB%E7%BB%9F&serviceCode=vepfs&version=2022-01-01​
Content-Type: application/json; charset=UTF-8​
X-Date: 20250728T074201Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250728/cn-beijing/vepfs/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
"Filters": [​
{​
"Key": "Status",​
"Value": "Running"​
}​
],​
"OrderBy": "CreateTimeDesc",​
"PageSize": 10,​
"PageNumber": 1,​
"Project": "default",​
"LanguageCode": "zh"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "202507281542040481231282124B209D",​
"Action": "DescribeMountServices",​
"Version": "2022-01-01",​
"Service": "vepfs",​
"Region": "cn-beijing"​
},​
"Result": {​
"TotalCount": 2,​
"MountServices": [​
{​
"Nodes": [​
{​
"NodeId": "i-yclmdnskx838df3y****",​
"DefaultPassword": "948E4=9@2Jbq****"​
}​
],​
"VpcId": "vpc-13fz0iip9nlds3n6nu4fi****",​
"Status": "Running",​
"ZoneId": "cn-beijing-b",​
"Project": "default",​
"RegionId": "cn-beijing",​
"SubnetId": "subnet-13fz1bsbrsw743n6nu47c****",​
"ZoneName": "华北2(北京)-可用区B",​
"AccountId": "210015****",​
"CreateTime": "2023-07-18T17:10:03+08:00",​
"VersionNumber": "1.4.1",​
"MountServiceId": "mount-94eb****",​
"SecurityGroupId": "sg-mioirewk8zcw5smt1ba8****",​
"MountServiceName": "mountservice",​
"AttachFileSystems": [​
{​
"Status": "Attached",​
"AccountId": "210015****",​
"CustomerPath": "/vepfs-test",​
"FileSystemId": "vepfs-cnbjbf3c46b6****",​
"FileSystemName": "lltest"​
}​
]​
}​
],​
"PageSize": 10,​
"PageNumber": 1​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
500​
InternalError​
Service has some internal Error. Pls Contact With Admin.​
内部错误。​
​
​
最近更新时间:2025.08.06 10:50:55
这个页面对您有帮助吗?
有用
有用
无用
无用