更新时间:2022-12-08 GMT+08:00

查询企业项目列表

功能介绍

查询当前用户已授权的企业项目列表,用户可以使用企业项目绑定资源。

URI

GET /v1.0/enterprise-projects

请求消息

  • 要素说明
    表1 请求样例的要素说明

    名称

    是否必选

    参数类型

    位置

    说明

    id

    String

    query

    企业项目ID,0表示搜索默认企业项目。

    limit

    Interger

    query

    查询记录数默认为1000,limit最多为1000,最小值为1。

    name

    String

    query

    企业项目名称,支持模糊搜索。

    offset

    Interger

    query

    索引位置,从offset指定的下一条数据开始查询,必须为数字,不能为负数,默认为0。

    sort_dir

    String

    query

    降序或升序,默认为“desc”。

    desc表示降序 ,asc 表示升序。

    sort_key

    String

    query

    返回结果按该关键字排序(支持updated_at等关键字,默认为“created_at”)

    status

    Integer

    query

    企业项目状态。

    1--启用,2--停用

  • 请求样例
    GET https://{EPS的Endpoint}/v1.0/enterprise-projects?name=prise_pro

响应消息

  • 要素说明
    表2 响应样例的要素说明

    名称

    参数类型

    说明

    enterprise_projects

    List<enterprise_project>

    企业项目列表。

    详细参数请参见表3

    total_count

    Integer

    满足查询条件的企业项目总数。

  • enterprise_project字段数据结构说明
    表3 enterprise_project字段数据结构说明

    名称

    参数类型

    说明

    id

    String

    企业项目ID。

    name

    String

    企业项目名称。

    description

    String

    企业项目描述。

    status

    Integer

    企业项目状态。

    1-启用,2-停用。

    created_at

    String

    创建时间,格式为UTC格式。

    如:2018-05-18T06:49:06Z。

    updated_at

    String

    修改时间,格式为UTC格式。

    如:2018-05-28T02:21:36Z。

  • 响应样例
    {
        "enterprise_projects": [
            {
                "id": "6fbcf2f3-3164-4d32-9a3e-a8886dc38c24",
                "name": "auto_test",
                "description": "hello world!",
                
                "status": 1,
                "created_at": "2018-05-18T06:49:06Z",
                "updated_at": "2018-05-28T02:21:36Z"
            }
        ],
        "total_count": 1
    }

状态码

请参考状态码

错误码

请参考错误码