Skip to main content

aws_sdk_ssm/client/
create_association_batch.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 [`CreateAssociationBatch`](crate::operation::create_association_batch::builders::CreateAssociationBatchFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`entries(CreateAssociationBatchRequestEntry)`](crate::operation::create_association_batch::builders::CreateAssociationBatchFluentBuilder::entries) / [`set_entries(Option<Vec::<CreateAssociationBatchRequestEntry>>)`](crate::operation::create_association_batch::builders::CreateAssociationBatchFluentBuilder::set_entries):<br>required: **true**<br><p>One or more associations.</p><br>
7    ///   - [`association_dispatch_assume_role(impl Into<String>)`](crate::operation::create_association_batch::builders::CreateAssociationBatchFluentBuilder::association_dispatch_assume_role) / [`set_association_dispatch_assume_role(Option<String>)`](crate::operation::create_association_batch::builders::CreateAssociationBatchFluentBuilder::set_association_dispatch_assume_role):<br>required: **false**<br><p>A role used by association to take actions on your behalf. State Manager will assume this role and call required APIs when dispatching configurations to nodes. If not specified, <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/using-service-linked-roles.html"> service-linked role for Systems Manager</a> will be used by default.</p><note>  <p>It is recommended that you define a custom IAM role so that you have full control of the permissions that State Manager has when taking actions on your behalf.</p>  <p>Service-linked role support in State Manager is being phased out. Associations relying on service-linked role may require updates in the future to continue functioning properly.</p> </note><br>
8    /// - On success, responds with [`CreateAssociationBatchOutput`](crate::operation::create_association_batch::CreateAssociationBatchOutput) with field(s):
9    ///   - [`successful(Option<Vec::<AssociationDescription>>)`](crate::operation::create_association_batch::CreateAssociationBatchOutput::successful): <p>Information about the associations that succeeded.</p>
10    ///   - [`failed(Option<Vec::<FailedCreateAssociation>>)`](crate::operation::create_association_batch::CreateAssociationBatchOutput::failed): <p>Information about the associations that failed.</p>
11    /// - On failure, responds with [`SdkError<CreateAssociationBatchError>`](crate::operation::create_association_batch::CreateAssociationBatchError)
12    pub fn create_association_batch(&self) -> crate::operation::create_association_batch::builders::CreateAssociationBatchFluentBuilder {
13        crate::operation::create_association_batch::builders::CreateAssociationBatchFluentBuilder::new(self.handle.clone())
14    }
15}