Tous les produits
Search
Centre de documentation

Managed Service for Prometheus:CreatePrometheusInstance

Dernière mise à jour :Aug 18, 2026

Crée une instance Managed Service for Prometheus.

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:CreatePrometheusInstance

create

*Prometheus.

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

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

RegionId

string

Oui

L'identifiant réel de la région.

cn-shanghai

ClusterType

string

Oui

Le type d'instance. Valeurs valides :

  • remote-write : Prometheus for Remote Write.

  • ecs (n'est plus pris en charge) : Prometheus for ECS.

  • global-view : Prometheus for GlobalView.

  • aliyun-cs (n'est plus pris en charge) : Prometheus for Container Service.

  • cloud-product (n'est plus pris en charge) : Prometheus for Cloud Service.

  • cloud-monitor (n'est plus pris en charge) : Prometheus for Hybrid Cloud Monitoring.

  • flink (n'est plus pris en charge) : Prometheus for Flink.

remote-write

VpcId

string

Non

L'identifiant du VPC. Ce paramètre est requis lorsque ClusterType est défini sur ecs ou aliyun-cs pour un cluster ASK managé.

vpc-rpn**********

VSwitchId

string

Non

L'identifiant du vSwitch. Ce paramètre est requis lorsque ClusterType est défini sur ecs ou aliyun-cs pour un cluster ASK managé.

vsw-bp1*********

SecurityGroupId

string

Non

L'identifiant du groupe de sécurité réseau. Ce paramètre est requis lorsque ClusterType est défini sur ecs ou aliyun-cs pour un cluster ASK managé.

sg-bp1********

ClusterId

string

Non

L'identifiant du cluster Container Service. Ce paramètre est requis lorsque ClusterType est défini sur aliyun-cs.

cc7a37ee31aea4ed1a059eff8034b****

ClusterName

string

Non

Le nom du nouveau cluster. Ce paramètre est requis lorsque ClusterType est défini sur remote-write, ecs ou global-view.

Pour les instances ecs, le ClusterName doit suivre le format "name-vpc-id", et la partie nom ne peut pas dépasser 24 caractères. Exemple : "mytest1-vpc-xxxxxxxxxxx".

clusterNameOfTest

SubClustersJson

string

Non

La chaîne JSON des sous-instances pour l'instance GlobalView.

Lorsque clusterType est défini sur global-view, ce paramètre est requis : liste des informations sur les clusters à agréger. Exemple : [ { "headers":{ }, "regionId":"cn-hangzhou", "sourceType":"AlibabaPrometheus", "extras":{ }, "clusterId":"c39a1048921e04f***********", "sourceName":"arms-luyao-test", "dataSource":"", "userId":"1672753***********" }, { "headers":{ }, "regionId":"cn-beijing", "sourceType":"AlibabaPrometheus", "extras":{ }, "clusterId":"c6b6485496d5b40***********", "sourceName":"agent-321-test", "dataSource":"", "userId":"1672753***********" }, { "headers":{ }, "regionId":"cn-zhangjiakou", "sourceType":"AlibabaPrometheus", "extras":{ }, "clusterId":"c261a4f3200c446***********", "sourceName":"zaifeng-cardinality-01", "dataSource":"", "userId":"1672753***********" } ]

AllSubClustersSuccess

boolean

Non

Indique si toutes les sous-instances doivent passer la validation avant la création de l'instance GlobalView. Valeur par défaut : false, ce qui indique qu'un succès partiel est autorisé.

true

GrafanaInstanceId

string

Non

L'identifiant de l'espace de travail Grafana lié. Définissez ce paramètre sur "free" lorsque vous utilisez l'édition partagée de Grafana.

grafana-bp1*****

ResourceGroupId

string

Non

L'identifiant du groupe de ressources.

rg-acfmxyexli2****

Tags

array<object>

Non

Les balises personnalisées.

[ { "labelName":"labelValue" }, { "testName":"clusterA" } ]

object

Non

La liste des balises.

Key

string

Non

La clé de la balise.

TestKey

Value

string

Non

La valeur de la balise.

TestValue

Duration

integer

Non

La durée de stockage des données, en jours.

90

ArchiveDuration

integer

Non

Le nombre de jours pour archiver automatiquement les données après l'expiration de la période de stockage. Valeurs valides : 60, 90, 180 et 365. Une valeur de 0 indique que les données ne sont pas archivées.

90

PaymentType

string

Non

Les méthodes de facturation. Valeurs valides : POSTPAY : paiement à l'usage basé sur le nombre de métriques signalées. POSTPAY_GB : paiement à l'usage basé sur le volume de métriques écrites. Empty : utilise la méthode de facturation par défaut configurée par l'utilisateur. Si aucune valeur par défaut n'est configurée, le système facture par défaut en fonction du nombre de métriques signalées.

POSTPAY

Éléments de réponse

Élément

Type

Description

Exemple

object

Data

string

L'identifiant de l'instance renvoyé après la création de l'instance.

  • Pour les instances aliyun-cs, l'identifiant de l'instance Prometheus est l'identifiant du cluster Container Service.

  • Pour les instances ecs, l'identifiant de l'instance Prometheus est l'identifiant du VPC.

qduukd****

RequestId

string

L'identifiant de la requête.

70675725-8F11-4817-8106-CFE0AD71****

Message

string

Le message renvoyé.

message

Code

integer

Le code d'état HTTP. Valeurs valides :

  • 2XX : Succès.

  • 3XX : Redirection.

  • 4XX : Erreur de requête.

  • 5XX : Erreur de serveur.

200

Exemples

JSON format

{
  "Data": "qduukd****",
  "RequestId": "70675725-8F11-4817-8106-CFE0AD71****",
  "Message": "message",
  "Code": 200
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.