获取TTS租户级词表分组列表 - ListTtscVocabularyGroups

功能介绍

该接口用于获取TTS租户级词表分组列表。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /v1/{project_id}/ttsc/vocabulary-groups

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID，获取方法请参考获取项目ID。

表2 Query参数
参数	是否必选	参数类型	描述
limit	否	Integer	每页显示的条目数量。取值范围： 1~100 默认取值： 10
offset	否	Integer	偏移量，表示从此偏移量开始查询。取值范围： 0~2147483647 默认取值： 0
group_id	否	String	分组id

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Request-Id	否	String	请求requestId，用来标识一路请求，用于问题跟踪定位，建议使用uuId，若不携带，则后台自动生成
X-Auth-Token	否	String	用户Token。使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取。响应消息头中X-Subject-Token的值。
Authorization	否	String	使用AK/SK方式认证时必选，携带的鉴权信息。
X-Sdk-Date	否	String	使用AK/SK方式认证时必选，请求的发生时间。
X-Project-Id	否	String	使用AK/SK方式认证时必选，携带项目ID信息。
X-App-UserId	否	String	第三方用户ID。不允许输入中文。

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
count	Integer	总记录数。取值范围： 0~2147483647
data	Array of TtscGroupAssetsConfig objects	自定义词表分组列表。

表5 TtscGroupAssetsConfig
参数	参数类型	描述
group_id	String	分组id
group_name	String	分组名称
asset_ids	Array of strings	每个分组的资产id列表

状态码：400

表6 响应Body参数
参数	参数类型	描述
error_code	String	业务返回码 MSS.000000001 - 失败 MSS.000000002 - 内部错误 MSS.000000003 - 非法参数 MSS.000000004 - 非法访问，未鉴权或者鉴权失败
error_msg	String	返回描述
request_id	String	请求唯一标识

状态码：500

表7 响应Body参数
参数	参数类型	描述
error_code	String	业务返回码 MSS.000000001 - 失败 MSS.000000002 - 内部错误 MSS.000000003 - 非法参数 MSS.000000004 - 非法访问，未鉴权或者鉴权失败
error_msg	String	返回描述
request_id	String	请求唯一标识

请求示例

Get https://{endpoint}/v1/3f0924078d1b471c884a5383d4dec9fa/ttsc/vocabulary-groups

响应示例

状态码：200

处理成功。

{
  "count" : 1,
  "data" : [ {
    "group_id" : "90247b5e90247b5e90247b5e11111111",
    "group_name" : "词表名称",
    "asset_ids" : [ "7b5e90247b5e90247b5e902422222222" ]
  } ]
}