list_configurations

list_configurations(**kwargs)

Retrieves a list of configuration items as specified by the value passed to the required parameter configurationType . Optional filtering may be applied to refine search results.

See also: AWS API Documentation

Request Syntax

response = client.list_configurations(
    configurationType='SERVER'|'PROCESS'|'CONNECTION'|'APPLICATION',
    filters=[
        {
            'name': 'string',
            'values': [
                'string',
            ],
            'condition': 'string'
        },
    ],
    maxResults=123,
    nextToken='string',
    orderBy=[
        {
            'fieldName': 'string',
            'sortOrder': 'ASC'|'DESC'
        },
    ]
)
Parameters
  • configurationType (string) --

    [REQUIRED]

    A valid configuration identified by Application Discovery Service.

  • filters (list) --

    You can filter the request using various logical operators and a key -value format. For example:

    {"key": "serverType", "value": "webServer"}

    For a complete list of filter options and guidance about using them with this action, see Using the ListConfigurations Action in the Amazon Web Services Application Discovery Service User Guide .

    • (dict) --

      A filter that can use conditional operators.

      For more information about filters, see Querying Discovered Configuration Items in the Amazon Web Services Application Discovery Service User Guide .

      • name (string) -- [REQUIRED]

        The name of the filter.

      • values (list) -- [REQUIRED]

        A string value on which to filter. For example, if you choose the destinationServer.osVersion filter name, you could specify Ubuntu for the value.

        • (string) --
      • condition (string) -- [REQUIRED]

        A conditional operator. The following operators are valid: EQUALS, NOT_EQUALS, CONTAINS, NOT_CONTAINS. If you specify multiple filters, the system utilizes all filters as though concatenated by AND . If you specify multiple values for a particular filter, the system differentiates the values using OR . Calling either DescribeConfigurations or ListConfigurations returns attributes of matching configuration items.

  • maxResults (integer) -- The total number of items to return. The maximum value is 100.
  • nextToken (string) -- Token to retrieve the next set of results. For example, if a previous call to ListConfigurations returned 100 items, but you set ListConfigurationsRequest$maxResults to 10, you received a set of 10 results along with a token. Use that token in this query to get the next set of 10.
  • orderBy (list) --

    Certain filter criteria return output that can be sorted in ascending or descending order. For a list of output characteristics for each filter, see Using the ListConfigurations Action in the Amazon Web Services Application Discovery Service User Guide .

    • (dict) --

      A field and direction for ordered output.

      • fieldName (string) -- [REQUIRED]

        The field on which to order.

      • sortOrder (string) --

        Ordering direction.

Return type

dict

Returns

Response Syntax

{
    'configurations': [
        {
            'string': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • configurations (list) --

      Returns configuration details, including the configuration ID, attribute names, and attribute values.

      • (dict) --
        • (string) --
          • (string) --
    • nextToken (string) --

      Token to retrieve the next set of results. For example, if your call to ListConfigurations returned 100 items, but you set ListConfigurationsRequest$maxResults to 10, you received a set of 10 results along with this token. Use this token in the next query to retrieve the next set of 10.

Exceptions

  • ApplicationDiscoveryService.Client.exceptions.AuthorizationErrorException
  • ApplicationDiscoveryService.Client.exceptions.ResourceNotFoundException
  • ApplicationDiscoveryService.Client.exceptions.InvalidParameterException
  • ApplicationDiscoveryService.Client.exceptions.InvalidParameterValueException
  • ApplicationDiscoveryService.Client.exceptions.ServerInternalErrorException
  • ApplicationDiscoveryService.Client.exceptions.HomeRegionNotSetException