AWS Resource Explorer

Lists the Amazon resource names (ARNs) of the Amazon Web Services-managed views available in the Amazon Web Services Region in which you call this operation.

See also: AWS API Documentation

Request Syntax

client.list_managed_views(
    MaxResults=123,
    NextToken='string',
    ServicePrincipal='string'
)

type MaxResults:

integer

param MaxResults:

The maximum number of results that you want included on each page of the response. If you do not include this parameter, it defaults to a value appropriate to the operation. If additional items exist beyond those included in the current response, the NextToken response element is present and has a value (is not null). Include that value as the NextToken request parameter in the next call to the operation to get the next part of the results.

type NextToken:

string

param NextToken:

The parameter for receiving additional results if you receive a NextToken response in a previous request. A NextToken response indicates that more output is available. Set this parameter to the value of the previous call's NextToken response to indicate where the output should continue from. The pagination tokens expire after 24 hours.

type ServicePrincipal:

string

param ServicePrincipal:

Specifies a service principal name. If specified, then the operation only returns the managed views that are managed by the input service.

rtype:

dict

returns:

Response Syntax

{
    'ManagedViews': [
        'string',
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) --

  • ManagedViews (list) --

    The list of managed views available in the Amazon Web Services Region in which you called this operation.

    • (string) --

  • NextToken (string) --

    If present, indicates that more output is available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null. The pagination tokens expire after 24 hours.

Retrieves details of the specified Amazon Web Services-managed view.

See also: AWS API Documentation

Request Syntax

client.get_managed_view(
    ManagedViewArn='string'
)

type ManagedViewArn:

string

param ManagedViewArn:

[REQUIRED]

The Amazon resource name (ARN) of the managed view.

rtype:

dict

returns:

Response Syntax

{
    'ManagedView': {
        'Filters': {
            'FilterString': 'string'
        },
        'IncludedProperties': [
            {
                'Name': 'string'
            },
        ],
        'LastUpdatedAt': datetime(2015, 1, 1),
        'ManagedViewArn': 'string',
        'ManagedViewName': 'string',
        'Owner': 'string',
        'ResourcePolicy': 'string',
        'Scope': 'string',
        'TrustedService': 'string',
        'Version': 'string'
    }
}

Response Structure

• (dict) --

  • ManagedView (dict) --

    Details about the specified managed view.

    • Filters (dict) --

      A search filter defines which resources can be part of a search query result set.

      • FilterString (string) --

        The string that contains the search keywords, prefixes, and operators to control the results that can be returned by a Search operation. For more details, see Search query syntax.

    • IncludedProperties (list) --

      A structure that contains additional information about the managed view.

      • (dict) --

        Information about an additional property that describes a resource, that you can optionally include in the view. This lets you view that property in search results, and filter your search results based on the value of the property.

        • Name (string) --

          The name of the property that is included in this view.

          You can specify the following property names for this field:

          • Tags

    • LastUpdatedAt (datetime) --

      The date and time when this managed view was last modified.

    • ManagedViewArn (string) --

      The Amazon resource name (ARN) of the managed view.

    • ManagedViewName (string) --

      The name of the managed view.

    • Owner (string) --

      The Amazon Web Services account that owns this managed view.

    • ResourcePolicy (string) --

      The resource policy that defines access to the managed view. To learn more about this policy, review Managed views.

    • Scope (string) --

      An Amazon resource name (ARN) of an Amazon Web Services account or organization that specifies whether this managed view includes resources from only the specified Amazon Web Services account or all accounts in the specified organization.

    • TrustedService (string) --

      The service principal of the Amazon Web Services service that created and manages the managed view.

    • Version (string) --

      The version of the managed view.