# List CloudWatch alarms

Canonical URL: https://docs.fuse.init.inc/integrations/aws/actions/cloudwatch.alarms.list

List metric, composite, and log CloudWatch alarms. alarm_names and alarm_name_prefix are mutually exclusive. Requires cloudwatch:DescribeAlarms (composite enumeration needs Resource: *).

Action ID: `cloudwatch.alarms.list`
Provider: AWS (`aws`)
Contract version: 1

## Risk and exposure

- Risk: Read
- Idempotency: Safe — Safe to retry without coordination; repeats do not create additional side effects.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=true, destructive=false, idempotent=true, openWorld=true

## Required scopes

- `cloudwatch:DescribeAlarms`

## Input schema fields

- `region`
- `alarm_names`
- `alarm_names[]`
- `alarm_name_prefix`
- `state_value`
- `page_size`
- `cursor`

## Output schema fields

- `alarms`
- `alarms[]`
- `alarms[].type`
- `alarms[].name`
- `alarms[].arn`
- `alarms[].description`
- `alarms[].state`
- `alarms[].state_updated_at`
- `alarms[].actions_enabled`
- `alarms[].metric`
- `alarms[].metric.namespace`
- `alarms[].metric.metric_name`
- `alarms[].metric.statistic`
- `alarms[].metric.extended_statistic`
- `alarms[].metric.dimensions`
- `alarms[].metric.dimensions[]`
- `alarms[].metric.dimensions[].name`
- `alarms[].metric.dimensions[].value`
- `alarms[].metric.period_seconds`
- `alarms[].metric.unit`
- `alarms[].metric.threshold`
- `alarms[].metric.comparison_operator`
- `alarms[].metric.evaluation_periods`
- `alarms[].metric.datapoints_to_alarm`
- `alarms[].metric.treat_missing_data`
- `alarms[].alarm_rule`
- `alarms[].log`
- `alarms[].log.query_string`
- `alarms[].log.query_arn`
- `alarms[].log.aggregation_expression`
- `alarms[].log.log_group_identifiers`
- `alarms[].log.log_group_identifiers[]`
- `alarms[].log.threshold`
- `alarms[].log.comparison_operator`
- `next_cursor`

Provider overview: https://docs.fuse.init.inc/integrations/aws
Actions index: https://docs.fuse.init.inc/integrations/aws/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/aws/actions/cloudwatch.alarms.list
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/aws/actions