• Image Management Service

ims
  1. Help Center
  2. Image Management Service
  3. API Reference
  4. APIs
  5. Image Tagging (Extension APIs)
  6. Querying Tags

Querying Tags

Function

This API is used to query image tags using search criteria and display them in a list.

URI

  • URI format

    GET /v1/cloudimages/tags

NOTE:

You can type a question mark (?) and an ampersand (&) at the end of the URI to define multiple search criteria. For details, see the example request.

  • Parameter description

    Parameter

    Mandatory

    Type

    Description

    limit

    No

    Integer

    Specifies the number of tags to be queried. The value is an integer. All tags can be queried by default.

    page

    No

    Integer

    Specifies the number of the page on which tags are to be queried. The default value is 1.

Request

Example request
GET /v1/cloudimages/tags?limit=5&page=1 

Response

  • Parameter description

    Parameter

    Type

    Description

    tags

    List<String>

    Lists the tags.

  • Example response
    STATUS CODE 200
    {
       "tags": [
          "jjjj.11111",
          "uuuu.22222",
          "234.4",
          "test",
          "image"
       ]
    }
    NOTE:

    In the new specification, equal signs are used as separators.

Returned Values

  • Normal

    200

  • Abnormal

    Return Value

    Description

    400 Bad Request

    Request error. For details about the returned error code, see Error Codes.

    401 Unauthorized

    Authentication failed.

    403 Forbidden

    You do not have the rights to perform the operation.

    404 Not Found

    The requested resource was not found.

    500 Internal Server Error

    Internal service error.

    503 Service Unavailable

    The service is unavailable.