ivschat / Client / list_logging_configurations

list_logging_configurations

ivschat.Client.list_logging_configurations(**kwargs)

Gets summary information about all your logging configurations in the AWS region where the API request is processed.

See also: AWS API Documentation

Request Syntax

response = client.list_logging_configurations(
    nextToken='string',
    maxResults=123
)

Parameters:

• nextToken (string) – The first logging configurations to retrieve. This is used for pagination; see the nextToken response field.

• maxResults (integer) – Maximum number of logging configurations to return. Default: 50.

Return type:

dict

Returns:

Response Syntax

{
    'loggingConfigurations': [
        {
            'arn': 'string',
            'id': 'string',
            'createTime': datetime(2015, 1, 1),
            'updateTime': datetime(2015, 1, 1),
            'name': 'string',
            'destinationConfiguration': {
                's3': {
                    'bucketName': 'string'
                },
                'cloudWatchLogs': {
                    'logGroupName': 'string'
                },
                'firehose': {
                    'deliveryStreamName': 'string'
                }
            },
            'state': 'CREATING'|'CREATE_FAILED'|'DELETING'|'DELETE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'ACTIVE',
            'tags': {
                'string': 'string'
            }
        },
    ],
    'nextToken': 'string'
}

Response Structure

• (dict) –

  • loggingConfigurations (list) –

    List of the matching logging configurations (summary information only). There is only one type of destination ( cloudWatchLogs, firehose, or s3) in a destinationConfiguration.

    • (dict) –

      Summary information about a logging configuration.

      • arn (string) –

        Logging-configuration ARN.

      • id (string) –

        Logging-configuration ID, generated by the system. This is a relative identifier, the part of the ARN that uniquely identifies the room.

      • createTime (datetime) –

        Time when the logging configuration was created. This is an ISO 8601 timestamp; note that this is returned as a string.

      • updateTime (datetime) –

        Time of the logging configuration’s last update. This is an ISO 8601 timestamp; note that this is returned as a string.

      • name (string) –

        Logging-configuration name. The value does not need to be unique.

      • destinationConfiguration (dict) –

        A complex type that contains a destination configuration for where chat content will be logged.

        Note

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

        • s3 (dict) –

          An Amazon S3 destination configuration where chat activity will be logged.

          • bucketName (string) –

            Name of the Amazon S3 bucket where chat activity will be logged.

        • cloudWatchLogs (dict) –

          An Amazon CloudWatch Logs destination configuration where chat activity will be logged.

          • logGroupName (string) –

            Name of the Amazon Cloudwatch Logs destination where chat activity will be logged.

        • firehose (dict) –

          An Amazon Kinesis Data Firehose destination configuration where chat activity will be logged.

          • deliveryStreamName (string) –

            Name of the Amazon Kinesis Firehose delivery stream where chat activity will be logged.

      • state (string) –

        The state of the logging configuration. When this is ACTIVE, the configuration is ready for logging chat content.

      • tags (dict) –

        Tags to attach to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and “Tag naming limits and requirements”; Amazon IVS Chat has no constraints on tags beyond what is documented there.

        • (string) –

          • (string) –

  • nextToken (string) –

    If there are more logging configurations than maxResults, use nextToken in the request to get the next set.

Exceptions

• ivschat.Client.exceptions.AccessDeniedException

• ivschat.Client.exceptions.ValidationException