全部产品
Search

搜索本产品

    边缘节点服务ENS：CreateSDG - 创建SDG

    文档中心

    边缘节点服务ENS：CreateSDG - 创建SDG

    更新时间：Jan 28, 2026

    在AIC实例上创建SDG。

    接口说明

    数据共享集（SDG）可以看作成虚拟设备的数据分区镜像，用户通过操作将某个虚拟设备数据分区保存为 SDG。制作好的 SDG 可以部署在其他虚拟设备的数据分区，实现数据快速分发和应用。SDG 相关接口使用流程如下：

    • 用户调用 CreateSDG 接口创建一个 SDG ，该 SDG 会绑定到 AIC 实例 A（InstanceId ）上。创建成功后，会有一个空白云盘（也称原始云盘）挂载到设备 A（InstanceId）上，用于 SDG 的制作。

    • 用户在 AIC 实例 A（InstanceId）上进行安装应用，下发文件等所需操作。

    • 调用 SaveSDG 将 AIC 实例 A 中的数据盘保存为 SDG A。

    • 调用 DeploySDG 将 SDG A 部署到其他 AIC 实例 B 中。该过程为异步执行，通过 DescribeARMServerInstances 可查询到 AIC 实例 B 的状态。当状态恢复为 success 后可以认为 AIC 实例 B 可用，此时 AIC 实例 B 内的应用与 AIC 实例 A 完全一致。

    调试

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

    调试

    授权信息

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

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

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

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

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

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

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

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

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ens:CreateSDG

    none

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    InstanceId

    string

    是

    AIC 实例 ID。可以通过调用 DescribeARMServerInstances 获取 InstanceId 值。

    aic-xxxx
    Size

    string

    否

    SDG 最大容量，单位 GB。

    说明

    • 为了节约成本，建议按需评估。

    • 如果是首次创建 SDG，Size 为必填参数。

    • 后续数据量增大时可传递新的 Size 进行扩容。如果 Size 不为空，且大于原有 SDG 的 Size 值，则表示将该 SDG 对应的原始云盘扩容到当前 Size 大小。如果 Size 为空，或填入的 Size 小于原有 SDG 的 Szie 值，系统将不做处理。

    20
    Description

    string

    否

    SDG 的描述信息。

    说明

    建议详细填写，以便后续查询。

    测试SDG
    FromSDGId

    string

    否

    已有 SDG 的 ID。

    说明

    • 如果为首次创建 SDG，FromSDGId 则为空。

    • 如果 FromSDGId 非法或查询不到对应的原始云盘，则报错。

    • 如果 FromSDGId 不为空，则表示非首次创建 SDG，对已有 SDG 进行操作。

    sdg-xxxxx
    DiskType

    string

    否

    制作母盘类型 可选参数：

    • standard（标准云盘：默认）。

    • rbd（rbd 盘）。

    说明

    • 使用限制：rbd 盘 SDG 与标准盘 SDG 不可相互继承。

    standard
    BillingCycle

    string

    否

    SDG 子盘计费逻辑：该 SDG 所生产的 rbd 子盘的计费方案（标准云盘不适配） 可选参数：

    • Hour。

    • Day（默认）。

    说明

    • 参数说明：周期越长计费越便宜，若周期未满提早释放会有手续费。

    Day
    PerformanceLevel

    integer

    否

    sdg 共享比参数，支持不同最大共享比的云盘

    100

    返回参数

    名称

    类型

    描述

    示例值

    object

    Schema of Response

    RequestId

    string

    请求 ID。

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    SDGId

    string

    生成 SDG 的 ID。

    sdg-xxxx

    示例

    正常返回示例

    JSON格式

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

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 Interface.Call.Error The interface call error 接口调用出错
    400 Interface.Call.Failed %s. 请求失败
    400 Parameter.Invalid The parameter is invalid. Please check your parameters and try it again. 参数不合法
    400 NoPermission Permission denied.
    400 InvalidParameter.%s The specified field %s invalid. Please check it again.

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

    变更历史

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