2017-04-05 09:45:27 +02:00
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
2016-01-29 20:53:56 +01:00
// Package dynamodb provides a client for Amazon DynamoDB.
package dynamodb
import (
2016-05-05 03:06:27 +02:00
"fmt"
2016-01-29 20:53:56 +01:00
"time"
2017-04-05 09:45:27 +02:00
"github.com/aws/aws-sdk-go/aws"
2016-01-29 20:53:56 +01:00
"github.com/aws/aws-sdk-go/aws/awsutil"
"github.com/aws/aws-sdk-go/aws/request"
2017-01-23 22:22:31 +01:00
"github.com/aws/aws-sdk-go/private/protocol"
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
2016-01-29 20:53:56 +01:00
)
const opBatchGetItem = "BatchGetItem"
2016-07-15 15:49:02 +02:00
// BatchGetItemRequest generates a "aws/request.Request" representing the
// client's request for the BatchGetItem operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See BatchGetItem for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the BatchGetItem method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the BatchGetItemRequest method.
// req, resp := client.BatchGetItemRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/BatchGetItem
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) BatchGetItemRequest ( input * BatchGetItemInput ) ( req * request . Request , output * BatchGetItemOutput ) {
op := & request . Operation {
Name : opBatchGetItem ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
Paginator : & request . Paginator {
InputTokens : [ ] string { "RequestItems" } ,
OutputTokens : [ ] string { "UnprocessedKeys" } ,
LimitToken : "" ,
TruncationToken : "" ,
} ,
}
if input == nil {
input = & BatchGetItemInput { }
}
output = & BatchGetItemOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// BatchGetItem API operation for Amazon DynamoDB.
//
2016-01-29 20:53:56 +01:00
// The BatchGetItem operation returns the attributes of one or more items from
// one or more tables. You identify requested items by primary key.
//
// A single operation can retrieve up to 16 MB of data, which can contain as
// many as 100 items. BatchGetItem will return a partial result if the response
// size limit is exceeded, the table's provisioned throughput is exceeded, or
// an internal processing failure occurs. If a partial result is returned, the
// operation returns a value for UnprocessedKeys. You can use this value to
// retry the operation starting with the next item to get.
//
2016-11-19 19:41:01 +01:00
// If you request more than 100 items BatchGetItem will return a ValidationException
2016-01-29 20:53:56 +01:00
// with the message "Too many items requested for the BatchGetItem call".
//
2016-11-19 19:41:01 +01:00
// For example, if you ask to retrieve 100 items, but each individual item is
// 300 KB in size, the system returns 52 items (so as not to exceed the 16 MB
// limit). It also returns an appropriate UnprocessedKeys value so you can get
// the next page of results. If desired, your application can include its own
// logic to assemble the pages of results into one data set.
2016-01-29 20:53:56 +01:00
//
// If none of the items can be processed due to insufficient provisioned throughput
// on all of the tables in the request, then BatchGetItem will return a ProvisionedThroughputExceededException.
// If at least one of the items is successfully processed, then BatchGetItem
// completes successfully, while returning the keys of the unread items in UnprocessedKeys.
//
2016-11-19 19:41:01 +01:00
// If DynamoDB returns any unprocessed items, you should retry the batch operation
2016-01-29 20:53:56 +01:00
// on those items. However, we strongly recommend that you use an exponential
// backoff algorithm. If you retry the batch operation immediately, the underlying
// read or write requests can still fail due to throttling on the individual
// tables. If you delay the batch operation using exponential backoff, the individual
// requests in the batch are much more likely to succeed.
//
// For more information, see Batch Operations and Error Handling (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ErrorHandling.html#BatchOperations)
// in the Amazon DynamoDB Developer Guide.
//
2016-11-19 19:41:01 +01:00
// By default, BatchGetItem performs eventually consistent reads on every table
// in the request. If you want strongly consistent reads instead, you can set
// ConsistentRead to true for any or all tables.
2016-01-29 20:53:56 +01:00
//
// In order to minimize response latency, BatchGetItem retrieves items in parallel.
//
// When designing your application, keep in mind that DynamoDB does not return
2016-07-15 15:49:02 +02:00
// items in any particular order. To help parse the response by item, include
2017-01-23 22:22:31 +01:00
// the primary key values for the items in your request in the ProjectionExpression
2016-01-29 20:53:56 +01:00
// parameter.
//
// If a requested item does not exist, it is not returned in the result. Requests
// for nonexistent items consume the minimum read capacity units according to
// the type of read. For more information, see Capacity Units Calculations (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html#CapacityUnitCalculations)
// in the Amazon DynamoDB Developer Guide.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation BatchGetItem for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeProvisionedThroughputExceededException "ProvisionedThroughputExceededException"
2016-10-17 23:21:08 +02:00
// Your request rate is too high. The AWS SDKs for DynamoDB automatically retry
// requests that receive this exception. Your request is eventually successful,
// unless your retry queue is too large to finish. Reduce the frequency of requests
// and use exponential backoff. For more information, go to Error Retries and
2017-01-23 22:22:31 +01:00
// Exponential Backoff (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.Errors.html#Programming.Errors.RetryAndBackoff)
2016-10-17 23:21:08 +02:00
// in the Amazon DynamoDB Developer Guide.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
2016-10-17 23:21:08 +02:00
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2016-10-17 23:21:08 +02:00
// An error occurred on the server side.
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/BatchGetItem
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) BatchGetItem ( input * BatchGetItemInput ) ( * BatchGetItemOutput , error ) {
req , out := c . BatchGetItemRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// BatchGetItemWithContext is the same as BatchGetItem with the addition of
// the ability to pass a context and additional request options.
//
// See BatchGetItem for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) BatchGetItemWithContext ( ctx aws . Context , input * BatchGetItemInput , opts ... request . Option ) ( * BatchGetItemOutput , error ) {
req , out := c . BatchGetItemRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
2016-07-15 15:49:02 +02:00
// BatchGetItemPages iterates over the pages of a BatchGetItem operation,
// calling the "fn" function with the response data for each page. To stop
// iterating, return false from the fn function.
//
// See BatchGetItem method for more information on how to use this operation.
//
// Note: This operation can generate multiple requests to a service.
//
// // Example iterating over at most 3 pages of a BatchGetItem operation.
// pageNum := 0
// err := client.BatchGetItemPages(params,
// func(page *BatchGetItemOutput, lastPage bool) bool {
// pageNum++
// fmt.Println(page)
// return pageNum <= 3
// })
//
2017-04-05 09:45:27 +02:00
func ( c * DynamoDB ) BatchGetItemPages ( input * BatchGetItemInput , fn func ( * BatchGetItemOutput , bool ) bool ) error {
return c . BatchGetItemPagesWithContext ( aws . BackgroundContext ( ) , input , fn )
}
// BatchGetItemPagesWithContext same as BatchGetItemPages except
// it takes a Context and allows setting request options on the pages.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) BatchGetItemPagesWithContext ( ctx aws . Context , input * BatchGetItemInput , fn func ( * BatchGetItemOutput , bool ) bool , opts ... request . Option ) error {
p := request . Pagination {
NewRequest : func ( ) ( * request . Request , error ) {
var inCpy * BatchGetItemInput
if input != nil {
tmp := * input
inCpy = & tmp
}
req , _ := c . BatchGetItemRequest ( inCpy )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return req , nil
} ,
}
cont := true
for p . Next ( ) && cont {
cont = fn ( p . Page ( ) . ( * BatchGetItemOutput ) , ! p . HasNextPage ( ) )
}
return p . Err ( )
2016-01-29 20:53:56 +01:00
}
const opBatchWriteItem = "BatchWriteItem"
2016-07-15 15:49:02 +02:00
// BatchWriteItemRequest generates a "aws/request.Request" representing the
// client's request for the BatchWriteItem operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See BatchWriteItem for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the BatchWriteItem method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the BatchWriteItemRequest method.
// req, resp := client.BatchWriteItemRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/BatchWriteItem
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) BatchWriteItemRequest ( input * BatchWriteItemInput ) ( req * request . Request , output * BatchWriteItemOutput ) {
op := & request . Operation {
Name : opBatchWriteItem ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & BatchWriteItemInput { }
}
output = & BatchWriteItemOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// BatchWriteItem API operation for Amazon DynamoDB.
//
2016-01-29 20:53:56 +01:00
// The BatchWriteItem operation puts or deletes multiple items in one or more
// tables. A single call to BatchWriteItem can write up to 16 MB of data, which
// can comprise as many as 25 put or delete requests. Individual items to be
// written can be as large as 400 KB.
//
2017-01-23 22:22:31 +01:00
// BatchWriteItem cannot update items. To update items, use the UpdateItem action.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The individual PutItem and DeleteItem operations specified in BatchWriteItem
2016-01-29 20:53:56 +01:00
// are atomic; however BatchWriteItem as a whole is not. If any requested operations
// fail because the table's provisioned throughput is exceeded or an internal
// processing failure occurs, the failed operations are returned in the UnprocessedItems
// response parameter. You can investigate and optionally resend the requests.
// Typically, you would call BatchWriteItem in a loop. Each iteration would
// check for unprocessed items and submit a new BatchWriteItem request with
// those unprocessed items until all items have been processed.
//
// Note that if none of the items can be processed due to insufficient provisioned
// throughput on all of the tables in the request, then BatchWriteItem will
// return a ProvisionedThroughputExceededException.
//
2016-11-19 19:41:01 +01:00
// If DynamoDB returns any unprocessed items, you should retry the batch operation
2016-01-29 20:53:56 +01:00
// on those items. However, we strongly recommend that you use an exponential
// backoff algorithm. If you retry the batch operation immediately, the underlying
// read or write requests can still fail due to throttling on the individual
// tables. If you delay the batch operation using exponential backoff, the individual
// requests in the batch are much more likely to succeed.
//
// For more information, see Batch Operations and Error Handling (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ErrorHandling.html#BatchOperations)
// in the Amazon DynamoDB Developer Guide.
//
2016-11-19 19:41:01 +01:00
// With BatchWriteItem, you can efficiently write or delete large amounts of
// data, such as from Amazon Elastic MapReduce (EMR), or copy data from another
2016-01-29 20:53:56 +01:00
// database into DynamoDB. In order to improve performance with these large-scale
// operations, BatchWriteItem does not behave in the same way as individual
// PutItem and DeleteItem calls would. For example, you cannot specify conditions
// on individual put and delete requests, and BatchWriteItem does not return
// deleted items in the response.
//
// If you use a programming language that supports concurrency, you can use
// threads to write items in parallel. Your application must include the necessary
// logic to manage the threads. With languages that don't support threading,
// you must update or delete the specified items one at a time. In both situations,
2017-01-23 22:22:31 +01:00
// BatchWriteItem performs the specified put and delete operations in parallel,
// giving you the power of the thread pool approach without having to introduce
// complexity into your application.
2016-01-29 20:53:56 +01:00
//
// Parallel processing reduces latency, but each specified put and delete request
// consumes the same number of write capacity units whether it is processed
// in parallel or not. Delete operations on nonexistent items consume one write
// capacity unit.
//
// If one or more of the following is true, DynamoDB rejects the entire batch
// write operation:
//
2016-11-19 19:41:01 +01:00
// * One or more tables specified in the BatchWriteItem request does not
// exist.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Primary key attributes specified on an item in the request do not match
// those in the corresponding table's primary key schema.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * You try to perform multiple operations on the same item in the same
// BatchWriteItem request. For example, you cannot put and delete the same
// item in the same BatchWriteItem request.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * There are more than 25 requests in the batch.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Any individual item in a batch exceeds 400 KB.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * The total request size exceeds 16 MB.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation BatchWriteItem for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeProvisionedThroughputExceededException "ProvisionedThroughputExceededException"
2016-10-17 23:21:08 +02:00
// Your request rate is too high. The AWS SDKs for DynamoDB automatically retry
// requests that receive this exception. Your request is eventually successful,
// unless your retry queue is too large to finish. Reduce the frequency of requests
// and use exponential backoff. For more information, go to Error Retries and
2017-01-23 22:22:31 +01:00
// Exponential Backoff (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.Errors.html#Programming.Errors.RetryAndBackoff)
2016-10-17 23:21:08 +02:00
// in the Amazon DynamoDB Developer Guide.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
2016-10-17 23:21:08 +02:00
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeItemCollectionSizeLimitExceededException "ItemCollectionSizeLimitExceededException"
2016-10-17 23:21:08 +02:00
// An item collection is too large. This exception is only returned for tables
// that have one or more local secondary indexes.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2016-10-17 23:21:08 +02:00
// An error occurred on the server side.
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/BatchWriteItem
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) BatchWriteItem ( input * BatchWriteItemInput ) ( * BatchWriteItemOutput , error ) {
req , out := c . BatchWriteItemRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// BatchWriteItemWithContext is the same as BatchWriteItem with the addition of
// the ability to pass a context and additional request options.
//
// See BatchWriteItem for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) BatchWriteItemWithContext ( ctx aws . Context , input * BatchWriteItemInput , opts ... request . Option ) ( * BatchWriteItemOutput , error ) {
req , out := c . BatchWriteItemRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opCreateTable = "CreateTable"
2016-07-15 15:49:02 +02:00
// CreateTableRequest generates a "aws/request.Request" representing the
// client's request for the CreateTable operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See CreateTable for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the CreateTable method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the CreateTableRequest method.
// req, resp := client.CreateTableRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/CreateTable
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) CreateTableRequest ( input * CreateTableInput ) ( req * request . Request , output * CreateTableOutput ) {
op := & request . Operation {
Name : opCreateTable ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & CreateTableInput { }
}
output = & CreateTableOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// CreateTable API operation for Amazon DynamoDB.
//
2016-01-29 20:53:56 +01:00
// The CreateTable operation adds a new table to your account. In an AWS account,
// table names must be unique within each region. That is, you can have two
// tables with same name if you create the tables in different regions.
//
2016-11-19 19:41:01 +01:00
// CreateTable is an asynchronous operation. Upon receiving a CreateTable request,
// DynamoDB immediately returns a response with a TableStatus of CREATING. After
// the table is created, DynamoDB sets the TableStatus to ACTIVE. You can perform
// read and write operations only on an ACTIVE table.
2016-01-29 20:53:56 +01:00
//
// You can optionally define secondary indexes on the new table, as part of
// the CreateTable operation. If you want to create multiple tables with secondary
// indexes on them, you must create the tables sequentially. Only one table
// with secondary indexes can be in the CREATING state at any given time.
//
2017-01-23 22:22:31 +01:00
// You can use the DescribeTable action to check the table status.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation CreateTable for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceInUseException "ResourceInUseException"
2016-10-17 23:21:08 +02:00
// The operation conflicts with the resource's availability. For example, you
// attempted to recreate an existing table, or tried to delete a table currently
// in the CREATING state.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeLimitExceededException "LimitExceededException"
2016-10-17 23:21:08 +02:00
// The number of concurrent table requests (cumulative number of tables in the
// CREATING, DELETING or UPDATING state) exceeds the maximum allowed of 10.
//
// Also, for tables with secondary indexes, only one of those tables can be
// in the CREATING state at any point in time. Do not attempt to create more
// than one such table simultaneously.
//
// The total limit of tables in the ACTIVE state is 250.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2016-10-17 23:21:08 +02:00
// An error occurred on the server side.
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/CreateTable
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) CreateTable ( input * CreateTableInput ) ( * CreateTableOutput , error ) {
req , out := c . CreateTableRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// CreateTableWithContext is the same as CreateTable with the addition of
// the ability to pass a context and additional request options.
//
// See CreateTable for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) CreateTableWithContext ( ctx aws . Context , input * CreateTableInput , opts ... request . Option ) ( * CreateTableOutput , error ) {
req , out := c . CreateTableRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opDeleteItem = "DeleteItem"
2016-07-15 15:49:02 +02:00
// DeleteItemRequest generates a "aws/request.Request" representing the
// client's request for the DeleteItem operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See DeleteItem for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the DeleteItem method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the DeleteItemRequest method.
// req, resp := client.DeleteItemRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteItem
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) DeleteItemRequest ( input * DeleteItemInput ) ( req * request . Request , output * DeleteItemOutput ) {
op := & request . Operation {
Name : opDeleteItem ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & DeleteItemInput { }
}
output = & DeleteItemOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// DeleteItem API operation for Amazon DynamoDB.
//
2016-01-29 20:53:56 +01:00
// Deletes a single item in a table by primary key. You can perform a conditional
// delete operation that deletes the item if it exists, or if it has an expected
// attribute value.
//
// In addition to deleting an item, you can also return the item's attribute
// values in the same operation, using the ReturnValues parameter.
//
// Unless you specify conditions, the DeleteItem is an idempotent operation;
// running it multiple times on the same item or attribute does not result in
// an error response.
//
// Conditional deletes are useful for deleting items only if specific conditions
// are met. If those conditions are met, DynamoDB performs the delete. Otherwise,
// the item is not deleted.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation DeleteItem for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeConditionalCheckFailedException "ConditionalCheckFailedException"
2016-10-17 23:21:08 +02:00
// A condition specified in the operation could not be evaluated.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeProvisionedThroughputExceededException "ProvisionedThroughputExceededException"
2016-10-17 23:21:08 +02:00
// Your request rate is too high. The AWS SDKs for DynamoDB automatically retry
// requests that receive this exception. Your request is eventually successful,
// unless your retry queue is too large to finish. Reduce the frequency of requests
// and use exponential backoff. For more information, go to Error Retries and
2017-01-23 22:22:31 +01:00
// Exponential Backoff (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.Errors.html#Programming.Errors.RetryAndBackoff)
2016-10-17 23:21:08 +02:00
// in the Amazon DynamoDB Developer Guide.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
2016-10-17 23:21:08 +02:00
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeItemCollectionSizeLimitExceededException "ItemCollectionSizeLimitExceededException"
2016-10-17 23:21:08 +02:00
// An item collection is too large. This exception is only returned for tables
// that have one or more local secondary indexes.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2016-10-17 23:21:08 +02:00
// An error occurred on the server side.
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteItem
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) DeleteItem ( input * DeleteItemInput ) ( * DeleteItemOutput , error ) {
req , out := c . DeleteItemRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// DeleteItemWithContext is the same as DeleteItem with the addition of
// the ability to pass a context and additional request options.
//
// See DeleteItem for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) DeleteItemWithContext ( ctx aws . Context , input * DeleteItemInput , opts ... request . Option ) ( * DeleteItemOutput , error ) {
req , out := c . DeleteItemRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opDeleteTable = "DeleteTable"
2016-07-15 15:49:02 +02:00
// DeleteTableRequest generates a "aws/request.Request" representing the
// client's request for the DeleteTable operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See DeleteTable for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the DeleteTable method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the DeleteTableRequest method.
// req, resp := client.DeleteTableRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteTable
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) DeleteTableRequest ( input * DeleteTableInput ) ( req * request . Request , output * DeleteTableOutput ) {
op := & request . Operation {
Name : opDeleteTable ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & DeleteTableInput { }
}
output = & DeleteTableOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// DeleteTable API operation for Amazon DynamoDB.
//
2016-01-29 20:53:56 +01:00
// The DeleteTable operation deletes a table and all of its items. After a DeleteTable
// request, the specified table is in the DELETING state until DynamoDB completes
// the deletion. If the table is in the ACTIVE state, you can delete it. If
// a table is in CREATING or UPDATING states, then DynamoDB returns a ResourceInUseException.
// If the specified table does not exist, DynamoDB returns a ResourceNotFoundException.
// If table is already in the DELETING state, no error is returned.
//
2016-11-19 19:41:01 +01:00
// DynamoDB might continue to accept data read and write operations, such as
// GetItem and PutItem, on a table in the DELETING state until the table deletion
// is complete.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// When you delete a table, any indexes on that table are also deleted.
2016-01-29 20:53:56 +01:00
//
// If you have DynamoDB Streams enabled on the table, then the corresponding
// stream on that table goes into the DISABLED state, and the stream is automatically
// deleted after 24 hours.
//
2017-01-23 22:22:31 +01:00
// Use the DescribeTable action to check the status of the table.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation DeleteTable for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceInUseException "ResourceInUseException"
2016-10-17 23:21:08 +02:00
// The operation conflicts with the resource's availability. For example, you
// attempted to recreate an existing table, or tried to delete a table currently
// in the CREATING state.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
2016-10-17 23:21:08 +02:00
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeLimitExceededException "LimitExceededException"
2016-10-17 23:21:08 +02:00
// The number of concurrent table requests (cumulative number of tables in the
// CREATING, DELETING or UPDATING state) exceeds the maximum allowed of 10.
//
// Also, for tables with secondary indexes, only one of those tables can be
// in the CREATING state at any point in time. Do not attempt to create more
// than one such table simultaneously.
//
// The total limit of tables in the ACTIVE state is 250.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2016-10-17 23:21:08 +02:00
// An error occurred on the server side.
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteTable
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) DeleteTable ( input * DeleteTableInput ) ( * DeleteTableOutput , error ) {
req , out := c . DeleteTableRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// DeleteTableWithContext is the same as DeleteTable with the addition of
// the ability to pass a context and additional request options.
//
// See DeleteTable for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) DeleteTableWithContext ( ctx aws . Context , input * DeleteTableInput , opts ... request . Option ) ( * DeleteTableOutput , error ) {
req , out := c . DeleteTableRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
2016-03-11 01:27:37 +01:00
const opDescribeLimits = "DescribeLimits"
2016-07-15 15:49:02 +02:00
// DescribeLimitsRequest generates a "aws/request.Request" representing the
// client's request for the DescribeLimits operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See DescribeLimits for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the DescribeLimits method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the DescribeLimitsRequest method.
// req, resp := client.DescribeLimitsRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeLimits
2016-03-11 01:27:37 +01:00
func ( c * DynamoDB ) DescribeLimitsRequest ( input * DescribeLimitsInput ) ( req * request . Request , output * DescribeLimitsOutput ) {
op := & request . Operation {
Name : opDescribeLimits ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & DescribeLimitsInput { }
}
output = & DescribeLimitsOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-03-11 01:27:37 +01:00
return
}
2016-10-17 23:21:08 +02:00
// DescribeLimits API operation for Amazon DynamoDB.
//
2016-03-11 01:27:37 +01:00
// Returns the current provisioned-capacity limits for your AWS account in a
// region, both for the region as a whole and for any one DynamoDB table that
// you create there.
//
// When you establish an AWS account, the account has initial limits on the
// maximum read capacity units and write capacity units that you can provision
// across all of your DynamoDB tables in a given region. Also, there are per-table
// limits that apply when you create a table there. For more information, see
// Limits (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html)
// page in the Amazon DynamoDB Developer Guide.
//
// Although you can increase these limits by filing a case at AWS Support Center
// (https://console.aws.amazon.com/support/home#/), obtaining the increase is
2017-01-23 22:22:31 +01:00
// not instantaneous. The DescribeLimits action lets you write code to compare
2016-03-11 01:27:37 +01:00
// the capacity you are currently using to those limits imposed by your account
// so that you have enough time to apply for an increase before you hit a limit.
//
2016-07-15 15:49:02 +02:00
// For example, you could use one of the AWS SDKs to do the following:
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// Call DescribeLimits for a particular region to obtain your current account
2016-07-15 15:49:02 +02:00
// limits on provisioned capacity there.
//
2016-11-19 19:41:01 +01:00
// Create a variable to hold the aggregate read capacity units provisioned for
// all your tables in that region, and one to hold the aggregate write capacity
2016-07-15 15:49:02 +02:00
// units. Zero them both.
//
2016-11-19 19:41:01 +01:00
// Call ListTables to obtain a list of all your DynamoDB tables.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// For each table name listed by ListTables, do the following:
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// Call DescribeTable with the table name.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// Use the data returned by DescribeTable to add the read capacity units and
2016-07-15 15:49:02 +02:00
// write capacity units provisioned for the table itself to your variables.
//
2016-11-19 19:41:01 +01:00
// If the table has one or more global secondary indexes (GSIs), loop over these
// GSIs and add their provisioned capacity values to your variables as well.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// Report the account limits for that region returned by DescribeLimits, along
// with the total current provisioned capacity levels you have calculated.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// This will let you see whether you are getting close to your account-level
2016-07-15 15:49:02 +02:00
// limits.
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// The per-table limits apply only when you are creating a new table. They restrict
// the sum of the provisioned capacity of the new table itself and all its global
// secondary indexes.
2016-03-11 01:27:37 +01:00
//
// For existing tables and their GSIs, DynamoDB will not let you increase provisioned
// capacity extremely rapidly, but the only upper limit that applies is that
// the aggregate provisioned capacity over all your tables and GSIs cannot exceed
// either of the per-account limits.
//
2016-11-19 19:41:01 +01:00
// DescribeLimits should only be called periodically. You can expect throttling
2016-03-11 01:27:37 +01:00
// errors if you call it more than once in a minute.
//
2016-11-19 19:41:01 +01:00
// The DescribeLimits Request element has no content.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation DescribeLimits for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2016-10-17 23:21:08 +02:00
// An error occurred on the server side.
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeLimits
2016-03-11 01:27:37 +01:00
func ( c * DynamoDB ) DescribeLimits ( input * DescribeLimitsInput ) ( * DescribeLimitsOutput , error ) {
req , out := c . DescribeLimitsRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// DescribeLimitsWithContext is the same as DescribeLimits with the addition of
// the ability to pass a context and additional request options.
//
// See DescribeLimits for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) DescribeLimitsWithContext ( ctx aws . Context , input * DescribeLimitsInput , opts ... request . Option ) ( * DescribeLimitsOutput , error ) {
req , out := c . DescribeLimitsRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-03-11 01:27:37 +01:00
}
2016-01-29 20:53:56 +01:00
const opDescribeTable = "DescribeTable"
2016-07-15 15:49:02 +02:00
// DescribeTableRequest generates a "aws/request.Request" representing the
// client's request for the DescribeTable operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See DescribeTable for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the DescribeTable method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the DescribeTableRequest method.
// req, resp := client.DescribeTableRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeTable
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) DescribeTableRequest ( input * DescribeTableInput ) ( req * request . Request , output * DescribeTableOutput ) {
op := & request . Operation {
Name : opDescribeTable ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & DescribeTableInput { }
}
output = & DescribeTableOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// DescribeTable API operation for Amazon DynamoDB.
//
2016-01-29 20:53:56 +01:00
// Returns information about the table, including the current status of the
// table, when it was created, the primary key schema, and any indexes on the
// table.
//
2016-11-19 19:41:01 +01:00
// If you issue a DescribeTable request immediately after a CreateTable request,
2016-01-29 20:53:56 +01:00
// DynamoDB might return a ResourceNotFoundException. This is because DescribeTable
// uses an eventually consistent query, and the metadata for your table might
// not be available at that moment. Wait for a few seconds, and then try the
// DescribeTable request again.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation DescribeTable for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
2016-10-17 23:21:08 +02:00
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2016-10-17 23:21:08 +02:00
// An error occurred on the server side.
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeTable
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) DescribeTable ( input * DescribeTableInput ) ( * DescribeTableOutput , error ) {
req , out := c . DescribeTableRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// DescribeTableWithContext is the same as DescribeTable with the addition of
// the ability to pass a context and additional request options.
//
// See DescribeTable for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) DescribeTableWithContext ( ctx aws . Context , input * DescribeTableInput , opts ... request . Option ) ( * DescribeTableOutput , error ) {
req , out := c . DescribeTableRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
2017-03-03 19:48:24 +01:00
const opDescribeTimeToLive = "DescribeTimeToLive"
// DescribeTimeToLiveRequest generates a "aws/request.Request" representing the
// client's request for the DescribeTimeToLive operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
// See DescribeTimeToLive for usage and error information.
//
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the DescribeTimeToLive method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the DescribeTimeToLiveRequest method.
// req, resp := client.DescribeTimeToLiveRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeTimeToLive
func ( c * DynamoDB ) DescribeTimeToLiveRequest ( input * DescribeTimeToLiveInput ) ( req * request . Request , output * DescribeTimeToLiveOutput ) {
op := & request . Operation {
Name : opDescribeTimeToLive ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & DescribeTimeToLiveInput { }
}
output = & DescribeTimeToLiveOutput { }
req = c . newRequest ( op , input , output )
return
}
// DescribeTimeToLive API operation for Amazon DynamoDB.
//
// Gives a description of the Time to Live (TTL) status on the specified table.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation DescribeTimeToLive for usage and error information.
//
// Returned Error Codes:
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
// * ErrCodeInternalServerError "InternalServerError"
// An error occurred on the server side.
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeTimeToLive
func ( c * DynamoDB ) DescribeTimeToLive ( input * DescribeTimeToLiveInput ) ( * DescribeTimeToLiveOutput , error ) {
req , out := c . DescribeTimeToLiveRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// DescribeTimeToLiveWithContext is the same as DescribeTimeToLive with the addition of
// the ability to pass a context and additional request options.
//
// See DescribeTimeToLive for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) DescribeTimeToLiveWithContext ( ctx aws . Context , input * DescribeTimeToLiveInput , opts ... request . Option ) ( * DescribeTimeToLiveOutput , error ) {
req , out := c . DescribeTimeToLiveRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2017-03-03 19:48:24 +01:00
}
2016-01-29 20:53:56 +01:00
const opGetItem = "GetItem"
2016-07-15 15:49:02 +02:00
// GetItemRequest generates a "aws/request.Request" representing the
// client's request for the GetItem operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See GetItem for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the GetItem method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the GetItemRequest method.
// req, resp := client.GetItemRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/GetItem
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) GetItemRequest ( input * GetItemInput ) ( req * request . Request , output * GetItemOutput ) {
op := & request . Operation {
Name : opGetItem ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & GetItemInput { }
}
output = & GetItemOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// GetItem API operation for Amazon DynamoDB.
//
2016-01-29 20:53:56 +01:00
// The GetItem operation returns a set of attributes for the item with the given
2017-01-23 22:22:31 +01:00
// primary key. If there is no matching item, GetItem does not return any data
// and there will be no Item element in the response.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// GetItem provides an eventually consistent read by default. If your application
2016-01-29 20:53:56 +01:00
// requires a strongly consistent read, set ConsistentRead to true. Although
// a strongly consistent read might take more time than an eventually consistent
// read, it always returns the last updated value.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation GetItem for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeProvisionedThroughputExceededException "ProvisionedThroughputExceededException"
2016-10-17 23:21:08 +02:00
// Your request rate is too high. The AWS SDKs for DynamoDB automatically retry
// requests that receive this exception. Your request is eventually successful,
// unless your retry queue is too large to finish. Reduce the frequency of requests
// and use exponential backoff. For more information, go to Error Retries and
2017-01-23 22:22:31 +01:00
// Exponential Backoff (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.Errors.html#Programming.Errors.RetryAndBackoff)
2016-10-17 23:21:08 +02:00
// in the Amazon DynamoDB Developer Guide.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
2016-10-17 23:21:08 +02:00
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2016-10-17 23:21:08 +02:00
// An error occurred on the server side.
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/GetItem
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) GetItem ( input * GetItemInput ) ( * GetItemOutput , error ) {
req , out := c . GetItemRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// GetItemWithContext is the same as GetItem with the addition of
// the ability to pass a context and additional request options.
//
// See GetItem for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) GetItemWithContext ( ctx aws . Context , input * GetItemInput , opts ... request . Option ) ( * GetItemOutput , error ) {
req , out := c . GetItemRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opListTables = "ListTables"
2016-07-15 15:49:02 +02:00
// ListTablesRequest generates a "aws/request.Request" representing the
// client's request for the ListTables operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See ListTables for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the ListTables method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the ListTablesRequest method.
// req, resp := client.ListTablesRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ListTables
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) ListTablesRequest ( input * ListTablesInput ) ( req * request . Request , output * ListTablesOutput ) {
op := & request . Operation {
Name : opListTables ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
Paginator : & request . Paginator {
InputTokens : [ ] string { "ExclusiveStartTableName" } ,
OutputTokens : [ ] string { "LastEvaluatedTableName" } ,
LimitToken : "Limit" ,
TruncationToken : "" ,
} ,
}
if input == nil {
input = & ListTablesInput { }
}
output = & ListTablesOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// ListTables API operation for Amazon DynamoDB.
//
2016-01-29 20:53:56 +01:00
// Returns an array of table names associated with the current account and endpoint.
// The output from ListTables is paginated, with each page returning a maximum
// of 100 table names.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation ListTables for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2016-10-17 23:21:08 +02:00
// An error occurred on the server side.
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ListTables
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) ListTables ( input * ListTablesInput ) ( * ListTablesOutput , error ) {
req , out := c . ListTablesRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// ListTablesWithContext is the same as ListTables with the addition of
// the ability to pass a context and additional request options.
//
// See ListTables for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) ListTablesWithContext ( ctx aws . Context , input * ListTablesInput , opts ... request . Option ) ( * ListTablesOutput , error ) {
req , out := c . ListTablesRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
2016-07-15 15:49:02 +02:00
// ListTablesPages iterates over the pages of a ListTables operation,
// calling the "fn" function with the response data for each page. To stop
// iterating, return false from the fn function.
//
// See ListTables method for more information on how to use this operation.
//
// Note: This operation can generate multiple requests to a service.
//
// // Example iterating over at most 3 pages of a ListTables operation.
// pageNum := 0
// err := client.ListTablesPages(params,
// func(page *ListTablesOutput, lastPage bool) bool {
// pageNum++
// fmt.Println(page)
// return pageNum <= 3
// })
//
2017-04-05 09:45:27 +02:00
func ( c * DynamoDB ) ListTablesPages ( input * ListTablesInput , fn func ( * ListTablesOutput , bool ) bool ) error {
return c . ListTablesPagesWithContext ( aws . BackgroundContext ( ) , input , fn )
}
// ListTablesPagesWithContext same as ListTablesPages except
// it takes a Context and allows setting request options on the pages.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) ListTablesPagesWithContext ( ctx aws . Context , input * ListTablesInput , fn func ( * ListTablesOutput , bool ) bool , opts ... request . Option ) error {
p := request . Pagination {
NewRequest : func ( ) ( * request . Request , error ) {
var inCpy * ListTablesInput
if input != nil {
tmp := * input
inCpy = & tmp
}
req , _ := c . ListTablesRequest ( inCpy )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return req , nil
} ,
}
cont := true
for p . Next ( ) && cont {
cont = fn ( p . Page ( ) . ( * ListTablesOutput ) , ! p . HasNextPage ( ) )
}
return p . Err ( )
2016-01-29 20:53:56 +01:00
}
2017-01-23 22:22:31 +01:00
const opListTagsOfResource = "ListTagsOfResource"
// ListTagsOfResourceRequest generates a "aws/request.Request" representing the
// client's request for the ListTagsOfResource operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
// See ListTagsOfResource for usage and error information.
//
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the ListTagsOfResource method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the ListTagsOfResourceRequest method.
// req, resp := client.ListTagsOfResourceRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ListTagsOfResource
func ( c * DynamoDB ) ListTagsOfResourceRequest ( input * ListTagsOfResourceInput ) ( req * request . Request , output * ListTagsOfResourceOutput ) {
op := & request . Operation {
Name : opListTagsOfResource ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & ListTagsOfResourceInput { }
}
output = & ListTagsOfResourceOutput { }
req = c . newRequest ( op , input , output )
return
}
// ListTagsOfResource API operation for Amazon DynamoDB.
//
// List all tags on an Amazon DynamoDB resource. You can call ListTagsOfResource
// up to 10 times per second, per account.
//
// For an overview on tagging DynamoDB resources, see Tagging for DynamoDB (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.html)
// in the Amazon DynamoDB Developer Guide.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation ListTagsOfResource for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
2017-01-23 22:22:31 +01:00
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2017-01-23 22:22:31 +01:00
// An error occurred on the server side.
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ListTagsOfResource
func ( c * DynamoDB ) ListTagsOfResource ( input * ListTagsOfResourceInput ) ( * ListTagsOfResourceOutput , error ) {
req , out := c . ListTagsOfResourceRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// ListTagsOfResourceWithContext is the same as ListTagsOfResource with the addition of
// the ability to pass a context and additional request options.
//
// See ListTagsOfResource for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) ListTagsOfResourceWithContext ( ctx aws . Context , input * ListTagsOfResourceInput , opts ... request . Option ) ( * ListTagsOfResourceOutput , error ) {
req , out := c . ListTagsOfResourceRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2017-01-23 22:22:31 +01:00
}
2016-01-29 20:53:56 +01:00
const opPutItem = "PutItem"
2016-07-15 15:49:02 +02:00
// PutItemRequest generates a "aws/request.Request" representing the
// client's request for the PutItem operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See PutItem for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the PutItem method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the PutItemRequest method.
// req, resp := client.PutItemRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/PutItem
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) PutItemRequest ( input * PutItemInput ) ( req * request . Request , output * PutItemOutput ) {
op := & request . Operation {
Name : opPutItem ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & PutItemInput { }
}
output = & PutItemOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// PutItem API operation for Amazon DynamoDB.
//
2016-01-29 20:53:56 +01:00
// Creates a new item, or replaces an old item with a new item. If an item that
// has the same primary key as the new item already exists in the specified
// table, the new item completely replaces the existing item. You can perform
// a conditional put operation (add a new item if one with the specified primary
// key doesn't exist), or replace an existing item if it has certain attribute
// values.
//
// In addition to putting an item, you can also return the item's attribute
// values in the same operation, using the ReturnValues parameter.
//
// When you add an item, the primary key attribute(s) are the only required
// attributes. Attribute values cannot be null. String and Binary type attributes
// must have lengths greater than zero. Set type attributes cannot be empty.
// Requests with empty values will be rejected with a ValidationException exception.
//
2016-11-19 19:41:01 +01:00
// To prevent a new item from replacing an existing item, use a conditional
2016-03-11 01:27:37 +01:00
// expression that contains the attribute_not_exists function with the name
// of the attribute being used as the partition key for the table. Since every
// record must contain that attribute, the attribute_not_exists function will
// only succeed if no matching item exists.
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// For more information about PutItem, see Working with Items (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation PutItem for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeConditionalCheckFailedException "ConditionalCheckFailedException"
2016-10-17 23:21:08 +02:00
// A condition specified in the operation could not be evaluated.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeProvisionedThroughputExceededException "ProvisionedThroughputExceededException"
2016-10-17 23:21:08 +02:00
// Your request rate is too high. The AWS SDKs for DynamoDB automatically retry
// requests that receive this exception. Your request is eventually successful,
// unless your retry queue is too large to finish. Reduce the frequency of requests
// and use exponential backoff. For more information, go to Error Retries and
2017-01-23 22:22:31 +01:00
// Exponential Backoff (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.Errors.html#Programming.Errors.RetryAndBackoff)
2016-10-17 23:21:08 +02:00
// in the Amazon DynamoDB Developer Guide.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
2016-10-17 23:21:08 +02:00
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeItemCollectionSizeLimitExceededException "ItemCollectionSizeLimitExceededException"
2016-10-17 23:21:08 +02:00
// An item collection is too large. This exception is only returned for tables
// that have one or more local secondary indexes.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2016-10-17 23:21:08 +02:00
// An error occurred on the server side.
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/PutItem
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) PutItem ( input * PutItemInput ) ( * PutItemOutput , error ) {
req , out := c . PutItemRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// PutItemWithContext is the same as PutItem with the addition of
// the ability to pass a context and additional request options.
//
// See PutItem for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) PutItemWithContext ( ctx aws . Context , input * PutItemInput , opts ... request . Option ) ( * PutItemOutput , error ) {
req , out := c . PutItemRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opQuery = "Query"
2016-07-15 15:49:02 +02:00
// QueryRequest generates a "aws/request.Request" representing the
// client's request for the Query operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See Query for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the Query method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the QueryRequest method.
// req, resp := client.QueryRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/Query
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) QueryRequest ( input * QueryInput ) ( req * request . Request , output * QueryOutput ) {
op := & request . Operation {
Name : opQuery ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
Paginator : & request . Paginator {
InputTokens : [ ] string { "ExclusiveStartKey" } ,
OutputTokens : [ ] string { "LastEvaluatedKey" } ,
LimitToken : "Limit" ,
TruncationToken : "" ,
} ,
}
if input == nil {
input = & QueryInput { }
}
output = & QueryOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// Query API operation for Amazon DynamoDB.
//
2016-01-29 20:53:56 +01:00
// A Query operation uses the primary key of a table or a secondary index to
// directly access items from that table or index.
//
2016-03-11 01:27:37 +01:00
// Use the KeyConditionExpression parameter to provide a specific value for
// the partition key. The Query operation will return all of the items from
// the table or index with that partition key value. You can optionally narrow
// the scope of the Query operation by specifying a sort key value and a comparison
// operator in KeyConditionExpression. You can use the ScanIndexForward parameter
// to get results in forward or reverse order, by sort key.
2016-01-29 20:53:56 +01:00
//
// Queries that do not return results consume the minimum number of read capacity
// units for that type of read operation.
//
// If the total number of items meeting the query criteria exceeds the result
// set size limit of 1 MB, the query stops and results are returned to the user
// with the LastEvaluatedKey element to continue the query in a subsequent operation.
// Unlike a Scan operation, a Query operation never returns both an empty result
2016-07-15 15:49:02 +02:00
// set and a LastEvaluatedKey value. LastEvaluatedKey is only provided if you
// have used the Limit parameter, or if the result set exceeds 1 MB (prior to
// applying a filter).
2016-01-29 20:53:56 +01:00
//
// You can query a table, a local secondary index, or a global secondary index.
// For a query on a table or on a local secondary index, you can set the ConsistentRead
// parameter to true and obtain a strongly consistent result. Global secondary
// indexes support eventually consistent reads only, so do not specify ConsistentRead
// when querying a global secondary index.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation Query for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeProvisionedThroughputExceededException "ProvisionedThroughputExceededException"
2016-10-17 23:21:08 +02:00
// Your request rate is too high. The AWS SDKs for DynamoDB automatically retry
// requests that receive this exception. Your request is eventually successful,
// unless your retry queue is too large to finish. Reduce the frequency of requests
// and use exponential backoff. For more information, go to Error Retries and
2017-01-23 22:22:31 +01:00
// Exponential Backoff (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.Errors.html#Programming.Errors.RetryAndBackoff)
2016-10-17 23:21:08 +02:00
// in the Amazon DynamoDB Developer Guide.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
2016-10-17 23:21:08 +02:00
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2016-10-17 23:21:08 +02:00
// An error occurred on the server side.
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/Query
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) Query ( input * QueryInput ) ( * QueryOutput , error ) {
req , out := c . QueryRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// QueryWithContext is the same as Query with the addition of
// the ability to pass a context and additional request options.
//
// See Query for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) QueryWithContext ( ctx aws . Context , input * QueryInput , opts ... request . Option ) ( * QueryOutput , error ) {
req , out := c . QueryRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
2016-07-15 15:49:02 +02:00
// QueryPages iterates over the pages of a Query operation,
// calling the "fn" function with the response data for each page. To stop
// iterating, return false from the fn function.
//
// See Query method for more information on how to use this operation.
//
// Note: This operation can generate multiple requests to a service.
//
// // Example iterating over at most 3 pages of a Query operation.
// pageNum := 0
// err := client.QueryPages(params,
// func(page *QueryOutput, lastPage bool) bool {
// pageNum++
// fmt.Println(page)
// return pageNum <= 3
// })
//
2017-04-05 09:45:27 +02:00
func ( c * DynamoDB ) QueryPages ( input * QueryInput , fn func ( * QueryOutput , bool ) bool ) error {
return c . QueryPagesWithContext ( aws . BackgroundContext ( ) , input , fn )
}
// QueryPagesWithContext same as QueryPages except
// it takes a Context and allows setting request options on the pages.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) QueryPagesWithContext ( ctx aws . Context , input * QueryInput , fn func ( * QueryOutput , bool ) bool , opts ... request . Option ) error {
p := request . Pagination {
NewRequest : func ( ) ( * request . Request , error ) {
var inCpy * QueryInput
if input != nil {
tmp := * input
inCpy = & tmp
}
req , _ := c . QueryRequest ( inCpy )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return req , nil
} ,
}
cont := true
for p . Next ( ) && cont {
cont = fn ( p . Page ( ) . ( * QueryOutput ) , ! p . HasNextPage ( ) )
}
return p . Err ( )
2016-01-29 20:53:56 +01:00
}
const opScan = "Scan"
2016-07-15 15:49:02 +02:00
// ScanRequest generates a "aws/request.Request" representing the
// client's request for the Scan operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See Scan for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the Scan method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the ScanRequest method.
// req, resp := client.ScanRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/Scan
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) ScanRequest ( input * ScanInput ) ( req * request . Request , output * ScanOutput ) {
op := & request . Operation {
Name : opScan ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
Paginator : & request . Paginator {
InputTokens : [ ] string { "ExclusiveStartKey" } ,
OutputTokens : [ ] string { "LastEvaluatedKey" } ,
LimitToken : "Limit" ,
TruncationToken : "" ,
} ,
}
if input == nil {
input = & ScanInput { }
}
output = & ScanOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// Scan API operation for Amazon DynamoDB.
//
2016-01-29 20:53:56 +01:00
// The Scan operation returns one or more items and item attributes by accessing
// every item in a table or a secondary index. To have DynamoDB return fewer
2017-01-23 22:22:31 +01:00
// items, you can provide a FilterExpression operation.
2016-01-29 20:53:56 +01:00
//
// If the total number of scanned items exceeds the maximum data set size limit
// of 1 MB, the scan stops and results are returned to the user as a LastEvaluatedKey
// value to continue the scan in a subsequent operation. The results also include
// the number of items exceeding the limit. A scan can result in no table data
// meeting the filter criteria.
//
// By default, Scan operations proceed sequentially; however, for faster performance
// on a large table or secondary index, applications can request a parallel
// Scan operation by providing the Segment and TotalSegments parameters. For
// more information, see Parallel Scan (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#QueryAndScanParallelScan)
// in the Amazon DynamoDB Developer Guide.
//
2016-03-11 01:27:37 +01:00
// By default, Scan uses eventually consistent reads when accessing the data
// in a table; therefore, the result set might not include the changes to data
// in the table immediately before the operation began. If you need a consistent
// copy of the data, as of the time that the Scan begins, you can set the ConsistentRead
// parameter to true.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation Scan for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeProvisionedThroughputExceededException "ProvisionedThroughputExceededException"
2016-10-17 23:21:08 +02:00
// Your request rate is too high. The AWS SDKs for DynamoDB automatically retry
// requests that receive this exception. Your request is eventually successful,
// unless your retry queue is too large to finish. Reduce the frequency of requests
// and use exponential backoff. For more information, go to Error Retries and
2017-01-23 22:22:31 +01:00
// Exponential Backoff (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.Errors.html#Programming.Errors.RetryAndBackoff)
2016-10-17 23:21:08 +02:00
// in the Amazon DynamoDB Developer Guide.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
2016-10-17 23:21:08 +02:00
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2016-10-17 23:21:08 +02:00
// An error occurred on the server side.
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/Scan
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) Scan ( input * ScanInput ) ( * ScanOutput , error ) {
req , out := c . ScanRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// ScanWithContext is the same as Scan with the addition of
// the ability to pass a context and additional request options.
//
// See Scan for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) ScanWithContext ( ctx aws . Context , input * ScanInput , opts ... request . Option ) ( * ScanOutput , error ) {
req , out := c . ScanRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
2016-07-15 15:49:02 +02:00
// ScanPages iterates over the pages of a Scan operation,
// calling the "fn" function with the response data for each page. To stop
// iterating, return false from the fn function.
//
// See Scan method for more information on how to use this operation.
//
// Note: This operation can generate multiple requests to a service.
//
// // Example iterating over at most 3 pages of a Scan operation.
// pageNum := 0
// err := client.ScanPages(params,
// func(page *ScanOutput, lastPage bool) bool {
// pageNum++
// fmt.Println(page)
// return pageNum <= 3
// })
//
2017-04-05 09:45:27 +02:00
func ( c * DynamoDB ) ScanPages ( input * ScanInput , fn func ( * ScanOutput , bool ) bool ) error {
return c . ScanPagesWithContext ( aws . BackgroundContext ( ) , input , fn )
}
// ScanPagesWithContext same as ScanPages except
// it takes a Context and allows setting request options on the pages.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) ScanPagesWithContext ( ctx aws . Context , input * ScanInput , fn func ( * ScanOutput , bool ) bool , opts ... request . Option ) error {
p := request . Pagination {
NewRequest : func ( ) ( * request . Request , error ) {
var inCpy * ScanInput
if input != nil {
tmp := * input
inCpy = & tmp
}
req , _ := c . ScanRequest ( inCpy )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return req , nil
} ,
}
cont := true
for p . Next ( ) && cont {
cont = fn ( p . Page ( ) . ( * ScanOutput ) , ! p . HasNextPage ( ) )
}
return p . Err ( )
2016-01-29 20:53:56 +01:00
}
2017-01-23 22:22:31 +01:00
const opTagResource = "TagResource"
// TagResourceRequest generates a "aws/request.Request" representing the
// client's request for the TagResource operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
// See TagResource for usage and error information.
//
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the TagResource method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the TagResourceRequest method.
// req, resp := client.TagResourceRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/TagResource
func ( c * DynamoDB ) TagResourceRequest ( input * TagResourceInput ) ( req * request . Request , output * TagResourceOutput ) {
op := & request . Operation {
Name : opTagResource ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & TagResourceInput { }
}
output = & TagResourceOutput { }
req = c . newRequest ( op , input , output )
req . Handlers . Unmarshal . Remove ( jsonrpc . UnmarshalHandler )
req . Handlers . Unmarshal . PushBackNamed ( protocol . UnmarshalDiscardBodyHandler )
return
}
// TagResource API operation for Amazon DynamoDB.
//
// Associate a set of tags with an Amazon DynamoDB resource. You can then activate
// these user-defined tags so that they appear on the Billing and Cost Management
// console for cost allocation tracking. You can call TagResource up to 5 times
// per second, per account.
//
// For an overview on tagging DynamoDB resources, see Tagging for DynamoDB (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.html)
// in the Amazon DynamoDB Developer Guide.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation TagResource for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeLimitExceededException "LimitExceededException"
2017-01-23 22:22:31 +01:00
// The number of concurrent table requests (cumulative number of tables in the
// CREATING, DELETING or UPDATING state) exceeds the maximum allowed of 10.
//
// Also, for tables with secondary indexes, only one of those tables can be
// in the CREATING state at any point in time. Do not attempt to create more
// than one such table simultaneously.
//
// The total limit of tables in the ACTIVE state is 250.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
2017-01-23 22:22:31 +01:00
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2017-01-23 22:22:31 +01:00
// An error occurred on the server side.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceInUseException "ResourceInUseException"
2017-01-23 22:22:31 +01:00
// The operation conflicts with the resource's availability. For example, you
// attempted to recreate an existing table, or tried to delete a table currently
// in the CREATING state.
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/TagResource
func ( c * DynamoDB ) TagResource ( input * TagResourceInput ) ( * TagResourceOutput , error ) {
req , out := c . TagResourceRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// TagResourceWithContext is the same as TagResource with the addition of
// the ability to pass a context and additional request options.
//
// See TagResource for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) TagResourceWithContext ( ctx aws . Context , input * TagResourceInput , opts ... request . Option ) ( * TagResourceOutput , error ) {
req , out := c . TagResourceRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2017-01-23 22:22:31 +01:00
}
const opUntagResource = "UntagResource"
// UntagResourceRequest generates a "aws/request.Request" representing the
// client's request for the UntagResource operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
// See UntagResource for usage and error information.
//
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the UntagResource method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the UntagResourceRequest method.
// req, resp := client.UntagResourceRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UntagResource
func ( c * DynamoDB ) UntagResourceRequest ( input * UntagResourceInput ) ( req * request . Request , output * UntagResourceOutput ) {
op := & request . Operation {
Name : opUntagResource ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & UntagResourceInput { }
}
output = & UntagResourceOutput { }
req = c . newRequest ( op , input , output )
req . Handlers . Unmarshal . Remove ( jsonrpc . UnmarshalHandler )
req . Handlers . Unmarshal . PushBackNamed ( protocol . UnmarshalDiscardBodyHandler )
return
}
// UntagResource API operation for Amazon DynamoDB.
//
// Removes the association of tags from an Amazon DynamoDB resource. You can
// call UntagResource up to 5 times per second, per account.
//
// For an overview on tagging DynamoDB resources, see Tagging for DynamoDB (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.html)
// in the Amazon DynamoDB Developer Guide.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation UntagResource for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeLimitExceededException "LimitExceededException"
2017-01-23 22:22:31 +01:00
// The number of concurrent table requests (cumulative number of tables in the
// CREATING, DELETING or UPDATING state) exceeds the maximum allowed of 10.
//
// Also, for tables with secondary indexes, only one of those tables can be
// in the CREATING state at any point in time. Do not attempt to create more
// than one such table simultaneously.
//
// The total limit of tables in the ACTIVE state is 250.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
2017-01-23 22:22:31 +01:00
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2017-01-23 22:22:31 +01:00
// An error occurred on the server side.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceInUseException "ResourceInUseException"
2017-01-23 22:22:31 +01:00
// The operation conflicts with the resource's availability. For example, you
// attempted to recreate an existing table, or tried to delete a table currently
// in the CREATING state.
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UntagResource
func ( c * DynamoDB ) UntagResource ( input * UntagResourceInput ) ( * UntagResourceOutput , error ) {
req , out := c . UntagResourceRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// UntagResourceWithContext is the same as UntagResource with the addition of
// the ability to pass a context and additional request options.
//
// See UntagResource for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) UntagResourceWithContext ( ctx aws . Context , input * UntagResourceInput , opts ... request . Option ) ( * UntagResourceOutput , error ) {
req , out := c . UntagResourceRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2017-01-23 22:22:31 +01:00
}
2016-01-29 20:53:56 +01:00
const opUpdateItem = "UpdateItem"
2016-07-15 15:49:02 +02:00
// UpdateItemRequest generates a "aws/request.Request" representing the
// client's request for the UpdateItem operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See UpdateItem for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the UpdateItem method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the UpdateItemRequest method.
// req, resp := client.UpdateItemRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateItem
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) UpdateItemRequest ( input * UpdateItemInput ) ( req * request . Request , output * UpdateItemOutput ) {
op := & request . Operation {
Name : opUpdateItem ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & UpdateItemInput { }
}
output = & UpdateItemOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// UpdateItem API operation for Amazon DynamoDB.
//
2016-01-29 20:53:56 +01:00
// Edits an existing item's attributes, or adds a new item to the table if it
// does not already exist. You can put, delete, or add attribute values. You
// can also perform a conditional update on an existing item (insert a new attribute
// name-value pair if it doesn't exist, or replace an existing name-value pair
2016-03-11 01:27:37 +01:00
// if it has certain expected attribute values).
2016-01-29 20:53:56 +01:00
//
// You can also return the item's attribute values in the same UpdateItem operation
// using the ReturnValues parameter.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation UpdateItem for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeConditionalCheckFailedException "ConditionalCheckFailedException"
2016-10-17 23:21:08 +02:00
// A condition specified in the operation could not be evaluated.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeProvisionedThroughputExceededException "ProvisionedThroughputExceededException"
2016-10-17 23:21:08 +02:00
// Your request rate is too high. The AWS SDKs for DynamoDB automatically retry
// requests that receive this exception. Your request is eventually successful,
// unless your retry queue is too large to finish. Reduce the frequency of requests
// and use exponential backoff. For more information, go to Error Retries and
2017-01-23 22:22:31 +01:00
// Exponential Backoff (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.Errors.html#Programming.Errors.RetryAndBackoff)
2016-10-17 23:21:08 +02:00
// in the Amazon DynamoDB Developer Guide.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
2016-10-17 23:21:08 +02:00
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeItemCollectionSizeLimitExceededException "ItemCollectionSizeLimitExceededException"
2016-10-17 23:21:08 +02:00
// An item collection is too large. This exception is only returned for tables
// that have one or more local secondary indexes.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2016-10-17 23:21:08 +02:00
// An error occurred on the server side.
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateItem
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) UpdateItem ( input * UpdateItemInput ) ( * UpdateItemOutput , error ) {
req , out := c . UpdateItemRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// UpdateItemWithContext is the same as UpdateItem with the addition of
// the ability to pass a context and additional request options.
//
// See UpdateItem for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) UpdateItemWithContext ( ctx aws . Context , input * UpdateItemInput , opts ... request . Option ) ( * UpdateItemOutput , error ) {
req , out := c . UpdateItemRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opUpdateTable = "UpdateTable"
2016-07-15 15:49:02 +02:00
// UpdateTableRequest generates a "aws/request.Request" representing the
// client's request for the UpdateTable operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See UpdateTable for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the UpdateTable method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the UpdateTableRequest method.
// req, resp := client.UpdateTableRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateTable
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) UpdateTableRequest ( input * UpdateTableInput ) ( req * request . Request , output * UpdateTableOutput ) {
op := & request . Operation {
Name : opUpdateTable ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & UpdateTableInput { }
}
output = & UpdateTableOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// UpdateTable API operation for Amazon DynamoDB.
//
2016-01-29 20:53:56 +01:00
// Modifies the provisioned throughput settings, global secondary indexes, or
// DynamoDB Streams settings for a given table.
//
// You can only perform one of the following operations at once:
//
2016-11-19 19:41:01 +01:00
// * Modify the provisioned throughput settings of the table.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Enable or disable Streams on the table.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Remove a global secondary index from the table.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Create a new global secondary index on the table. Once the index begins
// backfilling, you can use UpdateTable to perform other operations.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// UpdateTable is an asynchronous operation; while it is executing, the table
// status changes from ACTIVE to UPDATING. While it is UPDATING, you cannot
2016-01-29 20:53:56 +01:00
// issue another UpdateTable request. When the table returns to the ACTIVE state,
// the UpdateTable operation is complete.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation UpdateTable for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceInUseException "ResourceInUseException"
2016-10-17 23:21:08 +02:00
// The operation conflicts with the resource's availability. For example, you
// attempted to recreate an existing table, or tried to delete a table currently
// in the CREATING state.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
2016-10-17 23:21:08 +02:00
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeLimitExceededException "LimitExceededException"
2016-10-17 23:21:08 +02:00
// The number of concurrent table requests (cumulative number of tables in the
// CREATING, DELETING or UPDATING state) exceeds the maximum allowed of 10.
//
// Also, for tables with secondary indexes, only one of those tables can be
// in the CREATING state at any point in time. Do not attempt to create more
// than one such table simultaneously.
//
// The total limit of tables in the ACTIVE state is 250.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInternalServerError "InternalServerError"
2016-10-17 23:21:08 +02:00
// An error occurred on the server side.
//
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateTable
2016-01-29 20:53:56 +01:00
func ( c * DynamoDB ) UpdateTable ( input * UpdateTableInput ) ( * UpdateTableOutput , error ) {
req , out := c . UpdateTableRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// UpdateTableWithContext is the same as UpdateTable with the addition of
// the ability to pass a context and additional request options.
//
// See UpdateTable for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) UpdateTableWithContext ( ctx aws . Context , input * UpdateTableInput , opts ... request . Option ) ( * UpdateTableOutput , error ) {
req , out := c . UpdateTableRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
2017-03-03 19:48:24 +01:00
const opUpdateTimeToLive = "UpdateTimeToLive"
// UpdateTimeToLiveRequest generates a "aws/request.Request" representing the
// client's request for the UpdateTimeToLive operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
// See UpdateTimeToLive for usage and error information.
//
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the UpdateTimeToLive method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the UpdateTimeToLiveRequest method.
// req, resp := client.UpdateTimeToLiveRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateTimeToLive
func ( c * DynamoDB ) UpdateTimeToLiveRequest ( input * UpdateTimeToLiveInput ) ( req * request . Request , output * UpdateTimeToLiveOutput ) {
op := & request . Operation {
Name : opUpdateTimeToLive ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & UpdateTimeToLiveInput { }
}
output = & UpdateTimeToLiveOutput { }
req = c . newRequest ( op , input , output )
return
}
// UpdateTimeToLive API operation for Amazon DynamoDB.
//
// Specify the lifetime of individual table items. The database automatically
// removes the item at the expiration of the item. The UpdateTimeToLive method
// will enable or disable TTL for the specified table. A successful UpdateTimeToLive
// call returns the current TimeToLiveSpecification; it may take up to one hour
// for the change to fully process.
//
// TTL compares the current time in epoch time format to the time stored in
// the TTL attribute of an item. If the epoch time value stored in the attribute
// is less than the current time, the item is marked as expired and subsequently
// deleted.
//
// The epoch time format is the number of seconds elapsed since 12:00:00 AM
// January 1st, 1970 UTC.
//
// DynamoDB deletes expired items on a best-effort basis to ensure availability
// of throughput for other data operations.
//
// DynamoDB typically deletes expired items within two days of expiration. The
// exact duration within which an item gets deleted after expiration is specific
// to the nature of the workload. Items that have expired and not been deleted
// will still show up in reads, queries, and scans.
//
// As items are deleted, they are removed from any Local Secondary Index and
// Global Secondary Index immediately in the same eventually consistent way
// as a standard delete operation.
//
// For more information, see Time To Live (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/TTL.html)
// in the Amazon DynamoDB Developer Guide.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon DynamoDB's
// API operation UpdateTimeToLive for usage and error information.
//
// Returned Error Codes:
// * ErrCodeResourceInUseException "ResourceInUseException"
// The operation conflicts with the resource's availability. For example, you
// attempted to recreate an existing table, or tried to delete a table currently
// in the CREATING state.
//
// * ErrCodeResourceNotFoundException "ResourceNotFoundException"
// The operation tried to access a nonexistent table or index. The resource
// might not be specified correctly, or its status might not be ACTIVE.
//
// * ErrCodeLimitExceededException "LimitExceededException"
// The number of concurrent table requests (cumulative number of tables in the
// CREATING, DELETING or UPDATING state) exceeds the maximum allowed of 10.
//
// Also, for tables with secondary indexes, only one of those tables can be
// in the CREATING state at any point in time. Do not attempt to create more
// than one such table simultaneously.
//
// The total limit of tables in the ACTIVE state is 250.
//
// * ErrCodeInternalServerError "InternalServerError"
// An error occurred on the server side.
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateTimeToLive
func ( c * DynamoDB ) UpdateTimeToLive ( input * UpdateTimeToLiveInput ) ( * UpdateTimeToLiveOutput , error ) {
req , out := c . UpdateTimeToLiveRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// UpdateTimeToLiveWithContext is the same as UpdateTimeToLive with the addition of
// the ability to pass a context and additional request options.
//
// See UpdateTimeToLive for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * DynamoDB ) UpdateTimeToLiveWithContext ( ctx aws . Context , input * UpdateTimeToLiveInput , opts ... request . Option ) ( * UpdateTimeToLiveOutput , error ) {
req , out := c . UpdateTimeToLiveRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2017-03-03 19:48:24 +01:00
}
2016-01-29 20:53:56 +01:00
// Represents an attribute for describing the key schema for the table and indexes.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/AttributeDefinition
2016-01-29 20:53:56 +01:00
type AttributeDefinition struct {
_ struct { } ` type:"structure" `
// A name for the attribute.
2016-10-17 23:21:08 +02:00
//
// AttributeName is a required field
2016-01-29 20:53:56 +01:00
AttributeName * string ` min:"1" type:"string" required:"true" `
2016-03-11 01:27:37 +01:00
// The data type for the attribute, where:
//
2016-11-19 19:41:01 +01:00
// * S - the attribute is of type String
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * N - the attribute is of type Number
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * B - the attribute is of type Binary
2016-10-17 23:21:08 +02:00
//
// AttributeType is a required field
2016-01-29 20:53:56 +01:00
AttributeType * string ` type:"string" required:"true" enum:"ScalarAttributeType" `
}
// String returns the string representation
func ( s AttributeDefinition ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s AttributeDefinition ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * AttributeDefinition ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "AttributeDefinition" }
if s . AttributeName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "AttributeName" ) )
}
if s . AttributeName != nil && len ( * s . AttributeName ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "AttributeName" , 1 ) )
}
if s . AttributeType == nil {
invalidParams . Add ( request . NewErrParamRequired ( "AttributeType" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetAttributeName sets the AttributeName field's value.
func ( s * AttributeDefinition ) SetAttributeName ( v string ) * AttributeDefinition {
s . AttributeName = & v
return s
}
// SetAttributeType sets the AttributeType field's value.
func ( s * AttributeDefinition ) SetAttributeType ( v string ) * AttributeDefinition {
s . AttributeType = & v
return s
}
2017-01-23 22:22:31 +01:00
// Represents the data for an attribute.
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// Each attribute value is described as a name-value pair. The name is the data
// type, and the value is the data itself.
//
// For more information, see Data Types (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html#HowItWorks.DataTypes)
// in the Amazon DynamoDB Developer Guide.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/AttributeValue
2016-01-29 20:53:56 +01:00
type AttributeValue struct {
_ struct { } ` type:"structure" `
2017-01-23 22:22:31 +01:00
// An attribute of type Binary. For example:
//
// "B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"
2016-03-18 20:35:09 +01:00
//
// B is automatically base64 encoded/decoded by the SDK.
2016-01-29 20:53:56 +01:00
B [ ] byte ` type:"blob" `
2017-01-23 22:22:31 +01:00
// An attribute of type Boolean. For example:
//
// "BOOL": true
2016-01-29 20:53:56 +01:00
BOOL * bool ` type:"boolean" `
2017-01-23 22:22:31 +01:00
// An attribute of type Binary Set. For example:
//
// "BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]
2016-01-29 20:53:56 +01:00
BS [ ] [ ] byte ` type:"list" `
2017-01-23 22:22:31 +01:00
// An attribute of type List. For example:
//
// "L": ["Cookies", "Coffee", 3.14159]
2016-01-29 20:53:56 +01:00
L [ ] * AttributeValue ` type:"list" `
2017-01-23 22:22:31 +01:00
// An attribute of type Map. For example:
//
// "M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}
2016-01-29 20:53:56 +01:00
M map [ string ] * AttributeValue ` type:"map" `
2017-01-23 22:22:31 +01:00
// An attribute of type Number. For example:
//
// "N": "123.45"
//
// Numbers are sent across the network to DynamoDB as strings, to maximize compatibility
// across languages and libraries. However, DynamoDB treats them as number type
// attributes for mathematical operations.
2016-01-29 20:53:56 +01:00
N * string ` type:"string" `
2017-01-23 22:22:31 +01:00
// An attribute of type Number Set. For example:
//
// "NS": ["42.2", "-19", "7.5", "3.14"]
//
// Numbers are sent across the network to DynamoDB as strings, to maximize compatibility
// across languages and libraries. However, DynamoDB treats them as number type
// attributes for mathematical operations.
2016-01-29 20:53:56 +01:00
NS [ ] * string ` type:"list" `
2017-01-23 22:22:31 +01:00
// An attribute of type Null. For example:
//
// "NULL": true
2016-01-29 20:53:56 +01:00
NULL * bool ` type:"boolean" `
2017-01-23 22:22:31 +01:00
// An attribute of type String. For example:
//
// "S": "Hello"
2016-01-29 20:53:56 +01:00
S * string ` type:"string" `
2017-01-23 22:22:31 +01:00
// An attribute of type String Set. For example:
//
// "SS": ["Giraffe", "Hippo" ,"Zebra"]
2016-01-29 20:53:56 +01:00
SS [ ] * string ` type:"list" `
}
// String returns the string representation
func ( s AttributeValue ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s AttributeValue ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetB sets the B field's value.
func ( s * AttributeValue ) SetB ( v [ ] byte ) * AttributeValue {
s . B = v
return s
}
// SetBOOL sets the BOOL field's value.
func ( s * AttributeValue ) SetBOOL ( v bool ) * AttributeValue {
s . BOOL = & v
return s
}
// SetBS sets the BS field's value.
func ( s * AttributeValue ) SetBS ( v [ ] [ ] byte ) * AttributeValue {
s . BS = v
return s
}
// SetL sets the L field's value.
func ( s * AttributeValue ) SetL ( v [ ] * AttributeValue ) * AttributeValue {
s . L = v
return s
}
// SetM sets the M field's value.
func ( s * AttributeValue ) SetM ( v map [ string ] * AttributeValue ) * AttributeValue {
s . M = v
return s
}
// SetN sets the N field's value.
func ( s * AttributeValue ) SetN ( v string ) * AttributeValue {
s . N = & v
return s
}
// SetNS sets the NS field's value.
func ( s * AttributeValue ) SetNS ( v [ ] * string ) * AttributeValue {
s . NS = v
return s
}
// SetNULL sets the NULL field's value.
func ( s * AttributeValue ) SetNULL ( v bool ) * AttributeValue {
s . NULL = & v
return s
}
// SetS sets the S field's value.
func ( s * AttributeValue ) SetS ( v string ) * AttributeValue {
s . S = & v
return s
}
// SetSS sets the SS field's value.
func ( s * AttributeValue ) SetSS ( v [ ] * string ) * AttributeValue {
s . SS = v
return s
}
2016-01-29 20:53:56 +01:00
// For the UpdateItem operation, represents the attributes to be modified, the
// action to perform on each, and the new value for each.
//
2016-11-19 19:41:01 +01:00
// You cannot use UpdateItem to update any primary key attributes. Instead,
2016-01-29 20:53:56 +01:00
// you will need to delete the item, and then use PutItem to create a new item
// with new attributes.
//
2016-11-19 19:41:01 +01:00
// Attribute values cannot be null; string and binary type attributes must have
// lengths greater than zero; and set type attributes must not be empty. Requests
// with empty values will be rejected with a ValidationException exception.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/AttributeValueUpdate
2016-01-29 20:53:56 +01:00
type AttributeValueUpdate struct {
_ struct { } ` type:"structure" `
// Specifies how to perform the update. Valid values are PUT (default), DELETE,
// and ADD. The behavior depends on whether the specified primary key already
// exists in the table.
//
2016-11-19 19:41:01 +01:00
// If an item with the specified Key is found in the table:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * PUT - Adds the specified attribute to the item. If the attribute already
// exists, it is replaced by the new value.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * DELETE - If no value is specified, the attribute and its value are removed
// from the item. The data type of the specified value must match the existing
// value's data type.
2016-01-29 20:53:56 +01:00
//
// If a set of values is specified, then those values are subtracted from the
2016-11-19 19:41:01 +01:00
// old set. For example, if the attribute value was the set [a,b,c] and the
// DELETE action specified [a,c], then the final attribute value would be
// [b]. Specifying an empty set is an error.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ADD - If the attribute does not already exist, then the attribute and
// its values are added to the item. If the attribute does exist, then the
// behavior of ADD depends on the data type of the attribute:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// If the existing attribute is a number, and if Value is also a number, then
// the Value is mathematically added to the existing attribute. If Value
// is a negative number, then it is subtracted from the existing attribute.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// If you use ADD to increment or decrement a number value for an item that
// doesn't exist before the update, DynamoDB uses 0 as the initial value.
2016-01-29 20:53:56 +01:00
//
// In addition, if you use ADD to update an existing item, and intend to increment
2016-11-19 19:41:01 +01:00
// or decrement an attribute value which does not yet exist, DynamoDB uses
// 0 as the initial value. For example, suppose that the item you want to
// update does not yet have an attribute named itemcount, but you decide
// to ADD the number 3 to this attribute anyway, even though it currently
// does not exist. DynamoDB will create the itemcount attribute, set its
// initial value to 0, and finally add 3 to it. The result will be a new
// itemcount attribute in the item, with a value of 3.
//
// If the existing data type is a set, and if the Value is also a set, then
// the Value is added to the existing set. (This is a set operation, not
// mathematical addition.) For example, if the attribute value was the set
// [1,2], and the ADD action specified [3], then the final attribute value
// would be [1,2,3]. An error occurs if an Add action is specified for a
// set attribute and the attribute type specified does not match the existing
// set type.
2016-01-29 20:53:56 +01:00
//
// Both sets must have the same primitive data type. For example, if the existing
2016-11-19 19:41:01 +01:00
// data type is a set of strings, the Value must also be a set of strings.
// The same holds true for number sets and binary sets.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// This action is only valid for an existing attribute whose data type is number
// or is a set. Do not use ADD for any other data types.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// If no item with the specified Key is found:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * PUT - DynamoDB creates a new item with the specified primary key, and
// then adds the attribute.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * DELETE - Nothing happens; there is no attribute to delete.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ADD - DynamoDB creates an item with the supplied primary key and number
// (or set of numbers) for the attribute value. The only data types allowed
// are number and number set; no other data types can be specified.
2016-01-29 20:53:56 +01:00
Action * string ` type:"string" enum:"AttributeAction" `
2017-01-23 22:22:31 +01:00
// Represents the data for an attribute.
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// Each attribute value is described as a name-value pair. The name is the data
// type, and the value is the data itself.
//
// For more information, see Data TYpes (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html#HowItWorks.DataTypes)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
Value * AttributeValue ` type:"structure" `
}
// String returns the string representation
func ( s AttributeValueUpdate ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s AttributeValueUpdate ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetAction sets the Action field's value.
func ( s * AttributeValueUpdate ) SetAction ( v string ) * AttributeValueUpdate {
s . Action = & v
return s
}
// SetValue sets the Value field's value.
func ( s * AttributeValueUpdate ) SetValue ( v * AttributeValue ) * AttributeValueUpdate {
s . Value = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the input of a BatchGetItem operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/BatchGetItemInput
2016-01-29 20:53:56 +01:00
type BatchGetItemInput struct {
_ struct { } ` type:"structure" `
// A map of one or more table names and, for each table, a map that describes
// one or more items to retrieve from that table. Each table name can be used
// only once per BatchGetItem request.
//
// Each element in the map of items to retrieve consists of the following:
//
2016-11-19 19:41:01 +01:00
// * ConsistentRead - If true, a strongly consistent read is used; if false
// (the default), an eventually consistent read is used.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ExpressionAttributeNames - One or more substitution tokens for attribute
// names in the ProjectionExpression parameter. The following are some use
// cases for using ExpressionAttributeNames:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// To access an attribute whose name conflicts with a DynamoDB reserved word.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// To create a placeholder for repeating occurrences of an attribute name in
// an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// To prevent special characters in an attribute name from being misinterpreted
// in an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Use the # character in an expression to dereference an attribute name. For
// example, consider the following attribute name:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Percentile
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The name of this attribute conflicts with a reserved word, so it cannot be
// used directly in an expression. (For the complete list of reserved words,
// see Reserved Words (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html)
// in the Amazon DynamoDB Developer Guide). To work around this, you could
// specify the following for ExpressionAttributeNames:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// {"#P":"Percentile"}
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// You could then use this substitution in an expression, as in this example:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// #P = :val
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Tokens that begin with the : character are expression attribute values, which
// are placeholders for the actual value at runtime.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// For more information on expression attribute names, see Accessing Item Attributes
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Keys - An array of primary key attribute values that define specific
// items in the table. For each primary key, you must provide all of the
// key attributes. For example, with a simple primary key, you only need
// to provide the partition key value. For a composite key, you must provide
// both the partition key value and the sort key value.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ProjectionExpression - A string that identifies one or more attributes
// to retrieve from the table. These attributes can include scalars, sets,
// or elements of a JSON document. The attributes in the expression must
// be separated by commas.
2016-01-29 20:53:56 +01:00
//
// If no attribute names are specified, then all attributes will be returned.
2016-11-19 19:41:01 +01:00
// If any of the requested attributes are not found, they will not appear
// in the result.
2016-01-29 20:53:56 +01:00
//
// For more information, see Accessing Item Attributes (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html)
2016-11-19 19:41:01 +01:00
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// * AttributesToGet - This is a legacy parameter. Use ProjectionExpression
// instead. For more information, see AttributesToGet (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html)
// in the Amazon DynamoDB Developer Guide.
2016-10-17 23:21:08 +02:00
//
// RequestItems is a required field
2016-01-29 20:53:56 +01:00
RequestItems map [ string ] * KeysAndAttributes ` min:"1" type:"map" required:"true" `
// Determines the level of detail about provisioned throughput consumption that
// is returned in the response:
//
2016-11-19 19:41:01 +01:00
// * INDEXES - The response includes the aggregate ConsumedCapacity for the
// operation, together with ConsumedCapacity for each table and secondary
// index that was accessed.
2016-01-29 20:53:56 +01:00
//
// Note that some operations, such as GetItem and BatchGetItem, do not access
2016-11-19 19:41:01 +01:00
// any indexes at all. In these cases, specifying INDEXES will only return
// ConsumedCapacity information for table(s).
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * TOTAL - The response includes only the aggregate ConsumedCapacity for
// the operation.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * NONE - No ConsumedCapacity details are included in the response.
2016-01-29 20:53:56 +01:00
ReturnConsumedCapacity * string ` type:"string" enum:"ReturnConsumedCapacity" `
}
// String returns the string representation
func ( s BatchGetItemInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s BatchGetItemInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * BatchGetItemInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "BatchGetItemInput" }
if s . RequestItems == nil {
invalidParams . Add ( request . NewErrParamRequired ( "RequestItems" ) )
}
if s . RequestItems != nil && len ( s . RequestItems ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "RequestItems" , 1 ) )
}
if s . RequestItems != nil {
for i , v := range s . RequestItems {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "RequestItems" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetRequestItems sets the RequestItems field's value.
func ( s * BatchGetItemInput ) SetRequestItems ( v map [ string ] * KeysAndAttributes ) * BatchGetItemInput {
s . RequestItems = v
return s
}
// SetReturnConsumedCapacity sets the ReturnConsumedCapacity field's value.
func ( s * BatchGetItemInput ) SetReturnConsumedCapacity ( v string ) * BatchGetItemInput {
s . ReturnConsumedCapacity = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the output of a BatchGetItem operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/BatchGetItemOutput
2016-01-29 20:53:56 +01:00
type BatchGetItemOutput struct {
_ struct { } ` type:"structure" `
2017-01-23 22:22:31 +01:00
// The read capacity units consumed by the entire BatchGetItem operation.
2016-01-29 20:53:56 +01:00
//
// Each element consists of:
//
2016-11-19 19:41:01 +01:00
// * TableName - The table that consumed the provisioned throughput.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * CapacityUnits - The total number of capacity units consumed.
2016-01-29 20:53:56 +01:00
ConsumedCapacity [ ] * ConsumedCapacity ` type:"list" `
// A map of table name to a list of items. Each object in Responses consists
// of a table name, along with a map of attribute data consisting of the data
// type and attribute value.
Responses map [ string ] [ ] map [ string ] * AttributeValue ` type:"map" `
// A map of tables and their respective keys that were not processed with the
// current response. The UnprocessedKeys value is in the same form as RequestItems,
// so the value can be provided directly to a subsequent BatchGetItem operation.
// For more information, see RequestItems in the Request Parameters section.
//
// Each element consists of:
//
2016-11-19 19:41:01 +01:00
// * Keys - An array of primary key attribute values that define specific
// items in the table.
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// * ProjectionExpression - One or more attributes to be retrieved from the
// table or index. By default, all attributes are returned. If a requested
// attribute is not found, it does not appear in the result.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ConsistentRead - The consistency of a read operation. If set to true,
// then a strongly consistent read is used; otherwise, an eventually consistent
// read is used.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// If there are no unprocessed keys remaining, the response contains an empty
2016-01-29 20:53:56 +01:00
// UnprocessedKeys map.
UnprocessedKeys map [ string ] * KeysAndAttributes ` min:"1" type:"map" `
}
// String returns the string representation
func ( s BatchGetItemOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s BatchGetItemOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetConsumedCapacity sets the ConsumedCapacity field's value.
func ( s * BatchGetItemOutput ) SetConsumedCapacity ( v [ ] * ConsumedCapacity ) * BatchGetItemOutput {
s . ConsumedCapacity = v
return s
}
// SetResponses sets the Responses field's value.
func ( s * BatchGetItemOutput ) SetResponses ( v map [ string ] [ ] map [ string ] * AttributeValue ) * BatchGetItemOutput {
s . Responses = v
return s
}
// SetUnprocessedKeys sets the UnprocessedKeys field's value.
func ( s * BatchGetItemOutput ) SetUnprocessedKeys ( v map [ string ] * KeysAndAttributes ) * BatchGetItemOutput {
s . UnprocessedKeys = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the input of a BatchWriteItem operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/BatchWriteItemInput
2016-01-29 20:53:56 +01:00
type BatchWriteItemInput struct {
_ struct { } ` type:"structure" `
// A map of one or more table names and, for each table, a list of operations
// to be performed (DeleteRequest or PutRequest). Each element in the map consists
// of the following:
//
2016-11-19 19:41:01 +01:00
// * DeleteRequest - Perform a DeleteItem operation on the specified item.
// The item to be deleted is identified by a Key subelement:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Key - A map of primary key attribute values that uniquely identify the !
// item. Each entry in this map consists of an attribute name and an attribute
// value. For each primary key, you must provide all of the key attributes.
// For example, with a simple primary key, you only need to provide a value
// for the partition key. For a composite primary key, you must provide values
// for both the partition key and the sort key.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * PutRequest - Perform a PutItem operation on the specified item. The
// item to be put is identified by an Item subelement:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Item - A map of attributes and their values. Each entry in this map consists
// of an attribute name and an attribute value. Attribute values must not
// be null; string and binary type attributes must have lengths greater than
// zero; and set type attributes must not be empty. Requests that contain
// empty values will be rejected with a ValidationException exception.
2016-01-29 20:53:56 +01:00
//
// If you specify any attributes that are part of an index key, then the data
2016-11-19 19:41:01 +01:00
// types for those attributes must match those of the schema in the table's
// attribute definition.
2016-10-17 23:21:08 +02:00
//
// RequestItems is a required field
2016-01-29 20:53:56 +01:00
RequestItems map [ string ] [ ] * WriteRequest ` min:"1" type:"map" required:"true" `
// Determines the level of detail about provisioned throughput consumption that
// is returned in the response:
//
2016-11-19 19:41:01 +01:00
// * INDEXES - The response includes the aggregate ConsumedCapacity for the
// operation, together with ConsumedCapacity for each table and secondary
// index that was accessed.
2016-01-29 20:53:56 +01:00
//
// Note that some operations, such as GetItem and BatchGetItem, do not access
2016-11-19 19:41:01 +01:00
// any indexes at all. In these cases, specifying INDEXES will only return
// ConsumedCapacity information for table(s).
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * TOTAL - The response includes only the aggregate ConsumedCapacity for
// the operation.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * NONE - No ConsumedCapacity details are included in the response.
2016-01-29 20:53:56 +01:00
ReturnConsumedCapacity * string ` type:"string" enum:"ReturnConsumedCapacity" `
// Determines whether item collection metrics are returned. If set to SIZE,
// the response includes statistics about item collections, if any, that were
// modified during the operation are returned in the response. If set to NONE
// (the default), no statistics are returned.
ReturnItemCollectionMetrics * string ` type:"string" enum:"ReturnItemCollectionMetrics" `
}
// String returns the string representation
func ( s BatchWriteItemInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s BatchWriteItemInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * BatchWriteItemInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "BatchWriteItemInput" }
if s . RequestItems == nil {
invalidParams . Add ( request . NewErrParamRequired ( "RequestItems" ) )
}
if s . RequestItems != nil && len ( s . RequestItems ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "RequestItems" , 1 ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetRequestItems sets the RequestItems field's value.
func ( s * BatchWriteItemInput ) SetRequestItems ( v map [ string ] [ ] * WriteRequest ) * BatchWriteItemInput {
s . RequestItems = v
return s
}
// SetReturnConsumedCapacity sets the ReturnConsumedCapacity field's value.
func ( s * BatchWriteItemInput ) SetReturnConsumedCapacity ( v string ) * BatchWriteItemInput {
s . ReturnConsumedCapacity = & v
return s
}
// SetReturnItemCollectionMetrics sets the ReturnItemCollectionMetrics field's value.
func ( s * BatchWriteItemInput ) SetReturnItemCollectionMetrics ( v string ) * BatchWriteItemInput {
s . ReturnItemCollectionMetrics = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the output of a BatchWriteItem operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/BatchWriteItemOutput
2016-01-29 20:53:56 +01:00
type BatchWriteItemOutput struct {
_ struct { } ` type:"structure" `
2017-01-23 22:22:31 +01:00
// The capacity units consumed by the entire BatchWriteItem operation.
2016-01-29 20:53:56 +01:00
//
// Each element consists of:
//
2016-11-19 19:41:01 +01:00
// * TableName - The table that consumed the provisioned throughput.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * CapacityUnits - The total number of capacity units consumed.
2016-01-29 20:53:56 +01:00
ConsumedCapacity [ ] * ConsumedCapacity ` type:"list" `
// A list of tables that were processed by BatchWriteItem and, for each table,
// information about any item collections that were affected by individual DeleteItem
// or PutItem operations.
//
// Each entry consists of the following subelements:
//
2016-11-19 19:41:01 +01:00
// * ItemCollectionKey - The partition key value of the item collection.
// This is the same as the partition key value of the item.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * SizeEstimateRange - An estimate of item collection size, expressed in
// GB. This is a two-element array containing a lower bound and an upper
// bound for the estimate. The estimate includes the size of all the items
// in the table, plus the size of all attributes projected into all of the
// local secondary indexes on the table. Use this estimate to measure whether
// a local secondary index is approaching its size limit.
2016-01-29 20:53:56 +01:00
//
// The estimate is subject to change over time; therefore, do not rely on the
2016-11-19 19:41:01 +01:00
// precision or accuracy of the estimate.
2016-01-29 20:53:56 +01:00
ItemCollectionMetrics map [ string ] [ ] * ItemCollectionMetrics ` type:"map" `
// A map of tables and requests against those tables that were not processed.
// The UnprocessedItems value is in the same form as RequestItems, so you can
// provide this value directly to a subsequent BatchGetItem operation. For more
// information, see RequestItems in the Request Parameters section.
//
// Each UnprocessedItems entry consists of a table name and, for that table,
// a list of operations to perform (DeleteRequest or PutRequest).
//
2016-11-19 19:41:01 +01:00
// * DeleteRequest - Perform a DeleteItem operation on the specified item.
// The item to be deleted is identified by a Key subelement:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Key - A map of primary key attribute values that uniquely identify the item.
// Each entry in this map consists of an attribute name and an attribute
// value.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * PutRequest - Perform a PutItem operation on the specified item. The
// item to be put is identified by an Item subelement:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Item - A map of attributes and their values. Each entry in this map consists
// of an attribute name and an attribute value. Attribute values must not
// be null; string and binary type attributes must have lengths greater than
// zero; and set type attributes must not be empty. Requests that contain
// empty values will be rejected with a ValidationException exception.
2016-01-29 20:53:56 +01:00
//
// If you specify any attributes that are part of an index key, then the data
2016-11-19 19:41:01 +01:00
// types for those attributes must match those of the schema in the table's
// attribute definition.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// If there are no unprocessed items remaining, the response contains an empty
// UnprocessedItems map.
2016-01-29 20:53:56 +01:00
UnprocessedItems map [ string ] [ ] * WriteRequest ` min:"1" type:"map" `
}
// String returns the string representation
func ( s BatchWriteItemOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s BatchWriteItemOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetConsumedCapacity sets the ConsumedCapacity field's value.
func ( s * BatchWriteItemOutput ) SetConsumedCapacity ( v [ ] * ConsumedCapacity ) * BatchWriteItemOutput {
s . ConsumedCapacity = v
return s
}
// SetItemCollectionMetrics sets the ItemCollectionMetrics field's value.
func ( s * BatchWriteItemOutput ) SetItemCollectionMetrics ( v map [ string ] [ ] * ItemCollectionMetrics ) * BatchWriteItemOutput {
s . ItemCollectionMetrics = v
return s
}
// SetUnprocessedItems sets the UnprocessedItems field's value.
func ( s * BatchWriteItemOutput ) SetUnprocessedItems ( v map [ string ] [ ] * WriteRequest ) * BatchWriteItemOutput {
s . UnprocessedItems = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the amount of provisioned throughput capacity consumed on a table
// or an index.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/Capacity
2016-01-29 20:53:56 +01:00
type Capacity struct {
_ struct { } ` type:"structure" `
// The total number of capacity units consumed on a table or an index.
CapacityUnits * float64 ` type:"double" `
}
// String returns the string representation
func ( s Capacity ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s Capacity ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetCapacityUnits sets the CapacityUnits field's value.
func ( s * Capacity ) SetCapacityUnits ( v float64 ) * Capacity {
s . CapacityUnits = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the selection criteria for a Query or Scan operation:
//
2016-11-19 19:41:01 +01:00
// * For a Query operation, Condition is used for specifying the KeyConditions
// to use when querying a table or an index. For KeyConditions, only the
// following comparison operators are supported:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Condition is also used in a QueryFilter, which evaluates the query results
// and returns only the desired values.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * For a Scan operation, Condition is used in a ScanFilter, which evaluates
// the scan results and returns only the desired values.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/Condition
2016-01-29 20:53:56 +01:00
type Condition struct {
_ struct { } ` type:"structure" `
// One or more values to evaluate against the supplied attribute. The number
// of values in the list depends on the ComparisonOperator being used.
//
// For type Number, value comparisons are numeric.
//
// String value comparisons for greater than, equals, or less than are based
// on ASCII character code values. For example, a is greater than A, and a is
// greater than B. For a list of code values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters
// (http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters).
//
// For Binary, DynamoDB treats each byte of the binary data as unsigned when
// it compares binary values.
AttributeValueList [ ] * AttributeValue ` type:"list" `
// A comparator for evaluating attributes. For example, equals, greater than,
// less than, etc.
//
// The following comparison operators are available:
//
2016-11-19 19:41:01 +01:00
// EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS |
// BEGINS_WITH | IN | BETWEEN
2016-01-29 20:53:56 +01:00
//
// The following are descriptions of each comparison operator.
//
2017-01-23 22:22:31 +01:00
// * EQ : Equal. EQ is supported for all data types, including lists and
// maps.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// AttributeValueList can contain only one AttributeValue element of type String,
// Number, Binary, String Set, Number Set, or Binary Set. If an item contains
// an AttributeValue element of a different type than the one provided in
// the request, the value does not match. For example, {"S":"6"} does not
// equal {"N":"6"}. Also, {"N":"6"} does not equal {"NS":["6", "2", "1"]}.
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// * NE : Not equal. NE is supported for all data types, including lists
// and maps.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * AttributeValueList can contain only one AttributeValue of type String,
// Number, Binary, String Set, Number Set, or Binary Set. If an item contains
// an AttributeValue of a different type than the one provided in the request,
// the value does not match. For example, {"S":"6"} does not equal {"N":"6"}.
// Also, {"N":"6"} does not equal {"NS":["6", "2", "1"]}.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * LE : Less than or equal.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// AttributeValueList can contain only one AttributeValue element of type String,
2016-07-15 15:49:02 +02:00
// Number, or Binary (not a set type). If an item contains an AttributeValue
// element of a different type than the one provided in the request, the value
// does not match. For example, {"S":"6"} does not equal {"N":"6"}. Also, {"N":"6"}
2016-01-29 20:53:56 +01:00
// does not compare to {"NS":["6", "2", "1"]}.
//
2016-11-19 19:41:01 +01:00
// LT: Less than.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// AttributeValueListcan contain only one AttributeValueof type String, Number, or Binary (not a set type). If an item contains an
// AttributeValueelement of a different type than the one provided in the request, the value
// does not match. For example, {"S":"6"}does not equal {"N":"6"}. Also, {"N":"6"}does not compare to {"NS":["6", "2", "1"]}
2016-10-17 23:21:08 +02:00
//
// ComparisonOperator is a required field
2016-01-29 20:53:56 +01:00
ComparisonOperator * string ` type:"string" required:"true" enum:"ComparisonOperator" `
}
// String returns the string representation
func ( s Condition ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s Condition ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * Condition ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "Condition" }
if s . ComparisonOperator == nil {
invalidParams . Add ( request . NewErrParamRequired ( "ComparisonOperator" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetAttributeValueList sets the AttributeValueList field's value.
func ( s * Condition ) SetAttributeValueList ( v [ ] * AttributeValue ) * Condition {
s . AttributeValueList = v
return s
}
// SetComparisonOperator sets the ComparisonOperator field's value.
func ( s * Condition ) SetComparisonOperator ( v string ) * Condition {
s . ComparisonOperator = & v
return s
}
2016-01-29 20:53:56 +01:00
// The capacity units consumed by an operation. The data returned includes the
// total provisioned throughput consumed, along with statistics for the table
// and any indexes involved in the operation. ConsumedCapacity is only returned
// if the request asked for it. For more information, see Provisioned Throughput
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html)
// in the Amazon DynamoDB Developer Guide.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ConsumedCapacity
2016-01-29 20:53:56 +01:00
type ConsumedCapacity struct {
_ struct { } ` type:"structure" `
// The total number of capacity units consumed by the operation.
CapacityUnits * float64 ` type:"double" `
// The amount of throughput consumed on each global index affected by the operation.
GlobalSecondaryIndexes map [ string ] * Capacity ` type:"map" `
// The amount of throughput consumed on each local index affected by the operation.
LocalSecondaryIndexes map [ string ] * Capacity ` type:"map" `
// The amount of throughput consumed on the table affected by the operation.
Table * Capacity ` type:"structure" `
// The name of the table that was affected by the operation.
TableName * string ` min:"3" type:"string" `
}
// String returns the string representation
func ( s ConsumedCapacity ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ConsumedCapacity ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetCapacityUnits sets the CapacityUnits field's value.
func ( s * ConsumedCapacity ) SetCapacityUnits ( v float64 ) * ConsumedCapacity {
s . CapacityUnits = & v
return s
}
// SetGlobalSecondaryIndexes sets the GlobalSecondaryIndexes field's value.
func ( s * ConsumedCapacity ) SetGlobalSecondaryIndexes ( v map [ string ] * Capacity ) * ConsumedCapacity {
s . GlobalSecondaryIndexes = v
return s
}
// SetLocalSecondaryIndexes sets the LocalSecondaryIndexes field's value.
func ( s * ConsumedCapacity ) SetLocalSecondaryIndexes ( v map [ string ] * Capacity ) * ConsumedCapacity {
s . LocalSecondaryIndexes = v
return s
}
// SetTable sets the Table field's value.
func ( s * ConsumedCapacity ) SetTable ( v * Capacity ) * ConsumedCapacity {
s . Table = v
return s
}
// SetTableName sets the TableName field's value.
func ( s * ConsumedCapacity ) SetTableName ( v string ) * ConsumedCapacity {
s . TableName = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents a new global secondary index to be added to an existing table.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/CreateGlobalSecondaryIndexAction
2016-01-29 20:53:56 +01:00
type CreateGlobalSecondaryIndexAction struct {
_ struct { } ` type:"structure" `
// The name of the global secondary index to be created.
2016-10-17 23:21:08 +02:00
//
// IndexName is a required field
2016-01-29 20:53:56 +01:00
IndexName * string ` min:"3" type:"string" required:"true" `
// The key schema for the global secondary index.
2016-10-17 23:21:08 +02:00
//
// KeySchema is a required field
2016-01-29 20:53:56 +01:00
KeySchema [ ] * KeySchemaElement ` min:"1" type:"list" required:"true" `
// Represents attributes that are copied (projected) from the table into an
// index. These are in addition to the primary key attributes and index key
// attributes, which are automatically projected.
2016-10-17 23:21:08 +02:00
//
// Projection is a required field
2016-01-29 20:53:56 +01:00
Projection * Projection ` type:"structure" required:"true" `
2017-01-23 22:22:31 +01:00
// Represents the provisioned throughput settings for the specified global secondary
// index.
2016-01-29 20:53:56 +01:00
//
// For current minimum and maximum provisioned throughput values, see Limits
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html)
// in the Amazon DynamoDB Developer Guide.
2016-10-17 23:21:08 +02:00
//
// ProvisionedThroughput is a required field
2016-01-29 20:53:56 +01:00
ProvisionedThroughput * ProvisionedThroughput ` type:"structure" required:"true" `
}
// String returns the string representation
func ( s CreateGlobalSecondaryIndexAction ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s CreateGlobalSecondaryIndexAction ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * CreateGlobalSecondaryIndexAction ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "CreateGlobalSecondaryIndexAction" }
if s . IndexName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "IndexName" ) )
}
if s . IndexName != nil && len ( * s . IndexName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "IndexName" , 3 ) )
}
if s . KeySchema == nil {
invalidParams . Add ( request . NewErrParamRequired ( "KeySchema" ) )
}
if s . KeySchema != nil && len ( s . KeySchema ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "KeySchema" , 1 ) )
}
if s . Projection == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Projection" ) )
}
if s . ProvisionedThroughput == nil {
invalidParams . Add ( request . NewErrParamRequired ( "ProvisionedThroughput" ) )
}
if s . KeySchema != nil {
for i , v := range s . KeySchema {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "KeySchema" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if s . Projection != nil {
if err := s . Projection . Validate ( ) ; err != nil {
invalidParams . AddNested ( "Projection" , err . ( request . ErrInvalidParams ) )
}
}
if s . ProvisionedThroughput != nil {
if err := s . ProvisionedThroughput . Validate ( ) ; err != nil {
invalidParams . AddNested ( "ProvisionedThroughput" , err . ( request . ErrInvalidParams ) )
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetIndexName sets the IndexName field's value.
func ( s * CreateGlobalSecondaryIndexAction ) SetIndexName ( v string ) * CreateGlobalSecondaryIndexAction {
s . IndexName = & v
return s
}
// SetKeySchema sets the KeySchema field's value.
func ( s * CreateGlobalSecondaryIndexAction ) SetKeySchema ( v [ ] * KeySchemaElement ) * CreateGlobalSecondaryIndexAction {
s . KeySchema = v
return s
}
// SetProjection sets the Projection field's value.
func ( s * CreateGlobalSecondaryIndexAction ) SetProjection ( v * Projection ) * CreateGlobalSecondaryIndexAction {
s . Projection = v
return s
}
// SetProvisionedThroughput sets the ProvisionedThroughput field's value.
func ( s * CreateGlobalSecondaryIndexAction ) SetProvisionedThroughput ( v * ProvisionedThroughput ) * CreateGlobalSecondaryIndexAction {
s . ProvisionedThroughput = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the input of a CreateTable operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/CreateTableInput
2016-01-29 20:53:56 +01:00
type CreateTableInput struct {
_ struct { } ` type:"structure" `
// An array of attributes that describe the key schema for the table and indexes.
2016-10-17 23:21:08 +02:00
//
// AttributeDefinitions is a required field
2016-01-29 20:53:56 +01:00
AttributeDefinitions [ ] * AttributeDefinition ` type:"list" required:"true" `
// One or more global secondary indexes (the maximum is five) to be created
// on the table. Each global secondary index in the array includes the following:
//
2016-11-19 19:41:01 +01:00
// * IndexName - The name of the global secondary index. Must be unique only
// for this table.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * KeySchema - Specifies the key schema for the global secondary index.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Projection - Specifies attributes that are copied (projected) from the
// table into the index. These are in addition to the primary key attributes
// and index key attributes, which are automatically projected. Each attribute
// specification is composed of:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ProjectionType - One of the following:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// KEYS_ONLY - Only the index and primary keys are projected into the index.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// INCLUDE - Only the specified table attributes are projected into the index.
// The list of projected attributes are in NonKeyAttributes.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// ALL - All of the table attributes are projected into the index.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// NonKeyAttributes - A list of one or more non-key attribute names that are
// projected into the secondary index. The total count of attributes provided
// in NonKeyAttributes, summed across all of the secondary indexes, must
// not exceed 20. If you project the same attribute into two different indexes,
// this counts as two distinct attributes when determining the total.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ProvisionedThroughput - The provisioned throughput settings for the
// global secondary index, consisting of read and write capacity units.
2016-01-29 20:53:56 +01:00
GlobalSecondaryIndexes [ ] * GlobalSecondaryIndex ` type:"list" `
// Specifies the attributes that make up the primary key for a table or an index.
// The attributes in KeySchema must also be defined in the AttributeDefinitions
// array. For more information, see Data Model (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DataModel.html)
// in the Amazon DynamoDB Developer Guide.
//
// Each KeySchemaElement in the array is composed of:
//
2016-11-19 19:41:01 +01:00
// * AttributeName - The name of this key attribute.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * KeyType - The role that the key attribute will assume:
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// HASH - partition key
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// RANGE - sort key
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The partition key of an item is also known as its hash attribute. The term
// "hash attribute" derives from DynamoDB' usage of an internal hash function
2016-03-11 01:27:37 +01:00
// to evenly distribute data items across partitions, based on their partition
// key values.
//
// The sort key of an item is also known as its range attribute. The term "range
// attribute" derives from the way DynamoDB stores items with the same partition
// key physically close together, in sorted order by the sort key value.
//
2016-11-19 19:41:01 +01:00
// For a simple primary key (partition key), you must provide exactly one element
// with a KeyType of HASH.
2016-03-11 01:27:37 +01:00
//
// For a composite primary key (partition key and sort key), you must provide
2016-01-29 20:53:56 +01:00
// exactly two elements, in this order: The first element must have a KeyType
// of HASH, and the second element must have a KeyType of RANGE.
//
// For more information, see Specifying the Primary Key (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html#WorkingWithTables.primary.key)
// in the Amazon DynamoDB Developer Guide.
2016-10-17 23:21:08 +02:00
//
// KeySchema is a required field
2016-01-29 20:53:56 +01:00
KeySchema [ ] * KeySchemaElement ` min:"1" type:"list" required:"true" `
// One or more local secondary indexes (the maximum is five) to be created on
2016-03-11 01:27:37 +01:00
// the table. Each index is scoped to a given partition key value. There is
// a 10 GB size limit per partition key value; otherwise, the size of a local
// secondary index is unconstrained.
2016-01-29 20:53:56 +01:00
//
// Each local secondary index in the array includes the following:
//
2016-11-19 19:41:01 +01:00
// * IndexName - The name of the local secondary index. Must be unique only
// for this table.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * KeySchema - Specifies the key schema for the local secondary index.
// The key schema must begin with the same partition key as the table.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Projection - Specifies attributes that are copied (projected) from the
// table into the index. These are in addition to the primary key attributes
// and index key attributes, which are automatically projected. Each attribute
// specification is composed of:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ProjectionType - One of the following:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// KEYS_ONLY - Only the index and primary keys are projected into the index.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// INCLUDE - Only the specified table attributes are projected into the index.
// The list of projected attributes are in NonKeyAttributes.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// ALL - All of the table attributes are projected into the index.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// NonKeyAttributes - A list of one or more non-key attribute names that are
// projected into the secondary index. The total count of attributes provided
// in NonKeyAttributes, summed across all of the secondary indexes, must
// not exceed 20. If you project the same attribute into two different indexes,
// this counts as two distinct attributes when determining the total.
2016-01-29 20:53:56 +01:00
LocalSecondaryIndexes [ ] * LocalSecondaryIndex ` type:"list" `
// Represents the provisioned throughput settings for a specified table or index.
// The settings can be modified using the UpdateTable operation.
//
// For current minimum and maximum provisioned throughput values, see Limits
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html)
// in the Amazon DynamoDB Developer Guide.
2016-10-17 23:21:08 +02:00
//
// ProvisionedThroughput is a required field
2016-01-29 20:53:56 +01:00
ProvisionedThroughput * ProvisionedThroughput ` type:"structure" required:"true" `
// The settings for DynamoDB Streams on the table. These settings consist of:
//
2016-11-19 19:41:01 +01:00
// * StreamEnabled - Indicates whether Streams is to be enabled (true) or
// disabled (false).
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * StreamViewType - When an item in the table is modified, StreamViewType
// determines what information is written to the table's stream. Valid values
// for StreamViewType are:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// KEYS_ONLY - Only the key attributes of the modified item are written to the
// stream.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// NEW_IMAGE - The entire item, as it appears after it was modified, is written
// to the stream.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// OLD_IMAGE - The entire item, as it appeared before it was modified, is written
// to the stream.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// NEW_AND_OLD_IMAGES - Both the new and the old item images of the item are
// written to the stream.
2016-01-29 20:53:56 +01:00
StreamSpecification * StreamSpecification ` type:"structure" `
// The name of the table to create.
2016-10-17 23:21:08 +02:00
//
// TableName is a required field
2016-01-29 20:53:56 +01:00
TableName * string ` min:"3" type:"string" required:"true" `
}
// String returns the string representation
func ( s CreateTableInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s CreateTableInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * CreateTableInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "CreateTableInput" }
if s . AttributeDefinitions == nil {
invalidParams . Add ( request . NewErrParamRequired ( "AttributeDefinitions" ) )
}
if s . KeySchema == nil {
invalidParams . Add ( request . NewErrParamRequired ( "KeySchema" ) )
}
if s . KeySchema != nil && len ( s . KeySchema ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "KeySchema" , 1 ) )
}
if s . ProvisionedThroughput == nil {
invalidParams . Add ( request . NewErrParamRequired ( "ProvisionedThroughput" ) )
}
if s . TableName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "TableName" ) )
}
if s . TableName != nil && len ( * s . TableName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "TableName" , 3 ) )
}
if s . AttributeDefinitions != nil {
for i , v := range s . AttributeDefinitions {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "AttributeDefinitions" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if s . GlobalSecondaryIndexes != nil {
for i , v := range s . GlobalSecondaryIndexes {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "GlobalSecondaryIndexes" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if s . KeySchema != nil {
for i , v := range s . KeySchema {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "KeySchema" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if s . LocalSecondaryIndexes != nil {
for i , v := range s . LocalSecondaryIndexes {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "LocalSecondaryIndexes" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if s . ProvisionedThroughput != nil {
if err := s . ProvisionedThroughput . Validate ( ) ; err != nil {
invalidParams . AddNested ( "ProvisionedThroughput" , err . ( request . ErrInvalidParams ) )
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetAttributeDefinitions sets the AttributeDefinitions field's value.
func ( s * CreateTableInput ) SetAttributeDefinitions ( v [ ] * AttributeDefinition ) * CreateTableInput {
s . AttributeDefinitions = v
return s
}
// SetGlobalSecondaryIndexes sets the GlobalSecondaryIndexes field's value.
func ( s * CreateTableInput ) SetGlobalSecondaryIndexes ( v [ ] * GlobalSecondaryIndex ) * CreateTableInput {
s . GlobalSecondaryIndexes = v
return s
}
// SetKeySchema sets the KeySchema field's value.
func ( s * CreateTableInput ) SetKeySchema ( v [ ] * KeySchemaElement ) * CreateTableInput {
s . KeySchema = v
return s
}
// SetLocalSecondaryIndexes sets the LocalSecondaryIndexes field's value.
func ( s * CreateTableInput ) SetLocalSecondaryIndexes ( v [ ] * LocalSecondaryIndex ) * CreateTableInput {
s . LocalSecondaryIndexes = v
return s
}
// SetProvisionedThroughput sets the ProvisionedThroughput field's value.
func ( s * CreateTableInput ) SetProvisionedThroughput ( v * ProvisionedThroughput ) * CreateTableInput {
s . ProvisionedThroughput = v
return s
}
// SetStreamSpecification sets the StreamSpecification field's value.
func ( s * CreateTableInput ) SetStreamSpecification ( v * StreamSpecification ) * CreateTableInput {
s . StreamSpecification = v
return s
}
// SetTableName sets the TableName field's value.
func ( s * CreateTableInput ) SetTableName ( v string ) * CreateTableInput {
s . TableName = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the output of a CreateTable operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/CreateTableOutput
2016-01-29 20:53:56 +01:00
type CreateTableOutput struct {
_ struct { } ` type:"structure" `
2017-01-23 22:22:31 +01:00
// Represents the properties of the table.
2016-01-29 20:53:56 +01:00
TableDescription * TableDescription ` type:"structure" `
}
// String returns the string representation
func ( s CreateTableOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s CreateTableOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetTableDescription sets the TableDescription field's value.
func ( s * CreateTableOutput ) SetTableDescription ( v * TableDescription ) * CreateTableOutput {
s . TableDescription = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents a global secondary index to be deleted from an existing table.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteGlobalSecondaryIndexAction
2016-01-29 20:53:56 +01:00
type DeleteGlobalSecondaryIndexAction struct {
_ struct { } ` type:"structure" `
// The name of the global secondary index to be deleted.
2016-10-17 23:21:08 +02:00
//
// IndexName is a required field
2016-01-29 20:53:56 +01:00
IndexName * string ` min:"3" type:"string" required:"true" `
}
// String returns the string representation
func ( s DeleteGlobalSecondaryIndexAction ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DeleteGlobalSecondaryIndexAction ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * DeleteGlobalSecondaryIndexAction ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "DeleteGlobalSecondaryIndexAction" }
if s . IndexName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "IndexName" ) )
}
if s . IndexName != nil && len ( * s . IndexName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "IndexName" , 3 ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetIndexName sets the IndexName field's value.
func ( s * DeleteGlobalSecondaryIndexAction ) SetIndexName ( v string ) * DeleteGlobalSecondaryIndexAction {
s . IndexName = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the input of a DeleteItem operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteItemInput
2016-01-29 20:53:56 +01:00
type DeleteItemInput struct {
_ struct { } ` type:"structure" `
// A condition that must be satisfied in order for a conditional DeleteItem
// to succeed.
//
// An expression can contain any of the following:
//
2016-11-19 19:41:01 +01:00
// * Functions: attribute_exists | attribute_not_exists | attribute_type
// | contains | begins_with | size
2016-01-29 20:53:56 +01:00
//
// These function names are case-sensitive.
//
2017-03-03 19:48:24 +01:00
// * Comparison operators: = | <> | < | > | <= | >= | BETWEEN | IN
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Logical operators: AND | OR | NOT
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// For more information on condition expressions, see Specifying Conditions
2016-01-29 20:53:56 +01:00
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html)
// in the Amazon DynamoDB Developer Guide.
ConditionExpression * string ` type:"string" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use ConditionExpression instead. For more information,
// see ConditionalOperator (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.ConditionalOperator.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
ConditionalOperator * string ` type:"string" enum:"ConditionalOperator" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use ConditionExpresssion instead. For more information,
// see Expected (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.Expected.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
Expected map [ string ] * ExpectedAttributeValue ` type:"map" `
// One or more substitution tokens for attribute names in an expression. The
// following are some use cases for using ExpressionAttributeNames:
//
2016-11-19 19:41:01 +01:00
// * To access an attribute whose name conflicts with a DynamoDB reserved
// word.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * To create a placeholder for repeating occurrences of an attribute name
// in an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * To prevent special characters in an attribute name from being misinterpreted
// in an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Use the # character in an expression to dereference an attribute name. For
// example, consider the following attribute name:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Percentile
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The name of this attribute conflicts with a reserved word, so it cannot be
// used directly in an expression. (For the complete list of reserved words,
2016-01-29 20:53:56 +01:00
// see Reserved Words (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html)
// in the Amazon DynamoDB Developer Guide). To work around this, you could specify
// the following for ExpressionAttributeNames:
//
2016-11-19 19:41:01 +01:00
// * {"#P":"Percentile"}
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// You could then use this substitution in an expression, as in this example:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * #P = :val
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Tokens that begin with the : character are expression attribute values, which
// are placeholders for the actual value at runtime.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// For more information on expression attribute names, see Accessing Item Attributes
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
ExpressionAttributeNames map [ string ] * string ` type:"map" `
// One or more values that can be substituted in an expression.
//
// Use the : (colon) character in an expression to dereference an attribute
// value. For example, suppose that you wanted to check whether the value of
// the ProductStatus attribute was one of the following:
//
2016-11-19 19:41:01 +01:00
// Available | Backordered | Discontinued
2016-01-29 20:53:56 +01:00
//
// You would first need to specify ExpressionAttributeValues as follows:
//
2016-11-19 19:41:01 +01:00
// { ":avail":{"S":"Available"}, ":back":{"S":"Backordered"}, ":disc":{"S":"Discontinued"}
2016-01-29 20:53:56 +01:00
// }
//
// You could then use these values in an expression, such as this:
//
2016-11-19 19:41:01 +01:00
// ProductStatus IN (:avail, :back, :disc)
2016-01-29 20:53:56 +01:00
//
// For more information on expression attribute values, see Specifying Conditions
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html)
// in the Amazon DynamoDB Developer Guide.
ExpressionAttributeValues map [ string ] * AttributeValue ` type:"map" `
// A map of attribute names to AttributeValue objects, representing the primary
// key of the item to delete.
//
// For the primary key, you must provide all of the attributes. For example,
2016-03-11 01:27:37 +01:00
// with a simple primary key, you only need to provide a value for the partition
// key. For a composite primary key, you must provide values for both the partition
// key and the sort key.
2016-10-17 23:21:08 +02:00
//
// Key is a required field
2016-01-29 20:53:56 +01:00
Key map [ string ] * AttributeValue ` type:"map" required:"true" `
// Determines the level of detail about provisioned throughput consumption that
// is returned in the response:
//
2016-11-19 19:41:01 +01:00
// * INDEXES - The response includes the aggregate ConsumedCapacity for the
// operation, together with ConsumedCapacity for each table and secondary
// index that was accessed.
2016-01-29 20:53:56 +01:00
//
// Note that some operations, such as GetItem and BatchGetItem, do not access
2016-11-19 19:41:01 +01:00
// any indexes at all. In these cases, specifying INDEXES will only return
// ConsumedCapacity information for table(s).
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * TOTAL - The response includes only the aggregate ConsumedCapacity for
// the operation.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * NONE - No ConsumedCapacity details are included in the response.
2016-01-29 20:53:56 +01:00
ReturnConsumedCapacity * string ` type:"string" enum:"ReturnConsumedCapacity" `
// Determines whether item collection metrics are returned. If set to SIZE,
// the response includes statistics about item collections, if any, that were
// modified during the operation are returned in the response. If set to NONE
// (the default), no statistics are returned.
ReturnItemCollectionMetrics * string ` type:"string" enum:"ReturnItemCollectionMetrics" `
// Use ReturnValues if you want to get the item attributes as they appeared
// before they were deleted. For DeleteItem, the valid values are:
//
2016-11-19 19:41:01 +01:00
// * NONE - If ReturnValues is not specified, or if its value is NONE, then
// nothing is returned. (This setting is the default for ReturnValues.)
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ALL_OLD - The content of the old item is returned.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// The ReturnValues parameter is used by several DynamoDB operations; however,
2016-07-15 15:49:02 +02:00
// DeleteItem does not recognize any values other than NONE or ALL_OLD.
2016-01-29 20:53:56 +01:00
ReturnValues * string ` type:"string" enum:"ReturnValue" `
// The name of the table from which to delete the item.
2016-10-17 23:21:08 +02:00
//
// TableName is a required field
2016-01-29 20:53:56 +01:00
TableName * string ` min:"3" type:"string" required:"true" `
}
// String returns the string representation
func ( s DeleteItemInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DeleteItemInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * DeleteItemInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "DeleteItemInput" }
if s . Key == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Key" ) )
}
if s . TableName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "TableName" ) )
}
if s . TableName != nil && len ( * s . TableName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "TableName" , 3 ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetConditionExpression sets the ConditionExpression field's value.
func ( s * DeleteItemInput ) SetConditionExpression ( v string ) * DeleteItemInput {
s . ConditionExpression = & v
return s
}
// SetConditionalOperator sets the ConditionalOperator field's value.
func ( s * DeleteItemInput ) SetConditionalOperator ( v string ) * DeleteItemInput {
s . ConditionalOperator = & v
return s
}
// SetExpected sets the Expected field's value.
func ( s * DeleteItemInput ) SetExpected ( v map [ string ] * ExpectedAttributeValue ) * DeleteItemInput {
s . Expected = v
return s
}
// SetExpressionAttributeNames sets the ExpressionAttributeNames field's value.
func ( s * DeleteItemInput ) SetExpressionAttributeNames ( v map [ string ] * string ) * DeleteItemInput {
s . ExpressionAttributeNames = v
return s
}
// SetExpressionAttributeValues sets the ExpressionAttributeValues field's value.
func ( s * DeleteItemInput ) SetExpressionAttributeValues ( v map [ string ] * AttributeValue ) * DeleteItemInput {
s . ExpressionAttributeValues = v
return s
}
// SetKey sets the Key field's value.
func ( s * DeleteItemInput ) SetKey ( v map [ string ] * AttributeValue ) * DeleteItemInput {
s . Key = v
return s
}
// SetReturnConsumedCapacity sets the ReturnConsumedCapacity field's value.
func ( s * DeleteItemInput ) SetReturnConsumedCapacity ( v string ) * DeleteItemInput {
s . ReturnConsumedCapacity = & v
return s
}
// SetReturnItemCollectionMetrics sets the ReturnItemCollectionMetrics field's value.
func ( s * DeleteItemInput ) SetReturnItemCollectionMetrics ( v string ) * DeleteItemInput {
s . ReturnItemCollectionMetrics = & v
return s
}
// SetReturnValues sets the ReturnValues field's value.
func ( s * DeleteItemInput ) SetReturnValues ( v string ) * DeleteItemInput {
s . ReturnValues = & v
return s
}
// SetTableName sets the TableName field's value.
func ( s * DeleteItemInput ) SetTableName ( v string ) * DeleteItemInput {
s . TableName = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the output of a DeleteItem operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteItemOutput
2016-01-29 20:53:56 +01:00
type DeleteItemOutput struct {
_ struct { } ` type:"structure" `
// A map of attribute names to AttributeValue objects, representing the item
// as it appeared before the DeleteItem operation. This map appears in the response
// only if ReturnValues was specified as ALL_OLD in the request.
Attributes map [ string ] * AttributeValue ` type:"map" `
2017-01-23 22:22:31 +01:00
// The capacity units consumed by the DeleteItem operation. The data returned
// includes the total provisioned throughput consumed, along with statistics
// for the table and any indexes involved in the operation. ConsumedCapacity
// is only returned if the ReturnConsumedCapacity parameter was specified. For
// more information, see Provisioned Throughput (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
ConsumedCapacity * ConsumedCapacity ` type:"structure" `
2017-01-23 22:22:31 +01:00
// Information about item collections, if any, that were affected by the DeleteItem
// operation. ItemCollectionMetrics is only returned if the ReturnItemCollectionMetrics
// parameter was specified. If the table does not have any local secondary indexes,
// this information is not returned in the response.
2016-01-29 20:53:56 +01:00
//
// Each ItemCollectionMetrics element consists of:
//
2016-11-19 19:41:01 +01:00
// * ItemCollectionKey - The partition key value of the item collection.
// This is the same as the partition key value of the item itself.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * SizeEstimateRange - An estimate of item collection size, in gigabytes.
// This value is a two-element array containing a lower bound and an upper
// bound for the estimate. The estimate includes the size of all the items
// in the table, plus the size of all attributes projected into all of the
// local secondary indexes on that table. Use this estimate to measure whether
// a local secondary index is approaching its size limit.
2016-01-29 20:53:56 +01:00
//
// The estimate is subject to change over time; therefore, do not rely on the
2016-11-19 19:41:01 +01:00
// precision or accuracy of the estimate.
2016-01-29 20:53:56 +01:00
ItemCollectionMetrics * ItemCollectionMetrics ` type:"structure" `
}
// String returns the string representation
func ( s DeleteItemOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DeleteItemOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetAttributes sets the Attributes field's value.
func ( s * DeleteItemOutput ) SetAttributes ( v map [ string ] * AttributeValue ) * DeleteItemOutput {
s . Attributes = v
return s
}
// SetConsumedCapacity sets the ConsumedCapacity field's value.
func ( s * DeleteItemOutput ) SetConsumedCapacity ( v * ConsumedCapacity ) * DeleteItemOutput {
s . ConsumedCapacity = v
return s
}
// SetItemCollectionMetrics sets the ItemCollectionMetrics field's value.
func ( s * DeleteItemOutput ) SetItemCollectionMetrics ( v * ItemCollectionMetrics ) * DeleteItemOutput {
s . ItemCollectionMetrics = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents a request to perform a DeleteItem operation on an item.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteRequest
2016-01-29 20:53:56 +01:00
type DeleteRequest struct {
_ struct { } ` type:"structure" `
// A map of attribute name to attribute values, representing the primary key
// of the item to delete. All of the table's primary key attributes must be
// specified, and their data types must match those of the table's key schema.
2016-10-17 23:21:08 +02:00
//
// Key is a required field
2016-01-29 20:53:56 +01:00
Key map [ string ] * AttributeValue ` type:"map" required:"true" `
}
// String returns the string representation
func ( s DeleteRequest ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DeleteRequest ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetKey sets the Key field's value.
func ( s * DeleteRequest ) SetKey ( v map [ string ] * AttributeValue ) * DeleteRequest {
s . Key = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the input of a DeleteTable operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteTableInput
2016-01-29 20:53:56 +01:00
type DeleteTableInput struct {
_ struct { } ` type:"structure" `
// The name of the table to delete.
2016-10-17 23:21:08 +02:00
//
// TableName is a required field
2016-01-29 20:53:56 +01:00
TableName * string ` min:"3" type:"string" required:"true" `
}
// String returns the string representation
func ( s DeleteTableInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DeleteTableInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * DeleteTableInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "DeleteTableInput" }
if s . TableName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "TableName" ) )
}
if s . TableName != nil && len ( * s . TableName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "TableName" , 3 ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetTableName sets the TableName field's value.
func ( s * DeleteTableInput ) SetTableName ( v string ) * DeleteTableInput {
s . TableName = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the output of a DeleteTable operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteTableOutput
2016-01-29 20:53:56 +01:00
type DeleteTableOutput struct {
_ struct { } ` type:"structure" `
// Represents the properties of a table.
TableDescription * TableDescription ` type:"structure" `
}
// String returns the string representation
func ( s DeleteTableOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DeleteTableOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetTableDescription sets the TableDescription field's value.
func ( s * DeleteTableOutput ) SetTableDescription ( v * TableDescription ) * DeleteTableOutput {
s . TableDescription = v
return s
}
2016-03-11 01:27:37 +01:00
// Represents the input of a DescribeLimits operation. Has no content.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeLimitsInput
2016-03-11 01:27:37 +01:00
type DescribeLimitsInput struct {
_ struct { } ` type:"structure" `
}
// String returns the string representation
func ( s DescribeLimitsInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DescribeLimitsInput ) GoString ( ) string {
return s . String ( )
}
// Represents the output of a DescribeLimits operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeLimitsOutput
2016-03-11 01:27:37 +01:00
type DescribeLimitsOutput struct {
_ struct { } ` type:"structure" `
// The maximum total read capacity units that your account allows you to provision
// across all of your tables in this region.
AccountMaxReadCapacityUnits * int64 ` min:"1" type:"long" `
// The maximum total write capacity units that your account allows you to provision
// across all of your tables in this region.
AccountMaxWriteCapacityUnits * int64 ` min:"1" type:"long" `
// The maximum read capacity units that your account allows you to provision
// for a new table that you are creating in this region, including the read
// capacity units provisioned for its global secondary indexes (GSIs).
TableMaxReadCapacityUnits * int64 ` min:"1" type:"long" `
// The maximum write capacity units that your account allows you to provision
// for a new table that you are creating in this region, including the write
// capacity units provisioned for its global secondary indexes (GSIs).
TableMaxWriteCapacityUnits * int64 ` min:"1" type:"long" `
}
// String returns the string representation
func ( s DescribeLimitsOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DescribeLimitsOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetAccountMaxReadCapacityUnits sets the AccountMaxReadCapacityUnits field's value.
func ( s * DescribeLimitsOutput ) SetAccountMaxReadCapacityUnits ( v int64 ) * DescribeLimitsOutput {
s . AccountMaxReadCapacityUnits = & v
return s
}
// SetAccountMaxWriteCapacityUnits sets the AccountMaxWriteCapacityUnits field's value.
func ( s * DescribeLimitsOutput ) SetAccountMaxWriteCapacityUnits ( v int64 ) * DescribeLimitsOutput {
s . AccountMaxWriteCapacityUnits = & v
return s
}
// SetTableMaxReadCapacityUnits sets the TableMaxReadCapacityUnits field's value.
func ( s * DescribeLimitsOutput ) SetTableMaxReadCapacityUnits ( v int64 ) * DescribeLimitsOutput {
s . TableMaxReadCapacityUnits = & v
return s
}
// SetTableMaxWriteCapacityUnits sets the TableMaxWriteCapacityUnits field's value.
func ( s * DescribeLimitsOutput ) SetTableMaxWriteCapacityUnits ( v int64 ) * DescribeLimitsOutput {
s . TableMaxWriteCapacityUnits = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the input of a DescribeTable operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeTableInput
2016-01-29 20:53:56 +01:00
type DescribeTableInput struct {
_ struct { } ` type:"structure" `
// The name of the table to describe.
2016-10-17 23:21:08 +02:00
//
// TableName is a required field
2016-01-29 20:53:56 +01:00
TableName * string ` min:"3" type:"string" required:"true" `
}
// String returns the string representation
func ( s DescribeTableInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DescribeTableInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * DescribeTableInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "DescribeTableInput" }
if s . TableName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "TableName" ) )
}
if s . TableName != nil && len ( * s . TableName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "TableName" , 3 ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetTableName sets the TableName field's value.
func ( s * DescribeTableInput ) SetTableName ( v string ) * DescribeTableInput {
s . TableName = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the output of a DescribeTable operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeTableOutput
2016-01-29 20:53:56 +01:00
type DescribeTableOutput struct {
_ struct { } ` type:"structure" `
2017-01-23 22:22:31 +01:00
// The properties of the table.
2016-01-29 20:53:56 +01:00
Table * TableDescription ` type:"structure" `
}
// String returns the string representation
func ( s DescribeTableOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DescribeTableOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetTable sets the Table field's value.
func ( s * DescribeTableOutput ) SetTable ( v * TableDescription ) * DescribeTableOutput {
s . Table = v
return s
}
2017-03-03 19:48:24 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeTimeToLiveInput
type DescribeTimeToLiveInput struct {
_ struct { } ` type:"structure" `
// The name of the table to be described.
//
// TableName is a required field
TableName * string ` min:"3" type:"string" required:"true" `
}
// String returns the string representation
func ( s DescribeTimeToLiveInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DescribeTimeToLiveInput ) GoString ( ) string {
return s . String ( )
}
// Validate inspects the fields of the type to determine if they are valid.
func ( s * DescribeTimeToLiveInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "DescribeTimeToLiveInput" }
if s . TableName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "TableName" ) )
}
if s . TableName != nil && len ( * s . TableName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "TableName" , 3 ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
// SetTableName sets the TableName field's value.
func ( s * DescribeTimeToLiveInput ) SetTableName ( v string ) * DescribeTimeToLiveInput {
s . TableName = & v
return s
}
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeTimeToLiveOutput
type DescribeTimeToLiveOutput struct {
_ struct { } ` type:"structure" `
TimeToLiveDescription * TimeToLiveDescription ` type:"structure" `
}
// String returns the string representation
func ( s DescribeTimeToLiveOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DescribeTimeToLiveOutput ) GoString ( ) string {
return s . String ( )
}
// SetTimeToLiveDescription sets the TimeToLiveDescription field's value.
func ( s * DescribeTimeToLiveOutput ) SetTimeToLiveDescription ( v * TimeToLiveDescription ) * DescribeTimeToLiveOutput {
s . TimeToLiveDescription = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents a condition to be compared with an attribute value. This condition
// can be used with DeleteItem, PutItem or UpdateItem operations; if the comparison
// evaluates to true, the operation succeeds; if not, the operation fails. You
// can use ExpectedAttributeValue in one of two different ways:
//
2016-11-19 19:41:01 +01:00
// * Use AttributeValueList to specify one or more values to compare against
// an attribute. Use ComparisonOperator to specify how you want to perform
// the comparison. If the comparison evaluates to true, then the conditional
// operation succeeds.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Use Value to specify a value that DynamoDB will compare against an attribute.
// If the values match, then ExpectedAttributeValue evaluates to true and
// the conditional operation succeeds. Optionally, you can also set Exists
// to false, indicating that you do not expect to find the attribute value
// in the table. In this case, the conditional operation succeeds only if
// the comparison evaluates to false.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Value and Exists are incompatible with AttributeValueList and ComparisonOperator.
2016-01-29 20:53:56 +01:00
// Note that if you use both sets of parameters at once, DynamoDB will return
// a ValidationException exception.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExpectedAttributeValue
2016-01-29 20:53:56 +01:00
type ExpectedAttributeValue struct {
_ struct { } ` type:"structure" `
// One or more values to evaluate against the supplied attribute. The number
// of values in the list depends on the ComparisonOperator being used.
//
// For type Number, value comparisons are numeric.
//
// String value comparisons for greater than, equals, or less than are based
// on ASCII character code values. For example, a is greater than A, and a is
// greater than B. For a list of code values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters
// (http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters).
//
// For Binary, DynamoDB treats each byte of the binary data as unsigned when
// it compares binary values.
//
// For information on specifying data types in JSON, see JSON Data Format (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DataFormat.html)
// in the Amazon DynamoDB Developer Guide.
AttributeValueList [ ] * AttributeValue ` type:"list" `
// A comparator for evaluating attributes in the AttributeValueList. For example,
// equals, greater than, less than, etc.
//
// The following comparison operators are available:
//
2016-11-19 19:41:01 +01:00
// EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS |
// BEGINS_WITH | IN | BETWEEN
2016-01-29 20:53:56 +01:00
//
// The following are descriptions of each comparison operator.
//
2017-01-23 22:22:31 +01:00
// * EQ : Equal. EQ is supported for all data types, including lists and
// maps.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// AttributeValueList can contain only one AttributeValue element of type String,
// Number, Binary, String Set, Number Set, or Binary Set. If an item contains
// an AttributeValue element of a different type than the one provided in
// the request, the value does not match. For example, {"S":"6"} does not
// equal {"N":"6"}. Also, {"N":"6"} does not equal {"NS":["6", "2", "1"]}.
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// * NE : Not equal. NE is supported for all data types, including lists
// and maps.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * AttributeValueList can contain only one AttributeValue of type String,
// Number, Binary, String Set, Number Set, or Binary Set. If an item contains
// an AttributeValue of a different type than the one provided in the request,
// the value does not match. For example, {"S":"6"} does not equal {"N":"6"}.
// Also, {"N":"6"} does not equal {"NS":["6", "2", "1"]}.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * LE : Less than or equal.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// AttributeValueList can contain only one AttributeValue element of type String,
2016-07-15 15:49:02 +02:00
// Number, or Binary (not a set type). If an item contains an AttributeValue
// element of a different type than the one provided in the request, the value
// does not match. For example, {"S":"6"} does not equal {"N":"6"}. Also, {"N":"6"}
2016-01-29 20:53:56 +01:00
// does not compare to {"NS":["6", "2", "1"]}.
//
2016-11-19 19:41:01 +01:00
// LT: Less than.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// AttributeValueListcan contain only one AttributeValueof type String, Number, or Binary (not a set type). If an item contains an
// AttributeValueelement of a different type than the one provided in the request, the value
// does not match. For example, {"S":"6"}does not equal {"N":"6"}. Also, {"N":"6"}does not compare to {"NS":["6", "2", "1"]}
ComparisonOperator * string ` type:"string" enum:"ComparisonOperator" `
// Causes DynamoDB to evaluate the value before attempting a conditional operation:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * If Exists is true, DynamoDB will check to see if that attribute value
// already exists in the table. If it is found, then the operation succeeds.
// If it is not found, the operation fails with a ConditionalCheckFailedException.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * If Exists is false, DynamoDB assumes that the attribute value does not
// exist in the table. If in fact the value does not exist, then the assumption
// is valid and the operation succeeds. If the value is found, despite the
// assumption that it does not exist, the operation fails with a ConditionalCheckFailedException.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The default setting for Exists is true. If you supply a Value all by itself,
// DynamoDB assumes the attribute exists: You don't have to set Exists to true,
// because it is implied.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// DynamoDB returns a ValidationException if:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Exists is true but there is no Value to check. (You expect a value to
// exist, but don't specify what that value is.)
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Exists is false but you also provide a Value. (You cannot expect an
// attribute to have a value, while also expecting it not to exist.)
Exists * bool ` type:"boolean" `
2017-01-23 22:22:31 +01:00
// Represents the data for the expected attribute.
//
// Each attribute value is described as a name-value pair. The name is the data
// type, and the value is the data itself.
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// For more information, see Data Types (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html#HowItWorks.DataTypes)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
Value * AttributeValue ` type:"structure" `
}
// String returns the string representation
func ( s ExpectedAttributeValue ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ExpectedAttributeValue ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetAttributeValueList sets the AttributeValueList field's value.
func ( s * ExpectedAttributeValue ) SetAttributeValueList ( v [ ] * AttributeValue ) * ExpectedAttributeValue {
s . AttributeValueList = v
return s
}
// SetComparisonOperator sets the ComparisonOperator field's value.
func ( s * ExpectedAttributeValue ) SetComparisonOperator ( v string ) * ExpectedAttributeValue {
s . ComparisonOperator = & v
return s
}
// SetExists sets the Exists field's value.
func ( s * ExpectedAttributeValue ) SetExists ( v bool ) * ExpectedAttributeValue {
s . Exists = & v
return s
}
// SetValue sets the Value field's value.
func ( s * ExpectedAttributeValue ) SetValue ( v * AttributeValue ) * ExpectedAttributeValue {
s . Value = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the input of a GetItem operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/GetItemInput
2016-01-29 20:53:56 +01:00
type GetItemInput struct {
_ struct { } ` type:"structure" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use ProjectionExpression instead. For more information,
// see AttributesToGet (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
AttributesToGet [ ] * string ` min:"1" type:"list" `
// Determines the read consistency model: If set to true, then the operation
// uses strongly consistent reads; otherwise, the operation uses eventually
// consistent reads.
ConsistentRead * bool ` type:"boolean" `
// One or more substitution tokens for attribute names in an expression. The
// following are some use cases for using ExpressionAttributeNames:
//
2016-11-19 19:41:01 +01:00
// * To access an attribute whose name conflicts with a DynamoDB reserved
// word.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * To create a placeholder for repeating occurrences of an attribute name
// in an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * To prevent special characters in an attribute name from being misinterpreted
// in an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Use the # character in an expression to dereference an attribute name. For
// example, consider the following attribute name:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Percentile
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The name of this attribute conflicts with a reserved word, so it cannot be
// used directly in an expression. (For the complete list of reserved words,
2016-01-29 20:53:56 +01:00
// see Reserved Words (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html)
// in the Amazon DynamoDB Developer Guide). To work around this, you could specify
// the following for ExpressionAttributeNames:
//
2016-11-19 19:41:01 +01:00
// * {"#P":"Percentile"}
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// You could then use this substitution in an expression, as in this example:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * #P = :val
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Tokens that begin with the : character are expression attribute values, which
// are placeholders for the actual value at runtime.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// For more information on expression attribute names, see Accessing Item Attributes
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
ExpressionAttributeNames map [ string ] * string ` type:"map" `
// A map of attribute names to AttributeValue objects, representing the primary
// key of the item to retrieve.
//
// For the primary key, you must provide all of the attributes. For example,
2016-03-11 01:27:37 +01:00
// with a simple primary key, you only need to provide a value for the partition
// key. For a composite primary key, you must provide values for both the partition
// key and the sort key.
2016-10-17 23:21:08 +02:00
//
// Key is a required field
2016-01-29 20:53:56 +01:00
Key map [ string ] * AttributeValue ` type:"map" required:"true" `
// A string that identifies one or more attributes to retrieve from the table.
// These attributes can include scalars, sets, or elements of a JSON document.
// The attributes in the expression must be separated by commas.
//
// If no attribute names are specified, then all attributes will be returned.
// If any of the requested attributes are not found, they will not appear in
// the result.
//
// For more information, see Accessing Item Attributes (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html)
// in the Amazon DynamoDB Developer Guide.
ProjectionExpression * string ` type:"string" `
// Determines the level of detail about provisioned throughput consumption that
// is returned in the response:
//
2016-11-19 19:41:01 +01:00
// * INDEXES - The response includes the aggregate ConsumedCapacity for the
// operation, together with ConsumedCapacity for each table and secondary
// index that was accessed.
2016-01-29 20:53:56 +01:00
//
// Note that some operations, such as GetItem and BatchGetItem, do not access
2016-11-19 19:41:01 +01:00
// any indexes at all. In these cases, specifying INDEXES will only return
// ConsumedCapacity information for table(s).
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * TOTAL - The response includes only the aggregate ConsumedCapacity for
// the operation.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * NONE - No ConsumedCapacity details are included in the response.
2016-01-29 20:53:56 +01:00
ReturnConsumedCapacity * string ` type:"string" enum:"ReturnConsumedCapacity" `
// The name of the table containing the requested item.
2016-10-17 23:21:08 +02:00
//
// TableName is a required field
2016-01-29 20:53:56 +01:00
TableName * string ` min:"3" type:"string" required:"true" `
}
// String returns the string representation
func ( s GetItemInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s GetItemInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * GetItemInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "GetItemInput" }
if s . AttributesToGet != nil && len ( s . AttributesToGet ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "AttributesToGet" , 1 ) )
}
if s . Key == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Key" ) )
}
if s . TableName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "TableName" ) )
}
if s . TableName != nil && len ( * s . TableName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "TableName" , 3 ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetAttributesToGet sets the AttributesToGet field's value.
func ( s * GetItemInput ) SetAttributesToGet ( v [ ] * string ) * GetItemInput {
s . AttributesToGet = v
return s
}
// SetConsistentRead sets the ConsistentRead field's value.
func ( s * GetItemInput ) SetConsistentRead ( v bool ) * GetItemInput {
s . ConsistentRead = & v
return s
}
// SetExpressionAttributeNames sets the ExpressionAttributeNames field's value.
func ( s * GetItemInput ) SetExpressionAttributeNames ( v map [ string ] * string ) * GetItemInput {
s . ExpressionAttributeNames = v
return s
}
// SetKey sets the Key field's value.
func ( s * GetItemInput ) SetKey ( v map [ string ] * AttributeValue ) * GetItemInput {
s . Key = v
return s
}
// SetProjectionExpression sets the ProjectionExpression field's value.
func ( s * GetItemInput ) SetProjectionExpression ( v string ) * GetItemInput {
s . ProjectionExpression = & v
return s
}
// SetReturnConsumedCapacity sets the ReturnConsumedCapacity field's value.
func ( s * GetItemInput ) SetReturnConsumedCapacity ( v string ) * GetItemInput {
s . ReturnConsumedCapacity = & v
return s
}
// SetTableName sets the TableName field's value.
func ( s * GetItemInput ) SetTableName ( v string ) * GetItemInput {
s . TableName = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the output of a GetItem operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/GetItemOutput
2016-01-29 20:53:56 +01:00
type GetItemOutput struct {
_ struct { } ` type:"structure" `
2017-01-23 22:22:31 +01:00
// The capacity units consumed by the GetItem operation. The data returned includes
// the total provisioned throughput consumed, along with statistics for the
// table and any indexes involved in the operation. ConsumedCapacity is only
// returned if the ReturnConsumedCapacity parameter was specified. For more
// information, see Provisioned Throughput (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
ConsumedCapacity * ConsumedCapacity ` type:"structure" `
2017-01-23 22:22:31 +01:00
// A map of attribute names to AttributeValue objects, as specified by ProjectionExpression.
2016-01-29 20:53:56 +01:00
Item map [ string ] * AttributeValue ` type:"map" `
}
// String returns the string representation
func ( s GetItemOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s GetItemOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetConsumedCapacity sets the ConsumedCapacity field's value.
func ( s * GetItemOutput ) SetConsumedCapacity ( v * ConsumedCapacity ) * GetItemOutput {
s . ConsumedCapacity = v
return s
}
// SetItem sets the Item field's value.
func ( s * GetItemOutput ) SetItem ( v map [ string ] * AttributeValue ) * GetItemOutput {
s . Item = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the properties of a global secondary index.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/GlobalSecondaryIndex
2016-01-29 20:53:56 +01:00
type GlobalSecondaryIndex struct {
_ struct { } ` type:"structure" `
// The name of the global secondary index. The name must be unique among all
// other indexes on this table.
2016-10-17 23:21:08 +02:00
//
// IndexName is a required field
2016-01-29 20:53:56 +01:00
IndexName * string ` min:"3" type:"string" required:"true" `
// The complete key schema for a global secondary index, which consists of one
2016-03-11 01:27:37 +01:00
// or more pairs of attribute names and key types:
//
2016-11-19 19:41:01 +01:00
// * HASH - partition key
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// * RANGE - sort key
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// The partition key of an item is also known as its hash attribute. The term
// "hash attribute" derives from DynamoDB' usage of an internal hash function
2016-03-11 01:27:37 +01:00
// to evenly distribute data items across partitions, based on their partition
// key values.
//
// The sort key of an item is also known as its range attribute. The term "range
// attribute" derives from the way DynamoDB stores items with the same partition
// key physically close together, in sorted order by the sort key value.
2016-10-17 23:21:08 +02:00
//
// KeySchema is a required field
2016-01-29 20:53:56 +01:00
KeySchema [ ] * KeySchemaElement ` min:"1" type:"list" required:"true" `
2017-01-23 22:22:31 +01:00
// Represents attributes that are copied (projected) from the table into the
// global secondary index. These are in addition to the primary key attributes
// and index key attributes, which are automatically projected.
2016-10-17 23:21:08 +02:00
//
// Projection is a required field
2016-01-29 20:53:56 +01:00
Projection * Projection ` type:"structure" required:"true" `
2017-01-23 22:22:31 +01:00
// Represents the provisioned throughput settings for the specified global secondary
// index.
2016-01-29 20:53:56 +01:00
//
// For current minimum and maximum provisioned throughput values, see Limits
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html)
// in the Amazon DynamoDB Developer Guide.
2016-10-17 23:21:08 +02:00
//
// ProvisionedThroughput is a required field
2016-01-29 20:53:56 +01:00
ProvisionedThroughput * ProvisionedThroughput ` type:"structure" required:"true" `
}
// String returns the string representation
func ( s GlobalSecondaryIndex ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s GlobalSecondaryIndex ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * GlobalSecondaryIndex ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "GlobalSecondaryIndex" }
if s . IndexName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "IndexName" ) )
}
if s . IndexName != nil && len ( * s . IndexName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "IndexName" , 3 ) )
}
if s . KeySchema == nil {
invalidParams . Add ( request . NewErrParamRequired ( "KeySchema" ) )
}
if s . KeySchema != nil && len ( s . KeySchema ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "KeySchema" , 1 ) )
}
if s . Projection == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Projection" ) )
}
if s . ProvisionedThroughput == nil {
invalidParams . Add ( request . NewErrParamRequired ( "ProvisionedThroughput" ) )
}
if s . KeySchema != nil {
for i , v := range s . KeySchema {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "KeySchema" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if s . Projection != nil {
if err := s . Projection . Validate ( ) ; err != nil {
invalidParams . AddNested ( "Projection" , err . ( request . ErrInvalidParams ) )
}
}
if s . ProvisionedThroughput != nil {
if err := s . ProvisionedThroughput . Validate ( ) ; err != nil {
invalidParams . AddNested ( "ProvisionedThroughput" , err . ( request . ErrInvalidParams ) )
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetIndexName sets the IndexName field's value.
func ( s * GlobalSecondaryIndex ) SetIndexName ( v string ) * GlobalSecondaryIndex {
s . IndexName = & v
return s
}
// SetKeySchema sets the KeySchema field's value.
func ( s * GlobalSecondaryIndex ) SetKeySchema ( v [ ] * KeySchemaElement ) * GlobalSecondaryIndex {
s . KeySchema = v
return s
}
// SetProjection sets the Projection field's value.
func ( s * GlobalSecondaryIndex ) SetProjection ( v * Projection ) * GlobalSecondaryIndex {
s . Projection = v
return s
}
// SetProvisionedThroughput sets the ProvisionedThroughput field's value.
func ( s * GlobalSecondaryIndex ) SetProvisionedThroughput ( v * ProvisionedThroughput ) * GlobalSecondaryIndex {
s . ProvisionedThroughput = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the properties of a global secondary index.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/GlobalSecondaryIndexDescription
2016-01-29 20:53:56 +01:00
type GlobalSecondaryIndexDescription struct {
_ struct { } ` type:"structure" `
// Indicates whether the index is currently backfilling. Backfilling is the
// process of reading items from the table and determining whether they can
2016-03-11 01:27:37 +01:00
// be added to the index. (Not all items will qualify: For example, a partition
// key cannot have any duplicate values.) If an item can be added to the index,
2016-01-29 20:53:56 +01:00
// DynamoDB will do so. After all items have been processed, the backfilling
// operation is complete and Backfilling is false.
//
2016-11-19 19:41:01 +01:00
// For indexes that were created during a CreateTable operation, the Backfilling
2016-01-29 20:53:56 +01:00
// attribute does not appear in the DescribeTable output.
Backfilling * bool ` type:"boolean" `
// The Amazon Resource Name (ARN) that uniquely identifies the index.
IndexArn * string ` type:"string" `
// The name of the global secondary index.
IndexName * string ` min:"3" type:"string" `
// The total size of the specified index, in bytes. DynamoDB updates this value
// approximately every six hours. Recent changes might not be reflected in this
// value.
IndexSizeBytes * int64 ` type:"long" `
// The current state of the global secondary index:
//
2016-11-19 19:41:01 +01:00
// * CREATING - The index is being created.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * UPDATING - The index is being updated.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * DELETING - The index is being deleted.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ACTIVE - The index is ready for use.
2016-01-29 20:53:56 +01:00
IndexStatus * string ` type:"string" enum:"IndexStatus" `
// The number of items in the specified index. DynamoDB updates this value approximately
// every six hours. Recent changes might not be reflected in this value.
ItemCount * int64 ` type:"long" `
2016-03-11 01:27:37 +01:00
// The complete key schema for a global secondary index, which consists of one
// or more pairs of attribute names and key types:
//
2016-11-19 19:41:01 +01:00
// * HASH - partition key
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// * RANGE - sort key
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// The partition key of an item is also known as its hash attribute. The term
// "hash attribute" derives from DynamoDB' usage of an internal hash function
2016-03-11 01:27:37 +01:00
// to evenly distribute data items across partitions, based on their partition
// key values.
//
// The sort key of an item is also known as its range attribute. The term "range
// attribute" derives from the way DynamoDB stores items with the same partition
// key physically close together, in sorted order by the sort key value.
2016-01-29 20:53:56 +01:00
KeySchema [ ] * KeySchemaElement ` min:"1" type:"list" `
2017-01-23 22:22:31 +01:00
// Represents attributes that are copied (projected) from the table into the
// global secondary index. These are in addition to the primary key attributes
// and index key attributes, which are automatically projected.
2016-01-29 20:53:56 +01:00
Projection * Projection ` type:"structure" `
2017-01-23 22:22:31 +01:00
// Represents the provisioned throughput settings for the specified global secondary
// index.
//
// For current minimum and maximum provisioned throughput values, see Limits
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
ProvisionedThroughput * ProvisionedThroughputDescription ` type:"structure" `
}
// String returns the string representation
func ( s GlobalSecondaryIndexDescription ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s GlobalSecondaryIndexDescription ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetBackfilling sets the Backfilling field's value.
func ( s * GlobalSecondaryIndexDescription ) SetBackfilling ( v bool ) * GlobalSecondaryIndexDescription {
s . Backfilling = & v
return s
}
// SetIndexArn sets the IndexArn field's value.
func ( s * GlobalSecondaryIndexDescription ) SetIndexArn ( v string ) * GlobalSecondaryIndexDescription {
s . IndexArn = & v
return s
}
// SetIndexName sets the IndexName field's value.
func ( s * GlobalSecondaryIndexDescription ) SetIndexName ( v string ) * GlobalSecondaryIndexDescription {
s . IndexName = & v
return s
}
// SetIndexSizeBytes sets the IndexSizeBytes field's value.
func ( s * GlobalSecondaryIndexDescription ) SetIndexSizeBytes ( v int64 ) * GlobalSecondaryIndexDescription {
s . IndexSizeBytes = & v
return s
}
// SetIndexStatus sets the IndexStatus field's value.
func ( s * GlobalSecondaryIndexDescription ) SetIndexStatus ( v string ) * GlobalSecondaryIndexDescription {
s . IndexStatus = & v
return s
}
// SetItemCount sets the ItemCount field's value.
func ( s * GlobalSecondaryIndexDescription ) SetItemCount ( v int64 ) * GlobalSecondaryIndexDescription {
s . ItemCount = & v
return s
}
// SetKeySchema sets the KeySchema field's value.
func ( s * GlobalSecondaryIndexDescription ) SetKeySchema ( v [ ] * KeySchemaElement ) * GlobalSecondaryIndexDescription {
s . KeySchema = v
return s
}
// SetProjection sets the Projection field's value.
func ( s * GlobalSecondaryIndexDescription ) SetProjection ( v * Projection ) * GlobalSecondaryIndexDescription {
s . Projection = v
return s
}
// SetProvisionedThroughput sets the ProvisionedThroughput field's value.
func ( s * GlobalSecondaryIndexDescription ) SetProvisionedThroughput ( v * ProvisionedThroughputDescription ) * GlobalSecondaryIndexDescription {
s . ProvisionedThroughput = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents one of the following:
//
2016-11-19 19:41:01 +01:00
// * A new global secondary index to be added to an existing table.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * New provisioned throughput parameters for an existing global secondary
// index.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * An existing global secondary index to be removed from an existing table.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/GlobalSecondaryIndexUpdate
2016-01-29 20:53:56 +01:00
type GlobalSecondaryIndexUpdate struct {
_ struct { } ` type:"structure" `
// The parameters required for creating a global secondary index on an existing
// table:
//
2016-11-19 19:41:01 +01:00
// * IndexName
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * KeySchema
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * AttributeDefinitions
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Projection
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ProvisionedThroughput
2016-01-29 20:53:56 +01:00
Create * CreateGlobalSecondaryIndexAction ` type:"structure" `
// The name of an existing global secondary index to be removed.
Delete * DeleteGlobalSecondaryIndexAction ` type:"structure" `
// The name of an existing global secondary index, along with new provisioned
// throughput settings to be applied to that index.
Update * UpdateGlobalSecondaryIndexAction ` type:"structure" `
}
// String returns the string representation
func ( s GlobalSecondaryIndexUpdate ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s GlobalSecondaryIndexUpdate ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * GlobalSecondaryIndexUpdate ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "GlobalSecondaryIndexUpdate" }
if s . Create != nil {
if err := s . Create . Validate ( ) ; err != nil {
invalidParams . AddNested ( "Create" , err . ( request . ErrInvalidParams ) )
}
}
if s . Delete != nil {
if err := s . Delete . Validate ( ) ; err != nil {
invalidParams . AddNested ( "Delete" , err . ( request . ErrInvalidParams ) )
}
}
if s . Update != nil {
if err := s . Update . Validate ( ) ; err != nil {
invalidParams . AddNested ( "Update" , err . ( request . ErrInvalidParams ) )
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetCreate sets the Create field's value.
func ( s * GlobalSecondaryIndexUpdate ) SetCreate ( v * CreateGlobalSecondaryIndexAction ) * GlobalSecondaryIndexUpdate {
s . Create = v
return s
}
// SetDelete sets the Delete field's value.
func ( s * GlobalSecondaryIndexUpdate ) SetDelete ( v * DeleteGlobalSecondaryIndexAction ) * GlobalSecondaryIndexUpdate {
s . Delete = v
return s
}
// SetUpdate sets the Update field's value.
func ( s * GlobalSecondaryIndexUpdate ) SetUpdate ( v * UpdateGlobalSecondaryIndexAction ) * GlobalSecondaryIndexUpdate {
s . Update = v
return s
}
2016-01-29 20:53:56 +01:00
// Information about item collections, if any, that were affected by the operation.
// ItemCollectionMetrics is only returned if the request asked for it. If the
// table does not have any local secondary indexes, this information is not
// returned in the response.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ItemCollectionMetrics
2016-01-29 20:53:56 +01:00
type ItemCollectionMetrics struct {
_ struct { } ` type:"structure" `
2016-03-11 01:27:37 +01:00
// The partition key value of the item collection. This value is the same as
// the partition key value of the item.
2016-01-29 20:53:56 +01:00
ItemCollectionKey map [ string ] * AttributeValue ` type:"map" `
// An estimate of item collection size, in gigabytes. This value is a two-element
// array containing a lower bound and an upper bound for the estimate. The estimate
// includes the size of all the items in the table, plus the size of all attributes
// projected into all of the local secondary indexes on that table. Use this
// estimate to measure whether a local secondary index is approaching its size
// limit.
//
// The estimate is subject to change over time; therefore, do not rely on the
// precision or accuracy of the estimate.
SizeEstimateRangeGB [ ] * float64 ` type:"list" `
}
// String returns the string representation
func ( s ItemCollectionMetrics ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ItemCollectionMetrics ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetItemCollectionKey sets the ItemCollectionKey field's value.
func ( s * ItemCollectionMetrics ) SetItemCollectionKey ( v map [ string ] * AttributeValue ) * ItemCollectionMetrics {
s . ItemCollectionKey = v
return s
}
// SetSizeEstimateRangeGB sets the SizeEstimateRangeGB field's value.
func ( s * ItemCollectionMetrics ) SetSizeEstimateRangeGB ( v [ ] * float64 ) * ItemCollectionMetrics {
s . SizeEstimateRangeGB = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents a single element of a key schema. A key schema specifies the attributes
// that make up the primary key of a table, or the key attributes of an index.
//
2016-11-19 19:41:01 +01:00
// A KeySchemaElement represents exactly one attribute of the primary key. For
// example, a simple primary key would be represented by one KeySchemaElement
2016-03-11 01:27:37 +01:00
// (for the partition key). A composite primary key would require one KeySchemaElement
// for the partition key, and another KeySchemaElement for the sort key.
//
// A KeySchemaElement must be a scalar, top-level attribute (not a nested attribute).
// The data type must be one of String, Number, or Binary. The attribute cannot
// be nested within a List or a Map.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/KeySchemaElement
2016-01-29 20:53:56 +01:00
type KeySchemaElement struct {
_ struct { } ` type:"structure" `
// The name of a key attribute.
2016-10-17 23:21:08 +02:00
//
// AttributeName is a required field
2016-01-29 20:53:56 +01:00
AttributeName * string ` min:"1" type:"string" required:"true" `
2016-03-11 01:27:37 +01:00
// The role that this key attribute will assume:
//
2016-11-19 19:41:01 +01:00
// * HASH - partition key
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// * RANGE - sort key
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// The partition key of an item is also known as its hash attribute. The term
// "hash attribute" derives from DynamoDB' usage of an internal hash function
2016-03-11 01:27:37 +01:00
// to evenly distribute data items across partitions, based on their partition
// key values.
//
// The sort key of an item is also known as its range attribute. The term "range
// attribute" derives from the way DynamoDB stores items with the same partition
// key physically close together, in sorted order by the sort key value.
2016-10-17 23:21:08 +02:00
//
// KeyType is a required field
2016-01-29 20:53:56 +01:00
KeyType * string ` type:"string" required:"true" enum:"KeyType" `
}
// String returns the string representation
func ( s KeySchemaElement ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s KeySchemaElement ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * KeySchemaElement ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "KeySchemaElement" }
if s . AttributeName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "AttributeName" ) )
}
if s . AttributeName != nil && len ( * s . AttributeName ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "AttributeName" , 1 ) )
}
if s . KeyType == nil {
invalidParams . Add ( request . NewErrParamRequired ( "KeyType" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetAttributeName sets the AttributeName field's value.
func ( s * KeySchemaElement ) SetAttributeName ( v string ) * KeySchemaElement {
s . AttributeName = & v
return s
}
// SetKeyType sets the KeyType field's value.
func ( s * KeySchemaElement ) SetKeyType ( v string ) * KeySchemaElement {
s . KeyType = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents a set of primary keys and, for each key, the attributes to retrieve
// from the table.
//
// For each primary key, you must provide all of the key attributes. For example,
2016-03-11 01:27:37 +01:00
// with a simple primary key, you only need to provide the partition key. For
// a composite primary key, you must provide both the partition key and the
// sort key.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/KeysAndAttributes
2016-01-29 20:53:56 +01:00
type KeysAndAttributes struct {
_ struct { } ` type:"structure" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use ProjectionExpression instead. For more information,
// see Legacy Conditional Parameters (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
AttributesToGet [ ] * string ` min:"1" type:"list" `
// The consistency of a read operation. If set to true, then a strongly consistent
// read is used; otherwise, an eventually consistent read is used.
ConsistentRead * bool ` type:"boolean" `
// One or more substitution tokens for attribute names in an expression. The
// following are some use cases for using ExpressionAttributeNames:
//
2016-11-19 19:41:01 +01:00
// * To access an attribute whose name conflicts with a DynamoDB reserved
// word.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * To create a placeholder for repeating occurrences of an attribute name
// in an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * To prevent special characters in an attribute name from being misinterpreted
// in an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Use the # character in an expression to dereference an attribute name. For
// example, consider the following attribute name:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Percentile
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The name of this attribute conflicts with a reserved word, so it cannot be
// used directly in an expression. (For the complete list of reserved words,
2016-01-29 20:53:56 +01:00
// see Reserved Words (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html)
// in the Amazon DynamoDB Developer Guide). To work around this, you could specify
// the following for ExpressionAttributeNames:
//
2016-11-19 19:41:01 +01:00
// * {"#P":"Percentile"}
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// You could then use this substitution in an expression, as in this example:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * #P = :val
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Tokens that begin with the : character are expression attribute values, which
// are placeholders for the actual value at runtime.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// For more information on expression attribute names, see Accessing Item Attributes
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
ExpressionAttributeNames map [ string ] * string ` type:"map" `
// The primary key attribute values that define the items and the attributes
// associated with the items.
2016-10-17 23:21:08 +02:00
//
// Keys is a required field
2016-01-29 20:53:56 +01:00
Keys [ ] map [ string ] * AttributeValue ` min:"1" type:"list" required:"true" `
// A string that identifies one or more attributes to retrieve from the table.
// These attributes can include scalars, sets, or elements of a JSON document.
// The attributes in the ProjectionExpression must be separated by commas.
//
// If no attribute names are specified, then all attributes will be returned.
// If any of the requested attributes are not found, they will not appear in
// the result.
//
// For more information, see Accessing Item Attributes (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html)
// in the Amazon DynamoDB Developer Guide.
ProjectionExpression * string ` type:"string" `
}
// String returns the string representation
func ( s KeysAndAttributes ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s KeysAndAttributes ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * KeysAndAttributes ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "KeysAndAttributes" }
if s . AttributesToGet != nil && len ( s . AttributesToGet ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "AttributesToGet" , 1 ) )
}
if s . Keys == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Keys" ) )
}
if s . Keys != nil && len ( s . Keys ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "Keys" , 1 ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetAttributesToGet sets the AttributesToGet field's value.
func ( s * KeysAndAttributes ) SetAttributesToGet ( v [ ] * string ) * KeysAndAttributes {
s . AttributesToGet = v
return s
}
// SetConsistentRead sets the ConsistentRead field's value.
func ( s * KeysAndAttributes ) SetConsistentRead ( v bool ) * KeysAndAttributes {
s . ConsistentRead = & v
return s
}
// SetExpressionAttributeNames sets the ExpressionAttributeNames field's value.
func ( s * KeysAndAttributes ) SetExpressionAttributeNames ( v map [ string ] * string ) * KeysAndAttributes {
s . ExpressionAttributeNames = v
return s
}
// SetKeys sets the Keys field's value.
func ( s * KeysAndAttributes ) SetKeys ( v [ ] map [ string ] * AttributeValue ) * KeysAndAttributes {
s . Keys = v
return s
}
// SetProjectionExpression sets the ProjectionExpression field's value.
func ( s * KeysAndAttributes ) SetProjectionExpression ( v string ) * KeysAndAttributes {
s . ProjectionExpression = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the input of a ListTables operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ListTablesInput
2016-01-29 20:53:56 +01:00
type ListTablesInput struct {
_ struct { } ` type:"structure" `
// The first table name that this operation will evaluate. Use the value that
// was returned for LastEvaluatedTableName in a previous operation, so that
// you can obtain the next page of results.
ExclusiveStartTableName * string ` min:"3" type:"string" `
// A maximum number of table names to return. If this parameter is not specified,
// the limit is 100.
Limit * int64 ` min:"1" type:"integer" `
}
// String returns the string representation
func ( s ListTablesInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ListTablesInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * ListTablesInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "ListTablesInput" }
if s . ExclusiveStartTableName != nil && len ( * s . ExclusiveStartTableName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "ExclusiveStartTableName" , 3 ) )
}
if s . Limit != nil && * s . Limit < 1 {
invalidParams . Add ( request . NewErrParamMinValue ( "Limit" , 1 ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetExclusiveStartTableName sets the ExclusiveStartTableName field's value.
func ( s * ListTablesInput ) SetExclusiveStartTableName ( v string ) * ListTablesInput {
s . ExclusiveStartTableName = & v
return s
}
// SetLimit sets the Limit field's value.
func ( s * ListTablesInput ) SetLimit ( v int64 ) * ListTablesInput {
s . Limit = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the output of a ListTables operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ListTablesOutput
2016-01-29 20:53:56 +01:00
type ListTablesOutput struct {
_ struct { } ` type:"structure" `
// The name of the last table in the current page of results. Use this value
// as the ExclusiveStartTableName in a new request to obtain the next page of
// results, until all the table names are returned.
//
// If you do not receive a LastEvaluatedTableName value in the response, this
// means that there are no more table names to be retrieved.
LastEvaluatedTableName * string ` min:"3" type:"string" `
// The names of the tables associated with the current account at the current
// endpoint. The maximum size of this array is 100.
//
// If LastEvaluatedTableName also appears in the output, you can use this value
// as the ExclusiveStartTableName parameter in a subsequent ListTables request
// and obtain the next page of results.
TableNames [ ] * string ` type:"list" `
}
// String returns the string representation
func ( s ListTablesOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ListTablesOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetLastEvaluatedTableName sets the LastEvaluatedTableName field's value.
func ( s * ListTablesOutput ) SetLastEvaluatedTableName ( v string ) * ListTablesOutput {
s . LastEvaluatedTableName = & v
return s
}
// SetTableNames sets the TableNames field's value.
func ( s * ListTablesOutput ) SetTableNames ( v [ ] * string ) * ListTablesOutput {
s . TableNames = v
return s
}
2017-01-23 22:22:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ListTagsOfResourceInput
type ListTagsOfResourceInput struct {
_ struct { } ` type:"structure" `
// An optional string that, if supplied, must be copied from the output of a
// previous call to ListTagOfResource. When provided in this manner, this API
// fetches the next page of results.
NextToken * string ` type:"string" `
// The Amazon DynamoDB resource with tags to be listed. This value is an Amazon
// Resource Name (ARN).
//
// ResourceArn is a required field
ResourceArn * string ` min:"1" type:"string" required:"true" `
}
// String returns the string representation
func ( s ListTagsOfResourceInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ListTagsOfResourceInput ) GoString ( ) string {
return s . String ( )
}
// Validate inspects the fields of the type to determine if they are valid.
func ( s * ListTagsOfResourceInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "ListTagsOfResourceInput" }
if s . ResourceArn == nil {
invalidParams . Add ( request . NewErrParamRequired ( "ResourceArn" ) )
}
if s . ResourceArn != nil && len ( * s . ResourceArn ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "ResourceArn" , 1 ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
// SetNextToken sets the NextToken field's value.
func ( s * ListTagsOfResourceInput ) SetNextToken ( v string ) * ListTagsOfResourceInput {
s . NextToken = & v
return s
}
// SetResourceArn sets the ResourceArn field's value.
func ( s * ListTagsOfResourceInput ) SetResourceArn ( v string ) * ListTagsOfResourceInput {
s . ResourceArn = & v
return s
}
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ListTagsOfResourceOutput
type ListTagsOfResourceOutput struct {
_ struct { } ` type:"structure" `
// If this value is returned, there are additional results to be displayed.
// To retrieve them, call ListTagsOfResource again, with NextToken set to this
// value.
NextToken * string ` type:"string" `
// The tags currently associated with the Amazon DynamoDB resource.
Tags [ ] * Tag ` type:"list" `
}
// String returns the string representation
func ( s ListTagsOfResourceOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ListTagsOfResourceOutput ) GoString ( ) string {
return s . String ( )
}
// SetNextToken sets the NextToken field's value.
func ( s * ListTagsOfResourceOutput ) SetNextToken ( v string ) * ListTagsOfResourceOutput {
s . NextToken = & v
return s
}
// SetTags sets the Tags field's value.
func ( s * ListTagsOfResourceOutput ) SetTags ( v [ ] * Tag ) * ListTagsOfResourceOutput {
s . Tags = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the properties of a local secondary index.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/LocalSecondaryIndex
2016-01-29 20:53:56 +01:00
type LocalSecondaryIndex struct {
_ struct { } ` type:"structure" `
// The name of the local secondary index. The name must be unique among all
// other indexes on this table.
2016-10-17 23:21:08 +02:00
//
// IndexName is a required field
2016-01-29 20:53:56 +01:00
IndexName * string ` min:"3" type:"string" required:"true" `
// The complete key schema for the local secondary index, consisting of one
2016-03-11 01:27:37 +01:00
// or more pairs of attribute names and key types:
//
2016-11-19 19:41:01 +01:00
// * HASH - partition key
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// * RANGE - sort key
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// The partition key of an item is also known as its hash attribute. The term
// "hash attribute" derives from DynamoDB' usage of an internal hash function
2016-03-11 01:27:37 +01:00
// to evenly distribute data items across partitions, based on their partition
// key values.
//
// The sort key of an item is also known as its range attribute. The term "range
// attribute" derives from the way DynamoDB stores items with the same partition
// key physically close together, in sorted order by the sort key value.
2016-10-17 23:21:08 +02:00
//
// KeySchema is a required field
2016-01-29 20:53:56 +01:00
KeySchema [ ] * KeySchemaElement ` min:"1" type:"list" required:"true" `
2017-01-23 22:22:31 +01:00
// Represents attributes that are copied (projected) from the table into the
// local secondary index. These are in addition to the primary key attributes
// and index key attributes, which are automatically projected.
2016-10-17 23:21:08 +02:00
//
// Projection is a required field
2016-01-29 20:53:56 +01:00
Projection * Projection ` type:"structure" required:"true" `
}
// String returns the string representation
func ( s LocalSecondaryIndex ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s LocalSecondaryIndex ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * LocalSecondaryIndex ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "LocalSecondaryIndex" }
if s . IndexName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "IndexName" ) )
}
if s . IndexName != nil && len ( * s . IndexName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "IndexName" , 3 ) )
}
if s . KeySchema == nil {
invalidParams . Add ( request . NewErrParamRequired ( "KeySchema" ) )
}
if s . KeySchema != nil && len ( s . KeySchema ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "KeySchema" , 1 ) )
}
if s . Projection == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Projection" ) )
}
if s . KeySchema != nil {
for i , v := range s . KeySchema {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "KeySchema" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if s . Projection != nil {
if err := s . Projection . Validate ( ) ; err != nil {
invalidParams . AddNested ( "Projection" , err . ( request . ErrInvalidParams ) )
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetIndexName sets the IndexName field's value.
func ( s * LocalSecondaryIndex ) SetIndexName ( v string ) * LocalSecondaryIndex {
s . IndexName = & v
return s
}
// SetKeySchema sets the KeySchema field's value.
func ( s * LocalSecondaryIndex ) SetKeySchema ( v [ ] * KeySchemaElement ) * LocalSecondaryIndex {
s . KeySchema = v
return s
}
// SetProjection sets the Projection field's value.
func ( s * LocalSecondaryIndex ) SetProjection ( v * Projection ) * LocalSecondaryIndex {
s . Projection = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the properties of a local secondary index.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/LocalSecondaryIndexDescription
2016-01-29 20:53:56 +01:00
type LocalSecondaryIndexDescription struct {
_ struct { } ` type:"structure" `
// The Amazon Resource Name (ARN) that uniquely identifies the index.
IndexArn * string ` type:"string" `
// Represents the name of the local secondary index.
IndexName * string ` min:"3" type:"string" `
// The total size of the specified index, in bytes. DynamoDB updates this value
// approximately every six hours. Recent changes might not be reflected in this
// value.
IndexSizeBytes * int64 ` type:"long" `
// The number of items in the specified index. DynamoDB updates this value approximately
// every six hours. Recent changes might not be reflected in this value.
ItemCount * int64 ` type:"long" `
2016-03-11 01:27:37 +01:00
// The complete key schema for the local secondary index, consisting of one
// or more pairs of attribute names and key types:
//
2016-11-19 19:41:01 +01:00
// * HASH - partition key
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// * RANGE - sort key
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// The partition key of an item is also known as its hash attribute. The term
// "hash attribute" derives from DynamoDB' usage of an internal hash function
2016-03-11 01:27:37 +01:00
// to evenly distribute data items across partitions, based on their partition
// key values.
//
// The sort key of an item is also known as its range attribute. The term "range
// attribute" derives from the way DynamoDB stores items with the same partition
// key physically close together, in sorted order by the sort key value.
2016-01-29 20:53:56 +01:00
KeySchema [ ] * KeySchemaElement ` min:"1" type:"list" `
2017-01-23 22:22:31 +01:00
// Represents attributes that are copied (projected) from the table into the
// global secondary index. These are in addition to the primary key attributes
// and index key attributes, which are automatically projected.
2016-01-29 20:53:56 +01:00
Projection * Projection ` type:"structure" `
}
// String returns the string representation
func ( s LocalSecondaryIndexDescription ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s LocalSecondaryIndexDescription ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetIndexArn sets the IndexArn field's value.
func ( s * LocalSecondaryIndexDescription ) SetIndexArn ( v string ) * LocalSecondaryIndexDescription {
s . IndexArn = & v
return s
}
// SetIndexName sets the IndexName field's value.
func ( s * LocalSecondaryIndexDescription ) SetIndexName ( v string ) * LocalSecondaryIndexDescription {
s . IndexName = & v
return s
}
// SetIndexSizeBytes sets the IndexSizeBytes field's value.
func ( s * LocalSecondaryIndexDescription ) SetIndexSizeBytes ( v int64 ) * LocalSecondaryIndexDescription {
s . IndexSizeBytes = & v
return s
}
// SetItemCount sets the ItemCount field's value.
func ( s * LocalSecondaryIndexDescription ) SetItemCount ( v int64 ) * LocalSecondaryIndexDescription {
s . ItemCount = & v
return s
}
// SetKeySchema sets the KeySchema field's value.
func ( s * LocalSecondaryIndexDescription ) SetKeySchema ( v [ ] * KeySchemaElement ) * LocalSecondaryIndexDescription {
s . KeySchema = v
return s
}
// SetProjection sets the Projection field's value.
func ( s * LocalSecondaryIndexDescription ) SetProjection ( v * Projection ) * LocalSecondaryIndexDescription {
s . Projection = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents attributes that are copied (projected) from the table into an
// index. These are in addition to the primary key attributes and index key
// attributes, which are automatically projected.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/Projection
2016-01-29 20:53:56 +01:00
type Projection struct {
_ struct { } ` type:"structure" `
// Represents the non-key attribute names which will be projected into the index.
//
2016-11-19 19:41:01 +01:00
// For local secondary indexes, the total count of NonKeyAttributes summed across
// all of the local secondary indexes, must not exceed 20. If you project the
// same attribute into two different indexes, this counts as two distinct attributes
// when determining the total.
2016-01-29 20:53:56 +01:00
NonKeyAttributes [ ] * string ` min:"1" type:"list" `
// The set of attributes that are projected into the index:
//
2016-11-19 19:41:01 +01:00
// * KEYS_ONLY - Only the index and primary keys are projected into the index.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * INCLUDE - Only the specified table attributes are projected into the
// index. The list of projected attributes are in NonKeyAttributes.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ALL - All of the table attributes are projected into the index.
2016-01-29 20:53:56 +01:00
ProjectionType * string ` type:"string" enum:"ProjectionType" `
}
// String returns the string representation
func ( s Projection ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s Projection ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * Projection ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "Projection" }
if s . NonKeyAttributes != nil && len ( s . NonKeyAttributes ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "NonKeyAttributes" , 1 ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetNonKeyAttributes sets the NonKeyAttributes field's value.
func ( s * Projection ) SetNonKeyAttributes ( v [ ] * string ) * Projection {
s . NonKeyAttributes = v
return s
}
// SetProjectionType sets the ProjectionType field's value.
func ( s * Projection ) SetProjectionType ( v string ) * Projection {
s . ProjectionType = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the provisioned throughput settings for a specified table or index.
// The settings can be modified using the UpdateTable operation.
//
// For current minimum and maximum provisioned throughput values, see Limits
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html)
// in the Amazon DynamoDB Developer Guide.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ProvisionedThroughput
2016-01-29 20:53:56 +01:00
type ProvisionedThroughput struct {
_ struct { } ` type:"structure" `
// The maximum number of strongly consistent reads consumed per second before
// DynamoDB returns a ThrottlingException. For more information, see Specifying
// Read and Write Requirements (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html#ProvisionedThroughput)
// in the Amazon DynamoDB Developer Guide.
2016-10-17 23:21:08 +02:00
//
// ReadCapacityUnits is a required field
2016-01-29 20:53:56 +01:00
ReadCapacityUnits * int64 ` min:"1" type:"long" required:"true" `
// The maximum number of writes consumed per second before DynamoDB returns
// a ThrottlingException. For more information, see Specifying Read and Write
// Requirements (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html#ProvisionedThroughput)
// in the Amazon DynamoDB Developer Guide.
2016-10-17 23:21:08 +02:00
//
// WriteCapacityUnits is a required field
2016-01-29 20:53:56 +01:00
WriteCapacityUnits * int64 ` min:"1" type:"long" required:"true" `
}
// String returns the string representation
func ( s ProvisionedThroughput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ProvisionedThroughput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * ProvisionedThroughput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "ProvisionedThroughput" }
if s . ReadCapacityUnits == nil {
invalidParams . Add ( request . NewErrParamRequired ( "ReadCapacityUnits" ) )
}
if s . ReadCapacityUnits != nil && * s . ReadCapacityUnits < 1 {
invalidParams . Add ( request . NewErrParamMinValue ( "ReadCapacityUnits" , 1 ) )
}
if s . WriteCapacityUnits == nil {
invalidParams . Add ( request . NewErrParamRequired ( "WriteCapacityUnits" ) )
}
if s . WriteCapacityUnits != nil && * s . WriteCapacityUnits < 1 {
invalidParams . Add ( request . NewErrParamMinValue ( "WriteCapacityUnits" , 1 ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetReadCapacityUnits sets the ReadCapacityUnits field's value.
func ( s * ProvisionedThroughput ) SetReadCapacityUnits ( v int64 ) * ProvisionedThroughput {
s . ReadCapacityUnits = & v
return s
}
// SetWriteCapacityUnits sets the WriteCapacityUnits field's value.
func ( s * ProvisionedThroughput ) SetWriteCapacityUnits ( v int64 ) * ProvisionedThroughput {
s . WriteCapacityUnits = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the provisioned throughput settings for the table, consisting
// of read and write capacity units, along with data about increases and decreases.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ProvisionedThroughputDescription
2016-01-29 20:53:56 +01:00
type ProvisionedThroughputDescription struct {
_ struct { } ` type:"structure" `
// The date and time of the last provisioned throughput decrease for this table.
LastDecreaseDateTime * time . Time ` type:"timestamp" timestampFormat:"unix" `
// The date and time of the last provisioned throughput increase for this table.
LastIncreaseDateTime * time . Time ` type:"timestamp" timestampFormat:"unix" `
// The number of provisioned throughput decreases for this table during this
// UTC calendar day. For current maximums on provisioned throughput decreases,
// see Limits (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html)
// in the Amazon DynamoDB Developer Guide.
NumberOfDecreasesToday * int64 ` min:"1" type:"long" `
// The maximum number of strongly consistent reads consumed per second before
// DynamoDB returns a ThrottlingException. Eventually consistent reads require
// less effort than strongly consistent reads, so a setting of 50 ReadCapacityUnits
// per second provides 100 eventually consistent ReadCapacityUnits per second.
ReadCapacityUnits * int64 ` min:"1" type:"long" `
// The maximum number of writes consumed per second before DynamoDB returns
// a ThrottlingException.
WriteCapacityUnits * int64 ` min:"1" type:"long" `
}
// String returns the string representation
func ( s ProvisionedThroughputDescription ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ProvisionedThroughputDescription ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetLastDecreaseDateTime sets the LastDecreaseDateTime field's value.
func ( s * ProvisionedThroughputDescription ) SetLastDecreaseDateTime ( v time . Time ) * ProvisionedThroughputDescription {
s . LastDecreaseDateTime = & v
return s
}
// SetLastIncreaseDateTime sets the LastIncreaseDateTime field's value.
func ( s * ProvisionedThroughputDescription ) SetLastIncreaseDateTime ( v time . Time ) * ProvisionedThroughputDescription {
s . LastIncreaseDateTime = & v
return s
}
// SetNumberOfDecreasesToday sets the NumberOfDecreasesToday field's value.
func ( s * ProvisionedThroughputDescription ) SetNumberOfDecreasesToday ( v int64 ) * ProvisionedThroughputDescription {
s . NumberOfDecreasesToday = & v
return s
}
// SetReadCapacityUnits sets the ReadCapacityUnits field's value.
func ( s * ProvisionedThroughputDescription ) SetReadCapacityUnits ( v int64 ) * ProvisionedThroughputDescription {
s . ReadCapacityUnits = & v
return s
}
// SetWriteCapacityUnits sets the WriteCapacityUnits field's value.
func ( s * ProvisionedThroughputDescription ) SetWriteCapacityUnits ( v int64 ) * ProvisionedThroughputDescription {
s . WriteCapacityUnits = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the input of a PutItem operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/PutItemInput
2016-01-29 20:53:56 +01:00
type PutItemInput struct {
_ struct { } ` type:"structure" `
// A condition that must be satisfied in order for a conditional PutItem operation
// to succeed.
//
// An expression can contain any of the following:
//
2016-11-19 19:41:01 +01:00
// * Functions: attribute_exists | attribute_not_exists | attribute_type
// | contains | begins_with | size
2016-01-29 20:53:56 +01:00
//
// These function names are case-sensitive.
//
2017-03-03 19:48:24 +01:00
// * Comparison operators: = | <> | < | > | <= | >= | BETWEEN | IN
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Logical operators: AND | OR | NOT
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// For more information on condition expressions, see Specifying Conditions
2016-01-29 20:53:56 +01:00
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html)
// in the Amazon DynamoDB Developer Guide.
ConditionExpression * string ` type:"string" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use ConditionExpression instead. For more information,
// see ConditionalOperator (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.ConditionalOperator.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
ConditionalOperator * string ` type:"string" enum:"ConditionalOperator" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use ConditionExpresssion instead. For more information,
// see Expected (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.Expected.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
Expected map [ string ] * ExpectedAttributeValue ` type:"map" `
// One or more substitution tokens for attribute names in an expression. The
// following are some use cases for using ExpressionAttributeNames:
//
2016-11-19 19:41:01 +01:00
// * To access an attribute whose name conflicts with a DynamoDB reserved
// word.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * To create a placeholder for repeating occurrences of an attribute name
// in an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * To prevent special characters in an attribute name from being misinterpreted
// in an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Use the # character in an expression to dereference an attribute name. For
// example, consider the following attribute name:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Percentile
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The name of this attribute conflicts with a reserved word, so it cannot be
// used directly in an expression. (For the complete list of reserved words,
2016-01-29 20:53:56 +01:00
// see Reserved Words (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html)
// in the Amazon DynamoDB Developer Guide). To work around this, you could specify
// the following for ExpressionAttributeNames:
//
2016-11-19 19:41:01 +01:00
// * {"#P":"Percentile"}
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// You could then use this substitution in an expression, as in this example:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * #P = :val
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Tokens that begin with the : character are expression attribute values, which
// are placeholders for the actual value at runtime.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// For more information on expression attribute names, see Accessing Item Attributes
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
ExpressionAttributeNames map [ string ] * string ` type:"map" `
// One or more values that can be substituted in an expression.
//
// Use the : (colon) character in an expression to dereference an attribute
// value. For example, suppose that you wanted to check whether the value of
// the ProductStatus attribute was one of the following:
//
2016-11-19 19:41:01 +01:00
// Available | Backordered | Discontinued
2016-01-29 20:53:56 +01:00
//
// You would first need to specify ExpressionAttributeValues as follows:
//
2016-11-19 19:41:01 +01:00
// { ":avail":{"S":"Available"}, ":back":{"S":"Backordered"}, ":disc":{"S":"Discontinued"}
2016-01-29 20:53:56 +01:00
// }
//
// You could then use these values in an expression, such as this:
//
2016-11-19 19:41:01 +01:00
// ProductStatus IN (:avail, :back, :disc)
2016-01-29 20:53:56 +01:00
//
// For more information on expression attribute values, see Specifying Conditions
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html)
// in the Amazon DynamoDB Developer Guide.
ExpressionAttributeValues map [ string ] * AttributeValue ` type:"map" `
// A map of attribute name/value pairs, one for each attribute. Only the primary
// key attributes are required; you can optionally provide other attribute name-value
// pairs for the item.
//
// You must provide all of the attributes for the primary key. For example,
2016-03-11 01:27:37 +01:00
// with a simple primary key, you only need to provide a value for the partition
// key. For a composite primary key, you must provide both values for both the
// partition key and the sort key.
2016-01-29 20:53:56 +01:00
//
// If you specify any attributes that are part of an index key, then the data
// types for those attributes must match those of the schema in the table's
// attribute definition.
//
// For more information about primary keys, see Primary Key (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DataModel.html#DataModelPrimaryKey)
// in the Amazon DynamoDB Developer Guide.
//
// Each element in the Item map is an AttributeValue object.
2016-10-17 23:21:08 +02:00
//
// Item is a required field
2016-01-29 20:53:56 +01:00
Item map [ string ] * AttributeValue ` type:"map" required:"true" `
// Determines the level of detail about provisioned throughput consumption that
// is returned in the response:
//
2016-11-19 19:41:01 +01:00
// * INDEXES - The response includes the aggregate ConsumedCapacity for the
// operation, together with ConsumedCapacity for each table and secondary
// index that was accessed.
2016-01-29 20:53:56 +01:00
//
// Note that some operations, such as GetItem and BatchGetItem, do not access
2016-11-19 19:41:01 +01:00
// any indexes at all. In these cases, specifying INDEXES will only return
// ConsumedCapacity information for table(s).
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * TOTAL - The response includes only the aggregate ConsumedCapacity for
// the operation.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * NONE - No ConsumedCapacity details are included in the response.
2016-01-29 20:53:56 +01:00
ReturnConsumedCapacity * string ` type:"string" enum:"ReturnConsumedCapacity" `
// Determines whether item collection metrics are returned. If set to SIZE,
// the response includes statistics about item collections, if any, that were
// modified during the operation are returned in the response. If set to NONE
// (the default), no statistics are returned.
ReturnItemCollectionMetrics * string ` type:"string" enum:"ReturnItemCollectionMetrics" `
// Use ReturnValues if you want to get the item attributes as they appeared
// before they were updated with the PutItem request. For PutItem, the valid
// values are:
//
2016-11-19 19:41:01 +01:00
// * NONE - If ReturnValues is not specified, or if its value is NONE, then
// nothing is returned. (This setting is the default for ReturnValues.)
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ALL_OLD - If PutItem overwrote an attribute name-value pair, then the
// content of the old item is returned.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// The ReturnValues parameter is used by several DynamoDB operations; however,
2016-07-15 15:49:02 +02:00
// PutItem does not recognize any values other than NONE or ALL_OLD.
2016-01-29 20:53:56 +01:00
ReturnValues * string ` type:"string" enum:"ReturnValue" `
// The name of the table to contain the item.
2016-10-17 23:21:08 +02:00
//
// TableName is a required field
2016-01-29 20:53:56 +01:00
TableName * string ` min:"3" type:"string" required:"true" `
}
// String returns the string representation
func ( s PutItemInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s PutItemInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * PutItemInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "PutItemInput" }
if s . Item == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Item" ) )
}
if s . TableName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "TableName" ) )
}
if s . TableName != nil && len ( * s . TableName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "TableName" , 3 ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetConditionExpression sets the ConditionExpression field's value.
func ( s * PutItemInput ) SetConditionExpression ( v string ) * PutItemInput {
s . ConditionExpression = & v
return s
}
// SetConditionalOperator sets the ConditionalOperator field's value.
func ( s * PutItemInput ) SetConditionalOperator ( v string ) * PutItemInput {
s . ConditionalOperator = & v
return s
}
// SetExpected sets the Expected field's value.
func ( s * PutItemInput ) SetExpected ( v map [ string ] * ExpectedAttributeValue ) * PutItemInput {
s . Expected = v
return s
}
// SetExpressionAttributeNames sets the ExpressionAttributeNames field's value.
func ( s * PutItemInput ) SetExpressionAttributeNames ( v map [ string ] * string ) * PutItemInput {
s . ExpressionAttributeNames = v
return s
}
// SetExpressionAttributeValues sets the ExpressionAttributeValues field's value.
func ( s * PutItemInput ) SetExpressionAttributeValues ( v map [ string ] * AttributeValue ) * PutItemInput {
s . ExpressionAttributeValues = v
return s
}
// SetItem sets the Item field's value.
func ( s * PutItemInput ) SetItem ( v map [ string ] * AttributeValue ) * PutItemInput {
s . Item = v
return s
}
// SetReturnConsumedCapacity sets the ReturnConsumedCapacity field's value.
func ( s * PutItemInput ) SetReturnConsumedCapacity ( v string ) * PutItemInput {
s . ReturnConsumedCapacity = & v
return s
}
// SetReturnItemCollectionMetrics sets the ReturnItemCollectionMetrics field's value.
func ( s * PutItemInput ) SetReturnItemCollectionMetrics ( v string ) * PutItemInput {
s . ReturnItemCollectionMetrics = & v
return s
}
// SetReturnValues sets the ReturnValues field's value.
func ( s * PutItemInput ) SetReturnValues ( v string ) * PutItemInput {
s . ReturnValues = & v
return s
}
// SetTableName sets the TableName field's value.
func ( s * PutItemInput ) SetTableName ( v string ) * PutItemInput {
s . TableName = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the output of a PutItem operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/PutItemOutput
2016-01-29 20:53:56 +01:00
type PutItemOutput struct {
_ struct { } ` type:"structure" `
// The attribute values as they appeared before the PutItem operation, but only
// if ReturnValues is specified as ALL_OLD in the request. Each element consists
// of an attribute name and an attribute value.
Attributes map [ string ] * AttributeValue ` type:"map" `
2017-01-23 22:22:31 +01:00
// The capacity units consumed by the PutItem operation. The data returned includes
// the total provisioned throughput consumed, along with statistics for the
// table and any indexes involved in the operation. ConsumedCapacity is only
// returned if the ReturnConsumedCapacity parameter was specified. For more
// information, see Provisioned Throughput (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
ConsumedCapacity * ConsumedCapacity ` type:"structure" `
2017-01-23 22:22:31 +01:00
// Information about item collections, if any, that were affected by the PutItem
// operation. ItemCollectionMetrics is only returned if the ReturnItemCollectionMetrics
// parameter was specified. If the table does not have any local secondary indexes,
// this information is not returned in the response.
2016-01-29 20:53:56 +01:00
//
// Each ItemCollectionMetrics element consists of:
//
2016-11-19 19:41:01 +01:00
// * ItemCollectionKey - The partition key value of the item collection.
// This is the same as the partition key value of the item itself.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * SizeEstimateRange - An estimate of item collection size, in gigabytes.
// This value is a two-element array containing a lower bound and an upper
// bound for the estimate. The estimate includes the size of all the items
// in the table, plus the size of all attributes projected into all of the
// local secondary indexes on that table. Use this estimate to measure whether
// a local secondary index is approaching its size limit.
2016-01-29 20:53:56 +01:00
//
// The estimate is subject to change over time; therefore, do not rely on the
2016-11-19 19:41:01 +01:00
// precision or accuracy of the estimate.
2016-01-29 20:53:56 +01:00
ItemCollectionMetrics * ItemCollectionMetrics ` type:"structure" `
}
// String returns the string representation
func ( s PutItemOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s PutItemOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetAttributes sets the Attributes field's value.
func ( s * PutItemOutput ) SetAttributes ( v map [ string ] * AttributeValue ) * PutItemOutput {
s . Attributes = v
return s
}
// SetConsumedCapacity sets the ConsumedCapacity field's value.
func ( s * PutItemOutput ) SetConsumedCapacity ( v * ConsumedCapacity ) * PutItemOutput {
s . ConsumedCapacity = v
return s
}
// SetItemCollectionMetrics sets the ItemCollectionMetrics field's value.
func ( s * PutItemOutput ) SetItemCollectionMetrics ( v * ItemCollectionMetrics ) * PutItemOutput {
s . ItemCollectionMetrics = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents a request to perform a PutItem operation on an item.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/PutRequest
2016-01-29 20:53:56 +01:00
type PutRequest struct {
_ struct { } ` type:"structure" `
// A map of attribute name to attribute values, representing the primary key
// of an item to be processed by PutItem. All of the table's primary key attributes
// must be specified, and their data types must match those of the table's key
// schema. If any attributes are present in the item which are part of an index
// key schema for the table, their types must match the index key schema.
2016-10-17 23:21:08 +02:00
//
// Item is a required field
2016-01-29 20:53:56 +01:00
Item map [ string ] * AttributeValue ` type:"map" required:"true" `
}
// String returns the string representation
func ( s PutRequest ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s PutRequest ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetItem sets the Item field's value.
func ( s * PutRequest ) SetItem ( v map [ string ] * AttributeValue ) * PutRequest {
s . Item = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the input of a Query operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/QueryInput
2016-01-29 20:53:56 +01:00
type QueryInput struct {
_ struct { } ` type:"structure" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use ProjectionExpression instead. For more information,
// see AttributesToGet (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
AttributesToGet [ ] * string ` min:"1" type:"list" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use FilterExpression instead. For more information,
// see ConditionalOperator (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.ConditionalOperator.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
ConditionalOperator * string ` type:"string" enum:"ConditionalOperator" `
// Determines the read consistency model: If set to true, then the operation
// uses strongly consistent reads; otherwise, the operation uses eventually
// consistent reads.
//
// Strongly consistent reads are not supported on global secondary indexes.
// If you query a global secondary index with ConsistentRead set to true, you
// will receive a ValidationException.
ConsistentRead * bool ` type:"boolean" `
// The primary key of the first item that this operation will evaluate. Use
// the value that was returned for LastEvaluatedKey in the previous operation.
//
// The data type for ExclusiveStartKey must be String, Number or Binary. No
// set data types are allowed.
ExclusiveStartKey map [ string ] * AttributeValue ` type:"map" `
// One or more substitution tokens for attribute names in an expression. The
// following are some use cases for using ExpressionAttributeNames:
//
2016-11-19 19:41:01 +01:00
// * To access an attribute whose name conflicts with a DynamoDB reserved
// word.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * To create a placeholder for repeating occurrences of an attribute name
// in an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * To prevent special characters in an attribute name from being misinterpreted
// in an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Use the # character in an expression to dereference an attribute name. For
// example, consider the following attribute name:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Percentile
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The name of this attribute conflicts with a reserved word, so it cannot be
// used directly in an expression. (For the complete list of reserved words,
2016-01-29 20:53:56 +01:00
// see Reserved Words (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html)
// in the Amazon DynamoDB Developer Guide). To work around this, you could specify
// the following for ExpressionAttributeNames:
//
2016-11-19 19:41:01 +01:00
// * {"#P":"Percentile"}
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// You could then use this substitution in an expression, as in this example:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * #P = :val
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Tokens that begin with the : character are expression attribute values, which
// are placeholders for the actual value at runtime.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// For more information on expression attribute names, see Accessing Item Attributes
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
ExpressionAttributeNames map [ string ] * string ` type:"map" `
// One or more values that can be substituted in an expression.
//
// Use the : (colon) character in an expression to dereference an attribute
// value. For example, suppose that you wanted to check whether the value of
// the ProductStatus attribute was one of the following:
//
2016-11-19 19:41:01 +01:00
// Available | Backordered | Discontinued
2016-01-29 20:53:56 +01:00
//
// You would first need to specify ExpressionAttributeValues as follows:
//
2016-11-19 19:41:01 +01:00
// { ":avail":{"S":"Available"}, ":back":{"S":"Backordered"}, ":disc":{"S":"Discontinued"}
2016-01-29 20:53:56 +01:00
// }
//
// You could then use these values in an expression, such as this:
//
2016-11-19 19:41:01 +01:00
// ProductStatus IN (:avail, :back, :disc)
2016-01-29 20:53:56 +01:00
//
// For more information on expression attribute values, see Specifying Conditions
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html)
// in the Amazon DynamoDB Developer Guide.
ExpressionAttributeValues map [ string ] * AttributeValue ` type:"map" `
// A string that contains conditions that DynamoDB applies after the Query operation,
// but before the data is returned to you. Items that do not satisfy the FilterExpression
// criteria are not returned.
//
2017-01-23 22:22:31 +01:00
// A FilterExpression does not allow key attributes. You cannot define a filter
// expression based on a partition key or a sort key.
//
2016-11-19 19:41:01 +01:00
// A FilterExpression is applied after the items have already been read; the
2016-01-29 20:53:56 +01:00
// process of filtering does not consume any additional read capacity units.
//
2016-11-19 19:41:01 +01:00
// For more information, see Filter Expressions (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
FilterExpression * string ` type:"string" `
// The name of an index to query. This index can be any local secondary index
// or global secondary index on the table. Note that if you use the IndexName
// parameter, you must also provide TableName.
IndexName * string ` min:"3" type:"string" `
// The condition that specifies the key value(s) for items to be retrieved by
// the Query action.
//
2016-03-11 01:27:37 +01:00
// The condition must perform an equality test on a single partition key value.
2016-01-29 20:53:56 +01:00
// The condition can also perform one of several comparison tests on a single
2016-03-11 01:27:37 +01:00
// sort key value. Query can use KeyConditionExpression to retrieve one item
// with a given partition key value and sort key value, or several items that
// have the same partition key value but different sort key values.
2016-01-29 20:53:56 +01:00
//
2016-03-11 01:27:37 +01:00
// The partition key equality test is required, and must be specified in the
// following format:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// partitionKeyName=:partitionkeyval
2016-01-29 20:53:56 +01:00
//
2016-03-11 01:27:37 +01:00
// If you also want to provide a condition for the sort key, it must be combined
// using AND with the condition for the sort key. Following is an example, using
// the = comparison operator for the sort key:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// partitionKeyName=:partitionkeyvalANDsortKeyName=:sortkeyval
2016-01-29 20:53:56 +01:00
//
2016-03-11 01:27:37 +01:00
// Valid comparisons for the sort key condition are as follows:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * sortKeyName=:sortkeyval - true if the sort key value is equal to :sortkeyval.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * sortKeyName<:sortkeyval - true if the sort key value is less than :sortkeyval.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * sortKeyName<=:sortkeyval - true if the sort key value is less than or
// equal to :sortkeyval.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * sortKeyName>:sortkeyval - true if the sort key value is greater than
// :sortkeyval.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * sortKeyName>= :sortkeyval - true if the sort key value is greater than
// or equal to :sortkeyval.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * sortKeyNameBETWEEN:sortkeyval1AND:sortkeyval2 - true if the sort key
// value is greater than or equal to :sortkeyval1, and less than or equal
// to :sortkeyval2.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * begins_with (sortKeyName, :sortkeyval) - true if the sort key value
// begins with a particular operand. (You cannot use this function with a
// sort key that is of type Number.) Note that the function name begins_with
// is case-sensitive.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Use the ExpressionAttributeValues parameter to replace tokens such as :partitionval
// and :sortval with actual values at runtime.
2016-01-29 20:53:56 +01:00
//
// You can optionally use the ExpressionAttributeNames parameter to replace
2016-03-11 01:27:37 +01:00
// the names of the partition key and sort key with placeholder tokens. This
2016-01-29 20:53:56 +01:00
// option might be necessary if an attribute name conflicts with a DynamoDB
// reserved word. For example, the following KeyConditionExpression parameter
// causes an error because Size is a reserved word:
//
2016-11-19 19:41:01 +01:00
// * Size = :myval
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// To work around this, define a placeholder (such a #S) to represent the attribute
// name Size. KeyConditionExpression then is as follows:
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * #S = :myval
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// For a list of reserved words, see Reserved Words (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
//
// For more information on ExpressionAttributeNames and ExpressionAttributeValues,
// see Using Placeholders for Attribute Names and Values (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ExpressionPlaceholders.html)
// in the Amazon DynamoDB Developer Guide.
KeyConditionExpression * string ` type:"string" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use KeyConditionExpression instead. For more
// information, see KeyConditions (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.KeyConditions.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
KeyConditions map [ string ] * Condition ` type:"map" `
// The maximum number of items to evaluate (not necessarily the number of matching
// items). If DynamoDB processes the number of items up to the limit while processing
// the results, it stops the operation and returns the matching values up to
// that point, and a key in LastEvaluatedKey to apply in a subsequent operation,
// so that you can pick up where you left off. Also, if the processed data set
// size exceeds 1 MB before DynamoDB reaches this limit, it stops the operation
// and returns the matching values up to the limit, and a key in LastEvaluatedKey
// to apply in a subsequent operation to continue the operation. For more information,
2016-07-15 15:49:02 +02:00
// see Query and Scan (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
Limit * int64 ` min:"1" type:"integer" `
// A string that identifies one or more attributes to retrieve from the table.
// These attributes can include scalars, sets, or elements of a JSON document.
// The attributes in the expression must be separated by commas.
//
// If no attribute names are specified, then all attributes will be returned.
// If any of the requested attributes are not found, they will not appear in
// the result.
//
// For more information, see Accessing Item Attributes (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html)
// in the Amazon DynamoDB Developer Guide.
ProjectionExpression * string ` type:"string" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use FilterExpression instead. For more information,
// see QueryFilter (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.QueryFilter.html)
// in the Amazon DynamoDB Developer Guide.
QueryFilter map [ string ] * Condition ` type:"map" `
// Determines the level of detail about provisioned throughput consumption that
// is returned in the response:
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// * INDEXES - The response includes the aggregate ConsumedCapacity for the
// operation, together with ConsumedCapacity for each table and secondary
// index that was accessed.
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// Note that some operations, such as GetItem and BatchGetItem, do not access
// any indexes at all. In these cases, specifying INDEXES will only return
// ConsumedCapacity information for table(s).
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// * TOTAL - The response includes only the aggregate ConsumedCapacity for
// the operation.
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// * NONE - No ConsumedCapacity details are included in the response.
ReturnConsumedCapacity * string ` type:"string" enum:"ReturnConsumedCapacity" `
// Specifies the order for index traversal: If true (default), the traversal
// is performed in ascending order; if false, the traversal is performed in
// descending order.
2016-01-29 20:53:56 +01:00
//
2016-03-11 01:27:37 +01:00
// Items with the same partition key value are stored in sorted order by sort
// key. If the sort key data type is Number, the results are stored in numeric
// order. For type String, the results are stored in order of ASCII character
// code values. For type Binary, DynamoDB treats each byte of the binary data
// as unsigned.
2016-01-29 20:53:56 +01:00
//
2016-03-11 01:27:37 +01:00
// If ScanIndexForward is true, DynamoDB returns the results in the order in
// which they are stored (by sort key value). This is the default behavior.
// If ScanIndexForward is false, DynamoDB reads the results in reverse order
// by sort key value, and then returns the results to the client.
2016-01-29 20:53:56 +01:00
ScanIndexForward * bool ` type:"boolean" `
// The attributes to be returned in the result. You can retrieve all item attributes,
// specific item attributes, the count of matching items, or in the case of
// an index, some or all of the attributes projected into the index.
//
2016-11-19 19:41:01 +01:00
// * ALL_ATTRIBUTES - Returns all of the item attributes from the specified
// table or index. If you query a local secondary index, then for each matching
// item in the index DynamoDB will fetch the entire item from the parent
// table. If the index is configured to project all item attributes, then
// all of the data can be obtained from the local secondary index, and no
// fetching is required.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ALL_PROJECTED_ATTRIBUTES - Allowed only when querying an index. Retrieves
// all attributes that have been projected into the index. If the index is
// configured to project all attributes, this return value is equivalent
// to specifying ALL_ATTRIBUTES.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * COUNT - Returns the number of matching items, rather than the matching
// items themselves.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * SPECIFIC_ATTRIBUTES - Returns only the attributes listed in AttributesToGet.
// This return value is equivalent to specifying AttributesToGet without
// specifying any value for Select.
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// If you query or scan a local secondary index and request only attributes
// that are projected into that index, the operation will read only the index
// and not the table. If any of the requested attributes are not projected
// into the local secondary index, DynamoDB will fetch each of these attributes
2016-11-19 19:41:01 +01:00
// from the parent table. This extra fetching incurs additional throughput
// cost and latency.
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// If you query or scan a global secondary index, you can only request attributes
// that are projected into the index. Global secondary index queries cannot
// fetch attributes from the parent table.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// If neither Select nor AttributesToGet are specified, DynamoDB defaults to
// ALL_ATTRIBUTES when accessing a table, and ALL_PROJECTED_ATTRIBUTES when
2016-01-29 20:53:56 +01:00
// accessing an index. You cannot use both Select and AttributesToGet together
// in a single request, unless the value for Select is SPECIFIC_ATTRIBUTES.
// (This usage is equivalent to specifying AttributesToGet without any value
// for Select.)
//
2016-11-19 19:41:01 +01:00
// If you use the ProjectionExpression parameter, then the value for Select
2016-01-29 20:53:56 +01:00
// can only be SPECIFIC_ATTRIBUTES. Any other value for Select will return an
// error.
Select * string ` type:"string" enum:"Select" `
// The name of the table containing the requested items.
2016-10-17 23:21:08 +02:00
//
// TableName is a required field
2016-01-29 20:53:56 +01:00
TableName * string ` min:"3" type:"string" required:"true" `
}
// String returns the string representation
func ( s QueryInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s QueryInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * QueryInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "QueryInput" }
if s . AttributesToGet != nil && len ( s . AttributesToGet ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "AttributesToGet" , 1 ) )
}
if s . IndexName != nil && len ( * s . IndexName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "IndexName" , 3 ) )
}
if s . Limit != nil && * s . Limit < 1 {
invalidParams . Add ( request . NewErrParamMinValue ( "Limit" , 1 ) )
}
if s . TableName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "TableName" ) )
}
if s . TableName != nil && len ( * s . TableName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "TableName" , 3 ) )
}
if s . KeyConditions != nil {
for i , v := range s . KeyConditions {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "KeyConditions" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if s . QueryFilter != nil {
for i , v := range s . QueryFilter {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "QueryFilter" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetAttributesToGet sets the AttributesToGet field's value.
func ( s * QueryInput ) SetAttributesToGet ( v [ ] * string ) * QueryInput {
s . AttributesToGet = v
return s
}
// SetConditionalOperator sets the ConditionalOperator field's value.
func ( s * QueryInput ) SetConditionalOperator ( v string ) * QueryInput {
s . ConditionalOperator = & v
return s
}
// SetConsistentRead sets the ConsistentRead field's value.
func ( s * QueryInput ) SetConsistentRead ( v bool ) * QueryInput {
s . ConsistentRead = & v
return s
}
// SetExclusiveStartKey sets the ExclusiveStartKey field's value.
func ( s * QueryInput ) SetExclusiveStartKey ( v map [ string ] * AttributeValue ) * QueryInput {
s . ExclusiveStartKey = v
return s
}
// SetExpressionAttributeNames sets the ExpressionAttributeNames field's value.
func ( s * QueryInput ) SetExpressionAttributeNames ( v map [ string ] * string ) * QueryInput {
s . ExpressionAttributeNames = v
return s
}
// SetExpressionAttributeValues sets the ExpressionAttributeValues field's value.
func ( s * QueryInput ) SetExpressionAttributeValues ( v map [ string ] * AttributeValue ) * QueryInput {
s . ExpressionAttributeValues = v
return s
}
// SetFilterExpression sets the FilterExpression field's value.
func ( s * QueryInput ) SetFilterExpression ( v string ) * QueryInput {
s . FilterExpression = & v
return s
}
// SetIndexName sets the IndexName field's value.
func ( s * QueryInput ) SetIndexName ( v string ) * QueryInput {
s . IndexName = & v
return s
}
// SetKeyConditionExpression sets the KeyConditionExpression field's value.
func ( s * QueryInput ) SetKeyConditionExpression ( v string ) * QueryInput {
s . KeyConditionExpression = & v
return s
}
// SetKeyConditions sets the KeyConditions field's value.
func ( s * QueryInput ) SetKeyConditions ( v map [ string ] * Condition ) * QueryInput {
s . KeyConditions = v
return s
}
// SetLimit sets the Limit field's value.
func ( s * QueryInput ) SetLimit ( v int64 ) * QueryInput {
s . Limit = & v
return s
}
// SetProjectionExpression sets the ProjectionExpression field's value.
func ( s * QueryInput ) SetProjectionExpression ( v string ) * QueryInput {
s . ProjectionExpression = & v
return s
}
// SetQueryFilter sets the QueryFilter field's value.
func ( s * QueryInput ) SetQueryFilter ( v map [ string ] * Condition ) * QueryInput {
s . QueryFilter = v
return s
}
// SetReturnConsumedCapacity sets the ReturnConsumedCapacity field's value.
func ( s * QueryInput ) SetReturnConsumedCapacity ( v string ) * QueryInput {
s . ReturnConsumedCapacity = & v
return s
}
// SetScanIndexForward sets the ScanIndexForward field's value.
func ( s * QueryInput ) SetScanIndexForward ( v bool ) * QueryInput {
s . ScanIndexForward = & v
return s
}
// SetSelect sets the Select field's value.
func ( s * QueryInput ) SetSelect ( v string ) * QueryInput {
s . Select = & v
return s
}
// SetTableName sets the TableName field's value.
func ( s * QueryInput ) SetTableName ( v string ) * QueryInput {
s . TableName = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the output of a Query operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/QueryOutput
2016-01-29 20:53:56 +01:00
type QueryOutput struct {
_ struct { } ` type:"structure" `
2017-01-23 22:22:31 +01:00
// The capacity units consumed by the Query operation. The data returned includes
// the total provisioned throughput consumed, along with statistics for the
// table and any indexes involved in the operation. ConsumedCapacity is only
// returned if the ReturnConsumedCapacity parameter was specified For more information,
// see Provisioned Throughput (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
ConsumedCapacity * ConsumedCapacity ` type:"structure" `
// The number of items in the response.
//
// If you used a QueryFilter in the request, then Count is the number of items
// returned after the filter was applied, and ScannedCount is the number of
2016-03-11 01:27:37 +01:00
// matching items before the filter was applied.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// If you did not use a filter in the request, then Count and ScannedCount are
// the same.
2016-01-29 20:53:56 +01:00
Count * int64 ` type:"integer" `
// An array of item attributes that match the query criteria. Each element in
// this array consists of an attribute name and the value for that attribute.
Items [ ] map [ string ] * AttributeValue ` type:"list" `
// The primary key of the item where the operation stopped, inclusive of the
// previous result set. Use this value to start a new operation, excluding this
// value in the new request.
//
// If LastEvaluatedKey is empty, then the "last page" of results has been processed
// and there is no more data to be retrieved.
//
// If LastEvaluatedKey is not empty, it does not necessarily mean that there
// is more data in the result set. The only way to know when you have reached
// the end of the result set is when LastEvaluatedKey is empty.
LastEvaluatedKey map [ string ] * AttributeValue ` type:"map" `
// The number of items evaluated, before any QueryFilter is applied. A high
// ScannedCount value with few, or no, Count results indicates an inefficient
// Query operation. For more information, see Count and ScannedCount (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Count)
// in the Amazon DynamoDB Developer Guide.
//
// If you did not use a filter in the request, then ScannedCount is the same
// as Count.
ScannedCount * int64 ` type:"integer" `
}
// String returns the string representation
func ( s QueryOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s QueryOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetConsumedCapacity sets the ConsumedCapacity field's value.
func ( s * QueryOutput ) SetConsumedCapacity ( v * ConsumedCapacity ) * QueryOutput {
s . ConsumedCapacity = v
return s
}
// SetCount sets the Count field's value.
func ( s * QueryOutput ) SetCount ( v int64 ) * QueryOutput {
s . Count = & v
return s
}
// SetItems sets the Items field's value.
func ( s * QueryOutput ) SetItems ( v [ ] map [ string ] * AttributeValue ) * QueryOutput {
s . Items = v
return s
}
// SetLastEvaluatedKey sets the LastEvaluatedKey field's value.
func ( s * QueryOutput ) SetLastEvaluatedKey ( v map [ string ] * AttributeValue ) * QueryOutput {
s . LastEvaluatedKey = v
return s
}
// SetScannedCount sets the ScannedCount field's value.
func ( s * QueryOutput ) SetScannedCount ( v int64 ) * QueryOutput {
s . ScannedCount = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the input of a Scan operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ScanInput
2016-01-29 20:53:56 +01:00
type ScanInput struct {
_ struct { } ` type:"structure" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use ProjectionExpression instead. For more information,
// see AttributesToGet (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
AttributesToGet [ ] * string ` min:"1" type:"list" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use FilterExpression instead. For more information,
// see ConditionalOperator (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.ConditionalOperator.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
ConditionalOperator * string ` type:"string" enum:"ConditionalOperator" `
// A Boolean value that determines the read consistency model during the scan:
//
2016-11-19 19:41:01 +01:00
// * If ConsistentRead is false, then the data returned from Scan might not
// contain the results from other recently completed write operations (PutItem,
// UpdateItem or DeleteItem).
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * If ConsistentRead is true, then all of the write operations that completed
// before the Scan began are guaranteed to be contained in the Scan response.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The default setting for ConsistentRead is false.
2016-01-29 20:53:56 +01:00
//
2016-03-11 01:27:37 +01:00
// The ConsistentRead parameter is not supported on global secondary indexes.
2016-01-29 20:53:56 +01:00
// If you scan a global secondary index with ConsistentRead set to true, you
// will receive a ValidationException.
ConsistentRead * bool ` type:"boolean" `
// The primary key of the first item that this operation will evaluate. Use
// the value that was returned for LastEvaluatedKey in the previous operation.
//
// The data type for ExclusiveStartKey must be String, Number or Binary. No
// set data types are allowed.
//
2016-11-19 19:41:01 +01:00
// In a parallel scan, a Scan request that includes ExclusiveStartKey must specify
// the same segment whose previous Scan returned the corresponding value of
// LastEvaluatedKey.
2016-01-29 20:53:56 +01:00
ExclusiveStartKey map [ string ] * AttributeValue ` type:"map" `
// One or more substitution tokens for attribute names in an expression. The
// following are some use cases for using ExpressionAttributeNames:
//
2016-11-19 19:41:01 +01:00
// * To access an attribute whose name conflicts with a DynamoDB reserved
// word.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * To create a placeholder for repeating occurrences of an attribute name
// in an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * To prevent special characters in an attribute name from being misinterpreted
// in an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Use the # character in an expression to dereference an attribute name. For
// example, consider the following attribute name:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Percentile
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The name of this attribute conflicts with a reserved word, so it cannot be
// used directly in an expression. (For the complete list of reserved words,
2016-01-29 20:53:56 +01:00
// see Reserved Words (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html)
// in the Amazon DynamoDB Developer Guide). To work around this, you could specify
// the following for ExpressionAttributeNames:
//
2016-11-19 19:41:01 +01:00
// * {"#P":"Percentile"}
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// You could then use this substitution in an expression, as in this example:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * #P = :val
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Tokens that begin with the : character are expression attribute values, which
// are placeholders for the actual value at runtime.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// For more information on expression attribute names, see Accessing Item Attributes
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
ExpressionAttributeNames map [ string ] * string ` type:"map" `
// One or more values that can be substituted in an expression.
//
// Use the : (colon) character in an expression to dereference an attribute
// value. For example, suppose that you wanted to check whether the value of
// the ProductStatus attribute was one of the following:
//
2016-11-19 19:41:01 +01:00
// Available | Backordered | Discontinued
2016-01-29 20:53:56 +01:00
//
// You would first need to specify ExpressionAttributeValues as follows:
//
2016-11-19 19:41:01 +01:00
// { ":avail":{"S":"Available"}, ":back":{"S":"Backordered"}, ":disc":{"S":"Discontinued"}
2016-01-29 20:53:56 +01:00
// }
//
// You could then use these values in an expression, such as this:
//
2016-11-19 19:41:01 +01:00
// ProductStatus IN (:avail, :back, :disc)
2016-01-29 20:53:56 +01:00
//
// For more information on expression attribute values, see Specifying Conditions
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html)
// in the Amazon DynamoDB Developer Guide.
ExpressionAttributeValues map [ string ] * AttributeValue ` type:"map" `
// A string that contains conditions that DynamoDB applies after the Scan operation,
// but before the data is returned to you. Items that do not satisfy the FilterExpression
// criteria are not returned.
//
2016-11-19 19:41:01 +01:00
// A FilterExpression is applied after the items have already been read; the
2016-01-29 20:53:56 +01:00
// process of filtering does not consume any additional read capacity units.
//
2016-11-19 19:41:01 +01:00
// For more information, see Filter Expressions (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
FilterExpression * string ` type:"string" `
// The name of a secondary index to scan. This index can be any local secondary
// index or global secondary index. Note that if you use the IndexName parameter,
// you must also provide TableName.
IndexName * string ` min:"3" type:"string" `
// The maximum number of items to evaluate (not necessarily the number of matching
// items). If DynamoDB processes the number of items up to the limit while processing
// the results, it stops the operation and returns the matching values up to
// that point, and a key in LastEvaluatedKey to apply in a subsequent operation,
// so that you can pick up where you left off. Also, if the processed data set
// size exceeds 1 MB before DynamoDB reaches this limit, it stops the operation
// and returns the matching values up to the limit, and a key in LastEvaluatedKey
// to apply in a subsequent operation to continue the operation. For more information,
2016-07-15 15:49:02 +02:00
// see Query and Scan (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
Limit * int64 ` min:"1" type:"integer" `
// A string that identifies one or more attributes to retrieve from the specified
// table or index. These attributes can include scalars, sets, or elements of
// a JSON document. The attributes in the expression must be separated by commas.
//
// If no attribute names are specified, then all attributes will be returned.
// If any of the requested attributes are not found, they will not appear in
// the result.
//
// For more information, see Accessing Item Attributes (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html)
// in the Amazon DynamoDB Developer Guide.
ProjectionExpression * string ` type:"string" `
// Determines the level of detail about provisioned throughput consumption that
// is returned in the response:
//
2016-11-19 19:41:01 +01:00
// * INDEXES - The response includes the aggregate ConsumedCapacity for the
// operation, together with ConsumedCapacity for each table and secondary
// index that was accessed.
2016-01-29 20:53:56 +01:00
//
// Note that some operations, such as GetItem and BatchGetItem, do not access
2016-11-19 19:41:01 +01:00
// any indexes at all. In these cases, specifying INDEXES will only return
// ConsumedCapacity information for table(s).
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * TOTAL - The response includes only the aggregate ConsumedCapacity for
// the operation.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * NONE - No ConsumedCapacity details are included in the response.
2016-01-29 20:53:56 +01:00
ReturnConsumedCapacity * string ` type:"string" enum:"ReturnConsumedCapacity" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use FilterExpression instead. For more information,
// see ScanFilter (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.ScanFilter.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
ScanFilter map [ string ] * Condition ` type:"map" `
// For a parallel Scan request, Segment identifies an individual segment to
// be scanned by an application worker.
//
// Segment IDs are zero-based, so the first segment is always 0. For example,
// if you want to use four application threads to scan a table or an index,
// then the first thread specifies a Segment value of 0, the second thread specifies
// 1, and so on.
//
// The value of LastEvaluatedKey returned from a parallel Scan request must
// be used as ExclusiveStartKey with the same segment ID in a subsequent Scan
// operation.
//
2016-11-19 19:41:01 +01:00
// The value for Segment must be greater than or equal to 0, and less than the
// value provided for TotalSegments.
2016-01-29 20:53:56 +01:00
//
// If you provide Segment, you must also provide TotalSegments.
Segment * int64 ` type:"integer" `
// The attributes to be returned in the result. You can retrieve all item attributes,
2017-01-23 22:22:31 +01:00
// specific item attributes, the count of matching items, or in the case of
// an index, some or all of the attributes projected into the index.
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// * ALL_ATTRIBUTES - Returns all of the item attributes from the specified
// table or index. If you query a local secondary index, then for each matching
// item in the index DynamoDB will fetch the entire item from the parent
// table. If the index is configured to project all item attributes, then
// all of the data can be obtained from the local secondary index, and no
// fetching is required.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * ALL_PROJECTED_ATTRIBUTES - Allowed only when querying an index. Retrieves
// all attributes that have been projected into the index. If the index is
// configured to project all attributes, this return value is equivalent
// to specifying ALL_ATTRIBUTES.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * COUNT - Returns the number of matching items, rather than the matching
// items themselves.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * SPECIFIC_ATTRIBUTES - Returns only the attributes listed in AttributesToGet.
// This return value is equivalent to specifying AttributesToGet without
// specifying any value for Select.
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// If you query or scan a local secondary index and request only attributes
// that are projected into that index, the operation will read only the index
// and not the table. If any of the requested attributes are not projected
// into the local secondary index, DynamoDB will fetch each of these attributes
// from the parent table. This extra fetching incurs additional throughput
// cost and latency.
//
// If you query or scan a global secondary index, you can only request attributes
// that are projected into the index. Global secondary index queries cannot
// fetch attributes from the parent table.
//
2016-11-19 19:41:01 +01:00
// If neither Select nor AttributesToGet are specified, DynamoDB defaults to
2017-01-23 22:22:31 +01:00
// ALL_ATTRIBUTES when accessing a table, and ALL_PROJECTED_ATTRIBUTES when
// accessing an index. You cannot use both Select and AttributesToGet together
// in a single request, unless the value for Select is SPECIFIC_ATTRIBUTES.
// (This usage is equivalent to specifying AttributesToGet without any value
// for Select.)
//
// If you use the ProjectionExpression parameter, then the value for Select
// can only be SPECIFIC_ATTRIBUTES. Any other value for Select will return an
// error.
2016-01-29 20:53:56 +01:00
Select * string ` type:"string" enum:"Select" `
// The name of the table containing the requested items; or, if you provide
// IndexName, the name of the table to which that index belongs.
2016-10-17 23:21:08 +02:00
//
// TableName is a required field
2016-01-29 20:53:56 +01:00
TableName * string ` min:"3" type:"string" required:"true" `
// For a parallel Scan request, TotalSegments represents the total number of
// segments into which the Scan operation will be divided. The value of TotalSegments
// corresponds to the number of application workers that will perform the parallel
// scan. For example, if you want to use four application threads to scan a
// table or an index, specify a TotalSegments value of 4.
//
// The value for TotalSegments must be greater than or equal to 1, and less
// than or equal to 1000000. If you specify a TotalSegments value of 1, the
// Scan operation will be sequential rather than parallel.
//
// If you specify TotalSegments, you must also specify Segment.
TotalSegments * int64 ` min:"1" type:"integer" `
}
// String returns the string representation
func ( s ScanInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ScanInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * ScanInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "ScanInput" }
if s . AttributesToGet != nil && len ( s . AttributesToGet ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "AttributesToGet" , 1 ) )
}
if s . IndexName != nil && len ( * s . IndexName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "IndexName" , 3 ) )
}
if s . Limit != nil && * s . Limit < 1 {
invalidParams . Add ( request . NewErrParamMinValue ( "Limit" , 1 ) )
}
if s . TableName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "TableName" ) )
}
if s . TableName != nil && len ( * s . TableName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "TableName" , 3 ) )
}
if s . TotalSegments != nil && * s . TotalSegments < 1 {
invalidParams . Add ( request . NewErrParamMinValue ( "TotalSegments" , 1 ) )
}
if s . ScanFilter != nil {
for i , v := range s . ScanFilter {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "ScanFilter" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetAttributesToGet sets the AttributesToGet field's value.
func ( s * ScanInput ) SetAttributesToGet ( v [ ] * string ) * ScanInput {
s . AttributesToGet = v
return s
}
// SetConditionalOperator sets the ConditionalOperator field's value.
func ( s * ScanInput ) SetConditionalOperator ( v string ) * ScanInput {
s . ConditionalOperator = & v
return s
}
// SetConsistentRead sets the ConsistentRead field's value.
func ( s * ScanInput ) SetConsistentRead ( v bool ) * ScanInput {
s . ConsistentRead = & v
return s
}
// SetExclusiveStartKey sets the ExclusiveStartKey field's value.
func ( s * ScanInput ) SetExclusiveStartKey ( v map [ string ] * AttributeValue ) * ScanInput {
s . ExclusiveStartKey = v
return s
}
// SetExpressionAttributeNames sets the ExpressionAttributeNames field's value.
func ( s * ScanInput ) SetExpressionAttributeNames ( v map [ string ] * string ) * ScanInput {
s . ExpressionAttributeNames = v
return s
}
// SetExpressionAttributeValues sets the ExpressionAttributeValues field's value.
func ( s * ScanInput ) SetExpressionAttributeValues ( v map [ string ] * AttributeValue ) * ScanInput {
s . ExpressionAttributeValues = v
return s
}
// SetFilterExpression sets the FilterExpression field's value.
func ( s * ScanInput ) SetFilterExpression ( v string ) * ScanInput {
s . FilterExpression = & v
return s
}
// SetIndexName sets the IndexName field's value.
func ( s * ScanInput ) SetIndexName ( v string ) * ScanInput {
s . IndexName = & v
return s
}
// SetLimit sets the Limit field's value.
func ( s * ScanInput ) SetLimit ( v int64 ) * ScanInput {
s . Limit = & v
return s
}
// SetProjectionExpression sets the ProjectionExpression field's value.
func ( s * ScanInput ) SetProjectionExpression ( v string ) * ScanInput {
s . ProjectionExpression = & v
return s
}
// SetReturnConsumedCapacity sets the ReturnConsumedCapacity field's value.
func ( s * ScanInput ) SetReturnConsumedCapacity ( v string ) * ScanInput {
s . ReturnConsumedCapacity = & v
return s
}
// SetScanFilter sets the ScanFilter field's value.
func ( s * ScanInput ) SetScanFilter ( v map [ string ] * Condition ) * ScanInput {
s . ScanFilter = v
return s
}
// SetSegment sets the Segment field's value.
func ( s * ScanInput ) SetSegment ( v int64 ) * ScanInput {
s . Segment = & v
return s
}
// SetSelect sets the Select field's value.
func ( s * ScanInput ) SetSelect ( v string ) * ScanInput {
s . Select = & v
return s
}
// SetTableName sets the TableName field's value.
func ( s * ScanInput ) SetTableName ( v string ) * ScanInput {
s . TableName = & v
return s
}
// SetTotalSegments sets the TotalSegments field's value.
func ( s * ScanInput ) SetTotalSegments ( v int64 ) * ScanInput {
s . TotalSegments = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the output of a Scan operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ScanOutput
2016-01-29 20:53:56 +01:00
type ScanOutput struct {
_ struct { } ` type:"structure" `
2017-01-23 22:22:31 +01:00
// The capacity units consumed by the Scan operation. The data returned includes
// the total provisioned throughput consumed, along with statistics for the
// table and any indexes involved in the operation. ConsumedCapacity is only
// returned if the ReturnConsumedCapacity parameter was specified. For more
// information, see Provisioned Throughput (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
ConsumedCapacity * ConsumedCapacity ` type:"structure" `
// The number of items in the response.
//
2016-11-19 19:41:01 +01:00
// If you set ScanFilter in the request, then Count is the number of items returned
// after the filter was applied, and ScannedCount is the number of matching
// items before the filter was applied.
2016-01-29 20:53:56 +01:00
//
// If you did not use a filter in the request, then Count is the same as ScannedCount.
Count * int64 ` type:"integer" `
// An array of item attributes that match the scan criteria. Each element in
// this array consists of an attribute name and the value for that attribute.
Items [ ] map [ string ] * AttributeValue ` type:"list" `
// The primary key of the item where the operation stopped, inclusive of the
// previous result set. Use this value to start a new operation, excluding this
// value in the new request.
//
// If LastEvaluatedKey is empty, then the "last page" of results has been processed
// and there is no more data to be retrieved.
//
// If LastEvaluatedKey is not empty, it does not necessarily mean that there
// is more data in the result set. The only way to know when you have reached
// the end of the result set is when LastEvaluatedKey is empty.
LastEvaluatedKey map [ string ] * AttributeValue ` type:"map" `
// The number of items evaluated, before any ScanFilter is applied. A high ScannedCount
// value with few, or no, Count results indicates an inefficient Scan operation.
// For more information, see Count and ScannedCount (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Count)
// in the Amazon DynamoDB Developer Guide.
//
// If you did not use a filter in the request, then ScannedCount is the same
// as Count.
ScannedCount * int64 ` type:"integer" `
}
// String returns the string representation
func ( s ScanOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ScanOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetConsumedCapacity sets the ConsumedCapacity field's value.
func ( s * ScanOutput ) SetConsumedCapacity ( v * ConsumedCapacity ) * ScanOutput {
s . ConsumedCapacity = v
return s
}
// SetCount sets the Count field's value.
func ( s * ScanOutput ) SetCount ( v int64 ) * ScanOutput {
s . Count = & v
return s
}
// SetItems sets the Items field's value.
func ( s * ScanOutput ) SetItems ( v [ ] map [ string ] * AttributeValue ) * ScanOutput {
s . Items = v
return s
}
// SetLastEvaluatedKey sets the LastEvaluatedKey field's value.
func ( s * ScanOutput ) SetLastEvaluatedKey ( v map [ string ] * AttributeValue ) * ScanOutput {
s . LastEvaluatedKey = v
return s
}
// SetScannedCount sets the ScannedCount field's value.
func ( s * ScanOutput ) SetScannedCount ( v int64 ) * ScanOutput {
s . ScannedCount = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the DynamoDB Streams configuration for a table in DynamoDB.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/StreamSpecification
2016-01-29 20:53:56 +01:00
type StreamSpecification struct {
_ struct { } ` type:"structure" `
// Indicates whether DynamoDB Streams is enabled (true) or disabled (false)
// on the table.
StreamEnabled * bool ` type:"boolean" `
2017-01-23 22:22:31 +01:00
// When an item in the table is modified, StreamViewType determines what information
// is written to the stream for this table. Valid values for StreamViewType
// are:
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// * KEYS_ONLY - Only the key attributes of the modified item are written
2016-11-19 19:41:01 +01:00
// to the stream.
2016-01-29 20:53:56 +01:00
//
2017-01-23 22:22:31 +01:00
// * NEW_IMAGE - The entire item, as it appears after it was modified, is
2016-11-19 19:41:01 +01:00
// written to the stream.
2017-01-23 22:22:31 +01:00
//
// * OLD_IMAGE - The entire item, as it appeared before it was modified,
// is written to the stream.
//
// * NEW_AND_OLD_IMAGES - Both the new and the old item images of the item
// are written to the stream.
2016-01-29 20:53:56 +01:00
StreamViewType * string ` type:"string" enum:"StreamViewType" `
}
// String returns the string representation
func ( s StreamSpecification ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s StreamSpecification ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetStreamEnabled sets the StreamEnabled field's value.
func ( s * StreamSpecification ) SetStreamEnabled ( v bool ) * StreamSpecification {
s . StreamEnabled = & v
return s
}
// SetStreamViewType sets the StreamViewType field's value.
func ( s * StreamSpecification ) SetStreamViewType ( v string ) * StreamSpecification {
s . StreamViewType = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the properties of a table.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/TableDescription
2016-01-29 20:53:56 +01:00
type TableDescription struct {
_ struct { } ` type:"structure" `
// An array of AttributeDefinition objects. Each of these objects describes
// one attribute in the table and index key schema.
//
// Each AttributeDefinition object in this array is composed of:
//
2016-11-19 19:41:01 +01:00
// * AttributeName - The name of the attribute.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * AttributeType - The data type for the attribute.
2016-01-29 20:53:56 +01:00
AttributeDefinitions [ ] * AttributeDefinition ` type:"list" `
// The date and time when the table was created, in UNIX epoch time (http://www.epochconverter.com/)
// format.
CreationDateTime * time . Time ` type:"timestamp" timestampFormat:"unix" `
// The global secondary indexes, if any, on the table. Each index is scoped
2016-03-11 01:27:37 +01:00
// to a given partition key value. Each element is composed of:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Backfilling - If true, then the index is currently in the backfilling
// phase. Backfilling occurs only when a new global secondary index is added
// to the table; it is the process by which DynamoDB populates the new index
// with data from the table. (This attribute does not appear for indexes
// that were created during a CreateTable operation.)
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * IndexName - The name of the global secondary index.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * IndexSizeBytes - The total size of the global secondary index, in bytes.
// DynamoDB updates this value approximately every six hours. Recent changes
// might not be reflected in this value.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * IndexStatus - The current status of the global secondary index:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// CREATING - The index is being created.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// UPDATING - The index is being updated.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// DELETING - The index is being deleted.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// ACTIVE - The index is ready for use.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ItemCount - The number of items in the global secondary index. DynamoDB
// updates this value approximately every six hours. Recent changes might
// not be reflected in this value.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * KeySchema - Specifies the complete index key schema. The attribute names
// in the key schema must be between 1 and 255 characters (inclusive). The
// key schema must begin with the same partition key as the table.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Projection - Specifies attributes that are copied (projected) from the
// table into the index. These are in addition to the primary key attributes
// and index key attributes, which are automatically projected. Each attribute
// specification is composed of:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// ProjectionType - One of the following:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// KEYS_ONLY - Only the index and primary keys are projected into the index.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// INCLUDE - Only the specified table attributes are projected into the index.
// The list of projected attributes are in NonKeyAttributes.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// ALL - All of the table attributes are projected into the index.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// NonKeyAttributes - A list of one or more non-key attribute names that are
// projected into the secondary index. The total count of attributes provided
// in NonKeyAttributes, summed across all of the secondary indexes, must
// not exceed 20. If you project the same attribute into two different indexes,
// this counts as two distinct attributes when determining the total.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ProvisionedThroughput - The provisioned throughput settings for the
// global secondary index, consisting of read and write capacity units, along
// with data about increases and decreases.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// If the table is in the DELETING state, no information about indexes will
2016-01-29 20:53:56 +01:00
// be returned.
GlobalSecondaryIndexes [ ] * GlobalSecondaryIndexDescription ` type:"list" `
// The number of items in the specified table. DynamoDB updates this value approximately
// every six hours. Recent changes might not be reflected in this value.
ItemCount * int64 ` type:"long" `
// The primary key structure for the table. Each KeySchemaElement consists of:
//
2016-11-19 19:41:01 +01:00
// * AttributeName - The name of the attribute.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * KeyType - The role of the attribute:
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// HASH - partition key
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// RANGE - sort key
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// The partition key of an item is also known as its hash attribute. The term
// "hash attribute" derives from DynamoDB' usage of an internal hash function
// to evenly distribute data items across partitions, based on their partition
// key values.
2016-03-11 01:27:37 +01:00
//
// The sort key of an item is also known as its range attribute. The term "range
2016-11-19 19:41:01 +01:00
// attribute" derives from the way DynamoDB stores items with the same partition
// key physically close together, in sorted order by the sort key value.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// For more information about primary keys, see Primary Key (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DataModel.html#DataModelPrimaryKey)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
KeySchema [ ] * KeySchemaElement ` min:"1" type:"list" `
// The Amazon Resource Name (ARN) that uniquely identifies the latest stream
// for this table.
LatestStreamArn * string ` min:"37" type:"string" `
// A timestamp, in ISO 8601 format, for this stream.
//
// Note that LatestStreamLabel is not a unique identifier for the stream, because
// it is possible that a stream from another table might have the same timestamp.
// However, the combination of the following three elements is guaranteed to
// be unique:
//
2016-11-19 19:41:01 +01:00
// * the AWS customer ID.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * the table name.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * the StreamLabel.
2016-01-29 20:53:56 +01:00
LatestStreamLabel * string ` type:"string" `
// Represents one or more local secondary indexes on the table. Each index is
2016-03-11 01:27:37 +01:00
// scoped to a given partition key value. Tables with one or more local secondary
2016-01-29 20:53:56 +01:00
// indexes are subject to an item collection size limit, where the amount of
// data within a given item collection cannot exceed 10 GB. Each element is
// composed of:
//
2016-11-19 19:41:01 +01:00
// * IndexName - The name of the local secondary index.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * KeySchema - Specifies the complete index key schema. The attribute names
// in the key schema must be between 1 and 255 characters (inclusive). The
// key schema must begin with the same partition key as the table.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Projection - Specifies attributes that are copied (projected) from the
// table into the index. These are in addition to the primary key attributes
// and index key attributes, which are automatically projected. Each attribute
// specification is composed of:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// ProjectionType - One of the following:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// KEYS_ONLY - Only the index and primary keys are projected into the index.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// INCLUDE - Only the specified table attributes are projected into the index.
// The list of projected attributes are in NonKeyAttributes.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// ALL - All of the table attributes are projected into the index.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// NonKeyAttributes - A list of one or more non-key attribute names that are
// projected into the secondary index. The total count of attributes provided
// in NonKeyAttributes, summed across all of the secondary indexes, must
// not exceed 20. If you project the same attribute into two different indexes,
// this counts as two distinct attributes when determining the total.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * IndexSizeBytes - Represents the total size of the index, in bytes. DynamoDB
// updates this value approximately every six hours. Recent changes might
// not be reflected in this value.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ItemCount - Represents the number of items in the index. DynamoDB updates
// this value approximately every six hours. Recent changes might not be
// reflected in this value.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// If the table is in the DELETING state, no information about indexes will
2016-01-29 20:53:56 +01:00
// be returned.
LocalSecondaryIndexes [ ] * LocalSecondaryIndexDescription ` type:"list" `
// The provisioned throughput settings for the table, consisting of read and
// write capacity units, along with data about increases and decreases.
ProvisionedThroughput * ProvisionedThroughputDescription ` type:"structure" `
// The current DynamoDB Streams configuration for the table.
StreamSpecification * StreamSpecification ` type:"structure" `
// The Amazon Resource Name (ARN) that uniquely identifies the table.
TableArn * string ` type:"string" `
// The name of the table.
TableName * string ` min:"3" type:"string" `
// The total size of the specified table, in bytes. DynamoDB updates this value
// approximately every six hours. Recent changes might not be reflected in this
// value.
TableSizeBytes * int64 ` type:"long" `
// The current state of the table:
//
2016-11-19 19:41:01 +01:00
// * CREATING - The table is being created.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * UPDATING - The table is being updated.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * DELETING - The table is being deleted.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ACTIVE - The table is ready for use.
2016-01-29 20:53:56 +01:00
TableStatus * string ` type:"string" enum:"TableStatus" `
}
// String returns the string representation
func ( s TableDescription ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s TableDescription ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetAttributeDefinitions sets the AttributeDefinitions field's value.
func ( s * TableDescription ) SetAttributeDefinitions ( v [ ] * AttributeDefinition ) * TableDescription {
s . AttributeDefinitions = v
return s
}
// SetCreationDateTime sets the CreationDateTime field's value.
func ( s * TableDescription ) SetCreationDateTime ( v time . Time ) * TableDescription {
s . CreationDateTime = & v
return s
}
// SetGlobalSecondaryIndexes sets the GlobalSecondaryIndexes field's value.
func ( s * TableDescription ) SetGlobalSecondaryIndexes ( v [ ] * GlobalSecondaryIndexDescription ) * TableDescription {
s . GlobalSecondaryIndexes = v
return s
}
// SetItemCount sets the ItemCount field's value.
func ( s * TableDescription ) SetItemCount ( v int64 ) * TableDescription {
s . ItemCount = & v
return s
}
// SetKeySchema sets the KeySchema field's value.
func ( s * TableDescription ) SetKeySchema ( v [ ] * KeySchemaElement ) * TableDescription {
s . KeySchema = v
return s
}
// SetLatestStreamArn sets the LatestStreamArn field's value.
func ( s * TableDescription ) SetLatestStreamArn ( v string ) * TableDescription {
s . LatestStreamArn = & v
return s
}
// SetLatestStreamLabel sets the LatestStreamLabel field's value.
func ( s * TableDescription ) SetLatestStreamLabel ( v string ) * TableDescription {
s . LatestStreamLabel = & v
return s
}
// SetLocalSecondaryIndexes sets the LocalSecondaryIndexes field's value.
func ( s * TableDescription ) SetLocalSecondaryIndexes ( v [ ] * LocalSecondaryIndexDescription ) * TableDescription {
s . LocalSecondaryIndexes = v
return s
}
// SetProvisionedThroughput sets the ProvisionedThroughput field's value.
func ( s * TableDescription ) SetProvisionedThroughput ( v * ProvisionedThroughputDescription ) * TableDescription {
s . ProvisionedThroughput = v
return s
}
// SetStreamSpecification sets the StreamSpecification field's value.
func ( s * TableDescription ) SetStreamSpecification ( v * StreamSpecification ) * TableDescription {
s . StreamSpecification = v
return s
}
// SetTableArn sets the TableArn field's value.
func ( s * TableDescription ) SetTableArn ( v string ) * TableDescription {
s . TableArn = & v
return s
}
// SetTableName sets the TableName field's value.
func ( s * TableDescription ) SetTableName ( v string ) * TableDescription {
s . TableName = & v
return s
}
// SetTableSizeBytes sets the TableSizeBytes field's value.
func ( s * TableDescription ) SetTableSizeBytes ( v int64 ) * TableDescription {
s . TableSizeBytes = & v
return s
}
// SetTableStatus sets the TableStatus field's value.
func ( s * TableDescription ) SetTableStatus ( v string ) * TableDescription {
s . TableStatus = & v
return s
}
2017-01-23 22:22:31 +01:00
// Describes a tag. A tag is a key-value pair. You can add up to 50 tags to
// a single DynamoDB table.
//
// AWS-assigned tag names and values are automatically assigned the aws: prefix,
// which the user cannot assign. AWS-assigned tag names do not count towards
// the tag limit of 50. User-assigned tag names have the prefix user: in the
// Cost Allocation Report. You cannot backdate the application of a tag.
//
// For an overview on tagging DynamoDB resources, see Tagging for DynamoDB (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.html)
// in the Amazon DynamoDB Developer Guide.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/Tag
type Tag struct {
_ struct { } ` type:"structure" `
// The key of the tag.Tag keys are case sensitive. Each DynamoDB table can only
// have up to one tag with the same key. If you try to add an existing tag (same
// key), the existing tag value will be updated to the new value.
//
// Key is a required field
Key * string ` min:"1" type:"string" required:"true" `
// The value of the tag. Tag values are case-sensitive and can be null.
//
// Value is a required field
Value * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s Tag ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s Tag ) GoString ( ) string {
return s . String ( )
}
// Validate inspects the fields of the type to determine if they are valid.
func ( s * Tag ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "Tag" }
if s . Key == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Key" ) )
}
if s . Key != nil && len ( * s . Key ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "Key" , 1 ) )
}
if s . Value == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Value" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
// SetKey sets the Key field's value.
func ( s * Tag ) SetKey ( v string ) * Tag {
s . Key = & v
return s
}
// SetValue sets the Value field's value.
func ( s * Tag ) SetValue ( v string ) * Tag {
s . Value = & v
return s
}
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/TagResourceInput
type TagResourceInput struct {
_ struct { } ` type:"structure" `
// Identifies the Amazon DynamoDB resource to which tags should be added. This
// value is an Amazon Resource Name (ARN).
//
// ResourceArn is a required field
ResourceArn * string ` min:"1" type:"string" required:"true" `
// The tags to be assigned to the Amazon DynamoDB resource.
//
// Tags is a required field
Tags [ ] * Tag ` type:"list" required:"true" `
}
// String returns the string representation
func ( s TagResourceInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s TagResourceInput ) GoString ( ) string {
return s . String ( )
}
// Validate inspects the fields of the type to determine if they are valid.
func ( s * TagResourceInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "TagResourceInput" }
if s . ResourceArn == nil {
invalidParams . Add ( request . NewErrParamRequired ( "ResourceArn" ) )
}
if s . ResourceArn != nil && len ( * s . ResourceArn ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "ResourceArn" , 1 ) )
}
if s . Tags == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Tags" ) )
}
if s . Tags != nil {
for i , v := range s . Tags {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "Tags" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
// SetResourceArn sets the ResourceArn field's value.
func ( s * TagResourceInput ) SetResourceArn ( v string ) * TagResourceInput {
s . ResourceArn = & v
return s
}
// SetTags sets the Tags field's value.
func ( s * TagResourceInput ) SetTags ( v [ ] * Tag ) * TagResourceInput {
s . Tags = v
return s
}
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/TagResourceOutput
type TagResourceOutput struct {
_ struct { } ` type:"structure" `
}
// String returns the string representation
func ( s TagResourceOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s TagResourceOutput ) GoString ( ) string {
return s . String ( )
}
2017-03-03 19:48:24 +01:00
// The description of the Time to Live (TTL) status on the specified table.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/TimeToLiveDescription
type TimeToLiveDescription struct {
_ struct { } ` type:"structure" `
// The name of the Time to Live attribute for items in the table.
AttributeName * string ` min:"1" type:"string" `
// The Time to Live status for the table.
TimeToLiveStatus * string ` type:"string" enum:"TimeToLiveStatus" `
}
// String returns the string representation
func ( s TimeToLiveDescription ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s TimeToLiveDescription ) GoString ( ) string {
return s . String ( )
}
// SetAttributeName sets the AttributeName field's value.
func ( s * TimeToLiveDescription ) SetAttributeName ( v string ) * TimeToLiveDescription {
s . AttributeName = & v
return s
}
// SetTimeToLiveStatus sets the TimeToLiveStatus field's value.
func ( s * TimeToLiveDescription ) SetTimeToLiveStatus ( v string ) * TimeToLiveDescription {
s . TimeToLiveStatus = & v
return s
}
// Represents the settings used to enable or disable Time to Live for the specified
// table.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/TimeToLiveSpecification
type TimeToLiveSpecification struct {
_ struct { } ` type:"structure" `
// The name of the Time to Live attribute used to store the expiration time
// for items in the table.
//
// AttributeName is a required field
AttributeName * string ` min:"1" type:"string" required:"true" `
// Indicates whether Time To Live is to be enabled (true) or disabled (false)
// on the table.
//
// Enabled is a required field
Enabled * bool ` type:"boolean" required:"true" `
}
// String returns the string representation
func ( s TimeToLiveSpecification ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s TimeToLiveSpecification ) GoString ( ) string {
return s . String ( )
}
// Validate inspects the fields of the type to determine if they are valid.
func ( s * TimeToLiveSpecification ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "TimeToLiveSpecification" }
if s . AttributeName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "AttributeName" ) )
}
if s . AttributeName != nil && len ( * s . AttributeName ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "AttributeName" , 1 ) )
}
if s . Enabled == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Enabled" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
// SetAttributeName sets the AttributeName field's value.
func ( s * TimeToLiveSpecification ) SetAttributeName ( v string ) * TimeToLiveSpecification {
s . AttributeName = & v
return s
}
// SetEnabled sets the Enabled field's value.
func ( s * TimeToLiveSpecification ) SetEnabled ( v bool ) * TimeToLiveSpecification {
s . Enabled = & v
return s
}
2017-01-23 22:22:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UntagResourceInput
type UntagResourceInput struct {
_ struct { } ` type:"structure" `
// The Amazon DyanamoDB resource the tags will be removed from. This value is
// an Amazon Resource Name (ARN).
//
// ResourceArn is a required field
ResourceArn * string ` min:"1" type:"string" required:"true" `
// A list of tag keys. Existing tags of the resource whose keys are members
// of this list will be removed from the Amazon DynamoDB resource.
//
// TagKeys is a required field
TagKeys [ ] * string ` type:"list" required:"true" `
}
// String returns the string representation
func ( s UntagResourceInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s UntagResourceInput ) GoString ( ) string {
return s . String ( )
}
// Validate inspects the fields of the type to determine if they are valid.
func ( s * UntagResourceInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "UntagResourceInput" }
if s . ResourceArn == nil {
invalidParams . Add ( request . NewErrParamRequired ( "ResourceArn" ) )
}
if s . ResourceArn != nil && len ( * s . ResourceArn ) < 1 {
invalidParams . Add ( request . NewErrParamMinLen ( "ResourceArn" , 1 ) )
}
if s . TagKeys == nil {
invalidParams . Add ( request . NewErrParamRequired ( "TagKeys" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
// SetResourceArn sets the ResourceArn field's value.
func ( s * UntagResourceInput ) SetResourceArn ( v string ) * UntagResourceInput {
s . ResourceArn = & v
return s
}
// SetTagKeys sets the TagKeys field's value.
func ( s * UntagResourceInput ) SetTagKeys ( v [ ] * string ) * UntagResourceInput {
s . TagKeys = v
return s
}
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UntagResourceOutput
type UntagResourceOutput struct {
_ struct { } ` type:"structure" `
}
// String returns the string representation
func ( s UntagResourceOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s UntagResourceOutput ) GoString ( ) string {
return s . String ( )
}
2016-01-29 20:53:56 +01:00
// Represents the new provisioned throughput settings to be applied to a global
// secondary index.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateGlobalSecondaryIndexAction
2016-01-29 20:53:56 +01:00
type UpdateGlobalSecondaryIndexAction struct {
_ struct { } ` type:"structure" `
// The name of the global secondary index to be updated.
2016-10-17 23:21:08 +02:00
//
// IndexName is a required field
2016-01-29 20:53:56 +01:00
IndexName * string ` min:"3" type:"string" required:"true" `
2017-01-23 22:22:31 +01:00
// Represents the provisioned throughput settings for the specified global secondary
// index.
2016-01-29 20:53:56 +01:00
//
// For current minimum and maximum provisioned throughput values, see Limits
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html)
// in the Amazon DynamoDB Developer Guide.
2016-10-17 23:21:08 +02:00
//
// ProvisionedThroughput is a required field
2016-01-29 20:53:56 +01:00
ProvisionedThroughput * ProvisionedThroughput ` type:"structure" required:"true" `
}
// String returns the string representation
func ( s UpdateGlobalSecondaryIndexAction ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s UpdateGlobalSecondaryIndexAction ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * UpdateGlobalSecondaryIndexAction ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "UpdateGlobalSecondaryIndexAction" }
if s . IndexName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "IndexName" ) )
}
if s . IndexName != nil && len ( * s . IndexName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "IndexName" , 3 ) )
}
if s . ProvisionedThroughput == nil {
invalidParams . Add ( request . NewErrParamRequired ( "ProvisionedThroughput" ) )
}
if s . ProvisionedThroughput != nil {
if err := s . ProvisionedThroughput . Validate ( ) ; err != nil {
invalidParams . AddNested ( "ProvisionedThroughput" , err . ( request . ErrInvalidParams ) )
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetIndexName sets the IndexName field's value.
func ( s * UpdateGlobalSecondaryIndexAction ) SetIndexName ( v string ) * UpdateGlobalSecondaryIndexAction {
s . IndexName = & v
return s
}
// SetProvisionedThroughput sets the ProvisionedThroughput field's value.
func ( s * UpdateGlobalSecondaryIndexAction ) SetProvisionedThroughput ( v * ProvisionedThroughput ) * UpdateGlobalSecondaryIndexAction {
s . ProvisionedThroughput = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the input of an UpdateItem operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateItemInput
2016-01-29 20:53:56 +01:00
type UpdateItemInput struct {
_ struct { } ` type:"structure" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use UpdateExpression instead. For more information,
// see AttributeUpdates (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributeUpdates.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
AttributeUpdates map [ string ] * AttributeValueUpdate ` type:"map" `
// A condition that must be satisfied in order for a conditional update to succeed.
//
// An expression can contain any of the following:
//
2016-11-19 19:41:01 +01:00
// * Functions: attribute_exists | attribute_not_exists | attribute_type
// | contains | begins_with | size
2016-01-29 20:53:56 +01:00
//
// These function names are case-sensitive.
//
2017-03-03 19:48:24 +01:00
// * Comparison operators: = | <> | < | > | <= | >= | BETWEEN | IN
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Logical operators: AND | OR | NOT
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// For more information on condition expressions, see Specifying Conditions
2016-01-29 20:53:56 +01:00
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html)
// in the Amazon DynamoDB Developer Guide.
ConditionExpression * string ` type:"string" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use ConditionExpression instead. For more information,
// see ConditionalOperator (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.ConditionalOperator.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
ConditionalOperator * string ` type:"string" enum:"ConditionalOperator" `
2017-01-23 22:22:31 +01:00
// This is a legacy parameter. Use ConditionExpresssion instead. For more information,
// see Expected (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.Expected.html)
// in the Amazon DynamoDB Developer Guide.
2016-01-29 20:53:56 +01:00
Expected map [ string ] * ExpectedAttributeValue ` type:"map" `
// One or more substitution tokens for attribute names in an expression. The
// following are some use cases for using ExpressionAttributeNames:
//
2016-11-19 19:41:01 +01:00
// * To access an attribute whose name conflicts with a DynamoDB reserved
// word.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * To create a placeholder for repeating occurrences of an attribute name
// in an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * To prevent special characters in an attribute name from being misinterpreted
// in an expression.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Use the # character in an expression to dereference an attribute name. For
// example, consider the following attribute name:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Percentile
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The name of this attribute conflicts with a reserved word, so it cannot be
// used directly in an expression. (For the complete list of reserved words,
2016-01-29 20:53:56 +01:00
// see Reserved Words (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html)
// in the Amazon DynamoDB Developer Guide). To work around this, you could specify
// the following for ExpressionAttributeNames:
//
2016-11-19 19:41:01 +01:00
// * {"#P":"Percentile"}
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// You could then use this substitution in an expression, as in this example:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * #P = :val
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Tokens that begin with the : character are expression attribute values, which
// are placeholders for the actual value at runtime.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// For more information on expression attribute names, see Accessing Item Attributes
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
ExpressionAttributeNames map [ string ] * string ` type:"map" `
// One or more values that can be substituted in an expression.
//
// Use the : (colon) character in an expression to dereference an attribute
// value. For example, suppose that you wanted to check whether the value of
// the ProductStatus attribute was one of the following:
//
2016-11-19 19:41:01 +01:00
// Available | Backordered | Discontinued
2016-01-29 20:53:56 +01:00
//
// You would first need to specify ExpressionAttributeValues as follows:
//
2016-11-19 19:41:01 +01:00
// { ":avail":{"S":"Available"}, ":back":{"S":"Backordered"}, ":disc":{"S":"Discontinued"}
2016-01-29 20:53:56 +01:00
// }
//
// You could then use these values in an expression, such as this:
//
2016-11-19 19:41:01 +01:00
// ProductStatus IN (:avail, :back, :disc)
2016-01-29 20:53:56 +01:00
//
// For more information on expression attribute values, see Specifying Conditions
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html)
// in the Amazon DynamoDB Developer Guide.
ExpressionAttributeValues map [ string ] * AttributeValue ` type:"map" `
// The primary key of the item to be updated. Each element consists of an attribute
// name and a value for that attribute.
//
// For the primary key, you must provide all of the attributes. For example,
2016-03-11 01:27:37 +01:00
// with a simple primary key, you only need to provide a value for the partition
// key. For a composite primary key, you must provide values for both the partition
// key and the sort key.
2016-10-17 23:21:08 +02:00
//
// Key is a required field
2016-01-29 20:53:56 +01:00
Key map [ string ] * AttributeValue ` type:"map" required:"true" `
// Determines the level of detail about provisioned throughput consumption that
// is returned in the response:
//
2016-11-19 19:41:01 +01:00
// * INDEXES - The response includes the aggregate ConsumedCapacity for the
// operation, together with ConsumedCapacity for each table and secondary
// index that was accessed.
2016-01-29 20:53:56 +01:00
//
// Note that some operations, such as GetItem and BatchGetItem, do not access
2016-11-19 19:41:01 +01:00
// any indexes at all. In these cases, specifying INDEXES will only return
// ConsumedCapacity information for table(s).
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * TOTAL - The response includes only the aggregate ConsumedCapacity for
// the operation.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * NONE - No ConsumedCapacity details are included in the response.
2016-01-29 20:53:56 +01:00
ReturnConsumedCapacity * string ` type:"string" enum:"ReturnConsumedCapacity" `
// Determines whether item collection metrics are returned. If set to SIZE,
// the response includes statistics about item collections, if any, that were
// modified during the operation are returned in the response. If set to NONE
// (the default), no statistics are returned.
ReturnItemCollectionMetrics * string ` type:"string" enum:"ReturnItemCollectionMetrics" `
// Use ReturnValues if you want to get the item attributes as they appeared
// either before or after they were updated. For UpdateItem, the valid values
// are:
//
2016-11-19 19:41:01 +01:00
// * NONE - If ReturnValues is not specified, or if its value is NONE, then
// nothing is returned. (This setting is the default for ReturnValues.)
2016-01-29 20:53:56 +01:00
//
2017-03-03 19:48:24 +01:00
// * ALL_OLD - Returns all of the attributes of the item, as they appeared
// before the UpdateItem operation.
2016-01-29 20:53:56 +01:00
//
2017-03-03 19:48:24 +01:00
// * UPDATED_OLD - Returns only the updated attributes, as they appeared
// before the UpdateItem operation.
2016-01-29 20:53:56 +01:00
//
2017-03-03 19:48:24 +01:00
// * ALL_NEW - Returns all of the attributes of the item, as they appear
// after the UpdateItem operation.
2016-01-29 20:53:56 +01:00
//
2017-03-03 19:48:24 +01:00
// * UPDATED_NEW - Returns only the updated attributes, as they appear after
// the UpdateItem operation.
2016-03-11 01:27:37 +01:00
//
2016-11-19 19:41:01 +01:00
// There is no additional cost associated with requesting a return value aside
// from the small network and processing overhead of receiving a larger response.
// No Read Capacity Units are consumed.
2016-03-11 01:27:37 +01:00
//
// Values returned are strongly consistent
2016-01-29 20:53:56 +01:00
ReturnValues * string ` type:"string" enum:"ReturnValue" `
// The name of the table containing the item to update.
2016-10-17 23:21:08 +02:00
//
// TableName is a required field
2016-01-29 20:53:56 +01:00
TableName * string ` min:"3" type:"string" required:"true" `
// An expression that defines one or more attributes to be updated, the action
// to be performed on them, and new value(s) for them.
//
// The following action values are available for UpdateExpression.
//
2016-11-19 19:41:01 +01:00
// * SET - Adds one or more attributes and values to an item. If any of these
// attribute already exist, they are replaced by the new values. You can
// also use SET to add or subtract from an attribute that is of type Number.
// For example: SET myNum = myNum + :val
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// SET supports the following functions:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// if_not_exists (path, operand) - if the item does not contain an attribute
// at the specified path, then if_not_exists evaluates to operand; otherwise,
// it evaluates to path. You can use this function to avoid overwriting an
// attribute that may already be present in the item.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// list_append (operand, operand) - evaluates to a list with a new element added
// to it. You can append the new element to the start or the end of the list
// by reversing the order of the operands.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// These function names are case-sensitive.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * REMOVE - Removes one or more attributes from an item.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * ADD - Adds the specified value to the item, if the attribute does not
// already exist. If the attribute does exist, then the behavior of ADD depends
// on the data type of the attribute:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// If the existing attribute is a number, and if Value is also a number, then
// Value is mathematically added to the existing attribute. If Value is a
// negative number, then it is subtracted from the existing attribute.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// If you use ADD to increment or decrement a number value for an item that
// doesn't exist before the update, DynamoDB uses 0 as the initial value.
2016-01-29 20:53:56 +01:00
//
// Similarly, if you use ADD for an existing item to increment or decrement
2016-11-19 19:41:01 +01:00
// an attribute value that doesn't exist before the update, DynamoDB uses
// 0 as the initial value. For example, suppose that the item you want to
// update doesn't have an attribute named itemcount, but you decide to ADD
// the number 3 to this attribute anyway. DynamoDB will create the itemcount
// attribute, set its initial value to 0, and finally add 3 to it. The result
// will be a new itemcount attribute in the item, with a value of 3.
//
// If the existing data type is a set and if Value is also a set, then Value
// is added to the existing set. For example, if the attribute value is the
// set [1,2], and the ADD action specified [3], then the final attribute
// value is [1,2,3]. An error occurs if an ADD action is specified for a
// set attribute and the attribute type specified does not match the existing
// set type.
2016-01-29 20:53:56 +01:00
//
// Both sets must have the same primitive data type. For example, if the existing
2016-11-19 19:41:01 +01:00
// data type is a set of strings, the Value must also be a set of strings.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The ADD action only supports Number and set data types. In addition, ADD
// can only be used on top-level attributes, not nested attributes.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * DELETE - Deletes an element from a set.
2016-01-29 20:53:56 +01:00
//
// If a set of values is specified, then those values are subtracted from the
2016-11-19 19:41:01 +01:00
// old set. For example, if the attribute value was the set [a,b,c] and the
// DELETE action specifies [a,c], then the final attribute value is [b].
// Specifying an empty set is an error.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The DELETE action only supports set data types. In addition, DELETE can only
// be used on top-level attributes, not nested attributes.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// You can have many actions in a single expression, such as the following:
2016-01-29 20:53:56 +01:00
// SET a=:value1, b=:value2 DELETE :value3, :value4, :value5
//
// For more information on update expressions, see Modifying Items and Attributes
// (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.Modifying.html)
// in the Amazon DynamoDB Developer Guide.
UpdateExpression * string ` type:"string" `
}
// String returns the string representation
func ( s UpdateItemInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s UpdateItemInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * UpdateItemInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "UpdateItemInput" }
if s . Key == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Key" ) )
}
if s . TableName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "TableName" ) )
}
if s . TableName != nil && len ( * s . TableName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "TableName" , 3 ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetAttributeUpdates sets the AttributeUpdates field's value.
func ( s * UpdateItemInput ) SetAttributeUpdates ( v map [ string ] * AttributeValueUpdate ) * UpdateItemInput {
s . AttributeUpdates = v
return s
}
// SetConditionExpression sets the ConditionExpression field's value.
func ( s * UpdateItemInput ) SetConditionExpression ( v string ) * UpdateItemInput {
s . ConditionExpression = & v
return s
}
// SetConditionalOperator sets the ConditionalOperator field's value.
func ( s * UpdateItemInput ) SetConditionalOperator ( v string ) * UpdateItemInput {
s . ConditionalOperator = & v
return s
}
// SetExpected sets the Expected field's value.
func ( s * UpdateItemInput ) SetExpected ( v map [ string ] * ExpectedAttributeValue ) * UpdateItemInput {
s . Expected = v
return s
}
// SetExpressionAttributeNames sets the ExpressionAttributeNames field's value.
func ( s * UpdateItemInput ) SetExpressionAttributeNames ( v map [ string ] * string ) * UpdateItemInput {
s . ExpressionAttributeNames = v
return s
}
// SetExpressionAttributeValues sets the ExpressionAttributeValues field's value.
func ( s * UpdateItemInput ) SetExpressionAttributeValues ( v map [ string ] * AttributeValue ) * UpdateItemInput {
s . ExpressionAttributeValues = v
return s
}
// SetKey sets the Key field's value.
func ( s * UpdateItemInput ) SetKey ( v map [ string ] * AttributeValue ) * UpdateItemInput {
s . Key = v
return s
}
// SetReturnConsumedCapacity sets the ReturnConsumedCapacity field's value.
func ( s * UpdateItemInput ) SetReturnConsumedCapacity ( v string ) * UpdateItemInput {
s . ReturnConsumedCapacity = & v
return s
}
// SetReturnItemCollectionMetrics sets the ReturnItemCollectionMetrics field's value.
func ( s * UpdateItemInput ) SetReturnItemCollectionMetrics ( v string ) * UpdateItemInput {
s . ReturnItemCollectionMetrics = & v
return s
}
// SetReturnValues sets the ReturnValues field's value.
func ( s * UpdateItemInput ) SetReturnValues ( v string ) * UpdateItemInput {
s . ReturnValues = & v
return s
}
// SetTableName sets the TableName field's value.
func ( s * UpdateItemInput ) SetTableName ( v string ) * UpdateItemInput {
s . TableName = & v
return s
}
// SetUpdateExpression sets the UpdateExpression field's value.
func ( s * UpdateItemInput ) SetUpdateExpression ( v string ) * UpdateItemInput {
s . UpdateExpression = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the output of an UpdateItem operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateItemOutput
2016-01-29 20:53:56 +01:00
type UpdateItemOutput struct {
_ struct { } ` type:"structure" `
// A map of attribute values as they appeared before the UpdateItem operation.
// This map only appears if ReturnValues was specified as something other than
// NONE in the request. Each element represents one attribute.
Attributes map [ string ] * AttributeValue ` type:"map" `
2017-01-23 22:22:31 +01:00
// The capacity units consumed by the UpdateItem operation. The data returned
// includes the total provisioned throughput consumed, along with statistics
// for the table and any indexes involved in the operation. ConsumedCapacity
// is only returned if the ReturnConsumedCapacity parameter was specified. For
// more information, see Provisioned Throughput (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
ConsumedCapacity * ConsumedCapacity ` type:"structure" `
2017-01-23 22:22:31 +01:00
// Information about item collections, if any, that were affected by the UpdateItem
// operation. ItemCollectionMetrics is only returned if the ReturnItemCollectionMetrics
// parameter was specified. If the table does not have any local secondary indexes,
// this information is not returned in the response.
//
// Each ItemCollectionMetrics element consists of:
//
// * ItemCollectionKey - The partition key value of the item collection.
// This is the same as the partition key value of the item itself.
//
// * SizeEstimateRange - An estimate of item collection size, in gigabytes.
// This value is a two-element array containing a lower bound and an upper
// bound for the estimate. The estimate includes the size of all the items
// in the table, plus the size of all attributes projected into all of the
// local secondary indexes on that table. Use this estimate to measure whether
// a local secondary index is approaching its size limit.
//
// The estimate is subject to change over time; therefore, do not rely on the
// precision or accuracy of the estimate.
2016-01-29 20:53:56 +01:00
ItemCollectionMetrics * ItemCollectionMetrics ` type:"structure" `
}
// String returns the string representation
func ( s UpdateItemOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s UpdateItemOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetAttributes sets the Attributes field's value.
func ( s * UpdateItemOutput ) SetAttributes ( v map [ string ] * AttributeValue ) * UpdateItemOutput {
s . Attributes = v
return s
}
// SetConsumedCapacity sets the ConsumedCapacity field's value.
func ( s * UpdateItemOutput ) SetConsumedCapacity ( v * ConsumedCapacity ) * UpdateItemOutput {
s . ConsumedCapacity = v
return s
}
// SetItemCollectionMetrics sets the ItemCollectionMetrics field's value.
func ( s * UpdateItemOutput ) SetItemCollectionMetrics ( v * ItemCollectionMetrics ) * UpdateItemOutput {
s . ItemCollectionMetrics = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the input of an UpdateTable operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateTableInput
2016-01-29 20:53:56 +01:00
type UpdateTableInput struct {
_ struct { } ` type:"structure" `
// An array of attributes that describe the key schema for the table and indexes.
// If you are adding a new global secondary index to the table, AttributeDefinitions
// must include the key element(s) of the new index.
AttributeDefinitions [ ] * AttributeDefinition ` type:"list" `
// An array of one or more global secondary indexes for the table. For each
// index in the array, you can request one action:
//
2016-11-19 19:41:01 +01:00
// * Create - add a new global secondary index to the table.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Update - modify the provisioned throughput settings of an existing global
// secondary index.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * Delete - remove a global secondary index from the table.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// For more information, see Managing Global Secondary Indexes (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GSI.OnlineOps.html)
2016-01-29 20:53:56 +01:00
// in the Amazon DynamoDB Developer Guide.
GlobalSecondaryIndexUpdates [ ] * GlobalSecondaryIndexUpdate ` type:"list" `
2017-01-23 22:22:31 +01:00
// The new provisioned throughput settings for the specified table or index.
2016-01-29 20:53:56 +01:00
ProvisionedThroughput * ProvisionedThroughput ` type:"structure" `
// Represents the DynamoDB Streams configuration for the table.
//
2016-11-19 19:41:01 +01:00
// You will receive a ResourceInUseException if you attempt to enable a stream
2016-01-29 20:53:56 +01:00
// on a table that already has a stream, or if you attempt to disable a stream
// on a table which does not have a stream.
StreamSpecification * StreamSpecification ` type:"structure" `
// The name of the table to be updated.
2016-10-17 23:21:08 +02:00
//
// TableName is a required field
2016-01-29 20:53:56 +01:00
TableName * string ` min:"3" type:"string" required:"true" `
}
// String returns the string representation
func ( s UpdateTableInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s UpdateTableInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * UpdateTableInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "UpdateTableInput" }
if s . TableName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "TableName" ) )
}
if s . TableName != nil && len ( * s . TableName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "TableName" , 3 ) )
}
if s . AttributeDefinitions != nil {
for i , v := range s . AttributeDefinitions {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "AttributeDefinitions" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if s . GlobalSecondaryIndexUpdates != nil {
for i , v := range s . GlobalSecondaryIndexUpdates {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "GlobalSecondaryIndexUpdates" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if s . ProvisionedThroughput != nil {
if err := s . ProvisionedThroughput . Validate ( ) ; err != nil {
invalidParams . AddNested ( "ProvisionedThroughput" , err . ( request . ErrInvalidParams ) )
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetAttributeDefinitions sets the AttributeDefinitions field's value.
func ( s * UpdateTableInput ) SetAttributeDefinitions ( v [ ] * AttributeDefinition ) * UpdateTableInput {
s . AttributeDefinitions = v
return s
}
// SetGlobalSecondaryIndexUpdates sets the GlobalSecondaryIndexUpdates field's value.
func ( s * UpdateTableInput ) SetGlobalSecondaryIndexUpdates ( v [ ] * GlobalSecondaryIndexUpdate ) * UpdateTableInput {
s . GlobalSecondaryIndexUpdates = v
return s
}
// SetProvisionedThroughput sets the ProvisionedThroughput field's value.
func ( s * UpdateTableInput ) SetProvisionedThroughput ( v * ProvisionedThroughput ) * UpdateTableInput {
s . ProvisionedThroughput = v
return s
}
// SetStreamSpecification sets the StreamSpecification field's value.
func ( s * UpdateTableInput ) SetStreamSpecification ( v * StreamSpecification ) * UpdateTableInput {
s . StreamSpecification = v
return s
}
// SetTableName sets the TableName field's value.
func ( s * UpdateTableInput ) SetTableName ( v string ) * UpdateTableInput {
s . TableName = & v
return s
}
2016-01-29 20:53:56 +01:00
// Represents the output of an UpdateTable operation.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateTableOutput
2016-01-29 20:53:56 +01:00
type UpdateTableOutput struct {
_ struct { } ` type:"structure" `
2017-01-23 22:22:31 +01:00
// Represents the properties of the table.
2016-01-29 20:53:56 +01:00
TableDescription * TableDescription ` type:"structure" `
}
// String returns the string representation
func ( s UpdateTableOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s UpdateTableOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetTableDescription sets the TableDescription field's value.
func ( s * UpdateTableOutput ) SetTableDescription ( v * TableDescription ) * UpdateTableOutput {
s . TableDescription = v
return s
}
2017-03-03 19:48:24 +01:00
// Represents the input of an UpdateTimeToLive operation.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateTimeToLiveInput
type UpdateTimeToLiveInput struct {
_ struct { } ` type:"structure" `
// The name of the table to be configured.
//
// TableName is a required field
TableName * string ` min:"3" type:"string" required:"true" `
// Represents the settings used to enable or disable Time to Live for the specified
// table.
//
// TimeToLiveSpecification is a required field
TimeToLiveSpecification * TimeToLiveSpecification ` type:"structure" required:"true" `
}
// String returns the string representation
func ( s UpdateTimeToLiveInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s UpdateTimeToLiveInput ) GoString ( ) string {
return s . String ( )
}
// Validate inspects the fields of the type to determine if they are valid.
func ( s * UpdateTimeToLiveInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "UpdateTimeToLiveInput" }
if s . TableName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "TableName" ) )
}
if s . TableName != nil && len ( * s . TableName ) < 3 {
invalidParams . Add ( request . NewErrParamMinLen ( "TableName" , 3 ) )
}
if s . TimeToLiveSpecification == nil {
invalidParams . Add ( request . NewErrParamRequired ( "TimeToLiveSpecification" ) )
}
if s . TimeToLiveSpecification != nil {
if err := s . TimeToLiveSpecification . Validate ( ) ; err != nil {
invalidParams . AddNested ( "TimeToLiveSpecification" , err . ( request . ErrInvalidParams ) )
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
// SetTableName sets the TableName field's value.
func ( s * UpdateTimeToLiveInput ) SetTableName ( v string ) * UpdateTimeToLiveInput {
s . TableName = & v
return s
}
// SetTimeToLiveSpecification sets the TimeToLiveSpecification field's value.
func ( s * UpdateTimeToLiveInput ) SetTimeToLiveSpecification ( v * TimeToLiveSpecification ) * UpdateTimeToLiveInput {
s . TimeToLiveSpecification = v
return s
}
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateTimeToLiveOutput
type UpdateTimeToLiveOutput struct {
_ struct { } ` type:"structure" `
// Represents the output of an UpdateTimeToLive operation.
TimeToLiveSpecification * TimeToLiveSpecification ` type:"structure" `
}
// String returns the string representation
func ( s UpdateTimeToLiveOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s UpdateTimeToLiveOutput ) GoString ( ) string {
return s . String ( )
}
// SetTimeToLiveSpecification sets the TimeToLiveSpecification field's value.
func ( s * UpdateTimeToLiveOutput ) SetTimeToLiveSpecification ( v * TimeToLiveSpecification ) * UpdateTimeToLiveOutput {
s . TimeToLiveSpecification = v
return s
}
2016-01-29 20:53:56 +01:00
// Represents an operation to perform - either DeleteItem or PutItem. You can
// only request one of these operations, not both, in a single WriteRequest.
// If you do need to perform both of these operations, you will need to provide
// two separate WriteRequest objects.
2017-01-02 21:35:31 +01:00
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/WriteRequest
2016-01-29 20:53:56 +01:00
type WriteRequest struct {
_ struct { } ` type:"structure" `
// A request to perform a DeleteItem operation.
DeleteRequest * DeleteRequest ` type:"structure" `
// A request to perform a PutItem operation.
PutRequest * PutRequest ` type:"structure" `
}
// String returns the string representation
func ( s WriteRequest ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s WriteRequest ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetDeleteRequest sets the DeleteRequest field's value.
func ( s * WriteRequest ) SetDeleteRequest ( v * DeleteRequest ) * WriteRequest {
s . DeleteRequest = v
return s
}
// SetPutRequest sets the PutRequest field's value.
func ( s * WriteRequest ) SetPutRequest ( v * PutRequest ) * WriteRequest {
s . PutRequest = v
return s
}
2016-01-29 20:53:56 +01:00
const (
2016-10-17 23:21:08 +02:00
// AttributeActionAdd is a AttributeAction enum value
2016-01-29 20:53:56 +01:00
AttributeActionAdd = "ADD"
2016-10-17 23:21:08 +02:00
// AttributeActionPut is a AttributeAction enum value
2016-01-29 20:53:56 +01:00
AttributeActionPut = "PUT"
2016-10-17 23:21:08 +02:00
// AttributeActionDelete is a AttributeAction enum value
2016-01-29 20:53:56 +01:00
AttributeActionDelete = "DELETE"
)
const (
2016-10-17 23:21:08 +02:00
// ComparisonOperatorEq is a ComparisonOperator enum value
2016-01-29 20:53:56 +01:00
ComparisonOperatorEq = "EQ"
2016-10-17 23:21:08 +02:00
// ComparisonOperatorNe is a ComparisonOperator enum value
2016-01-29 20:53:56 +01:00
ComparisonOperatorNe = "NE"
2016-10-17 23:21:08 +02:00
// ComparisonOperatorIn is a ComparisonOperator enum value
2016-01-29 20:53:56 +01:00
ComparisonOperatorIn = "IN"
2016-10-17 23:21:08 +02:00
// ComparisonOperatorLe is a ComparisonOperator enum value
2016-01-29 20:53:56 +01:00
ComparisonOperatorLe = "LE"
2016-10-17 23:21:08 +02:00
// ComparisonOperatorLt is a ComparisonOperator enum value
2016-01-29 20:53:56 +01:00
ComparisonOperatorLt = "LT"
2016-10-17 23:21:08 +02:00
// ComparisonOperatorGe is a ComparisonOperator enum value
2016-01-29 20:53:56 +01:00
ComparisonOperatorGe = "GE"
2016-10-17 23:21:08 +02:00
// ComparisonOperatorGt is a ComparisonOperator enum value
2016-01-29 20:53:56 +01:00
ComparisonOperatorGt = "GT"
2016-10-17 23:21:08 +02:00
// ComparisonOperatorBetween is a ComparisonOperator enum value
2016-01-29 20:53:56 +01:00
ComparisonOperatorBetween = "BETWEEN"
2016-10-17 23:21:08 +02:00
// ComparisonOperatorNotNull is a ComparisonOperator enum value
2016-01-29 20:53:56 +01:00
ComparisonOperatorNotNull = "NOT_NULL"
2016-10-17 23:21:08 +02:00
// ComparisonOperatorNull is a ComparisonOperator enum value
2016-01-29 20:53:56 +01:00
ComparisonOperatorNull = "NULL"
2016-10-17 23:21:08 +02:00
// ComparisonOperatorContains is a ComparisonOperator enum value
2016-01-29 20:53:56 +01:00
ComparisonOperatorContains = "CONTAINS"
2016-10-17 23:21:08 +02:00
// ComparisonOperatorNotContains is a ComparisonOperator enum value
2016-01-29 20:53:56 +01:00
ComparisonOperatorNotContains = "NOT_CONTAINS"
2016-10-17 23:21:08 +02:00
// ComparisonOperatorBeginsWith is a ComparisonOperator enum value
2016-01-29 20:53:56 +01:00
ComparisonOperatorBeginsWith = "BEGINS_WITH"
)
const (
2016-10-17 23:21:08 +02:00
// ConditionalOperatorAnd is a ConditionalOperator enum value
2016-01-29 20:53:56 +01:00
ConditionalOperatorAnd = "AND"
2016-10-17 23:21:08 +02:00
// ConditionalOperatorOr is a ConditionalOperator enum value
2016-01-29 20:53:56 +01:00
ConditionalOperatorOr = "OR"
)
const (
2016-10-17 23:21:08 +02:00
// IndexStatusCreating is a IndexStatus enum value
2016-01-29 20:53:56 +01:00
IndexStatusCreating = "CREATING"
2016-10-17 23:21:08 +02:00
// IndexStatusUpdating is a IndexStatus enum value
2016-01-29 20:53:56 +01:00
IndexStatusUpdating = "UPDATING"
2016-10-17 23:21:08 +02:00
// IndexStatusDeleting is a IndexStatus enum value
2016-01-29 20:53:56 +01:00
IndexStatusDeleting = "DELETING"
2016-10-17 23:21:08 +02:00
// IndexStatusActive is a IndexStatus enum value
2016-01-29 20:53:56 +01:00
IndexStatusActive = "ACTIVE"
)
const (
2016-10-17 23:21:08 +02:00
// KeyTypeHash is a KeyType enum value
2016-01-29 20:53:56 +01:00
KeyTypeHash = "HASH"
2016-10-17 23:21:08 +02:00
// KeyTypeRange is a KeyType enum value
2016-01-29 20:53:56 +01:00
KeyTypeRange = "RANGE"
)
const (
2016-10-17 23:21:08 +02:00
// ProjectionTypeAll is a ProjectionType enum value
2016-01-29 20:53:56 +01:00
ProjectionTypeAll = "ALL"
2016-10-17 23:21:08 +02:00
// ProjectionTypeKeysOnly is a ProjectionType enum value
2016-01-29 20:53:56 +01:00
ProjectionTypeKeysOnly = "KEYS_ONLY"
2016-10-17 23:21:08 +02:00
// ProjectionTypeInclude is a ProjectionType enum value
2016-01-29 20:53:56 +01:00
ProjectionTypeInclude = "INCLUDE"
)
// Determines the level of detail about provisioned throughput consumption that
// is returned in the response:
//
2016-11-19 19:41:01 +01:00
// * INDEXES - The response includes the aggregate ConsumedCapacity for the
// operation, together with ConsumedCapacity for each table and secondary
// index that was accessed.
2016-01-29 20:53:56 +01:00
//
// Note that some operations, such as GetItem and BatchGetItem, do not access
2016-11-19 19:41:01 +01:00
// any indexes at all. In these cases, specifying INDEXES will only return
// ConsumedCapacity information for table(s).
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * TOTAL - The response includes only the aggregate ConsumedCapacity for
// the operation.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * NONE - No ConsumedCapacity details are included in the response.
2016-01-29 20:53:56 +01:00
const (
2016-10-17 23:21:08 +02:00
// ReturnConsumedCapacityIndexes is a ReturnConsumedCapacity enum value
2016-01-29 20:53:56 +01:00
ReturnConsumedCapacityIndexes = "INDEXES"
2016-10-17 23:21:08 +02:00
// ReturnConsumedCapacityTotal is a ReturnConsumedCapacity enum value
2016-01-29 20:53:56 +01:00
ReturnConsumedCapacityTotal = "TOTAL"
2016-10-17 23:21:08 +02:00
// ReturnConsumedCapacityNone is a ReturnConsumedCapacity enum value
2016-01-29 20:53:56 +01:00
ReturnConsumedCapacityNone = "NONE"
)
const (
2016-10-17 23:21:08 +02:00
// ReturnItemCollectionMetricsSize is a ReturnItemCollectionMetrics enum value
2016-01-29 20:53:56 +01:00
ReturnItemCollectionMetricsSize = "SIZE"
2016-10-17 23:21:08 +02:00
// ReturnItemCollectionMetricsNone is a ReturnItemCollectionMetrics enum value
2016-01-29 20:53:56 +01:00
ReturnItemCollectionMetricsNone = "NONE"
)
const (
2016-10-17 23:21:08 +02:00
// ReturnValueNone is a ReturnValue enum value
2016-01-29 20:53:56 +01:00
ReturnValueNone = "NONE"
2016-10-17 23:21:08 +02:00
// ReturnValueAllOld is a ReturnValue enum value
2016-01-29 20:53:56 +01:00
ReturnValueAllOld = "ALL_OLD"
2016-10-17 23:21:08 +02:00
// ReturnValueUpdatedOld is a ReturnValue enum value
2016-01-29 20:53:56 +01:00
ReturnValueUpdatedOld = "UPDATED_OLD"
2016-10-17 23:21:08 +02:00
// ReturnValueAllNew is a ReturnValue enum value
2016-01-29 20:53:56 +01:00
ReturnValueAllNew = "ALL_NEW"
2016-10-17 23:21:08 +02:00
// ReturnValueUpdatedNew is a ReturnValue enum value
2016-01-29 20:53:56 +01:00
ReturnValueUpdatedNew = "UPDATED_NEW"
)
const (
2016-10-17 23:21:08 +02:00
// ScalarAttributeTypeS is a ScalarAttributeType enum value
2016-01-29 20:53:56 +01:00
ScalarAttributeTypeS = "S"
2016-10-17 23:21:08 +02:00
// ScalarAttributeTypeN is a ScalarAttributeType enum value
2016-01-29 20:53:56 +01:00
ScalarAttributeTypeN = "N"
2016-10-17 23:21:08 +02:00
// ScalarAttributeTypeB is a ScalarAttributeType enum value
2016-01-29 20:53:56 +01:00
ScalarAttributeTypeB = "B"
)
const (
2016-10-17 23:21:08 +02:00
// SelectAllAttributes is a Select enum value
2016-01-29 20:53:56 +01:00
SelectAllAttributes = "ALL_ATTRIBUTES"
2016-10-17 23:21:08 +02:00
// SelectAllProjectedAttributes is a Select enum value
2016-01-29 20:53:56 +01:00
SelectAllProjectedAttributes = "ALL_PROJECTED_ATTRIBUTES"
2016-10-17 23:21:08 +02:00
// SelectSpecificAttributes is a Select enum value
2016-01-29 20:53:56 +01:00
SelectSpecificAttributes = "SPECIFIC_ATTRIBUTES"
2016-10-17 23:21:08 +02:00
// SelectCount is a Select enum value
2016-01-29 20:53:56 +01:00
SelectCount = "COUNT"
)
const (
2016-10-17 23:21:08 +02:00
// StreamViewTypeNewImage is a StreamViewType enum value
2016-01-29 20:53:56 +01:00
StreamViewTypeNewImage = "NEW_IMAGE"
2016-10-17 23:21:08 +02:00
// StreamViewTypeOldImage is a StreamViewType enum value
2016-01-29 20:53:56 +01:00
StreamViewTypeOldImage = "OLD_IMAGE"
2016-10-17 23:21:08 +02:00
// StreamViewTypeNewAndOldImages is a StreamViewType enum value
2016-01-29 20:53:56 +01:00
StreamViewTypeNewAndOldImages = "NEW_AND_OLD_IMAGES"
2016-10-17 23:21:08 +02:00
// StreamViewTypeKeysOnly is a StreamViewType enum value
2016-01-29 20:53:56 +01:00
StreamViewTypeKeysOnly = "KEYS_ONLY"
)
const (
2016-10-17 23:21:08 +02:00
// TableStatusCreating is a TableStatus enum value
2016-01-29 20:53:56 +01:00
TableStatusCreating = "CREATING"
2016-10-17 23:21:08 +02:00
// TableStatusUpdating is a TableStatus enum value
2016-01-29 20:53:56 +01:00
TableStatusUpdating = "UPDATING"
2016-10-17 23:21:08 +02:00
// TableStatusDeleting is a TableStatus enum value
2016-01-29 20:53:56 +01:00
TableStatusDeleting = "DELETING"
2016-10-17 23:21:08 +02:00
// TableStatusActive is a TableStatus enum value
2016-01-29 20:53:56 +01:00
TableStatusActive = "ACTIVE"
)
2017-03-03 19:48:24 +01:00
const (
// TimeToLiveStatusEnabling is a TimeToLiveStatus enum value
TimeToLiveStatusEnabling = "ENABLING"
// TimeToLiveStatusDisabling is a TimeToLiveStatus enum value
TimeToLiveStatusDisabling = "DISABLING"
// TimeToLiveStatusEnabled is a TimeToLiveStatus enum value
TimeToLiveStatusEnabled = "ENABLED"
// TimeToLiveStatusDisabled is a TimeToLiveStatus enum value
TimeToLiveStatusDisabled = "DISABLED"
)