# Checking for Tags of a BMS (Native OpenStack API)

#### Function

This API is used to check whether a BMS has a specified tag.

You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.

#### URI

GET /v2.1/{project_id}/servers/{server_id}/tags/{tag}

Table 1 lists the parameters.

Table 1 Parameter description
Parameter | Mandatory | Description
--- | --- | ---
project_id | Yes | Specifies the project ID. For how to obtain the project ID, see Obtaining Required Information.
server_id | Yes | Specifies the BMS ID. You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API.

tag

Yes

Specifies the key of the tag to be queried.

Constraints:

- URL encoding is required for special characters.
- If no tag key is specified, all tags of the BMS are displayed.

#### Request

- Request parameters

  None

- Example request

      1

      GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers/2d85af7c-cbfe-40c5-a378-4d03b42fb0e2/tags/{tag}

#### Response

If the specified tag exists, no response is returned.

If the specified tag does not exist, the response is as follows:

    1
    2
    3
    4
    5
    6

    {
        "itemNotFound": {
            "message": "Server 2d85af7c-cbfe-40c5-a378-4d03b42fb0e2 has no tag 'abc'",
            "code": 404
        }
    }

#### Returned Values

Normal values

Returned Values | Description
--- | ---
204 | The server has processed the request but did not return any content.

For details about other returned values, see Status Codes.

#### Error Codes

See Error Codes.

Parent topic: BMS 1D Tag Management