AWS SSM-GUIConnect

2025/04/29 - AWS SSM-GUIConnect - 3 new api methods

Changes  This release adds API support for the connection recording GUI Connect feature of AWS Systems Manager

DeleteConnectionRecordingPreferences (new) Link ¶

Deletes the preferences for recording RDP connections.

See also: AWS API Documentation

Request Syntax

client.delete_connection_recording_preferences(
    ClientToken='string'
)
type ClientToken:

string

param ClientToken:

User-provided idempotency token.

This field is autopopulated if not provided.

rtype:

dict

returns:

Response Syntax

{
    'ClientToken': 'string'
}

Response Structure

  • (dict) --

    • ClientToken (string) --

      Service-provided idempotency token.

UpdateConnectionRecordingPreferences (new) Link ¶

Updates the preferences for recording RDP connections.

See also: AWS API Documentation

Request Syntax

client.update_connection_recording_preferences(
    ClientToken='string',
    ConnectionRecordingPreferences={
        'KMSKeyArn': 'string',
        'RecordingDestinations': {
            'S3Buckets': [
                {
                    'BucketName': 'string',
                    'BucketOwner': 'string'
                },
            ]
        }
    }
)
type ClientToken:

string

param ClientToken:

User-provided idempotency token.

This field is autopopulated if not provided.

type ConnectionRecordingPreferences:

dict

param ConnectionRecordingPreferences:

[REQUIRED]

The set of preferences used for recording RDP connections in the requesting Amazon Web Services account and Amazon Web Services Region. This includes details such as which S3 bucket recordings are stored in.

  • KMSKeyArn (string) -- [REQUIRED]

    The ARN of a KMS key that is used to encrypt data while it is being processed by the service. This key must exist in the same Amazon Web Services Region as the node you start an RDP connection to.

  • RecordingDestinations (dict) -- [REQUIRED]

    Determines where recordings of RDP connections are stored.

    • S3Buckets (list) -- [REQUIRED]

      The S3 bucket where RDP connection recordings are stored.

      • (dict) --

        The S3 bucket where RDP connection recordings are stored.

        • BucketName (string) -- [REQUIRED]

          The name of the S3 bucket where RDP connection recordings are stored.

        • BucketOwner (string) -- [REQUIRED]

          The Amazon Web Services account number that owns the S3 bucket.

rtype:

dict

returns:

Response Syntax

{
    'ClientToken': 'string',
    'ConnectionRecordingPreferences': {
        'KMSKeyArn': 'string',
        'RecordingDestinations': {
            'S3Buckets': [
                {
                    'BucketName': 'string',
                    'BucketOwner': 'string'
                },
            ]
        }
    }
}

Response Structure

  • (dict) --

    • ClientToken (string) --

      Service-provided idempotency token.

    • ConnectionRecordingPreferences (dict) --

      The set of preferences used for recording RDP connections in the requesting Amazon Web Services account and Amazon Web Services Region. This includes details such as which S3 bucket recordings are stored in.

      • KMSKeyArn (string) --

        The ARN of a KMS key that is used to encrypt data while it is being processed by the service. This key must exist in the same Amazon Web Services Region as the node you start an RDP connection to.

      • RecordingDestinations (dict) --

        Determines where recordings of RDP connections are stored.

        • S3Buckets (list) --

          The S3 bucket where RDP connection recordings are stored.

          • (dict) --

            The S3 bucket where RDP connection recordings are stored.

            • BucketName (string) --

              The name of the S3 bucket where RDP connection recordings are stored.

            • BucketOwner (string) --

              The Amazon Web Services account number that owns the S3 bucket.

GetConnectionRecordingPreferences (new) Link ¶

Returns the preferences specified for recording RDP connections in the requesting Amazon Web Services account and Amazon Web Services Region.

See also: AWS API Documentation

Request Syntax

client.get_connection_recording_preferences()
rtype:

dict

returns:

Response Syntax

{
    'ClientToken': 'string',
    'ConnectionRecordingPreferences': {
        'KMSKeyArn': 'string',
        'RecordingDestinations': {
            'S3Buckets': [
                {
                    'BucketName': 'string',
                    'BucketOwner': 'string'
                },
            ]
        }
    }
}

Response Structure

  • (dict) --

    • ClientToken (string) --

      Service-provided idempotency token.

    • ConnectionRecordingPreferences (dict) --

      The set of preferences used for recording RDP connections in the requesting Amazon Web Services account and Amazon Web Services Region. This includes details such as which S3 bucket recordings are stored in.

      • KMSKeyArn (string) --

        The ARN of a KMS key that is used to encrypt data while it is being processed by the service. This key must exist in the same Amazon Web Services Region as the node you start an RDP connection to.

      • RecordingDestinations (dict) --

        Determines where recordings of RDP connections are stored.

        • S3Buckets (list) --

          The S3 bucket where RDP connection recordings are stored.

          • (dict) --

            The S3 bucket where RDP connection recordings are stored.

            • BucketName (string) --

              The name of the S3 bucket where RDP connection recordings are stored.

            • BucketOwner (string) --

              The Amazon Web Services account number that owns the S3 bucket.