Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . qldb-session ]

send-command

Description

Sends a command to an Amazon QLDB ledger.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  send-command
[--session-token <value>]
[--start-session <value>]
[--start-transaction <value>]
[--end-session <value>]
[--commit-transaction <value>]
[--abort-transaction <value>]
[--execute-statement <value>]
[--fetch-page <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--session-token (string)

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

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

--start-session (structure)

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

Shorthand Syntax:

LedgerName=string

JSON Syntax:

{
  "LedgerName": "string"
}

--start-transaction (structure)

Command to start a new transaction.

JSON Syntax:

{

}

--end-session (structure)

Command to end the current session.

JSON Syntax:

{

}

--commit-transaction (structure)

Command to commit the specified transaction.

Shorthand Syntax:

TransactionId=string,CommitDigest=blob

JSON Syntax:

{
  "TransactionId": "string",
  "CommitDigest": blob
}

--abort-transaction (structure)

Command to abort the current transaction.

JSON Syntax:

{

}

--execute-statement (structure)

Command to execute a statement in the specified transaction.

Shorthand Syntax:

TransactionId=string,Statement=string,Parameters=[{IonBinary=blob,IonText=string},{IonBinary=blob,IonText=string}]

JSON Syntax:

{
  "TransactionId": "string",
  "Statement": "string",
  "Parameters": [
    {
      "IonBinary": blob,
      "IonText": "string"
    }
    ...
  ]
}

--fetch-page (structure)

Command to fetch a page.

Shorthand Syntax:

TransactionId=string,NextPageToken=string

JSON Syntax:

{
  "TransactionId": "string",
  "NextPageToken": "string"
}

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Output

StartSession -> (structure)

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

SessionToken -> (string)

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

StartTransaction -> (structure)

Contains the details of the started transaction.

TransactionId -> (string)

The transaction id of the started transaction.

EndSession -> (structure)

Contains the details of the ended session.

CommitTransaction -> (structure)

Contains the details of the committed transaction.

TransactionId -> (string)

The transaction id of the committed transaction.

CommitDigest -> (blob)

The commit digest of the committed transaction.

AbortTransaction -> (structure)

Contains the details of the aborted transaction.

ExecuteStatement -> (structure)

Contains the details of the executed statement.

FirstPage -> (structure)

Contains the details of the first fetched page.

Values -> (list)

A structure that contains values in multiple encoding formats.

(structure)

A structure that can contains values in multiple encoding formats.

IonBinary -> (blob)

An Amazon Ion binary value contained in a ValueHolder structure.

IonText -> (string)

An Amazon Ion plaintext value contained in a ValueHolder structure.

NextPageToken -> (string)

The token of the next page.

FetchPage -> (structure)

Contains the details of the fetched page.

Page -> (structure)

Contains details of the fetched page.

Values -> (list)

A structure that contains values in multiple encoding formats.

(structure)

A structure that can contains values in multiple encoding formats.

IonBinary -> (blob)

An Amazon Ion binary value contained in a ValueHolder structure.

IonText -> (string)

An Amazon Ion plaintext value contained in a ValueHolder structure.

NextPageToken -> (string)

The token of the next page.