All Products
Search
Document Center

Application Real-Time Monitoring Service:GetPrometheusInstance

Last Updated:Mar 22, 2023

Queries the information about the specified Prometheus instance.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The ID of the region.

cn-hangzhou
ClusterIdstringYes

The ID of the Prometheus instance.

c77f6f2397ea74672872acf5e31374a27

Response parameters

ParameterTypeDescriptionExample
object

Schema of Response

RequestIdstring

Id of the request

52C422FD-6B43-524D-B8A1-A4693294318C
Messagestring

The message that is returned.

message
Codeinteger

The HTTP status code that is returned. The HTTP 200 status code indicates that the call is successful. If a different HTTP status code is returned, the call fails.

200
Dataobject

The information that is returned.

ClusterIdstring

The ID of the Prometheus instance.

c589a1b8db05c4561aefbb898ca8fb1cf
RegionIdstring

The ID of the region.

cn-beijing
UserIdstring

The ID of the user.

167275301789****
ClusterNamestring

The name of the cluster.

prom1
ClusterTypestring

The type of the cluster. Valid values: remote-write (Prometheus instance for Remote Write), ecs (Prometheus instance for ECS), Prometheus for Cloud Services, cloud-product (Prometheus instance for Alibaba Cloud services outside China), global-view (Prometheus instance for GlobalView), and aliyun-cs (Prometheus for Container Service).

remote-write
VpcIdstring

The virtual private cloud (VPC) where the cluster resides.

vpc-8vb02uk57qbcktqcvqqqj
VSwitchIdstring

The ID of the vSwitch.

vsw-f8z73vcja1tqnw90aav5a
SecurityGroupIdstring

The ID of the security group.

sg-8vbdgmf4nraiqa9bx0jo
SubClustersJsonstring

The JSON string of the child instance of the GlobalView instance.

\[{"headers":{},"regionId":"cn-hangzhou","sourceType":"AlibabaPrometheus","extras":{},"clusterId":"c39a1048921e04fceb039db2fbb73\*\*\*","sourceName":"arms-luyao-test","dataSource":"","userId":"167275301789\*\*\*"},{"headers":{},"regionId":"cn-beijing","sourceType":"AlibabaPrometheus","extras":{},"clusterId":"c6b6485496d5b400abde22cb47b5\*\*\*\*","sourceName":"agent-321-test","dataSource":"","userId":"1672753017899\*\*\*"},{"headers":{},"regionId":"cn-zhangjiakou","sourceType":"AlibabaPrometheus","extras":{},"clusterId":"c261a4f3200c446659133f1ade789b15e","sourceName":"zaifeng-cardinality-01","dataSource":"","userId":"167275301789\*\*\*"}]
PaymentTypestring

The billing method. Valid values: PREPAY (subscription) and POSTPAY (pay-as-you-go).

PREPAY
GrafanaInstanceIdstring

The ID of the Grafana workspace.

grafana-rnggfvhlcdl6m71***
ResourceGroupIdstring

The ID of the resource group to which the instance belongs.

rg-aek2vezare****
ResourceTypestring

The type of the resource. Only PROMETHEUS is supported.

PROMETHEUS
Tagsarray

The tags of the instance.

object

The tag of the instance.

TagKeystring

The tag key of the instance.

tag1
TagValuestring

The tag value of the instance.

tagValue1

Examples

Sample success responses

JSONformat

{
  "RequestId": "52C422FD-6B43-524D-B8A1-A4693294318C",
  "Message": "message",
  "Code": 200,
  "Data": {
    "ClusterId": "c589a1b8db05c4561aefbb898ca8fb1cf",
    "RegionId": "cn-beijing",
    "UserId": "167275301789****",
    "ClusterName": "prom1",
    "ClusterType": "remote-write",
    "VpcId": "vpc-8vb02uk57qbcktqcvqqqj",
    "VSwitchId": "vsw-f8z73vcja1tqnw90aav5a",
    "SecurityGroupId": "sg-8vbdgmf4nraiqa9bx0jo",
    "SubClustersJson": "\\[{\"headers\":{},\"regionId\":\"cn-hangzhou\",\"sourceType\":\"AlibabaPrometheus\",\"extras\":{},\"clusterId\":\"c39a1048921e04fceb039db2fbb73\\*\\*\\*\",\"sourceName\":\"arms-luyao-test\",\"dataSource\":\"\",\"userId\":\"167275301789\\*\\*\\*\"},{\"headers\":{},\"regionId\":\"cn-beijing\",\"sourceType\":\"AlibabaPrometheus\",\"extras\":{},\"clusterId\":\"c6b6485496d5b400abde22cb47b5\\*\\*\\*\\*\",\"sourceName\":\"agent-321-test\",\"dataSource\":\"\",\"userId\":\"1672753017899\\*\\*\\*\"},{\"headers\":{},\"regionId\":\"cn-zhangjiakou\",\"sourceType\":\"AlibabaPrometheus\",\"extras\":{},\"clusterId\":\"c261a4f3200c446659133f1ade789b15e\",\"sourceName\":\"zaifeng-cardinality-01\",\"dataSource\":\"\",\"userId\":\"167275301789\\*\\*\\*\"}]\n",
    "PaymentType": "PREPAY",
    "GrafanaInstanceId": "grafana-rnggfvhlcdl6m71***",
    "ResourceGroupId": "rg-aek2vezare****",
    "ResourceType": "PROMETHEUS",
    "Tags": [
      {
        "TagKey": "tag1",
        "TagValue": "tagValue1"
      }
    ]
  }
}

Error codes

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