Querying Tag Values_Prometheus Monitoring_APIs_API Reference_Application Operations Management-Huawei Cloud

This API is used to query the values of a specified tag.

For details, see Calling APIs.

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action

Access Level

Resource Type (*: required)

Condition Key

Alias

Dependencies

aom:metric:list

List

-

-

aom:metric:get

-

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
aom:metric:list	List	-	-	aom:metric:get	-

GET /v1/{project_id}/aom/api/v1/label/{label_name}/values

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
label_name	Yes	String	Tag specified for query. You can obtain tag names by calling the API Obtaining the Tag Name List Using the POST Method.
project_id	Yes	String	Project ID, which can be obtained from the console or by calling an API. For details, see Obtaining a Project ID.

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token obtained from IAM. For details, see Obtaining a Token.

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
status	String	Definition: Response status. Range: success: A success message is returned. error: A failure message is returned.
data	Array of strings	Tag value.

Status code: 400

**Table 4** Response body parameters
Parameter	Type	Description
status	String	Definition: Response status. Range: success: A success message is returned. error: A failure message is returned.
errorType	String	Error type.
error	String	Error message.

Status code: 403

**Table 5** Response body parameters
Parameter	Type	Description
status	String	Definition: Response status. Range: success: A success message is returned. error: A failure message is returned.
errorType	String	Error type.
error	String	Error message.

Status code: 422

**Table 6** Response body parameters
Parameter	Type	Description
status	String	Definition: Response status. Range: success: A success message is returned. error: A failure message is returned.
errorType	String	Error type.
error	String	Error message.

Status code: 503

**Table 7** Response body parameters
Parameter	Type	Description
status	String	Definition: Response status. Range: success: A success message is returned. error: A failure message is returned.
errorType	String	Error type.
error	String	Error message.

Query all values of the "job" tag.

https://{EndPoint}/v1/{project_id}/aom/api/v1/label/job/values

Status code: 200

{
  "status" : "success",
  "data" : [ "node", "prometheus" ]
}

Status code: 400

{
  "status" : "error",
  "errorType" : "bad_param",
  "error" : "param is invalid."
}

Status code: 403

{
  "status" : "error",
  "errorType" : "auth",
  "error" : "auth project_id not pass."
}

Status code: 422

{
  "status" : "error",
  "errorType" : "execution",
  "error" : "expression can't be executed."
}

Status code: 503

{
  "status" : "error",
  "errorType" : "timeout",
  "error" : "query timed out in query execution."
}

Status Code	Description
200	OK: The request is successful.
400	Bad Request: The request is invalid. The client should not repeat the request without modifications.
403	Forbidden: The request is rejected. The server has received the request and understood it, but the server refuses to respond to it. The client should not repeat the request without modifications.
422	Unprocessable: The expression cannot be executed.
503	Service Unavailable: The requested service is invalid. The client should not repeat the request without modifications.

Querying Tag Values