SSOAdmin / Paginator / ListApplications

ListApplications#

class SSOAdmin.Paginator.ListApplications#
paginator = client.get_paginator('list_applications')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from SSOAdmin.Client.list_applications().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    Filter={
        'ApplicationAccount': 'string',
        'ApplicationProvider': 'string'
    },
    InstanceArn='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • Filter (dict) –

    Filters response results.

    • ApplicationAccount (string) –

      An Amazon Web Services account ID number that filters the results in the response.

    • ApplicationProvider (string) –

      The ARN of an application provider that can filter the results in the response.

  • InstanceArn (string) –

    [REQUIRED]

    The ARN of the IAM Identity Center application under which the operation will run. For more information about ARNs, see Amazon Resource Names (ARNs) and Amazon Web Services Service Namespaces in the Amazon Web Services General Reference.

  • 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

{
    'Applications': [
        {
            'ApplicationAccount': 'string',
            'ApplicationArn': 'string',
            'ApplicationProviderArn': 'string',
            'CreatedDate': datetime(2015, 1, 1),
            'Description': 'string',
            'InstanceArn': 'string',
            'Name': 'string',
            'PortalOptions': {
                'SignInOptions': {
                    'ApplicationUrl': 'string',
                    'Origin': 'IDENTITY_CENTER'|'APPLICATION'
                },
                'Visibility': 'ENABLED'|'DISABLED'
            },
            'Status': 'ENABLED'|'DISABLED'
        },
    ],

}

Response Structure

  • (dict) –

    • Applications (list) –

      Retrieves all applications associated with the instance.

      • (dict) –

        A structure that describes an application that uses IAM Identity Center for access management.

        • ApplicationAccount (string) –

          The Amazon Web Services account ID number of the application.

        • ApplicationArn (string) –

          The ARN of the application.

        • ApplicationProviderArn (string) –

          The ARN of the application provider for this application.

        • CreatedDate (datetime) –

          The date and time when the application was originally created.

        • Description (string) –

          The description of the application.

        • InstanceArn (string) –

          The ARN of the instance of IAM Identity Center that is configured with this application.

        • Name (string) –

          The name of the application.

        • PortalOptions (dict) –

          A structure that describes the options for the access portal associated with this application.

          • SignInOptions (dict) –

            A structure that describes the sign-in options for the access portal.

            • ApplicationUrl (string) –

              The URL that accepts authentication requests for an application. This is a required parameter if the Origin parameter is APPLICATION.

            • Origin (string) –

              This determines how IAM Identity Center navigates the user to the target application. It can be one of the following values:

              • APPLICATION: IAM Identity Center redirects the customer to the configured ApplicationUrl.

              • IDENTITY_CENTER: IAM Identity Center uses SAML identity-provider initiated authentication to sign the customer directly into a SAML-based application.

          • Visibility (string) –

            Indicates whether this application is visible in the access portal.

        • Status (string) –

          The current status of the application in this instance of IAM Identity Center.