Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

AWS CloudWatch Metric Streams API

Operations for managing metric streams

AWS CloudWatch Metric Streams API is one of 8 APIs that AWS CloudWatch publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Metric Streams. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, pricing, a getting-started guide, an API reference, and 2 JSON Schemas.

This API exposes 2 operations across 2 paths, and defines 8 schemas. It is described by OpenAPI 3.1.0, at version 2010-08-01.

Requests are made against a single base URL, https://monitoring.{region}.amazonaws.com.

2 operations 2 paths 8 schemas 2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2010-08-01
Base URL
https://monitoring.amazonaws.com
Authentication
API Key
License
Resource Areas
1

Authentication & Security 1

AWS CloudWatch Metric Streams API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (aws_sigv4). By default, every request must be authenticated.

  • aws_sigv4 — AWS Signature Version 4 authentication

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 POST. Each is listed below with its method, path, parameters, and response codes.

Metric Streams 2

Operations for managing metric streams

POST
/#PutMetricStream
Aws Cloudwatch Create or Update a Metric Stream
PutMetricStream 2 params body → 200400
POST
/#ListMetricStreams
Aws Cloudwatch List the Metric Streams in Your Account
ListMetricStreams 2 params body → 200

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are PutMetricStreamInput (8 properties), MetricStreamEntry (7 properties), ListMetricStreamsOutput (2 properties), ErrorResponse (2 properties). Each schema is shown below with its type and property counts.

ListMetricStreamsOutput
object
2 properties
PutMetricStreamInput
object
8 properties 4 required
MetricStreamFilter
object
Contains the configuration for a metric stream filter.
2 properties
MetricStreamEntry
object
Contains information about a metric stream.
7 properties
Tag
object
A key-value pair associated with a CloudWatch resource.
2 properties 2 required
ListMetricStreamsInput
object
2 properties
ErrorResponse
object
Standard error response from CloudWatch API.
2 properties
PutMetricStreamOutput
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cloudwatch-metric-streams-api-openapi.yml Raw ↑

Other APIs AWS CloudWatch publishes across the network.

Amazon CloudWatch Application Signals API
Amazon CloudWatch Network Monitor API
AWS CloudWatch Alarms API
AWS CloudWatch Anomaly Detection API
AWS CloudWatch Composite Alarms API
AWS CloudWatch Dashboards API
AWS CloudWatch Metrics API