#[non_exhaustive]pub enum UpdateContainerAgentError {
ClientException(ClientException),
ClusterNotFoundException(ClusterNotFoundException),
InvalidParameterException(InvalidParameterException),
MissingVersionException(MissingVersionException),
NoUpdateAvailableException(NoUpdateAvailableException),
ServerException(ServerException),
UpdateInProgressException(UpdateInProgressException),
Unhandled(Unhandled),
}
Expand description
Error type for the UpdateContainerAgentError
operation.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
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.
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)
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§
source§impl UpdateContainerAgentError
impl UpdateContainerAgentError
sourcepub fn unhandled(err: impl Into<Box<dyn Error + Send + Sync + 'static>>) -> Self
pub fn unhandled(err: impl Into<Box<dyn Error + Send + Sync + 'static>>) -> Self
Creates the UpdateContainerAgentError::Unhandled
variant from any error type.
sourcepub fn generic(err: ErrorMetadata) -> Self
pub fn generic(err: ErrorMetadata) -> Self
Creates the UpdateContainerAgentError::Unhandled
variant from an ErrorMetadata
.
sourcepub fn meta(&self) -> &ErrorMetadata
pub fn meta(&self) -> &ErrorMetadata
Returns error metadata, which includes the error code, message, request ID, and potentially additional information.
sourcepub fn is_client_exception(&self) -> bool
pub fn is_client_exception(&self) -> bool
Returns true
if the error kind is UpdateContainerAgentError::ClientException
.
sourcepub fn is_cluster_not_found_exception(&self) -> bool
pub fn is_cluster_not_found_exception(&self) -> bool
Returns true
if the error kind is UpdateContainerAgentError::ClusterNotFoundException
.
sourcepub fn is_invalid_parameter_exception(&self) -> bool
pub fn is_invalid_parameter_exception(&self) -> bool
Returns true
if the error kind is UpdateContainerAgentError::InvalidParameterException
.
sourcepub fn is_missing_version_exception(&self) -> bool
pub fn is_missing_version_exception(&self) -> bool
Returns true
if the error kind is UpdateContainerAgentError::MissingVersionException
.
sourcepub fn is_no_update_available_exception(&self) -> bool
pub fn is_no_update_available_exception(&self) -> bool
Returns true
if the error kind is UpdateContainerAgentError::NoUpdateAvailableException
.
sourcepub fn is_server_exception(&self) -> bool
pub fn is_server_exception(&self) -> bool
Returns true
if the error kind is UpdateContainerAgentError::ServerException
.
sourcepub fn is_update_in_progress_exception(&self) -> bool
pub fn is_update_in_progress_exception(&self) -> bool
Returns true
if the error kind is UpdateContainerAgentError::UpdateInProgressException
.
Trait Implementations§
source§impl CreateUnhandledError for UpdateContainerAgentError
impl CreateUnhandledError for UpdateContainerAgentError
source§fn create_unhandled_error(
source: Box<dyn Error + Send + Sync + 'static>,
meta: Option<ErrorMetadata>
) -> Self
fn create_unhandled_error( source: Box<dyn Error + Send + Sync + 'static>, meta: Option<ErrorMetadata> ) -> Self
source
and error metadata.source§impl Debug for UpdateContainerAgentError
impl Debug for UpdateContainerAgentError
source§impl Display for UpdateContainerAgentError
impl Display for UpdateContainerAgentError
source§impl Error for UpdateContainerAgentError
impl Error for UpdateContainerAgentError
source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
1.0.0 · source§fn description(&self) -> &str
fn description(&self) -> &str
source§impl From<UpdateContainerAgentError> for Error
impl From<UpdateContainerAgentError> for Error
source§fn from(err: UpdateContainerAgentError) -> Self
fn from(err: UpdateContainerAgentError) -> Self
source§impl ProvideErrorMetadata for UpdateContainerAgentError
impl ProvideErrorMetadata for UpdateContainerAgentError
source§fn meta(&self) -> &ErrorMetadata
fn meta(&self) -> &ErrorMetadata
source§impl RequestId for UpdateContainerAgentError
impl RequestId for UpdateContainerAgentError
source§fn request_id(&self) -> Option<&str>
fn request_id(&self) -> Option<&str>
None
if the service could not be reached.