Enum PutParameterError

#[non_exhaustive]
pub enum PutParameterError {
    HierarchyLevelLimitExceededException(HierarchyLevelLimitExceededException),
    HierarchyTypeMismatchException(HierarchyTypeMismatchException),
    IncompatiblePolicyException(IncompatiblePolicyException),
    InternalServerError(InternalServerError),
    InvalidAllowedPatternException(InvalidAllowedPatternException),
    InvalidKeyId(InvalidKeyId),
    InvalidPolicyAttributeException(InvalidPolicyAttributeException),
    InvalidPolicyTypeException(InvalidPolicyTypeException),
    ParameterAlreadyExists(ParameterAlreadyExists),
    ParameterLimitExceeded(ParameterLimitExceeded),
    ParameterMaxVersionLimitExceeded(ParameterMaxVersionLimitExceeded),
    ParameterPatternMismatchException(ParameterPatternMismatchException),
    PoliciesLimitExceededException(PoliciesLimitExceededException),
    TooManyUpdates(TooManyUpdates),
    UnsupportedParameterType(UnsupportedParameterType),
    Unhandled(Unhandled),
}

Error type for the PutParameterError 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.

HierarchyLevelLimitExceededException(HierarchyLevelLimitExceededException)

A hierarchy can have a maximum of 15 levels. For more information, see Requirements and constraints for parameter names in the Amazon Web Services Systems Manager User Guide.

HierarchyTypeMismatchException(HierarchyTypeMismatchException)

Parameter Store doesn't support changing a parameter type in a hierarchy. For example, you can't change a parameter from a String type to a SecureString type. You must create a new, unique parameter.

IncompatiblePolicyException(IncompatiblePolicyException)

There is a conflict in the policies specified for this parameter. You can't, for example, specify two Expiration policies for a parameter. Review your policies, and try again.

InternalServerError(InternalServerError)

An error occurred on the server side.

InvalidAllowedPatternException(InvalidAllowedPatternException)

The request doesn't meet the regular expression requirement.

InvalidKeyId(InvalidKeyId)

The query key ID isn't valid.

InvalidPolicyAttributeException(InvalidPolicyAttributeException)

A policy attribute or its value is invalid.

InvalidPolicyTypeException(InvalidPolicyTypeException)

The policy type isn't supported. Parameter Store supports the following policy types: Expiration, ExpirationNotification, and NoChangeNotification.

ParameterAlreadyExists(ParameterAlreadyExists)

The parameter already exists. You can't create duplicate parameters.

ParameterLimitExceeded(ParameterLimitExceeded)

You have exceeded the number of parameters for this Amazon Web Services account. Delete one or more parameters and try again.

ParameterMaxVersionLimitExceeded(ParameterMaxVersionLimitExceeded)

Parameter Store retains the 100 most recently created versions of a parameter. After this number of versions has been created, Parameter Store deletes the oldest version when a new one is created. However, if the oldest version has a label attached to it, Parameter Store won't delete the version and instead presents this error message:

An error occurred (ParameterMaxVersionLimitExceeded) when calling the PutParameter operation: You attempted to create a new version of parameter-name by calling the PutParameter API with the overwrite flag. Version version-number, the oldest version, can't be deleted because it has a label associated with it. Move the label to another version of the parameter, and try again.

This safeguard is to prevent parameter versions with mission critical labels assigned to them from being deleted. To continue creating new parameters, first move the label from the oldest version of the parameter to a newer one for use in your operations. For information about moving parameter labels, see Move a parameter label (console) or Move a parameter label (CLI) in the Amazon Web Services Systems Manager User Guide.

ParameterPatternMismatchException(ParameterPatternMismatchException)

The parameter name isn't valid.

PoliciesLimitExceededException(PoliciesLimitExceededException)

You specified more than the maximum number of allowed policies for the parameter. The maximum is 10.

TooManyUpdates(TooManyUpdates)

There are concurrent updates for a resource that supports one update at a time.

UnsupportedParameterType(UnsupportedParameterType)

The parameter type isn't supported.

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 PutParameterError

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

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

pub fn generic(err: ErrorMetadata) -> Self

Creates the PutParameterError::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_hierarchy_level_limit_exceeded_exception(&self) -> bool

Returns true if the error kind is PutParameterError::HierarchyLevelLimitExceededException.

pub fn is_hierarchy_type_mismatch_exception(&self) -> bool

Returns true if the error kind is PutParameterError::HierarchyTypeMismatchException.

pub fn is_incompatible_policy_exception(&self) -> bool

Returns true if the error kind is PutParameterError::IncompatiblePolicyException.

pub fn is_internal_server_error(&self) -> bool

Returns true if the error kind is PutParameterError::InternalServerError.

pub fn is_invalid_allowed_pattern_exception(&self) -> bool

Returns true if the error kind is PutParameterError::InvalidAllowedPatternException.

pub fn is_invalid_key_id(&self) -> bool

Returns true if the error kind is PutParameterError::InvalidKeyId.

pub fn is_invalid_policy_attribute_exception(&self) -> bool

Returns true if the error kind is PutParameterError::InvalidPolicyAttributeException.

pub fn is_invalid_policy_type_exception(&self) -> bool

Returns true if the error kind is PutParameterError::InvalidPolicyTypeException.

pub fn is_parameter_already_exists(&self) -> bool

Returns true if the error kind is PutParameterError::ParameterAlreadyExists.

pub fn is_parameter_limit_exceeded(&self) -> bool

Returns true if the error kind is PutParameterError::ParameterLimitExceeded.

pub fn is_parameter_max_version_limit_exceeded(&self) -> bool

Returns true if the error kind is PutParameterError::ParameterMaxVersionLimitExceeded.

pub fn is_parameter_pattern_mismatch_exception(&self) -> bool

Returns true if the error kind is PutParameterError::ParameterPatternMismatchException.

pub fn is_policies_limit_exceeded_exception(&self) -> bool

Returns true if the error kind is PutParameterError::PoliciesLimitExceededException.

pub fn is_too_many_updates(&self) -> bool

Returns true if the error kind is PutParameterError::TooManyUpdates.

pub fn is_unsupported_parameter_type(&self) -> bool

Returns true if the error kind is PutParameterError::UnsupportedParameterType.

Trait Implementations

impl CreateUnhandledError for PutParameterError

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 PutParameterError

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

Formats the value using the given formatter.

impl Display for PutParameterError

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

Formats the value using the given formatter.

impl Error for PutParameterError

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<PutParameterError> for Error

fn from(err: PutParameterError) -> Self

Converts to this type from the input type.

impl ProvideErrorKind for PutParameterError

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 PutParameterError

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 PutParameterError

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

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