940 lines
38 KiB
JSON
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> <note> <p>The <code>generatedFields</code> data isn't supported by Aurora PostgreSQL. To get the values of generated fields, use the <code>RETURNING</code> clause. For more information, see <a href="https://www.postgresql.org/docs/10/dml-returning.html">Returning Data From Modified Rows</a> in the PostgreSQL documentation.</p> </note> </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> <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> </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> <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> </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>"
|
|
}
|