AppFabric / Client / update_ingestion_destination

update_ingestion_destination#

AppFabric.Client.update_ingestion_destination(**kwargs)#

Updates an ingestion destination, which specifies how an application’s ingested data is processed by Amazon Web Services AppFabric and where it’s delivered.

See also: AWS API Documentation

Request Syntax

response = client.update_ingestion_destination(
    appBundleIdentifier='string',
    ingestionIdentifier='string',
    ingestionDestinationIdentifier='string',
    destinationConfiguration={
        'auditLog': {
            'destination': {
                's3Bucket': {
                    'bucketName': 'string',
                    'prefix': 'string'
                },
                'firehoseStream': {
                    'streamName': 'string'
                }
            }
        }
    }
)
Parameters:
  • appBundleIdentifier (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) or Universal Unique Identifier (UUID) of the app bundle to use for the request.

  • ingestionIdentifier (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) or Universal Unique Identifier (UUID) of the ingestion to use for the request.

  • ingestionDestinationIdentifier (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) or Universal Unique Identifier (UUID) of the ingestion destination to use for the request.

  • destinationConfiguration (dict) –

    [REQUIRED]

    Contains information about the destination of ingested data.

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: auditLog.

    • auditLog (dict) –

      Contains information about an audit log destination configuration.

      • destination (dict) – [REQUIRED]

        Contains information about an audit log destination.

        Note

        This is a Tagged Union structure. Only one of the following top level keys can be set: s3Bucket, firehoseStream.

        • s3Bucket (dict) –

          Contains information about an Amazon S3 bucket.

          • bucketName (string) – [REQUIRED]

            The name of the Amazon S3 bucket.

          • prefix (string) –

            The object key to use.

        • firehoseStream (dict) –

          Contains information about an Amazon Kinesis Data Firehose delivery stream.

          • streamName (string) – [REQUIRED]

            The name of the Amazon Kinesis Data Firehose delivery stream.

Return type:

dict

Returns:

Response Syntax

{
    'ingestionDestination': {
        'arn': 'string',
        'ingestionArn': 'string',
        'processingConfiguration': {
            'auditLog': {
                'schema': 'ocsf'|'raw',
                'format': 'json'|'parquet'
            }
        },
        'destinationConfiguration': {
            'auditLog': {
                'destination': {
                    's3Bucket': {
                        'bucketName': 'string',
                        'prefix': 'string'
                    },
                    'firehoseStream': {
                        'streamName': 'string'
                    }
                }
            }
        },
        'status': 'Active'|'Failed',
        'statusReason': 'string',
        'createdAt': datetime(2015, 1, 1),
        'updatedAt': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) –

    • ingestionDestination (dict) –

      Contains information about an ingestion destination.

      • arn (string) –

        The Amazon Resource Name (ARN) of the ingestion destination.

      • ingestionArn (string) –

        The Amazon Resource Name (ARN) of the ingestion.

      • processingConfiguration (dict) –

        Contains information about how ingested data is processed.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: auditLog. 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'}
        
        • auditLog (dict) –

          Contains information about an audit log processing configuration.

          • schema (string) –

            The event schema in which the audit logs need to be formatted.

          • format (string) –

            The format in which the audit logs need to be formatted.

      • destinationConfiguration (dict) –

        Contains information about the destination of ingested data.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: auditLog. 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'}
        
        • auditLog (dict) –

          Contains information about an audit log destination configuration.

          • destination (dict) –

            Contains information about an audit log destination.

            Note

            This is a Tagged Union structure. Only one of the following top level keys will be set: s3Bucket, firehoseStream. 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'}
            
            • s3Bucket (dict) –

              Contains information about an Amazon S3 bucket.

              • bucketName (string) –

                The name of the Amazon S3 bucket.

              • prefix (string) –

                The object key to use.

            • firehoseStream (dict) –

              Contains information about an Amazon Kinesis Data Firehose delivery stream.

              • streamName (string) –

                The name of the Amazon Kinesis Data Firehose delivery stream.

      • status (string) –

        The state of the ingestion destination.

        The following states are possible:

        • Active: The ingestion destination is active and is ready to be used.

        • Failed: The ingestion destination has failed. If the ingestion destination is in this state, you should verify the ingestion destination configuration and try again.

      • statusReason (string) –

        The reason for the current status of the ingestion destination.

        Only present when the status of ingestion destination is Failed.

      • createdAt (datetime) –

        The timestamp of when the ingestion destination was created.

      • updatedAt (datetime) –

        The timestamp of when the ingestion destination was last updated.

Exceptions

  • AppFabric.Client.exceptions.InternalServerException

  • AppFabric.Client.exceptions.ServiceQuotaExceededException

  • AppFabric.Client.exceptions.ThrottlingException

  • AppFabric.Client.exceptions.ConflictException

  • AppFabric.Client.exceptions.ValidationException

  • AppFabric.Client.exceptions.ResourceNotFoundException

  • AppFabric.Client.exceptions.AccessDeniedException