Querying the Service Catalog

Function

This API is used to query the service catalog corresponding to X-Auth-Token contained in the request.

URI

GET /v3/auth/catalog

Request Parameters

• Parameters in the request header

  Parameter	Mandatory	Type	Description
  X-Auth-Token	Yes	String	Authenticated scoped token of a project.

• Example request

  curl -i -k -H 'Accept:application/json' -H 'X-Auth-Token:$token' -H 'Content-Type:application/json;charset=utf8' -X GET https://sample.domain.com/v3/auth/catalog

Response Parameters

• Parameters in the response body

  Parameter	Type	Description
  catalog	Array of objects	Service catalog information.
  links	Object	Resource link information.

• catalog

  Parameter	Type	Description
  endpoints	Array of objects	Endpoint information.
  id	String	Service ID.
  name	String	Service name.
  type	String	Service type.

• catalog.endpoints

  Parameter	Type	Description
  id	String	Endpoint ID.
  interface	String	Plane to which the endpoint belongs. The value is public.
  region	String	Region to which the endpoint belongs.
  region_id	String	ID of the region to which the endpoint belongs.
  url	String	Endpoint URL.

• links

  Parameter	Type	Description
  self	String	Resource link.

{
  "catalog": [
    {
      "endpoints": [
        {
          "region_id": null,
          "url": "https://sample.domain.com/v2/c972a59e958e407e89b0c6d8e522df3b",
          "region": null,
          "interface": "public",
          "id": "04f0ee42038447f0a9c7b407028fd7b9"
        }
      ],
      "type": "compute",
      "id": "eb884e9f64b44dd0ac73cdc55d817286",
      "name": "nova"
    }
  ],
  "links": {
    "self": "https://sample.domain.com/v3/auth/catalog"
  }
}

Status Codes