调用CreateSDG使用指定设备创建SDG。

注意事项

创建完成后，必须调用SaveSDG接口保存SDG，否则SDG不可用。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateSDG

系统规定参数。取值：CreateSDG。
InstanceId String 是 aic-xxxx

设备资源ID。
Size String 否 20

SDG最大容量，单位GB。

说明
  • 为了节约成本，建议按需评估。
  • 如果是首次创建SDG，Size为必填参数。
  • 后续数据量增大时可传递新的Size进行扩容。
    • 如果Size不为空，且大于原有SDG的Size值，则表示将该SDG对应的原始云盘扩容到当前Size大小。
    • 如果Size为空，或填入的Size小于原有SDG的Szie值，系统将不做处理。
Description String 否 测试SDG

SDG的描述信息。

说明 建议详细填写，以便后续查询。
FromSDGId String 否 sdg-xxxxx

已有SDG的ID。

说明
  • 如果为首次创建SDG，FromSDGId则为空。
  • 如果FromSDGId非法或查询不到对应的原始云盘，则报错。
  • 如果FromSDGId不为空，则表示非首次创建SDG，对已有SDG进行操作。

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。
SDGId String sdg-xxxx

生成SDG的ID。

示例

请求示例

http(s)://ens.aliyuncs.com/?Action=CreateSDG
&InstanceId=aic-xxxx
&Size=20
&Description=测试SDG
&FromSDGId=sdg-xxxxx
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateSDGResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <SDGId>sdg-xxxx</SDGId>
</CreateSDGResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "SDGId" : "sdg-xxxx"
}

错误码

HttpCode 错误码 错误信息 描述
400 NoPermission Permission denied. 没有足够的权限，请联系云账号管理员授予您相应权限。

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