AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Creates or updates a metric stream. Metric streams can automatically stream CloudWatch metrics to Amazon Web Services destinations, including Amazon S3, and to many third-party solutions.
For more information, see Using Metric Streams.
To create a metric stream, you must be signed in to an account that has the iam:PassRole
permission and either the CloudWatchFullAccess policy or the cloudwatch:PutMetricStream
permission.
When you create or update a metric stream, you choose one of the following:
Stream metrics from all metric namespaces in the account.
Stream metrics from all metric namespaces in the account, except for the namespaces
that you list in ExcludeFilters.
Stream metrics from only the metric namespaces that you list in IncludeFilters.
By default, a metric stream always sends the MAX, MIN, SUM, and
SAMPLECOUNT statistics for each metric that is streamed. You can use the StatisticsConfigurations
parameter to have the metric stream send additional statistics in the stream. Streaming
additional statistics incurs additional costs. For more information, see Amazon
CloudWatch Pricing.
When you use PutMetricStream to create a new metric stream, the stream is created
in the running state. If you use it to update an existing stream, the state
of the stream is not changed.
If you are using CloudWatch cross-account observability and you create a metric stream in a monitoring account, you can choose whether to include metrics from source accounts in the stream. For more information, see CloudWatch cross-account observability.
For .NET Core this operation is only available in asynchronous form. Please refer to PutMetricStreamAsync.
Namespace: Amazon.CloudWatch
Assembly: AWSSDK.CloudWatch.dll
Version: 3.x.y.z
public virtual PutMetricStreamResponse PutMetricStream( PutMetricStreamRequest request )
Container for the necessary parameters to execute the PutMetricStream service method.
| Exception | Condition |
|---|---|
| ConcurrentModificationException | More than one process tried to modify a resource at the same time. |
| InternalServiceException | Request processing has failed due to some unknown error, exception, or failure. |
| InvalidParameterCombinationException | Parameters were used together that cannot be used together. |
| InvalidParameterValueException | The value of an input parameter is bad or out-of-range. |
| MissingRequiredParameterException | An input parameter that is required is missing. |
.NET Framework:
Supported in: 4.5 and newer, 3.5