# Amazon CloudWatch API

> Amazon CloudWatch API on Apizie: 38 endpoints (Deletes the specified alarms. You can delete up to 100 alarms in one operation. However, this total can…, Deletes the specified anomaly detection model from your account. For more information about how to delete an…, Deletes all dashboards that you specify. You can specify up to 100 dashboards to delete. If there is an…, Permanently deletes the specified Contributor Insights rules. If you create a rule, delete it, and then…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-monitoring`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://zieapi.vercel.app/api/cloud/amazonaws-monitoring
- OpenAPI: https://zieapi.vercel.app/api/cloud/amazonaws-monitoring/openapi.json

Amazon CloudWatch monitors your Amazon Web Services (Amazon Web Services) resources and the applications you run on Amazon Web Services in real time. You can use CloudWatch to collect and track metrics, which are the…

## Endpoints

### Deletes the specified alarms. You can delete up to 100 alarms in one operation. However, this total can…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-delete-alarms` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| AlarmNames | array | yes | The alarms to be deleted. Do not enclose the alarm names in quote marks. |

### Deletes the specified anomaly detection model from your account. For more information about how to delete an…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-delete-anomaly-detector` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| Namespace | string | no | The namespace associated with the anomaly detection model to delete. |
| MetricName | string | no | The metric name associated with the anomaly detection model to delete. |
| Dimensions | array | no | The metric dimensions associated with the anomaly detection model to delete. |
| Stat | string | no | The statistic associated with the anomaly detection model to delete. |
| SingleMetricAnomalyDetector | object | no | A single metric anomaly detector to be deleted. When using SingleMetricAnomalyDetector , you cannot include the following parameters in… |
| MetricMathAnomalyDetector | object | no | The metric math anomaly detector to be deleted. When using MetricMathAnomalyDetector , you cannot include following parameters in the same… |

### Deletes all dashboards that you specify. You can specify up to 100 dashboards to delete. If there is an…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-delete-dashboards` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| DashboardNames | array | yes | The dashboards to be deleted. This parameter is required. |

### Permanently deletes the specified Contributor Insights rules. If you create a rule, delete it, and then…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-delete-insight-rules` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| RuleNames | array | yes | An array of the rule names to delete. If you need to find out the names of your rules, use DescribeInsightRules . |

### Permanently deletes the metric stream that you specify.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-delete-metric-stream` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| Name | string | yes | The name of the metric stream to delete. |

### Retrieves the history for the specified alarm. You can filter the results by date range or item type. If an…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-describe-alarm-history` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| AlarmName | string | no | The name of the alarm. |
| AlarmTypes | array | no | Use this parameter to specify whether you want the operation to return metric alarms or composite alarms. If you omit this parameter, only… |
| HistoryItemType | string | no | The type of alarm histories to retrieve. |
| StartDate | string | no | The starting date to retrieve alarm history. |
| EndDate | string | no | The ending date to retrieve alarm history. |
| MaxRecords | integer | no | The maximum number of alarm history records to retrieve. |
| NextToken | string | no | The token returned by a previous call to indicate that there is more data available. |
| ScanBy | string | no | Specified whether to return the newest or oldest alarm history first. Specify TimestampDescending to have the newest event history… |

### Retrieves the specified alarms. You can filter the results by specifying a prefix for the alarm name, the…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-describe-alarms` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| AlarmNames | array | no | The names of the alarms to retrieve information about. |
| AlarmNamePrefix | string | no | An alarm name prefix. If you specify this parameter, you receive information about all alarms that have names that start with this prefix.… |
| AlarmTypes | array | no | Use this parameter to specify whether you want the operation to return metric alarms or composite alarms. If you omit this parameter, only… |
| ChildrenOfAlarmName | string | no | If you use this parameter and specify the name of a composite alarm, the operation returns information about the "children" alarms of the… |
| ParentsOfAlarmName | string | no | If you use this parameter and specify the name of a metric or composite alarm, the operation returns information about the "parent" alarms… |
| StateValue | string | no | Specify this parameter to receive information only about alarms that are currently in the state that you specify. |
| ActionPrefix | string | no | Use this parameter to filter the results of the operation to only those alarms that use a certain alarm action. For example, you could… |
| MaxRecords | integer | no | The maximum number of alarm descriptions to retrieve. |
| NextToken | string | no | The token returned by a previous call to indicate that there is more data available. |

### Retrieves the alarms for the specified metric. To filter the results, specify a statistic, period, or unit.…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-describe-alarms-for-metric` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| MetricName | string | yes | The name of the metric. |
| Namespace | string | yes | The namespace of the metric. |
| Statistic | string | no | The statistic for the metric, other than percentiles. For percentile statistics, use ExtendedStatistics . |
| ExtendedStatistic | string | no | The percentile statistic for the metric. Specify a value between p0.0 and p100. |
| Dimensions | array | no | The dimensions associated with the metric. If the metric has any associated dimensions, you must specify them in order for the call to… |
| Period | integer | no | The period, in seconds, over which the statistic is applied. |
| Unit | string | no | The unit for the metric. |

### Lists the anomaly detection models that you have created in your account. For single metric anomaly…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-describe-anomaly-detectors` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | Use the token returned by the previous operation to request the next page of results. |
| MaxResults | integer | no | The maximum number of results to return in one operation. The maximum value that you can specify is 100. To retrieve the remaining… |
| Namespace | string | no | Limits the results to only the anomaly detection models that are associated with the specified namespace. |
| MetricName | string | no | Limits the results to only the anomaly detection models that are associated with the specified metric name. If there are multiple metrics… |
| Dimensions | array | no | Limits the results to only the anomaly detection models that are associated with the specified metric dimensions. If there are multiple… |
| AnomalyDetectorTypes | array | no | The anomaly detector types to request when using DescribeAnomalyDetectorsInput . If empty, defaults to SINGLE_METRIC . |

### Returns a list of all the Contributor Insights rules in your account. For more information about Contributor…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-describe-insight-rules` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | Include this value, if it was returned by the previous operation, to get the next set of rules. |
| MaxResults | integer | no | The maximum number of results to return in one operation. If you omit this parameter, the default of 500 is used. |

### Disables the actions for the specified alarms. When an alarm's actions are disabled, the alarm actions do…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-disable-alarm-actions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| AlarmNames | array | yes | The names of the alarms. |

### Disables the specified Contributor Insights rules. When rules are disabled, they do not analyze log groups…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-disable-insight-rules` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| RuleNames | array | yes | An array of the rule names to disable. If you need to find out the names of your rules, use DescribeInsightRules . |

### Enables the actions for the specified alarms.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-enable-alarm-actions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| AlarmNames | array | yes | The names of the alarms. |

### Enables the specified Contributor Insights rules. When rules are enabled, they immediately begin analyzing…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-enable-insight-rules` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| RuleNames | array | yes | An array of the rule names to enable. If you need to find out the names of your rules, use DescribeInsightRules . |

### Displays the details of the dashboard that you specify. To copy an existing dashboard, use GetDashboard ,…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-get-dashboard` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| DashboardName | string | yes | The name of the dashboard to be described. |

### This operation returns the time series data collected by a Contributor Insights rule. The data includes the…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-get-insight-rule-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| RuleName | string | yes | The name of the rule that you want to see data from. |
| StartTime | string | yes | The start time of the data to use in the report. When used in a raw HTTP Query API, it is formatted as yyyy-MM-dd'T'HH:mm:ss . For… |
| EndTime | string | yes | The end time of the data to use in the report. When used in a raw HTTP Query API, it is formatted as yyyy-MM-dd'T'HH:mm:ss . For example,… |
| Period | integer | yes | The period, in seconds, to use for the statistics in the InsightRuleMetricDatapoint results. |
| MaxContributorCount | integer | no | The maximum number of contributors to include in the report. The range is 1 to 100. If you omit this, the default of 10 is used. |
| Metrics | array | no | Specifies which metrics to use for aggregation of contributor values for the report. You can specify one or more of the following metrics:… |
| OrderBy | string | no | Determines what statistic to use to rank the contributors. Valid values are SUM and MAXIMUM. |

### You can use the GetMetricData API to retrieve CloudWatch metric values. The operation can also include a…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-get-metric-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| MetricDataQueries | array | yes | The metric queries to be returned. A single GetMetricData call can include as many as 500 MetricDataQuery structures. Each of these… |
| StartTime | string | yes | The time stamp indicating the earliest data to be returned. The value specified is inclusive; results include data points with the… |
| EndTime | string | yes | The time stamp indicating the latest data to be returned. The value specified is exclusive; results include data points up to the… |
| NextToken | string | no | Include this value, if it was returned by the previous GetMetricData operation, to get the next set of data points. |
| ScanBy | string | no | The order in which data points should be returned. TimestampDescending returns the newest data first and paginates when the MaxDatapoints… |
| MaxDatapoints | integer | no | The maximum number of data points the request should return before paginating. If you omit this, the default of 100,800 is used. |
| LabelOptions | object | no | This structure includes the Timezone parameter, which you can use to specify your time zone so that the labels of returned data display… |

### Gets statistics for the specified metric. The maximum number of data points returned from a single call is…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-get-metric-statistics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| Namespace | string | yes | The namespace of the metric, with or without spaces. |
| MetricName | string | yes | The name of the metric, with or without spaces. |
| Dimensions | array | no | The dimensions. If the metric contains multiple dimensions, you must include a value for each dimension. CloudWatch treats each unique… |
| StartTime | string | yes | The time stamp that determines the first data point to return. Start times are evaluated relative to the time that CloudWatch receives the… |
| EndTime | string | yes | The time stamp that determines the last data point to return. The value specified is exclusive; results include data points up to the… |
| Period | integer | yes | The granularity, in seconds, of the returned data points. For metrics with regular resolution, a period can be as short as one minute (60… |
| Statistics | array | no | The metric statistics, other than percentile. For percentile statistics, use ExtendedStatistics . When calling GetMetricStatistics , you… |
| ExtendedStatistics | array | no | The percentile statistics. Specify values between p0.0 and p100. When calling GetMetricStatistics , you must specify either Statistics or… |
| Unit | string | no | The unit for a given metric. If you omit Unit , all data that was collected with any unit is returned, along with the corresponding units… |

### Returns information about the metric stream that you specify.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-get-metric-stream` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| Name | string | yes | The name of the metric stream to retrieve information about. |

### You can use the GetMetricWidgetImage API to retrieve a snapshot graph of one or more Amazon CloudWatch…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-get-metric-widget-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| MetricWidget | string | yes | A JSON string that defines the bitmap graph to be retrieved. The string includes the metrics to include in the graph, statistics,… |
| OutputFormat | string | no | The format of the resulting image. Only PNG images are supported. The default is png . If you specify png , the API returns an HTTP… |

### Returns a list of the dashboards for your account. If you include DashboardNamePrefix , only those…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-list-dashboards` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| DashboardNamePrefix | string | no | If you specify this parameter, only the dashboards with names starting with the specified string are listed. The maximum length is 255,… |
| NextToken | string | no | The token returned by a previous call to indicate that there is more data available. |

### Returns a list that contains the number of managed Contributor Insights rules in your account.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-list-managed-insight-rules` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ResourceARN | string | yes | The ARN of an Amazon Web Services resource that has managed Contributor Insights rules. |
| NextToken | string | no | Include this value to get the next set of rules if the value was returned by the previous operation. |
| MaxResults | integer | no | The maximum number of results to return in one operation. If you omit this parameter, the default number is used. The default number is… |

### Returns a list of metric streams in this account.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-list-metric-streams` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | Include this value, if it was returned by the previous call, to get the next set of metric streams. |
| MaxResults | integer | no | The maximum number of results to return in one operation. |

### List the specified metrics. You can use the returned metrics with GetMetricData or GetMetricStatistics to…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-list-metrics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| Namespace | string | no | The metric namespace to filter against. Only the namespace that matches exactly will be returned. |
| MetricName | string | no | The name of the metric to filter against. Only the metrics with names that match exactly will be returned. |
| Dimensions | array | no | The dimensions to filter against. Only the dimensions that match exactly will be returned. |
| NextToken | string | no | The token returned by a previous call to indicate that there is more data available. |
| RecentlyActive | string | no | To filter the results to show only metrics that have had data points published in the past three hours, specify this parameter with a… |
| IncludeLinkedAccounts | boolean | no | If you are using this operation in a monitoring account, specify true to include metrics from source accounts in the returned data. The… |
| OwningAccount | string | no | When you use this operation in a monitoring account, use this field to return metrics only from one source account. To do so, specify that… |

### Displays the tags associated with a CloudWatch resource. Currently, alarms and Contributor Insights rules…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-list-tags-for-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ResourceARN | string | yes | The ARN of the CloudWatch resource that you want to view tags for. The ARN format of an alarm is arn:aws:cloudwatch: Region : account-id… |

### Creates an anomaly detection model for a CloudWatch metric. You can use the model to display a band of…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-put-anomaly-detector` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| Namespace | string | no | The namespace of the metric to create the anomaly detection model for. |
| MetricName | string | no | The name of the metric to create the anomaly detection model for. |
| Dimensions | array | no | The metric dimensions to create the anomaly detection model for. |
| Stat | string | no | The statistic to use for the metric and the anomaly detection model. |
| Configuration | object | no | The configuration specifies details about how the anomaly detection model is to be trained, including time ranges to exclude when training… |
| SingleMetricAnomalyDetector | object | no | A single metric anomaly detector to be created. When using SingleMetricAnomalyDetector , you cannot include the following parameters in… |
| MetricMathAnomalyDetector | object | no | The metric math anomaly detector to be created. When using MetricMathAnomalyDetector , you cannot include the following parameters in the… |

### Creates or updates a composite alarm . When you create a composite alarm, you specify a rule expression for…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-put-composite-alarm` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ActionsEnabled | boolean | no | Indicates whether actions should be executed during any changes to the alarm state of the composite alarm. The default is TRUE . |
| AlarmActions | array | no | The actions to execute when this alarm transitions to the ALARM state from any other state. Each action is specified as an Amazon Resource… |
| AlarmDescription | string | no | The description for the composite alarm. |
| AlarmName | string | yes | The name for the composite alarm. This name must be unique within the Region. |
| AlarmRule | string | yes | An expression that specifies which other alarms are to be evaluated to determine this composite alarm's state. For each alarm that you… |
| InsufficientDataActions | array | no | The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state from any other state. Each action is specified as an… |
| OKActions | array | no | The actions to execute when this alarm transitions to an OK state from any other state. Each action is specified as an Amazon Resource… |
| Tags | array | no | A list of key-value pairs to associate with the composite alarm. You can associate as many as 50 tags with an alarm. Tags can help you… |
| ActionsSuppressor | string | no | Actions will be suppressed if the suppressor alarm is in the ALARM state. ActionsSuppressor can be an AlarmName or an Amazon Resource Name… |
| ActionsSuppressorWaitPeriod | integer | no | The maximum time in seconds that the composite alarm waits for the suppressor alarm to go into the ALARM state. After this time, the… |
| ActionsSuppressorExtensionPeriod | integer | no | The maximum time in seconds that the composite alarm waits after suppressor alarm goes out of the ALARM state. After this time, the… |

### Creates a dashboard if it does not already exist, or updates an existing dashboard. If you update a…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-put-dashboard` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| DashboardName | string | yes | The name of the dashboard. If a dashboard with this name already exists, this call modifies that dashboard, replacing its current… |
| DashboardBody | string | yes | The detailed information about the dashboard in JSON format, including the widgets to include and their location on the dashboard. This… |

### Creates a Contributor Insights rule. Rules evaluate log events in a CloudWatch Logs log group, enabling you…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-put-insight-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| RuleName | string | yes | A unique name for the rule. |
| RuleState | string | no | The state of the rule. Valid values are ENABLED and DISABLED. |
| RuleDefinition | string | yes | The definition of the rule, as a JSON object. For details on the valid syntax, see Contributor Insights Rule Syntax . |
| Tags | array | no | A list of key-value pairs to associate with the Contributor Insights rule. You can associate as many as 50 tags with a rule. Tags can help… |

### Creates a managed Contributor Insights rule for a specified Amazon Web Services resource. When you enable a…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-put-managed-insight-rules` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ManagedRules | array | yes | A list of ManagedRules to enable. |

### Creates or updates an alarm and associates it with the specified metric, metric math expression, anomaly…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-put-metric-alarm` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| AlarmName | string | yes | The name for the alarm. This name must be unique within the Region. The name must contain only UTF-8 characters, and can't contain ASCII… |
| AlarmDescription | string | no | The description for the alarm. |
| ActionsEnabled | boolean | no | Indicates whether actions should be executed during any changes to the alarm state. The default is TRUE . |
| OKActions | array | no | The actions to execute when this alarm transitions to an OK state from any other state. Each action is specified as an Amazon Resource… |
| AlarmActions | array | no | The actions to execute when this alarm transitions to the ALARM state from any other state. Each action is specified as an Amazon Resource… |
| InsufficientDataActions | array | no | The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state from any other state. Each action is specified as an… |
| MetricName | string | no | The name for the metric associated with the alarm. For each PutMetricAlarm operation, you must specify either MetricName or a Metrics… |
| Namespace | string | no | The namespace for the metric associated specified in MetricName . |
| Statistic | string | no | The statistic for the metric specified in MetricName , other than percentile. For percentile statistics, use ExtendedStatistic . When you… |
| ExtendedStatistic | string | no | The percentile statistic for the metric specified in MetricName . Specify a value between p0.0 and p100. When you call PutMetricAlarm and… |
| Dimensions | array | no | The dimensions for the metric specified in MetricName . |
| Period | integer | no | The length, in seconds, used each time the metric specified in MetricName is evaluated. Valid values are 10, 30, and any multiple of 60.… |
| Unit | string | no | The unit of measure for the statistic. For example, the units for the Amazon EC2 NetworkIn metric are Bytes because NetworkIn tracks the… |
| EvaluationPeriods | integer | yes | The number of periods over which data is compared to the specified threshold. If you are setting an alarm that requires that a number of… |
| DatapointsToAlarm | integer | no | The number of data points that must be breaching to trigger the alarm. This is used only if you are setting an "M out of N" alarm. In that… |
| Threshold | number | no | The value against which the specified statistic is compared. This parameter is required for alarms based on static thresholds, but should… |
| ComparisonOperator | string | yes | The arithmetic operation to use when comparing the specified statistic and threshold. The specified statistic value is used as the first… |
| TreatMissingData | string | no | Sets how this alarm is to handle missing data points. If TreatMissingData is omitted, the default behavior of missing is used. For more… |
| EvaluateLowSampleCountPercentile | string | no | Used only for alarms based on percentiles. If you specify ignore , the alarm state does not change during periods with too few data points… |
| Metrics | array | no | An array of MetricDataQuery structures that enable you to create an alarm based on the result of a metric math expression. For each… |
| Tags | array | no | A list of key-value pairs to associate with the alarm. You can associate as many as 50 tags with an alarm. Tags can help you organize and… |
| ThresholdMetricId | string | no | If this is an alarm based on an anomaly detection model, make this value match the ID of the ANOMALY_DETECTION_BAND function. For an… |

### Publishes metric data points to Amazon CloudWatch. CloudWatch associates the data points with the specified…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-put-metric-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| Namespace | string | yes | The namespace for the metric data. You can use ASCII characters for the namespace, except for control characters which are not supported.… |
| MetricData | array | yes | The data for the metric. The array can include no more than 1000 metrics per call. |

### Creates or updates a metric stream. Metric streams can automatically stream CloudWatch metrics to Amazon Web…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-put-metric-stream` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| Name | string | yes | If you are creating a new metric stream, this is the name for the new stream. The name must be different than the names of other metric… |
| IncludeFilters | array | no | If you specify this parameter, the stream sends only the metrics from the metric namespaces that you specify here. You cannot include… |
| ExcludeFilters | array | no | If you specify this parameter, the stream sends metrics from all metric namespaces except for the namespaces that you specify here. You… |
| FirehoseArn | string | yes | The ARN of the Amazon Kinesis Data Firehose delivery stream to use for this metric stream. This Amazon Kinesis Data Firehose delivery… |
| RoleArn | string | yes | The ARN of an IAM role that this metric stream will use to access Amazon Kinesis Data Firehose resources. This IAM role must already exist… |
| OutputFormat | string | yes | The output format for the stream. Valid values are json and opentelemetry0.7 . For more information about metric stream output formats,… |
| Tags | array | no | A list of key-value pairs to associate with the metric stream. You can associate as many as 50 tags with a metric stream. Tags can help… |
| StatisticsConfigurations | array | no | By default, a metric stream always sends the MAX , MIN , SUM , and SAMPLECOUNT statistics for each metric that is streamed. You can use… |
| IncludeLinkedAccountsMetrics | boolean | no | If you are creating a metric stream in a monitoring account, specify true to include metrics from source accounts in the metric stream. |

### Temporarily sets the state of an alarm for testing purposes. When the updated state differs from the…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-set-alarm-state` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| AlarmName | string | yes | The name of the alarm. |
| StateValue | string | yes | The value of the state. |
| StateReason | string | yes | The reason that this alarm is set to this specific state, in text format. |
| StateReasonData | string | no | The reason that this alarm is set to this specific state, in JSON format. For SNS or EC2 alarm actions, this is just informational. But… |

### Starts the streaming of metrics for one or more of your metric streams.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-start-metric-streams` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| Names | array | yes | The array of the names of metric streams to start streaming. This is an "all or nothing" operation. If you do not have permission to… |

### Stops the streaming of metrics for one or more of your metric streams.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-stop-metric-streams` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| Names | array | yes | The array of the names of metric streams to stop streaming. This is an "all or nothing" operation. If you do not have permission to access… |

### Assigns one or more tags (key-value pairs) to the specified CloudWatch resource. Currently, the only…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ResourceARN | string | yes | The ARN of the CloudWatch resource that you're adding tags to. The ARN format of an alarm is arn:aws:cloudwatch: Region : account-id… |
| Tags | array | yes | The list of key-value pairs to associate with the alarm. |

### Removes one or more tags from the specified resource.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| ResourceARN | string | yes | The ARN of the CloudWatch resource that you're removing tags from. The ARN format of an alarm is arn:aws:cloudwatch: Region : account-id… |
| TagKeys | array | yes | The list of tag keys to remove from the resource. |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-delete-alarms" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Amazon CloudWatch API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/cloud:amazonaws-monitoring/get-delete-alarms with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Amazon CloudWatch API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Amazon CloudWatch itself also needs your own key from amazonaws.com.

### Can AI agents use the Amazon CloudWatch API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-monitoring.

### What is the status of the Amazon CloudWatch API?
Needs your own provider key (bring your own key)
