查询项目空间列表 - ListPrograms
功能介绍
查询项目空间列表。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
URI
GET /v4/programs
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| limit | 否 | Integer | 查询项目空间列表数目,最大为100 |
| offset | 否 | Integer | 查询项目空间列表偏移量 |
| search | 否 | String | 模糊查询项目空间名称或者描述 |
| sort_key | 否 | String | 排序字段,支持name,created_time排序, |
| sort_dir | 否 | String | 排序顺序ASC,DESC |
| is_watched | 否 | Boolean | 是否关注,false 未关注, true 已关注 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| programs | Array of ProgramItem objects | 项目空间列表 |
| total | Integer | 项目空间总数 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| created_time | Long | 参数解释: 创建时间。 取值范围: 时间戳。 |
| creator | User object | 参数解释: 创建人。 |
| description | String | 参数解释: 项目空间描述。 取值范围: 最少1位字符,最大128位字符。 |
| is_archived | Boolean | 参数解释: 归档状态。 取值范围:, true(已归档); false(未归档)。 |
| is_watched | Boolean | 是否关注, true 已关注, false 未关注 |
| name | String | 参数解释: 项目空间名称。 取值范围: 最少0位字符,最大500位字符。 |
| owner | User object | 参数解释: 所有者。 |
| program_id | String | 参数解释: 项目空间uuid。 取值范围: 32位uuid。 |
| updated_time | Long | 参数解释: 更新时间。 取值范围: 时间戳。 |
| project_count | Integer | 项目空间关联的项目数,1个项目最多关联100个项目 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| domain_id | String | 参数解释: 租户uuid 取值范围: 不涉及 |
| domain_name | String | 参数解释: 租户名 取值范围: 不涉及 |
| gender | String | 参数解释: 性别 取值范围: 不涉及 |
| nick_name | String | 参数解释: 昵称 取值范围: 不涉及 |
| user_id | String | 参数解释: 用户uuid 取值范围: 不涉及 |
| user_name | String | 参数解释: 用户名 取值范围: 不涉及 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 不涉及。 |
| error_msg | String | 参数解释: 错误描述。 取值范围: 不涉及。 |
状态码:401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 不涉及。 |
| error_msg | String | 参数解释: 错误描述。 取值范围: 不涉及。 |
请求示例
GET https://{endpoint}/v4/programs
GET https://{endpoint}/v4/programs 响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 200 | 成功返回项目空间列表 |
| 400 | Bad Request |
| 401 | Unauthorized |
错误码
请参见错误码。