ReplaceEdgeInstanceGateway
替换已绑定到边缘实例的网关。替换网关后,原网关的部署状态和部署历史会被清除
服务地址:
华东2(上海)
输入参数
只看必填
IotInstanceId实例ID
InstanceId边缘实例的ID
CurrentGatewayId当前网关设备的IotId
NewGatewayId要替换的新网关设备的IotId
插件下载了解更多
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.

接口说明

限制条件

  • 替换网关前,必须先在物联网平台控制台的边缘计算 > 边缘实例> 实例详情页面重置边缘实例。

  • 单阿里云账号调用该接口的每秒请求数(QPS)最大限制为 20。

    说明 RAM 用户共享主账号配额。

请求参数

字段名称字段详情
IotInstanceIdstring

实例 ID。公共实例不传此参数,企业版实例需传入。

示例值:iot_instc_pu****_c*-v64********
InstanceIdstring

边缘实例的 ID。在边缘计算控制台边缘实例页面中,鼠标悬浮在目标边缘实例名称上获取 ID。展开详情

示例值:G4TGWGYwpo8zwr******参考取值来源:
    QueryEdgeInstance
    CreateEdgeInstance
    BindRoleToEdgeInstance
    BatchSetEdgeInstanceDeviceChannel
CurrentGatewayIdstring

当前网关设备的 IotId。IotId 是物联网平台为设备生成的唯一标识符。可调用 QueryDevice 接口查询。

示例值:oTCJomvT95WPyPPQ5sje******
NewGatewayIdstring

要替换的新网关设备的 IotId。IotId 是物联网平台为设备生成的唯一标识符。可调用 QueryDevice 接口查询。

示例值:65SkFyhZcU5d3PO2Ri13******

请求说明

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

返回参数

字段名称字段详情
Codestring

接口返回码。Success 表示成功,其它表示错误码。详情请参见错误码

示例值:Success
ErrorMessagestring

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

示例值:request parameter error
RequestIdstring

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

示例值:10E5C856-E0A1-4468-BE01-E540A8BA8819
Successboolean

表示是否调用成功。true 表示调用成功,false 表示调用失败。

示例值:true
变更历史
暂无变更历史