get_parameters

SSM.Client.get_parameters(**kwargs)

Get information about one or more parameters by specifying multiple parameter names.

Note

To get information about a single parameter, you can use the GetParameter operation instead.

See also: AWS API Documentation

Request Syntax

response = client.get_parameters(
    Names=[
        'string',
    ],
    WithDecryption=True|False
)

Parameters

• Names (list) --

  [REQUIRED]

  Names of the parameters for which you want to query information.

  To query by parameter label, use "Name": "name:label" . To query by parameter version, use "Name": "name:version" .

  • (string) --
• WithDecryption (boolean) -- Return decrypted secure string value. Return decrypted values for secure string parameters. This flag is ignored for String and StringList parameter types.

Return type

dict

Returns

Response Syntax

{
    'Parameters': [
        {
            'Name': 'string',
            'Type': 'String'|'StringList'|'SecureString',
            'Value': 'string',
            'Version': 123,
            'Selector': 'string',
            'SourceResult': 'string',
            'LastModifiedDate': datetime(2015, 1, 1),
            'ARN': 'string',
            'DataType': 'string'
        },
    ],
    'InvalidParameters': [
        'string',
    ]
}

Response Structure

• (dict) --

  • Parameters (list) --

    A list of details for a parameter.

    • (dict) --

      An Amazon Web Services Systems Manager parameter in Parameter Store.

      • Name (string) --

        The name of the parameter.

      • Type (string) --

        The type of parameter. Valid values include the following: String , StringList , and SecureString .

        Note

        If type is StringList , the system returns a comma-separated string with no spaces between commas in the Value field.

      • Value (string) --

        The parameter value.

        Note

        If type is StringList , the system returns a comma-separated string with no spaces between commas in the Value field.

      • Version (integer) --

        The parameter version.

      • Selector (string) --

        Either the version number or the label used to retrieve the parameter value. Specify selectors by using one of the following formats:

        parameter_name:version

        parameter_name:label

      • SourceResult (string) --

        Applies to parameters that reference information in other Amazon Web Services services. SourceResult is the raw result or response from the source.

      • LastModifiedDate (datetime) --

        Date the parameter was last changed or updated and the parameter version was created.

      • ARN (string) --

        The Amazon Resource Name (ARN) of the parameter.

      • DataType (string) --

        The data type of the parameter, such as text or aws:ec2:image . The default is text .

  • InvalidParameters (list) --

    A list of parameters that aren't formatted correctly or don't run during an execution.

    • (string) --

Exceptions

• SSM.Client.exceptions.InvalidKeyId
• SSM.Client.exceptions.InternalServerError