Connect / Client / search_resource_tags

search_resource_tags#

Connect.Client.search_resource_tags(**kwargs)#

Searches tags used in an Amazon Connect instance using optional search criteria.

See also: AWS API Documentation

Request Syntax

response = client.search_resource_tags(
    InstanceId='string',
    ResourceTypes=[
        'string',
    ],
    NextToken='string',
    MaxResults=123,
    SearchCriteria={
        'TagSearchCondition': {
            'tagKey': 'string',
            'tagValue': 'string',
            'tagKeyComparisonType': 'STARTS_WITH'|'CONTAINS'|'EXACT',
            'tagValueComparisonType': 'STARTS_WITH'|'CONTAINS'|'EXACT'
        }
    }
)
Parameters:

  • InstanceId (string) –

    [REQUIRED]

    The identifier of the Amazon Connect instance. You can find the instanceId in the Amazon Resource Name (ARN) of the instance.

  • ResourceTypes (list) –

    The list of resource types to be used to search tags from. If not provided or if any empty list is provided, this API will search from all supported resource types.

    • (string) –

  • NextToken (string) – The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

  • MaxResults (integer) – The maximum number of results to return per page.

  • SearchCriteria (dict) –

    The search criteria to be used to return tags.

    • TagSearchCondition (dict) –

      The search criteria to be used to return tags.

      • tagKey (string) –

        The tag key used in the tag search condition.

      • tagValue (string) –

        The tag value used in the tag search condition.

      • tagKeyComparisonType (string) –

        The type of comparison to be made when evaluating the tag key in tag search condition.

      • tagValueComparisonType (string) –

        The type of comparison to be made when evaluating the tag value in tag search condition.

Return type:

dict

Returns:

Response Syntax

{
    'Tags': [
        {
            'key': 'string',
            'value': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • Tags (list) –

      A list of tags used in the Amazon Connect instance.

      • (dict) –

        A tag set contains tag key and tag value.

        • key (string) –

          The tag key in the tagSet.

        • value (string) –

          The tag value in the tagSet.

    • NextToken (string) –

      If there are additional results, this is the token for the next set of results.

Exceptions