Struct aws_sdk_resourcegroups::client::fluent_builders::CreateGroup

pub struct CreateGroup<C = DynConnector, M = AwsMiddleware, R = Standard> { /* fields omitted */ }

Fluent builder constructing a request to CreateGroup.

Creates a resource group with the specified name and description. You can optionally include a resource query, or a service configuration. For more information about constructing a resource query, see Create a tag-based group in Resource Groups. For more information about service configurations, see Service configurations for resource groups.

Minimum permissions

To run this command, you must have the following permissions:

• resource-groups:CreateGroup

Implementations

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

pub async fn send(self) -> Result<CreateGroupOutput, SdkError<CreateGroupError>> where
    R::Policy: SmithyRetryPolicy<CreateGroupInputOperationOutputAlias, CreateGroupOutput, CreateGroupError, CreateGroupInputOperationRetryAlias>, 

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 name(self, inp: impl Into<String>) -> Self

The name of the group, which is the identifier of the group in other operations. You can't change the name of a resource group after you create it. A resource group name can consist of letters, numbers, hyphens, periods, and underscores. The name cannot start with AWS or aws; these are reserved. A resource group name must be unique within each AWS Region in your AWS account.

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

The name of the group, which is the identifier of the group in other operations. You can't change the name of a resource group after you create it. A resource group name can consist of letters, numbers, hyphens, periods, and underscores. The name cannot start with AWS or aws; these are reserved. A resource group name must be unique within each AWS Region in your AWS account.

pub fn description(self, inp: impl Into<String>) -> Self

The description of the resource group. Descriptions can consist of letters, numbers, hyphens, underscores, periods, and spaces.

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

The description of the resource group. Descriptions can consist of letters, numbers, hyphens, underscores, periods, and spaces.

pub fn resource_query(self, inp: ResourceQuery) -> Self

The resource query that determines which AWS resources are members of this group. For more information about resource queries, see Create a tag-based group in Resource Groups.

A resource group can contain either a ResourceQuery or a Configuration, but not both.

pub fn set_resource_query(self, input: Option<ResourceQuery>) -> Self

The resource query that determines which AWS resources are members of this group. For more information about resource queries, see Create a tag-based group in Resource Groups.

A resource group can contain either a ResourceQuery or a Configuration, but not both.

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 tags to add to the group. A tag is key-value pair string.

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

The tags to add to the group. A tag is key-value pair string.

pub fn configuration(self, inp: impl Into<GroupConfigurationItem>) -> Self

Appends an item to Configuration.

To override the contents of this collection use set_configuration.

A configuration associates the resource group with an AWS service and specifies how the service can interact with the resources in the group. A configuration is an array of GroupConfigurationItem elements. For details about the syntax of service configurations, see Service configurations for resource groups.

A resource group can contain either a Configuration or a ResourceQuery, but not both.

pub fn set_configuration(
    self,
    input: Option<Vec<GroupConfigurationItem>>
) -> Self

A configuration associates the resource group with an AWS service and specifies how the service can interact with the resources in the group. A configuration is an array of GroupConfigurationItem elements. For details about the syntax of service configurations, see Service configurations for resource groups.

A resource group can contain either a Configuration or a ResourceQuery, but not both.

Trait Implementations

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

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

Formats the value using the given formatter.