API standards and multilingual preset SDKs
The OpenAPI of this product (Cms/2019-01-01) uses the RPC signature style. We have encapsulated SDKs for common programming languages for developers. Developers can download the SDK to directly call this product's OpenAPI without worrying about technical details. If the existing SDK does not meet your needs, you can use the signature mechanism for self-signing integration. Since the details of self-signing are very complex, it may take around 5 business days. Therefore, we recommend joining our DingTalk service group (147535001692) and conducting signature integration under expert guidance.
Before using the API, you need to prepare your identity account and access key (AccessKey) to effectively access the API through client tools (such as SDK and CLI). For details, see Obtain an AccessKey.
Custom signature scenarios
If your business scenario has special requirements and you need to integrate the API through self-signing, we recommend consulting our technical support team first (DingTalk service group: 147535001692) to obtain professional guidance and ensure efficient integration.
Account and security preparation
Alibaba Cloud accounts have full administrative permissions over all resources. Once an AccessKey is compromised, all associated resources will be at risk of unauthorized access. To ensure security, it is recommended to create a RAM user with only API access permissions and configure its AccessKey, while configuring RAM policies based on the principle of least privilege (PoLP). Use the Alibaba Cloud account only in specific scenarios where Alibaba Cloud account permissions are explicitly required.
Application group
|
API |
Title |
Description |
| Manage application groups | Manage application groups | |
| CreateMonitorGroup | CreateMonitorGroup | Creates an application group. |
| ModifyMonitorGroup | ModifyMonitorGroup | You can call the ModifyMonitorGroup operation to modify an application group. |
| DeleteMonitorGroup | DeleteMonitorGroup | Deletes an application group. |
| DescribeMonitorGroups | DescribeMonitorGroups | You can call the DescribeMonitorGroups operation to query a list of application groups. |
| CreateMonitorGroupInstances | CreateMonitorGroupInstances | Adds resources to an application group. |
| ModifyMonitorGroupInstances | ModifyMonitorGroupInstances | The ModifyMonitorGroupInstances operation modifies the resources in an application group. |
| DescribeMonitorGroupInstances | DescribeMonitorGroupInstances | Queries the resources in an application group. |
| DescribeMonitorGroupDynamicRules | DescribeMonitorGroupDynamicRules | Queries the dynamic rules of an application group. |
| DescribeMonitorGroupInstanceAttribute | DescribeMonitorGroupInstanceAttribute | Queries the resources in an application group. |
| DeleteMonitorGroupDynamicRule | DeleteMonitorGroupDynamicRule | Deletes a rule that is used to dynamically add the instances of a service to an application group. |
| DeleteMonitorGroupInstances | DeleteMonitorGroupInstances | Removes instances from an application group. |
| DescribeMonitorGroupCategories | DescribeMonitorGroupCategories | Queries the cloud services to which the resources in an application group belong and the number of resources that belong to each cloud service in the application group. |
| PutMonitorGroupDynamicRule | PutMonitorGroupDynamicRule | Creates or modifies an alert rule to dynamically add instances that meet the rule to an application group. |
| CreateGroupMonitoringAgentProcess | CreateGroupMonitoringAgentProcess | Creates a process monitoring task for an application group. |
| ModifyGroupMonitoringAgentProcess | Modify process monitoring in an application group | Modifies process monitoring in an application group. |
| DeleteGroupMonitoringAgentProcess | Delete a group process monitoring task | Deletes a group process monitoring task by calling the DeleteGroupMonitoringAgentProcess operation. |
| DescribeGroupMonitoringAgentProcess | DescribeGroupMonitoringAgentProcess | Queries the process monitoring tasks for an application group. |
| CreateMonitorGroupNotifyPolicy | Create a pause alert notification policy for an application group | Calls the CreateMonitorGroupNotifyPolicy operation to create a pause alert notification policy for an application group. |
| DeleteMonitorGroupNotifyPolicy | DeleteMonitorGroupNotifyPolicy | Deletes a policy that is used to pause alert notifications for an application group. |
| DescribeMonitorGroupNotifyPolicyList | Query alert notification pause policies for an application group | Queries the list of alert notification pause policies for an application group. |
| Tags | Tags | |
| CreateDynamicTagGroup | CreateDynamicTagGroup | You can call the CreateDynamicTagGroup operation to automatically create application groups using tags. |
| DeleteDynamicTagGroup | DeleteDynamicTagGroup | Deletes a tag rule. |
| DescribeTagValueList | DescribeTagValueList | Queries the tag values for a specified tag key. |
| DescribeTagKeyList | Query tag key list | Calls the DescribeTagKeyList operation to query a list of tag keys. |
| DescribeProductResourceTagKeyList | DescribeProductResourceTagKeyList | Call the DescribeProductResourceTagKeyList operation to query all tag keys of cloud resources in a specified region. |
| DescribeDynamicTagRuleList | DescribeDynamicTagRuleList | Call the DescribeDynamicTagRuleList operation to query the rules for dynamic tags. |
| Availability monitoring | Availability monitoring | |
| CreateHostAvailability | Create an availability monitoring task | Creates an availability monitoring task. |
| DeleteHostAvailability | DeleteHostAvailability | Deletes one or more availability monitoring jobs. |
| EnableHostAvailability | Enable a specified availability monitoring task | Enables a specified availability monitoring task. |
| DisableHostAvailability | DisableHostAvailability | Disables one or more specified availability monitoring jobs. |
| ModifyHostAvailability | Modify an availability monitoring task | Modifies an availability monitoring task. |
| DescribeUnhealthyHostAvailability | DescribeUnhealthyHostAvailability | Call the DescribeUnhealthyHostAvailability operation to query a list of unhealthy servers. |
| DescribeHostAvailabilityList | Query availability monitoring tasks | Queries the list of availability monitoring tasks. |
Host monitoring
|
API |
Title |
Description |
| InstallMonitoringAgent | InstallMonitoringAgent | Call the InstallMonitoringAgent operation to install the CloudMonitor agent on specified Alibaba Cloud hosts. |
| DescribeMonitoringAgentHosts | DescribeMonitoringAgentHosts | You can call the DescribeMonitoringAgentHosts operation to query a list of all hosts, regardless of whether the CloudMonitor agent is installed. |
| DescribeMonitoringAgentAccessKey | DescribeMonitoringAgentAccessKey | Queries the AccessKey ID and AccessKey secret that are required to install the CloudMonitor agent on a third-party host. |
| DescribeMonitoringAgentConfig | DescribeMonitoringAgentConfig | Queries the configurations of the CloudMonitor agent. |
| DescribeMonitoringAgentStatuses | Query the running status of the CloudMonitor agent | Queries the running status of the CloudMonitor agent by calling the DescribeMonitoringAgentStatuses operation. |
| ModifyHostInfo | Modify the display information of a non-Alibaba Cloud host | Calls the ModifyHostInfo operation to modify the display information of a non-Alibaba Cloud host. |
| DescribeMonitoringConfig | DescribeMonitoringConfig | Queries the global configurations of the CloudMonitor agent. |
| PutMonitoringConfig | Configure global settings of the cloudMonitor agent | Configures the global settings of the CloudMonitor agent. |
| UninstallMonitoringAgent | UninstallMonitoringAgent | Uninstalls the CloudMonitor agent from a third-party host. |
| CreateMonitoringAgentProcess | CreateMonitoringAgentProcess | Creates a task to monitor a process. |
| CreateMonitorAgentProcess | CreateMonitorAgentProcess | Creates a task to monitor a process. |
| DescribeMonitoringAgentProcesses | DescribeMonitoringAgentProcesses | Call the DescribeMonitoringAgentProcesses operation to query the list of processes for a specified resource. |
| DeleteMonitoringAgentProcess | Delete process monitoring from a specified host | Calls the DeleteMonitoringAgentProcess operation to delete the specified process monitoring from a specified host. |
Event center
|
API |
Title |
Description |
| System events | System events | |
| DescribeSystemEventHistogram | DescribeSystemEventHistogram | Queries the number of times a system event occurred during each interval within a period of time. |
| DescribeSystemEventMetaList | Query meta information of system events | Queries the meta information of system events by calling the DescribeSystemEventMetaList operation. |
| DescribeSystemEventAttribute | DescribeSystemEventAttribute | Queries a system event. |
| DescribeSystemEventCount | Query the number of events for each Alibaba Cloud service under the current account | Queries the number of events that occurred for each Alibaba Cloud service under the current account. |
| DescribeMonitorResourceQuotaAttribute | Query cloudMonitor resource quotas | Queries the quotas of various CloudMonitor resources. |
| SendDryRunSystemEvent | SendDryRunSystemEvent | Debugs a system event of an Alibaba Cloud service. |
| Custom events | Custom events | |
| DescribeCustomEventCount | DescribeCustomEventCount | Queries the number of times that a custom event occurred within a period of time. |
| DescribeCustomEventHistogram | DescribeCustomEventHistogram | Queries the number of times that a custom event occurred during each interval within a period of time. |
| DescribeCustomEventAttribute | DescribeCustomEventAttribute | Queries a custom event. |
| PutCustomEvent | PutCustomEvent | Reports custom events. |
Custom monitoring
|
API |
Title |
Description |
| PutCustomMetric | Report custom monitoring data | Calls the PutCustomMetric operation to report custom monitoring data. |
| PutCustomMetricRule | Create a custom monitoring alert rule | Creates an alert rule for custom monitoring. |
| DescribeCustomMetricList | DescribeCustomMetricList | Queries the reported monitoring data. |
| DeleteCustomMetric | DeleteCustomMetric | Deletes the reported monitoring data of a metric. |
Log monitoring
|
API |
Title |
Description |
| PutLogMonitor | Create or modify a log monitoring metric | Creates or modifies a log monitoring metric by calling the PutLogMonitor operation. |
| DeleteLogMonitor | DeleteLogMonitor | Deletes a log monitoring metric. |
| DescribeLogMonitorList | DescribeLogMonitorList | Queries log monitoring metrics. |
| DescribeLogMonitorAttribute | DescribeLogMonitorAttribute | Queries a Log Monitoring task. |
Site monitoring
|
API |
Title |
Description |
| CreateMonitorGroupByResourceGroupId | CreateMonitorGroupByResourceGroupId | Creates an application group by using a resource group. |
| CreateInstantSiteMonitor | Create a one-time site monitoring task | Creates a one-time site monitoring task. |
| BatchCreateInstantSiteMonitor | BatchCreateInstantSiteMonitor | You can call the BatchCreateInstantSiteMonitor operation to create a batch of site monitoring tasks. |
| DeleteSiteMonitors | Delete site monitoring tasks | Deletes site monitoring tasks by calling the DeleteSiteMonitors operation. |
| DisableSiteMonitors | Disable one or more site monitoring tasks | Disables one or more site monitoring tasks by calling the DisableSiteMonitors operation. |
| ModifySiteMonitor | Modify a site monitoring task | Modifies a site monitoring task by calling the ModifySiteMonitor operation. |
| EnableSiteMonitors | EnableSiteMonitors | Enables site monitoring tasks. |
| DescribeSiteMonitorQuota | Queries the quota and version of site monitoring | Calls the DescribeSiteMonitorQuota operation to query the quota and version of site monitoring. |
| DescribeSiteMonitorAttribute | Query details of a site monitoring task | Queries the details of a site monitoring task by calling the DescribeSiteMonitorAttribute operation. |
| DescribeSiteMonitorISPCityList | Query details of all carrier detection points | Queries the details of all carrier detection points by calling the DescribeSiteMonitorISPCityList operation. |
| DescribeSiteMonitorData | DescribeSiteMonitorData | Queries the fine-grained monitoring data of a site monitoring task. |
| DescribeSiteMonitorStatistics | Queries the average statistics of a specified metric in a specified site monitoring task. | Queries the average statistics of a specified metric in a specified site monitoring task by calling the DescribeSiteMonitorStatistics operation. |
| DescribeSiteMonitorList | Query site monitoring tasks | Queries the list of site monitoring tasks by calling the DescribeSiteMonitorList operation. |
| DescribeSiteMonitorLog | DescribeSiteMonitorLog | Call the DescribeSiteMonitorLog operation to query the detection logs for a one-time detection task. |
Cloud service monitoring
|
API |
Title |
Description |
| DescribeMetricData | DescribeMetricData | Queries the monitoring data of a metric for a cloud service. |
| DescribeProjectMeta | Queries the list of cloud services that support time series monitoring metrics in CloudMonitor | Calls the DescribeProjectMeta operation to query the list of cloud services that support time series monitoring metrics in CloudMonitor. |
Alert service
|
API |
Title |
Description |
| Alert history | Alert history | |
| DescribeAlertLogCount | DescribeAlertLogCount | Queries the statistics of alert logs. |
| DescribeAlertLogList | Queries the alert history | Queries the alert history by calling the DescribeAlertLogList operation. |
| DescribeAlertLogHistogram | DescribeAlertLogHistogram | Queries the number of alert logs that are generated during each interval within a period of time. |
| One-click alert | One-click alert | |
| DescribeProductsOfActiveMetricRule | DescribeProductsOfActiveMetricRule | Queries the cloud services for which the initiative alert feature is enabled. |
| DescribeActiveMetricRuleList | DescribeActiveMetricRuleList | Queries initiative alert rules. |
| EnableActiveMetricRule | EnableActiveMetricRule | Enables the initiative alert feature for a cloud service. |
| DisableActiveMetricRule | DisableActiveMetricRule | Disables the initiative alert feature for a cloud service. |
| Alert templates | Alert templates | |
| CreateMetricRuleTemplate | CreateMetricRuleTemplate | Creates an alert template. |
| DeleteMetricRuleTemplate | Delete an alert rule template | Deletes an alert rule template. |
| ModifyMetricRuleTemplate | ModifyMetricRuleTemplate | Modifies an alert template. |
| DescribeMetricRuleTemplateAttribute | Query alert template details | Queries the details of an alert template by calling the DescribeMetricRuleTemplateAttribute operation. |
| DescribeMetricRuleTemplateList | DescribeMetricRuleTemplateList | Queries alert templates. |
| ApplyMetricRuleTemplate | Apply an alert template to an application group | Applies an alert template to an application group to generate alert rules. |
| Threshold alert rules | Threshold alert rules | |
| DescribeMetricRuleList | Query all rules in the alert rule list | Query all rules in the alert rule list. |
| CreateGroupMetricRules | Create alert rules in batches for a specified application group | Creates alert rules in batches for a specified application group by calling the CreateGroupMetricRules operation. |
| CreateMetricRuleResources | Create a resource associated with an alert rule | Calls the CreateMetricRuleResources operation to create a resource associated with an alert rule. |
| DeleteMetricRuleTargets | DeleteMetricRuleTargets | Delete the push channels of an alert rule. |
| DeleteMetricRules | DeleteMetricRules | The DeleteMetricRules operation deletes one or more alert rules. |
| DeleteMetricRuleResources | DeleteMetricRuleResources | Disassociates resources from an alert rule. |
| EnableMetricRules | EnableMetricRules | Enables alert rules. |
| DisableMetricRules | DisableMetricRules | You can call the DisableMetricRules operation to disable alert rules. |
| DescribeMetricRuleTargets | Query notification channels of a specified alert rule | Queries the notification channels of a specified alert rule by calling the DescribeMetricRuleTargets operation. |
| DescribeMetricRuleCount | DescribeMetricRuleCount | Queries the number of alert rules in each state. |
| DescribeAlertingMetricRuleResources | Query resources with active alerts for a specified alert rule | Queries the list of resources that are triggering alerts for a specified alert rule. |
| PutMetricRuleTargets | Add or modify push channels for a specified alert rule | Adds or modifies push channels for a specified alert rule by calling the PutMetricRuleTargets operation. |
| PutResourceMetricRule | Set a threshold alert rule for a specified metric of a specified resource | Sets an alert rule. |
| PutResourceMetricRules | Create multiple threshold alert rules for a specified metric of a specified resource | Calls the PutResourceMetricRules operation to create multiple threshold alert rules for a specified metric of a specified resource. |
| PutGroupMetricRule | Create or modify an alert rule in a specified application group | Creates or modifies an alert rule in a specified application group. |
| Event-triggered alert rules | Event-triggered alert rules | |
| DeleteEventRuleTargets | DeleteEventRuleTargets | Deletes the push channels of an event-triggered alert rule. |
| DeleteEventRules | DeleteEventRules | Deletes one or more event-triggered alert rules. |
| EnableEventRules | EnableEventRules | The EnableEventRules operation enables one or more event rules. |
| DisableEventRules | DisableEventRules | Disables one or more event-triggered alert rules. |
| DescribeEventRuleAttribute | Query the details of a specified event-triggered alert rule | Queries the details of a specified event-triggered alert rule by calling the DescribeEventRuleAttribute operation. |
| DescribeEventRuleList | DescribeEventRuleList | Queries event-triggered alert rules. |
| DescribeEventRuleTargetList | Query the notification channels of a specified event-triggered alert rule | Queries the list of event-triggered alert rules. |
| PutEventRuleTargets | Add or modify notification channels of an alert rule | Adds or modifies the notification channels of an event-triggered alert rule by calling the PutEventRuleTargets operation. |
| PutEventRule | Create or modify an event-based alert rule | Creates or modifies an event-based alert rule by calling the PutEventRule operation. |
| PutCustomEventRule | Create an alert rule for a custom event | Calls the PutCustomEventRule operation to create an alert rule for a custom event. |
| Alert blacklist | Alert blacklist | |
| CreateMetricRuleBlackList | CreateMetricRuleBlackList | Creates a blacklist policy. |
| ModifyMetricRuleBlackList | ModifyMetricRuleBlackList | Modifies a blacklist policy. |
| DeleteMetricRuleBlackList | Delete alert blacklist policies | Calls the DeleteMetricRuleBlackList operation to delete alert blacklist policies. |
| DescribeMetricRuleBlackList | Query alert blacklist policies | Queries a list of alert blacklist policies. |
| EnableMetricRuleBlackList | EnableMetricRuleBlackList | Enables or disables multiple blacklist policies at a time. |
| Alert contacts | Alert contacts | |
| DescribeContactListByContactGroup | DescribeContactListByContactGroup | Queries the alert contacts in an alert contact group. |
| DescribeContactGroupList | Query Alarm Contact Group List | Call the DescribeContactGroupList interface to query the list of alarm contact groups. |
| DescribeContactList | Query alert contacts | Calls the DescribeContactList operation to query a list of alert contacts. |
| PutContact | Create or modify alert contact information | Calls the PutContact operation to create or modify alert contact information. |
| PutContactGroup | Create or modify an alert contact group | Creates or modifies an alert contact group by calling the PutContactGroup operation. |
Hybrid Cloud monitoring
|
API |
Title |
Description |
| CreateHybridMonitorNamespace | Create a metric repository | Calls the CreateHybridMonitorNamespace operation to create a metric repository. |
| ModifyHybridMonitorNamespace | Modify a metric store | Calls the ModifyHybridMonitorNamespace operation to modify a metric store. |
| DeleteHybridMonitorNamespace | DeleteHybridMonitorNamespace | Deletes a namespace. |
| DescribeHybridMonitorNamespaceList | DescribeHybridMonitorNamespaceList | Queries a list of namespaces and the details of their data sources. |
| CreateHybridMonitorTask | Create a monitoring task | Creates a monitoring task for ingesting metrics from an Alibaba Cloud service or Simple Log Service (SLS) logs. |
| ModifyHybridMonitorTask | Modify a monitoring task | Modifies the metrics of a Simple Log Service (SLS) log monitoring task by calling the ModifyHybridMonitorTask operation. |
| DeleteHybridMonitorTask | DeleteHybridMonitorTask | Deletes a metric import task for Alibaba Cloud services or a metric for the logs that are imported from Log Service. |
| DescribeHybridMonitorTaskList | DescribeHybridMonitorTaskList | Queries metric import tasks. |
| PutHybridMonitorMetricData | Reports monitoring data to a metric namespace | Reports the specified monitoring data to a specified metric namespace of Enterprise CloudMonitor by calling the PutHybridMonitorMetricData operation. |
| DescribeHybridMonitorDataList | DescribeHybridMonitorDataList | Queries the monitoring data in a namespace. |
| CreateHybridMonitorSLSGroup | Create a logstore group for SLS log metrics | Creates a Logstore group for Hybrid Cloud Monitoring. |
| ModifyHybridMonitorSLSGroup | Modify a logstore group | Modifies a Logstore group by calling the ModifyHybridMonitorSLSGroup operation. |
| DeleteHybridMonitorSLSGroup | DeleteHybridMonitorSLSGroup | Deletes a Logstore group. |
| DescribeHybridMonitorSLSGroup | Query logstore group list | Queries the list of Logstore groups by calling the DescribeHybridMonitorSLSGroup operation. |
| Cursor | Defines the scope of monitoring data to be exported | Calls the Cursor operation to define the scope of monitoring data to be exported, and returns the Cursor value used for the initial call to the BatchExport operation. |
| BatchExport | Exports the monitoring data defined in Cursor | Calls the BatchExport operation to export monitoring data defined in the Cursor operation. |
Others
|
API |
Title |
Description |
| DescribeSyntheticProbeList | DescribeSyntheticProbeList | Queries a list of detection points. |
| AddTags | AddTags | The AddTags operation attaches tags to specified application groups. |
| CreateSiteMonitor | CreateSiteMonitor | Creates a site monitoring task. |
| DeleteContact | Delete an alert contact | Deletes an alert contact. |
| DeleteContactGroup | Delete an alert contact group | Calls the DeleteContactGroup operation to delete an alert contact group. |
| DescribeMetricLast | Query the latest monitoring data of a specified metric | Queries the latest monitoring data of a specified metric. |
| DescribeMetricList | DescribeMetricList | The DescribeMetricList operation queries the monitoring data of a specific metric for a cloud service. |
| DescribeMetricMetaList | DescribeMetricMetaList | Queries metrics that are supported in CloudMonitor. |
| DescribeMetricTop | DescribeMetricTop | Queries the latest monitoring data of a metric for a cloud service. The data can be sorted by a specified order. |
| RemoveTags | RemoveTags | The RemoveTags operation removes one or more tags. |