• Elastic Volume Service

evs
  1. Help Center
  2. Elastic Volume Service
  3. API Reference
  4. API v2
  5. EVS Tag
  6. Querying EVS Resources by Tag (Deprecated)

Querying EVS Resources by Tag (Deprecated)

Function

This API is used to query the EVS resources by tag.

This API has been deprecated. Use another API. For details, see Querying Details of EVS Disks by Tag.

Constraints

None

URI

  • URI format

    GET /v2/{project_id}/os-vendor-tags/{resource_type}/resource_instances

    Examples:

    • https://{{evs_url}}/v2/{{project_id}}/os-vendor-tags/volumes/resource_instances?tags={'test':['test']}
    • https://{{evs_url}}/v2/{{project_id}}/os-vendor-tags/volumes/resource_instances
  • Parameter description

    Parameter

    Mandatory

    Description

    project_id

    Yes

    Specifies the project ID.

    resource_type

    Yes

    Specifies the resource type. The value can be volumes, snapshots, or backups.

  • Request filter parameters

    Parameter

    Type

    Mandatory

    Description

    tags

    string

    No

    Specifies to query EVS resources owning the tags in the filtering tag.

    For example, if the filtering tag is tags={'a':['b', 'c'], 'd':['e']}, EVS resources owning tags (key is a and value is b or c) and tags (key is d and value is e) are queried.

    tags_any

    string

    No

    Specifies to query EVS resources owing one of the tags in the filtering tag.

    For example, if the filtering tag is tags_any={'a':['b', 'c'], 'd':['e']}, EVS resources owning tags (key is a and value is b or c) or tags (key is d and value is e) are queried.

    not_tags

    string

    No

    Specifies to query EVS resources not owning the tags in the filtering tag.

    For example, if the filtering tag is not_tags={'a':['b', 'c'], 'd':['e']}, EVS resources not owning tags (key is a and value is b or c) and tags (key is d and value is e) are queried.

    not_tags_any

    string

    No

    Specifies to query EVS resources not owning one of the tags in the filtering tag.

    For example, if the filtering tag is not_tags={'a':['b', 'c'], 'd':['e']}, EVS resources not owning tags (key is a and value is b or c) or tags (key is d and value is e) are queried.

Request

None

Response

  • Parameter description

    Parameter

    Type

    Description

    total_count

    int

    Specifies the number of EVS resources.

    resources

    list

    Specifies the EVS resource lists.

  • Example response
    {
        "total_count": 2, 
        "resources": [
            {
                "resource_name": null, 
                "resource_detail": {
                    "status": "available", 
                    "description": null, 
                    "availability_zone": "eu-de-01", 
                    "updated_at": "2017-07-26T08:14:07.857625", 
                    "source_volid": null, 
                    "snapshot_id": null, 
                    "id": "47cc4949-447a-43dc-b482-a1d7917fef69", 
                    "size": 45, 
                    "name": null, 
                    "bootable": "true", 
                    "created_at": "2017-07-26T08:09:39.787432", 
                    "multiattach": false
                }, 
                "tags": {
                    "a": "c", 
                    "d": "e"
                }, 
                "resource_id": "47cc4949-447a-43dc-b482-a1d7917fef69"
            }, 
            {
                "resource_name": null, 
                "resource_detail": {
                    "status": "available", 
                    "description": null, 
                    "availability_zone": "eu-de-01", 
                    "updated_at": "2017-07-26T08:02:11.250455", 
                    "source_volid": null, 
                    "snapshot_id": null, 
                    "id": "588e94ef-eb2d-4895-a692-18163a7eeddc", 
                    "size": 100, 
                    "name": null, 
                    "bootable": "false", 
                    "created_at": "2017-07-26T08:00:51.563309", 
                    "multiattach": false
                }, 
                "tags": {
                    "a": "c", 
                    "d": "e"
                }, 
                "resource_id": "588e94ef-eb2d-4895-a692-18163a7eeddc"
            }
        ]
    }

    or

    {
        "error": {
            "message": "XXXX", 
            "code": "XXX"
        }
    }

    In the preceding example, error indicates a general error, for example, badRequest or itemNotFound. An example is provided as follows:

    {
        "computeFault": {
            "message": "The server has either erred or is incapable of performing the requested operation.", 
            "code": 500
        }
    }

Returned Values

  • Normal

    200

Error Codes

For details, see Error Codes.