dynamodb

package
v1.55.6 Latest Latest
Warning

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

Go to latest
Published: Jan 15, 2025 License: Apache-2.0 Imports: 19 Imported by: 4,573

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 (
	// ApproximateCreationDateTimePrecisionMillisecond is a ApproximateCreationDateTimePrecision enum value
	ApproximateCreationDateTimePrecisionMillisecond = "MILLISECOND"

	// ApproximateCreationDateTimePrecisionMicrosecond is a ApproximateCreationDateTimePrecision enum value
	ApproximateCreationDateTimePrecisionMicrosecond = "MICROSECOND"
)
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"

	// DestinationStatusUpdating is a DestinationStatus enum value
	DestinationStatusUpdating = "UPDATING"
)
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"

	// ErrCodePolicyNotFoundException for service response error code
	// "PolicyNotFoundException".
	//
	// The operation tried to access a nonexistent resource-based policy.
	//
	// If you specified an ExpectedRevisionId, it's possible that a policy is present
	// for the resource but its revision ID didn't match the expected value.
	ErrCodePolicyNotFoundException = "PolicyNotFoundException"

	// 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.
	//
	//    * There is an ongoing TransactWriteItems operation that conflicts with
	//    a concurrent TransactWriteItems request. In this case the TransactWriteItems
	//    operation fails with a TransactionCanceledException.
	//
	// 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 ApproximateCreationDateTimePrecision_Values added in v1.50.0

func ApproximateCreationDateTimePrecision_Values() []string

ApproximateCreationDateTimePrecision_Values returns all elements of the ApproximateCreationDateTimePrecision enum

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