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.
HTTP Status Code: 400
- EntityNotFoundException
-
A specified entity does not exist.
HTTP Status Code: 400
- InternalServiceException
-
An internal service error occurred.
HTTP Status Code: 500
- InvalidInputException
-
The input provided was not valid.
HTTP Status Code: 400
- OperationTimeoutException
-
The operation timed out.
HTTP Status Code: 400
- ResourceNotReadyException
-
Contains details about an error related to a resource which is not ready for a transaction.
HTTP Status Code: 400
- TransactionCanceledException
-
Contains details about an error related to a transaction that was cancelled.
HTTP Status Code: 400
- TransactionCommitInProgressException
-
Contains details about an error related to a transaction commit that was in progress.
HTTP Status Code: 400
- TransactionCommittedException
-
Contains details about an error where the specified transaction has already been committed and cannot be used for
UpdateTableObjects
.HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: