// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::register_instance::_register_instance_output::RegisterInstanceOutputBuilder;
pub use crate::operation::register_instance::_register_instance_input::RegisterInstanceInputBuilder;
impl crate::operation::register_instance::builders::RegisterInstanceInputBuilder {
/// Sends a request with this input using the given client.
pub async fn send_with(
self,
client: &crate::Client,
) -> ::std::result::Result<
crate::operation::register_instance::RegisterInstanceOutput,
::aws_smithy_runtime_api::client::result::SdkError<
crate::operation::register_instance::RegisterInstanceError,
::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
>,
> {
let mut fluent_builder = client.register_instance();
fluent_builder.inner = self;
fluent_builder.send().await
}
}
/// Fluent builder constructing a request to `RegisterInstance`.
///
/// <p>Registers instances that were created outside of OpsWorks Stacks with a specified stack.</p><note>
/// <p>We do not recommend using this action to register instances. The complete registration operation includes two tasks: installing the OpsWorks Stacks agent on the instance, and registering the instance with the stack. <code>RegisterInstance</code> handles only the second step. You should instead use the CLI <code>register</code> command, which performs the entire registration operation. For more information, see <a href="https://docs.aws.amazon.com/opsworks/latest/userguide/registered-instances-register.html"> Registering an Instance with an OpsWorks Stacks Stack</a>.</p>
/// </note>
/// <p>Registered instances have the same requirements as instances that are created by using the <code>CreateInstance</code> API. For example, registered instances must be running a supported Linux-based operating system, and they must have a supported instance type. For more information about requirements for instances that you want to register, see <a href="https://docs.aws.amazon.com/opsworks/latest/userguide/registered-instances-register-registering-preparer.html"> Preparing the Instance</a>.</p>
/// <p><b>Required Permissions</b>: To use this action, an IAM user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information on user permissions, see <a href="https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html">Managing User Permissions</a>.</p>
#[derive(::std::clone::Clone, ::std::fmt::Debug)]
pub struct RegisterInstanceFluentBuilder {
handle: ::std::sync::Arc<crate::client::Handle>,
inner: crate::operation::register_instance::builders::RegisterInstanceInputBuilder,
config_override: ::std::option::Option<crate::config::Builder>,
}
impl
crate::client::customize::internal::CustomizableSend<
crate::operation::register_instance::RegisterInstanceOutput,
crate::operation::register_instance::RegisterInstanceError,
> for RegisterInstanceFluentBuilder
{
fn send(
self,
config_override: crate::config::Builder,
) -> crate::client::customize::internal::BoxFuture<
crate::client::customize::internal::SendResult<
crate::operation::register_instance::RegisterInstanceOutput,
crate::operation::register_instance::RegisterInstanceError,
>,
> {
::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
}
}
impl RegisterInstanceFluentBuilder {
/// Creates a new `RegisterInstanceFluentBuilder`.
pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
Self {
handle,
inner: ::std::default::Default::default(),
config_override: ::std::option::Option::None,
}
}
/// Access the RegisterInstance as a reference.
pub fn as_input(&self) -> &crate::operation::register_instance::builders::RegisterInstanceInputBuilder {
&self.inner
}
/// 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::register_instance::RegisterInstanceOutput,
::aws_smithy_runtime_api::client::result::SdkError<
crate::operation::register_instance::RegisterInstanceError,
::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
>,
> {
let input = self
.inner
.build()
.map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
let runtime_plugins = crate::operation::register_instance::RegisterInstance::operation_runtime_plugins(
self.handle.runtime_plugins.clone(),
&self.handle.conf,
self.config_override,
);
crate::operation::register_instance::RegisterInstance::orchestrate(&runtime_plugins, input).await
}
/// Consumes this builder, creating a customizable operation that can be modified before being sent.
pub fn customize(
self,
) -> crate::client::customize::CustomizableOperation<
crate::operation::register_instance::RegisterInstanceOutput,
crate::operation::register_instance::RegisterInstanceError,
Self,
> {
crate::client::customize::CustomizableOperation::new(self)
}
pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
self.set_config_override(::std::option::Option::Some(config_override.into()));
self
}
pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
self.config_override = config_override;
self
}
/// <p>The ID of the stack that the instance is to be registered with.</p>
pub fn stack_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.stack_id(input.into());
self
}
/// <p>The ID of the stack that the instance is to be registered with.</p>
pub fn set_stack_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_stack_id(input);
self
}
/// <p>The ID of the stack that the instance is to be registered with.</p>
pub fn get_stack_id(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_stack_id()
}
/// <p>The instance's host name. The following are character limits for instance host names.</p>
/// <ul>
/// <li>
/// <p>Linux-based instances: 63 characters</p></li>
/// <li>
/// <p>Windows-based instances: 15 characters</p></li>
/// </ul>
pub fn hostname(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.hostname(input.into());
self
}
/// <p>The instance's host name. The following are character limits for instance host names.</p>
/// <ul>
/// <li>
/// <p>Linux-based instances: 63 characters</p></li>
/// <li>
/// <p>Windows-based instances: 15 characters</p></li>
/// </ul>
pub fn set_hostname(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_hostname(input);
self
}
/// <p>The instance's host name. The following are character limits for instance host names.</p>
/// <ul>
/// <li>
/// <p>Linux-based instances: 63 characters</p></li>
/// <li>
/// <p>Windows-based instances: 15 characters</p></li>
/// </ul>
pub fn get_hostname(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_hostname()
}
/// <p>The instance's public IP address.</p>
pub fn public_ip(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.public_ip(input.into());
self
}
/// <p>The instance's public IP address.</p>
pub fn set_public_ip(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_public_ip(input);
self
}
/// <p>The instance's public IP address.</p>
pub fn get_public_ip(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_public_ip()
}
/// <p>The instance's private IP address.</p>
pub fn private_ip(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.private_ip(input.into());
self
}
/// <p>The instance's private IP address.</p>
pub fn set_private_ip(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_private_ip(input);
self
}
/// <p>The instance's private IP address.</p>
pub fn get_private_ip(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_private_ip()
}
/// <p>The instances public RSA key. This key is used to encrypt communication between the instance and the service.</p>
pub fn rsa_public_key(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.rsa_public_key(input.into());
self
}
/// <p>The instances public RSA key. This key is used to encrypt communication between the instance and the service.</p>
pub fn set_rsa_public_key(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_rsa_public_key(input);
self
}
/// <p>The instances public RSA key. This key is used to encrypt communication between the instance and the service.</p>
pub fn get_rsa_public_key(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_rsa_public_key()
}
/// <p>The instances public RSA key fingerprint.</p>
pub fn rsa_public_key_fingerprint(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.rsa_public_key_fingerprint(input.into());
self
}
/// <p>The instances public RSA key fingerprint.</p>
pub fn set_rsa_public_key_fingerprint(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_rsa_public_key_fingerprint(input);
self
}
/// <p>The instances public RSA key fingerprint.</p>
pub fn get_rsa_public_key_fingerprint(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_rsa_public_key_fingerprint()
}
/// <p>An InstanceIdentity object that contains the instance's identity.</p>
pub fn instance_identity(mut self, input: crate::types::InstanceIdentity) -> Self {
self.inner = self.inner.instance_identity(input);
self
}
/// <p>An InstanceIdentity object that contains the instance's identity.</p>
pub fn set_instance_identity(mut self, input: ::std::option::Option<crate::types::InstanceIdentity>) -> Self {
self.inner = self.inner.set_instance_identity(input);
self
}
/// <p>An InstanceIdentity object that contains the instance's identity.</p>
pub fn get_instance_identity(&self) -> &::std::option::Option<crate::types::InstanceIdentity> {
self.inner.get_instance_identity()
}
}