1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::execute_command::_execute_command_output::ExecuteCommandOutputBuilder;
pub use crate::operation::execute_command::_execute_command_input::ExecuteCommandInputBuilder;
/// Fluent builder constructing a request to `ExecuteCommand`.
///
/// <p>Runs a command remotely on a container within a task.</p>
/// <p>If you use a condition key in your IAM policy to refine the conditions for the policy statement, for example limit the actions to a specific cluster, you receive an <code>AccessDeniedException</code> when there is a mismatch between the condition key value and the corresponding parameter value.</p>
/// <p>For information about required permissions and considerations, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-exec.html">Using Amazon ECS Exec for debugging</a> in the <i>Amazon ECS Developer Guide</i>. </p>
#[derive(::std::clone::Clone, ::std::fmt::Debug)]
pub struct ExecuteCommandFluentBuilder {
handle: ::std::sync::Arc<crate::client::Handle>,
inner: crate::operation::execute_command::builders::ExecuteCommandInputBuilder,
}
impl ExecuteCommandFluentBuilder {
/// Creates a new `ExecuteCommand`.
pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
Self {
handle,
inner: ::std::default::Default::default(),
}
}
// This function will go away in the near future. Do not rely on it.
#[doc(hidden)]
pub async fn customize_middleware(
self,
) -> ::std::result::Result<
crate::client::customize::CustomizableOperation<
crate::operation::execute_command::ExecuteCommand,
::aws_http::retry::AwsResponseRetryClassifier,
>,
::aws_smithy_http::result::SdkError<crate::operation::execute_command::ExecuteCommandError>,
> {
let handle = self.handle.clone();
let operation = self
.inner
.build()
.map_err(::aws_smithy_http::result::SdkError::construction_failure)?
.make_operation(&handle.conf)
.await
.map_err(::aws_smithy_http::result::SdkError::construction_failure)?;
::std::result::Result::Ok(crate::client::customize::CustomizableOperation {
handle,
operation,
})
}
// This function will go away in the near future. Do not rely on it.
#[doc(hidden)]
pub async fn send_middleware(
self,
) -> ::std::result::Result<
crate::operation::execute_command::ExecuteCommandOutput,
::aws_smithy_http::result::SdkError<crate::operation::execute_command::ExecuteCommandError>,
> {
let op = self
.inner
.build()
.map_err(::aws_smithy_http::result::SdkError::construction_failure)?
.make_operation(&self.handle.conf)
.await
.map_err(::aws_smithy_http::result::SdkError::construction_failure)?;
self.handle.client.call(op).await
}
/// 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](aws_smithy_types::retry::RetryConfig), which can be
/// set when configuring the client.
pub async fn send(
self,
) -> ::std::result::Result<
crate::operation::execute_command::ExecuteCommandOutput,
::aws_smithy_http::result::SdkError<crate::operation::execute_command::ExecuteCommandError>,
> {
self.send_middleware().await
}
/// Consumes this builder, creating a customizable operation that can be modified before being
/// sent. The operation's inner [http::Request] can be modified as well.
pub async fn customize(
self,
) -> ::std::result::Result<
crate::client::customize::CustomizableOperation<
crate::operation::execute_command::ExecuteCommand,
::aws_http::retry::AwsResponseRetryClassifier,
>,
::aws_smithy_http::result::SdkError<crate::operation::execute_command::ExecuteCommandError>,
> {
self.customize_middleware().await
}
/// <p>The Amazon Resource Name (ARN) or short name of the cluster the task is running in. If you do not specify a cluster, the default cluster is assumed.</p>
pub fn cluster(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.cluster(input.into());
self
}
/// <p>The Amazon Resource Name (ARN) or short name of the cluster the task is running in. If you do not specify a cluster, the default cluster is assumed.</p>
pub fn set_cluster(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_cluster(input);
self
}
/// <p>The name of the container to execute the command on. A container name only needs to be specified for tasks containing multiple containers.</p>
pub fn container(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.container(input.into());
self
}
/// <p>The name of the container to execute the command on. A container name only needs to be specified for tasks containing multiple containers.</p>
pub fn set_container(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_container(input);
self
}
/// <p>The command to run on the container.</p>
pub fn command(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.command(input.into());
self
}
/// <p>The command to run on the container.</p>
pub fn set_command(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_command(input);
self
}
/// <p>Use this flag to run your command in interactive mode.</p>
pub fn interactive(mut self, input: bool) -> Self {
self.inner = self.inner.interactive(input);
self
}
/// <p>Use this flag to run your command in interactive mode.</p>
pub fn set_interactive(mut self, input: ::std::option::Option<bool>) -> Self {
self.inner = self.inner.set_interactive(input);
self
}
/// <p>The Amazon Resource Name (ARN) or ID of the task the container is part of.</p>
pub fn task(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.task(input.into());
self
}
/// <p>The Amazon Resource Name (ARN) or ID of the task the container is part of.</p>
pub fn set_task(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_task(input);
self
}
}