Skip to content

CloudFront  >  Operations  >  create_monitoring_subscription

create_monitoring_subscription

Operation

create_monitoring_subscription async

create_monitoring_subscription(request: CreateMonitoringSubscriptionInput | CreateMonitoringSubscriptionInputDict, /, *, plugins: list[Plugin] | None = None) -> CreateMonitoringSubscriptionOutput
create_monitoring_subscription(*, plugins: list[Plugin] | None = None, **kwargs: Unpack[CreateMonitoringSubscriptionInputDict]) -> CreateMonitoringSubscriptionOutput

Enables or disables additional Amazon 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.

Parameters:

Name Type Description Default
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
CreateMonitoringSubscriptionOutput

An instance of CreateMonitoringSubscriptionOutput.

Input

Pass the input fields as keyword arguments, or pass a model or dictionary as the first positional argument. Pass plugins separately as a keyword argument.

Model

CreateMonitoringSubscriptionInput dataclass

Bases: _SerdeShape

Dataclass for CreateMonitoringSubscriptionInput structure.

Attributes
distribution_id class-attribute instance-attribute
distribution_id: str | None = ...

The ID of the distribution that you are enabling metrics for.

monitoring_subscription class-attribute instance-attribute
monitoring_subscription: MonitoringSubscription | None = ...

A monitoring subscription. This structure contains information about whether additional CloudWatch metrics are enabled for a given CloudFront distribution.

Dictionaries

CreateMonitoringSubscriptionInputDict

Bases: TypedDict

Dictionary form of CreateMonitoringSubscriptionInput.

Attributes
distribution_id instance-attribute
distribution_id: Required[str]

The ID of the distribution that you are enabling metrics for.

monitoring_subscription instance-attribute

A monitoring subscription. This structure contains information about whether additional CloudWatch metrics are enabled for a given CloudFront distribution.

Output

CreateMonitoringSubscriptionOutput dataclass

Bases: _SerdeShape

Dataclass for CreateMonitoringSubscriptionOutput structure.

Attributes

monitoring_subscription class-attribute instance-attribute
monitoring_subscription: MonitoringSubscription | None = ...

A monitoring subscription. This structure contains information about whether additional CloudWatch metrics are enabled for a given CloudFront distribution.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.