查询企业项目列表
功能介绍
查询企业项目列表。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
接口约束
仅支持部分Region使用，详情参考终端节点。
URI
GET /v5/{project_id}/enterprise-projects
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
租户在某一Region下的Project ID。 获取方法请参见获取项目ID。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
offset |
否 |
Integer |
偏移量，表示从此偏移量开始查询， offset 大于等于 0。默认为0 缺省值：0 |
limit |
否 |
Integer |
每页显示的条目数量。默认为1000，取值范围【1-1000】 最小值：1 最大值：1000 缺省值：1000 |
name |
否 |
String |
企业项目名称，支持模糊搜索。 |
domain_id |
否 |
String |
IAM用户所属账号ID。op_service权限必须携带此参数，非op_service权限可不携带此参数。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
Content-Type |
是 |
String |
发送的实体的MIME类型。推荐用户默认使用application/json，如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。 缺省值：application/json |
X-Auth-Token |
是 |
String |
从IAM服务获取的用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 |
X-Language |
否 |
String |
请求语言类型。 缺省值：en-us 枚举值：
|
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
count |
Integer |
总数。 |
enterprise_project_list |
Array of objects |
企业项目列表。 详情请参见表5。 |
参数 |
参数类型 |
描述 |
|---|---|---|
id |
String |
企业项目ID。 |
name |
String |
企业项目名称。 |
description |
String |
描述。 |
status |
String |
企业项目状态。 |
created_at |
String |
创建时间，例如：2023-01-20T07:18:26Z |
updated_at |
String |
更新时间，例如：2023-03-01T09:42:02Z |
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
错误码。 最小长度：12 最大长度：12 |
error_msg |
String |
错误描述。 最小长度：1 最大长度：512 |
请求示例
查询企业项目列表请求示例。
https://{endpoint}/v5/{project_id}/enterprise-projects
响应示例
状态码： 200
{
"count": 113,
"enterprise_project_list": [
{
"id": "0",
"name": "default",
"status": "1"
},
{
"id": "2d8315f3-f25f-4481-a867-b7ef05a4b9c2",
"name": "eps_test_new_改名",
"status": "1",
"created_at": "2023-01-20T07:18:26Z",
"updated_at": "2023-01-20T15:32:29Z"
},
{
"id": "81b344c4-5644-485b-8ea7-398f3b8013cf",
"name": "(!@$%^-_=+[{}]:,./?~#*;|)",
"status": "1",
"created_at": "2022-09-27T02:41:22Z",
"updated_at": "2023-03-01T09:42:02Z"
},
{
"id": "59add094-0be7-49d0-a3ee-22de62f7eb4c",
"name": "DDS-test01_01",
"status": "1",
"created_at": "2022-02-25T08:04:44Z",
"updated_at": "2022-07-13T03:45:24Z"
},
{
"id": "6e2795dd-6fd1-4413-9038-cf1c1acc0940",
"name": "gaussdb_test02",
"description": "gaussdb_test02",
"status": "1",
"created_at": "2022-02-25T07:39:05Z",
"updated_at": "2022-02-25T07:39:05Z"
}
]
}
状态码： 422
Bad Request
{
"error_code": "DRS.M00277",
"error_msg": "该任务名称已存在"
}
错误码
请参见错误码。
