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:
