aws_sdk_snowdevicemanagement/client/
create_task.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 [`CreateTask`](crate::operation::create_task::builders::CreateTaskFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`targets(impl Into<String>)`](crate::operation::create_task::builders::CreateTaskFluentBuilder::targets) / [`set_targets(Option<Vec::<String>>)`](crate::operation::create_task::builders::CreateTaskFluentBuilder::set_targets):<br>required: **true**<br><p>A list of managed device IDs.</p><br>
7    ///   - [`command(Command)`](crate::operation::create_task::builders::CreateTaskFluentBuilder::command) / [`set_command(Option<Command>)`](crate::operation::create_task::builders::CreateTaskFluentBuilder::set_command):<br>required: **true**<br><p>The task to be performed. Only one task is executed on a device at a time.</p><br>
8    ///   - [`description(impl Into<String>)`](crate::operation::create_task::builders::CreateTaskFluentBuilder::description) / [`set_description(Option<String>)`](crate::operation::create_task::builders::CreateTaskFluentBuilder::set_description):<br>required: **false**<br><p>A description of the task and its targets.</p><br>
9    ///   - [`tags(impl Into<String>, impl Into<String>)`](crate::operation::create_task::builders::CreateTaskFluentBuilder::tags) / [`set_tags(Option<HashMap::<String, String>>)`](crate::operation::create_task::builders::CreateTaskFluentBuilder::set_tags):<br>required: **false**<br><p>Optional metadata that you assign to a resource. You can use tags to categorize a resource in different ways, such as by purpose, owner, or environment.</p><br>
10    ///   - [`client_token(impl Into<String>)`](crate::operation::create_task::builders::CreateTaskFluentBuilder::client_token) / [`set_client_token(Option<String>)`](crate::operation::create_task::builders::CreateTaskFluentBuilder::set_client_token):<br>required: **false**<br><p>A token ensuring that the action is called only once with the specified details.</p><br>
11    /// - On success, responds with [`CreateTaskOutput`](crate::operation::create_task::CreateTaskOutput) with field(s):
12    ///   - [`task_id(Option<String>)`](crate::operation::create_task::CreateTaskOutput::task_id): <p>The ID of the task that you created.</p>
13    ///   - [`task_arn(Option<String>)`](crate::operation::create_task::CreateTaskOutput::task_arn): <p>The Amazon Resource Name (ARN) of the task that you created.</p>
14    /// - On failure, responds with [`SdkError<CreateTaskError>`](crate::operation::create_task::CreateTaskError)
15    pub fn create_task(&self) -> crate::operation::create_task::builders::CreateTaskFluentBuilder {
16        crate::operation::create_task::builders::CreateTaskFluentBuilder::new(self.handle.clone())
17    }
18}