All Products
Search
Document Center

CloudMonitor:DescribeProjectMeta

Last Updated:Mar 18, 2024

Queries the information about monitored services in CloudMonitor.

Operation description

The information obtained by this operation includes the service description, namespace, and tags.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
LabelsstringNo

The tags. Tags are used to filter services.

You can filter services only by the tag whose name is product. Example: {"name":"product","value":"ECS"}.

Note We recommend that you do not use the special tags in the CloudMonitor console.
[{"name":"product","value":"ECS"}]
PageNumberintegerNo

The page number.

Valid values: 1 to 100.

Default value: 1.

1
PageSizeintegerNo

The number of entries per page.

Valid values: 1 to 10000.

Default value: 30.

Note The value of this parameter is not limited. You can view a large number of entries per page.
30

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The request ID.

4C2061B2-3B1B-43BF-A4A4-C53426F479C0
Successboolean

Indicates whether the request was successful. Valid values: true: The request was successful. false: The request failed.

true
Codestring

The status code.

Note The status code 200 indicates that the request was successful.
200
Messagestring

The error message.

The Request is not authorization.
PageSizestring

The number of entries per page.

5
PageNumberstring

The page number.

1
Totalstring

The total number of entries returned.

12
Resourcesobject []

The details of the cloud service.

Namespacestring

The namespace of the cloud service. Format: acs_Service name abbreviation. For more information about namespaces, see Appendix 1: Metrics.

acs_cdn
Descriptionstring

The description.

CDN
Labelsstring

The tags. Tags are used to filter services.

Tags are returned in the following format: [{"name":"Tag key","value":"Tag value"}, {"name":"Tag key","value":"Tag value"}]. The following tags are commonly used:

  • alertUnit: the unit of the metric value in alerts. If the unit is small, the original metric value may be too large. In this case, you can use the alertUnit tag to specify an appropriate unit. This tag is used in CloudMonitor.
  • minAlertPeriod: the minimum time interval to report a new alert. The interval at which monitoring data is reported. The value is usually 1 minute.
  • metricCategory: the service specification. Example: kvstore_sharding. Some Alibaba Cloud services have multiple specifications that are defined in the same namespace. This parameter is used to identify the specifications.
  • is_alarm: indicates whether an alert rule can be configured. We recommend that you do not use the special tags in the CloudMonitor console.
[{"groupFlag":true}]

Examples

Sample success responses

JSONformat

{
  "RequestId": "4C2061B2-3B1B-43BF-A4A4-C53426F479C0",
  "Success": true,
  "Code": "200",
  "Message": "The Request is not authorization.",
  "PageSize": "5",
  "PageNumber": "1",
  "Total": "12",
  "Resources": {
    "Resource": [
      {
        "Namespace": "acs_cdn",
        "Description": "CDN",
        "Labels": "[{\"groupFlag\":true}]"
      }
    ]
  }
}

Error codes

HTTP status codeError codeError messageDescription
400ParameterInvalidIllegal parameters.-
403AccessForbiddenUser not authorized to operate on the specified resource.-
404ResourceNotFoundThe specified resource is not found.The specified resource is not found.
500InternalErrorThe request processing has failed due to some unknown error.-

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history