# 批量查询版本能力集
#### 功能介绍
批量查询版本能力集
#### URI
POST /v1/{user_id}/devices/ability
表1路径参数 
| 参数      | 是否必选 | 参数类型   | 描述                                                                                                                                                              |
|:---|:---|:---|:---|
| user_id | 是    | String | 用户ID：由数字组成，长度范围\[15,25\]，获取方式参考[获取user ID与下载AK/SK](https://support.huaweicloud.com/api-ivm/ivm_03_0005.html#ZH-CN_TOPIC_0000001710465704__section1213543912215) |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                    |
|:---|:---|:---|:---|
| Access-Token | 是    | String | 用户认证AccessToken：从[获取用户北向接口认证AccessToken](https://support.huaweicloud.com/api-ivm/ivm_03_0002.html)中获取 |
   
表3请求Body参数 
| 参数                 | 是否必选 | 参数类型                                                                             | 描述                     |
|:---|:---|:---|:---|
| versions           | 是    | Array of [versions] objects | 设备版本                   |
| need_specification | 否    | Boolean                                                                          | 是否需要返回具体规格，不传默认false   |
| ability            | 否    | Array of strings                                                                 | 查询的云上能力集列表，不传默认查询所有能力集 |
   
 表4versions 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                 |
|:---|:---|:---|:---|
| device_type | 是    | String | 设备类型，必填，可以通过[用户根据设备ID查询设备信息详情](https://support.huaweicloud.com/api-ivm/ivm_03_0038.html)获取         |
| firmware    | 是    | String | 设备软件版本，必填，可以通过[用户根据设备ID查询设备信息详情](https://support.huaweicloud.com/api-ivm/ivm_03_0038.html)获取       |
| model       | 是    | String | 设备固件类型（设备款型），必填，可以通过[用户根据设备ID查询设备信息详情](https://support.huaweicloud.com/api-ivm/ivm_03_0038.html)获取 |
   
#### 响应参数
**状态码： 200**
表5响应Body参数 
| 参数        | 参数类型                                                                                            | 描述           |
|:---|:---|:---|
| abilities | Array of [DeviceVersionAndAbilities] objects | 设备版本对应能力集返回体 |
   
 表6DeviceVersionAndAbilities 
| 参数          | 参数类型   | 描述      |
|:---|:---|:---|
| device_type | String | 设备类型    |
| model       | String | 设备款型    |
| firmware    | String | 设备软件版本  |
| abilities   | Object | 设备能力集规格 |
   
#### 请求示例
通过版本查询设备能力集
```
POST /v1/2562572829***/devices/ability 
 
{ 
  "versions" : [ { 
    "device_type" : "IPC", 
    "model" : "C3050-10-LI-PV(3.6mm)", 
    "firmware" : "SDC 10.0.RC11" 
  }, { 
    "device_type" : "IPC", 
    "model" : "C3050-10-LI-PV(3.6mm)", 
    "firmware" : "SDC 10.0.RC12" 
  } ], 
  "need_specification" : true, 
  "ability" : [ "ptz", "soundlightalarm" ] 
}
```
#### 响应示例
**状态码： 200**
OK
```
{ 
  "abilities" : [ { 
    "device_type" : "IPC", 
    "firmware" : "SDC 10.0.RC11", 
    "model" : "C3050-10-LI-PV(3.6mm)", 
    "abilities" : { 
      "ptz" : { 
        "support" : false 
      }, 
      "soundlightalarm" : { 
        "alarm_voice_file_max_num" : "6", 
        "alarm_voice_one_file_max_size" : "76800", 
        "alarm_voice_file_max_size" : "524288", 
        "support" : false 
      } 
    } 
  }, { 
    "device_type" : "IPC", 
    "firmware" : "SDC 10.0.RC12", 
    "model" : "C3050-10-LI-PV(3.6mm)", 
    "abilities" : { 
      "ptz" : { 
        "support" : false 
      }, 
      "soundlightalarm" : { 
        "support" : false 
      } 
    } 
  } ] 
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-ivm/ivm_03_0136.html)
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ivm/ivm_03_0137.html)