AI 助理
文档备案控制台
官方文档
输入文档关键字查找
首页

CreateDrive - 创建用户级别存储资源

更新时间：
复制为 MD 格式
产品详情
我的收藏

创建用户级别存储资源。

调试

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

调试

授权信息

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

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ecd:CreateDrive

create

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
RegionId

string

否

地域 ID。

cn-hangzhou
AliUid

integer

否

阿里云账号 ID。

1202****
UserId

string

否

用户 ID。

user01
DomainId

string

否

存储资源 ID。

说明

可通过 DescribeDrives 接口获取。

dom-aaaa****
ExternalDomainId

string

否

外部存储资源 ID。

说明

可通过 DescribeDrives 接口获取。

1234****
ResourceType

string

否

存储资源类型。

枚举值：

  • NAS :

    NAS 存储

  • PDS :

    PDS 存储

NAS
Type

string

否

存储资源用途。

枚举值：

  • DESKTOP :

    数据盘空间

  • USER_PROFILE :

    用户个人数据空间

USER_PROFILE
DriveName

string

否

用户级别存储资源名称。

test01
Description

string

否

用户级别存储资源简介。

test01
ProfileRoaming

boolean

否

说明

此参数已废弃。

-

返回参数

名称

类型

描述

示例值

object

返回结果。

RequestId

string

请求 ID。

B7AA****
Message

string

响应消息。

successful
Code

string

响应代码，200 表示成功。

200
Success

boolean

是否成功。

true
Drive

object

用户级别的存储资源。

Id

string

ID。

1
GmtCreate

string

创建时间。

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

string

修改时间。

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

string

阿里云账号 ID。

1202****
DomainId

string

存储资源 ID。

dom-aaaa****
DriveId

string

用户级别的存储资源 ID。

dri-aaaa****
ExternalDriveId

string

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

说明

仅存储资源为 PDS 时返回此参数。

1100****
UserId

string

用户 ID。

user01
ExternalUserId

string

外部用户 ID。

user01@cn-hangzhou.120****
Name

string

存储资源名称。

test****
Description

string

存储资源简介。

test****
TotalSize

integer

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

说明

单位：字节。

536870912000
UsedSize

integer

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

说明

单位：字节。

243175936
Status

string

用户级别存储资源状态。

枚举值：

  • INIT :

    初始化

  • MAINTAIN :

    维护中

  • DELETING :

    删除中

  • INVALID :

    失效

  • NORMAL :

    正常

  • FAIL :

    失败

NORMAL
Type

string

存储资源用途。

枚举值：

  • DESKTOP :

    数据盘空间

  • USER_PROFILE :

    用户个人数据空间

USER_PROFILE
ProfileRoaming

boolean
说明

此参数已废弃。

-

示例

正常返回示例

JSON格式

{
  "RequestId": "B7AA****",
  "Message": "successful",
  "Code": "200",
  "Success": true,
  "Drive": {
    "Id": "1",
    "GmtCreate": "2025-07-02T08:42:26.000+00:00",
    "GmtModified": "2025-07-07T02:46:04.000+00:00",
    "AliUid": "1202****",
    "DomainId": "dom-aaaa****",
    "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
  }
}

错误码

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

变更历史

更多信息，参考变更详情。

上一篇：存储下一篇：DeleteDrive - 删除用户级别存储资源