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

弹性文件存储

请输入
  • 文档首页
    • 弹性文件存储弹性文件存储 EFSAPI 参考权限组DescribePermissionGroups - 列举权限组
复制全文
下载 pdf
我的收藏
权限组
DescribePermissionGroups - 列举权限组
复制全文
下载 pdf
我的收藏
DescribePermissionGroups - 列举权限组
调用 DescribePermissionGroups 接口列举权限组。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值：DescribePermissionGroups​
要执行的操作，取值：DescribePermissionGroups。​
​
Version string 必选 示例值：2025-01-01​
API的版本，取值：2025-01-01。​
​
PageSize integer 可选 示例值：10​
每个分页包含的权限组个数。​
​
PageNumber integer 可选 示例值：1​
权限组分页页码。​
​
PermissionGroupId string 可选 示例值：pgroup-1f85db2c****​
权限组 ID。​
​
PermissionGroupName string 可选 示例值：groupname_test​
权限组名称。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
TotalCount integer 示例值：50​
权限组总数。​
​
PageSize integer 示例值：10​
每个分页包含的权限组个数。​
​
PageNumber integer 示例值：1​
权限组分页页码。​
​
PermissionGroups object[] 示例值：详情请参见示例代码​
权限组信息集合。​
PermissionGroupId string 示例值：pgroup-1f85db2c****​
权限组 ID。​
​
PermissionGroupName string 示例值：groupname_test​
权限组名称。​
​
Description string 示例值：for_test​
权限组描述信息。​
​
Status string 示例值：Available​
权限组状态。​
​
CreateTime string 示例值：2025-05-26T20:09:00+08:00​
权限组创建时间。​
​
UpdateTime string 示例值：2025-06-11T08:12:00+08:00​
权限组修改时间。​
​
PermissionRuleCount integer 示例值：1​
权限组规则数量。​
​
MountPointCount integer 示例值：1​
绑定挂载点数量。​
​
AccessPointCount integer 示例值：1​
绑定接入点数量。​
​
MountPoints object[] 示例值：详情请参见示例代码​
绑定的挂载点列表。​
MountPointId string 示例值：mount-a9c2****​
挂载点 ID。​
​
MountPointName string 示例值：mountpoint_test​
挂载点名称。​
​
FileSystemId string 示例值：efs-cnbjb24db2d21****​
文件系统 ID。​
​
FileSystemName string 示例值：filesystem_test​
文件系统名称。​
​
​
AccessPoints object[] 示例值：详情请参见示例代码​
绑定的接入点列表。​
AccessPointId string 示例值：ap-96cc****​
接入点 ID。​
​
AccessPointName string 示例值：accesspoint_test​
接入点名称。​
​
FileSystemId string 示例值：efs-cnbjb24db2d21****​
文件系统 ID。​
​
FileSystemName string 示例值：filesystem_test​
文件系统名称。​
​
​
​
​
​
请求示例​
​
POST /?Action=DescribePermissionGroups&Version=2025-01-01 HTTP/1.1​
Host: efs.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260121T092857Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260121/cn-beijing/efs/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
"PageSize": 10,​
"PageNumber": 1,​
"PermissionGroupId": "pgroup-1f85db2c****",​
"PermissionGroupName": "groupname_test"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20260202151045163014141004E6****",​
"Action": "DescribePermissionGroups",​
"Version": "2025-01-01",​
"Service": "efs",​
"Region": "cn-beijing"​
},​
"Result": {​
"TotalCount": 50,​
"PageSize": 10,​
"PageNumber": 1,​
"PermissionGroups": [​
{​
"PermissionGroupId": "pgroup-1f85db2c****",​
"PermissionGroupName": "groupname_test",​
"Description": "for_test",​
"Status": "Available",​
"CreateTime": "2025-05-26T20:09:00+08:00",​
"UpdateTime": "2025-06-11T08:12:00+08:00",​
"PermissionRuleCount": 1,​
"MountPointCount": 1,​
"AccessPointCount": 1,​
"MountPoints": [​
{​
"MountPointId": "mount-a9c2****",​
"MountPointName": "mountpoint_test",​
"FileSystemId": "efs-cnbjb24db2d21****",​
"FileSystemName": "filesystem_test"​
}​
],​
"AccessPoints": [​
{​
"AccessPointId": "ap-96cc****",​
"AccessPointName": "accesspoint_test",​
"FileSystemId": "efs-cnbjb24db2d21****",​
"FileSystemName": "filesystem_test"​
}​
]​
}​
]​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
500​
InternalError​
An internal error has occurred.​
内部错误。​
​
​
最近更新时间：2026.02.05 17:53:59
这个页面对您有帮助吗？
有用
有用
无用
无用