Skip to content

Commit a8ff0c6

Browse files
author
AWS
committed
Amazon DynamoDB Update: DynamoDB PartiQL now supports ReturnConsumedCapacity, which returns capacity units consumed by PartiQL APIs if the request specified returnConsumedCapacity parameter. PartiQL APIs include ExecuteStatement, BatchExecuteStatement, and ExecuteTransaction.
1 parent 6e3cb5b commit a8ff0c6

File tree

2 files changed

+25
-4
lines changed

2 files changed

+25
-4
lines changed
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"type": "feature",
3+
"category": "Amazon DynamoDB",
4+
"contributor": "",
5+
"description": "DynamoDB PartiQL now supports ReturnConsumedCapacity, which returns capacity units consumed by PartiQL APIs if the request specified returnConsumedCapacity parameter. PartiQL APIs include ExecuteStatement, BatchExecuteStatement, and ExecuteTransaction."
6+
}

services/dynamodb/src/main/resources/codegen-resources/dynamodb/service-2.json

Lines changed: 19 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1328,7 +1328,8 @@
13281328
"Statements":{
13291329
"shape":"PartiQLBatchRequest",
13301330
"documentation":"<p>The list of PartiQL statements representing the batch to run.</p>"
1331-
}
1331+
},
1332+
"ReturnConsumedCapacity":{"shape":"ReturnConsumedCapacity"}
13321333
}
13331334
},
13341335
"BatchExecuteStatementOutput":{
@@ -1337,6 +1338,10 @@
13371338
"Responses":{
13381339
"shape":"PartiQLBatchResponse",
13391340
"documentation":"<p>The response to each PartiQL statement in the batch.</p>"
1341+
},
1342+
"ConsumedCapacity":{
1343+
"shape":"ConsumedCapacityMultiple",
1344+
"documentation":"<p>The capacity units consumed by the entire operation. The values of the list are ordered according to the ordering of the statements.</p>"
13401345
}
13411346
}
13421347
},
@@ -2463,7 +2468,8 @@
24632468
"NextToken":{
24642469
"shape":"PartiQLNextToken",
24652470
"documentation":"<p>Set this value to get remaining results, if <code>NextToken</code> was returned in the statement response.</p>"
2466-
}
2471+
},
2472+
"ReturnConsumedCapacity":{"shape":"ReturnConsumedCapacity"}
24672473
}
24682474
},
24692475
"ExecuteStatementOutput":{
@@ -2476,7 +2482,8 @@
24762482
"NextToken":{
24772483
"shape":"PartiQLNextToken",
24782484
"documentation":"<p>If the response of a read request exceeds the response payload limit DynamoDB will set this value in the response. If set, you can use that this value in the subsequent request to get the remaining results.</p>"
2479-
}
2485+
},
2486+
"ConsumedCapacity":{"shape":"ConsumedCapacity"}
24802487
}
24812488
},
24822489
"ExecuteTransactionInput":{
@@ -2491,6 +2498,10 @@
24912498
"shape":"ClientRequestToken",
24922499
"documentation":"<p>Set this value to get remaining results, if <code>NextToken</code> was returned in the statement response.</p>",
24932500
"idempotencyToken":true
2501+
},
2502+
"ReturnConsumedCapacity":{
2503+
"shape":"ReturnConsumedCapacity",
2504+
"documentation":"<p>Determines the level of detail about either provisioned or on-demand throughput consumption that is returned in the response. For more information, see <a href=\"https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactGetItems.html\">TransactGetItems</a> and <a href=\"https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactWriteItems.html\">TransactWriteItems</a>.</p>"
24942505
}
24952506
}
24962507
},
@@ -2500,6 +2511,10 @@
25002511
"Responses":{
25012512
"shape":"ItemResponseList",
25022513
"documentation":"<p>The response to a PartiQL transaction.</p>"
2514+
},
2515+
"ConsumedCapacity":{
2516+
"shape":"ConsumedCapacityMultiple",
2517+
"documentation":"<p>The capacity units consumed by the entire operation. The values of the list are ordered according to the ordering of the statements.</p>"
25032518
}
25042519
}
25052520
},
@@ -4607,7 +4622,7 @@
46074622
},
46084623
"ReturnConsumedCapacity":{
46094624
"type":"string",
4610-
"documentation":"<p>Determines the level of detail about provisioned throughput consumption that is returned in the response:</p> <ul> <li> <p> <code>INDEXES</code> - The response includes the aggregate <code>ConsumedCapacity</code> for the operation, together with <code>ConsumedCapacity</code> for each table and secondary index that was accessed.</p> <p>Note that some operations, such as <code>GetItem</code> and <code>BatchGetItem</code>, do not access any indexes at all. In these cases, specifying <code>INDEXES</code> will only return <code>ConsumedCapacity</code> information for table(s).</p> </li> <li> <p> <code>TOTAL</code> - The response includes only the aggregate <code>ConsumedCapacity</code> for the operation.</p> </li> <li> <p> <code>NONE</code> - No <code>ConsumedCapacity</code> details are included in the response.</p> </li> </ul>",
4625+
"documentation":"<p>Determines the level of detail about either provisioned or on-demand throughput consumption that is returned in the response:</p> <ul> <li> <p> <code>INDEXES</code> - The response includes the aggregate <code>ConsumedCapacity</code> for the operation, together with <code>ConsumedCapacity</code> for each table and secondary index that was accessed.</p> <p>Note that some operations, such as <code>GetItem</code> and <code>BatchGetItem</code>, do not access any indexes at all. In these cases, specifying <code>INDEXES</code> will only return <code>ConsumedCapacity</code> information for table(s).</p> </li> <li> <p> <code>TOTAL</code> - The response includes only the aggregate <code>ConsumedCapacity</code> for the operation.</p> </li> <li> <p> <code>NONE</code> - No <code>ConsumedCapacity</code> details are included in the response.</p> </li> </ul>",
46114626
"enum":[
46124627
"INDEXES",
46134628
"TOTAL",

0 commit comments

Comments
 (0)