aws-sdk-ssm 1.133.0

AWS SDK for Amazon Simple Systems Manager (SSM)
Documentation
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
#[allow(missing_docs)] // documentation missing in model
#[non_exhaustive]
#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::fmt::Debug)]
pub struct DescribeParametersInput {
    /// <p>This data type is deprecated. Instead, use <code>ParameterFilters</code>.</p>
    pub filters: ::std::option::Option<::std::vec::Vec<crate::types::ParametersFilter>>,
    /// <p>Filters to limit the request results.</p>
    pub parameter_filters: ::std::option::Option<::std::vec::Vec<crate::types::ParameterStringFilter>>,
    /// <p>The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.</p>
    pub max_results: ::std::option::Option<i32>,
    /// <p>The token for the next set of items to return. (You received this token from a previous call.)</p>
    pub next_token: ::std::option::Option<::std::string::String>,
    /// <p>Lists parameters that are shared with you.</p><note>
    /// <p>By default when using this option, the command returns parameters that have been shared using a standard Resource Access Manager Resource Share. In order for a parameter that was shared using the <code>PutResourcePolicy</code> command to be returned, the associated <code>RAM Resource Share Created From Policy</code> must have been promoted to a standard Resource Share using the RAM <a href="https://docs.aws.amazon.com/ram/latest/APIReference/API_PromoteResourceShareCreatedFromPolicy.html">PromoteResourceShareCreatedFromPolicy</a> API operation.</p>
    /// <p>For more information about sharing parameters, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html">Working with shared parameters</a> in the <i>Amazon Web Services Systems Manager User Guide</i>.</p>
    /// </note>
    pub shared: ::std::option::Option<bool>,
}
impl DescribeParametersInput {
    /// <p>This data type is deprecated. Instead, use <code>ParameterFilters</code>.</p>
    ///
    /// If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use `.filters.is_none()`.
    pub fn filters(&self) -> &[crate::types::ParametersFilter] {
        self.filters.as_deref().unwrap_or_default()
    }
    /// <p>Filters to limit the request results.</p>
    ///
    /// If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use `.parameter_filters.is_none()`.
    pub fn parameter_filters(&self) -> &[crate::types::ParameterStringFilter] {
        self.parameter_filters.as_deref().unwrap_or_default()
    }
    /// <p>The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.</p>
    pub fn max_results(&self) -> ::std::option::Option<i32> {
        self.max_results
    }
    /// <p>The token for the next set of items to return. (You received this token from a previous call.)</p>
    pub fn next_token(&self) -> ::std::option::Option<&str> {
        self.next_token.as_deref()
    }
    /// <p>Lists parameters that are shared with you.</p><note>
    /// <p>By default when using this option, the command returns parameters that have been shared using a standard Resource Access Manager Resource Share. In order for a parameter that was shared using the <code>PutResourcePolicy</code> command to be returned, the associated <code>RAM Resource Share Created From Policy</code> must have been promoted to a standard Resource Share using the RAM <a href="https://docs.aws.amazon.com/ram/latest/APIReference/API_PromoteResourceShareCreatedFromPolicy.html">PromoteResourceShareCreatedFromPolicy</a> API operation.</p>
    /// <p>For more information about sharing parameters, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html">Working with shared parameters</a> in the <i>Amazon Web Services Systems Manager User Guide</i>.</p>
    /// </note>
    pub fn shared(&self) -> ::std::option::Option<bool> {
        self.shared
    }
}
static DESCRIBEPARAMETERSINPUT_MEMBER_FILTERS_MEMBER: ::aws_smithy_schema::Schema<'static> = ::aws_smithy_schema::Schema::new_member(
    ::aws_smithy_schema::ShapeId::from_parts(
        "com.amazonaws.ssm#ParametersFilterList$member",
        "com.amazonaws.ssm",
        "ParametersFilterList",
    ),
    ::aws_smithy_schema::ShapeType::Structure,
    "member",
    0,
);
static DESCRIBEPARAMETERSINPUT_MEMBER_FILTERS: ::aws_smithy_schema::Schema<'static> = ::aws_smithy_schema::Schema::new_member(
    ::aws_smithy_schema::ShapeId::from_parts(
        "com.amazonaws.ssm.synthetic#DescribeParametersInput$Filters",
        "com.amazonaws.ssm.synthetic",
        "DescribeParametersInput",
    ),
    ::aws_smithy_schema::ShapeType::List,
    "Filters",
    0,
)
.with_list_member(&DESCRIBEPARAMETERSINPUT_MEMBER_FILTERS_MEMBER);
static DESCRIBEPARAMETERSINPUT_MEMBER_PARAMETER_FILTERS_MEMBER: ::aws_smithy_schema::Schema<'static> = ::aws_smithy_schema::Schema::new_member(
    ::aws_smithy_schema::ShapeId::from_parts(
        "com.amazonaws.ssm#ParameterStringFilterList$member",
        "com.amazonaws.ssm",
        "ParameterStringFilterList",
    ),
    ::aws_smithy_schema::ShapeType::Structure,
    "member",
    0,
);
static DESCRIBEPARAMETERSINPUT_MEMBER_PARAMETER_FILTERS: ::aws_smithy_schema::Schema<'static> = ::aws_smithy_schema::Schema::new_member(
    ::aws_smithy_schema::ShapeId::from_parts(
        "com.amazonaws.ssm.synthetic#DescribeParametersInput$ParameterFilters",
        "com.amazonaws.ssm.synthetic",
        "DescribeParametersInput",
    ),
    ::aws_smithy_schema::ShapeType::List,
    "ParameterFilters",
    1,
)
.with_list_member(&DESCRIBEPARAMETERSINPUT_MEMBER_PARAMETER_FILTERS_MEMBER);
static DESCRIBEPARAMETERSINPUT_MEMBER_MAX_RESULTS: ::aws_smithy_schema::Schema<'static> = ::aws_smithy_schema::Schema::new_member(
    ::aws_smithy_schema::ShapeId::from_parts(
        "com.amazonaws.ssm.synthetic#DescribeParametersInput$MaxResults",
        "com.amazonaws.ssm.synthetic",
        "DescribeParametersInput",
    ),
    ::aws_smithy_schema::ShapeType::Integer,
    "MaxResults",
    2,
);
static DESCRIBEPARAMETERSINPUT_MEMBER_NEXT_TOKEN: ::aws_smithy_schema::Schema<'static> = ::aws_smithy_schema::Schema::new_member(
    ::aws_smithy_schema::ShapeId::from_parts(
        "com.amazonaws.ssm.synthetic#DescribeParametersInput$NextToken",
        "com.amazonaws.ssm.synthetic",
        "DescribeParametersInput",
    ),
    ::aws_smithy_schema::ShapeType::String,
    "NextToken",
    3,
);
static DESCRIBEPARAMETERSINPUT_MEMBER_SHARED: ::aws_smithy_schema::Schema<'static> = ::aws_smithy_schema::Schema::new_member(
    ::aws_smithy_schema::ShapeId::from_parts(
        "com.amazonaws.ssm.synthetic#DescribeParametersInput$Shared",
        "com.amazonaws.ssm.synthetic",
        "DescribeParametersInput",
    ),
    ::aws_smithy_schema::ShapeType::Boolean,
    "Shared",
    4,
);
static DESCRIBEPARAMETERSINPUT_SCHEMA: ::aws_smithy_schema::Schema<'static> = ::aws_smithy_schema::Schema::new_struct(
    ::aws_smithy_schema::ShapeId::from_parts(
        "com.amazonaws.ssm.synthetic#DescribeParametersInput",
        "com.amazonaws.ssm.synthetic",
        "DescribeParametersInput",
    ),
    ::aws_smithy_schema::ShapeType::Structure,
    &[
        &DESCRIBEPARAMETERSINPUT_MEMBER_FILTERS,
        &DESCRIBEPARAMETERSINPUT_MEMBER_PARAMETER_FILTERS,
        &DESCRIBEPARAMETERSINPUT_MEMBER_MAX_RESULTS,
        &DESCRIBEPARAMETERSINPUT_MEMBER_NEXT_TOKEN,
        &DESCRIBEPARAMETERSINPUT_MEMBER_SHARED,
    ],
)
.with_payload_hint(::aws_smithy_schema::PayloadHint::NoStructPayload)
.with_original_name("DescribeParametersRequest");
impl DescribeParametersInput {
    /// The schema for this shape.
    pub const SCHEMA: &'static ::aws_smithy_schema::Schema<'static> = &DESCRIBEPARAMETERSINPUT_SCHEMA;
}
impl ::aws_smithy_schema::serde::SerializableStruct for DescribeParametersInput {
    fn schema(&self) -> &::aws_smithy_schema::Schema<'_> {
        Self::SCHEMA
    }

    #[allow(unused_variables, clippy::diverging_sub_expression)]
    fn serialize_members(
        &self,
        ser: &mut dyn ::aws_smithy_schema::serde::ShapeSerializer,
    ) -> ::std::result::Result<(), ::aws_smithy_schema::serde::SerdeError> {
        if let Some(ref val) = self.filters {
            ser.write_list(
                &DESCRIBEPARAMETERSINPUT_MEMBER_FILTERS,
                &|ser: &mut dyn ::aws_smithy_schema::serde::ShapeSerializer| {
                    for item in val {
                        ser.write_struct(crate::types::ParametersFilter::SCHEMA, item)?;
                    }
                    Ok(())
                },
            )?;
        }
        if let Some(ref val) = self.parameter_filters {
            ser.write_list(
                &DESCRIBEPARAMETERSINPUT_MEMBER_PARAMETER_FILTERS,
                &|ser: &mut dyn ::aws_smithy_schema::serde::ShapeSerializer| {
                    for item in val {
                        ser.write_struct(crate::types::ParameterStringFilter::SCHEMA, item)?;
                    }
                    Ok(())
                },
            )?;
        }
        if let Some(ref val) = self.max_results {
            ser.write_integer(&DESCRIBEPARAMETERSINPUT_MEMBER_MAX_RESULTS, *val)?;
        }
        if let Some(ref val) = self.next_token {
            ser.write_string(&DESCRIBEPARAMETERSINPUT_MEMBER_NEXT_TOKEN, val)?;
        }
        if let Some(ref val) = self.shared {
            ser.write_boolean(&DESCRIBEPARAMETERSINPUT_MEMBER_SHARED, *val)?;
        }
        Ok(())
    }
}
impl crate::operation::describe_parameters::builders::DescribeParametersInputBuilder {
    #[allow(
        unused_variables,
        unreachable_code,
        clippy::single_match,
        clippy::match_single_binding,
        clippy::diverging_sub_expression
    )]
    pub(crate) fn deserialize_members(
        &mut self,
        deserializer: &mut dyn ::aws_smithy_schema::serde::ShapeDeserializer,
    ) -> ::std::result::Result<(), ::aws_smithy_schema::serde::SerdeError> {
        deserializer.read_struct(&DESCRIBEPARAMETERSINPUT_SCHEMA, &mut |member, deser| {
            match member.member_index() {
                Some(0) => {
                    if deser.is_null() {
                        deser.read_null()?;
                    } else {
                        self.filters = Some({
                            let mut container = Vec::new();
                            deser.read_list(member, &mut |deser| {
                                container.push(crate::types::ParametersFilter::deserialize(deser)?);
                                Ok(())
                            })?;
                            container
                        });
                    }
                }
                Some(1) => {
                    if deser.is_null() {
                        deser.read_null()?;
                    } else {
                        self.parameter_filters = Some({
                            let mut container = Vec::new();
                            deser.read_list(member, &mut |deser| {
                                container.push(crate::types::ParameterStringFilter::deserialize(deser)?);
                                Ok(())
                            })?;
                            container
                        });
                    }
                }
                Some(2) => {
                    if deser.is_null() {
                        deser.read_null()?;
                    } else {
                        self.max_results = Some(deser.read_integer(member)?);
                    }
                }
                Some(3) => {
                    if deser.is_null() {
                        deser.read_null()?;
                    } else {
                        self.next_token = Some(deser.read_string(member)?);
                    }
                }
                Some(4) => {
                    if deser.is_null() {
                        deser.read_null()?;
                    } else {
                        self.shared = Some(deser.read_boolean(member)?);
                    }
                }
                _ => {}
            }
            Ok(())
        })
    }
}

impl DescribeParametersInput {
    /// Deserializes this structure from a [`ShapeDeserializer`].
    pub fn deserialize(
        deserializer: &mut dyn ::aws_smithy_schema::serde::ShapeDeserializer,
    ) -> ::std::result::Result<Self, ::aws_smithy_schema::serde::SerdeError> {
        let mut builder = Self::builder();
        builder.deserialize_members(deserializer)?;
        builder.build().map_err(|e| aws_smithy_schema::serde::SerdeError::custom(e.to_string()))
    }
}
impl DescribeParametersInput {
    /// Creates a new builder-style object to manufacture [`DescribeParametersInput`](crate::operation::describe_parameters::DescribeParametersInput).
    pub fn builder() -> crate::operation::describe_parameters::builders::DescribeParametersInputBuilder {
        crate::operation::describe_parameters::builders::DescribeParametersInputBuilder::default()
    }
}

/// A builder for [`DescribeParametersInput`](crate::operation::describe_parameters::DescribeParametersInput).
#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::default::Default, ::std::fmt::Debug)]
#[non_exhaustive]
pub struct DescribeParametersInputBuilder {
    pub(crate) filters: ::std::option::Option<::std::vec::Vec<crate::types::ParametersFilter>>,
    pub(crate) parameter_filters: ::std::option::Option<::std::vec::Vec<crate::types::ParameterStringFilter>>,
    pub(crate) max_results: ::std::option::Option<i32>,
    pub(crate) next_token: ::std::option::Option<::std::string::String>,
    pub(crate) shared: ::std::option::Option<bool>,
}
impl DescribeParametersInputBuilder {
    /// Appends an item to `filters`.
    ///
    /// To override the contents of this collection use [`set_filters`](Self::set_filters).
    ///
    /// <p>This data type is deprecated. Instead, use <code>ParameterFilters</code>.</p>
    pub fn filters(mut self, input: crate::types::ParametersFilter) -> Self {
        let mut v = self.filters.unwrap_or_default();
        v.push(input);
        self.filters = ::std::option::Option::Some(v);
        self
    }
    /// <p>This data type is deprecated. Instead, use <code>ParameterFilters</code>.</p>
    pub fn set_filters(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::ParametersFilter>>) -> Self {
        self.filters = input;
        self
    }
    /// <p>This data type is deprecated. Instead, use <code>ParameterFilters</code>.</p>
    pub fn get_filters(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::ParametersFilter>> {
        &self.filters
    }
    /// Appends an item to `parameter_filters`.
    ///
    /// To override the contents of this collection use [`set_parameter_filters`](Self::set_parameter_filters).
    ///
    /// <p>Filters to limit the request results.</p>
    pub fn parameter_filters(mut self, input: crate::types::ParameterStringFilter) -> Self {
        let mut v = self.parameter_filters.unwrap_or_default();
        v.push(input);
        self.parameter_filters = ::std::option::Option::Some(v);
        self
    }
    /// <p>Filters to limit the request results.</p>
    pub fn set_parameter_filters(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::ParameterStringFilter>>) -> Self {
        self.parameter_filters = input;
        self
    }
    /// <p>Filters to limit the request results.</p>
    pub fn get_parameter_filters(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::ParameterStringFilter>> {
        &self.parameter_filters
    }
    /// <p>The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.</p>
    pub fn max_results(mut self, input: i32) -> Self {
        self.max_results = ::std::option::Option::Some(input);
        self
    }
    /// <p>The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.</p>
    pub fn set_max_results(mut self, input: ::std::option::Option<i32>) -> Self {
        self.max_results = input;
        self
    }
    /// <p>The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.</p>
    pub fn get_max_results(&self) -> &::std::option::Option<i32> {
        &self.max_results
    }
    /// <p>The token for the next set of items to return. (You received this token from a previous call.)</p>
    pub fn next_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
        self.next_token = ::std::option::Option::Some(input.into());
        self
    }
    /// <p>The token for the next set of items to return. (You received this token from a previous call.)</p>
    pub fn set_next_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
        self.next_token = input;
        self
    }
    /// <p>The token for the next set of items to return. (You received this token from a previous call.)</p>
    pub fn get_next_token(&self) -> &::std::option::Option<::std::string::String> {
        &self.next_token
    }
    /// <p>Lists parameters that are shared with you.</p><note>
    /// <p>By default when using this option, the command returns parameters that have been shared using a standard Resource Access Manager Resource Share. In order for a parameter that was shared using the <code>PutResourcePolicy</code> command to be returned, the associated <code>RAM Resource Share Created From Policy</code> must have been promoted to a standard Resource Share using the RAM <a href="https://docs.aws.amazon.com/ram/latest/APIReference/API_PromoteResourceShareCreatedFromPolicy.html">PromoteResourceShareCreatedFromPolicy</a> API operation.</p>
    /// <p>For more information about sharing parameters, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html">Working with shared parameters</a> in the <i>Amazon Web Services Systems Manager User Guide</i>.</p>
    /// </note>
    pub fn shared(mut self, input: bool) -> Self {
        self.shared = ::std::option::Option::Some(input);
        self
    }
    /// <p>Lists parameters that are shared with you.</p><note>
    /// <p>By default when using this option, the command returns parameters that have been shared using a standard Resource Access Manager Resource Share. In order for a parameter that was shared using the <code>PutResourcePolicy</code> command to be returned, the associated <code>RAM Resource Share Created From Policy</code> must have been promoted to a standard Resource Share using the RAM <a href="https://docs.aws.amazon.com/ram/latest/APIReference/API_PromoteResourceShareCreatedFromPolicy.html">PromoteResourceShareCreatedFromPolicy</a> API operation.</p>
    /// <p>For more information about sharing parameters, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html">Working with shared parameters</a> in the <i>Amazon Web Services Systems Manager User Guide</i>.</p>
    /// </note>
    pub fn set_shared(mut self, input: ::std::option::Option<bool>) -> Self {
        self.shared = input;
        self
    }
    /// <p>Lists parameters that are shared with you.</p><note>
    /// <p>By default when using this option, the command returns parameters that have been shared using a standard Resource Access Manager Resource Share. In order for a parameter that was shared using the <code>PutResourcePolicy</code> command to be returned, the associated <code>RAM Resource Share Created From Policy</code> must have been promoted to a standard Resource Share using the RAM <a href="https://docs.aws.amazon.com/ram/latest/APIReference/API_PromoteResourceShareCreatedFromPolicy.html">PromoteResourceShareCreatedFromPolicy</a> API operation.</p>
    /// <p>For more information about sharing parameters, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html">Working with shared parameters</a> in the <i>Amazon Web Services Systems Manager User Guide</i>.</p>
    /// </note>
    pub fn get_shared(&self) -> &::std::option::Option<bool> {
        &self.shared
    }
    /// Consumes the builder and constructs a [`DescribeParametersInput`](crate::operation::describe_parameters::DescribeParametersInput).
    pub fn build(
        self,
    ) -> ::std::result::Result<crate::operation::describe_parameters::DescribeParametersInput, ::aws_smithy_types::error::operation::BuildError> {
        ::std::result::Result::Ok(crate::operation::describe_parameters::DescribeParametersInput {
            filters: self.filters,
            parameter_filters: self.parameter_filters,
            max_results: self.max_results,
            next_token: self.next_token,
            shared: self.shared,
        })
    }
}