创建并挂载云硬盘 - CreateAttachUDisk
简介
创建并挂载UDisk磁盘
💡 “17092”: “该磁盘版本过低,无法开启数据方舟”
定义
公共参数
| 参数名 | 类型 | 描述信息 | 必填 | 
|---|---|---|---|
| Action | string | 对应的 API 指令名称,当前 API 为 CreateAttachUDisk | Yes | 
| PublicKey | string | 用户公钥,可从 控制台 获取 | Yes | 
| Signature | string | 根据公钥及 API 指令生成的用户签名,参见 签名算法 | Yes | 
请求参数
| 参数名 | 类型 | 描述信息 | 必填 | 
|---|---|---|---|
| Region | string | 地域。 参见 地域和可用区列表 | Yes | 
| Zone | string | 可用区。参见 可用区列表 | Yes | 
| ProjectId | string | 项目ID。不填写为默认项目,子帐号必须填写。 请参考GetProjectList接口 | No | 
| Size | int | 购买UDisk大小,单位:GB,普通数据盘:范围[1~8000];SSD数据盘、经济型SSD数据盘:范围[1~8000];RSSD数据盘、经济型RSSD数据盘:范围[1~32000];高效数据盘:范围[1~32000]。 | Yes | 
| Name | string | 实例名称 | Yes | 
| UHostId | string | UHost实例ID。当创建云盘类型为RSSDDataDisk时,根据传入的UHostId,创建与虚机在同一PodId下的云盘。【UHostId和HostId必须选填一个,本字段即将废弃,建议使用HostId】 | No | 
| ChargeType | string | Year , Month, Dynamic, Postpay, Trial 。 Size小于等于2000时,默认为Dynamic;Size大于2000时,默认为Month。 | No | 
| Quantity | int | 购买时长 默认: 1 | No | 
| UDataArkMode | string | 【开启数据方舟入口已关闭】是否开启数据方舟。Yes:开启,No:不开启,默认值:No | No | 
| SnapshotService | string | 是否开启快照服务(开启快照服务,可免费开启数据方舟)。Yes:开启,No:不开启,默认值:No | No | 
| Tag | string | 业务组 默认:Default | No | 
| DiskType | string | UDisk 类型: DataDisk(普通数据盘),SSDDataDisk(SSD数据盘),ESSDDataDisk(经济型SSD数据盘),RSSDDataDisk(RSSD数据盘),ERSSDDataDisk(经济型 RSSD数据盘),EfficiencyDataDisk(高效数据盘),默认值(DataDisk) | No | 
| UKmsMode | string | 是否加密。Yes:加密,No:不加密,默认值(No) | No | 
| CmkId | string | 加密需要的cmk id,UKmsMode为Yes时,必填 | No | 
| MultiAttach | string | 是否允许多点挂载(Yes: 允许多点挂载, No: 不允许多点挂载, 不填默认Yes ) | No | 
| HostId | string | Host实例ID。当创建云盘类型为RSSDDataDisk时,根据传入的HostId,创建与虚机在同一PodId下的云盘。 | No | 
| BackupMode | string | 快照服务备份策略。普通云盘,SSD云盘,RSSD云盘套餐选择:“Base”:基础版,“ Ultimate”:旗舰版,“ Custom”:自定义备份链,默认采用基础版套餐开通;ESSD云盘,ERSSD云盘套餐:“Lite”:精简版,默认采用精简版套餐开通。 | No | 
| Journal | int | BackupMode为Custom时,进行设置, 以12小时秒级为基础进行倍数扩增,如12、24、36、48 | No | 
| Hour | int | BackupMode为Custom时,进行设置, 以24小时级为基础进行倍数扩增,如24、48、72、96 | No | 
| Day | int | BackupMode为Custom时,进行设置, 以5天级为基础进行倍数扩增,如5、10、15、20、25、30 | No | 
| CouponId | string | 使用的代金券id | No | 
响应字段
| 字段名 | 类型 | 描述信息 | 必填 | 
|---|---|---|---|
| RetCode | int | 返回状态码,为 0 则为成功返回,非 0 为失败 | Yes | 
| Action | string | 操作指令名称 | Yes | 
| Message | string | 返回错误消息,当 RetCode非 0 时提供详细的描述信息 | No | 
| UDiskId | string | 挂载的UDisk实例ID | No | 
| UHostId | string | 挂载的UHost实例ID。【即将废弃,建议使用HostId】 | No | 
| HostId | string | 挂载的Host实例ID | No | 
| DeviceName | string | 挂载设备名称 | No | 
示例
请求示例
https://api.tnqacloud.com/?Action=CreateAttachUDisk
&Region=fePADFDK
&Zone=nZVkTEeG
&ProjectId=lBYhRYwK
&Size=2
&Name=dRnLmEsF
&ChargeType=Year
&Quantity=3
&UDataArkMode=Yes
&Tag=ANUJBMxl
&DiskType=rdyjaTAh
&UKmsMode=UWdWyhmS
&CmkId=XYYNHuCm
&UHostIdForAttachment=hgLBzxKT
&CouponId=XHavHbdB
&MultiAttach=yyMqSgep
&MultiAttach=ejvSWdAP
&SnapshotService=VlgfpSlc
&HostId=FKnpCGZT
&HostProduct=VGePkIjN
&BackupMode=aAvKfYBB
&Journal=6
&Hour=3
&Day=1响应示例
{
  "Action": "CreateAttachUDiskResponse",
  "DeviceName": "lGfgoKdq",
  "HostId": "PIUVdtUD",
  "RetCode": 0,
  "UDiskId": [
    "lVjpdPEC"
  ],
  "UHostId": "gZjemlLv"
}