转移购买的云存储套餐-阿里云帮助中心

QPS限制

单个阿里云账号调用该接口的每秒请求数（QPS）最大限制为100。

说明单个阿里云账号下的所有RAM用户共享该阿里云账号的配额。

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	TransferStorageOrder	系统规定参数。取值：TransferStorageOrder。
DstIotId	String	是	wse4rfgy67j8lDnTLv****00122	云存储套餐转移的目标设备ID（IotId）。
SrcIotId	String	是	111*********	购买的云存储套餐的订单ID。
SrcOrderId	String	是	Q7uOhVRdZRRlDnTLv****00100	云存储套餐待转移源设备的设备ID（IotId）。
EventRecordDuration	Integer	否	10	事件录像总时长。取值范围为0~30，单位为秒。
SupportCrossIdentityTransfer	Boolean	否	true	是否支持云存套餐跨账号间转移。 true：支持跨用户账号不同设备间转移订单。 false（默认）：仅支持同一个用户账号下不同的设备间转移订单。
EventRecordProlong	Boolean	否	true	是否延长事件录像。 true：表示在事件录像过程中，持续触发的事件会延长录像至事件结束。 false（默认）：表示每个事件上报云端按配置的事件录像时长（如10秒）录制对应时长的录像。
ImmediateUse	Boolean	否	true	是否立即使用。 true：表示新领取免费套餐立即生效。 false（默认）：表示新领取的免费套餐在之前套餐到期后生效。
UserName	String	否	test	购买云存储套餐的用户名。
UserId	String	否	123*******	购买云存储套餐的用户ID。
EnableDefaultPlan	Boolean	否	false	是否设置默认的全天录像计划。 true：设置，可自定义PreRecordDuration和EventRecordDuration。 false（默认）：不设置，PreRecordDuration值为5，EventRecordDuration值为10。
PreRecordDuration	Integer	否	1	事件录像的预录时长。取值范围为0~5，单位为秒。

调用API时，除了本文介绍的该API的特有请求参数，还需传入公共请求参数。

返回数据

名称	类型	示例值	描述
Code	String	400	调用结果状态码：调用成功，返回200。调用失败，返回错误码。详细信息，请参见下文错误码。
Data	Struct		调用成功，返回的结果。
CommodityCode	String	LinkVisualCloudStorage	云存储套餐Code。
Copies	Integer	10	购买数量。
EndTime	String	2024-0-01 12:00:00	结束时间。格式为`yyyy-MM-dd HH:mm:ss`。
EndTimeUTC	String	2024-01-01T12:00:00Z	结束时间UTC。格式`yyyy-MM-ddTHH:mm:ssZ`。
IdentityId	String	234********	用户身份ID。
IotId	String	Q7uOhVRdZRRlDnTLv****00100	设备ID。设备的唯一标识符。
OrderId	String	11******	购买云存储套餐的订单ID。
OrderType	Integer	1	订单类型。 0：付费订单。 1：免费订单。
OutOrderNo	String	23********	外部支付结算订单号。阿里云账号下的订单号。
PaymentStatus	Integer	1	云存储订单支付状态。 0：未支付。 1：已支付。 2：正在支付中。
PreConsume	Integer	30	已消耗的时间，单位为秒。
Price	String	100	云存储套餐价格，单位为元。
RecordType	Integer	1	云存储录像类型。 1：连续型。 2：事件型。
Specification	String	eventRecord_7	云存储套餐规格。
StartTime	String	2023-01-01 12:00:00	开始时间。格式为`yyyy-MM-dd HH:mm:ss`。
StartTimeUTC	String	2023-01-01T12:00:00Z	开始时间UTC，格式为`yyyy-MM-ddTHH:mm:ssZ`。
Status	Integer	0	云存储套餐订单的状态。 0：订单有效，使用中。 1：订单无效，已过期。 2：订单冻结停用。
UserId	String	100*******	购买云存储套餐的用户ID。
UserName	String	test	购买云存储套餐的用户名。
ErrorMessage	String	Request parameter error.	调用失败时，返回的出错信息。
RequestId	String	E****7-4-B-8E-D3********65	阿里云为该请求生成的唯一标识符。
Success	Boolean	true	是否调用成功。 true：调用成功。 false：调用失败。

示例

请求示例

http(s)://linkvisual.cn-shanghai.aliyuncs.com/?Action=TransferStorageOrder
&DstIotId=wse4rfgy67j8lDnTLv****00122
&SrcIotId=111*********
&SrcOrderId=Q7uOhVRdZRRlDnTLv****00100
&<公共请求参数>

正常返回示例

XML格式

<TransferStorageOrderResponse>
  <RequestId>E******7-4***-***B-8**E-D3********65</RequestId>
  <Data>
        <Status>0</Status>
        <StartTimeUTC>2023-01-01T12:00:00Z</StartTimeUTC>
        <UserName>test</UserName>
        <EndTime>2024-0-01 12:00:00</EndTime>
        <StartTime>2023-01-01 12:00:00</StartTime>
        <PreConsume>30</PreConsume>
        <Specification>eventRecord_7</Specification>
        <EndTimeUTC>2024-01-01T12:00:00Z</EndTimeUTC>
        <OrderId>11******</OrderId>
        <IotId>Q7uOhVRdZRRlDnTLv****00100</IotId>
        <OrderType>1</OrderType>
        <RecordType>1</RecordType>
        <Price>100</Price>
        <UserId>100*******</UserId>
        <Copies>10</Copies>
        <CommodityCode>LinkVisualCloudStorage</CommodityCode>
        <IdentityId>234********</IdentityId>
        <PaymentStatus>1</PaymentStatus>
        <OutOrderNo>23********</OutOrderNo>
  </Data>
  <Code>200</Code>
  <Success>true</Success>
</TransferStorageOrderResponse>

JSON格式

{
    "RequestId": "E******7-4***-***B-8**E-D3********65",
    "Data": {
        "Status": 0,
        "StartTimeUTC": "2023-01-01T12:00:00Z",
        "UserName": "test",
        "EndTime": "2024-0-01 12:00:00",
        "StartTime": "2023-01-01 12:00:00",
        "PreConsume": 30,
        "Specification": "eventRecord_7",
        "EndTimeUTC": "2024-01-01T12:00:00Z",
        "OrderId": "11******",
        "IotId": "Q7uOhVRdZRRlDnTLv****00100",
        "OrderType": 1,
        "RecordType": 1,
        "Price": 100,
        "UserId": "100*******",
        "Copies": 10,
        "CommodityCode": "LinkVisualCloudStorage",
        "IdentityId": "234********",
        "PaymentStatus": 1,
        "OutOrderNo": "23********"
    },
    "Code": 200,
    "Success": true
}

错误码

HttpCode	错误码	错误信息	描述
400	iot.vision.RequestParamError	Request parameter error.	请求参数错误。
403	iot.vision.RequestAuthFailed	Request auth failed.	请求鉴权失败。
403	iot.vision.RequestForbidden	Request forbidden.	请求被禁止。
429	iot.vision.RequestTrafficControl	Request traffic control.	请求太频繁被限流。
400	iot.vision.RequestFailed	Request failed.	请求失败。
400	iot.vision.UnexpectedInternalError	Unexpected internal error.	未知内部错误。
400	iot.vision.DeviceNoOwner	Device has no owner.	设备没有绑定管理员。
400	iot.vision.DeviceOwnerChanged	Device owner changed.	设备的管理员用户变更。
400	iot.vision.InvalidStorageOrder	Invalid storage order.	无效的云存储订单。

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