python-botocore/botocore/data/rds-data/2018-08-01/service-2.json
2022-12-12 08:14:19 -08:00

940 lines
38 KiB
JSON

{
"version":"2.0",
"metadata":{
"apiVersion":"2018-08-01",
"endpointPrefix":"rds-data",
"jsonVersion":"1.1",
"protocol":"rest-json",
"serviceFullName":"AWS RDS DataService",
"serviceId":"RDS Data",
"signatureVersion":"v4",
"signingName":"rds-data",
"uid":"rds-data-2018-08-01"
},
"operations":{
"BatchExecuteStatement":{
"name":"BatchExecuteStatement",
"http":{
"method":"POST",
"requestUri":"/BatchExecute",
"responseCode":200
},
"input":{"shape":"BatchExecuteStatementRequest"},
"output":{"shape":"BatchExecuteStatementResponse"},
"errors":[
{"shape":"AccessDeniedException"},
{"shape":"BadRequestException"},
{"shape":"StatementTimeoutException"},
{"shape":"InternalServerErrorException"},
{"shape":"ForbiddenException"},
{"shape":"ServiceUnavailableError"}
],
"documentation":"<p>Runs a batch SQL statement over an array of data.</p> <p>You can run bulk update and insert operations for multiple records using a DML statement with different parameter sets. Bulk operations can provide a significant performance improvement over individual insert and update operations.</p> <note> <p>If a call isn't part of a transaction because it doesn't include the <code>transactionID</code> parameter, changes that result from the call are committed automatically.</p> <p>There isn't a fixed upper limit on the number of parameter sets. However, the maximum size of the HTTP request submitted through the Data API is 4 MiB. If the request exceeds this limit, the Data API returns an error and doesn't process the request. This 4-MiB limit includes the size of the HTTP headers and the JSON notation in the request. Thus, the number of parameter sets that you can include depends on a combination of factors, such as the size of the SQL statement and the size of each parameter set.</p> <p>The response size limit is 1 MiB. If the call returns more than 1 MiB of response data, the call is terminated.</p> </note>"
},
"BeginTransaction":{
"name":"BeginTransaction",
"http":{
"method":"POST",
"requestUri":"/BeginTransaction",
"responseCode":200
},
"input":{"shape":"BeginTransactionRequest"},
"output":{"shape":"BeginTransactionResponse"},
"errors":[
{"shape":"AccessDeniedException"},
{"shape":"BadRequestException"},
{"shape":"StatementTimeoutException"},
{"shape":"InternalServerErrorException"},
{"shape":"ForbiddenException"},
{"shape":"ServiceUnavailableError"}
],
"documentation":"<p>Starts a SQL transaction.</p> <note> <p>A transaction can run for a maximum of 24 hours. A transaction is terminated and rolled back automatically after 24 hours.</p> <p>A transaction times out if no calls use its transaction ID in three minutes. If a transaction times out before it's committed, it's rolled back automatically.</p> <p>DDL statements inside a transaction cause an implicit commit. We recommend that you run each DDL statement in a separate <code>ExecuteStatement</code> call with <code>continueAfterTimeout</code> enabled.</p> </note>"
},
"CommitTransaction":{
"name":"CommitTransaction",
"http":{
"method":"POST",
"requestUri":"/CommitTransaction",
"responseCode":200
},
"input":{"shape":"CommitTransactionRequest"},
"output":{"shape":"CommitTransactionResponse"},
"errors":[
{"shape":"AccessDeniedException"},
{"shape":"BadRequestException"},
{"shape":"StatementTimeoutException"},
{"shape":"InternalServerErrorException"},
{"shape":"ForbiddenException"},
{"shape":"ServiceUnavailableError"},
{"shape":"NotFoundException"}
],
"documentation":"<p>Ends a SQL transaction started with the <code>BeginTransaction</code> operation and commits the changes.</p>"
},
"ExecuteSql":{
"name":"ExecuteSql",
"http":{
"method":"POST",
"requestUri":"/ExecuteSql",
"responseCode":200
},
"input":{"shape":"ExecuteSqlRequest"},
"output":{"shape":"ExecuteSqlResponse"},
"errors":[
{"shape":"AccessDeniedException"},
{"shape":"BadRequestException"},
{"shape":"InternalServerErrorException"},
{"shape":"ForbiddenException"},
{"shape":"ServiceUnavailableError"}
],
"documentation":"<p>Runs one or more SQL statements.</p> <note> <p>This operation is deprecated. Use the <code>BatchExecuteStatement</code> or <code>ExecuteStatement</code> operation.</p> </note>",
"deprecated":true,
"deprecatedMessage":"The ExecuteSql API is deprecated, please use the ExecuteStatement API."
},
"ExecuteStatement":{
"name":"ExecuteStatement",
"http":{
"method":"POST",
"requestUri":"/Execute",
"responseCode":200
},
"input":{"shape":"ExecuteStatementRequest"},
"output":{"shape":"ExecuteStatementResponse"},
"errors":[
{"shape":"AccessDeniedException"},
{"shape":"BadRequestException"},
{"shape":"StatementTimeoutException"},
{"shape":"InternalServerErrorException"},
{"shape":"ForbiddenException"},
{"shape":"ServiceUnavailableError"}
],
"documentation":"<p>Runs a SQL statement against a database.</p> <note> <p>If a call isn't part of a transaction because it doesn't include the <code>transactionID</code> parameter, changes that result from the call are committed automatically.</p> <p>If the binary response data from the database is more than 1 MB, the call is terminated.</p> </note>"
},
"RollbackTransaction":{
"name":"RollbackTransaction",
"http":{
"method":"POST",
"requestUri":"/RollbackTransaction",
"responseCode":200
},
"input":{"shape":"RollbackTransactionRequest"},
"output":{"shape":"RollbackTransactionResponse"},
"errors":[
{"shape":"AccessDeniedException"},
{"shape":"BadRequestException"},
{"shape":"StatementTimeoutException"},
{"shape":"InternalServerErrorException"},
{"shape":"ForbiddenException"},
{"shape":"ServiceUnavailableError"},
{"shape":"NotFoundException"}
],
"documentation":"<p>Performs a rollback of a transaction. Rolling back a transaction cancels its changes.</p>"
}
},
"shapes":{
"AccessDeniedException":{
"type":"structure",
"members":{
"message":{"shape":"ErrorMessage"}
},
"documentation":"<p>You do not have sufficient access to perform this action.</p>",
"error":{
"httpStatusCode":403,
"senderFault":true
},
"exception":true
},
"Arn":{
"type":"string",
"max":100,
"min":11
},
"ArrayOfArray":{
"type":"list",
"member":{"shape":"ArrayValue"},
"documentation":"<p>An array of arrays.</p> <note> <p>Some array entries can be null.</p> </note>"
},
"ArrayValue":{
"type":"structure",
"members":{
"booleanValues":{
"shape":"BooleanArray",
"documentation":"<p>An array of Boolean values.</p>"
},
"longValues":{
"shape":"LongArray",
"documentation":"<p>An array of integers.</p>"
},
"doubleValues":{
"shape":"DoubleArray",
"documentation":"<p>An array of floating-point numbers.</p>"
},
"stringValues":{
"shape":"StringArray",
"documentation":"<p>An array of strings.</p>"
},
"arrayValues":{
"shape":"ArrayOfArray",
"documentation":"<p>An array of arrays.</p>"
}
},
"documentation":"<p>Contains an array.</p>",
"union":true
},
"ArrayValueList":{
"type":"list",
"member":{"shape":"Value"}
},
"BadRequestException":{
"type":"structure",
"members":{
"message":{
"shape":"ErrorMessage",
"documentation":"<p>The error message returned by this <code>BadRequestException</code> error.</p>"
}
},
"documentation":"<p>There is an error in the call or in a SQL statement.</p>",
"error":{
"httpStatusCode":400,
"senderFault":true
},
"exception":true
},
"BatchExecuteStatementRequest":{
"type":"structure",
"required":[
"resourceArn",
"secretArn",
"sql"
],
"members":{
"resourceArn":{
"shape":"Arn",
"documentation":"<p>The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.</p>"
},
"secretArn":{
"shape":"Arn",
"documentation":"<p>The ARN of the secret that enables access to the DB cluster. Enter the database user name and password for the credentials in the secret.</p> <p>For information about creating the secret, see <a href=\"https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_database_secret.html\">Create a database secret</a>.</p>"
},
"sql":{
"shape":"SqlStatement",
"documentation":"<p>The SQL statement to run. Don't include a semicolon (;) at the end of the SQL statement.</p>"
},
"database":{
"shape":"DbName",
"documentation":"<p>The name of the database.</p>"
},
"schema":{
"shape":"DbName",
"documentation":"<p>The name of the database schema.</p> <note> <p>Currently, the <code>schema</code> parameter isn't supported.</p> </note>"
},
"parameterSets":{
"shape":"SqlParameterSets",
"documentation":"<p>The parameter set for the batch operation.</p> <p>The SQL statement is executed as many times as the number of parameter sets provided. To execute a SQL statement with no parameters, use one of the following options:</p> <ul> <li> <p>Specify one or more empty parameter sets.</p> </li> <li> <p>Use the <code>ExecuteStatement</code> operation instead of the <code>BatchExecuteStatement</code> operation.</p> </li> </ul> <note> <p>Array parameters are not supported.</p> </note>"
},
"transactionId":{
"shape":"Id",
"documentation":"<p>The identifier of a transaction that was started by using the <code>BeginTransaction</code> operation. Specify the transaction ID of the transaction that you want to include the SQL statement in.</p> <p>If the SQL statement is not part of a transaction, don't set this parameter.</p>"
}
},
"documentation":"<p>The request parameters represent the input of a SQL statement over an array of data.</p>"
},
"BatchExecuteStatementResponse":{
"type":"structure",
"members":{
"updateResults":{
"shape":"UpdateResults",
"documentation":"<p>The execution results of each batch entry.</p>"
}
},
"documentation":"<p>The response elements represent the output of a SQL statement over an array of data.</p>"
},
"BeginTransactionRequest":{
"type":"structure",
"required":[
"resourceArn",
"secretArn"
],
"members":{
"resourceArn":{
"shape":"Arn",
"documentation":"<p>The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.</p>"
},
"secretArn":{
"shape":"Arn",
"documentation":"<p>The name or ARN of the secret that enables access to the DB cluster.</p>"
},
"database":{
"shape":"DbName",
"documentation":"<p>The name of the database.</p>"
},
"schema":{
"shape":"DbName",
"documentation":"<p>The name of the database schema.</p>"
}
},
"documentation":"<p>The request parameters represent the input of a request to start a SQL transaction.</p>"
},
"BeginTransactionResponse":{
"type":"structure",
"members":{
"transactionId":{
"shape":"Id",
"documentation":"<p>The transaction ID of the transaction started by the call.</p>"
}
},
"documentation":"<p>The response elements represent the output of a request to start a SQL transaction.</p>"
},
"Blob":{"type":"blob"},
"Boolean":{"type":"boolean"},
"BooleanArray":{
"type":"list",
"member":{"shape":"BoxedBoolean"},
"documentation":"<p>An array of Boolean values.</p> <note> <p>Some array entries can be null.</p> </note>"
},
"BoxedBoolean":{
"type":"boolean",
"box":true
},
"BoxedDouble":{
"type":"double",
"box":true
},
"BoxedFloat":{
"type":"float",
"box":true
},
"BoxedInteger":{
"type":"integer",
"box":true
},
"BoxedLong":{
"type":"long",
"box":true
},
"ColumnMetadata":{
"type":"structure",
"members":{
"name":{
"shape":"String",
"documentation":"<p>The name of the column.</p>"
},
"type":{
"shape":"Integer",
"documentation":"<p>The type of the column.</p>"
},
"typeName":{
"shape":"String",
"documentation":"<p>The database-specific data type of the column.</p>"
},
"label":{
"shape":"String",
"documentation":"<p>The label for the column.</p>"
},
"schemaName":{
"shape":"String",
"documentation":"<p>The name of the schema that owns the table that includes the column.</p>"
},
"tableName":{
"shape":"String",
"documentation":"<p>The name of the table that includes the column.</p>"
},
"isAutoIncrement":{
"shape":"Boolean",
"documentation":"<p>A value that indicates whether the column increments automatically.</p>"
},
"isSigned":{
"shape":"Boolean",
"documentation":"<p>A value that indicates whether an integer column is signed.</p>"
},
"isCurrency":{
"shape":"Boolean",
"documentation":"<p>A value that indicates whether the column contains currency values.</p>"
},
"isCaseSensitive":{
"shape":"Boolean",
"documentation":"<p>A value that indicates whether the column is case-sensitive.</p>"
},
"nullable":{
"shape":"Integer",
"documentation":"<p>A value that indicates whether the column is nullable.</p>"
},
"precision":{
"shape":"Integer",
"documentation":"<p>The precision value of a decimal number column.</p>"
},
"scale":{
"shape":"Integer",
"documentation":"<p>The scale value of a decimal number column.</p>"
},
"arrayBaseColumnType":{
"shape":"Integer",
"documentation":"<p>The type of the column.</p>"
}
},
"documentation":"<p>Contains the metadata for a column.</p>"
},
"CommitTransactionRequest":{
"type":"structure",
"required":[
"resourceArn",
"secretArn",
"transactionId"
],
"members":{
"resourceArn":{
"shape":"Arn",
"documentation":"<p>The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.</p>"
},
"secretArn":{
"shape":"Arn",
"documentation":"<p>The name or ARN of the secret that enables access to the DB cluster.</p>"
},
"transactionId":{
"shape":"Id",
"documentation":"<p>The identifier of the transaction to end and commit.</p>"
}
},
"documentation":"<p>The request parameters represent the input of a commit transaction request.</p>"
},
"CommitTransactionResponse":{
"type":"structure",
"members":{
"transactionStatus":{
"shape":"TransactionStatus",
"documentation":"<p>The status of the commit operation.</p>"
}
},
"documentation":"<p>The response elements represent the output of a commit transaction request.</p>"
},
"DbName":{
"type":"string",
"max":64,
"min":0
},
"DecimalReturnType":{
"type":"string",
"enum":[
"STRING",
"DOUBLE_OR_LONG"
]
},
"DoubleArray":{
"type":"list",
"member":{"shape":"BoxedDouble"},
"documentation":"<p>An array of floating-point numbers.</p> <note> <p>Some array entries can be null.</p> </note>"
},
"ErrorMessage":{"type":"string"},
"ExecuteSqlRequest":{
"type":"structure",
"required":[
"dbClusterOrInstanceArn",
"awsSecretStoreArn",
"sqlStatements"
],
"members":{
"dbClusterOrInstanceArn":{
"shape":"Arn",
"documentation":"<p>The ARN of the Aurora Serverless DB cluster.</p>"
},
"awsSecretStoreArn":{
"shape":"Arn",
"documentation":"<p>The Amazon Resource Name (ARN) of the secret that enables access to the DB cluster. Enter the database user name and password for the credentials in the secret.</p> <p>For information about creating the secret, see <a href=\"https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_database_secret.html\">Create a database secret</a>.</p>"
},
"sqlStatements":{
"shape":"SqlStatement",
"documentation":"<p>One or more SQL statements to run on the DB cluster.</p> <p>You can separate SQL statements from each other with a semicolon (;). Any valid SQL statement is permitted, including data definition, data manipulation, and commit statements. </p>"
},
"database":{
"shape":"DbName",
"documentation":"<p>The name of the database.</p>"
},
"schema":{
"shape":"DbName",
"documentation":"<p>The name of the database schema.</p>"
}
},
"documentation":"<p>The request parameters represent the input of a request to run one or more SQL statements.</p>"
},
"ExecuteSqlResponse":{
"type":"structure",
"members":{
"sqlStatementResults":{
"shape":"SqlStatementResults",
"documentation":"<p>The results of the SQL statement or statements.</p>"
}
},
"documentation":"<p>The response elements represent the output of a request to run one or more SQL statements.</p>"
},
"ExecuteStatementRequest":{
"type":"structure",
"required":[
"resourceArn",
"secretArn",
"sql"
],
"members":{
"resourceArn":{
"shape":"Arn",
"documentation":"<p>The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.</p>"
},
"secretArn":{
"shape":"Arn",
"documentation":"<p>The ARN of the secret that enables access to the DB cluster. Enter the database user name and password for the credentials in the secret.</p> <p>For information about creating the secret, see <a href=\"https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_database_secret.html\">Create a database secret</a>.</p>"
},
"sql":{
"shape":"SqlStatement",
"documentation":"<p>The SQL statement to run.</p>"
},
"database":{
"shape":"DbName",
"documentation":"<p>The name of the database.</p>"
},
"schema":{
"shape":"DbName",
"documentation":"<p>The name of the database schema.</p> <note> <p>Currently, the <code>schema</code> parameter isn't supported.</p> </note>"
},
"parameters":{
"shape":"SqlParametersList",
"documentation":"<p>The parameters for the SQL statement.</p> <note> <p>Array parameters are not supported.</p> </note>"
},
"transactionId":{
"shape":"Id",
"documentation":"<p>The identifier of a transaction that was started by using the <code>BeginTransaction</code> operation. Specify the transaction ID of the transaction that you want to include the SQL statement in.</p> <p>If the SQL statement is not part of a transaction, don't set this parameter.</p>"
},
"includeResultMetadata":{
"shape":"Boolean",
"documentation":"<p>A value that indicates whether to include metadata in the results.</p>"
},
"continueAfterTimeout":{
"shape":"Boolean",
"documentation":"<p>A value that indicates whether to continue running the statement after the call times out. By default, the statement stops running when the call times out.</p> <note> <p>For DDL statements, we recommend continuing to run the statement after the call times out. When a DDL statement terminates before it is finished running, it can result in errors and possibly corrupted data structures.</p> </note>"
},
"resultSetOptions":{
"shape":"ResultSetOptions",
"documentation":"<p>Options that control how the result set is returned.</p>"
},
"formatRecordsAs":{
"shape":"RecordsFormatType",
"documentation":"<p>A value that indicates whether to format the result set as a single JSON string. This parameter only applies to <code>SELECT</code> statements and is ignored for other types of statements. Allowed values are <code>NONE</code> and <code>JSON</code>. The default value is <code>NONE</code>. The result is returned in the <code>formattedRecords</code> field.</p> <p>For usage information about the JSON format for result sets, see <a href=\"https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html\">Using the Data API</a> in the <i>Amazon Aurora User Guide</i>.</p>"
}
},
"documentation":"<p>The request parameters represent the input of a request to run a SQL statement against a database.</p>"
},
"ExecuteStatementResponse":{
"type":"structure",
"members":{
"records":{
"shape":"SqlRecords",
"documentation":"<p>The records returned by the SQL statement. This field is blank if the <code>formatRecordsAs</code> parameter is set to <code>JSON</code>.</p>"
},
"columnMetadata":{
"shape":"Metadata",
"documentation":"<p>Metadata for the columns included in the results. This field is blank if the <code>formatRecordsAs</code> parameter is set to <code>JSON</code>.</p>"
},
"numberOfRecordsUpdated":{
"shape":"RecordsUpdated",
"documentation":"<p>The number of records updated by the request.</p>"
},
"generatedFields":{
"shape":"FieldList",
"documentation":"<p>Values for fields generated during a DML request.</p> <pre><code> &lt;note&gt; &lt;p&gt;The &lt;code&gt;generatedFields&lt;/code&gt; data isn't supported by Aurora PostgreSQL. To get the values of generated fields, use the &lt;code&gt;RETURNING&lt;/code&gt; clause. For more information, see &lt;a href=&quot;https://www.postgresql.org/docs/10/dml-returning.html&quot;&gt;Returning Data From Modified Rows&lt;/a&gt; in the PostgreSQL documentation.&lt;/p&gt; &lt;/note&gt; </code></pre>"
},
"formattedRecords":{
"shape":"FormattedSqlRecords",
"documentation":"<p>A string value that represents the result set of a <code>SELECT</code> statement in JSON format. This value is only present when the <code>formatRecordsAs</code> parameter is set to <code>JSON</code>.</p> <p>The size limit for this field is currently 10 MB. If the JSON-formatted string representing the result set requires more than 10 MB, the call returns an error.</p>"
}
},
"documentation":"<p>The response elements represent the output of a request to run a SQL statement against a database.</p>"
},
"Field":{
"type":"structure",
"members":{
"isNull":{
"shape":"BoxedBoolean",
"documentation":"<p>A NULL value.</p>",
"box":true
},
"booleanValue":{
"shape":"BoxedBoolean",
"documentation":"<p>A value of Boolean data type.</p>",
"box":true
},
"longValue":{
"shape":"BoxedLong",
"documentation":"<p>A value of long data type.</p>",
"box":true
},
"doubleValue":{
"shape":"BoxedDouble",
"documentation":"<p>A value of double data type.</p>",
"box":true
},
"stringValue":{
"shape":"String",
"documentation":"<p>A value of string data type.</p>"
},
"blobValue":{
"shape":"Blob",
"documentation":"<p>A value of BLOB data type.</p>"
},
"arrayValue":{
"shape":"ArrayValue",
"documentation":"<p>An array of values.</p>"
}
},
"documentation":"<p>Contains a value.</p>",
"union":true
},
"FieldList":{
"type":"list",
"member":{"shape":"Field"}
},
"ForbiddenException":{
"type":"structure",
"members":{
"message":{
"shape":"ErrorMessage",
"documentation":"<p>The error message returned by this <code>ForbiddenException</code> error.</p>"
}
},
"documentation":"<p>There are insufficient privileges to make the call.</p>",
"error":{
"httpStatusCode":403,
"senderFault":true
},
"exception":true
},
"FormattedSqlRecords":{"type":"string"},
"Id":{
"type":"string",
"max":192,
"min":0
},
"Integer":{"type":"integer"},
"InternalServerErrorException":{
"type":"structure",
"members":{
},
"documentation":"<p>An internal error occurred.</p>",
"error":{"httpStatusCode":500},
"exception":true,
"fault":true
},
"Long":{"type":"long"},
"LongArray":{
"type":"list",
"member":{"shape":"BoxedLong"},
"documentation":"<p>An array of integers.</p> <note> <p>Some array entries can be null.</p> </note>"
},
"LongReturnType":{
"type":"string",
"enum":[
"STRING",
"LONG"
]
},
"Metadata":{
"type":"list",
"member":{"shape":"ColumnMetadata"}
},
"NotFoundException":{
"type":"structure",
"members":{
"message":{
"shape":"ErrorMessage",
"documentation":"<p>The error message returned by this <code>NotFoundException</code> error.</p>"
}
},
"documentation":"<p>The <code>resourceArn</code>, <code>secretArn</code>, or <code>transactionId</code> value can't be found.</p>",
"error":{
"httpStatusCode":404,
"senderFault":true
},
"exception":true
},
"ParameterName":{"type":"string"},
"Record":{
"type":"structure",
"members":{
"values":{
"shape":"Row",
"documentation":"<p>The values returned in the record.</p>"
}
},
"documentation":"<p>A record returned by a call.</p> <note> <p>This data structure is only used with the deprecated <code>ExecuteSql</code> operation. Use the <code>BatchExecuteStatement</code> or <code>ExecuteStatement</code> operation instead.</p> </note>"
},
"Records":{
"type":"list",
"member":{"shape":"Record"}
},
"RecordsFormatType":{
"type":"string",
"enum":[
"NONE",
"JSON"
]
},
"RecordsUpdated":{"type":"long"},
"ResultFrame":{
"type":"structure",
"members":{
"resultSetMetadata":{
"shape":"ResultSetMetadata",
"documentation":"<p>The result-set metadata in the result set.</p>"
},
"records":{
"shape":"Records",
"documentation":"<p>The records in the result set.</p>"
}
},
"documentation":"<p>The result set returned by a SQL statement.</p> <note> <p>This data structure is only used with the deprecated <code>ExecuteSql</code> operation. Use the <code>BatchExecuteStatement</code> or <code>ExecuteStatement</code> operation instead.</p> </note>"
},
"ResultSetMetadata":{
"type":"structure",
"members":{
"columnCount":{
"shape":"Long",
"documentation":"<p>The number of columns in the result set.</p>"
},
"columnMetadata":{
"shape":"Metadata",
"documentation":"<p>The metadata of the columns in the result set.</p>"
}
},
"documentation":"<p>The metadata of the result set returned by a SQL statement.</p>"
},
"ResultSetOptions":{
"type":"structure",
"members":{
"decimalReturnType":{
"shape":"DecimalReturnType",
"documentation":"<p>A value that indicates how a field of <code>DECIMAL</code> type is represented in the response. The value of <code>STRING</code>, the default, specifies that it is converted to a String value. The value of <code>DOUBLE_OR_LONG</code> specifies that it is converted to a Long value if its scale is 0, or to a Double value otherwise.</p> <note> <p>Conversion to Double or Long can result in roundoff errors due to precision loss. We recommend converting to String, especially when working with currency values.</p> </note>"
},
"longReturnType":{
"shape":"LongReturnType",
"documentation":"<p>A value that indicates how a field of <code>LONG</code> type is represented. Allowed values are <code>LONG</code> and <code>STRING</code>. The default is <code>LONG</code>. Specify <code>STRING</code> if the length or precision of numeric values might cause truncation or rounding errors. </p>"
}
},
"documentation":"<p>Options that control how the result set is returned.</p>"
},
"RollbackTransactionRequest":{
"type":"structure",
"required":[
"resourceArn",
"secretArn",
"transactionId"
],
"members":{
"resourceArn":{
"shape":"Arn",
"documentation":"<p>The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.</p>"
},
"secretArn":{
"shape":"Arn",
"documentation":"<p>The name or ARN of the secret that enables access to the DB cluster.</p>"
},
"transactionId":{
"shape":"Id",
"documentation":"<p>The identifier of the transaction to roll back.</p>"
}
},
"documentation":"<p>The request parameters represent the input of a request to perform a rollback of a transaction.</p>"
},
"RollbackTransactionResponse":{
"type":"structure",
"members":{
"transactionStatus":{
"shape":"TransactionStatus",
"documentation":"<p>The status of the rollback operation.</p>"
}
},
"documentation":"<p>The response elements represent the output of a request to perform a rollback of a transaction.</p>"
},
"Row":{
"type":"list",
"member":{"shape":"Value"}
},
"ServiceUnavailableError":{
"type":"structure",
"members":{
},
"documentation":"<p>The service specified by the <code>resourceArn</code> parameter is not available.</p>",
"error":{"httpStatusCode":503},
"exception":true,
"fault":true
},
"SqlParameter":{
"type":"structure",
"members":{
"name":{
"shape":"ParameterName",
"documentation":"<p>The name of the parameter.</p>"
},
"value":{
"shape":"Field",
"documentation":"<p>The value of the parameter.</p>"
},
"typeHint":{
"shape":"TypeHint",
"documentation":"<p>A hint that specifies the correct object type for data type mapping. Possible values are as follows:</p> <ul> <li> <p> <code>DATE</code> - The corresponding <code>String</code> parameter value is sent as an object of <code>DATE</code> type to the database. The accepted format is <code>YYYY-MM-DD</code>.</p> </li> <li> <p> <code>DECIMAL</code> - The corresponding <code>String</code> parameter value is sent as an object of <code>DECIMAL</code> type to the database.</p> </li> <li> <p> <code>JSON</code> - The corresponding <code>String</code> parameter value is sent as an object of <code>JSON</code> type to the database.</p> </li> <li> <p> <code>TIME</code> - The corresponding <code>String</code> parameter value is sent as an object of <code>TIME</code> type to the database. The accepted format is <code>HH:MM:SS[.FFF]</code>.</p> </li> <li> <p> <code>TIMESTAMP</code> - The corresponding <code>String</code> parameter value is sent as an object of <code>TIMESTAMP</code> type to the database. The accepted format is <code>YYYY-MM-DD HH:MM:SS[.FFF]</code>.</p> </li> <li> <p> <code>UUID</code> - The corresponding <code>String</code> parameter value is sent as an object of <code>UUID</code> type to the database. </p> </li> </ul>"
}
},
"documentation":"<p>A parameter used in a SQL statement.</p>"
},
"SqlParameterSets":{
"type":"list",
"member":{"shape":"SqlParametersList"}
},
"SqlParametersList":{
"type":"list",
"member":{"shape":"SqlParameter"}
},
"SqlRecords":{
"type":"list",
"member":{"shape":"FieldList"}
},
"SqlStatement":{
"type":"string",
"max":65536,
"min":0
},
"SqlStatementResult":{
"type":"structure",
"members":{
"resultFrame":{
"shape":"ResultFrame",
"documentation":"<p>The result set of the SQL statement.</p>"
},
"numberOfRecordsUpdated":{
"shape":"RecordsUpdated",
"documentation":"<p>The number of records updated by a SQL statement.</p>"
}
},
"documentation":"<p>The result of a SQL statement.</p> <pre><code> &lt;note&gt; &lt;p&gt;This data structure is only used with the deprecated &lt;code&gt;ExecuteSql&lt;/code&gt; operation. Use the &lt;code&gt;BatchExecuteStatement&lt;/code&gt; or &lt;code&gt;ExecuteStatement&lt;/code&gt; operation instead.&lt;/p&gt; &lt;/note&gt; </code></pre>"
},
"SqlStatementResults":{
"type":"list",
"member":{"shape":"SqlStatementResult"}
},
"StatementTimeoutException":{
"type":"structure",
"members":{
"message":{
"shape":"ErrorMessage",
"documentation":"<p>The error message returned by this <code>StatementTimeoutException</code> error.</p>"
},
"dbConnectionId":{
"shape":"Long",
"documentation":"<p>The database connection ID that executed the SQL statement.</p>"
}
},
"documentation":"<p>The execution of the SQL statement timed out.</p>",
"error":{
"httpStatusCode":400,
"senderFault":true
},
"exception":true
},
"String":{"type":"string"},
"StringArray":{
"type":"list",
"member":{"shape":"String"},
"documentation":"<p>An array of strings.</p> <note> <p>Some array entries can be null.</p> </note>"
},
"StructValue":{
"type":"structure",
"members":{
"attributes":{
"shape":"ArrayValueList",
"documentation":"<p>The attributes returned in the record.</p>"
}
},
"documentation":"<p>A structure value returned by a call.</p> <note> <p>This data structure is only used with the deprecated <code>ExecuteSql</code> operation. Use the <code>BatchExecuteStatement</code> or <code>ExecuteStatement</code> operation instead.</p> </note>"
},
"TransactionStatus":{
"type":"string",
"max":128,
"min":0
},
"TypeHint":{
"type":"string",
"enum":[
"JSON",
"UUID",
"TIMESTAMP",
"DATE",
"TIME",
"DECIMAL"
]
},
"UpdateResult":{
"type":"structure",
"members":{
"generatedFields":{
"shape":"FieldList",
"documentation":"<p>Values for fields generated during the request.</p>"
}
},
"documentation":"<p>The response elements represent the results of an update.</p>"
},
"UpdateResults":{
"type":"list",
"member":{"shape":"UpdateResult"}
},
"Value":{
"type":"structure",
"members":{
"isNull":{
"shape":"BoxedBoolean",
"documentation":"<p>A NULL value.</p>",
"box":true
},
"bitValue":{
"shape":"BoxedBoolean",
"documentation":"<p>A value for a column of BIT data type.</p>",
"box":true
},
"bigIntValue":{
"shape":"BoxedLong",
"documentation":"<p>A value for a column of big integer data type.</p>",
"box":true
},
"intValue":{
"shape":"BoxedInteger",
"documentation":"<p>A value for a column of integer data type.</p>",
"box":true
},
"doubleValue":{
"shape":"BoxedDouble",
"documentation":"<p>A value for a column of double data type.</p>",
"box":true
},
"realValue":{
"shape":"BoxedFloat",
"documentation":"<p>A value for a column of real data type.</p>",
"box":true
},
"stringValue":{
"shape":"String",
"documentation":"<p>A value for a column of string data type.</p>"
},
"blobValue":{
"shape":"Blob",
"documentation":"<p>A value for a column of BLOB data type.</p>"
},
"arrayValues":{
"shape":"ArrayValueList",
"documentation":"<p>An array of column values.</p>"
},
"structValue":{
"shape":"StructValue",
"documentation":"<p>A value for a column of STRUCT data type.</p>"
}
},
"documentation":"<p>Contains the value of a column.</p> <pre><code> &lt;note&gt; &lt;p&gt;This data structure is only used with the deprecated &lt;code&gt;ExecuteSql&lt;/code&gt; operation. Use the &lt;code&gt;BatchExecuteStatement&lt;/code&gt; or &lt;code&gt;ExecuteStatement&lt;/code&gt; operation instead.&lt;/p&gt; &lt;/note&gt; </code></pre>",
"union":true
}
},
"documentation":"<p><fullname>Amazon RDS Data Service</fullname> <p>Amazon RDS provides an HTTP endpoint to run SQL statements on an Amazon Aurora Serverless v1 DB cluster. To run these statements, you work with the Data Service API.</p> <note> <p>The Data Service API isn't supported on Amazon Aurora Serverless v2 DB clusters.</p> </note> <p>For more information about the Data Service API, see <a href=\"https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html\">Using the Data API</a> in the <i>Amazon Aurora User Guide</i>.</p></p>"
}