dynamodb

package
Version: v1.45.17 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 26, 2023 License: Apache-2.0 Imports: 19 Imported by: 2,435

Documentation

Overview

Package dynamodb provides the client and types for making API requests to Amazon DynamoDB.

Amazon DynamoDB is a fully managed NoSQL database service that provides fast and predictable performance with seamless scalability. DynamoDB lets you offload the administrative burdens of operating and scaling a distributed database, so that you don't have to worry about hardware provisioning, setup and configuration, replication, software patching, or cluster scaling.

With DynamoDB, you can create database tables that can store and retrieve any amount of data, and serve any level of request traffic. You can scale up or scale down your tables' throughput capacity without downtime or performance degradation, and use the Amazon Web Services Management Console to monitor resource utilization and performance metrics.

DynamoDB automatically spreads the data and traffic for your tables over a sufficient number of servers to handle your throughput and storage requirements, while maintaining consistent and fast performance. All of your data is stored on solid state disks (SSDs) and automatically replicated across multiple Availability Zones in an Amazon Web Services Region, providing built-in high availability and data durability.

See https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10 for more information on this service.

See dynamodb package documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/dynamodb/

Using the Client

To contact Amazon DynamoDB with the SDK use the New function to create a new service client. With that client you can make API requests to the service. These clients are safe to use concurrently.

See the SDK's documentation for more information on how to use the SDK. https://docs.aws.amazon.com/sdk-for-go/api/

See aws.Config documentation for more information on configuring SDK clients. https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config

See the Amazon DynamoDB client DynamoDB for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/dynamodb/#New

AttributeValue Marshaling and Unmarshaling Helpers

Utility helpers to marshal and unmarshal AttributeValue to and from Go types can be found in the dynamodbattribute sub package. This package provides specialized functions for the common ways of working with AttributeValues. Such as map[string]*AttributeValue, []*AttributeValue, and directly with *AttributeValue. This is helpful for marshaling Go types for API operations such as PutItem, and unmarshaling Query and Scan APIs' responses.

See the dynamodbattribute package documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/dynamodb/dynamodbattribute/

Expression Builders

The expression package provides utility types and functions to build DynamoDB expression for type safe construction of API ExpressionAttributeNames, and ExpressionAttribute Values.

The package represents the various DynamoDB Expressions as structs named accordingly. For example, ConditionBuilder represents a DynamoDB Condition Expression, an UpdateBuilder represents a DynamoDB Update Expression, and so on.

See the expression package documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/dynamodb/expression/

Index

Examples

Constants

View Source 
const (
	// AttributeActionAdd is a AttributeAction enum value
	AttributeActionAdd = "ADD"

	// AttributeActionPut is a AttributeAction enum value
	AttributeActionPut = "PUT"

	// AttributeActionDelete is a AttributeAction enum value
	AttributeActionDelete = "DELETE"
)
View Source 
const (
	// BackupStatusCreating is a BackupStatus enum value
	BackupStatusCreating = "CREATING"

	// BackupStatusDeleted is a BackupStatus enum value
	BackupStatusDeleted = "DELETED"

	// BackupStatusAvailable is a BackupStatus enum value
	BackupStatusAvailable = "AVAILABLE"
)
View Source 
const (
	// BackupTypeUser is a BackupType enum value
	BackupTypeUser = "USER"

	// BackupTypeSystem is a BackupType enum value
	BackupTypeSystem = "SYSTEM"

	// BackupTypeAwsBackup is a BackupType enum value
	BackupTypeAwsBackup = "AWS_BACKUP"
)
View Source 
const (
	// BackupTypeFilterUser is a BackupTypeFilter enum value
	BackupTypeFilterUser = "USER"

	// BackupTypeFilterSystem is a BackupTypeFilter enum value
	BackupTypeFilterSystem = "SYSTEM"

	// BackupTypeFilterAwsBackup is a BackupTypeFilter enum value
	BackupTypeFilterAwsBackup = "AWS_BACKUP"

	// BackupTypeFilterAll is a BackupTypeFilter enum value
	BackupTypeFilterAll = "ALL"
)
View Source 
const (
	// BatchStatementErrorCodeEnumConditionalCheckFailed is a BatchStatementErrorCodeEnum enum value
	BatchStatementErrorCodeEnumConditionalCheckFailed = "ConditionalCheckFailed"

	// BatchStatementErrorCodeEnumItemCollectionSizeLimitExceeded is a BatchStatementErrorCodeEnum enum value
	BatchStatementErrorCodeEnumItemCollectionSizeLimitExceeded = "ItemCollectionSizeLimitExceeded"

	// BatchStatementErrorCodeEnumRequestLimitExceeded is a BatchStatementErrorCodeEnum enum value
	BatchStatementErrorCodeEnumRequestLimitExceeded = "RequestLimitExceeded"

	// BatchStatementErrorCodeEnumValidationError is a BatchStatementErrorCodeEnum enum value
	BatchStatementErrorCodeEnumValidationError = "ValidationError"

	// BatchStatementErrorCodeEnumProvisionedThroughputExceeded is a BatchStatementErrorCodeEnum enum value
	BatchStatementErrorCodeEnumProvisionedThroughputExceeded = "ProvisionedThroughputExceeded"

	// BatchStatementErrorCodeEnumTransactionConflict is a BatchStatementErrorCodeEnum enum value
	BatchStatementErrorCodeEnumTransactionConflict = "TransactionConflict"

	// BatchStatementErrorCodeEnumThrottlingError is a BatchStatementErrorCodeEnum enum value
	BatchStatementErrorCodeEnumThrottlingError = "ThrottlingError"

	// BatchStatementErrorCodeEnumInternalServerError is a BatchStatementErrorCodeEnum enum value
	BatchStatementErrorCodeEnumInternalServerError = "InternalServerError"

	// BatchStatementErrorCodeEnumResourceNotFound is a BatchStatementErrorCodeEnum enum value
	BatchStatementErrorCodeEnumResourceNotFound = "ResourceNotFound"

	// BatchStatementErrorCodeEnumAccessDenied is a BatchStatementErrorCodeEnum enum value
	BatchStatementErrorCodeEnumAccessDenied = "AccessDenied"

	// BatchStatementErrorCodeEnumDuplicateItem is a BatchStatementErrorCodeEnum enum value
	BatchStatementErrorCodeEnumDuplicateItem = "DuplicateItem"
)
View Source 
const (
	// BillingModeProvisioned is a BillingMode enum value
	BillingModeProvisioned = "PROVISIONED"

	// BillingModePayPerRequest is a BillingMode enum value
	BillingModePayPerRequest = "PAY_PER_REQUEST"
)
View Source 
const (
	// ComparisonOperatorEq is a ComparisonOperator enum value
	ComparisonOperatorEq = "EQ"

	// ComparisonOperatorNe is a ComparisonOperator enum value
	ComparisonOperatorNe = "NE"

	// ComparisonOperatorIn is a ComparisonOperator enum value
	ComparisonOperatorIn = "IN"

	// ComparisonOperatorLe is a ComparisonOperator enum value
	ComparisonOperatorLe = "LE"

	// ComparisonOperatorLt is a ComparisonOperator enum value
	ComparisonOperatorLt = "LT"

	// ComparisonOperatorGe is a ComparisonOperator enum value
	ComparisonOperatorGe = "GE"

	// ComparisonOperatorGt is a ComparisonOperator enum value
	ComparisonOperatorGt = "GT"

	// ComparisonOperatorBetween is a ComparisonOperator enum value
	ComparisonOperatorBetween = "BETWEEN"

	// ComparisonOperatorNotNull is a ComparisonOperator enum value
	ComparisonOperatorNotNull = "NOT_NULL"

	// ComparisonOperatorNull is a ComparisonOperator enum value
	ComparisonOperatorNull = "NULL"

	// ComparisonOperatorContains is a ComparisonOperator enum value
	ComparisonOperatorContains = "CONTAINS"

	// ComparisonOperatorNotContains is a ComparisonOperator enum value
	ComparisonOperatorNotContains = "NOT_CONTAINS"

	// ComparisonOperatorBeginsWith is a ComparisonOperator enum value
	ComparisonOperatorBeginsWith = "BEGINS_WITH"
)
View Source 
const (
	// ConditionalOperatorAnd is a ConditionalOperator enum value
	ConditionalOperatorAnd = "AND"

	// ConditionalOperatorOr is a ConditionalOperator enum value
	ConditionalOperatorOr = "OR"
)
View Source 
const (
	// ContinuousBackupsStatusEnabled is a ContinuousBackupsStatus enum value
	ContinuousBackupsStatusEnabled = "ENABLED"

	// ContinuousBackupsStatusDisabled is a ContinuousBackupsStatus enum value
	ContinuousBackupsStatusDisabled = "DISABLED"
)
View Source 
const (
	// ContributorInsightsActionEnable is a ContributorInsightsAction enum value
	ContributorInsightsActionEnable = "ENABLE"

	// ContributorInsightsActionDisable is a ContributorInsightsAction enum value
	ContributorInsightsActionDisable = "DISABLE"
)
View Source 
const (
	// ContributorInsightsStatusEnabling is a ContributorInsightsStatus enum value
	ContributorInsightsStatusEnabling = "ENABLING"

	// ContributorInsightsStatusEnabled is a ContributorInsightsStatus enum value
	ContributorInsightsStatusEnabled = "ENABLED"

	// ContributorInsightsStatusDisabling is a ContributorInsightsStatus enum value
	ContributorInsightsStatusDisabling = "DISABLING"

	// ContributorInsightsStatusDisabled is a ContributorInsightsStatus enum value
	ContributorInsightsStatusDisabled = "DISABLED"

	// ContributorInsightsStatusFailed is a ContributorInsightsStatus enum value
	ContributorInsightsStatusFailed = "FAILED"
)
View Source 
const (
	// DestinationStatusEnabling is a DestinationStatus enum value
	DestinationStatusEnabling = "ENABLING"

	// DestinationStatusActive is a DestinationStatus enum value
	DestinationStatusActive = "ACTIVE"

	// DestinationStatusDisabling is a DestinationStatus enum value
	DestinationStatusDisabling = "DISABLING"

	// DestinationStatusDisabled is a DestinationStatus enum value
	DestinationStatusDisabled = "DISABLED"

	// DestinationStatusEnableFailed is a DestinationStatus enum value
	DestinationStatusEnableFailed = "ENABLE_FAILED"
)
View Source 
const (
	// ExportFormatDynamodbJson is a ExportFormat enum value
	ExportFormatDynamodbJson = "DYNAMODB_JSON"

	// ExportFormatIon is a ExportFormat enum value
	ExportFormatIon = "ION"
)
View Source 
const (
	// ExportStatusInProgress is a ExportStatus enum value
	ExportStatusInProgress = "IN_PROGRESS"

	// ExportStatusCompleted is a ExportStatus enum value
	ExportStatusCompleted = "COMPLETED"

	// ExportStatusFailed is a ExportStatus enum value
	ExportStatusFailed = "FAILED"
)
View Source 
const (
	// ExportTypeFullExport is a ExportType enum value
	ExportTypeFullExport = "FULL_EXPORT"

	// ExportTypeIncrementalExport is a ExportType enum value
	ExportTypeIncrementalExport = "INCREMENTAL_EXPORT"
)
View Source 
const (
	// ExportViewTypeNewImage is a ExportViewType enum value
	ExportViewTypeNewImage = "NEW_IMAGE"

	// ExportViewTypeNewAndOldImages is a ExportViewType enum value
	ExportViewTypeNewAndOldImages = "NEW_AND_OLD_IMAGES"
)
View Source 
const (
	// GlobalTableStatusCreating is a GlobalTableStatus enum value
	GlobalTableStatusCreating = "CREATING"

	// GlobalTableStatusActive is a GlobalTableStatus enum value
	GlobalTableStatusActive = "ACTIVE"

	// GlobalTableStatusDeleting is a GlobalTableStatus enum value
	GlobalTableStatusDeleting = "DELETING"

	// GlobalTableStatusUpdating is a GlobalTableStatus enum value
	GlobalTableStatusUpdating = "UPDATING"
)
View Source 
const (
	// ImportStatusInProgress is a ImportStatus enum value
	ImportStatusInProgress = "IN_PROGRESS"

	// ImportStatusCompleted is a ImportStatus enum value
	ImportStatusCompleted = "COMPLETED"

	// ImportStatusCancelling is a ImportStatus enum value
	ImportStatusCancelling = "CANCELLING"

	// ImportStatusCancelled is a ImportStatus enum value
	ImportStatusCancelled = "CANCELLED"

	// ImportStatusFailed is a ImportStatus enum value
	ImportStatusFailed = "FAILED"
)
View Source 
const (
	// IndexStatusCreating is a IndexStatus enum value
	IndexStatusCreating = "CREATING"

	// IndexStatusUpdating is a IndexStatus enum value
	IndexStatusUpdating = "UPDATING"

	// IndexStatusDeleting is a IndexStatus enum value
	IndexStatusDeleting = "DELETING"

	// IndexStatusActive is a IndexStatus enum value
	IndexStatusActive = "ACTIVE"
)
View Source 
const (
	// InputCompressionTypeGzip is a InputCompressionType enum value
	InputCompressionTypeGzip = "GZIP"

	// InputCompressionTypeZstd is a InputCompressionType enum value
	InputCompressionTypeZstd = "ZSTD"

	// InputCompressionTypeNone is a InputCompressionType enum value
	InputCompressionTypeNone = "NONE"
)
View Source 
const (
	// InputFormatDynamodbJson is a InputFormat enum value
	InputFormatDynamodbJson = "DYNAMODB_JSON"

	// InputFormatIon is a InputFormat enum value
	InputFormatIon = "ION"

	// InputFormatCsv is a InputFormat enum value
	InputFormatCsv = "CSV"
)
View Source 
const (
	// KeyTypeHash is a KeyType enum value
	KeyTypeHash = "HASH"

	// KeyTypeRange is a KeyType enum value
	KeyTypeRange = "RANGE"
)
View Source 
const (
	// PointInTimeRecoveryStatusEnabled is a PointInTimeRecoveryStatus enum value
	PointInTimeRecoveryStatusEnabled = "ENABLED"

	// PointInTimeRecoveryStatusDisabled is a PointInTimeRecoveryStatus enum value
	PointInTimeRecoveryStatusDisabled = "DISABLED"
)
View Source 
const (
	// ProjectionTypeAll is a ProjectionType enum value
	ProjectionTypeAll = "ALL"

	// ProjectionTypeKeysOnly is a ProjectionType enum value
	ProjectionTypeKeysOnly = "KEYS_ONLY"

	// ProjectionTypeInclude is a ProjectionType enum value
	ProjectionTypeInclude = "INCLUDE"
)
View Source 
const (
	// ReplicaStatusCreating is a ReplicaStatus enum value
	ReplicaStatusCreating = "CREATING"

	// ReplicaStatusCreationFailed is a ReplicaStatus enum value
	ReplicaStatusCreationFailed = "CREATION_FAILED"

	// ReplicaStatusUpdating is a ReplicaStatus enum value
	ReplicaStatusUpdating = "UPDATING"

	// ReplicaStatusDeleting is a ReplicaStatus enum value
	ReplicaStatusDeleting = "DELETING"

	// ReplicaStatusActive is a ReplicaStatus enum value
	ReplicaStatusActive = "ACTIVE"

	// ReplicaStatusRegionDisabled is a ReplicaStatus enum value
	ReplicaStatusRegionDisabled = "REGION_DISABLED"

	// ReplicaStatusInaccessibleEncryptionCredentials is a ReplicaStatus enum value
	ReplicaStatusInaccessibleEncryptionCredentials = "INACCESSIBLE_ENCRYPTION_CREDENTIALS"
)
View Source 
const (
	// ReturnConsumedCapacityIndexes is a ReturnConsumedCapacity enum value
	ReturnConsumedCapacityIndexes = "INDEXES"

	// ReturnConsumedCapacityTotal is a ReturnConsumedCapacity enum value
	ReturnConsumedCapacityTotal = "TOTAL"

	// ReturnConsumedCapacityNone is a ReturnConsumedCapacity enum value
	ReturnConsumedCapacityNone = "NONE"
)

Determines the level of detail about either provisioned or on-demand throughput consumption that is returned in the response:

  • INDEXES - The response includes the aggregate ConsumedCapacity for the operation, together with ConsumedCapacity for each table and secondary index that was accessed. 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).

  • TOTAL - The response includes only the aggregate ConsumedCapacity for the operation.

  • NONE - No ConsumedCapacity details are included in the response.

View Source 
const (
	// ReturnItemCollectionMetricsSize is a ReturnItemCollectionMetrics enum value
	ReturnItemCollectionMetricsSize = "SIZE"

	// ReturnItemCollectionMetricsNone is a ReturnItemCollectionMetrics enum value
	ReturnItemCollectionMetricsNone = "NONE"
)
View Source 
const (
	// ReturnValueNone is a ReturnValue enum value
	ReturnValueNone = "NONE"

	// ReturnValueAllOld is a ReturnValue enum value
	ReturnValueAllOld = "ALL_OLD"

	// ReturnValueUpdatedOld is a ReturnValue enum value
	ReturnValueUpdatedOld = "UPDATED_OLD"

	// ReturnValueAllNew is a ReturnValue enum value
	ReturnValueAllNew = "ALL_NEW"

	// ReturnValueUpdatedNew is a ReturnValue enum value
	ReturnValueUpdatedNew = "UPDATED_NEW"
)
View Source 
const (
	// ReturnValuesOnConditionCheckFailureAllOld is a ReturnValuesOnConditionCheckFailure enum value
	ReturnValuesOnConditionCheckFailureAllOld = "ALL_OLD"

	// ReturnValuesOnConditionCheckFailureNone is a ReturnValuesOnConditionCheckFailure enum value
	ReturnValuesOnConditionCheckFailureNone = "NONE"
)
View Source 
const (
	// S3SseAlgorithmAes256 is a S3SseAlgorithm enum value
	S3SseAlgorithmAes256 = "AES256"

	// S3SseAlgorithmKms is a S3SseAlgorithm enum value
	S3SseAlgorithmKms = "KMS"
)
View Source 
const (
	// SSEStatusEnabling is a SSEStatus enum value
	SSEStatusEnabling = "ENABLING"

	// SSEStatusEnabled is a SSEStatus enum value
	SSEStatusEnabled = "ENABLED"

	// SSEStatusDisabling is a SSEStatus enum value
	SSEStatusDisabling = "DISABLING"

	// SSEStatusDisabled is a SSEStatus enum value
	SSEStatusDisabled = "DISABLED"

	// SSEStatusUpdating is a SSEStatus enum value
	SSEStatusUpdating = "UPDATING"
)
View Source 
const (
	// SSETypeAes256 is a SSEType enum value
	SSETypeAes256 = "AES256"

	// SSETypeKms is a SSEType enum value
	SSETypeKms = "KMS"
)
View Source 
const (
	// ScalarAttributeTypeS is a ScalarAttributeType enum value
	ScalarAttributeTypeS = "S"

	// ScalarAttributeTypeN is a ScalarAttributeType enum value
	ScalarAttributeTypeN = "N"

	// ScalarAttributeTypeB is a ScalarAttributeType enum value
	ScalarAttributeTypeB = "B"
)
View Source 
const (
	// SelectAllAttributes is a Select enum value
	SelectAllAttributes = "ALL_ATTRIBUTES"

	// SelectAllProjectedAttributes is a Select enum value
	SelectAllProjectedAttributes = "ALL_PROJECTED_ATTRIBUTES"

	// SelectSpecificAttributes is a Select enum value
	SelectSpecificAttributes = "SPECIFIC_ATTRIBUTES"

	// SelectCount is a Select enum value
	SelectCount = "COUNT"
)
View Source 
const (
	// StreamViewTypeNewImage is a StreamViewType enum value
	StreamViewTypeNewImage = "NEW_IMAGE"

	// StreamViewTypeOldImage is a StreamViewType enum value
	StreamViewTypeOldImage = "OLD_IMAGE"

	// StreamViewTypeNewAndOldImages is a StreamViewType enum value
	StreamViewTypeNewAndOldImages = "NEW_AND_OLD_IMAGES"

	// StreamViewTypeKeysOnly is a StreamViewType enum value
	StreamViewTypeKeysOnly = "KEYS_ONLY"
)
View Source 
const (
	// TableClassStandard is a TableClass enum value
	TableClassStandard = "STANDARD"

	// TableClassStandardInfrequentAccess is a TableClass enum value
	TableClassStandardInfrequentAccess = "STANDARD_INFREQUENT_ACCESS"
)
View Source 
const (
	// TableStatusCreating is a TableStatus enum value
	TableStatusCreating = "CREATING"

	// TableStatusUpdating is a TableStatus enum value
	TableStatusUpdating = "UPDATING"

	// TableStatusDeleting is a TableStatus enum value
	TableStatusDeleting = "DELETING"

	// TableStatusActive is a TableStatus enum value
	TableStatusActive = "ACTIVE"

	// TableStatusInaccessibleEncryptionCredentials is a TableStatus enum value
	TableStatusInaccessibleEncryptionCredentials = "INACCESSIBLE_ENCRYPTION_CREDENTIALS"

	// TableStatusArchiving is a TableStatus enum value
	TableStatusArchiving = "ARCHIVING"

	// TableStatusArchived is a TableStatus enum value
	TableStatusArchived = "ARCHIVED"
)
View Source 
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"
)
View Source 
const (

	// ErrCodeBackupInUseException for service response error code
	// "BackupInUseException".
	//
	// There is another ongoing conflicting backup control plane operation on the
	// table. The backup is either being created, deleted or restored to a table.
	ErrCodeBackupInUseException = "BackupInUseException"

	// ErrCodeBackupNotFoundException for service response error code
	// "BackupNotFoundException".
	//
	// Backup not found for the given BackupARN.
	ErrCodeBackupNotFoundException = "BackupNotFoundException"

	// ErrCodeConditionalCheckFailedException for service response error code
	// "ConditionalCheckFailedException".
	//
	// A condition specified in the operation could not be evaluated.
	ErrCodeConditionalCheckFailedException = "ConditionalCheckFailedException"

	// ErrCodeContinuousBackupsUnavailableException for service response error code
	// "ContinuousBackupsUnavailableException".
	//
	// Backups have not yet been enabled for this table.
	ErrCodeContinuousBackupsUnavailableException = "ContinuousBackupsUnavailableException"

	// ErrCodeDuplicateItemException for service response error code
	// "DuplicateItemException".
	//
	// There was an attempt to insert an item with the same primary key as an item
	// that already exists in the DynamoDB table.
	ErrCodeDuplicateItemException = "DuplicateItemException"

	// ErrCodeExportConflictException for service response error code
	// "ExportConflictException".
	//
	// There was a conflict when writing to the specified S3 bucket.
	ErrCodeExportConflictException = "ExportConflictException"

	// ErrCodeExportNotFoundException for service response error code
	// "ExportNotFoundException".
	//
	// The specified export was not found.
	ErrCodeExportNotFoundException = "ExportNotFoundException"

	// ErrCodeGlobalTableAlreadyExistsException for service response error code
	// "GlobalTableAlreadyExistsException".
	//
	// The specified global table already exists.
	ErrCodeGlobalTableAlreadyExistsException = "GlobalTableAlreadyExistsException"

	// ErrCodeGlobalTableNotFoundException for service response error code
	// "GlobalTableNotFoundException".
	//
	// The specified global table does not exist.
	ErrCodeGlobalTableNotFoundException = "GlobalTableNotFoundException"

	// ErrCodeIdempotentParameterMismatchException for service response error code
	// "IdempotentParameterMismatchException".
	//
	// DynamoDB rejected the request because you retried a request with a different
	// payload but with an idempotent token that was already used.
	ErrCodeIdempotentParameterMismatchException = "IdempotentParameterMismatchException"

	// ErrCodeImportConflictException for service response error code
	// "ImportConflictException".
	//
	// There was a conflict when importing from the specified S3 source. This can
	// occur when the current import conflicts with a previous import request that
	// had the same client token.
	ErrCodeImportConflictException = "ImportConflictException"

	// ErrCodeImportNotFoundException for service response error code
	// "ImportNotFoundException".
	//
	// The specified import was not found.
	ErrCodeImportNotFoundException = "ImportNotFoundException"

	// ErrCodeIndexNotFoundException for service response error code
	// "IndexNotFoundException".
	//
	// The operation tried to access a nonexistent index.
	ErrCodeIndexNotFoundException = "IndexNotFoundException"

	// ErrCodeInternalServerError for service response error code
	// "InternalServerError".
	//
	// An error occurred on the server side.
	ErrCodeInternalServerError = "InternalServerError"

	// ErrCodeInvalidExportTimeException for service response error code
	// "InvalidExportTimeException".
	//
	// The specified ExportTime is outside of the point in time recovery window.
	ErrCodeInvalidExportTimeException = "InvalidExportTimeException"

	// ErrCodeInvalidRestoreTimeException for service response error code
	// "InvalidRestoreTimeException".
	//
	// An invalid restore time was specified. RestoreDateTime must be between EarliestRestorableDateTime
	// and LatestRestorableDateTime.
	ErrCodeInvalidRestoreTimeException = "InvalidRestoreTimeException"

	// ErrCodeItemCollectionSizeLimitExceededException for service response error code
	// "ItemCollectionSizeLimitExceededException".
	//
	// An item collection is too large. This exception is only returned for tables
	// that have one or more local secondary indexes.
	ErrCodeItemCollectionSizeLimitExceededException = "ItemCollectionSizeLimitExceededException"

	// ErrCodeLimitExceededException for service response error code
	// "LimitExceededException".
	//
	// There is no limit to the number of daily on-demand backups that can be taken.
	//
	// For most purposes, up to 500 simultaneous table operations are allowed per
	// account. These operations include CreateTable, UpdateTable, DeleteTable,UpdateTimeToLive,
	// RestoreTableFromBackup, and RestoreTableToPointInTime.
	//
	// When you are creating a table with one or more secondary indexes, you can
	// have up to 250 such requests running at a time. However, if the table or
	// index specifications are complex, then DynamoDB might temporarily reduce
	// the number of concurrent operations.
	//
	// When importing into DynamoDB, up to 50 simultaneous import table operations
	// are allowed per account.
	//
	// There is a soft account quota of 2,500 tables.
	//
	// GetRecords was called with a value of more than 1000 for the limit request
	// parameter.
	//
	// More than 2 processes are reading from the same streams shard at the same
	// time. Exceeding this limit may result in request throttling.
	ErrCodeLimitExceededException = "LimitExceededException"

	// ErrCodePointInTimeRecoveryUnavailableException for service response error code
	// "PointInTimeRecoveryUnavailableException".
	//
	// Point in time recovery has not yet been enabled for this source table.
	ErrCodePointInTimeRecoveryUnavailableException = "PointInTimeRecoveryUnavailableException"

	// ErrCodeProvisionedThroughputExceededException for service response error code
	// "ProvisionedThroughputExceededException".
	//
	// Your request rate is too high. The Amazon Web Services 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 Exponential Backoff (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.Errors.html#Programming.Errors.RetryAndBackoff)
	// in the Amazon DynamoDB Developer Guide.
	ErrCodeProvisionedThroughputExceededException = "ProvisionedThroughputExceededException"

	// ErrCodeReplicaAlreadyExistsException for service response error code
	// "ReplicaAlreadyExistsException".
	//
	// The specified replica is already part of the global table.
	ErrCodeReplicaAlreadyExistsException = "ReplicaAlreadyExistsException"

	// ErrCodeReplicaNotFoundException for service response error code
	// "ReplicaNotFoundException".
	//
	// The specified replica is no longer part of the global table.
	ErrCodeReplicaNotFoundException = "ReplicaNotFoundException"

	// ErrCodeRequestLimitExceeded for service response error code
	// "RequestLimitExceeded".
	//
	// Throughput exceeds the current throughput quota for your account. Please
	// contact Amazon Web Services Support (https://aws.amazon.com/support) to request
	// a quota increase.
	ErrCodeRequestLimitExceeded = "RequestLimitExceeded"

	// ErrCodeResourceInUseException for service response error code
	// "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.
	ErrCodeResourceInUseException = "ResourceInUseException"

	// ErrCodeResourceNotFoundException for service response error code
	// "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.
	ErrCodeResourceNotFoundException = "ResourceNotFoundException"

	// ErrCodeTableAlreadyExistsException for service response error code
	// "TableAlreadyExistsException".
	//
	// A target table with the specified name already exists.
	ErrCodeTableAlreadyExistsException = "TableAlreadyExistsException"

	// ErrCodeTableInUseException for service response error code
	// "TableInUseException".
	//
	// A target table with the specified name is either being created or deleted.
	ErrCodeTableInUseException = "TableInUseException"

	// ErrCodeTableNotFoundException for service response error code
	// "TableNotFoundException".
	//
	// A source table with the name TableName does not currently exist within the
	// subscriber's account or the subscriber is operating in the wrong Amazon Web
	// Services Region.
	ErrCodeTableNotFoundException = "TableNotFoundException"

	// ErrCodeTransactionCanceledException for service response error code
	// "TransactionCanceledException".
	//
	// The entire transaction request was canceled.
	//
	// DynamoDB cancels a TransactWriteItems request under the following circumstances:
	//
	//    * A condition in one of the condition expressions is not met.
	//
	//    * A table in the TransactWriteItems request is in a different account
	//    or region.
	//
	//    * More than one action in the TransactWriteItems operation targets the
	//    same item.
	//
	//    * There is insufficient provisioned capacity for the transaction to be
	//    completed.
	//
	//    * An item size becomes too large (larger than 400 KB), or a local secondary
	//    index (LSI) becomes too large, or a similar validation error occurs because
	//    of changes made by the transaction.
	//
	//    * There is a user error, such as an invalid data format.
	//
	// DynamoDB cancels a TransactGetItems request under the following circumstances:
	//
	//    * There is an ongoing TransactGetItems operation that conflicts with a
	//    concurrent PutItem, UpdateItem, DeleteItem or TransactWriteItems request.
	//    In this case the TransactGetItems operation fails with a TransactionCanceledException.
	//
	//    * A table in the TransactGetItems request is in a different account or
	//    region.
	//
	//    * There is insufficient provisioned capacity for the transaction to be
	//    completed.
	//
	//    * There is a user error, such as an invalid data format.
	//
	// If using Java, DynamoDB lists the cancellation reasons on the CancellationReasons
	// property. This property is not set for other languages. Transaction cancellation
	// reasons are ordered in the order of requested items, if an item has no error
	// it will have None code and Null message.
	//
	// Cancellation reason codes and possible error messages:
	//
	//    * No Errors: Code: None Message: null
	//
	//    * Conditional Check Failed: Code: ConditionalCheckFailed Message: The
	//    conditional request failed.
	//
	//    * Item Collection Size Limit Exceeded: Code: ItemCollectionSizeLimitExceeded
	//    Message: Collection size exceeded.
	//
	//    * Transaction Conflict: Code: TransactionConflict Message: Transaction
	//    is ongoing for the item.
	//
	//    * Provisioned Throughput Exceeded: Code: ProvisionedThroughputExceeded
	//    Messages: The level of configured provisioned throughput for the table
	//    was exceeded. Consider increasing your provisioning level with the UpdateTable
	//    API. This Message is received when provisioned throughput is exceeded
	//    is on a provisioned DynamoDB table. The level of configured provisioned
	//    throughput for one or more global secondary indexes of the table was exceeded.
	//    Consider increasing your provisioning level for the under-provisioned
	//    global secondary indexes with the UpdateTable API. This message is returned
	//    when provisioned throughput is exceeded is on a provisioned GSI.
	//
	//    * Throttling Error: Code: ThrottlingError Messages: Throughput exceeds
	//    the current capacity of your table or index. DynamoDB is automatically
	//    scaling your table or index so please try again shortly. If exceptions
	//    persist, check if you have a hot key: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html.
	//    This message is returned when writes get throttled on an On-Demand table
	//    as DynamoDB is automatically scaling the table. Throughput exceeds the
	//    current capacity for one or more global secondary indexes. DynamoDB is
	//    automatically scaling your index so please try again shortly. This message
	//    is returned when writes get throttled on an On-Demand GSI as DynamoDB
	//    is automatically scaling the GSI.
	//
	//    * Validation Error: Code: ValidationError Messages: One or more parameter
	//    values were invalid. The update expression attempted to update the secondary
	//    index key beyond allowed size limits. The update expression attempted
	//    to update the secondary index key to unsupported type. An operand in the
	//    update expression has an incorrect data type. Item size to update has
	//    exceeded the maximum allowed size. Number overflow. Attempting to store
	//    a number with magnitude larger than supported range. Type mismatch for
	//    attribute to update. Nesting Levels have exceeded supported limits. The
	//    document path provided in the update expression is invalid for update.
	//    The provided expression refers to an attribute that does not exist in
	//    the item.
	ErrCodeTransactionCanceledException = "TransactionCanceledException"

	// ErrCodeTransactionConflictException for service response error code
	// "TransactionConflictException".
	//
	// Operation was rejected because there is an ongoing transaction for the item.
	ErrCodeTransactionConflictException = "TransactionConflictException"

	// ErrCodeTransactionInProgressException for service response error code
	// "TransactionInProgressException".
	//
	// The transaction with the given request token is already in progress.
	//
	// Recommended Settings
	//
	// This is a general recommendation for handling the TransactionInProgressException.
	// These settings help ensure that the client retries will trigger completion
	// of the ongoing TransactWriteItems request.
	//
	//    * Set clientExecutionTimeout to a value that allows at least one retry
	//    to be processed after 5 seconds have elapsed since the first attempt for
	//    the TransactWriteItems operation.
	//
	//    * Set socketTimeout to a value a little lower than the requestTimeout
	//    setting.
	//
	//    * requestTimeout should be set based on the time taken for the individual
	//    retries of a single HTTP request for your use case, but setting it to
	//    1 second or higher should work well to reduce chances of retries and TransactionInProgressException
	//    errors.
	//
	//    * Use exponential backoff when retrying and tune backoff if needed.
	//
	// Assuming default retry policy (https://github.com/aws/aws-sdk-java/blob/fd409dee8ae23fb8953e0bb4dbde65536a7e0514/aws-java-sdk-core/src/main/java/com/amazonaws/retry/PredefinedRetryPolicies.java#L97),
	// example timeout settings based on the guidelines above are as follows:
	//
	// Example timeline:
	//
	//    * 0-1000 first attempt
	//
	//    * 1000-1500 first sleep/delay (default retry policy uses 500 ms as base
	//    delay for 4xx errors)
	//
	//    * 1500-2500 second attempt
	//
	//    * 2500-3500 second sleep/delay (500 * 2, exponential backoff)
	//
	//    * 3500-4500 third attempt
	//
	//    * 4500-6500 third sleep/delay (500 * 2^2)
	//
	//    * 6500-7500 fourth attempt (this can trigger inline recovery since 5 seconds
	//    have elapsed since the first attempt reached TC)
	ErrCodeTransactionInProgressException = "TransactionInProgressException"
)
View Source 
const (
	ServiceName = "dynamodb"  // Name of service.
	EndpointsID = ServiceName // ID to lookup a service endpoint with.
	ServiceID   = "DynamoDB"  // ServiceID is a unique identifier of a specific service.
)

Service information constants

Variables

This section is empty.

Functions

func AttributeAction_Values added in v1.34.3 

func AttributeAction_Values() []string

AttributeAction_Values returns all elements of the AttributeAction enum

func BackupStatus_Values added in v1.34.3 

func BackupStatus_Values() []string

BackupStatus_Values returns all elements of the BackupStatus enum

func BackupTypeFilter_Values added in v1.34.3 

func BackupTypeFilter_Values() []string

BackupTypeFilter_Values returns all elements of the BackupTypeFilter enum

func BackupType_Values added in v1.34.3 

func BackupType_Values() []string

BackupType_Values returns all elements of the BackupType enum

func BatchStatementErrorCodeEnum_Values added in v1.35.34 

func BatchStatementErrorCodeEnum_Values() []string

BatchStatementErrorCodeEnum_Values returns all elements of the BatchStatementErrorCodeEnum enum

func BillingMode_Values added in v1.34.3 

func BillingMode_Values() []string

BillingMode_Values returns all elements of the BillingMode enum

func ComparisonOperator_Values added in v1.34.3 

func ComparisonOperator_Values() []string

ComparisonOperator_Values returns all elements of the ComparisonOperator enum

func ConditionalOperator_Values added in v1.34.3 

func ConditionalOperator_Values() []string

ConditionalOperator_Values returns all elements of the ConditionalOperator enum

func ContinuousBackupsStatus_Values added in v1.34.3 

func ContinuousBackupsStatus_Values() []string

ContinuousBackupsStatus_Values returns all elements of the ContinuousBackupsStatus enum

func ContributorInsightsAction_Values added in v1.34.3 

func ContributorInsightsAction_Values() []string

ContributorInsightsAction_Values returns all elements of the ContributorInsightsAction enum

func ContributorInsightsStatus_Values added in v1.34.3 

func ContributorInsightsStatus_Values() []string

ContributorInsightsStatus_Values returns all elements of the ContributorInsightsStatus enum

func DestinationStatus_Values added in v1.35.34 

func DestinationStatus_Values() []string

DestinationStatus_Values returns all elements of the DestinationStatus enum

func ExportFormat_Values added in v1.35.24 

func ExportFormat_Values() []string

ExportFormat_Values returns all elements of the ExportFormat enum

func ExportStatus_Values added in v1.35.24 

func ExportStatus_Values() []string

ExportStatus_Values returns all elements of the ExportStatus enum

func ExportType_Values added in v1.45.17 

func ExportType_Values() []string

ExportType_Values returns all elements of the ExportType enum

func ExportViewType_Values added in v1.45.17 

func ExportViewType_Values() []string

ExportViewType_Values returns all elements of the ExportViewType enum

func GlobalTableStatus_Values added in v1.34.3 

func GlobalTableStatus_Values() []string

GlobalTableStatus_Values returns all elements of the GlobalTableStatus enum

func ImportStatus_Values added in v1.44.80 

func ImportStatus_Values() []string

ImportStatus_Values returns all elements of the ImportStatus enum

func IndexStatus_Values added in v1.34.3 

func IndexStatus_Values() []string

IndexStatus_Values returns all elements of the IndexStatus enum

func InputCompressionType_Values added in v1.44.80 

func InputCompressionType_Values() []string

InputCompressionType_Values returns all elements of the InputCompressionType enum

func InputFormat_Values added in v1.44.80 

func InputFormat_Values() []string

InputFormat_Values returns all elements of the InputFormat enum

func KeyType_Values added in v1.34.3 

func KeyType_Values() []string

KeyType_Values returns all elements of the KeyType enum

func PointInTimeRecoveryStatus_Values added in v1.34.3 

func PointInTimeRecoveryStatus_Values() []string

PointInTimeRecoveryStatus_Values returns all elements of the PointInTimeRecoveryStatus enum

func ProjectionType_Values added in v1.34.3 

func ProjectionType_Values() []string

ProjectionType_Values returns all elements of the ProjectionType enum

func ReplicaStatus_Values added in v1.34.3 

func ReplicaStatus_Values() []string

ReplicaStatus_Values returns all elements of the ReplicaStatus enum

func ReturnConsumedCapacity_Values added in v1.34.3 

func ReturnConsumedCapacity_Values() []string

ReturnConsumedCapacity_Values returns all elements of the ReturnConsumedCapacity enum

func ReturnItemCollectionMetrics_Values added in v1.34.3 

func ReturnItemCollectionMetrics_Values() []string

ReturnItemCollectionMetrics_Values returns all elements of the ReturnItemCollectionMetrics enum

func ReturnValue_Values added in v1.34.3 

func ReturnValue_Values() []string

ReturnValue_Values returns all elements of the ReturnValue enum

func ReturnValuesOnConditionCheckFailure_Values added in v1.34.3 

func ReturnValuesOnConditionCheckFailure_Values() []string

ReturnValuesOnConditionCheckFailure_Values returns all elements of the ReturnValuesOnConditionCheckFailure enum

func S3SseAlgorithm_Values added in v1.35.24 

func S3SseAlgorithm_Values() []string

S3SseAlgorithm_Values returns all elements of the S3SseAlgorithm enum

func SSEStatus_Values added in v1.34.3 

func SSEStatus_Values() []string

SSEStatus_Values returns all elements of the SSEStatus enum

func SSEType_Values added in v1.34.3 

func SSEType_Values() []string

SSEType_Values returns all elements of the SSEType enum

func ScalarAttributeType_Values added in v1.34.3 

func ScalarAttributeType_Values() []string

ScalarAttributeType_Values returns all elements of the ScalarAttributeType enum

func Select_Values added in v1.34.3 

func Select_Values() []string

Select_Values returns all elements of the Select enum

func StreamViewType_Values added in v1.34.3 

func StreamViewType_Values() []string

StreamViewType_Values returns all elements of the StreamViewType enum

func TableClass_Values added in v1.42.17 

func TableClass_Values() []string

TableClass_Values returns all elements of the TableClass enum

func TableStatus_Values added in v1.34.3 

func TableStatus_Values() []string

TableStatus_Values returns all elements of the TableStatus enum

func TimeToLiveStatus_Values added in v1.34.3 

func TimeToLiveStatus_Values() []string

TimeToLiveStatus_Values returns all elements of the TimeToLiveStatus enum

Types

type ArchivalSummary added in v1.25.43 

type ArchivalSummary struct {

	// The Amazon Resource Name (ARN) of the backup the table was archived to, when
	// applicable in the archival reason. If you wish to restore this backup to
	// the same table name, you will need to delete the original table.
	ArchivalBackupArn *string `min:"37" type:"string"`

	// The date and time when table archival was initiated by DynamoDB, in UNIX
	// epoch time format.
	ArchivalDateTime *time.Time `type:"timestamp"`

	// The reason DynamoDB archived the table. Currently, the only possible value
	// is:
	//
	//    * INACCESSIBLE_ENCRYPTION_CREDENTIALS - The table was archived due to
	//    the table's KMS key being inaccessible for more than seven days. An On-Demand
	//    backup was created at the archival time.
	ArchivalReason *string `type:"string"`
	// contains filtered or unexported fields
}

Contains details of a table archival operation.

func (ArchivalSummary) GoString added in v1.25.43 

func (s ArchivalSummary) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*ArchivalSummary) SetArchivalBackupArn added in v1.25.43 

func (s *ArchivalSummary) SetArchivalBackupArn(v string) *ArchivalSummary

SetArchivalBackupArn sets the ArchivalBackupArn field's value.

func (*ArchivalSummary) SetArchivalDateTime added in v1.25.43 

func (s *ArchivalSummary) SetArchivalDateTime(v time.Time) *ArchivalSummary

SetArchivalDateTime sets the ArchivalDateTime field's value.

func (*ArchivalSummary) SetArchivalReason added in v1.25.43 

func (s *ArchivalSummary) SetArchivalReason(v string) *ArchivalSummary

SetArchivalReason sets the ArchivalReason field's value.

func (ArchivalSummary) String added in v1.25.43 

func (s ArchivalSummary) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type AttributeDefinition 

type AttributeDefinition struct {

	// A name for the attribute.
	//
	// AttributeName is a required field
	AttributeName *string `min:"1" type:"string" required:"true"`

	// The data type for the attribute, where:
	//
	//    * S - the attribute is of type String
	//
	//    * N - the attribute is of type Number
	//
	//    * B - the attribute is of type Binary
	//
	// AttributeType is a required field
	AttributeType *string `type:"string" required:"true" enum:"ScalarAttributeType"`
	// contains filtered or unexported fields
}

Represents an attribute for describing the key schema for the table and indexes.

func (AttributeDefinition) GoString added in v0.6.5 

func (s AttributeDefinition) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*AttributeDefinition) SetAttributeName added in v1.5.0 

func (s *AttributeDefinition) SetAttributeName(v string) *AttributeDefinition

SetAttributeName sets the AttributeName field's value.

func (*AttributeDefinition) SetAttributeType added in v1.5.0 

func (s *AttributeDefinition) SetAttributeType(v string) *AttributeDefinition

SetAttributeType sets the AttributeType field's value.

func (AttributeDefinition) String added in v0.6.5 

func (s AttributeDefinition) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*AttributeDefinition) Validate added in v1.1.21 

func (s *AttributeDefinition) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type AttributeValue 

type AttributeValue struct {

	// An attribute of type Binary. For example:
	//
	// "B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"
	// B is automatically base64 encoded/decoded by the SDK.
	B []byte `type:"blob"`

	// An attribute of type Boolean. For example:
	//
	// "BOOL": true
	BOOL *bool `type:"boolean"`

	// An attribute of type Binary Set. For example:
	//
	// "BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]
	BS [][]byte `type:"list"`

	// An attribute of type List. For example:
	//
	// "L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]
	L []*AttributeValue `type:"list"`

	// An attribute of type Map. For example:
	//
	// "M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}
	M map[string]*AttributeValue `type:"map"`

	// 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.
	N *string `type:"string"`

	// 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.
	NS []*string `type:"list"`

	// An attribute of type Null. For example:
	//
	// "NULL": true
	NULL *bool `type:"boolean"`

	// An attribute of type String. For example:
	//
	// "S": "Hello"
	S *string `type:"string"`

	// An attribute of type String Set. For example:
	//
	// "SS": ["Giraffe", "Hippo" ,"Zebra"]
	SS []*string `type:"list"`
	// contains filtered or unexported fields
}

Represents the data for an attribute.

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 (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html#HowItWorks.DataTypes) in the Amazon DynamoDB Developer Guide.

func (AttributeValue) GoString added in v0.6.5 

func (s AttributeValue) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*AttributeValue) SetB added in v1.5.0 

func (s *AttributeValue) SetB(v []byte) *AttributeValue

SetB sets the B field's value.

func (*AttributeValue) SetBOOL added in v1.5.0 

func (s *AttributeValue) SetBOOL(v bool) *AttributeValue

SetBOOL sets the BOOL field's value.

func (*AttributeValue) SetBS added in v1.5.0 

func (s *AttributeValue) SetBS(v [][]byte) *AttributeValue

SetBS sets the BS field's value.

func (*AttributeValue) SetL added in v1.5.0 

func (s *AttributeValue) SetL(v []*AttributeValue) *AttributeValue

SetL sets the L field's value.

func (*AttributeValue) SetM added in v1.5.0 

func (s *AttributeValue) SetM(v map[string]*AttributeValue) *AttributeValue

SetM sets the M field's value.

func (*AttributeValue) SetN added in v1.5.0 

func (s *AttributeValue) SetN(v string) *AttributeValue

SetN sets the N field's value.

func (*AttributeValue) SetNS added in v1.5.0 

func (s *AttributeValue) SetNS(v []*string) *AttributeValue

SetNS sets the NS field's value.

func (*AttributeValue) SetNULL added in v1.5.0 

func (s *AttributeValue) SetNULL(v bool) *AttributeValue

SetNULL sets the NULL field's value.

func (*AttributeValue) SetS added in v1.5.0 

func (s *AttributeValue) SetS(v string) *AttributeValue

SetS sets the S field's value.

func (*AttributeValue) SetSS added in v1.5.0 

func (s *AttributeValue) SetSS(v []*string) *AttributeValue

SetSS sets the SS field's value.

func (AttributeValue) String added in v0.6.5 

func (s AttributeValue) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type AttributeValueUpdate 

type AttributeValueUpdate struct {

	// 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.
	//
	// If an item with the specified Key is found in the table:
	//
	//    * PUT - Adds the specified attribute to the item. If the attribute already
	//    exists, it is replaced by the new value.
	//
	//    * 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. If a set of values is specified, then those values
	//    are subtracted from the 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.
	//
	//    * 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: 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. 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. In addition,
	//    if you use ADD to update an existing item, and intend to increment 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. Both sets must have the same primitive
	//    data type. For example, if the existing 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. 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.
	//
	// If no item with the specified Key is found:
	//
	//    * PUT - DynamoDB creates a new item with the specified primary key, and
	//    then adds the attribute.
	//
	//    * DELETE - Nothing happens; there is no attribute to delete.
	//
	//    * ADD - DynamoDB creates a new item with the supplied primary key and
	//    number (or set) for the attribute value. The only data types allowed are
	//    number, number set, string set or binary set.
	Action *string `type:"string" enum:"AttributeAction"`

	// Represents the data for an attribute.
	//
	// 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 (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html#HowItWorks.DataTypes)
	// in the Amazon DynamoDB Developer Guide.
	Value *AttributeValue `type:"structure"`
	// contains filtered or unexported fields
}

For the UpdateItem operation, represents the attributes to be modified, the action to perform on each, and the new value for each.

You cannot use UpdateItem to update any primary key attributes. Instead, you will need to delete the item, and then use PutItem to create a new item with new attributes.

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.

func (AttributeValueUpdate) GoString added in v0.6.5 

func (s AttributeValueUpdate) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*AttributeValueUpdate) SetAction added in v1.5.0 

func (s *AttributeValueUpdate) SetAction(v string) *AttributeValueUpdate

SetAction sets the Action field's value.

func (*AttributeValueUpdate) SetValue added in v1.5.0 

func (s *AttributeValueUpdate) SetValue(v *AttributeValue) *AttributeValueUpdate

SetValue sets the Value field's value.

func (AttributeValueUpdate) String added in v0.6.5 

func (s AttributeValueUpdate) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type AutoScalingPolicyDescription added in v1.14.32 

type AutoScalingPolicyDescription struct {

	// The name of the scaling policy.
	PolicyName *string `min:"1" type:"string"`

	// Represents a target tracking scaling policy configuration.
	TargetTrackingScalingPolicyConfiguration *AutoScalingTargetTrackingScalingPolicyConfigurationDescription `type:"structure"`
	// contains filtered or unexported fields
}

Represents the properties of the scaling policy.

func (AutoScalingPolicyDescription) GoString added in v1.14.32 

func (s