IVS / Client / list_recording_configurations



Gets summary information about all recording configurations in your account, in the Amazon Web Services region where the API request is processed.

See also: AWS API Documentation

Request Syntax

response = client.list_recording_configurations(
  • maxResults (integer) – Maximum number of recording configurations to return. Default: your service quota or 100, whichever is smaller.

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

Return type:



Response Syntax

    'nextToken': 'string',
    'recordingConfigurations': [
            'arn': 'string',
            'destinationConfiguration': {
                's3': {
                    'bucketName': 'string'
            'name': 'string',
            'state': 'CREATING'|'CREATE_FAILED'|'ACTIVE',
            'tags': {
                'string': 'string'

Response Structure

  • (dict) –

    • nextToken (string) –

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

    • recordingConfigurations (list) –

      List of the matching recording configurations.

      • (dict) –

        Summary information about a RecordingConfiguration.

        • arn (string) –

          Recording-configuration ARN.

        • destinationConfiguration (dict) –

          A complex type that contains information about where recorded video will be stored.

          • s3 (dict) –

            An S3 destination configuration where recorded videos will be stored.

            • bucketName (string) –

              Location (S3 bucket name) where recorded videos will be stored.

        • name (string) –

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

        • state (string) –

          Indicates the current state of the recording configuration. When the state is ACTIVE, the configuration is ready for recording a channel stream.

        • tags (dict) –

          Tags attached to the resource. Array of 1-50 maps, each of the form string:string (key:value). See Tagging Amazon Web Services Resources for more information, including restrictions that apply to tags and “Tag naming limits and requirements”; Amazon IVS has no service-specific constraints beyond what is documented there.

          • (string) –

            • (string) –