此操作用来创建克隆卷。

前提条件：用于创建克隆卷的快照，其状态必须是Normal。

说明

系统支持的最大克隆卷数：100000。
单个快照可创建的最大克隆卷数：512。
系统支持的最大克隆深度：16。

请求语法

单机版

POST /rest/v1/block/lun/clone HTTP/1.1
Date:date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization

{
"lunName": lunName,
"snapshotName": snapshotName,
    "targetName": targetName,
    "capacity": capacity,
    "config": {
        "sectorSize": sectorSize,
        "writePolicy": writePolicy,
        "path": path
    }
}

集群版

POST /rest/v1/block/lun/clone HTTP/1.1
Date:date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization

{
"lunName": lunName,
"snapshotName": snapshotName,
    "targetName": targetName,
    "capacity": capacity,
    "config": {
        "localStorageClass": localStorageClass,
        "minReplica": minReplica,
        "ECfragmentSize": ECfragmentSize,
        "redundancyOverlap": redundancyOverlap,
        "sectorSize": sectorSize,
        "cachePool": poolName,
        "pool": poolName,
        "highAvailability": highAvailability,
        "writePolicy": writePolicy,
        "serverAffinity": {
            "autoFailback": autoFailback,
            "priority": [
                SeverID,ServerID…
            ]
        }
    }
}

请求参数

参数	类型	描述	是否必须
lunName	String	克隆卷名称。取值：长度范围是1~16，只能由字母、数字和短横线（-）组成，字母区分大小写，且仅支持以字母或数字开头。	是
snapshotName	String	指定克隆卷关联的快照名称。取值：字符串形式，长度范围是1~256，只能由字母、数字、短横线( - )、下划线( _ )组成，字母区分大小写，且仅支持以字母或数字开头。	是
targetName	String	指定克隆卷关联的iSCSI Target名称，可以跟源卷的iSCSI Target不同。说明创建卷时，如果指定的Target名称不存在，那么同时创建iSCSI Target，新创建iSCSI Target的回收策略默认为Delete。取值：长度范围是1~16，可以由小写字母、数字、句点（.）和短横线（-）组成，且仅支持以字母或数字开头。	是
capacity	Integer	指定克隆卷的容量。取值：[1,1048576]，单位是GiB。默认为快照时刻的源卷容量，如果重新设置，则必须大于等于快照时刻的源卷的容量。	否
config.localStorageClass	String	指定克隆卷的冗余模式（仅集群版支持）。取值： single-copy：单副本。 2-copy：两副本。 3-copy：三副本。 EC N+M：纠删码模式。其中N、M为正整数，N>M，且N+M≤128。表示将数据分割成N个片段，并生成M个校验数据。默认值为源卷的卷冗余模式。说明（以下场景均为集群可用的前提下）：创建EC N+M的卷时：服务器级别故障域：集群中可用节点台数不足N+M时，卷可以创建成功，但是卷数据将处于降级状态，允许故障的服务器台数不足M，建议尽快添加服务器或修复故障服务器。可用故障域不足N时，可以创建卷，但无法写入数据，且系统会产生告警。数据目录级别故障域：集群中可用数据目录数量不足N+M时，卷可以创建成功，但是卷数据将处于降级状态，允许故障的数据目录个数不足M，建议尽快添加数据目录或修复故障数据目录。可用故障域不足N时，可以创建卷，但无法写入数据，且系统会产生告警。创建副本模式的卷时：可用故障域数量大于等于1，即可创建两副本、三副本的卷，卷数据将处于降级状态，建议尽快添加服务器或修复故障服务器。	否
config.minReplica	Integer	指定克隆卷的最小副本数（仅集群版支持）。对于副本模式的卷，假设卷副本数为X，最小副本数为Y（Y必须≤X），该卷每次写入时，至少Y份数据写入成功，才视为本次写入成功。对于EC N+M模式的卷，假设该卷最小副本数设置为Y（必须满足N≤Y≤N+M），必须满足总和至少为Y的数据块和校验块写入成功，才视为本次写入成功。取值：对于副本卷，取值范围是[1, N]，N为副本模式卷的副本数；对于EC卷，取值范围是[N, N+M]。如果未设置克隆卷的最小副本数，默认值为源卷的最小副本数。	否
config.ECfragmentSize	Integer	指定克隆卷的纠删码模式分片大小（仅集群版支持）。 config.localStorageClass为EC模式时，此设置才生效，否则忽略。取值：1、2、4、8、16、32、64、128、256、512、1024、2048、4096，单位是KiB。默认值为源卷的纠删码模式分片大小。	否
config.redundancyOverlap	Integer	指定克隆卷的折叠副本数（仅集群版支持）。在数据冗余模式下，同一份数据的不同副本/分片默认分布在不同的故障域，当故障域损坏时，允许根据卷的冗余折叠原则，将多份数据副本放在同一个故障域中，但是分布在不同的path上。注意如果存储池故障域级别为path，此参数不生效。取值：对副本模式，取值范围是[1，副本数]；对于EC卷，取值范围是[1，N+M]。如果未设置克隆卷的折叠副本数，默认值为源卷的折叠副本数。	否
config.sectorSize	Integer	指定克隆卷的扇区大小。取值：512、4096，单位为字节。默认值为源卷的扇区大小。说明扇区大小的选取：根据自身业务场景，一般情况下，单次I/O操作的数据大小大于或接近4KiB，则推荐选择4096；单次I/O操作的数据大小接近512Bytes，则推荐选择512。如果对接VMware等虚拟化平台，则推荐选择512。	否
config.cachePool	String	指定缓存存储池（仅集群版支持）。取值：长度范围是1~16，只能由字母、数字和短横线（-）、下划线（_）组成，字母区分大小写，且仅支持以字母和数字开头。默认值与源卷的配置一致。注意 pool与cachePool不能设置为同一个存储池。当克隆卷的pool和cachePool配置与源卷一致，无需额外设置。若单独设置了克隆卷的pool或cachePool，则不再沿用源卷的对应配置，而是采用所设参数值。例如，源卷同时有cachePool和pool，若克隆卷仅重新设置了pool而未设置cachePool，则其仅使用新设置的pool；反之，若克隆卷设置了cachePool，则必须同时设置pool，或者让pool使用基础存储池。	否
config.pool	String	指定存储池（仅集群版支持）。取值：长度范围是1~16，只能由字母、数字和短横线（-）、下划线（_）组成，字母区分大小写，且仅支持以字母和数字开头。默认值与源卷的配置一致。注意 pool与cachePool不能设置为同一个存储池。若克隆卷的pool与cachePool配置与源卷一致，则无需单独设置。一旦克隆卷单独设置了pool或cachePool，就不再沿用源卷的相应配置，而是采用参数中所设的值。例如，源卷同时拥有cachePool和pool，若克隆卷仅重新设置了pool而未设置cachePool，则其仅使用新设置的pool；反之，若克隆卷设置了cachePool，则必须同时设置pool，或者让pool使用基础存储池。	否
config.highAvailability	String	指定克隆卷的高可用类型（仅集群版支持）。取值： ActiveStandby：启用主备，该卷关联对应Target下的所有IQN。 Disabled：不启用主备，该卷关联对应Target下的1个IQN。默认值为源卷的高可用类型。	否
config.writePolicy	String	指定克隆卷的写策略。取值： WriteBack：回写，指数据写入到内存后即返回客户端成功，之后再异步写入磁盘。适用于对性能要求较高，稳定性要求不高的场景。 WriteThrough：透写，指数据同时写入内存和磁盘，并在都写成功后再返回客户端成功。适用于稳定性要求较高，写性能要求不高，且最近写入的数据会较快被读取的场景。 WriteAround：绕写，指数据直接写到磁盘，不写入内存。适用于稳定性要求较高，性能要求不高，且写多读少的场景。默认为源卷的写策略。	否
config.serverAffinity	List of serverAffinity	卷主备分布优先级设置，详见“表1 请求参数config.serverAffinity说明”。	否
config.path	String	指定存储克隆卷数据的数据目录（仅单机版支持）。如果创建卷时不指定数据目录，默认与源卷配置保持一致。	否

表1 请求参数config.serverAffinity说明

参数	类型	描述	是否必须
autoFailback	String	是否根据指定的克隆卷主备分布优先级自动进行主备切换（仅集群版支持），即针对卷主备状态，当高优先级的服务器恢复正常后，是否自动进行主备状态切换。取值： Enabled：自动进行主备切换。 Disabled：不自动进行主备切换。默认值为Enabled。	否
priority	Array of string	指定卷主备分布优先级的服务器ID（仅集群版支持），系统根据指定的服务器ID顺序来选择卷的主备IQN。可以指定一个或者多个服务器ID，以英文逗号分开。前置条件：iSCSI Target名称已经存在，且指定的服务器必须是iSCSI Target所在的服务器。取值：服务器ID。	否

参数

类型

描述

是否必须

autoFailback

String

是否根据指定的克隆卷主备分布优先级自动进行主备切换（仅集群版支持），即针对卷主备状态，当高优先级的服务器恢复正常后，是否自动进行主备状态切换。
取值：

Enabled：自动进行主备切换。
Disabled：不自动进行主备切换。

默认值为Enabled。

否

priority

Array of string

指定卷主备分布优先级的服务器ID（仅集群版支持），系统根据指定的服务器ID顺序来选择卷的主备IQN。可以指定一个或者多个服务器ID，以英文逗号分开。
前置条件：iSCSI Target名称已经存在，且指定的服务器必须是iSCSI Target所在的服务器。
取值：服务器ID。

否

响应结果

名称	类型	描述
iSCSITargets	Array of iSCSITarget	iSCSI Target属性集合，详见“表2 响应参数iSCSITarget说明”。
cloneDepth	Integer	克隆卷的深度。

表2 响应参数iSCSITarget说明

名称	类型	描述
iqn	String	iSCSI Target IQN。
status	String	克隆卷对应的Target的状态： Active：主Target。 Standby：热备Target。 Unavailable：冷备Target。
ips	Array of ip	iSCSI Target的IP属性集合，详见“表3 响应参数ip说明”。
serverId	String	服务器ID。

表3 响应参数ip说明

名称	类型	描述
ip	String	iSCSI Target的IP。
port	Integer	iSCSI Target的端口号。

请求示例1

单机：创建克隆卷luna1-C2。

POST /rest/v1/block/lun/clone HTTP/1.1
Date: Tue, 11 Mar 2025 06:55:43 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Connection: keep-alive
Content-Length: 211
Host:192.168.0.66:1443

{
    "lunName": "luna1-C2",
    "snapshotName": "luna1-snap4",
    "targetName": "targeta",
    "capacity": 500,
    "config": {
        "sectorSize": 512,
        "writePolicy": "WriteThrough"
    }
}

响应示例1

HTTP/1.1 200 OK 
x-hblock-request-id: 1e3c374dc4044830828d69d3657d996a
Connection: keep-alive
Content-Length: 172
Date: Tue, 11 Mar 2025 06:55:43 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock

{
    "data": {
        "iSCSITargets": [
            {
                "iqn": "iqn.2012-08.cn.ctyunapi.oos:targeta.1",
                "status": "Active",
                "ips": [
                    {
                        "ip": "192.168.0.66",
                        "port": 3260
                    }
                ],
                "serverId": "hblock_1"
            }
        ],
        "cloneDepth": 1
    }
}

请求示例2

集群版：创建克隆卷lun02-clone-6。

POST /rest/v1/block/lun/clone HTTP/1.1
Date: Tue, 11 Mar 2025 06:41:03 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Connection: keep-alive
Content-Length: 559
Host:192.168.0.64:1443

{
    "lunName": "lun02-clone-6",
    "snapshotName": "lun02-snap20250304170942",
    "targetName": "target02",
    "capacity": 500,
    "config": {
        "localStorageClass": "EC 2+1",
        "ECfragmentSize": 1024,
        "sectorSize": 512,
        "cachePool": "default",
        "pool": "pool2",
        "highAvailability": "ActiveStandby",
        "writePolicy": "WriteThrough",
        "serverAffinity": {
            "autoFailback": "Enabled",
            "priority": [
                "hblock_1"
            ]
        }
    }
}

响应示例2

HTTP/1.1 200 OK 
x-hblock-request-id: 379a264ec280457ea92a44ba3e0413eb
Connection: keep-alive
Content-Length: 314
Date: Tue, 11 Mar 2025 06:41:03 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock

{
    "data": {
        "iSCSITargets": [
            {
                "iqn": "iqn.2012-08.cn.ctyunapi.oos:target02.3",
                "status": "Unavailable",
                "ips": [
                    {
                        "ip": "192.168.0.65",
                        "port": 3260
                    }
                ],
                "serverId": "hblock_1"
            },
            {
                "iqn": "iqn.2012-08.cn.ctyunapi.oos:target02.4",
                "status": "Unavailable",
                "ips": [
                    {
                        "ip": "192.168.0.64",
                        "port": 3260
                    }
                ],
                "serverId": "hblock_2"
            }
        ],
        "cloneDepth": 1
    }
}

智算服务

应用商城

合作伙伴

开发者

支持与服务

了解天翼云

查看所有产品

存储资源盘活系统

存储资源盘活系统

请求语法

请求参数

响应结果

请求示例1

响应示例1

请求示例2

响应示例2

活动

智算服务

应用商城

合作伙伴

开发者

支持与服务

了解天翼云

查看所有产品

存储资源盘活系统

存储资源盘活系统

请求语法

请求参数

响应结果

请求示例1

响应示例1

请求示例2

响应示例2