Tous les produits
Search

Ce produit

    Managed Service for Prometheus:ListPrometheusInstanceByTagAndResourceGroupId

    Centre de documentation

    Managed Service for Prometheus:ListPrometheusInstanceByTagAndResourceGroupId

    Dernière mise à jour :Aug 18, 2026

    Consulte les instances Prometheus par balise et groupe de ressources.

    Testez maintenant

    Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

    Test

    Autorisation RAM

    Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

    • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

    • API : l'API que vous pouvez appeler pour exécuter l'action.

    • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

    • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

      • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

      • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

    • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

    • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

    arms:ListPrometheusInstanceByTagAndResourceGroupId

    list

    *Prometheus.

    acs:arms:{#regionId}:{#accountId}:prometheus/*

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    RegionId

    string

    Oui

    L'identifiant de la région de l'instance Prometheus.

    cn-hangzhou
    ResourceGroupId

    string

    Non

    L'identifiant du groupe de ressources.

    rg-acfmxyexli2****
    Tag

    array<object>

    Non

    Les balises.

    object

    Non

    La balise de la ressource.

    Key

    string

    Non

    La clé de la balise.

    fpx-tag
    Value

    string

    Non

    La valeur de la balise.

    fvt-tag-value

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    Schéma de la réponse.

    RequestId

    string

    L'identifiant de la requête.

    4789C3E9-A85A-524B-B97B-9D2B14BA06BC
    Data

    object

    La structure renvoyée.

    PrometheusInstances

    array<object>

    Les instances Prometheus interrogées.

    array<object>

    ClusterId

    string

    L'identifiant de l'instance Prometheus.

    c9d5dda1aeca64220853ace304baeb03d
    RegionId

    string

    L'identifiant de la région.

    cn-shanghai
    UserId

    string

    L'identifiant de l'utilisateur.

    1672753017899***
    ClusterName

    string

    Le nom de l'instance Prometheus.

    prom1
    ClusterType

    string

    Le type d'instance. Valeurs valides :

    • remote-write : instance Prometheus pour Remote Write

    • ecs : instances Prometheus pour ECS

    • cloud-monitor : instance Prometheus pour les services Alibaba Cloud en Chine continentale

    • cloud-product : instance Prometheus pour les services Alibaba Cloud en dehors de la Chine continentale

    • global-view : instance d'agrégation globale

    • aliyun-cs : instance Prometheus pour Container Service

    ecs
    VpcId

    string

    L'identifiant du cloud privé virtuel (VPC).

    vpc-8vbtp1fsm8mir18l8rl0u
    VSwitchId

    string

    L'identifiant du vSwitch.

    vsw-f8z73vcja1tqnw90aav5a
    SecurityGroupId

    string

    L'identifiant du groupe de sécurité.

    sg-f8zd1toc10wmbi1v5rom
    SubClustersJson

    string

    Les instances enfants de l'instance d'agrégation globale. La valeur est une chaîne JSON.

    [ { "headers": {}, "regionId": "cn-hangzhou", "sourceType": "AlibabaPrometheus", "extras": {}, "clusterId": "c39a1048921e04fceb039db2fb****", "sourceName": "arms-luyao-test", "dataSource": "", "userId": "167275301789****" }, { "headers": {}, "regionId": "cn-beijing", "sourceType": "AlibabaPrometheus", "extras": {}, "clusterId": "c6b6485496d5b400abde22cb47b5****", "sourceName": "agent-321-测试", "dataSource": "", "userId": "167275301789****" }, { "headers": {}, "regionId": "cn-zhangjiakou", "sourceType": "AlibabaPrometheus", "extras": {}, "clusterId": "c261a4f3200c446659133f1ade78****", "sourceName": "zaifeng-cardinality-01", "dataSource": "", "userId": "167275301789****" } ]
    RemoteReadIntraUrl

    string

    L'URL interne pour Remote Read.

    http://cn-beijing-intranet.arms.aliyuncs.com:9090/api/v1/prometheus/xxx/api/v1/read
    RemoteReadInterUrl

    string

    L'URL publique pour Remote Read.

    http://cn-beijing.arms.aliyuncs.com:9090/api/v1/prometheus/xxx/api/v1/read
    RemoteWriteIntraUrl

    string

    L'URL interne pour Remote Write.

    http://cn-beijing-intranet.arms.aliyuncs.com/prometheus/xxx/api/v3/write
    RemoteWriteInterUrl

    string

    L'URL publique pour Remote Write.

    https://cn-beijing.arms.aliyuncs.com/prometheus/xxx/api/v3/write
    PushGatewayIntraUrl

    string

    L'URL interne pour Pushgateway.

    http://cn-beijing-intranet.arms.aliyuncs.com/prometheus/xxx/api/v2
    PushGatewayInterUrl

    string

    L'URL publique pour Pushgateway.

    https://cn-beijing.arms.aliyuncs.com/prometheus/xxx/api/v2
    HttpApiIntraUrl

    string

    L'URL interne pour l'API HTTP.

    http://cn-beijing-intranet.arms.aliyuncs.com:9090/api/v1/prometheus/xxx
    HttpApiInterUrl

    string

    L'URL publique pour l'API HTTP.

    https://cn-beijing.arms.aliyuncs.com:9443/api/v1/prometheus/xxx
    AuthToken

    string

    Le jeton d'autorisation.

    GciOiJIUzI1NiJ9***
    PaymentType

    string

    La méthode de facturation. Valeurs valides :

    • PREPAY : abonnement

    • POSTPAY : paiement à l'usage

    POSTPAY
    GrafanaInstanceId

    string

    L'identifiant de l'espace de travail Grafana.

    grafana-rnggfvhlcdl6m71l**
    ResourceGroupId

    string

    L'identifiant du groupe de ressources auquel l'instance Prometheus appartient.

    rg-acfmz7nocpeidcy
    ResourceType

    string

    Le type de ressource.

    PROMETHEUS
    Tags

    array<object>

    La liste des balises.

    object

    La balise.

    TagKey

    string

    La clé de la balise.

    ac-cus-tag-3
    TagValue

    string

    La valeur de la balise.

    asg-2vc8qq7x89o11rus9uvu
    Code

    string

    Le code de réponse. Le code d'état 200 indique que la requête a réussi. Les autres codes d'état indiquent que la requête a échoué.

    200
    Message

    string

    Le message renvoyé.

    message

    Exemples

    JSON format

    {
  "RequestId": "4789C3E9-A85A-524B-B97B-9D2B14BA06BC",
  "Data": {
    "PrometheusInstances": [
      {
        "ClusterId": "c9d5dda1aeca64220853ace304baeb03d",
        "RegionId": "cn-shanghai",
        "UserId": "1672753017899***",
        "ClusterName": "prom1",
        "ClusterType": "ecs",
        "VpcId": "vpc-8vbtp1fsm8mir18l8rl0u",
        "VSwitchId": "vsw-f8z73vcja1tqnw90aav5a",
        "SecurityGroupId": "sg-f8zd1toc10wmbi1v5rom",
        "SubClustersJson": "[\n  {\n    \"headers\": {},\n    \"regionId\": \"cn-hangzhou\",\n    \"sourceType\": \"AlibabaPrometheus\",\n    \"extras\": {},\n    \"clusterId\": \"c39a1048921e04fceb039db2fb****\",\n    \"sourceName\": \"arms-luyao-test\",\n    \"dataSource\": \"\",\n    \"userId\": \"167275301789****\"\n  },\n  {\n    \"headers\": {},\n    \"regionId\": \"cn-beijing\",\n    \"sourceType\": \"AlibabaPrometheus\",\n    \"extras\": {},\n    \"clusterId\": \"c6b6485496d5b400abde22cb47b5****\",\n    \"sourceName\": \"agent-321-测试\",\n    \"dataSource\": \"\",\n    \"userId\": \"167275301789****\"\n  },\n  {\n    \"headers\": {},\n    \"regionId\": \"cn-zhangjiakou\",\n    \"sourceType\": \"AlibabaPrometheus\",\n    \"extras\": {},\n    \"clusterId\": \"c261a4f3200c446659133f1ade78****\",\n    \"sourceName\": \"zaifeng-cardinality-01\",\n    \"dataSource\": \"\",\n    \"userId\": \"167275301789****\"\n  }\n]",
        "RemoteReadIntraUrl": "http://cn-beijing-intranet.arms.aliyuncs.com:9090/api/v1/prometheus/xxx/api/v1/read",
        "RemoteReadInterUrl": "http://cn-beijing.arms.aliyuncs.com:9090/api/v1/prometheus/xxx/api/v1/read",
        "RemoteWriteIntraUrl": "http://cn-beijing-intranet.arms.aliyuncs.com/prometheus/xxx/api/v3/write",
        "RemoteWriteInterUrl": "https://cn-beijing.arms.aliyuncs.com/prometheus/xxx/api/v3/write",
        "PushGatewayIntraUrl": "http://cn-beijing-intranet.arms.aliyuncs.com/prometheus/xxx/api/v2",
        "PushGatewayInterUrl": "https://cn-beijing.arms.aliyuncs.com/prometheus/xxx/api/v2",
        "HttpApiIntraUrl": "http://cn-beijing-intranet.arms.aliyuncs.com:9090/api/v1/prometheus/xxx",
        "HttpApiInterUrl": "https://cn-beijing.arms.aliyuncs.com:9443/api/v1/prometheus/xxx",
        "AuthToken": "GciOiJIUzI1NiJ9***",
        "PaymentType": "POSTPAY",
        "GrafanaInstanceId": "grafana-rnggfvhlcdl6m71l**",
        "ResourceGroupId": "rg-acfmz7nocpeidcy",
        "ResourceType": "PROMETHEUS",
        "Tags": [
          {
            "TagKey": "ac-cus-tag-3",
            "TagValue": "asg-2vc8qq7x89o11rus9uvu"
          }
        ]
      }
    ]
  },
  "Code": "200",
  "Message": "message"
}

    Codes d'erreur

    Consultez Codes d'erreur pour la liste complète.

    Notes de version

    Consultez Notes de version pour la liste complète.