{ "smithy": "2.0", "shapes": { "com.amazonaws.ssmguiconnect#AccessDeniedException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.ssmguiconnect#ErrorMessage", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "
You do not have sufficient access to perform this action.
", "smithy.api#error": "client", "smithy.api#httpError": 403 } }, "com.amazonaws.ssmguiconnect#AccountId": { "type": "string", "traits": { "smithy.api#pattern": "^[0-9]{12}$" } }, "com.amazonaws.ssmguiconnect#BucketName": { "type": "string", "traits": { "smithy.api#pattern": "(?=^.{3,63}$)(?!^(\\d+\\.)+\\d+$)(^(([a-z0-9]|[a-z0-9][a-z0-9\\-]*[a-z0-9])\\.)*([a-z0-9]|[a-z0-9][a-z0-9\\-]*[a-z0-9])$)" } }, "com.amazonaws.ssmguiconnect#ClientToken": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 64 } } }, "com.amazonaws.ssmguiconnect#ConflictException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.ssmguiconnect#ErrorMessage", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "An error occurred due to a conflict.
", "smithy.api#error": "client", "smithy.api#httpError": 409 } }, "com.amazonaws.ssmguiconnect#Connection": { "type": "resource", "identifiers": { "ConnectionArn": { "target": "com.amazonaws.ssmguiconnect#ConnectionArn" } } }, "com.amazonaws.ssmguiconnect#ConnectionAccess": { "type": "resource", "identifiers": { "ConnectionToken": { "target": "com.amazonaws.ssmguiconnect#ConnectionToken" } } }, "com.amazonaws.ssmguiconnect#ConnectionArn": { "type": "string" }, "com.amazonaws.ssmguiconnect#ConnectionPreferences": { "type": "resource", "identifiers": { "AccountId": { "target": "com.amazonaws.ssmguiconnect#AccountId" } } }, "com.amazonaws.ssmguiconnect#ConnectionRecordingPreferences": { "type": "structure", "members": { "RecordingDestinations": { "target": "com.amazonaws.ssmguiconnect#RecordingDestinations", "traits": { "smithy.api#documentation": "Determines where recordings of RDP connections are stored.
", "smithy.api#required": {} } }, "KMSKeyArn": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "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.
", "smithy.api#length": { "min": 1, "max": 2048 }, "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "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.
" } }, "com.amazonaws.ssmguiconnect#ConnectionToken": { "type": "string", "traits": { "smithy.api#pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}_[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$" } }, "com.amazonaws.ssmguiconnect#ConnectionsCollection": { "type": "resource", "identifiers": { "AccountId": { "target": "com.amazonaws.ssmguiconnect#AccountId" } } }, "com.amazonaws.ssmguiconnect#DeleteConnectionRecordingPreferences": { "type": "operation", "input": { "target": "com.amazonaws.ssmguiconnect#DeleteConnectionRecordingPreferencesRequest" }, "output": { "target": "com.amazonaws.ssmguiconnect#DeleteConnectionRecordingPreferencesResponse" }, "errors": [ { "target": "com.amazonaws.ssmguiconnect#AccessDeniedException" }, { "target": "com.amazonaws.ssmguiconnect#ConflictException" }, { "target": "com.amazonaws.ssmguiconnect#InternalServerException" }, { "target": "com.amazonaws.ssmguiconnect#ResourceNotFoundException" }, { "target": "com.amazonaws.ssmguiconnect#ServiceQuotaExceededException" }, { "target": "com.amazonaws.ssmguiconnect#ThrottlingException" }, { "target": "com.amazonaws.ssmguiconnect#ValidationException" } ], "traits": { "smithy.api#documentation": "Deletes the preferences for recording RDP connections.
", "smithy.api#examples": [ { "title": "Delete the connection recording preferences for the account", "input": {}, "output": { "ClientToken": "sample_uuid" } } ], "smithy.api#http": { "uri": "/DeleteConnectionRecordingPreferences", "method": "POST" }, "smithy.api#idempotent": {}, "smithy.test#smokeTests": [ { "id": "DeleteConnectionRecordingPreferencesSuccess", "params": {}, "expect": { "success": {} }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-east-1" } } ] } }, "com.amazonaws.ssmguiconnect#DeleteConnectionRecordingPreferencesRequest": { "type": "structure", "members": { "ClientToken": { "target": "com.amazonaws.ssmguiconnect#ClientToken", "traits": { "smithy.api#documentation": "User-provided idempotency token.
", "smithy.api#idempotencyToken": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.ssmguiconnect#DeleteConnectionRecordingPreferencesResponse": { "type": "structure", "members": { "ClientToken": { "target": "com.amazonaws.ssmguiconnect#ClientToken", "traits": { "smithy.api#documentation": "Service-provided idempotency token.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.ssmguiconnect#ErrorMessage": { "type": "string" }, "com.amazonaws.ssmguiconnect#GetConnectionRecordingPreferences": { "type": "operation", "input": { "target": "smithy.api#Unit" }, "output": { "target": "com.amazonaws.ssmguiconnect#GetConnectionRecordingPreferencesResponse" }, "errors": [ { "target": "com.amazonaws.ssmguiconnect#AccessDeniedException" }, { "target": "com.amazonaws.ssmguiconnect#ConflictException" }, { "target": "com.amazonaws.ssmguiconnect#InternalServerException" }, { "target": "com.amazonaws.ssmguiconnect#ResourceNotFoundException" }, { "target": "com.amazonaws.ssmguiconnect#ServiceQuotaExceededException" }, { "target": "com.amazonaws.ssmguiconnect#ThrottlingException" }, { "target": "com.amazonaws.ssmguiconnect#ValidationException" } ], "traits": { "smithy.api#documentation": "Returns the preferences specified for recording RDP connections in the requesting Amazon Web Services account and Amazon Web Services Region.
", "smithy.api#examples": [ { "title": "Retrieves the connection recording preferences for the account", "output": { "ConnectionRecordingPreferences": { "RecordingDestinations": { "S3Buckets": [ { "BucketOwner": "123456789012", "BucketName": "sample-connection-recording-bucket" } ] }, "KMSKeyArn": "arn:aws:kms:region:account_id:key/sample_key_id" }, "ClientToken": "sample_uuid" } } ], "smithy.api#http": { "uri": "/GetConnectionRecordingPreferences", "method": "POST" }, "smithy.api#readonly": {}, "smithy.test#smokeTests": [ { "id": "GetConnectionRecordingPreferencesSuccess", "params": {}, "expect": { "success": {} }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-east-1" } } ] } }, "com.amazonaws.ssmguiconnect#GetConnectionRecordingPreferencesResponse": { "type": "structure", "members": { "ClientToken": { "target": "com.amazonaws.ssmguiconnect#ClientToken", "traits": { "smithy.api#documentation": "Service-provided idempotency token.
" } }, "ConnectionRecordingPreferences": { "target": "com.amazonaws.ssmguiconnect#ConnectionRecordingPreferences", "traits": { "smithy.api#documentation": "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.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.ssmguiconnect#InternalServerException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.ssmguiconnect#ErrorMessage", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The request processing has failed because of an unknown error, exception or failure.
", "smithy.api#error": "server", "smithy.api#httpError": 500 } }, "com.amazonaws.ssmguiconnect#ModifyConnectionPreferences": { "type": "resource" }, "com.amazonaws.ssmguiconnect#ModifyRecordingPreferences": { "type": "resource", "read": { "target": "com.amazonaws.ssmguiconnect#GetConnectionRecordingPreferences" }, "delete": { "target": "com.amazonaws.ssmguiconnect#DeleteConnectionRecordingPreferences" } }, "com.amazonaws.ssmguiconnect#RecordingDestinations": { "type": "structure", "members": { "S3Buckets": { "target": "com.amazonaws.ssmguiconnect#S3Buckets", "traits": { "smithy.api#documentation": "The S3 bucket where RDP connection recordings are stored.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Determines where recordings of RDP connections are stored.
" } }, "com.amazonaws.ssmguiconnect#RecordingPreferences": { "type": "resource", "identifiers": { "AccountId": { "target": "com.amazonaws.ssmguiconnect#AccountId" } }, "create": { "target": "com.amazonaws.ssmguiconnect#UpdateConnectionRecordingPreferences" } }, "com.amazonaws.ssmguiconnect#ResourceNotFoundException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.ssmguiconnect#ErrorMessage", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The resource could not be found.
", "smithy.api#error": "client", "smithy.api#httpError": 404 } }, "com.amazonaws.ssmguiconnect#S3Bucket": { "type": "structure", "members": { "BucketOwner": { "target": "com.amazonaws.ssmguiconnect#AccountId", "traits": { "smithy.api#documentation": "The Amazon Web Services account number that owns the S3 bucket.
", "smithy.api#required": {} } }, "BucketName": { "target": "com.amazonaws.ssmguiconnect#BucketName", "traits": { "smithy.api#documentation": "The name of the S3 bucket where RDP connection recordings are stored.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The S3 bucket where RDP connection recordings are stored.
" } }, "com.amazonaws.ssmguiconnect#S3Buckets": { "type": "list", "member": { "target": "com.amazonaws.ssmguiconnect#S3Bucket" }, "traits": { "smithy.api#length": { "min": 1, "max": 1 } } }, "com.amazonaws.ssmguiconnect#SSMGuiConnect": { "type": "service", "version": "2021-05-01", "resources": [ { "target": "com.amazonaws.ssmguiconnect#Connection" }, { "target": "com.amazonaws.ssmguiconnect#ConnectionAccess" }, { "target": "com.amazonaws.ssmguiconnect#ConnectionPreferences" }, { "target": "com.amazonaws.ssmguiconnect#ConnectionsCollection" }, { "target": "com.amazonaws.ssmguiconnect#ModifyConnectionPreferences" }, { "target": "com.amazonaws.ssmguiconnect#ModifyRecordingPreferences" }, { "target": "com.amazonaws.ssmguiconnect#RecordingPreferences" } ], "traits": { "aws.api#controlPlane": {}, "aws.api#service": { "sdkId": "SSM GuiConnect", "arnNamespace": "ssm-guiconnect" }, "aws.auth#sigv4": { "name": "ssm-guiconnect" }, "aws.protocols#restJson1": {}, "smithy.api#cors": { "additionalAllowedHeaders": [ "*", "content-type", "x-amz-content-sha256", "x-amz-user-agent", "x-amzn-platform-id", "x-amzn-trace-id" ], "additionalExposedHeaders": [ "x-amzn-errortype", "x-amzn-requestid", "x-amzn-trace-id" ], "maxAge": 86400 }, "smithy.api#documentation": "Systems Manager GUI Connect, a component of Fleet Manager, lets you connect to your Window\n Server-type Amazon Elastic Compute Cloud (Amazon EC2) instances using the Remote Desktop Protocol (RDP). GUI\n Connect, which is powered by Amazon DCV, provides you\n with secure connectivity to your Windows Server instances directly from the Systems Manager console.\n You can have up to four simultaneous connections in a single browser window. In the\n console, GUI Connect is also referred to as Fleet Manager Remote Desktop.
\nThis reference is intended to be used with the \n Amazon Web Services Systems Manager User\n Guide\n . To get started, see the following user guide topics:
\n\n Connect to a Windows Server managed instance using Remote Desktop\n
\nYour request exceeds a service quota.
", "smithy.api#error": "client", "smithy.api#httpError": 402 } }, "com.amazonaws.ssmguiconnect#ThrottlingException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.ssmguiconnect#ErrorMessage", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The request was denied due to request throttling.
", "smithy.api#error": "client", "smithy.api#httpError": 429 } }, "com.amazonaws.ssmguiconnect#UpdateConnectionRecordingPreferences": { "type": "operation", "input": { "target": "com.amazonaws.ssmguiconnect#UpdateConnectionRecordingPreferencesRequest" }, "output": { "target": "com.amazonaws.ssmguiconnect#UpdateConnectionRecordingPreferencesResponse" }, "errors": [ { "target": "com.amazonaws.ssmguiconnect#AccessDeniedException" }, { "target": "com.amazonaws.ssmguiconnect#ConflictException" }, { "target": "com.amazonaws.ssmguiconnect#InternalServerException" }, { "target": "com.amazonaws.ssmguiconnect#ResourceNotFoundException" }, { "target": "com.amazonaws.ssmguiconnect#ServiceQuotaExceededException" }, { "target": "com.amazonaws.ssmguiconnect#ThrottlingException" }, { "target": "com.amazonaws.ssmguiconnect#ValidationException" } ], "traits": { "smithy.api#documentation": "Updates the preferences for recording RDP connections.
", "smithy.api#examples": [ { "title": "Updates the connection recording preferences for the account", "input": { "ConnectionRecordingPreferences": { "RecordingDestinations": { "S3Buckets": [ { "BucketOwner": "123456789012", "BucketName": "sample-connection-recording-bucket" } ] }, "KMSKeyArn": "arn:aws:kms:region:account_id:key/sample_key_id" } }, "output": { "ConnectionRecordingPreferences": { "RecordingDestinations": { "S3Buckets": [ { "BucketOwner": "123456789012", "BucketName": "sample-connection-recording-bucket" } ] }, "KMSKeyArn": "arn:aws:kms:region:account_id:key/sample_key_id" }, "ClientToken": "sample_uuid" } } ], "smithy.api#http": { "uri": "/UpdateConnectionRecordingPreferences", "method": "POST" }, "smithy.api#idempotent": {}, "smithy.test#smokeTests": [ { "id": "UpdateConnectionRecordingPreferencesSuccess", "params": { "ConnectionRecordingPreferences": { "RecordingDestinations": { "S3Buckets": [ { "BucketOwner": "111122223333", "BucketName": "test-bucket" } ] }, "KMSKeyArn": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" } }, "expect": { "success": {} }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-east-1" } } ] } }, "com.amazonaws.ssmguiconnect#UpdateConnectionRecordingPreferencesRequest": { "type": "structure", "members": { "ConnectionRecordingPreferences": { "target": "com.amazonaws.ssmguiconnect#ConnectionRecordingPreferences", "traits": { "smithy.api#documentation": "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.
", "smithy.api#required": {} } }, "ClientToken": { "target": "com.amazonaws.ssmguiconnect#ClientToken", "traits": { "smithy.api#documentation": "User-provided idempotency token.
", "smithy.api#idempotencyToken": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.ssmguiconnect#UpdateConnectionRecordingPreferencesResponse": { "type": "structure", "members": { "ClientToken": { "target": "com.amazonaws.ssmguiconnect#ClientToken", "traits": { "smithy.api#documentation": "Service-provided idempotency token.
" } }, "ConnectionRecordingPreferences": { "target": "com.amazonaws.ssmguiconnect#ConnectionRecordingPreferences", "traits": { "smithy.api#documentation": "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.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.ssmguiconnect#ValidationException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.ssmguiconnect#ErrorMessage", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The input fails to satisfy the constraints specified by an AWS service.
", "smithy.api#error": "client", "smithy.api#httpError": 400 } } } }