Struct aws_sdk_cloudwatch::client::fluent_builders::PutInsightRule

pub struct PutInsightRule<C = DynConnector, M = DefaultMiddleware, R = Standard> { /* private fields */ }

Fluent builder constructing a request to PutInsightRule.

Creates a Contributor Insights rule. Rules evaluate log events in a CloudWatch Logs log group, enabling you to find contributor data for the log events in that log group. For more information, see Using Contributor Insights to Analyze High-Cardinality Data.

If you create a rule, delete it, and then re-create it with the same name, historical data from the first time the rule was created might not be available.

Implementations

impl<C, M, R> PutInsightRule<C, M, R> where
    C: SmithyConnector,
    M: SmithyMiddleware<C>,
    R: NewRequestPolicy, 

pub async fn send(
    self
) -> Result<PutInsightRuleOutput, SdkError<PutInsightRuleError>> where
    R::Policy: SmithyRetryPolicy<PutInsightRuleInputOperationOutputAlias, PutInsightRuleOutput, PutInsightRuleError, PutInsightRuleInputOperationRetryAlias>, 

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub fn rule_name(self, input: impl Into<String>) -> Self

A unique name for the rule.

pub fn set_rule_name(self, input: Option<String>) -> Self

A unique name for the rule.

pub fn rule_state(self, input: impl Into<String>) -> Self

The state of the rule. Valid values are ENABLED and DISABLED.

pub fn set_rule_state(self, input: Option<String>) -> Self

The state of the rule. Valid values are ENABLED and DISABLED.

pub fn rule_definition(self, input: impl Into<String>) -> Self

The definition of the rule, as a JSON object. For details on the valid syntax, see Contributor Insights Rule Syntax.

pub fn set_rule_definition(self, input: Option<String>) -> Self

The definition of the rule, as a JSON object. For details on the valid syntax, see Contributor Insights Rule Syntax.

pub fn tags(self, input: Tag) -> Self

Appends an item to Tags.

To override the contents of this collection use set_tags.

A list of key-value pairs to associate with the Contributor Insights rule. You can associate as many as 50 tags with a rule.

Tags can help you organize and categorize your resources. You can also use them to scope user permissions, by granting a user permission to access or change only the resources that have certain tag values.

To be able to associate tags with a rule, you must have the cloudwatch:TagResource permission in addition to the cloudwatch:PutInsightRule permission.

If you are using this operation to update an existing Contributor Insights rule, any tags you specify in this parameter are ignored. To change the tags of an existing rule, use TagResource.

pub fn set_tags(self, input: Option<Vec<Tag>>) -> Self

A list of key-value pairs to associate with the Contributor Insights rule. You can associate as many as 50 tags with a rule.

Tags can help you organize and categorize your resources. You can also use them to scope user permissions, by granting a user permission to access or change only the resources that have certain tag values.

To be able to associate tags with a rule, you must have the cloudwatch:TagResource permission in addition to the cloudwatch:PutInsightRule permission.

If you are using this operation to update an existing Contributor Insights rule, any tags you specify in this parameter are ignored. To change the tags of an existing rule, use TagResource.

Trait Implementations

impl<C: Clone, M: Clone, R: Clone> Clone for PutInsightRule<C, M, R>

fn clone(&self) -> PutInsightRule<C, M, R>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<C: Debug, M: Debug, R: Debug> Debug for PutInsightRule<C, M, R>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.