# Get CloudWatch metric data

Canonical URL: https://docs.fuse.init.inc/integrations/aws/actions/cloudwatch.metric_data.get

Get CloudWatch metric data for up to 100 queries with MaxDatapoints 10000. Metric expressions are 1-2048 characters and must not start with SELECT (Metrics Insights deferred). Returns AWS pagination cursors without local truncation. Requires cloudwatch:GetMetricData.

Action ID: `cloudwatch.metric_data.get`
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:GetMetricData`

## Input schema fields

- `region`
- `start_time`
- `end_time`
- `queries`
- `queries[]`
- `queries[].id`
- `queries[].label`
- `queries[].return_data`
- `queries[].metric`
- `queries[].metric.namespace`
- `queries[].metric.metric_name`
- `queries[].metric.dimensions`
- `queries[].metric.dimensions[]`
- `queries[].metric.dimensions[].name`
- `queries[].metric.dimensions[].value`
- `queries[].metric.period_seconds`
- `queries[].metric.stat`
- `queries[].metric.unit`
- `queries[].expression`
- `queries[].period_seconds`
- `scan_order`
- `cursor`

## Output schema fields

- `results`
- `results[]`
- `results[].id`
- `results[].label`
- `results[].status`
- `results[].messages`
- `results[].messages[]`
- `results[].messages[].code`
- `results[].messages[].value`
- `results[].points`
- `results[].points[]`
- `results[].points[].timestamp`
- `results[].points[].value`
- `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.metric_data.get
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/aws/actions