DescribeDrives - 查询用户级别的存储资源

查询用户级别的存储资源。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ecd:DescribeDrives
*全部资源
*

请求参数

名称类型必填描述示例值
RegionIdstring

地域 ID。可以调用 DescribeRegions 获取无影云电脑支持的地域列表。

cn-hangzhou
UserIdstring

用户 ID。

user01
DomainIdsarray

存储资源 ID 列表。

string

存储资源 ID。

dom-aaaa****
ResourceTypestring

存储资源类型。

枚举值:
  • NASNAS存储
  • PDSPDS存储
NAS
MaxResultsinteger

分页查询时每页行数。

  • 最大值:500
  • 默认值:20
20
NextTokenstring

下一个查询开始的 Token,NextToken 为空表示没有下一个。

AAAA****

返回参数

名称类型描述示例值
object

返回结果。

RequestIdstring

请求 ID。

B7AA****
Successboolean

是否成功。

true
Codestring

响应代码,200 表示成功。

200
Messagestring

响应消息。

successful
Countinteger

总数。

2
NextTokenstring

下一个查询开始的 Token,NextToken 为空表示没有下一个。

AAAA****
Drivesarray<object>

用户级别的存储资源列表。

Driveobject

用户级别的存储资源。

Idstring

ID。

说明 此参数不需要关注
1
GmtCreatestring

创建时间。

2025-07-02T08:42:26.000+00:00
GmtModifiedstring

修改时间。

2025-07-07T02:46:04.000+00:00
AliUidlong

阿里云账号 id。

1202****
DomainIdstring

存储资源 ID。

dom-aaaa****
ExternalDomainIdstring

外部存储资源 ID。

  • 当存储资源为 NAS 时,此参数返回 NAS 的 ID。
  • 当存储资源为 PDS 时,此参数返回 PDS 的 ID。
0976****
DriveIdstring

用户级别的存储资源 ID。

dri-aaaa****
ExternalDriveIdstring

外部用户级别的存储资源 ID。

说明 仅存储资源为 PDS 时返回此参数。
1100****
UserIdstring

用户 ID。

user01
ExternalUserIdstring

外部用户 ID。

说明 仅存储资源为 PDS 时返回此参数。
user01@cn-hangzhou.120****
Namestring

存储资源名称。

test****
Descriptionstring

存储资源简介。

test****
TotalSizelong

用户级别存储资源总容量。

536870912000
UsedSizelong

用户级别存储资源已用容量。

243175936
Statusstring

用户级别存储资源状态。

枚举值:
  • INIT初始化
  • MAINTAIN维护中
  • DELETING删除中
  • INVALID失效
  • NORMAL正常
  • FAIL失败
NORMAL
Typestring

存储资源用途。

枚举值:
  • DESKTOP数据盘空间
  • USER_PROFILE用户个人数据空间
USER_PROFILE
ProfileRoamingboolean
说明 此参数已废弃。
-
DesktopGroupCountinteger

关联云电脑池数量。

说明 仅存储资源为 NAS 且用途为 USER_PROFILE 时返回此参数。
1
DesktopGroupsarray<object>

关联云电脑池详情列表。

说明 仅存储资源为 NAS 且用途为 USER_PROFILE 时返回此参数。
DesktopGroupobject

云电脑池详情。

DesktopGroupIdstring

云电脑池 ID。

dg-aaaa****
DesktopGroupNamestring

云电脑池名称。

group01
EnableProfileManagementboolean

是否开启了 UPM 功能。

true

示例

正常返回示例

JSON格式

{
  "RequestId": "B7AA****",
  "Success": true,
  "Code": 200,
  "Message": "successful",
  "Count": 2,
  "NextToken": "AAAA****",
  "Drives": [
    {
      "Id": 1,
      "GmtCreate": "2025-07-02T08:42:26.000+00:00",
      "GmtModified": "2025-07-07T02:46:04.000+00:00",
      "AliUid": 0,
      "DomainId": "dom-aaaa****",
      "ExternalDomainId": "0976****",
      "DriveId": "dri-aaaa****",
      "ExternalDriveId": "1100****",
      "UserId": "user01",
      "ExternalUserId": "user01@cn-hangzhou.120****",
      "Name": "test****",
      "Description": "test****",
      "TotalSize": 536870912000,
      "UsedSize": 243175936,
      "Status": "NORMAL",
      "Type": "USER_PROFILE",
      "ProfileRoaming": true,
      "DesktopGroupCount": 1,
      "DesktopGroups": [
        {
          "DesktopGroupId": "dg-aaaa****",
          "DesktopGroupName": "group01"
        }
      ],
      "EnableProfileManagement": true
    }
  ]
}

错误码

访问错误中心查看更多错误码。