调用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"
}

错误码

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