Redshift / Client / describe_redshift_idc_applications

describe_redshift_idc_applications#

Redshift.Client.describe_redshift_idc_applications(**kwargs)#

Lists the Amazon Redshift IAM Identity Center applications.

Request Syntax

response = client.describe_redshift_idc_applications(
    RedshiftIdcApplicationArn='string',
    MaxRecords=123,
    Marker='string'
)

Parameters:

RedshiftIdcApplicationArn (string) – The ARN for the Redshift application that integrates with IAM Identity Center.
MaxRecords (integer) – The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.
Marker (string) – A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

Return type:

dict

Returns:

Response Syntax

{
    'RedshiftIdcApplications': [
        {
            'IdcInstanceArn': 'string',
            'RedshiftIdcApplicationName': 'string',
            'RedshiftIdcApplicationArn': 'string',
            'IdentityNamespace': 'string',
            'IdcDisplayName': 'string',
            'IamRoleArn': 'string',
            'IdcManagedApplicationArn': 'string',
            'IdcOnboardStatus': 'string',
            'AuthorizedTokenIssuerList': [
                {
                    'TrustedTokenIssuerArn': 'string',
                    'AuthorizedAudiencesList': [
                        'string',
                    ]
                },
            ],
            'ServiceIntegrations': [
                {
                    'LakeFormation': [
                        {
                            'LakeFormationQuery': {
                                'Authorization': 'Enabled'|'Disabled'
                            }
                        },
                    ],
                    'S3AccessGrants': [
                        {
                            'ReadWriteAccess': {
                                'Authorization': 'Enabled'|'Disabled'
                            }
                        },
                    ]
                },
            ]
        },
    ],
    'Marker': 'string'
}

Response Structure

(dict) –
- RedshiftIdcApplications (list) –
  
  The list of Amazon Redshift IAM Identity Center applications.
  - (dict) –
    
    Contains properties for the Redshift IDC application.
    - IdcInstanceArn (string) –
      
      The ARN for the IAM Identity Center instance that Redshift integrates with.
    - RedshiftIdcApplicationName (string) –
      
      The name of the Redshift application in IAM Identity Center.
    - RedshiftIdcApplicationArn (string) –
      
      The ARN for the Redshift application that integrates with IAM Identity Center.
    - IdentityNamespace (string) –
      
      The identity namespace for the Amazon Redshift IAM Identity Center application. It determines which managed application verifies the connection token.
    - IdcDisplayName (string) –
      
      The display name for the Amazon Redshift IAM Identity Center application. It appears on the console.
    - IamRoleArn (string) –
      
      The ARN for the Amazon Redshift IAM Identity Center application. It has the required permissions to be assumed and invoke the IDC Identity Center API.
    - IdcManagedApplicationArn (string) –
      
      The ARN for the Amazon Redshift IAM Identity Center application.
    - IdcOnboardStatus (string) –
      
      The onboarding status for the Amazon Redshift IAM Identity Center application.
    - AuthorizedTokenIssuerList (list) –
      
      The authorized token issuer list for the Amazon Redshift IAM Identity Center application.
      - (dict) –
        
        The authorized token issuer for the Amazon Redshift IAM Identity Center application.
        
        TrustedTokenIssuerArn (string) –
        
        The ARN for the authorized token issuer for integrating Amazon Redshift with IDC Identity Center.
        
        AuthorizedAudiencesList (list) –
        
        The list of audiences for the authorized token issuer for integrating Amazon Redshift with IDC Identity Center.
        
        (string) –
    - ServiceIntegrations (list) –
      
      A list of service integrations for the Redshift IAM Identity Center application.
      - (dict) –
        
        A list of service integrations.
        
        Note
        This is a Tagged Union structure. Only one of the following top level keys will be set: LakeFormation, S3AccessGrants. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:
        
        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
        
        LakeFormation (list) –
        
        A list of scopes set up for Lake Formation integration.
        
        (dict) –
        
        A list of scopes set up for Lake Formation integration.
        
        Note
        This is a Tagged Union structure. Only one of the following top level keys will be set: LakeFormationQuery. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:
        
        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
        
        LakeFormationQuery (dict) –
        
        The Lake Formation scope.
        
        Authorization (string) –
        
        Determines whether the query scope is enabled or disabled.
        
        S3AccessGrants (list) –
        
        A list of scopes set up for S3 Access Grants integration.
        
        (dict) –
        
        A list of scopes set up for S3 Access Grants integration.
        
        Note
        This is a Tagged Union structure. Only one of the following top level keys will be set: ReadWriteAccess. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:
        
        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
        
        ReadWriteAccess (dict) –
        
        The S3 Access Grants scope.
        
        Authorization (string) –
        
        Determines whether the read/write scope is enabled or disabled.
- Marker (string) –
  
  A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the Marker parameter and retrying the command. If the Marker field is empty, all response records have been retrieved for the request.

Exceptions

Redshift.Client.exceptions.RedshiftIdcApplicationNotExistsFault
Redshift.Client.exceptions.DependentServiceUnavailableFault
Redshift.Client.exceptions.UnsupportedOperationFault
Redshift.Client.exceptions.DependentServiceAccessDeniedFault