更新时间:2025-08-18 GMT+08:00
分享

查询领域列表V2

功能介绍

查询领域列表V2。

调用方法

请参见如何调用API

URI

GET /v2/domain/domain

表1 Query参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目的32位uuid,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。

约束限制

32位的数字和字母组成的字符串。

取值范围

不涉及。

默认取值

不涉及。

flag

Integer

参数解释:

该领域是否配置到项目。

约束限制:

不涉及。

取值范围:

0(没有配置到项目)

1(该领域配置到项目)

默认取值:

不涉及。

offset

Integer

参数解释:

分页索引,偏移量,offset是limit的整数倍数。例如,offset为0表示从第一个记录开始,offset为10表示从第11个记录开始。

约束限制:

不涉及。

取值范围:

最小值:0,最大值:10000。

默认取值:

缺省值:0。

limit

Integer

参数解释:

条数,每页显示查询的数量。

约束限制:

不涉及。

取值范围:

最小长度:1,最大长度:10。

默认取值:

10。

page_no

Integer

参数解释:

分页索引。

约束限制:

不涉及

取值范围:

最小值0,最大值9,999,999,999。

默认取值:

不涉及。

page_size

Integer

参数解释:

分页大小。

约束限制:

不涉及。

取值范围:

最小值0,最大值9,999,999,999。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

必传。

取值范围:

最小长度:10,最大长度:32768。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

-

String

领域设置的返回信息。

result

result object

参数解释:

返回结果。

status

String

参数解释:

返回状态。

约束限制:

success:返回成功

error :返回失败

表4 result

参数

参数类型

描述

domains

Array of domains objects

参数解释:*

领域设置

取值范围:

不涉及。

total_count

Integer

参数解释:

领域设置的数量。

取值范围:

不涉及。

表5 domains

参数

参数类型

描述

id

Integer

参数解释:

领域id

取值范围:

不涉及。

name

String

参数解释:

领域名称

取值范围:

不涉及。

flag

Integer

参数解释:

领域是否配置到该项目。

取值范围:

0(没有配置到项目)

1(该领域配置到项目)

project_id

Integer

参数解释:

项目数字id

取值范围:

不涉及。

domain_id

Integer

参数解释:

领域数字id

取值范围:

不涉及。

project_uuid

String

参数解释:

项目的32位uuid,项目唯一标识,通过查询项目列表(ListProjectsV4.xml)接口获取,响应消息体中的project_id字段的值就是项目ID。

取值范围:

不涉及。

default_d

Integer

参数解释:

领域是否配置到该项目的默认值。

取值范围:

1。

请求示例

{endpoint}/v2/domain/domain?project_id=5192de5eb435430c8cd41c6ae6028848&page_no=1&page_size=10&flag=1&_=1753181122622

响应示例

状态码:200

返回信息

{
  "result": {
    "domains": [
      {
        "id": 14,
        "name": "性能",
        "flag": 1,
        "project_id": 35138974,
        "domain_id": 14,
        "project_uuid": "5192de5eb435430c8cd41c6ae6028848",
        "default_d": 1
      },
      {
        "id": 15,
        "name": "功能",
        "flag": 1,
        "project_id": 35138974,
        "domain_id": 15,
        "project_uuid": "5192de5eb435430c8cd41c6ae6028848",
        "default_d": 1
      },
      {
        "id": 16,
        "name": "可靠性",
        "flag": 1,
        "project_id": 35138974,
        "domain_id": 16,
        "project_uuid": "5192de5eb435430c8cd41c6ae6028848",
        "default_d": 1
      },
      {
        "id": 17,
        "name": "网络安全",
        "flag": 1,
        "project_id": 35138974,
        "domain_id": 17,
        "project_uuid": "5192de5eb435430c8cd41c6ae6028848",
        "default_d": 1
      },
      {
        "id": 18,
        "name": "可维护性",
        "flag": 1,
        "project_id": 35138974,
        "domain_id": 18,
        "project_uuid": "5192de5eb435430c8cd41c6ae6028848",
        "default_d": 1
      },
      {
        "id": 19,
        "name": "其他DFX",
        "flag": 1,
        "project_id": 35138974,
        "domain_id": 19,
        "project_uuid": "5192de5eb435430c8cd41c6ae6028848",
        "default_d": 1
      },
      {
        "id": 20,
        "name": "可用性",
        "flag": 1,
        "project_id": 35138974,
        "domain_id": 20,
        "project_uuid": "5192de5eb435430c8cd41c6ae6028848",
        "default_d": 1
      },
      {
        "id": 56599,
        "name": "111",
        "flag": 1,
        "project_id": 35138974,
        "domain_id": 56599,
        "project_uuid": "5192de5eb435430c8cd41c6ae6028848",
        "default_d": 0,
      }
    ],
    "total_count": 8
  },
  "status": "success"
}

状态码

状态码

描述

200

返回信息

错误码

请参见错误码

相关文档