UpdateTableObjects
Updates the manifest of Amazon S3 objects that make up the specified governed table.
Request Syntax
{
"CatalogId": "string
",
"DatabaseName": "string
",
"TableName": "string
",
"TransactionId": "string
",
"WriteOperations": [
{
"AddObject": {
"ETag": "string
",
"PartitionValues": [ "string
" ],
"Size": number
,
"Uri": "string
"
},
"DeleteObject": {
"ETag": "string
",
"PartitionValues": [ "string
" ],
"Uri": "string
"
}
}
]
}
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- CatalogId
-
The catalog containing the governed table to update. Defaults to the caller’s account ID.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\t]*
Required: No
- DatabaseName
-
The database containing the governed table to update.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\t]*
Required: Yes
- TableName
-
The governed table to update.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\t]*
Required: Yes
- TransactionId
-
The transaction at which to do the write.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
[\p{L}\p{N}\p{P}]*
Required: No
- WriteOperations
-
A list of
WriteOperation
objects that define an object to add to or delete from the manifest for a governed table.Type: Array of WriteOperation objects
Array Members: Minimum number of 1 item. Maximum number of 100 items.
Required: Yes
Response Elements
If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.
Errors
For information about the errors that are common to all actions, see Common Errors.
- ConcurrentModificationException
-
Two processes are trying to modify a resource simultaneously.
- Message
-
A message describing the problem.
HTTP Status Code: 400
- EntityNotFoundException
-
A specified entity does not exist.
- Message
-
A message describing the problem.
HTTP Status Code: 400
- InternalServiceException
-
An internal service error occurred.
- Message
-
A message describing the problem.
HTTP Status Code: 500
- InvalidInputException
-
The input provided was not valid.
- Message
-
A message describing the problem.
HTTP Status Code: 400
- OperationTimeoutException
-
The operation timed out.
- Message
-
A message describing the problem.
HTTP Status Code: 400
- ResourceNotReadyException
-
Contains details about an error related to a resource which is not ready for a transaction.
- Message
-
A message describing the error.
HTTP Status Code: 400
- TransactionCanceledException
-
Contains details about an error related to a transaction that was cancelled.
- Message
-
A message describing the error.
HTTP Status Code: 400
- TransactionCommitInProgressException
-
Contains details about an error related to a transaction commit that was in progress.
- Message
-
A message describing the error.
HTTP Status Code: 400
- TransactionCommittedException
-
Contains details about an error where the specified transaction has already been committed and cannot be used for
UpdateTableObjects
.- Message
-
A message describing the error.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: