{ "smithy": "1.0", "metadata": { "suppressions": [ { "id": "HttpMethodSemantics", "namespace": "*" }, { "id": "HttpResponseCodeSemantics", "namespace": "*" }, { "id": "PaginatedTrait", "namespace": "*" }, { "id": "HttpHeaderTrait", "namespace": "*" }, { "id": "HttpUriConflict", "namespace": "*" }, { "id": "Service", "namespace": "*" } ] }, "shapes": { "com.amazonaws.qldbsession#AbortTransactionRequest": { "type": "structure", "members": {}, "traits": { "smithy.api#documentation": "

Contains the details of the transaction to abort.

" } }, "com.amazonaws.qldbsession#AbortTransactionResult": { "type": "structure", "members": { "TimingInformation": { "target": "com.amazonaws.qldbsession#TimingInformation", "traits": { "smithy.api#documentation": "

Contains server-side performance information for the command.

" } } }, "traits": { "smithy.api#documentation": "

Contains the details of the aborted transaction.

" } }, "com.amazonaws.qldbsession#BadRequestException": { "type": "structure", "members": { "Message": { "target": "com.amazonaws.qldbsession#ErrorMessage" }, "Code": { "target": "com.amazonaws.qldbsession#ErrorCode" } }, "traits": { "smithy.api#documentation": "

Returned if the request is malformed or contains an error such as an invalid parameter\n value or a missing required parameter.

", "smithy.api#error": "client" } }, "com.amazonaws.qldbsession#CapacityExceededException": { "type": "structure", "members": { "Message": { "target": "com.amazonaws.qldbsession#ErrorMessage" } }, "traits": { "smithy.api#documentation": "

Returned when the request exceeds the processing capacity of the ledger.

", "smithy.api#error": "server", "smithy.api#httpError": 503 } }, "com.amazonaws.qldbsession#CommitDigest": { "type": "blob" }, "com.amazonaws.qldbsession#CommitTransactionRequest": { "type": "structure", "members": { "TransactionId": { "target": "com.amazonaws.qldbsession#TransactionId", "traits": { "smithy.api#documentation": "

Specifies the transaction ID of the transaction to commit.

", "smithy.api#required": {} } }, "CommitDigest": { "target": "com.amazonaws.qldbsession#CommitDigest", "traits": { "smithy.api#documentation": "

Specifies the commit digest for the transaction to commit. For every active transaction,\n the commit digest must be passed. QLDB validates CommitDigest and rejects\n the commit with an error if the digest computed on the client does not match the digest\n computed by QLDB.

\n

The purpose of the CommitDigest parameter is to ensure that QLDB commits\n a transaction if and only if the server has processed the exact set of statements sent by\n the client, in the same order that client sent them, and with no duplicates.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Contains the details of the transaction to commit.

" } }, "com.amazonaws.qldbsession#CommitTransactionResult": { "type": "structure", "members": { "TransactionId": { "target": "com.amazonaws.qldbsession#TransactionId", "traits": { "smithy.api#documentation": "

The transaction ID of the committed transaction.

" } }, "CommitDigest": { "target": "com.amazonaws.qldbsession#CommitDigest", "traits": { "smithy.api#documentation": "

The commit digest of the committed transaction.

" } }, "TimingInformation": { "target": "com.amazonaws.qldbsession#TimingInformation", "traits": { "smithy.api#documentation": "

Contains server-side performance information for the command.

" } }, "ConsumedIOs": { "target": "com.amazonaws.qldbsession#IOUsage", "traits": { "smithy.api#documentation": "

Contains metrics about the number of I/O requests that were consumed.

" } } }, "traits": { "smithy.api#documentation": "

Contains the details of the committed transaction.

" } }, "com.amazonaws.qldbsession#EndSessionRequest": { "type": "structure", "members": {}, "traits": { "smithy.api#documentation": "

Specifies a request to end the session.

" } }, "com.amazonaws.qldbsession#EndSessionResult": { "type": "structure", "members": { "TimingInformation": { "target": "com.amazonaws.qldbsession#TimingInformation", "traits": { "smithy.api#documentation": "

Contains server-side performance information for the command.

" } } }, "traits": { "smithy.api#documentation": "

Contains the details of the ended session.

" } }, "com.amazonaws.qldbsession#ErrorCode": { "type": "string" }, "com.amazonaws.qldbsession#ErrorMessage": { "type": "string" }, "com.amazonaws.qldbsession#ExecuteStatementRequest": { "type": "structure", "members": { "TransactionId": { "target": "com.amazonaws.qldbsession#TransactionId", "traits": { "smithy.api#documentation": "

Specifies the transaction ID of the request.

", "smithy.api#required": {} } }, "Statement": { "target": "com.amazonaws.qldbsession#Statement", "traits": { "smithy.api#documentation": "

Specifies the statement of the request.

", "smithy.api#required": {} } }, "Parameters": { "target": "com.amazonaws.qldbsession#StatementParameters", "traits": { "smithy.api#documentation": "

Specifies the parameters for the parameterized statement in the request.

" } } }, "traits": { "smithy.api#documentation": "

Specifies a request to execute a statement.

" } }, "com.amazonaws.qldbsession#ExecuteStatementResult": { "type": "structure", "members": { "FirstPage": { "target": "com.amazonaws.qldbsession#Page", "traits": { "smithy.api#documentation": "

Contains the details of the first fetched page.

" } }, "TimingInformation": { "target": "com.amazonaws.qldbsession#TimingInformation", "traits": { "smithy.api#documentation": "

Contains server-side performance information for the command.

" } }, "ConsumedIOs": { "target": "com.amazonaws.qldbsession#IOUsage", "traits": { "smithy.api#documentation": "

Contains metrics about the number of I/O requests that were consumed.

" } } }, "traits": { "smithy.api#documentation": "

Contains the details of the executed statement.

" } }, "com.amazonaws.qldbsession#FetchPageRequest": { "type": "structure", "members": { "TransactionId": { "target": "com.amazonaws.qldbsession#TransactionId", "traits": { "smithy.api#documentation": "

Specifies the transaction ID of the page to be fetched.

", "smithy.api#required": {} } }, "NextPageToken": { "target": "com.amazonaws.qldbsession#PageToken", "traits": { "smithy.api#documentation": "

Specifies the next page token of the page to be fetched.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Specifies the details of the page to be fetched.

" } }, "com.amazonaws.qldbsession#FetchPageResult": { "type": "structure", "members": { "Page": { "target": "com.amazonaws.qldbsession#Page", "traits": { "smithy.api#documentation": "

Contains details of the fetched page.

" } }, "TimingInformation": { "target": "com.amazonaws.qldbsession#TimingInformation", "traits": { "smithy.api#documentation": "

Contains server-side performance information for the command.

" } }, "ConsumedIOs": { "target": "com.amazonaws.qldbsession#IOUsage", "traits": { "smithy.api#documentation": "

Contains metrics about the number of I/O requests that were consumed.

" } } }, "traits": { "smithy.api#documentation": "

Contains the page that was fetched.

" } }, "com.amazonaws.qldbsession#IOUsage": { "type": "structure", "members": { "ReadIOs": { "target": "com.amazonaws.qldbsession#ReadIOs", "traits": { "smithy.api#documentation": "

The number of read I/O requests that the command made.

" } }, "WriteIOs": { "target": "com.amazonaws.qldbsession#WriteIOs", "traits": { "smithy.api#documentation": "

The number of write I/O requests that the command made.

" } } }, "traits": { "smithy.api#documentation": "

Contains I/O usage metrics for a command that was invoked.

" } }, "com.amazonaws.qldbsession#InvalidSessionException": { "type": "structure", "members": { "Message": { "target": "com.amazonaws.qldbsession#ErrorMessage" }, "Code": { "target": "com.amazonaws.qldbsession#ErrorCode" } }, "traits": { "smithy.api#documentation": "

Returned if the session doesn't exist anymore because it timed out or expired.

", "smithy.api#error": "client" } }, "com.amazonaws.qldbsession#IonBinary": { "type": "blob", "traits": { "smithy.api#length": { "min": 1, "max": 131072 } } }, "com.amazonaws.qldbsession#IonText": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 1048576 } } }, "com.amazonaws.qldbsession#LedgerName": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 32 }, "smithy.api#pattern": "(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$" } }, "com.amazonaws.qldbsession#LimitExceededException": { "type": "structure", "members": { "Message": { "target": "com.amazonaws.qldbsession#ErrorMessage" } }, "traits": { "smithy.api#documentation": "

Returned if a resource limit such as number of active sessions is exceeded.

", "smithy.api#error": "client" } }, "com.amazonaws.qldbsession#OccConflictException": { "type": "structure", "members": { "Message": { "target": "com.amazonaws.qldbsession#ErrorMessage" } }, "traits": { "smithy.api#documentation": "

Returned when a transaction cannot be written to the journal due to a failure in the\n verification phase of optimistic concurrency control (OCC).

", "smithy.api#error": "client" } }, "com.amazonaws.qldbsession#Page": { "type": "structure", "members": { "Values": { "target": "com.amazonaws.qldbsession#ValueHolders", "traits": { "smithy.api#documentation": "

A structure that contains values in multiple encoding formats.

" } }, "NextPageToken": { "target": "com.amazonaws.qldbsession#PageToken", "traits": { "smithy.api#documentation": "

The token of the next page.

" } } }, "traits": { "smithy.api#documentation": "

Contains details of the fetched page.

" } }, "com.amazonaws.qldbsession#PageToken": { "type": "string", "traits": { "smithy.api#length": { "min": 4, "max": 1024 }, "smithy.api#pattern": "^[A-Za-z-0-9+/=]+$" } }, "com.amazonaws.qldbsession#ProcessingTimeMilliseconds": { "type": "long" }, "com.amazonaws.qldbsession#QLDBSession": { "type": "service", "version": "2019-07-11", "operations": [ { "target": "com.amazonaws.qldbsession#SendCommand" } ], "traits": { "aws.api#service": { "sdkId": "QLDB Session", "arnNamespace": "qldb", "cloudFormationName": "QLDBSession", "cloudTrailEventSource": "qldbsession.amazonaws.com", "endpointPrefix": "session.qldb" }, "aws.auth#sigv4": { "name": "qldb" }, "aws.protocols#awsJson1_0": {}, "smithy.api#documentation": "

The transactional data APIs for Amazon QLDB

\n \n

Instead of interacting directly with this API, we recommend using the QLDB driver\n or the QLDB shell to execute data transactions on a ledger.

\n \n
", "smithy.api#title": "Amazon QLDB Session" } }, "com.amazonaws.qldbsession#RateExceededException": { "type": "structure", "members": { "Message": { "target": "com.amazonaws.qldbsession#ErrorMessage" } }, "traits": { "smithy.api#documentation": "

Returned when the rate of requests exceeds the allowed throughput.

", "smithy.api#error": "client" } }, "com.amazonaws.qldbsession#ReadIOs": { "type": "long" }, "com.amazonaws.qldbsession#SendCommand": { "type": "operation", "input": { "target": "com.amazonaws.qldbsession#SendCommandRequest" }, "output": { "target": "com.amazonaws.qldbsession#SendCommandResult" }, "errors": [ { "target": "com.amazonaws.qldbsession#BadRequestException" }, { "target": "com.amazonaws.qldbsession#CapacityExceededException" }, { "target": "com.amazonaws.qldbsession#InvalidSessionException" }, { "target": "com.amazonaws.qldbsession#LimitExceededException" }, { "target": "com.amazonaws.qldbsession#OccConflictException" }, { "target": "com.amazonaws.qldbsession#RateExceededException" } ], "traits": { "smithy.api#documentation": "

Sends a command to an Amazon QLDB ledger.

\n \n

Instead of interacting directly with this API, we recommend using the QLDB driver\n or the QLDB shell to execute data transactions on a ledger.

\n \n
" } }, "com.amazonaws.qldbsession#SendCommandRequest": { "type": "structure", "members": { "SessionToken": { "target": "com.amazonaws.qldbsession#SessionToken", "traits": { "smithy.api#documentation": "

Specifies the session token for the current command. A session token is constant\n throughout the life of the session.

\n

To obtain a session token, run the StartSession command. This\n SessionToken is required for every subsequent command that is issued during\n the current session.

" } }, "StartSession": { "target": "com.amazonaws.qldbsession#StartSessionRequest", "traits": { "smithy.api#documentation": "

Command to start a new session. A session token is obtained as part of the\n response.

" } }, "StartTransaction": { "target": "com.amazonaws.qldbsession#StartTransactionRequest", "traits": { "smithy.api#documentation": "

Command to start a new transaction.

" } }, "EndSession": { "target": "com.amazonaws.qldbsession#EndSessionRequest", "traits": { "smithy.api#documentation": "

Command to end the current session.

" } }, "CommitTransaction": { "target": "com.amazonaws.qldbsession#CommitTransactionRequest", "traits": { "smithy.api#documentation": "

Command to commit the specified transaction.

" } }, "AbortTransaction": { "target": "com.amazonaws.qldbsession#AbortTransactionRequest", "traits": { "smithy.api#documentation": "

Command to abort the current transaction.

" } }, "ExecuteStatement": { "target": "com.amazonaws.qldbsession#ExecuteStatementRequest", "traits": { "smithy.api#documentation": "

Command to execute a statement in the specified transaction.

" } }, "FetchPage": { "target": "com.amazonaws.qldbsession#FetchPageRequest", "traits": { "smithy.api#documentation": "

Command to fetch a page.

" } } } }, "com.amazonaws.qldbsession#SendCommandResult": { "type": "structure", "members": { "StartSession": { "target": "com.amazonaws.qldbsession#StartSessionResult", "traits": { "smithy.api#documentation": "

Contains the details of the started session that includes a session token. This\n SessionToken is required for every subsequent command that is issued during\n the current session.

" } }, "StartTransaction": { "target": "com.amazonaws.qldbsession#StartTransactionResult", "traits": { "smithy.api#documentation": "

Contains the details of the started transaction.

" } }, "EndSession": { "target": "com.amazonaws.qldbsession#EndSessionResult", "traits": { "smithy.api#documentation": "

Contains the details of the ended session.

" } }, "CommitTransaction": { "target": "com.amazonaws.qldbsession#CommitTransactionResult", "traits": { "smithy.api#documentation": "

Contains the details of the committed transaction.

" } }, "AbortTransaction": { "target": "com.amazonaws.qldbsession#AbortTransactionResult", "traits": { "smithy.api#documentation": "

Contains the details of the aborted transaction.

" } }, "ExecuteStatement": { "target": "com.amazonaws.qldbsession#ExecuteStatementResult", "traits": { "smithy.api#documentation": "

Contains the details of the executed statement.

" } }, "FetchPage": { "target": "com.amazonaws.qldbsession#FetchPageResult", "traits": { "smithy.api#documentation": "

Contains the details of the fetched page.

" } } } }, "com.amazonaws.qldbsession#SessionToken": { "type": "string", "traits": { "smithy.api#length": { "min": 4, "max": 1024 }, "smithy.api#pattern": "^[A-Za-z-0-9+/=]+$" } }, "com.amazonaws.qldbsession#StartSessionRequest": { "type": "structure", "members": { "LedgerName": { "target": "com.amazonaws.qldbsession#LedgerName", "traits": { "smithy.api#documentation": "

The name of the ledger to start a new session against.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Specifies a request to start a new session.

" } }, "com.amazonaws.qldbsession#StartSessionResult": { "type": "structure", "members": { "SessionToken": { "target": "com.amazonaws.qldbsession#SessionToken", "traits": { "smithy.api#documentation": "

Session token of the started session. This SessionToken is required for\n every subsequent command that is issued during the current session.

" } }, "TimingInformation": { "target": "com.amazonaws.qldbsession#TimingInformation", "traits": { "smithy.api#documentation": "

Contains server-side performance information for the command.

" } } }, "traits": { "smithy.api#documentation": "

Contains the details of the started session.

" } }, "com.amazonaws.qldbsession#StartTransactionRequest": { "type": "structure", "members": {}, "traits": { "smithy.api#documentation": "

Specifies a request to start a transaction.

" } }, "com.amazonaws.qldbsession#StartTransactionResult": { "type": "structure", "members": { "TransactionId": { "target": "com.amazonaws.qldbsession#TransactionId", "traits": { "smithy.api#documentation": "

The transaction ID of the started transaction.

" } }, "TimingInformation": { "target": "com.amazonaws.qldbsession#TimingInformation", "traits": { "smithy.api#documentation": "

Contains server-side performance information for the command.

" } } }, "traits": { "smithy.api#documentation": "

Contains the details of the started transaction.

" } }, "com.amazonaws.qldbsession#Statement": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 100000 } } }, "com.amazonaws.qldbsession#StatementParameters": { "type": "list", "member": { "target": "com.amazonaws.qldbsession#ValueHolder" } }, "com.amazonaws.qldbsession#TimingInformation": { "type": "structure", "members": { "ProcessingTimeMilliseconds": { "target": "com.amazonaws.qldbsession#ProcessingTimeMilliseconds", "traits": { "smithy.api#documentation": "

The amount of time that QLDB spent on processing the command, measured in\n milliseconds.

" } } }, "traits": { "smithy.api#documentation": "

Contains server-side performance information for a command. Amazon QLDB captures timing\n information between the times when it receives the request and when it sends the\n corresponding response.

" } }, "com.amazonaws.qldbsession#TransactionId": { "type": "string", "traits": { "smithy.api#length": { "min": 22, "max": 22 }, "smithy.api#pattern": "^[A-Za-z-0-9]+$" } }, "com.amazonaws.qldbsession#ValueHolder": { "type": "structure", "members": { "IonBinary": { "target": "com.amazonaws.qldbsession#IonBinary", "traits": { "smithy.api#documentation": "

An Amazon Ion binary value contained in a ValueHolder structure.

" } }, "IonText": { "target": "com.amazonaws.qldbsession#IonText", "traits": { "smithy.api#documentation": "

An Amazon Ion plaintext value contained in a ValueHolder structure.

" } } }, "traits": { "smithy.api#documentation": "

A structure that can contain a value in multiple encoding formats.

" } }, "com.amazonaws.qldbsession#ValueHolders": { "type": "list", "member": { "target": "com.amazonaws.qldbsession#ValueHolder" } }, "com.amazonaws.qldbsession#WriteIOs": { "type": "long" } } }