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(
    maxResults=123,
    nextToken='string'
)

Parameters

• maxResults (integer) -- Maximum number of logging configurations to return. Default: 50.
• nextToken (string) -- The first logging configurations to retrieve. This is used for pagination; see the nextToken response field.

Return type

dict

Returns

Response Syntax

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

      • createTime (datetime) --

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

      • 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: cloudWatchLogs, firehose, s3. 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'}
        

        • 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.

        • 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.

      • id (string) --

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

      • name (string) --

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

      • 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) --

      • updateTime (datetime) --

        Time of the logging configuration’s last update. This is an ISO 8601 timestamp; note that this is returned as a 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