绑定设备策略 - BindDevicePolicy

功能介绍

应用服务器可调用此接口在物联网平台上为批量设备绑定目标策略，目前支持绑定目标类型为：设备、产品，当目标类型为产品时，该产品下所有设备都会生效。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

• 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
• 如果使用身份策略授权，需具备如下身份策略权限。

  授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
  iotda:devicepolicy:bind	Permission_management	app *	-	-	-
  		-	g:EnterpriseProjectId

URI

POST /v5/iot/{project_id}/device-policies/{policy_id}/bind

请求参数

响应参数

状态码：200

请求示例

• 为设备绑定策略

  POST https://{endpoint}/v5/iot/{project_id}/device-policies/{policy_id}/bind
  
  {
    "target_type" : "device",
    "target_ids" : [ "64a7ba7ef9cb063d27e16b97_123456", "64a7ba7ef9cb063d27e16b97_123457" ]
  }

• 为产品绑定策略

  POST https://{endpoint}/v5/iot/{project_id}/device-policies/{policy_id}/bind
  
  {
    "target_type" : "product",
    "target_ids" : [ "64a7ba7ef9cb063d27e16b97" ]
  }

响应示例

状态码：200

OK

{
  "policy_id" : "5c90fa7d3c4e4405e8525079",
  "target_type" : "device",
  "success_targets" : [ "64a7ba7ef9cb063d27e16b97_123456", "64a7ba7ef9cb063d27e16b97_123457" ],
  "failure_targets" : [ {
    "target_id" : "64a7ba7ef9cb063d27e16b97_123458",
    "error_code" : "IOTDA.015204",
    "error_msg" : "Operation not allowed. The number of policies bound to the target reaches the upper limit (5)."
  } ]
}

状态码

错误码

请参见错误码。