pub struct RestoreServerFluentBuilder { /* private fields */ }
Expand description
Fluent builder constructing a request to RestoreServer
.
Restores a backup to a server that is in a CONNECTION_LOST
, HEALTHY
, RUNNING
, UNHEALTHY
, or TERMINATED
state. When you run RestoreServer, the server's EC2 instance is deleted, and a new EC2 instance is configured. RestoreServer maintains the existing server endpoint, so configuration management of the server's client devices (nodes) should continue to work.
Restoring from a backup is performed by creating a new EC2 instance. If restoration is successful, and the server is in a HEALTHY
state, AWS OpsWorks CM switches traffic over to the new instance. After restoration is finished, the old EC2 instance is maintained in a Running
or Stopped
state, but is eventually terminated.
This operation is asynchronous.
An InvalidStateException
is thrown when the server is not in a valid state. A ResourceNotFoundException
is thrown when the server does not exist. A ValidationException
is raised when parameters of the request are not valid.
Implementations§
source§impl RestoreServerFluentBuilder
impl RestoreServerFluentBuilder
sourcepub fn as_input(&self) -> &RestoreServerInputBuilder
pub fn as_input(&self) -> &RestoreServerInputBuilder
Access the RestoreServer as a reference.
sourcepub async fn send(
self
) -> Result<RestoreServerOutput, SdkError<RestoreServerError, HttpResponse>>
pub async fn send( self ) -> Result<RestoreServerOutput, SdkError<RestoreServerError, HttpResponse>>
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, which can be set when configuring the client.
sourcepub fn customize(
self
) -> CustomizableOperation<RestoreServerOutput, RestoreServerError, Self>
pub fn customize( self ) -> CustomizableOperation<RestoreServerOutput, RestoreServerError, Self>
Consumes this builder, creating a customizable operation that can be modified before being sent.
sourcepub fn backup_id(self, input: impl Into<String>) -> Self
pub fn backup_id(self, input: impl Into<String>) -> Self
The ID of the backup that you want to use to restore a server.
sourcepub fn set_backup_id(self, input: Option<String>) -> Self
pub fn set_backup_id(self, input: Option<String>) -> Self
The ID of the backup that you want to use to restore a server.
sourcepub fn get_backup_id(&self) -> &Option<String>
pub fn get_backup_id(&self) -> &Option<String>
The ID of the backup that you want to use to restore a server.
sourcepub fn server_name(self, input: impl Into<String>) -> Self
pub fn server_name(self, input: impl Into<String>) -> Self
The name of the server that you want to restore.
sourcepub fn set_server_name(self, input: Option<String>) -> Self
pub fn set_server_name(self, input: Option<String>) -> Self
The name of the server that you want to restore.
sourcepub fn get_server_name(&self) -> &Option<String>
pub fn get_server_name(&self) -> &Option<String>
The name of the server that you want to restore.
sourcepub fn instance_type(self, input: impl Into<String>) -> Self
pub fn instance_type(self, input: impl Into<String>) -> Self
The type of instance to restore. Valid values must be specified in the following format: ^([cm][34]|t2).*
For example, m5.large
. Valid values are m5.large
, r5.xlarge
, and r5.2xlarge
. If you do not specify this parameter, RestoreServer uses the instance type from the specified backup.
sourcepub fn set_instance_type(self, input: Option<String>) -> Self
pub fn set_instance_type(self, input: Option<String>) -> Self
The type of instance to restore. Valid values must be specified in the following format: ^([cm][34]|t2).*
For example, m5.large
. Valid values are m5.large
, r5.xlarge
, and r5.2xlarge
. If you do not specify this parameter, RestoreServer uses the instance type from the specified backup.
sourcepub fn get_instance_type(&self) -> &Option<String>
pub fn get_instance_type(&self) -> &Option<String>
The type of instance to restore. Valid values must be specified in the following format: ^([cm][34]|t2).*
For example, m5.large
. Valid values are m5.large
, r5.xlarge
, and r5.2xlarge
. If you do not specify this parameter, RestoreServer uses the instance type from the specified backup.
sourcepub fn key_pair(self, input: impl Into<String>) -> Self
pub fn key_pair(self, input: impl Into<String>) -> Self
The name of the key pair to set on the new EC2 instance. This can be helpful if the administrator no longer has the SSH key.
sourcepub fn set_key_pair(self, input: Option<String>) -> Self
pub fn set_key_pair(self, input: Option<String>) -> Self
The name of the key pair to set on the new EC2 instance. This can be helpful if the administrator no longer has the SSH key.
sourcepub fn get_key_pair(&self) -> &Option<String>
pub fn get_key_pair(&self) -> &Option<String>
The name of the key pair to set on the new EC2 instance. This can be helpful if the administrator no longer has the SSH key.
Trait Implementations§
source§impl Clone for RestoreServerFluentBuilder
impl Clone for RestoreServerFluentBuilder
source§fn clone(&self) -> RestoreServerFluentBuilder
fn clone(&self) -> RestoreServerFluentBuilder
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreAuto Trait Implementations§
impl Freeze for RestoreServerFluentBuilder
impl !RefUnwindSafe for RestoreServerFluentBuilder
impl Send for RestoreServerFluentBuilder
impl Sync for RestoreServerFluentBuilder
impl Unpin for RestoreServerFluentBuilder
impl !UnwindSafe for RestoreServerFluentBuilder
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more