Glue / Paginator / SearchAssets

SearchAssets

class Glue.Paginator.SearchAssets
paginator = client.get_paginator('search_assets')
paginate(**kwargs)

Creates an iterator that will paginate through responses from Glue.Client.search_assets().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    SearchText='string',
    Sort={
        'Attribute': 'string',
        'Order': 'ASCENDING'|'DESCENDING'
    },
    FilterClause={
        'AndAllFilters': [
            {'... recursive ...'},
        ],
        'OrAnyFilters': [
            {'... recursive ...'},
        ],
        'AttributeFilter': {
            'Attribute': 'string',
            'Operator': 'equals'|'greaterThan'|'greaterThanOrEquals'|'lessThan'|'lessThanOrEquals'|'notExists',
            'Value': {
                'StringValue': 'string',
                'LongValue': 123
            }
        },
        'MapFilter': {
            'Attribute': 'string',
            'Key': 'string',
            'Value': {
                'StringValue': 'string'
            }
        }
    },
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • SearchText (string) – The text to search for. At least one of searchText or filterClause must be provided.

  • Sort (dict) –

    The sort criteria for the search results.

    • Attribute (string) – [REQUIRED]

      The attribute to sort by.

    • Order (string) –

      The sort order. Valid values are ASCENDING and DESCENDING.

  • FilterClause (dict) –

    The filter clause to apply to the search. Supports nested AND/OR logic with attribute-level and map-level filters.

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: AndAllFilters, OrAnyFilters, AttributeFilter, MapFilter.

    • AndAllFilters (list) –

      A list of filter clauses that must all match (logical AND).

      • (dict) –

        A filter clause that supports nested boolean logic. Exactly one of andAllFilters, orAnyFilters, attributeFilter, or mapFilter must be specified.

        Note

        This is a Tagged Union structure. Only one of the following top level keys can be set: AndAllFilters, OrAnyFilters, AttributeFilter, MapFilter.

    • OrAnyFilters (list) –

      A list of filter clauses where at least one must match (logical OR).

      • (dict) –

        A filter clause that supports nested boolean logic. Exactly one of andAllFilters, orAnyFilters, attributeFilter, or mapFilter must be specified.

        Note

        This is a Tagged Union structure. Only one of the following top level keys can be set: AndAllFilters, OrAnyFilters, AttributeFilter, MapFilter.

    • AttributeFilter (dict) –

      A filter on a single attribute value.

      • Attribute (string) – [REQUIRED]

        The attribute name to filter on.

      • Operator (string) – [REQUIRED]

        The comparison operator. Valid values are equals, greaterThan, greaterThanOrEquals, lessThan, lessThanOrEquals, and notExists.

      • Value (dict) –

        The value to compare against.

        Note

        This is a Tagged Union structure. Only one of the following top level keys can be set: StringValue, LongValue.

        • StringValue (string) –

          A string filter value.

        • LongValue (integer) –

          A long integer filter value.

    • MapFilter (dict) –

      A filter on a map attribute’s key-value pair.

      • Attribute (string) – [REQUIRED]

        The map attribute name to filter on.

      • Key (string) – [REQUIRED]

        The key within the map attribute to filter on.

      • Value (dict) – [REQUIRED]

        The value to compare against.

        Note

        This is a Tagged Union structure. Only one of the following top level keys can be set: StringValue.

        • StringValue (string) –

          A string filter value.

  • PaginationConfig (dict) –

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) –

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) –

      The size of each page.

    • StartingToken (string) –

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'Items': [
        {
            'Id': 'string',
            'AssetName': 'string',
            'AssetDescription': 'string',
            'UpdatedAt': datetime(2015, 1, 1),
            'AssetTypeId': 'string'
        },
    ],

}

Response Structure

  • (dict) –

    • Items (list) –

      The list of assets matching the search criteria.

      • (dict) –

        A single search result item representing a matched asset.

        • Id (string) –

          The unique identifier of the matched asset.

        • AssetName (string) –

          The name of the matched asset.

        • AssetDescription (string) –

          The description of the matched asset.

        • UpdatedAt (datetime) –

          The timestamp at which the matched asset was last updated.

        • AssetTypeId (string) –

          The identifier of the asset type for the matched asset.