Struct aws_sdk_cloudwatchlogs::operation::create_log_group::builders::CreateLogGroupFluentBuilder

pub struct CreateLogGroupFluentBuilder { /* private fields */ }

Fluent builder constructing a request to CreateLogGroup.

Creates a log group with the specified name. You can create up to 1,000,000 log groups per Region per account.

You must use the following guidelines when naming a log group:

• Log group names must be unique within a Region for an Amazon Web Services account.

• Log group names can be between 1 and 512 characters long.

• Log group names consist of the following characters: a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), '/' (forward slash), '.' (period), and '#' (number sign)

• Log group names can't start with the string aws/

When you create a log group, by default the log events in the log group do not expire. To set a retention policy so that events expire and are deleted after a specified time, use PutRetentionPolicy.

If you associate an KMS key with the log group, ingested data is encrypted using the KMS key. This association is stored as long as the data encrypted with the KMS key is still within CloudWatch Logs. This enables CloudWatch Logs to decrypt this data whenever it is requested.

If you attempt to associate a KMS key with the log group but the KMS key does not exist or the KMS key is disabled, you receive an InvalidParameterException error.

CloudWatch Logs supports only symmetric KMS keys. Do not associate an asymmetric KMS key with your log group. For more information, see Using Symmetric and Asymmetric Keys.

Implementations

impl CreateLogGroupFluentBuilder

pub fn as_input(&self) -> &CreateLogGroupInputBuilder

Access the CreateLogGroup as a reference.

pub async fn send( self, ) -> Result<CreateLogGroupOutput, SdkError<CreateLogGroupError, HttpResponse>>

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 customize( self, ) -> CustomizableOperation<CreateLogGroupOutput, CreateLogGroupError, Self>

Consumes this builder, creating a customizable operation that can be modified before being sent.

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

A name for the log group.

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

A name for the log group.

pub fn get_log_group_name(&self) -> &Option<String>

A name for the log group.

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

The Amazon Resource Name (ARN) of the KMS key to use when encrypting log data. For more information, see Amazon Resource Names.

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

The Amazon Resource Name (ARN) of the KMS key to use when encrypting log data. For more information, see Amazon Resource Names.

pub fn get_kms_key_id(&self) -> &Option<String>

The Amazon Resource Name (ARN) of the KMS key to use when encrypting log data. For more information, see Amazon Resource Names.

pub fn tags(self, k: impl Into<String>, v: impl Into<String>) -> Self

Adds a key-value pair to tags.

To override the contents of this collection use set_tags.

The key-value pairs to use for the tags.

You can grant users access to certain log groups while preventing them from accessing other log groups. To do so, tag your groups and use IAM policies that refer to those tags. To assign tags when you create a log group, you must have either the logs:TagResource or logs:TagLogGroup permission. For more information about tagging, see Tagging Amazon Web Services resources. For more information about using tags to control access, see Controlling access to Amazon Web Services resources using tags.

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

The key-value pairs to use for the tags.

You can grant users access to certain log groups while preventing them from accessing other log groups. To do so, tag your groups and use IAM policies that refer to those tags. To assign tags when you create a log group, you must have either the logs:TagResource or logs:TagLogGroup permission. For more information about tagging, see Tagging Amazon Web Services resources. For more information about using tags to control access, see Controlling access to Amazon Web Services resources using tags.

pub fn get_tags(&self) -> &Option<HashMap<String, String>>

The key-value pairs to use for the tags.

You can grant users access to certain log groups while preventing them from accessing other log groups. To do so, tag your groups and use IAM policies that refer to those tags. To assign tags when you create a log group, you must have either the logs:TagResource or logs:TagLogGroup permission. For more information about tagging, see Tagging Amazon Web Services resources. For more information about using tags to control access, see Controlling access to Amazon Web Services resources using tags.

pub fn log_group_class(self, input: LogGroupClass) -> Self

Use this parameter to specify the log group class for this log group. There are two classes:

• The Standard log class supports all CloudWatch Logs features.

• The Infrequent Access log class supports a subset of CloudWatch Logs features and incurs lower costs.

If you omit this parameter, the default of STANDARD is used.

The value of logGroupClass can't be changed after a log group is created.

For details about the features supported by each class, see Log classes

pub fn set_log_group_class(self, input: Option<LogGroupClass>) -> Self

Use this parameter to specify the log group class for this log group. There are two classes:

• The Standard log class supports all CloudWatch Logs features.

• The Infrequent Access log class supports a subset of CloudWatch Logs features and incurs lower costs.

If you omit this parameter, the default of STANDARD is used.

The value of logGroupClass can't be changed after a log group is created.

For details about the features supported by each class, see Log classes

pub fn get_log_group_class(&self) -> &Option<LogGroupClass>

Use this parameter to specify the log group class for this log group. There are two classes:

• The Standard log class supports all CloudWatch Logs features.

• The Infrequent Access log class supports a subset of CloudWatch Logs features and incurs lower costs.

If you omit this parameter, the default of STANDARD is used.

The value of logGroupClass can't be changed after a log group is created.

For details about the features supported by each class, see Log classes

Trait Implementations

impl Clone for CreateLogGroupFluentBuilder

fn clone(&self) -> CreateLogGroupFluentBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CreateLogGroupFluentBuilder

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

Formats the value using the given formatter.