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

查询服务列表

功能介绍

该接口用于查询服务列表。

URI

  • URI格式

    GET /v3/services{?type}

  • 参数说明

    参数

    是否必选

    类型

    说明

    type

    String

    服务类型。

    可能取值为compute,ec2,identity,image, network,或volume。

请求

  • Request Header参数说明

    参数

    是否必选

    类型

    说明

    Content-Type

    String

    该字段内容填为“application/json;charset=utf8”

    X-Auth-Token

    String

    已认证的token。

  • 请求样例
    curl -i -k -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf8' -H "X-Auth-Token:$token" -X GET https://sample.domain.com/v3/services?type=compute

响应

  • Response Body参数说明

    参数

    是否必选

    类型

    说明

    links

    Dict

    服务的资源链接。

    services

    List

    服务列表。

  • services格式说明

    参数

    是否必选

    类型

    说明

    description

    String

    服务描述。

    enabled

    Boolean

    服务是否可用。

    id

    String

    服务ID。

    name

    String

    服务名。

    type

    String

    服务类型。

    links

    Dict

    服务的资源链接。

  • 响应样例(响应成功)
    {
        "services": [
            {
                "name": "compute5",
                "links": {
                    "self": "https://sample.domain.com/v3/services/053d21d488d1463c818132d9d08fb617"
                },
                "enabled": true,
                "type": "compute",
                "id": "053d21d488d1463c818132d9d08fb617",
                "description": "Compute service 5"
            },
            {
                "name": "compute3",
                "links": {
                    "self": "https://sample.domain.com/v3/services/c2474183dca7453bbd73123a0b78feae"
                },
                "enabled": true,
                "type": "compute",
                "id": "c2474183dca7453bbd73123a0b78feae",
                "description": "Compute service 3"
            },
            {
                "name": "compute2",
                "links": {
                    "self": "https://sample.domain.com/v3/services/c7166694ebdd4616bd927737f7b12ca2"
                },
                "enabled": true,
                "type": "compute",
                "id": "c7166694ebdd4616bd927737f7b12ca2",
                "description": "Compute service 2"
            }
        ],
        "links": {
            "self": "https://sample.domain.com/v3/services?type=compute",
            "previous": null,
            "next": null
        }
    }

状态码

状态码

说明

200

请求成功。

400

请求错误。

401

认证失败。

403

鉴权失败。

404

找不到资源。

405

不允许的方法。

413

请求体过大。

500

内部服务错误。

503

服务不可用。