Skip to main content

aws_sdk_networkfirewall/client/
create_container_association.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3    /// Constructs a fluent builder for the [`CreateContainerAssociation`](crate::operation::create_container_association::builders::CreateContainerAssociationFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`container_association_name(impl Into<String>)`](crate::operation::create_container_association::builders::CreateContainerAssociationFluentBuilder::container_association_name) / [`set_container_association_name(Option<String>)`](crate::operation::create_container_association::builders::CreateContainerAssociationFluentBuilder::set_container_association_name):<br>required: **true**<br><p>The descriptive name of the container association. You can't change the name of a container association after you create it.</p><br>
7    ///   - [`description(impl Into<String>)`](crate::operation::create_container_association::builders::CreateContainerAssociationFluentBuilder::description) / [`set_description(Option<String>)`](crate::operation::create_container_association::builders::CreateContainerAssociationFluentBuilder::set_description):<br>required: **false**<br><p>A description of the container association.</p><br>
8    ///   - [`r#type(ContainerMonitoringType)`](crate::operation::create_container_association::builders::CreateContainerAssociationFluentBuilder::type) / [`set_type(Option<ContainerMonitoringType>)`](crate::operation::create_container_association::builders::CreateContainerAssociationFluentBuilder::set_type):<br>required: **true**<br><p>The type of container orchestration platform for the clusters in this association. Valid values are <code>ECS</code> and <code>EKS</code>. You can't change the type after creation.</p><br>
9    ///   - [`container_monitoring_configurations(ContainerMonitoringConfiguration)`](crate::operation::create_container_association::builders::CreateContainerAssociationFluentBuilder::container_monitoring_configurations) / [`set_container_monitoring_configurations(Option<Vec::<ContainerMonitoringConfiguration>>)`](crate::operation::create_container_association::builders::CreateContainerAssociationFluentBuilder::set_container_monitoring_configurations):<br>required: **true**<br><p>The list of container monitoring configurations that define which clusters and container attributes to monitor.</p><br>
10    ///   - [`tags(Tag)`](crate::operation::create_container_association::builders::CreateContainerAssociationFluentBuilder::tags) / [`set_tags(Option<Vec::<Tag>>)`](crate::operation::create_container_association::builders::CreateContainerAssociationFluentBuilder::set_tags):<br>required: **false**<br><p>The key:value pairs to associate with the resource.</p><br>
11    /// - On success, responds with [`CreateContainerAssociationOutput`](crate::operation::create_container_association::CreateContainerAssociationOutput) with field(s):
12    ///   - [`container_association_name(Option<String>)`](crate::operation::create_container_association::CreateContainerAssociationOutput::container_association_name): <p>The descriptive name of the container association.</p>
13    ///   - [`container_association_arn(Option<String>)`](crate::operation::create_container_association::CreateContainerAssociationOutput::container_association_arn): <p>The Amazon Resource Name (ARN) of the container association.</p>
14    ///   - [`description(Option<String>)`](crate::operation::create_container_association::CreateContainerAssociationOutput::description): <p>A description of the container association.</p>
15    ///   - [`r#type(Option<ContainerMonitoringType>)`](crate::operation::create_container_association::CreateContainerAssociationOutput::type): <p>The type of container orchestration platform. Either <code>ECS</code> or <code>EKS</code>.</p>
16    ///   - [`container_monitoring_configurations(Option<Vec::<ContainerMonitoringConfiguration>>)`](crate::operation::create_container_association::CreateContainerAssociationOutput::container_monitoring_configurations): <p>The container monitoring configurations for this container association.</p>
17    ///   - [`status(Option<ContainerAssociationStatus>)`](crate::operation::create_container_association::CreateContainerAssociationOutput::status): <p>The current status of the container association.</p>
18    ///   - [`tags(Option<Vec::<Tag>>)`](crate::operation::create_container_association::CreateContainerAssociationOutput::tags): <p>The key:value pairs associated with the resource.</p>
19    ///   - [`update_token(Option<String>)`](crate::operation::create_container_association::CreateContainerAssociationOutput::update_token): <p>A token used for optimistic locking. Network Firewall returns a token to your requests that access the container association. The token marks the state of the container association resource at the time of the request. To make an update to the container association, provide the token in your request. Network Firewall uses the token to ensure that the container association hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the container association again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token.</p>
20    /// - On failure, responds with [`SdkError<CreateContainerAssociationError>`](crate::operation::create_container_association::CreateContainerAssociationError)
21    pub fn create_container_association(&self) -> crate::operation::create_container_association::builders::CreateContainerAssociationFluentBuilder {
22        crate::operation::create_container_association::builders::CreateContainerAssociationFluentBuilder::new(self.handle.clone())
23    }
24}