用户云存储套餐转移

更新时间：2025-08-18 10:33:03

调用该接口将用户已购买的云存储套餐转移。

描述	值
路径	/platform/vision/customer/cloudstorage/transfer
版本号	1.0.0
协议	HTTPS
请求方法	POST

请求参数：

公共请求参数见公共请求参数

请求字段	类型	必选	描述
srcIotId	String	是	云存储套餐待转移设备ID。
srcOrderId	String	是	购买云存储套餐的订单ID。
dstIotId	String	是	云存储套餐转移目标设备ID。
immediateUse	Boolean	是	是否设置为立即生效。true（表示立即生效）；false（表示在之前套餐到期后生效）。
preRecordDuration	Int	否	事件录像预录时长，取值范围：0～5秒。
recordDuration	Int	否	事件录像时长，取值范围：0~30秒。
eventRecordProlong	Boolean	否	是否延长事件录像。 true（表示在事件录像过程中，持续触发的事件会延长录像至事件结束）； false（表示每个事件固定录制30秒内的录像）

返回参数：

返回字段	类型	描述
id	String	用于识别请求记录，即对应的请求ID。
code	Int	接口返回码字段，请求成功时返回200；请求失败时返回详细的错误码。
message	String	调用失败时，返回的出错信息
data	Object	响应的结果。
orderId	String	购买云存储套餐的订单ID。
specification	String	云存储套餐规格。
copies	Int	购买的数量。
startTime	Long	云存储套餐开始时间，UTC时间戳，单位毫秒。当前在生效的套餐订单才有此值。
endTime	Long	云存储套餐结束时间，UTC时间戳，单位毫秒。当前在生效的套餐订单才有此值。
status	Int	云存储套餐订单的状态。0（订单有效，使用中）；1（订单无效，已过期）；2（订单冻结停用）
price	String	订单价格，单位：元。
commodityType	Int	云存储套餐类型。1（表示连续型）；2（表示事件型）。
iotId	String	设备ID，设备的唯一标识符。
outOrderNo	String	外部支付结算订单号。
recordType	Int	云存储套餐类型。1（表示连续型）；2（表示事件型）。

请求示例：

x-ca-key: xxxxxxxx
x-ca-timestamp: 1728634151000
x-ca-nonce: 7b25fc15b9434dd98587a077a92b7e42
x-ca-signature: yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy
Content-Type: application/json;charset=UTF-8

{
    "id": "49a7be925e53******8ba0facf7",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0"
    },
    "params": {
        "srcIotId": "6vw0OrGyHFSW6EQA*****",
        "srcOrderId": "29e2b80475b7******d06af",
        "dstIotId": "cisalkW78K212hsAAL*****",
        "immediateUse": true,
        "preRecordDuration": 5,
        "recordDuration": 30,
        "eventRecordProlong": true
    }
}

成功返回示例：

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

{
    "id": "49a7be925******08ba0facf7",
    "code": 200,
    "message": "success",
    "data": {
        "orderId": "29e2b80475b7******d06af",
        "specification": "continuous_7",
        "copies": 1,
        "startTime": 1736336086000,
        "endTime": 1739000698000,
        "price": "35.0",
        "commodityType": 1
    }
}

请求参数：​

返回参数：​

请求示例：​

成功返回示例：​

请求参数：

返回参数：

请求示例：

成功返回示例：