# 查询指定项目级字段的选项使用情况 - ShowIpdProjectFieldOptionUsed
#### 功能介绍
查询指定项目级字段的选项使用情况，返回字段选项的value字段和使用次数。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-projectman/projectman_api_1002.html)。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
GET /v1/ipdprojectservice/projects/{project_id}/field/options-used
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释**： 项目32位ID，项目唯一标识。通过[查询IPD项目列表](https://support.huaweicloud.com/api-projectman/ShowIpdProjectList.html)获取，响应消息体中的**id**字段的值就是项目ID。 **约束限制**： 不涉及。 **取值范围**： 32个字符，由英文字母和数字组成。 **默认取值**： 不涉及。 |
   
表2Query参数 
| 参数   | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| code | 是    | String | **参数解释**： 工作项字段code，可通过[查询字段列表](https://support.huaweicloud.com/api-projectman/ListIpdProjectFields.html)接口获取，响应消息体中的**code**字段的值就是工作项字段code。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数       | 参数类型                  | 描述                                     |
|:---|:---|:---|
| {自定义key} | Map\<String,Integer\> | map的key为字段选项的value值，map中的value为选项使用次数。 |
   
**状态码：400**
表4响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                 |
|:---|:---|:---|
| error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。                   |
| error_msg  | String | **参数解释**： 错误描述，对error_code的补充解释。 **取值范围**： 不涉及。 |
   
#### 请求示例
查询指定项目字段的选项使用情况
```
GET https://{endpoint}/v1/ipdprojectservice/projects/056b156fc4a647a78d92a464afe58de6/field/options-used?code=c7354622570092720128
```
#### 响应示例
**状态码：200**
返回值中map的key为字段选项的value值，map中的value为选项使用次数。
```
{
  "1162701752338595842" : "2"
}
```
**状态码：400**
请求失败的响应。例如无操作权限、项目不存在。
```
{
  "error_code" : "PM.02174103",
  "error_msg" : "无操作权限"
}
```
#### 状态码
| 状态码 | 描述                                         |
|:---|:---|
| 200 | 返回值中map的key为字段选项的value值，map中的value为选项使用次数。 |
| 400 | 请求失败的响应。例如无操作权限、项目不存在。                     |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。