QBusiness / Client / get_plugin

get_plugin

QBusiness.Client.get_plugin(**kwargs)

Gets information about an existing Amazon Q Business plugin.

See also: AWS API Documentation

Request Syntax

response = client.get_plugin(
    applicationId='string',
    pluginId='string'
)

Parameters:

• applicationId (string) –

  [REQUIRED]

  The identifier of the application which contains the plugin.

• pluginId (string) –

  [REQUIRED]

  The identifier of the plugin.

Return type:

dict

Returns:

Response Syntax

{
    'applicationId': 'string',
    'authConfiguration': {
        'basicAuthConfiguration': {
            'roleArn': 'string',
            'secretArn': 'string'
        },
        'oAuth2ClientCredentialConfiguration': {
            'roleArn': 'string',
            'secretArn': 'string'
        }
    },
    'createdAt': datetime(2015, 1, 1),
    'displayName': 'string',
    'pluginArn': 'string',
    'pluginId': 'string',
    'serverUrl': 'string',
    'state': 'ENABLED'|'DISABLED',
    'type': 'SERVICE_NOW'|'SALESFORCE'|'JIRA'|'ZENDESK',
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

• (dict) –

  • applicationId (string) –

    The identifier of the application which contains the plugin.

  • authConfiguration (dict) –

    Authentication configuration information for an Amazon Q Business plugin.

    Note

    This is a Tagged Union structure. Only one of the following top level keys will be set: basicAuthConfiguration, oAuth2ClientCredentialConfiguration. 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'}
    

    • basicAuthConfiguration (dict) –

      Information about the basic authentication credentials used to configure a plugin.

      • roleArn (string) –

        The ARN of an IAM role used by Amazon Q Business to access the basic authentication credentials stored in a Secrets Manager secret.

      • secretArn (string) –

        The ARN of the Secrets Manager secret that stores the basic authentication credentials used for plugin configuration..

    • oAuth2ClientCredentialConfiguration (dict) –

      Information about the OAuth 2.0 authentication credential/token used to configure a plugin.

      • roleArn (string) –

        The ARN of an IAM role used by Amazon Q Business to access the OAuth 2.0 authentication credentials stored in a Secrets Manager secret.

      • secretArn (string) –

        The ARN of the Secrets Manager secret that stores the OAuth 2.0 credentials/token used for plugin configuration.

  • createdAt (datetime) –

    The timestamp for when the plugin was created.

  • displayName (string) –

    The name of the plugin.

  • pluginArn (string) –

    The Amazon Resource Name (ARN) of the role with permission to access resources needed to create the plugin.

  • pluginId (string) –

    The identifier of the plugin.

  • serverUrl (string) –

    The source URL used for plugin configuration.

  • state (string) –

    The current state of the plugin.

  • type (string) –

    The type of the plugin.

  • updatedAt (datetime) –

    The timestamp for when the plugin was last updated.

Exceptions

• QBusiness.Client.exceptions.ResourceNotFoundException

• QBusiness.Client.exceptions.InternalServerException

• QBusiness.Client.exceptions.ThrottlingException

• QBusiness.Client.exceptions.ValidationException

• QBusiness.Client.exceptions.AccessDeniedException