Enum UpdateContainerAgentError

#[non_exhaustive]
pub enum UpdateContainerAgentError {
    ClientException(ClientException),
    ClusterNotFoundException(ClusterNotFoundException),
    InvalidParameterException(InvalidParameterException),
    MissingVersionException(MissingVersionException),
    NoUpdateAvailableException(NoUpdateAvailableException),
    ServerException(ServerException),
    UpdateInProgressException(UpdateInProgressException),
    Unhandled(Unhandled),
}

Error type for the UpdateContainerAgentError operation.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ClientException(ClientException)

These errors are usually caused by a client action. This client action might be using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Or, it might be specifying an identifier that isn't valid.

ClusterNotFoundException(ClusterNotFoundException)

The specified cluster wasn't found. You can view your available clusters with ListClusters. Amazon ECS clusters are Region specific.

InvalidParameterException(InvalidParameterException)

The specified parameter isn't valid. Review the available parameters for the API request.

For more information about service event errors, see Amazon ECS service event messages.

MissingVersionException(MissingVersionException)

Amazon ECS can't determine the current version of the Amazon ECS container agent on the container instance and doesn't have enough information to proceed with an update. This could be because the agent running on the container instance is a previous or custom version that doesn't use our version information.

NoUpdateAvailableException(NoUpdateAvailableException)

There's no update available for this Amazon ECS container agent. This might be because the agent is already running the latest version or because it's so old that there's no update path to the current version.

ServerException(ServerException)

These errors are usually caused by a server issue.

UpdateInProgressException(UpdateInProgressException)

There's already a current Amazon ECS container agent update in progress on the container instance that's specified. If the container agent becomes disconnected while it's in a transitional stage, such as PENDING or STAGING, the update process can get stuck in that state. However, when the agent reconnects, it resumes where it stopped previously.

Unhandled(Unhandled)

👎Deprecated: Matching Unhandled directly is not forwards compatible. Instead, match using a variable wildcard pattern and check .code():    err if err.code() == Some("SpecificExceptionCode") => { /* handle the error */ } See ProvideErrorMetadata for what information is available for the error.

An unexpected error occurred (e.g., invalid JSON returned by the service or an unknown error code).

Implementations

impl UpdateContainerAgentError

pub fn unhandled(err: impl Into<Box<dyn Error + Send + Sync + 'static>>) -> Self

Creates the UpdateContainerAgentError::Unhandled variant from any error type.

pub fn generic(err: ErrorMetadata) -> Self

Creates the UpdateContainerAgentError::Unhandled variant from an ErrorMetadata.

pub fn meta(&self) -> &ErrorMetadata

Returns error metadata, which includes the error code, message, request ID, and potentially additional information.

pub fn is_client_exception(&self) -> bool

Returns true if the error kind is UpdateContainerAgentError::ClientException.

pub fn is_cluster_not_found_exception(&self) -> bool

Returns true if the error kind is UpdateContainerAgentError::ClusterNotFoundException.

pub fn is_invalid_parameter_exception(&self) -> bool

Returns true if the error kind is UpdateContainerAgentError::InvalidParameterException.

pub fn is_missing_version_exception(&self) -> bool

Returns true if the error kind is UpdateContainerAgentError::MissingVersionException.

pub fn is_no_update_available_exception(&self) -> bool

Returns true if the error kind is UpdateContainerAgentError::NoUpdateAvailableException.

pub fn is_server_exception(&self) -> bool

Returns true if the error kind is UpdateContainerAgentError::ServerException.

pub fn is_update_in_progress_exception(&self) -> bool

Returns true if the error kind is UpdateContainerAgentError::UpdateInProgressException.

Trait Implementations

impl CreateUnhandledError for UpdateContainerAgentError

fn create_unhandled_error( source: Box<dyn Error + Send + Sync + 'static>, meta: Option<ErrorMetadata>, ) -> Self

Creates an unhandled error variant with the given source and error metadata.

impl Debug for UpdateContainerAgentError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for UpdateContainerAgentError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for UpdateContainerAgentError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<UpdateContainerAgentError> for Error

fn from(err: UpdateContainerAgentError) -> Self

Converts to this type from the input type.

impl ProvideErrorKind for UpdateContainerAgentError

fn code(&self) -> Option<&str>

Returns the code for this error if one exists

fn retryable_error_kind(&self) -> Option<ErrorKind>

Returns the ErrorKind when the error is modeled as retryable

impl ProvideErrorMetadata for UpdateContainerAgentError

fn meta(&self) -> &ErrorMetadata

Returns error metadata, which includes the error code, message, request ID, and potentially additional information.

fn code(&self) -> Option<&str>

Returns the error code if it’s available.

fn message(&self) -> Option<&str>

Returns the error message, if there is one.

impl RequestId for UpdateContainerAgentError

fn request_id(&self) -> Option<&str>

Returns the request ID, or None if the service could not be reached.