TransferDeviceInstance_物联网智能视频服务_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

调用该接口迁移设备所在的实例前,请您联系技术支持人员进行迁移方案评估,防止迁移后功能无法使用。

前提条件

  • 被迁移的设备已开通视频服务功能。
    • 公共实例的设备:登录物联网平台控制台,单击公共实例。在左侧菜单栏,选择视频服务 > 接入服务。在接入服务页面,单击产品管理页签。确认待迁移设备所在产品,对应已开通/未开通状态列为已开通
    • 企业版实例的设备:已启用视频服务。
  • 设备分发任务已经完成。详细信息,请参考 CreateDeviceDistributeJob设备分发
  • 确保摄像头设备已配置图片生命周期。若摄像头设备未配置图片生命周期,调用该接口后,会自动设置图片生命周期为 180 天。详细信息,请参考 SetDevicePictureLifeCycle

背景信息

  • 若迁移的源实例与目标实例类型不同,迁移前请了解实例的计费方式。计费方式详细内容,请参考计费概述
  • 迁移过程中,设备会离线,设备数量越多迁移时间越长,在此期间设备产生的数据无法保留。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
linkvisual:TransferDeviceInstance
全部资源
*

请求参数

字段名称字段详情
DeviceNameListarray<string>

待迁移的设备名称列表。最多包含 100 个设备名称。

示例值:RepeatList子级条数 <= 100
ProductKeystring

设备所属产品的 ProductKey,创建产品时,物联网平台为该产品生成的唯一标识。

示例值:a1BwAGV****
SourceInstanceIdstring

设备所属的源实例 ID:展开详情

示例值:iotx-oxssharez200
TargetInstanceIdstring

设备迁移的目标实例 ID。目标实例仅支持企业版实例。展开详情

示例值:iot-060***

请求说明

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

返回参数

字段名称字段详情
Codestring

接口返回码:展开详情

示例值:200
RequestIdstring

阿里云为该请求生成的唯一标识符。

示例值:27AF2E38-12ED-4F67-BD20-36E812CD7A42
ErrorMessagestring

调用失败时,返回的出错信息。

示例值:来源实例和目标实例不能相同
Successboolean

是否调用成功:展开详情

示例值:true
Dataobject

查询结果。

返回示例

变更历史

暂无变更历史

相关示例