# 查询接口
#### 功能介绍
查询已注册的声音列表。
#### URI
GET /v1/{project_id}/vcs/voices
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                               |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目编号。获取方法，请参见[获取项目ID](https://support.huaweicloud.com/api-sis/sis_03_0008.html)。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                       |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 用于获取操作API的权限。获取方法请参见[认证鉴权](https://support.huaweicloud.com/api-sis/sis_03_0058.html)。响应消息头中X-Subject-Token的值即为Token |
   
表3请求Body参数 
| 参数     | 是否必选 | 参数类型    | 描述                                               |
|:---|:---|:---|:---|
| limit  | 否    | Integer | 查询已注册的声音列表，每页查询显示的条目数量，默认：10                     |
| offset | 否    | Integer | 查询已注册的声音列表，页码偏移量，表示从此页码偏移量开始查询，offset大于等于0， 默认：0 |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数       | 参数类型   | 描述                                              |
|:---|:---|:---|
| trace_id | String | 服务内部的令牌，可用于在日志中追溯具体流程，调用失败无此字段。                 |
| result   | Object | 注册声音响应，详见[表5]。 |
   
 表5result结构 
| 参数     | 参数类型 | 描述                                                  |
|:---|:---|:---|
| voices | List | 注册成功的声音列表，详见[表6]。 |
   
 表6voices结构 
| 参数         | 参数类型   | 描述         |
|:---|:---|:---|
| voice_name | String | 注册成功的声音名称。 |
| language   | String | 注册成功的声音语种。 |
   
**状态码： 400**
表7响应Body参数 
| 参数         | 参数类型   | 描述                     |
|:---|:---|:---|
| error_code | String | 调用失败时的错误码。 调用成功时无此字段。  |
| error_msg  | String | 调用失败时的错误信息。 调用成功时无此字段。 |
   
#### 请求示例
![](https://support.huaweicloud.com/api-sis/public_sys-resources/note_3.0-zh-cn.png)
"endpoint"即调用API的请求地址，不同服务不同区域的"endpoint"不同，具体请参见[终端节点](https://support.huaweicloud.com/api-sis/sis_03_0004.html)，当前支持上海一。
- 调用查询API，查询已注册的声音列表
  ```
  GET https://{endpoint}/v1/{project_id}/vcs/voices
  Request Header:
  Content-Type: application/json 
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
  ```
  
#### 响应示例
**状态码：200**
成功响应示例
```
{ 
   "trace_id": "567e8537-a89c-13c3-a882-826321939651", 
   "result":{ 
     "voices": [
        {
          "voice_name": "test_xiaoming",
          "language": "chinese"
        }
   } 
 }
```