- API Reference
- Native OpenStack Nova V2.1 APIs
- BMS 1D Tag Management
- Checking for Tags of a BMS (Native OpenStack API)
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.
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 by calling the Querying BMSs (Native OpenStack API). |
tag | Yes | Specifies the key of the tag to be queried. Constraints:
|
Request¶
Request parameters
None
Example request
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:
{
"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.