CreateMonitoringSubscription - Amazon CloudFront

CreateMonitoringSubscription

Enables additional CloudWatch metrics for the specified CloudFront distribution. The additional metrics incur an additional cost.

For more information, see Viewing additional CloudFront distribution metrics in the Amazon CloudFront Developer Guide.

Request Syntax

POST /2020-05-31/distributions/DistributionId/monitoring-subscription HTTP/1.1 <?xml version="1.0" encoding="UTF-8"?> <MonitoringSubscription xmlns="http://cloudfront.amazonaws.com/doc/2020-05-31/"> <RealtimeMetricsSubscriptionConfig> <RealtimeMetricsSubscriptionStatus>string</RealtimeMetricsSubscriptionStatus> </RealtimeMetricsSubscriptionConfig> </MonitoringSubscription>

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in XML format.

MonitoringSubscription

Root level tag for the MonitoringSubscription parameters.

Required: Yes

RealtimeMetricsSubscriptionConfig

A subscription configuration for additional CloudWatch metrics.

Type: RealtimeMetricsSubscriptionConfig object

Required: No

Response Syntax

HTTP/1.1 200 <?xml version="1.0" encoding="UTF-8"?> <MonitoringSubscription> <RealtimeMetricsSubscriptionConfig> <RealtimeMetricsSubscriptionStatus>string</RealtimeMetricsSubscriptionStatus> </RealtimeMetricsSubscriptionConfig> </MonitoringSubscription>

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in XML format by the service.

MonitoringSubscription

Root level tag for the MonitoringSubscription parameters.

Required: Yes

RealtimeMetricsSubscriptionConfig

A subscription configuration for additional CloudWatch metrics.

Type: RealtimeMetricsSubscriptionConfig object

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDenied

Access denied.

HTTP Status Code: 403

MonitoringSubscriptionAlreadyExists

A monitoring subscription already exists for the specified distribution.

HTTP Status Code: 409

NoSuchDistribution

The specified distribution does not exist.

HTTP Status Code: 404

UnsupportedOperation

This operation is not supported in this region.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: