• API White Paper

wp
  1. Help Center
  2. API White Paper
  3. API Reference
  4. Open Telekom Cloud API Open Scope Principles
  5. Principle 1: All Services Comply with API First Design Policy
  6. Later Versions Preferred

Later Versions Preferred

After a long-term evolution and development, API versions in many OpenStack Community projects have been upgraded. For some projects, such as Cinder and Glance, APIs of the new version can replace those of the earlier version. In this case, the API code of earlier versions is reserved for a period of time, but will be deprecated by the community at last and not maintained any more.

For the same OpenStack project, if APIs in multiple versions support the same function, Open Telekom Cloud provides the API in the latest version by default, preventing API conflicts caused by API changes. Open Telekom Cloud APIs in the earlier versions are not open to users.

For example, for APIs listed in the following table, Open Telekom Cloud preferentially use the new version.

Service

URI

Description

Availability

Cinder

POST /v2/{tenant_id}/volumes

Creating a volume

V2 (available)

Cinder

POST /v1/{tenant_id}/volumes

Creating a volume

V1, providing the same functions with V2, unavailable

Cinder

GET /v2/{tenant_id}/volumes/{volume_id}

Showing a volume

V2 (available)

Cinder

GET /v1/{tenant_id}/volumes/{volume_id}

Showing a volume

V1 (unavailable)

Glance

DELETE /v2/images/{image_id}

Deleting an image

V2 (available)

Glance

DELETE /v1.1/images/<resource_id>

Deleting an image

V1 (unavailable)

Glance

GET /v2/images

Listing an image

V2 (available)

Glance

GET /v1.1/images/detail

Listing the image detail

V1 (unavailable)

keystone

POST /v3/auth/tokens

Authentication

V3 (available)

keystone

POST /v2.0/tokens

Authentication

V2 (unavailable)