get_parameters

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