AWS CloudWatch Alarms API

Operations for creating, managing, and querying CloudWatch alarms

Operations 8

POST /#PutMetricAlarm Aws Cloudwatch Create or Update a Cloudwatch Alarm #
POST /#DescribeAlarms Aws Cloudwatch Retrieve Information About Specified Alarms #
POST /#DescribeAlarmsForMetric Aws Cloudwatch Retrieve Alarms for a Specified Metric #
POST /#DescribeAlarmHistory Aws Cloudwatch Retrieve the History for a Specified Alarm #
POST /#DeleteAlarms Aws Cloudwatch Delete Specified Alarms #
POST /#SetAlarmState Aws Cloudwatch Temporarily Set the State of an Alarm #
POST /#EnableAlarmActions Aws Cloudwatch Enable Actions for Specified Alarms #
POST /#DisableAlarmActions Aws Cloudwatch Disable Actions for Specified Alarms #

Documentation

📖
Documentation
https://docs.aws.amazon.com/cloudwatch/
📖
GettingStarted
https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/GettingStarted.html
📖
APIReference
https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/
📖
Documentation
https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/
📖
APIReference
https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/
📖
Documentation
https://docs.aws.amazon.com/eventbridge/
📖
APIReference
https://docs.aws.amazon.com/eventbridge/latest/APIReference/
📖
Documentation
https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-application-insights.html
📖
APIReference
https://docs.aws.amazon.com/cloudwatch/latest/APIReference/
📖
Documentation
https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html
📖
APIReference
https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/
📖
Documentation
https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-InternetMonitor.html
📖
APIReference
https://docs.aws.amazon.com/internet-monitor/latest/api/Welcome.html
📖
Documentation
https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM.html
📖
APIReference
https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/Welcome.html
📖
Documentation
https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
📖
APIReference
https://docs.aws.amazon.com/OAM/latest/APIReference/Welcome.html

Specifications

Schemas & Data

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/cloudwatch-alarms-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cloudwatch-alarms-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: AWS CloudWatch Amazon CloudWatch Alarms API
  description: Amazon CloudWatch monitors your Amazon Web Services (AWS) resources and the applications you run on AWS in real time. You can use CloudWatch to collect and track metrics, which are variables you can measure for your resources and applications. CloudWatch alarms watch metrics and automatically send notifications or make changes to the resources you are monitoring when a threshold is breached. CloudWatch dashboards provide a unified view of your AWS resources, custom applications, and services.
  version: '2010-08-01'
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/cloudwatch/
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  x-logo:
    url: https://a0.awsstatic.com/libra-css/images/logos/aws_logo_smile_1200x630.png
servers:
- url: https://monitoring.{region}.amazonaws.com
  description: CloudWatch regional endpoint
  variables:
    region:
      default: us-east-1
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-north-1
      - ap-east-1
      - ap-south-1
      - ap-southeast-1
      - ap-southeast-2
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - sa-east-1
      - ca-central-1
      - me-south-1
      - af-south-1
security:
- aws_sigv4: []
tags:
- name: Alarms
  description: Operations for creating, managing, and querying CloudWatch alarms
paths:
  /#PutMetricAlarm:
    post:
      operationId: PutMetricAlarm
      summary: Aws Cloudwatch Create or Update a Cloudwatch Alarm
      description: Creates or updates an alarm and associates it with the specified metric, metric math expression, anomaly detection model, or Metrics Insights query. When the alarm state changes, the alarm invokes the specified actions. An alarm can watch only one metric at a time, but it can take actions based on other alarms. If you are using a composite alarm, the alarm watches the states of other alarms.
      tags:
      - Alarms
      parameters:
      - $ref: '#/components/parameters/Action_PutMetricAlarm'
      - $ref: '#/components/parameters/Version'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/PutMetricAlarmInput'
            examples:
              PutmetricalarmRequestExample:
                summary: Default PutMetricAlarm request
                x-microcks-default: true
                value:
                  AlarmName: example_value
                  AlarmDescription: example_value
                  ActionsEnabled: true
                  OKActions:
                  - example_value
                  AlarmActions:
                  - example_value
                  InsufficientDataActions:
                  - example_value
                  MetricName: example_value
                  Namespace: example_value
                  Statistic: SampleCount
                  ExtendedStatistic: example_value
                  Dimensions:
                  - Name: Example Title
                    Value: example_value
                  Period: 10
                  Unit: Seconds
                  EvaluationPeriods: 10
                  DatapointsToAlarm: 10
                  Threshold: 42.5
                  ComparisonOperator: GreaterThanOrEqualToThreshold
                  TreatMissingData: example_value
                  EvaluateLowSampleCountPercentile: example_value
                  Metrics:
                  - Id: abc123
                    Expression: example_value
                    Label: Example Title
                    ReturnData: true
                    Period: 10
                    AccountId: '500123'
                  Tags:
                  - Key: example_value
                    Value: example_value
                  ThresholdMetricId: '500123'
      responses:
        '200':
          description: Successful response
        '400':
          description: Bad request - limit exceeded
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Putmetricalarm400Example:
                  summary: Default PutMetricAlarm 400 response
                  x-microcks-default: true
                  value:
                    Error:
                      Type: example_value
                      Code: example_value
                      Message: example_value
                    RequestId: '500123'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /#DescribeAlarms:
    post:
      operationId: DescribeAlarms
      summary: Aws Cloudwatch Retrieve Information About Specified Alarms
      description: Retrieves the specified alarms. You can filter the results by specifying a prefix for the alarm name, the alarm state, or a prefix for any action. To use this operation and return information about composite alarms, you must be signed on with the cloudwatch:DescribeAlarms permission.
      tags:
      - Alarms
      parameters:
      - $ref: '#/components/parameters/Action_DescribeAlarms'
      - $ref: '#/components/parameters/Version'
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/DescribeAlarmsInput'
            examples:
              DescribealarmsRequestExample:
                summary: Default DescribeAlarms request
                x-microcks-default: true
                value:
                  AlarmNames:
                  - example_value
                  AlarmNamePrefix: example_value
                  AlarmTypes:
                  - CompositeAlarm
                  ChildrenOfAlarmName: example_value
                  ParentsOfAlarmName: example_value
                  StateValue: OK
                  ActionPrefix: example_value
                  MaxRecords: 10
                  NextToken: example_value
      responses:
        '200':
          description: Successful response
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/DescribeAlarmsOutput'
              examples:
                Describealarms200Example:
                  summary: Default DescribeAlarms 200 response
                  x-microcks-default: true
                  value:
                    MetricAlarms:
                    - AlarmName: example_value
                      AlarmArn: example_value
                      AlarmDescription: example_value
                      AlarmConfigurationUpdatedTimestamp: '2026-01-15T10:30:00Z'
                      ActionsEnabled: true
                      OKActions: {}
                      AlarmActions: {}
                      InsufficientDataActions: {}
                      StateReason: example_value
                      StateReasonData: example_value
                      StateUpdatedTimestamp: '2026-01-15T10:30:00Z'
                      MetricName: example_value
                      Namespace: example_value
                      ExtendedStatistic: example_value
                      Dimensions: {}
                      Period: 10
                      EvaluationPeriods: 10
                      DatapointsToAlarm: 10
                      Threshold: 42.5
                      TreatMissingData: breaching
                      EvaluateLowSampleCountPercentile: example_value
                      Metrics: {}
                      ThresholdMetricId: '500123'
                      StateTransitionedTimestamp: '2026-01-15T10:30:00Z'
                    CompositeAlarms:
                    - ActionsEnabled: true
                      AlarmActions: {}
                      AlarmArn: example_value
                      AlarmConfigurationUpdatedTimestamp: '2026-01-15T10:30:00Z'
                      AlarmDescription: example_value
                      AlarmName: example_value
                      AlarmRule: example_value
                      InsufficientDataActions: {}
                      OKActions: {}
                      StateReason: example_value
                      StateReasonData: example_value
                      StateUpdatedTimestamp: '2026-01-15T10:30:00Z'
                      StateTransitionedTimestamp: '2026-01-15T10:30:00Z'
                      ActionsSuppressedBy: WaitPeriod
                      ActionsSuppressedReason: example_value
                      ActionsSuppressor: example_value
                      ActionsSuppressorWaitPeriod: 10
                      ActionsSuppressorExtensionPeriod: 10
                    NextToken: example_value
        '400':
          description: Invalid next token
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Describealarms400Example:
                  summary: Default DescribeAlarms 400 response
                  x-microcks-default: true
                  value:
                    Error:
                      Type: example_value
                      Code: example_value
                      Message: example_value
                    RequestId: '500123'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /#DescribeAlarmsForMetric:
    post:
      operationId: DescribeAlarmsForMetric
      summary: Aws Cloudwatch Retrieve Alarms for a Specified Metric
      description: Retrieves the alarms for the specified metric. To filter the results, specify a statistic, period, or unit. This operation retrieves only standard alarms that are based on the specified metric.
      tags:
      - Alarms
      parameters:
      - $ref: '#/components/parameters/Action_DescribeAlarmsForMetric'
      - $ref: '#/components/parameters/Version'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/DescribeAlarmsForMetricInput'
            examples:
              DescribealarmsformetricRequestExample:
                summary: Default DescribeAlarmsForMetric request
                x-microcks-default: true
                value:
                  MetricName: example_value
                  Namespace: example_value
                  Statistic: SampleCount
                  ExtendedStatistic: example_value
                  Dimensions:
                  - Name: Example Title
                    Value: example_value
                  Period: 10
                  Unit: Seconds
      responses:
        '200':
          description: Successful response
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/DescribeAlarmsForMetricOutput'
              examples:
                Describealarmsformetric200Example:
                  summary: Default DescribeAlarmsForMetric 200 response
                  x-microcks-default: true
                  value:
                    MetricAlarms:
                    - AlarmName: example_value
                      AlarmArn: example_value
                      AlarmDescription: example_value
                      AlarmConfigurationUpdatedTimestamp: '2026-01-15T10:30:00Z'
                      ActionsEnabled: true
                      OKActions: {}
                      AlarmActions: {}
                      InsufficientDataActions: {}
                      StateReason: example_value
                      StateReasonData: example_value
                      StateUpdatedTimestamp: '2026-01-15T10:30:00Z'
                      MetricName: example_value
                      Namespace: example_value
                      ExtendedStatistic: example_value
                      Dimensions: {}
                      Period: 10
                      EvaluationPeriods: 10
                      DatapointsToAlarm: 10
                      Threshold: 42.5
                      TreatMissingData: breaching
                      EvaluateLowSampleCountPercentile: example_value
                      Metrics: {}
                      ThresholdMetricId: '500123'
                      StateTransitionedTimestamp: '2026-01-15T10:30:00Z'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /#DescribeAlarmHistory:
    post:
      operationId: DescribeAlarmHistory
      summary: Aws Cloudwatch Retrieve the History for a Specified Alarm
      description: Retrieves the history for the specified alarm. You can filter the results by date range or item type. If an alarm name is not specified, the histories for either all metric alarms or all composite alarms are returned. CloudWatch retains the history of an alarm even if you delete the alarm.
      tags:
      - Alarms
      parameters:
      - $ref: '#/components/parameters/Action_DescribeAlarmHistory'
      - $ref: '#/components/parameters/Version'
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/DescribeAlarmHistoryInput'
            examples:
              DescribealarmhistoryRequestExample:
                summary: Default DescribeAlarmHistory request
                x-microcks-default: true
                value:
                  AlarmName: example_value
                  AlarmTypes:
                  - CompositeAlarm
                  HistoryItemType: ConfigurationUpdate
                  StartDate: '2026-01-15T10:30:00Z'
                  EndDate: '2026-01-15T10:30:00Z'
                  MaxRecords: 10
                  NextToken: example_value
                  ScanBy: TimestampDescending
      responses:
        '200':
          description: Successful response
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/DescribeAlarmHistoryOutput'
              examples:
                Describealarmhistory200Example:
                  summary: Default DescribeAlarmHistory 200 response
                  x-microcks-default: true
                  value:
                    AlarmHistoryItems:
                    - AlarmName: example_value
                      AlarmType: CompositeAlarm
                      Timestamp: '2026-01-15T10:30:00Z'
                      HistoryItemType: ConfigurationUpdate
                      HistorySummary: example_value
                      HistoryData: example_value
                    NextToken: example_value
        '400':
          description: Invalid next token
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Describealarmhistory400Example:
                  summary: Default DescribeAlarmHistory 400 response
                  x-microcks-default: true
                  value:
                    Error:
                      Type: example_value
                      Code: example_value
                      Message: example_value
                    RequestId: '500123'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /#DeleteAlarms:
    post:
      operationId: DeleteAlarms
      summary: Aws Cloudwatch Delete Specified Alarms
      description: Deletes the specified alarms. You can delete up to 100 alarms in one operation. In the event of an error, no alarms are deleted. To get information about your current alarms, use DescribeAlarms. If a specified alarm does not exist, no error is returned.
      tags:
      - Alarms
      parameters:
      - $ref: '#/components/parameters/Action_DeleteAlarms'
      - $ref: '#/components/parameters/Version'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/DeleteAlarmsInput'
            examples:
              DeletealarmsRequestExample:
                summary: Default DeleteAlarms request
                x-microcks-default: true
                value:
                  AlarmNames:
                  - example_value
      responses:
        '200':
          description: Successful response
        '400':
          description: Resource not found
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Deletealarms400Example:
                  summary: Default DeleteAlarms 400 response
                  x-microcks-default: true
                  value:
                    Error:
                      Type: example_value
                      Code: example_value
                      Message: example_value
                    RequestId: '500123'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /#SetAlarmState:
    post:
      operationId: SetAlarmState
      summary: Aws Cloudwatch Temporarily Set the State of an Alarm
      description: Temporarily sets the state of an alarm for testing purposes. When the updated state differs from the previous value, the action configured for the appropriate state is invoked. For example, if your alarm is configured to send an Amazon SNS message when an alarm is triggered, temporarily changing the alarm state to ALARM sends an SNS message.
      tags:
      - Alarms
      parameters:
      - $ref: '#/components/parameters/Action_SetAlarmState'
      - $ref: '#/components/parameters/Version'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/SetAlarmStateInput'
            examples:
              SetalarmstateRequestExample:
                summary: Default SetAlarmState request
                x-microcks-default: true
                value:
                  AlarmName: example_value
                  StateValue: OK
                  StateReason: example_value
                  StateReasonData: example_value
      responses:
        '200':
          description: Successful response
        '400':
          description: Invalid format or resource not found
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Setalarmstate400Example:
                  summary: Default SetAlarmState 400 response
                  x-microcks-default: true
                  value:
                    Error:
                      Type: example_value
                      Code: example_value
                      Message: example_value
                    RequestId: '500123'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /#EnableAlarmActions:
    post:
      operationId: EnableAlarmActions
      summary: Aws Cloudwatch Enable Actions for Specified Alarms
      description: Enables the actions for the specified alarms.
      tags:
      - Alarms
      parameters:
      - $ref: '#/components/parameters/Action_EnableAlarmActions'
      - $ref: '#/components/parameters/Version'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/EnableAlarmActionsInput'
            examples:
              EnablealarmactionsRequestExample:
                summary: Default EnableAlarmActions request
                x-microcks-default: true
                value:
                  AlarmNames:
                  - example_value
      responses:
        '200':
          description: Successful response
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /#DisableAlarmActions:
    post:
      operationId: DisableAlarmActions
      summary: Aws Cloudwatch Disable Actions for Specified Alarms
      description: Disables the actions for the specified alarms. When an alarm's actions are disabled, the alarm actions do not execute when the alarm state changes.
      tags:
      - Alarms
      parameters:
      - $ref: '#/components/parameters/Action_DisableAlarmActions'
      - $ref: '#/components/parameters/Version'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/DisableAlarmActionsInput'
            examples:
              DisablealarmactionsRequestExample:
                summary: Default DisableAlarmActions request
                x-microcks-default: true
                value:
                  AlarmNames:
                  - example_value
      responses:
        '200':
          description: Successful response
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  parameters:
    Action_EnableAlarmActions:
      name: Action
      in: query
      required: true
      schema:
        type: string
        enum:
        - EnableAlarmActions
    Action_DescribeAlarms:
      name: Action
      in: query
      required: true
      schema:
        type: string
        enum:
        - DescribeAlarms
    Action_PutMetricAlarm:
      name: Action
      in: query
      required: true
      schema:
        type: string
        enum:
        - PutMetricAlarm
    Action_DescribeAlarmsForMetric:
      name: Action
      in: query
      required: true
      schema:
        type: string
        enum:
        - DescribeAlarmsForMetric
    Action_SetAlarmState:
      name: Action
      in: query
      required: true
      schema:
        type: string
        enum:
        - SetAlarmState
    Action_DeleteAlarms:
      name: Action
      in: query
      required: true
      schema:
        type: string
        enum:
        - DeleteAlarms
    Action_DisableAlarmActions:
      name: Action
      in: query
      required: true
      schema:
        type: string
        enum:
        - DisableAlarmActions
    Action_DescribeAlarmHistory:
      name: Action
      in: query
      required: true
      schema:
        type: string
        enum:
        - DescribeAlarmHistory
    Version:
      name: Version
      in: query
      required: true
      schema:
        type: string
        enum:
        - '2010-08-01'
      description: The API version (2010-08-01)
  schemas:
    ComparisonOperator:
      type: string
      description: The arithmetic operation to use when comparing the specified statistic and threshold.
      enum:
      - GreaterThanOrEqualToThreshold
      - GreaterThanThreshold
      - LessThanThreshold
      - LessThanOrEqualToThreshold
      - LessThanLowerOrGreaterThanUpperThreshold
      - LessThanLowerThreshold
      - GreaterThanUpperThreshold
    PutMetricAlarmInput:
      type: object
      required:
      - AlarmName
      - EvaluationPeriods
      - ComparisonOperator
      properties:
        AlarmName:
          type: string
          minLength: 1
          maxLength: 255
          description: The name for the alarm.
          example: example_value
        AlarmDescription:
          type: string
          maxLength: 1024
          description: The description for the alarm.
          example: example_value
        ActionsEnabled:
          type: boolean
          description: Indicates whether actions should be executed during any changes to the alarm state.
          example: true
        OKActions:
          type: array
          items:
            type: string
          maxItems: 5
          description: The actions to execute when this alarm transitions to an OK state.
          example: []
        AlarmActions:
          type: array
          items:
            type: string
          maxItems: 5
          description: The actions to execute when this alarm transitions to the ALARM state.
          example: []
        InsufficientDataActions:
          type: array
          items:
            type: string
          maxItems: 5
          description: The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state.
          example: []
        MetricName:
          type: string
          minLength: 1
          maxLength: 255
          description: The name for the metric associated with the alarm.
          example: example_value
        Namespace:
          type: string
          minLength: 1
          maxLength: 255
          description: The namespace for the metric associated with the alarm.
          example: example_value
        Statistic:
          $ref: '#/components/schemas/Statistic'
        ExtendedStatistic:
          type: string
          description: The percentile statistic for the metric specified in MetricName.
          example: example_value
        Dimensions:
          type: array
          items:
            $ref: '#/components/schemas/Dimension'
          maxItems: 30
          description: The dimensions for the metric specified in MetricName.
          example: []
        Period:
          type: integer
          minimum: 1
          description: The length, in seconds, used each time the metric specified in MetricName is evaluated.
          example: 10
        Unit:
          $ref: '#/components/schemas/StandardUnit'
        EvaluationPeriods:
          type: integer
          minimum: 1
          description: The number of periods over which data is compared to the specified threshold.
          example: 10
        DatapointsToAlarm:
          type: integer
          minimum: 1
          description: The number of data points that must be breaching to trigger the alarm.
          example: 10
        Threshold:
          type: number
          format: double
          description: The value against which the specified statistic is compared.
          example: 42.5
        ComparisonOperator:
          $ref: '#/components/schemas/ComparisonOperator'
        TreatMissingData:
          type: string
          description: Sets how this alarm is to handle missing data points.
          example: example_value
        EvaluateLowSampleCountPercentile:
          type: string
          description: Used only for alarms based on percentiles.
          example: example_value
        Metrics:
          type: array
          items:
            $ref: '#/components/schemas/MetricDataQuery'
          description: An array of MetricDataQuery structures for metric math expression alarms.
          example: []
        Tags:
          type: array
          items:
            $ref: '#/components/schemas/Tag'
          description: A list of key-value pairs to associate with the alarm.
          example: []
        ThresholdMetricId:
          type: string
          description: If this is an alarm based on an anomaly detection model, make this value match the ID of the ANOMALY_DETECTION_BAND function.
          example: '500123'
    MetricAlarm:
      type: object
      description: The details about a metric alarm.
      properties:
        AlarmName:
          type: string
          minLength: 1
          maxLength: 255
          description: The name of the alarm.
          example: example_value
        AlarmArn:
          type: string
          minLength: 1
          maxLength: 1600
          description: The Amazon Resource Name (ARN) of the alarm.
          example: example_value
        AlarmDescription:
          type: string
          maxLength: 1024
          description: The description of the alarm.
          example: example_value
        AlarmConfigurationUpdatedTimestamp:
          type: string
          format: date-time
          description: The time stamp of the last update to the alarm configuration.
          example: '2026-01-15T10:30:00Z'
        ActionsEnabled:
          type: boolean
          description: Indicates whether actions should be executed during any changes to the alarm state.
          example: true
        OKActions:
          type: array
          items:
            type: string
          maxItems: 5
          description: The actions to execute when this alarm transitions to the OK state.
          example: []
        AlarmActions:
          type: array
          items:
            type: string
          maxItems: 5
          description: The actions to execute when this alarm transitions to the ALARM state.
          example: []
        InsufficientDataActions:
          type: array
          items:
            type: string
          maxItems: 5
          description: The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state.
          example: []
        StateValue:
          $ref: '#/components/schemas/StateValue'
        StateReason:
          type: string
          maxLength: 1023
          description: An explanation for the alarm state, in text format.
          example: example_value
        StateReasonData:
          type: string
          maxLength: 4000
          description: An explanation for the alarm state, in JSON format.
          example: example_value
        StateUpdatedTimestamp:
          type: string
          format: date-time
          description: The time stamp of the last update to the value of either the StateValue or StateReasonData.
          example: '2026-01-15T10:30:00Z'
        MetricName:
          type: string
          minLength: 1
          maxLength: 255
          description: The name of the metric associated with the alarm.
          example: example_value
        Namespace:
          type: string
          minLength: 1
          maxLength: 255
          description: The namespace of the metric associated with the alarm.
          example: example_value
        Statistic:
          $ref: '#/components/schemas/Statistic'
        ExtendedStatistic:
          type: string
          description: The percentile statistic for the metric associated with the alarm.
          example: example_value
        Dimensions:
          type: array
          items:
            $ref: '#/components/schemas/Dimension'
          maxItems: 30
          description: The dimensions for the metric associated with the alarm.
          example: []
        Period:
          type: integer
          minimum: 1
          description: The period, in seconds, over which the statistic is applied.
          example: 10
        Unit:
          $ref: '#/components/schemas/StandardUnit'
        EvaluationPeriods:
          type: integer
          minimum: 1
          description: The number of periods over which data is compared to the specified threshold.
          example: 10
        DatapointsToAlarm:
          type: integer
          minimum: 1
          description: The number of data points that must be breaching to trigger the alarm.
          example: 10
        Threshold:
          type: number
          format: double
          description: The value to compare with the specified statistic.
          example: 42.5
        ComparisonOperator:
          $ref: '#/components/schemas/ComparisonOperator'
        TreatMissingData:
          type: string
          enum:
          - breaching
          - notBreaching
          - ignore
          - missing
          description: Sets how this alarm is to handle missing data points.
          example: breaching
        EvaluateLowSampleCountPercentile:
          type: string
          description: Used only for alarms based on percentiles.
          example: example_value
        Metrics:
          type: array
          items:
            $ref: '#/components/schemas/MetricDataQuery'
          description: An array of MetricDataQuery structures for metric math expressions.
          example: []
        ThresholdMetricId:
          type: string
          description: If the value of this field is set to an alarm metric ID, the alarm is based on an anomaly detection model.
          example: '500123'
        StateTransitionedTimestamp:
          type: string
          format: date-time
          description: The date and time that the alarm's StateValue most recently changed.
          example: '2026-01-15T10:30:00Z'
    CompositeAlarm:
      type: object
      description: The details about a composite alarm.
      properties:
        ActionsEnabled:
          type: boolean
          description: Indicates whether actions should be executed during changes to the alarm state.
          example: true
        AlarmActions:
          type: array
          items:
            type: string
          maxItems: 5
          description: The actions to execute when this alarm transitions to the 

# --- truncated at 32 KB (49 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cloudwatch/refs/heads/main/openapi/cloudwatch-alarms-api-openapi.yml