调用AddVersionBlackDevices为系统版本或者应用版本添加黑名单。

说明 在系统升级或应用升级时,当希望某些特定的设备不允许升级时,可以调用此接口添加版本的设备黑名单。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String AddVersionBlackDevices

系统规定参数。取值:AddVersionBlackDevices

DeviceIdType String hardware_id

设备ID类型,支持:

  • device_id:硬件ID,
  • sn:序列号,
  • vin:车架号,
  • hardware_id:硬件ID
DeviceIds String 11,22,33

设备ID列表,英文逗号隔开。具体设备ID使用哪个,由DeviceIdType决定。

ProjectId String P0VFCREU

项目ID

RegionId String cn-shanghai

地域ID

VersionId String 12345

版本ID

VersionType String FOTA

版本类型,支持:

  • FOTA:系统升级
  • APP:应用升级

返回数据

名称 类型 示例值 描述
RequestId String 6F25F67C-F411-499F-BCE2-67CA563CB064

请求ID

示例

请求示例


http(s)://[Endpoint]/?Action=AddVersionBlackDevices
&DeviceIds=11,22,33
&DeviceIdType=hardware_id
&ProjectId=P0VFCREU
&RegionId=cn-shanghai
&VersionId=12345
&VersionType=FOTA
&<公共请求参数>

正常返回示例

XML 格式

<AddVersionBlackDevicesResponse>
	  <RequestId>6F25F67C-F411-499F-BCE2-67CA563CB064</RequestId>
</AddVersionBlackDevicesResponse>

JSON 格式

{
	"RequestId":"6F25F67C-F411-499F-BCE2-67CA563CB064"
}

错误码

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