package types
import "github.com/aws/aws-sdk-go-v2/service/dynamodb/types"
Index ¶
- type ArchivalSummary
- type AttributeAction
- type AttributeDefinition
- type AttributeValue
- type AttributeValueUpdate
- type AutoScalingPolicyDescription
- type AutoScalingPolicyUpdate
- type AutoScalingSettingsDescription
- type AutoScalingSettingsUpdate
- type AutoScalingTargetTrackingScalingPolicyConfigurationDescription
- type AutoScalingTargetTrackingScalingPolicyConfigurationUpdate
- type BackupDescription
- type BackupDetails
- type BackupInUseException
- func (e *BackupInUseException) Error() string
- func (e *BackupInUseException) ErrorCode() string
- func (e *BackupInUseException) ErrorFault() smithy.ErrorFault
- func (e *BackupInUseException) ErrorMessage() string
- type BackupNotFoundException
- func (e *BackupNotFoundException) Error() string
- func (e *BackupNotFoundException) ErrorCode() string
- func (e *BackupNotFoundException) ErrorFault() smithy.ErrorFault
- func (e *BackupNotFoundException) ErrorMessage() string
- type BackupStatus
- type BackupSummary
- type BackupType
- type BackupTypeFilter
- type BillingMode
- type BillingModeSummary
- type CancellationReason
- type Capacity
- type ComparisonOperator
- type Condition
- type ConditionCheck
- type ConditionalCheckFailedException
- func (e *ConditionalCheckFailedException) Error() string
- func (e *ConditionalCheckFailedException) ErrorCode() string
- func (e *ConditionalCheckFailedException) ErrorFault() smithy.ErrorFault
- func (e *ConditionalCheckFailedException) ErrorMessage() string
- type ConditionalOperator
- type ConsumedCapacity
- type ContinuousBackupsDescription
- type ContinuousBackupsStatus
- type ContinuousBackupsUnavailableException
- func (e *ContinuousBackupsUnavailableException) Error() string
- func (e *ContinuousBackupsUnavailableException) ErrorCode() string
- func (e *ContinuousBackupsUnavailableException) ErrorFault() smithy.ErrorFault
- func (e *ContinuousBackupsUnavailableException) ErrorMessage() string
- type ContributorInsightsAction
- type ContributorInsightsStatus
- type ContributorInsightsSummary
- type CreateGlobalSecondaryIndexAction
- type CreateReplicaAction
- type CreateReplicationGroupMemberAction
- type Delete
- type DeleteGlobalSecondaryIndexAction
- type DeleteReplicaAction
- type DeleteReplicationGroupMemberAction
- type DeleteRequest
- type Endpoint
- type ExpectedAttributeValue
- type FailureException
- type Get
- type GlobalSecondaryIndex
- type GlobalSecondaryIndexAutoScalingUpdate
- type GlobalSecondaryIndexDescription
- type GlobalSecondaryIndexInfo
- type GlobalSecondaryIndexUpdate
- type GlobalTable
- type GlobalTableAlreadyExistsException
- func (e *GlobalTableAlreadyExistsException) Error() string
- func (e *GlobalTableAlreadyExistsException) ErrorCode() string
- func (e *GlobalTableAlreadyExistsException) ErrorFault() smithy.ErrorFault
- func (e *GlobalTableAlreadyExistsException) ErrorMessage() string
- type GlobalTableDescription
- type GlobalTableGlobalSecondaryIndexSettingsUpdate
- type GlobalTableNotFoundException
- func (e *GlobalTableNotFoundException) Error() string
- func (e *GlobalTableNotFoundException) ErrorCode() string
- func (e *GlobalTableNotFoundException) ErrorFault() smithy.ErrorFault
- func (e *GlobalTableNotFoundException) ErrorMessage() string
- type GlobalTableStatus
- type IdempotentParameterMismatchException
- func (e *IdempotentParameterMismatchException) Error() string
- func (e *IdempotentParameterMismatchException) ErrorCode() string
- func (e *IdempotentParameterMismatchException) ErrorFault() smithy.ErrorFault
- func (e *IdempotentParameterMismatchException) ErrorMessage() string
- type IndexNotFoundException
- func (e *IndexNotFoundException) Error() string
- func (e *IndexNotFoundException) ErrorCode() string
- func (e *IndexNotFoundException) ErrorFault() smithy.ErrorFault
- func (e *IndexNotFoundException) ErrorMessage() string
- type IndexStatus
- type InternalServerError
- func (e *InternalServerError) Error() string
- func (e *InternalServerError) ErrorCode() string
- func (e *InternalServerError) ErrorFault() smithy.ErrorFault
- func (e *InternalServerError) ErrorMessage() string
- type InvalidEndpointException
- func (e *InvalidEndpointException) Error() string
- func (e *InvalidEndpointException) ErrorCode() string
- func (e *InvalidEndpointException) ErrorFault() smithy.ErrorFault
- func (e *InvalidEndpointException) ErrorMessage() string
- type InvalidRestoreTimeException
- func (e *InvalidRestoreTimeException) Error() string
- func (e *InvalidRestoreTimeException) ErrorCode() string
- func (e *InvalidRestoreTimeException) ErrorFault() smithy.ErrorFault
- func (e *InvalidRestoreTimeException) ErrorMessage() string
- type ItemCollectionMetrics
- type ItemCollectionSizeLimitExceededException
- func (e *ItemCollectionSizeLimitExceededException) Error() string
- func (e *ItemCollectionSizeLimitExceededException) ErrorCode() string
- func (e *ItemCollectionSizeLimitExceededException) ErrorFault() smithy.ErrorFault
- func (e *ItemCollectionSizeLimitExceededException) ErrorMessage() string
- type ItemResponse
- type KeySchemaElement
- type KeyType
- type KeysAndAttributes
- type LimitExceededException
- func (e *LimitExceededException) Error() string
- func (e *LimitExceededException) ErrorCode() string
- func (e *LimitExceededException) ErrorFault() smithy.ErrorFault
- func (e *LimitExceededException) ErrorMessage() string
- type LocalSecondaryIndex
- type LocalSecondaryIndexDescription
- type LocalSecondaryIndexInfo
- type PointInTimeRecoveryDescription
- type PointInTimeRecoverySpecification
- type PointInTimeRecoveryStatus
- type PointInTimeRecoveryUnavailableException
- func (e *PointInTimeRecoveryUnavailableException) Error() string
- func (e *PointInTimeRecoveryUnavailableException) ErrorCode() string
- func (e *PointInTimeRecoveryUnavailableException) ErrorFault() smithy.ErrorFault
- func (e *PointInTimeRecoveryUnavailableException) ErrorMessage() string
- type Projection
- type ProjectionType
- type ProvisionedThroughput
- type ProvisionedThroughputDescription
- type ProvisionedThroughputExceededException
- func (e *ProvisionedThroughputExceededException) Error() string
- func (e *ProvisionedThroughputExceededException) ErrorCode() string
- func (e *ProvisionedThroughputExceededException) ErrorFault() smithy.ErrorFault
- func (e *ProvisionedThroughputExceededException) ErrorMessage() string
- type ProvisionedThroughputOverride
- type Put
- type PutRequest
- type Replica
- type ReplicaAlreadyExistsException
- func (e *ReplicaAlreadyExistsException) Error() string
- func (e *ReplicaAlreadyExistsException) ErrorCode() string
- func (e *ReplicaAlreadyExistsException) ErrorFault() smithy.ErrorFault
- func (e *ReplicaAlreadyExistsException) ErrorMessage() string
- type ReplicaAutoScalingDescription
- type ReplicaAutoScalingUpdate
- type ReplicaDescription
- type ReplicaGlobalSecondaryIndex
- type ReplicaGlobalSecondaryIndexAutoScalingDescription
- type ReplicaGlobalSecondaryIndexAutoScalingUpdate
- type ReplicaGlobalSecondaryIndexDescription
- type ReplicaGlobalSecondaryIndexSettingsDescription
- type ReplicaGlobalSecondaryIndexSettingsUpdate
- type ReplicaNotFoundException
- func (e *ReplicaNotFoundException) Error() string
- func (e *ReplicaNotFoundException) ErrorCode() string
- func (e *ReplicaNotFoundException) ErrorFault() smithy.ErrorFault
- func (e *ReplicaNotFoundException) ErrorMessage() string
- type ReplicaSettingsDescription
- type ReplicaSettingsUpdate
- type ReplicaStatus
- type ReplicaUpdate
- type ReplicationGroupUpdate
- type RequestLimitExceeded
- func (e *RequestLimitExceeded) Error() string
- func (e *RequestLimitExceeded) ErrorCode() string
- func (e *RequestLimitExceeded) ErrorFault() smithy.ErrorFault
- func (e *RequestLimitExceeded) ErrorMessage() string
- type ResourceInUseException
- func (e *ResourceInUseException) Error() string
- func (e *ResourceInUseException) ErrorCode() string
- func (e *ResourceInUseException) ErrorFault() smithy.ErrorFault
- func (e *ResourceInUseException) ErrorMessage() string
- type ResourceNotFoundException
- func (e *ResourceNotFoundException) Error() string
- func (e *ResourceNotFoundException) ErrorCode() string
- func (e *ResourceNotFoundException) ErrorFault() smithy.ErrorFault
- func (e *ResourceNotFoundException) ErrorMessage() string
- type RestoreSummary
- type ReturnConsumedCapacity
- type ReturnItemCollectionMetrics
- type ReturnValue
- type ReturnValuesOnConditionCheckFailure
- type SSEDescription
- type SSESpecification
- type SSEStatus
- type SSEType
- type ScalarAttributeType
- type Select
- type SourceTableDetails
- type SourceTableFeatureDetails
- type StreamSpecification
- type StreamViewType
- type TableAlreadyExistsException
- func (e *TableAlreadyExistsException) Error() string
- func (e *TableAlreadyExistsException) ErrorCode() string
- func (e *TableAlreadyExistsException) ErrorFault() smithy.ErrorFault
- func (e *TableAlreadyExistsException) ErrorMessage() string
- type TableAutoScalingDescription
- type TableDescription
- type TableInUseException
- func (e *TableInUseException) Error() string
- func (e *TableInUseException) ErrorCode() string
- func (e *TableInUseException) ErrorFault() smithy.ErrorFault
- func (e *TableInUseException) ErrorMessage() string
- type TableNotFoundException
- func (e *TableNotFoundException) Error() string
- func (e *TableNotFoundException) ErrorCode() string
- func (e *TableNotFoundException) ErrorFault() smithy.ErrorFault
- func (e *TableNotFoundException) ErrorMessage() string
- type TableStatus
- type Tag
- type TimeToLiveDescription
- type TimeToLiveSpecification
- type TimeToLiveStatus
- type TransactGetItem
- type TransactWriteItem
- type TransactionCanceledException
- func (e *TransactionCanceledException) Error() string
- func (e *TransactionCanceledException) ErrorCode() string
- func (e *TransactionCanceledException) ErrorFault() smithy.ErrorFault
- func (e *TransactionCanceledException) ErrorMessage() string
- type TransactionConflictException
- func (e *TransactionConflictException) Error() string
- func (e *TransactionConflictException) ErrorCode() string
- func (e *TransactionConflictException) ErrorFault() smithy.ErrorFault
- func (e *TransactionConflictException) ErrorMessage() string
- type TransactionInProgressException
- func (e *TransactionInProgressException) Error() string
- func (e *TransactionInProgressException) ErrorCode() string
- func (e *TransactionInProgressException) ErrorFault() smithy.ErrorFault
- func (e *TransactionInProgressException) ErrorMessage() string
- type Update
- type UpdateGlobalSecondaryIndexAction
- type UpdateReplicationGroupMemberAction
- type WriteRequest
Types ¶
type ArchivalSummary ¶
type ArchivalSummary struct { // The reason DynamoDB archived the table. Currently, the only possible value is: // <ul> <li> <p> <code>INACCESSIBLE_ENCRYPTION_CREDENTIALS</code> - The table was // archived due to the table's AWS KMS key being inaccessible for more than seven // days. An On-Demand backup was created at the archival time.</p> </li> </ul> ArchivalReason *string // 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 // The date and time when table archival was initiated by DynamoDB, in UNIX epoch // time format. ArchivalDateTime *time.Time }
Contains details of a table archival operation.
type AttributeAction ¶
type AttributeAction string
const ( AttributeActionAdd AttributeAction = "ADD" AttributeActionPut AttributeAction = "PUT" AttributeActionDelete AttributeAction = "DELETE" )
Enum values for AttributeAction
type AttributeDefinition ¶
type AttributeDefinition struct { // 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 // // This member is required. AttributeType ScalarAttributeType // A name for the attribute. // // This member is required. AttributeName *string }
Represents an attribute for describing the key schema for the table and indexes.
type AttributeValue ¶
type AttributeValue struct { // An attribute of type Boolean. For example: "BOOL": true BOOL *bool // 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 // An attribute of type Binary Set. For example: "BS": ["U3Vubnk=", "UmFpbnk=", // "U25vd3k="] BS [][]byte // An attribute of type Null. For example: "NULL": true NULL *bool // An attribute of type String Set. For example: "SS": ["Giraffe", "Hippo" // ,"Zebra"] SS []*string // An attribute of type String. For example: "S": "Hello" S *string // An attribute of type Binary. For example: "B": // "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk" B []byte // An attribute of type Map. For example: "M": {"Name": {"S": "Joe"}, "Age": {"N": // "35"}} M map[string]*AttributeValue // An attribute of type List. For example: "L": [ {"S": "Cookies"} , {"S": // "Coffee"}, {"N", "3.14159"}] L []*AttributeValue // 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 }
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.
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. <p> <b>If an item with the specified <i>Key</i> is found in the // table:</b> </p> <ul> <li> <p> <code>PUT</code> - Adds the specified attribute to // the item. If the attribute already exists, it is replaced by the new value. </p> // </li> <li> <p> <code>DELETE</code> - 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.</p> <p>If a <i>set</i> of values is // specified, then those values are subtracted from the old set. For example, if // the attribute value was the set <code>[a,b,c]</code> and the <code>DELETE</code> // action specified <code>[a,c]</code>, then the final attribute value would be // <code>[b]</code>. Specifying an empty set is an error.</p> </li> <li> <p> // <code>ADD</code> - 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 <code>ADD</code> depends on the data type of the attribute:</p> <ul> // <li> <p>If the existing attribute is a number, and if <code>Value</code> is also // a number, then the <code>Value</code> is mathematically added to the existing // attribute. If <code>Value</code> is a negative number, then it is subtracted // from the existing attribute.</p> <note> <p> If you use <code>ADD</code> to // increment or decrement a number value for an item that doesn't exist before the // update, DynamoDB uses 0 as the initial value.</p> <p>In addition, if you use // <code>ADD</code> to update an existing item, and intend to increment or // decrement an attribute value which does not yet exist, DynamoDB uses // <code>0</code> as the initial value. For example, suppose that the item you want // to update does not yet have an attribute named <i>itemcount</i>, but you decide // to <code>ADD</code> the number <code>3</code> to this attribute anyway, even // though it currently does not exist. DynamoDB will create the <i>itemcount</i> // attribute, set its initial value to <code>0</code>, and finally add // <code>3</code> to it. The result will be a new <i>itemcount</i> attribute in the // item, with a value of <code>3</code>.</p> </note> </li> <li> <p>If the existing // data type is a set, and if the <code>Value</code> is also a set, then the // <code>Value</code> is added to the existing set. (This is a <i>set</i> // operation, not mathematical addition.) For example, if the attribute value was // the set <code>[1,2]</code>, and the <code>ADD</code> action specified // <code>[3]</code>, then the final attribute value would be <code>[1,2,3]</code>. // 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. </p> <p>Both sets // must have the same primitive data type. For example, if the existing data type // is a set of strings, the <code>Value</code> must also be a set of strings. The // same holds true for number sets and binary sets.</p> </li> </ul> <p>This action // is only valid for an existing attribute whose data type is number or is a set. // Do not use <code>ADD</code> for any other data types.</p> </li> </ul> <p> <b>If // no item with the specified <i>Key</i> is found:</b> </p> <ul> <li> <p> // <code>PUT</code> - DynamoDB creates a new item with the specified primary key, // and then adds the attribute. </p> </li> <li> <p> <code>DELETE</code> - Nothing // happens; there is no attribute to delete.</p> </li> <li> <p> <code>ADD</code> - // DynamoDB creates an item with the supplied primary key and number (or set of // numbers) for the attribute value. The only data types allowed are number and // number set; no other data types can be specified.</p> </li> </ul> Action 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 }
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.
type AutoScalingPolicyDescription ¶
type AutoScalingPolicyDescription struct { // The name of the scaling policy. PolicyName *string // Represents a target tracking scaling policy configuration. TargetTrackingScalingPolicyConfiguration *AutoScalingTargetTrackingScalingPolicyConfigurationDescription }
Represents the properties of the scaling policy.
type AutoScalingPolicyUpdate ¶
type AutoScalingPolicyUpdate struct { // The name of the scaling policy. PolicyName *string // Represents a target tracking scaling policy configuration. // // This member is required. TargetTrackingScalingPolicyConfiguration *AutoScalingTargetTrackingScalingPolicyConfigurationUpdate }
Represents the auto scaling policy to be modified.
type AutoScalingSettingsDescription ¶
type AutoScalingSettingsDescription struct { // Information about the scaling policies. ScalingPolicies []*AutoScalingPolicyDescription // The maximum capacity units that a global table or global secondary index should // be scaled up to. MaximumUnits *int64 // The minimum capacity units that a global table or global secondary index should // be scaled down to. MinimumUnits *int64 // Disabled auto scaling for this global table or global secondary index. AutoScalingDisabled *bool // Role ARN used for configuring the auto scaling policy. AutoScalingRoleArn *string }
Represents the auto scaling settings for a global table or global secondary index.
type AutoScalingSettingsUpdate ¶
type AutoScalingSettingsUpdate struct { // Disabled auto scaling for this global table or global secondary index. AutoScalingDisabled *bool // The minimum capacity units that a global table or global secondary index should // be scaled down to. MinimumUnits *int64 // The scaling policy to apply for scaling target global table or global secondary // index capacity units. ScalingPolicyUpdate *AutoScalingPolicyUpdate // The maximum capacity units that a global table or global secondary index should // be scaled up to. MaximumUnits *int64 // Role ARN used for configuring auto scaling policy. AutoScalingRoleArn *string }
Represents the auto scaling settings to be modified for a global table or global secondary index.
type AutoScalingTargetTrackingScalingPolicyConfigurationDescription ¶
type AutoScalingTargetTrackingScalingPolicyConfigurationDescription struct { // The amount of time, in seconds, after a scale out activity completes before // another scale out activity can start. While the cooldown period is in effect, // the capacity that has been added by the previous scale out event that initiated // the cooldown is calculated as part of the desired capacity for the next scale // out. You should continuously (but not excessively) scale out. ScaleOutCooldown *int32 // The amount of time, in seconds, after a scale in activity completes before // another scale in activity can start. The cooldown period is used to block // subsequent scale in requests until it has expired. You should scale in // conservatively to protect your application's availability. However, if another // alarm triggers a scale out policy during the cooldown period after a scale-in, // application auto scaling scales out your scalable target immediately. ScaleInCooldown *int32 // Indicates whether scale in by the target tracking policy is disabled. If the // value is true, scale in is disabled and the target tracking policy won't remove // capacity from the scalable resource. Otherwise, scale in is enabled and the // target tracking policy can remove capacity from the scalable resource. The // default value is false. DisableScaleIn *bool // The target value for the metric. The range is 8.515920e-109 to 1.174271e+108 // (Base 10) or 2e-360 to 2e360 (Base 2). // // This member is required. TargetValue *float64 }
Represents the properties of a target tracking scaling policy.
type AutoScalingTargetTrackingScalingPolicyConfigurationUpdate ¶
type AutoScalingTargetTrackingScalingPolicyConfigurationUpdate struct { // The amount of time, in seconds, after a scale out activity completes before // another scale out activity can start. While the cooldown period is in effect, // the capacity that has been added by the previous scale out event that initiated // the cooldown is calculated as part of the desired capacity for the next scale // out. You should continuously (but not excessively) scale out. ScaleOutCooldown *int32 // The amount of time, in seconds, after a scale in activity completes before // another scale in activity can start. The cooldown period is used to block // subsequent scale in requests until it has expired. You should scale in // conservatively to protect your application's availability. However, if another // alarm triggers a scale out policy during the cooldown period after a scale-in, // application auto scaling scales out your scalable target immediately. ScaleInCooldown *int32 // Indicates whether scale in by the target tracking policy is disabled. If the // value is true, scale in is disabled and the target tracking policy won't remove // capacity from the scalable resource. Otherwise, scale in is enabled and the // target tracking policy can remove capacity from the scalable resource. The // default value is false. DisableScaleIn *bool // The target value for the metric. The range is 8.515920e-109 to 1.174271e+108 // (Base 10) or 2e-360 to 2e360 (Base 2). // // This member is required. TargetValue *float64 }
Represents the settings of a target tracking scaling policy that will be modified.
type BackupDescription ¶
type BackupDescription struct { // Contains the details of the features enabled on the table when the backup was // created. For example, LSIs, GSIs, streams, TTL. SourceTableFeatureDetails *SourceTableFeatureDetails // Contains the details of the table when the backup was created. SourceTableDetails *SourceTableDetails // Contains the details of the backup created for the table. BackupDetails *BackupDetails }
Contains the description of the backup created for the table.
type BackupDetails ¶
type BackupDetails struct { // Backup can be in one of the following states: CREATING, ACTIVE, DELETED. // // This member is required. BackupStatus BackupStatus // Time at which the backup was created. This is the request time of the backup. // // This member is required. BackupCreationDateTime *time.Time // Time at which the automatic on-demand backup created by DynamoDB will expire. // This SYSTEM on-demand backup expires automatically 35 days after its creation. BackupExpiryDateTime *time.Time // BackupType: // // * USER - You create and manage these using the on-demand backup // feature. // // * SYSTEM - If you delete a table with point-in-time recovery // enabled, a SYSTEM backup is automatically created and is retained for 35 days // (at no additional cost). System backups allow you to restore the deleted table // to the state it was in just before the point of deletion. // // * AWS_BACKUP - // On-demand backup created by you from AWS Backup service. // // This member is required. BackupType BackupType // Name of the requested backup. // // This member is required. BackupName *string // ARN associated with the backup. // // This member is required. BackupArn *string // Size of the backup in bytes. BackupSizeBytes *int64 }
Contains the details of the backup created for the table.
type BackupInUseException ¶
type BackupInUseException struct { Message *string }
There is another ongoing conflicting backup control plane operation on the table. The backup is either being created, deleted or restored to a table.
func (*BackupInUseException) Error ¶
func (e *BackupInUseException) Error() string
func (*BackupInUseException) ErrorCode ¶
func (e *BackupInUseException) ErrorCode() string
func (*BackupInUseException) ErrorFault ¶
func (e *BackupInUseException) ErrorFault() smithy.ErrorFault
func (*BackupInUseException) ErrorMessage ¶
func (e *BackupInUseException) ErrorMessage() string
type BackupNotFoundException ¶
type BackupNotFoundException struct { Message *string }
Backup not found for the given BackupARN.
func (*BackupNotFoundException) Error ¶
func (e *BackupNotFoundException) Error() string
func (*BackupNotFoundException) ErrorCode ¶
func (e *BackupNotFoundException) ErrorCode() string
func (*BackupNotFoundException) ErrorFault ¶
func (e *BackupNotFoundException) ErrorFault() smithy.ErrorFault
func (*BackupNotFoundException) ErrorMessage ¶
func (e *BackupNotFoundException) ErrorMessage() string
type BackupStatus ¶
type BackupStatus string
const ( BackupStatusCreating BackupStatus = "CREATING" BackupStatusDeleted BackupStatus = "DELETED" BackupStatusAvailable BackupStatus = "AVAILABLE" )
Enum values for BackupStatus
type BackupSummary ¶
type BackupSummary struct { // Name of the specified backup. BackupName *string // Time at which the automatic on-demand backup created by DynamoDB will expire. // This SYSTEM on-demand backup expires automatically 35 days after its creation. BackupExpiryDateTime *time.Time // ARN associated with the backup. BackupArn *string // Name of the table. TableName *string // Unique identifier for the table. TableId *string // ARN associated with the table. TableArn *string // BackupType: // // * USER - You create and manage these using the on-demand backup // feature. // // * SYSTEM - If you delete a table with point-in-time recovery // enabled, a SYSTEM backup is automatically created and is retained for 35 days // (at no additional cost). System backups allow you to restore the deleted table // to the state it was in just before the point of deletion. // // * AWS_BACKUP - // On-demand backup created by you from AWS Backup service. BackupType BackupType // Backup can be in one of the following states: CREATING, ACTIVE, DELETED. BackupStatus BackupStatus // Time at which the backup was created. BackupCreationDateTime *time.Time // Size of the backup in bytes. BackupSizeBytes *int64 }
Contains details for the backup.
type BackupType ¶
type BackupType string
const ( BackupTypeUser BackupType = "USER" BackupTypeSystem BackupType = "SYSTEM" BackupTypeAws_backup BackupType = "AWS_BACKUP" )
Enum values for BackupType
type BackupTypeFilter ¶
type BackupTypeFilter string
const ( BackupTypeFilterUser BackupTypeFilter = "USER" BackupTypeFilterSystem BackupTypeFilter = "SYSTEM" BackupTypeFilterAws_backup BackupTypeFilter = "AWS_BACKUP" BackupTypeFilterAll BackupTypeFilter = "ALL" )
Enum values for BackupTypeFilter
type BillingMode ¶
type BillingMode string
const ( BillingModeProvisioned BillingMode = "PROVISIONED" BillingModePay_per_request BillingMode = "PAY_PER_REQUEST" )
Enum values for BillingMode
type BillingModeSummary ¶
type BillingModeSummary struct { // Represents the time when PAY_PER_REQUEST was last set as the read/write capacity // mode. LastUpdateToPayPerRequestDateTime *time.Time // Controls how you are charged for read and write throughput and how you manage // capacity. This setting can be changed later. // // * PROVISIONED - Sets the // read/write capacity mode to PROVISIONED. We recommend using PROVISIONED for // predictable workloads. // // * PAY_PER_REQUEST - Sets the read/write capacity // mode to PAY_PER_REQUEST. We recommend using PAY_PER_REQUEST for unpredictable // workloads. BillingMode BillingMode }
Contains the details for the read/write capacity mode.
type CancellationReason ¶
type CancellationReason struct { // Cancellation reason message description. Message *string // Item in the request which caused the transaction to get cancelled. Item map[string]*AttributeValue // Status code for the result of the cancelled transaction. Code *string }
An ordered list of errors for each item in the request which caused the transaction to get cancelled. The values of the list are ordered according to the ordering of the TransactWriteItems request parameter. If no error occurred for the associated item an error with a Null code and Null message will be present.
type Capacity ¶
type Capacity struct { // The total number of capacity units consumed on a table or an index. CapacityUnits *float64 // The total number of write capacity units consumed on a table or an index. WriteCapacityUnits *float64 // The total number of read capacity units consumed on a table or an index. ReadCapacityUnits *float64 }
Represents the amount of provisioned throughput capacity consumed on a table or an index.
type ComparisonOperator ¶
type ComparisonOperator string
const ( ComparisonOperatorEq ComparisonOperator = "EQ" ComparisonOperatorNe ComparisonOperator = "NE" ComparisonOperatorIn ComparisonOperator = "IN" ComparisonOperatorLe ComparisonOperator = "LE" ComparisonOperatorLt ComparisonOperator = "LT" ComparisonOperatorGe ComparisonOperator = "GE" ComparisonOperatorGt ComparisonOperator = "GT" ComparisonOperatorBetween ComparisonOperator = "BETWEEN" ComparisonOperatorNot_null ComparisonOperator = "NOT_NULL" ComparisonOperatorNull ComparisonOperator = "NULL" ComparisonOperatorContains ComparisonOperator = "CONTAINS" ComparisonOperatorNot_contains ComparisonOperator = "NOT_CONTAINS" ComparisonOperatorBegins_with ComparisonOperator = "BEGINS_WITH" )
Enum values for ComparisonOperator
type Condition ¶
type Condition struct { // One or more values to evaluate against the supplied attribute. The number of // values in the list depends on the ComparisonOperator being used. For type // Number, value comparisons are numeric. String value comparisons for greater // than, equals, or less than are based on ASCII character code values. For // example, a is greater than A, and a is greater than B. For a list of code // values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters // (http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters). For Binary, // DynamoDB treats each byte of the binary data as unsigned when it compares binary // values. AttributeValueList []*AttributeValue // A comparator for evaluating attributes. For example, equals, greater than, less // than, etc. The following comparison operators are available: EQ | NE | LE | LT | // GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN // The following are descriptions of each comparison operator. // // * EQ : Equal. // EQ is supported for all data types, including lists and maps. AttributeValueList // can contain only one AttributeValue element of type String, Number, Binary, // String Set, Number Set, or Binary Set. If an item contains an AttributeValue // element of a different type than the one provided in the request, the value does // not match. For example, {"S":"6"} does not equal {"N":"6"}. Also, {"N":"6"} does // not equal {"NS":["6", "2", "1"]}. // // * NE : Not equal. NE is supported for all // data types, including lists and maps. AttributeValueList can contain only one // AttributeValue of type String, Number, Binary, String Set, Number Set, or Binary // Set. If an item contains an AttributeValue of a different type than the one // provided in the request, the value does not match. For example, {"S":"6"} does // not equal {"N":"6"}. Also, {"N":"6"} does not equal {"NS":["6", "2", "1"]}. // // // * LE : Less than or equal. AttributeValueList can contain only one // AttributeValue element of type String, Number, or Binary (not a set type). If an // item contains an AttributeValue element of a different type than the one // provided in the request, the value does not match. For example, {"S":"6"} does // not equal {"N":"6"}. Also, {"N":"6"} does not compare to {"NS":["6", "2", // "1"]}. // // * LT : Less than. AttributeValueList can contain only one // AttributeValue of type String, Number, or Binary (not a set type). If an item // contains an AttributeValue element of a different type than the one provided in // the request, the value does not match. For example, {"S":"6"} does not equal // {"N":"6"}. Also, {"N":"6"} does not compare to {"NS":["6", "2", "1"]}. // // * GE // : Greater than or equal. AttributeValueList can contain only one AttributeValue // element of type String, Number, or Binary (not a set type). If an item contains // an AttributeValue element of a different type than the one provided in the // request, the value does not match. For example, {"S":"6"} does not equal // {"N":"6"}. Also, {"N":"6"} does not compare to {"NS":["6", "2", "1"]}. // // * GT // : Greater than. AttributeValueList can contain only one AttributeValue element // of type String, Number, or Binary (not a set type). If an item contains an // AttributeValue element of a different type than the one provided in the request, // the value does not match. For example, {"S":"6"} does not equal {"N":"6"}. Also, // {"N":"6"} does not compare to {"NS":["6", "2", "1"]}. // // * NOT_NULL : The // attribute exists. NOT_NULL is supported for all data types, including lists and // maps. This operator tests for the existence of an attribute, not its data type. // If the data type of attribute "a" is null, and you evaluate it using NOT_NULL, // the result is a Boolean true. This result is because the attribute "a" exists; // its data type is not relevant to the NOT_NULL comparison operator. // // * NULL : // The attribute does not exist. NULL is supported for all data types, including // lists and maps. This operator tests for the nonexistence of an attribute, not // its data type. If the data type of attribute "a" is null, and you evaluate it // using NULL, the result is a Boolean false. This is because the attribute "a" // exists; its data type is not relevant to the NULL comparison operator. // // * // CONTAINS : Checks for a subsequence, or value in a set. AttributeValueList can // contain only one AttributeValue element of type String, Number, or Binary (not a // set type). If the target attribute of the comparison is of type String, then the // operator checks for a substring match. If the target attribute of the comparison // is of type Binary, then the operator looks for a subsequence of the target that // matches the input. If the target attribute of the comparison is a set ("SS", // "NS", or "BS"), then the operator evaluates to true if it finds an exact match // with any member of the set. CONTAINS is supported for lists: When evaluating "a // CONTAINS b", "a" can be a list; however, "b" cannot be a set, a map, or a // list. // // * NOT_CONTAINS : Checks for absence of a subsequence, or absence of a // value in a set. AttributeValueList can contain only one AttributeValue element // of type String, Number, or Binary (not a set type). If the target attribute of // the comparison is a String, then the operator checks for the absence of a // substring match. If the target attribute of the comparison is Binary, then the // operator checks for the absence of a subsequence of the target that matches the // input. If the target attribute of the comparison is a set ("SS", "NS", or "BS"), // then the operator evaluates to true if it does not find an exact match with any // member of the set. NOT_CONTAINS is supported for lists: When evaluating "a NOT // CONTAINS b", "a" can be a list; however, "b" cannot be a set, a map, or a // list. // // * BEGINS_WITH : Checks for a prefix. AttributeValueList can contain // only one AttributeValue of type String or Binary (not a Number or a set type). // The target attribute of the comparison must be of type String or Binary (not a // Number or a set type). // // * IN : Checks for matching elements in a list. // AttributeValueList can contain one or more AttributeValue elements of type // String, Number, or Binary. These attributes are compared against an existing // attribute of an item. If any elements of the input are equal to the item // attribute, the expression evaluates to true. // // * BETWEEN : Greater than or // equal to the first value, and less than or equal to the second value. // AttributeValueList must contain two AttributeValue elements of the same type, // either String, Number, or Binary (not a set type). A target attribute matches if // the target value is greater than, or equal to, the first element and less than, // or equal to, the second element. If an item contains an AttributeValue element // of a different type than the one provided in the request, the value does not // match. For example, {"S":"6"} does not compare to {"N":"6"}. Also, {"N":"6"} // does not compare to {"NS":["6", "2", "1"]} // // For usage examples of // AttributeValueList and ComparisonOperator, see Legacy Conditional Parameters // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.html) // in the Amazon DynamoDB Developer Guide. // // This member is required. ComparisonOperator ComparisonOperator }
Represents the selection criteria for a Query or Scan operation:
- For a
Query operation, Condition is used for specifying the KeyConditions to use when querying a table or an index. For KeyConditions, only the following comparison operators are supported: EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEENCondition is also used in a QueryFilter, which evaluates the query results and returns only the desired values.
- For a Scan operation, Condition is used in a
ScanFilter, which evaluates the scan results and returns only the desired values.
type ConditionCheck ¶
type ConditionCheck struct { // One or more values that can be substituted in an expression. ExpressionAttributeValues map[string]*AttributeValue // Use ReturnValuesOnConditionCheckFailure to get the item attributes if the // ConditionCheck condition fails. For ReturnValuesOnConditionCheckFailure, the // valid values are: NONE and ALL_OLD. ReturnValuesOnConditionCheckFailure ReturnValuesOnConditionCheckFailure // A condition that must be satisfied in order for a conditional update to succeed. // // This member is required. ConditionExpression *string // The primary key of the item to be checked. Each element consists of an attribute // name and a value for that attribute. // // This member is required. Key map[string]*AttributeValue // Name of the table for the check item request. // // This member is required. TableName *string // One or more substitution tokens for attribute names in an expression. ExpressionAttributeNames map[string]*string }
Represents a request to perform a check that an item exists or to check the condition of specific attributes of the item.
type ConditionalCheckFailedException ¶
type ConditionalCheckFailedException struct { Message *string }
A condition specified in the operation could not be evaluated.
func (*ConditionalCheckFailedException) Error ¶
func (e *ConditionalCheckFailedException) Error() string
func (*ConditionalCheckFailedException) ErrorCode ¶
func (e *ConditionalCheckFailedException) ErrorCode() string
func (*ConditionalCheckFailedException) ErrorFault ¶
func (e *ConditionalCheckFailedException) ErrorFault() smithy.ErrorFault
func (*ConditionalCheckFailedException) ErrorMessage ¶
func (e *ConditionalCheckFailedException) ErrorMessage() string
type ConditionalOperator ¶
type ConditionalOperator string
const ( ConditionalOperatorAnd ConditionalOperator = "AND" ConditionalOperatorOr ConditionalOperator = "OR" )
Enum values for ConditionalOperator
type ConsumedCapacity ¶
type ConsumedCapacity struct { // The amount of throughput consumed on the table affected by the operation. Table *Capacity // The name of the table that was affected by the operation. TableName *string // The amount of throughput consumed on each local index affected by the operation. LocalSecondaryIndexes map[string]*Capacity // The total number of capacity units consumed by the operation. CapacityUnits *float64 // The amount of throughput consumed on each global index affected by the // operation. GlobalSecondaryIndexes map[string]*Capacity // The total number of read capacity units consumed by the operation. ReadCapacityUnits *float64 // The total number of write capacity units consumed by the operation. WriteCapacityUnits *float64 }
The capacity units consumed by an operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity is only returned if the request asked for it. For more information, see Provisioned Throughput (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html) in the Amazon DynamoDB Developer Guide.
type ContinuousBackupsDescription ¶
type ContinuousBackupsDescription struct { // ContinuousBackupsStatus can be one of the following states: ENABLED, DISABLED // // This member is required. ContinuousBackupsStatus ContinuousBackupsStatus // The description of the point in time recovery settings applied to the table. PointInTimeRecoveryDescription *PointInTimeRecoveryDescription }
Represents the continuous backups and point in time recovery settings on the table.
type ContinuousBackupsStatus ¶
type ContinuousBackupsStatus string
const ( ContinuousBackupsStatusEnabled ContinuousBackupsStatus = "ENABLED" ContinuousBackupsStatusDisabled ContinuousBackupsStatus = "DISABLED" )
Enum values for ContinuousBackupsStatus
type ContinuousBackupsUnavailableException ¶
type ContinuousBackupsUnavailableException struct { string }*
Backups have not yet been enabled for this table.
func (*ContinuousBackupsUnavailableException) Error ¶
func (e *ContinuousBackupsUnavailableException) Error() string
func (*ContinuousBackupsUnavailableException) ErrorCode ¶
func (e *ContinuousBackupsUnavailableException) ErrorCode() string
func (*ContinuousBackupsUnavailableException) ErrorFault ¶
func (e *ContinuousBackupsUnavailableException) ErrorFault() smithy.ErrorFault
func (*ContinuousBackupsUnavailableException) ErrorMessage ¶
func (e *ContinuousBackupsUnavailableException) ErrorMessage() string
type ContributorInsightsAction ¶
type ContributorInsightsAction string
const ( ContributorInsightsActionEnable ContributorInsightsAction = "ENABLE" ContributorInsightsActionDisable ContributorInsightsAction = "DISABLE" )
Enum values for ContributorInsightsAction
type ContributorInsightsStatus ¶
type ContributorInsightsStatus string
const ( ContributorInsightsStatusEnabling ContributorInsightsStatus = "ENABLING" ContributorInsightsStatusEnabled ContributorInsightsStatus = "ENABLED" ContributorInsightsStatusDisabling ContributorInsightsStatus = "DISABLING" ContributorInsightsStatusDisabled ContributorInsightsStatus = "DISABLED" ContributorInsightsStatusFailed ContributorInsightsStatus = "FAILED" )
Enum values for ContributorInsightsStatus
type ContributorInsightsSummary ¶
type ContributorInsightsSummary struct { // Name of the index associated with the summary, if any. IndexName *string // Describes the current status for contributor insights for the given table and // index, if applicable. ContributorInsightsStatus ContributorInsightsStatus // Name of the table associated with the summary. TableName *string }
Represents a Contributor Insights summary entry..
type CreateGlobalSecondaryIndexAction ¶
type CreateGlobalSecondaryIndexAction struct { // Represents attributes that are copied (projected) from the table into an index. // These are in addition to the primary key attributes and index key attributes, // which are automatically projected. // // This member is required. Projection *Projection // The name of the global secondary index to be created. // // This member is required. IndexName *string // The key schema for the global secondary index. // // This member is required. KeySchema []*KeySchemaElement // Represents the provisioned throughput settings for the specified global // secondary index. For current minimum and maximum provisioned throughput values, // see Limits // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html) // in the Amazon DynamoDB Developer Guide. ProvisionedThroughput *ProvisionedThroughput }
Represents a new global secondary index to be added to an existing table.
type CreateReplicaAction ¶
type CreateReplicaAction struct { // The Region of the replica to be added. // // This member is required. RegionName *string }
Represents a replica to be added.
type CreateReplicationGroupMemberAction ¶
type CreateReplicationGroupMemberAction struct { // The Region where the new replica will be created. // // This member is required. RegionName *string // Replica-specific global secondary index settings. GlobalSecondaryIndexes []*ReplicaGlobalSecondaryIndex // The AWS KMS customer master key (CMK) that should be used for AWS KMS encryption // in the new replica. To specify a CMK, use its key ID, Amazon Resource Name // (ARN), alias name, or alias ARN. Note that you should only provide this // parameter if the key is different from the default DynamoDB KMS master key // alias/aws/dynamodb. KMSMasterKeyId *string // Replica-specific provisioned throughput. If not specified, uses the source // table's provisioned throughput settings. ProvisionedThroughputOverride *ProvisionedThroughputOverride }
Represents a replica to be created.
type Delete ¶
type Delete struct { // Name of the table in which the item to be deleted resides. // // This member is required. TableName *string // One or more values that can be substituted in an expression. ExpressionAttributeValues map[string]*AttributeValue // The primary key of the item to be deleted. Each element consists of an attribute // name and a value for that attribute. // // This member is required. Key map[string]*AttributeValue // A condition that must be satisfied in order for a conditional delete to succeed. ConditionExpression *string // One or more substitution tokens for attribute names in an expression. ExpressionAttributeNames map[string]*string // Use ReturnValuesOnConditionCheckFailure to get the item attributes if the Delete // condition fails. For ReturnValuesOnConditionCheckFailure, the valid values are: // NONE and ALL_OLD. ReturnValuesOnConditionCheckFailure ReturnValuesOnConditionCheckFailure }
Represents a request to perform a DeleteItem operation.
type DeleteGlobalSecondaryIndexAction ¶
type DeleteGlobalSecondaryIndexAction struct { // The name of the global secondary index to be deleted. // // This member is required. IndexName *string }
Represents a global secondary index to be deleted from an existing table.
type DeleteReplicaAction ¶
type DeleteReplicaAction struct { // The Region of the replica to be removed. // // This member is required. RegionName *string }
Represents a replica to be removed.
type DeleteReplicationGroupMemberAction ¶
type DeleteReplicationGroupMemberAction struct { // The Region where the replica exists. // // This member is required. RegionName *string }
Represents a replica to be deleted.
type DeleteRequest ¶
type DeleteRequest struct { // A map of attribute name to attribute values, representing the primary key of the // item to delete. All of the table's primary key attributes must be specified, and // their data types must match those of the table's key schema. // // This member is required. Key map[string]*AttributeValue }
Represents a request to perform a DeleteItem operation on an item.
type Endpoint ¶
type Endpoint struct { // Endpoint cache time to live (TTL) value. // // This member is required. CachePeriodInMinutes *int64 // IP address of the endpoint. // // This member is required. Address *string }
An endpoint information details.
type ExpectedAttributeValue ¶
type ExpectedAttributeValue struct { // Represents the data for the expected attribute. Each attribute value is // described as a name-value pair. The name is the data type, and the value is the // data itself. 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 // One or more values to evaluate against the supplied attribute. The number of // values in the list depends on the ComparisonOperator being used. For type // Number, value comparisons are numeric. String value comparisons for greater // than, equals, or less than are based on ASCII character code values. For // example, a is greater than A, and a is greater than B. For a list of code // values, see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters // (http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters). For Binary, // DynamoDB treats each byte of the binary data as unsigned when it compares binary // values. For information on specifying data types in JSON, see JSON Data Format // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DataFormat.html) // in the Amazon DynamoDB Developer Guide. AttributeValueList []*AttributeValue // Causes DynamoDB to evaluate the value before attempting a conditional // operation: // // * If Exists is true, DynamoDB will check to see if that // attribute value already exists in the table. If it is found, then the operation // succeeds. If it is not found, the operation fails with a // ConditionCheckFailedException. // // * If Exists is false, DynamoDB assumes that // the attribute value does not exist in the table. If in fact the value does not // exist, then the assumption is valid and the operation succeeds. If the value is // found, despite the assumption that it does not exist, the operation fails with a // ConditionCheckFailedException. // // The default setting for Exists is true. If you // supply a Value all by itself, DynamoDB assumes the attribute exists: You don't // have to set Exists to true, because it is implied. DynamoDB returns a // ValidationException if: // // * Exists is true but there is no Value to check. // (You expect a value to exist, but don't specify what that value is.) // // * // Exists is false but you also provide a Value. (You cannot expect an attribute to // have a value, while also expecting it not to exist.) Exists *bool // A comparator for evaluating attributes in the AttributeValueList. For example, // equals, greater than, less than, etc. The following comparison operators are // available: EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS | // NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN The following are descriptions of each // comparison operator. // // * EQ : Equal. EQ is supported for all data types, // including lists and maps. AttributeValueList can contain only one AttributeValue // element of type String, Number, Binary, String Set, Number Set, or Binary Set. // If an item contains an AttributeValue element of a different type than the one // provided in the request, the value does not match. For example, {"S":"6"} does // not equal {"N":"6"}. Also, {"N":"6"} does not equal {"NS":["6", "2", "1"]}. // // // * NE : Not equal. NE is supported for all data types, including lists and maps. // AttributeValueList can contain only one AttributeValue of type String, Number, // Binary, String Set, Number Set, or Binary Set. If an item contains an // AttributeValue of a different type than the one provided in the request, the // value does not match. For example, {"S":"6"} does not equal {"N":"6"}. Also, // {"N":"6"} does not equal {"NS":["6", "2", "1"]}. // // * LE : Less than or equal. // AttributeValueList can contain only one AttributeValue element of type String, // Number, or Binary (not a set type). If an item contains an AttributeValue // element of a different type than the one provided in the request, the value does // not match. For example, {"S":"6"} does not equal {"N":"6"}. Also, {"N":"6"} does // not compare to {"NS":["6", "2", "1"]}. // // * LT : Less than. AttributeValueList // can contain only one AttributeValue of type String, Number, or Binary (not a set // type). If an item contains an AttributeValue element of a different type than // the one provided in the request, the value does not match. For example, // {"S":"6"} does not equal {"N":"6"}. Also, {"N":"6"} does not compare to // {"NS":["6", "2", "1"]}. // // * GE : Greater than or equal. AttributeValueList // can contain only one AttributeValue element of type String, Number, or Binary // (not a set type). If an item contains an AttributeValue element of a different // type than the one provided in the request, the value does not match. For // example, {"S":"6"} does not equal {"N":"6"}. Also, {"N":"6"} does not compare to // {"NS":["6", "2", "1"]}. // // * GT : Greater than. AttributeValueList can contain // only one AttributeValue element of type String, Number, or Binary (not a set // type). If an item contains an AttributeValue element of a different type than // the one provided in the request, the value does not match. For example, // {"S":"6"} does not equal {"N":"6"}. Also, {"N":"6"} does not compare to // {"NS":["6", "2", "1"]}. // // * NOT_NULL : The attribute exists. NOT_NULL is // supported for all data types, including lists and maps. This operator tests for // the existence of an attribute, not its data type. If the data type of attribute // "a" is null, and you evaluate it using NOT_NULL, the result is a Boolean true. // This result is because the attribute "a" exists; its data type is not relevant // to the NOT_NULL comparison operator. // // * NULL : The attribute does not exist. // NULL is supported for all data types, including lists and maps. This operator // tests for the nonexistence of an attribute, not its data type. If the data type // of attribute "a" is null, and you evaluate it using NULL, the result is a // Boolean false. This is because the attribute "a" exists; its data type is not // relevant to the NULL comparison operator. // // * CONTAINS : Checks for a // subsequence, or value in a set. AttributeValueList can contain only one // AttributeValue element of type String, Number, or Binary (not a set type). If // the target attribute of the comparison is of type String, then the operator // checks for a substring match. If the target attribute of the comparison is of // type Binary, then the operator looks for a subsequence of the target that // matches the input. If the target attribute of the comparison is a set ("SS", // "NS", or "BS"), then the operator evaluates to true if it finds an exact match // with any member of the set. CONTAINS is supported for lists: When evaluating "a // CONTAINS b", "a" can be a list; however, "b" cannot be a set, a map, or a // list. // // * NOT_CONTAINS : Checks for absence of a subsequence, or absence of a // value in a set. AttributeValueList can contain only one AttributeValue element // of type String, Number, or Binary (not a set type). If the target attribute of // the comparison is a String, then the operator checks for the absence of a // substring match. If the target attribute of the comparison is Binary, then the // operator checks for the absence of a subsequence of the target that matches the // input. If the target attribute of the comparison is a set ("SS", "NS", or "BS"), // then the operator evaluates to true if it does not find an exact match with any // member of the set. NOT_CONTAINS is supported for lists: When evaluating "a NOT // CONTAINS b", "a" can be a list; however, "b" cannot be a set, a map, or a // list. // // * BEGINS_WITH : Checks for a prefix. AttributeValueList can contain // only one AttributeValue of type String or Binary (not a Number or a set type). // The target attribute of the comparison must be of type String or Binary (not a // Number or a set type). // // * IN : Checks for matching elements in a list. // AttributeValueList can contain one or more AttributeValue elements of type // String, Number, or Binary. These attributes are compared against an existing // attribute of an item. If any elements of the input are equal to the item // attribute, the expression evaluates to true. // // * BETWEEN : Greater than or // equal to the first value, and less than or equal to the second value. // AttributeValueList must contain two AttributeValue elements of the same type, // either String, Number, or Binary (not a set type). A target attribute matches if // the target value is greater than, or equal to, the first element and less than, // or equal to, the second element. If an item contains an AttributeValue element // of a different type than the one provided in the request, the value does not // match. For example, {"S":"6"} does not compare to {"N":"6"}. Also, {"N":"6"} // does not compare to {"NS":["6", "2", "1"]} ComparisonOperator ComparisonOperator }
Represents a condition to be compared with an attribute value. This condition can be used with DeleteItem, PutItem, or UpdateItem operations; if the comparison evaluates to true, the operation succeeds; if not, the operation fails. You can use ExpectedAttributeValue in one of two different ways:
*
Use AttributeValueList to specify one or more values to compare against an attribute. Use ComparisonOperator to specify how you want to perform the comparison. If the comparison evaluates to true, then the conditional operation succeeds.
- Use Value to specify a value that DynamoDB will compare against
an attribute. If the values match, then ExpectedAttributeValue evaluates to true and the conditional operation succeeds. Optionally, you can also set Exists to false, indicating that you do not expect to find the attribute value in the table. In this case, the conditional operation succeeds only if the comparison evaluates to false.
Value and Exists are incompatible with AttributeValueList and ComparisonOperator. Note that if you use both sets of parameters at once, DynamoDB will return a ValidationException exception.
type FailureException ¶
type FailureException struct { // Description of the failure. ExceptionDescription *string // Exception name. ExceptionName *string }
Represents a failure a contributor insights operation.
type Get ¶
type Get struct { // One or more substitution tokens for attribute names in the ProjectionExpression // parameter. ExpressionAttributeNames map[string]*string // A string that identifies one or more attributes of the specified item to // retrieve from the table. The attributes in the expression must be separated by // commas. If no attribute names are specified, then all attributes of the // specified item are returned. If any of the requested attributes are not found, // they do not appear in the result. ProjectionExpression *string // A map of attribute names to AttributeValue objects that specifies the primary // key of the item to retrieve. // // This member is required. Key map[string]*AttributeValue // The name of the table from which to retrieve the specified item. // // This member is required. TableName *string }
Specifies an item and related attribute values to retrieve in a TransactGetItem object.
type GlobalSecondaryIndex ¶
type GlobalSecondaryIndex struct { // Represents attributes that are copied (projected) from the table into the global // secondary index. These are in addition to the primary key attributes and index // key attributes, which are automatically projected. // // This member is required. Projection *Projection // Represents the provisioned throughput settings for the specified global // secondary index. For current minimum and maximum provisioned throughput values, // see Limits // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html) // in the Amazon DynamoDB Developer Guide. ProvisionedThroughput *ProvisionedThroughput // The name of the global secondary index. The name must be unique among all other // indexes on this table. // // This member is required. IndexName *string // The complete key schema for a global secondary index, which consists of one or // more pairs of attribute names and key types: // // * HASH - partition key // // * // RANGE - sort key // // The partition key of an item is also known as its hash // attribute. The term "hash attribute" derives from DynamoDB's usage of an // internal hash function to evenly distribute data items across partitions, based // on their partition key values. The sort key of an item is also known as its // range attribute. The term "range attribute" derives from the way DynamoDB stores // items with the same partition key physically close together, in sorted order by // the sort key value. // // This member is required. KeySchema []*KeySchemaElement }
Represents the properties of a global secondary index.
type GlobalSecondaryIndexAutoScalingUpdate ¶
type GlobalSecondaryIndexAutoScalingUpdate struct { // The name of the global secondary index. IndexName *string // Represents the auto scaling settings to be modified for a global table or global // secondary index. ProvisionedWriteCapacityAutoScalingUpdate *AutoScalingSettingsUpdate }
Represents the auto scaling settings of a global secondary index for a global table that will be modified.
type GlobalSecondaryIndexDescription ¶
type GlobalSecondaryIndexDescription struct { // Represents attributes that are copied (projected) from the table into the global // secondary index. These are in addition to the primary key attributes and index // key attributes, which are automatically projected. Projection *Projection // The number of items in the specified index. DynamoDB updates this value // approximately every six hours. Recent changes might not be reflected in this // value. ItemCount *int64 // The total size of the specified index, in bytes. DynamoDB updates this value // approximately every six hours. Recent changes might not be reflected in this // value. IndexSizeBytes *int64 // The Amazon Resource Name (ARN) that uniquely identifies the index. IndexArn *string // The complete key schema for a global secondary index, which consists of one or // more pairs of attribute names and key types: // // * HASH - partition key // // * // RANGE - sort key // // The partition key of an item is also known as its hash // attribute. The term "hash attribute" derives from DynamoDB's usage of an // internal hash function to evenly distribute data items across partitions, based // on their partition key values. The sort key of an item is also known as its // range attribute. The term "range attribute" derives from the way DynamoDB stores // items with the same partition key physically close together, in sorted order by // the sort key value. KeySchema []*KeySchemaElement // The name of the global secondary index. IndexName *string // The current state of the global secondary index: // // * CREATING - The index is // being created. // // * UPDATING - The index is being updated. // // * DELETING - // The index is being deleted. // // * ACTIVE - The index is ready for use. IndexStatus IndexStatus // Represents the provisioned throughput settings for the specified global // secondary index. For current minimum and maximum provisioned throughput values, // see Limits // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html) // in the Amazon DynamoDB Developer Guide. ProvisionedThroughput *ProvisionedThroughputDescription // Indicates whether the index is currently backfilling. Backfilling is the process // of reading items from the table and determining whether they can be added to the // index. (Not all items will qualify: For example, a partition key cannot have any // duplicate values.) If an item can be added to the index, DynamoDB will do so. // After all items have been processed, the backfilling operation is complete and // Backfilling is false. You can delete an index that is being created during the // Backfilling phase when IndexStatus is set to CREATING and Backfilling is true. // You can't delete the index that is being created when IndexStatus is set to // CREATING and Backfilling is false. For indexes that were created during a // CreateTable operation, the Backfilling attribute does not appear in the // DescribeTable output. Backfilling *bool }
Represents the properties of a global secondary index.
type GlobalSecondaryIndexInfo ¶
type GlobalSecondaryIndexInfo struct { // The name of the global secondary index. IndexName *string // The complete key schema for a global secondary index, which consists of one or // more pairs of attribute names and key types: // // * HASH - partition key // // * // RANGE - sort key // // The partition key of an item is also known as its hash // attribute. The term "hash attribute" derives from DynamoDB's usage of an // internal hash function to evenly distribute data items across partitions, based // on their partition key values. The sort key of an item is also known as its // range attribute. The term "range attribute" derives from the way DynamoDB stores // items with the same partition key physically close together, in sorted order by // the sort key value. KeySchema []*KeySchemaElement // Represents the provisioned throughput settings for the specified global // secondary index. ProvisionedThroughput *ProvisionedThroughput // Represents attributes that are copied (projected) from the table into the global // secondary index. These are in addition to the primary key attributes and index // key attributes, which are automatically projected. Projection *Projection }
Represents the properties of a global secondary index for the table when the backup was created.
type GlobalSecondaryIndexUpdate ¶
type GlobalSecondaryIndexUpdate struct { // The name of an existing global secondary index, along with new provisioned // throughput settings to be applied to that index. Update *UpdateGlobalSecondaryIndexAction // The parameters required for creating a global secondary index on an existing // table: // // * IndexName // // * KeySchema // // * AttributeDefinitions // // * // Projection // // * ProvisionedThroughput Create *CreateGlobalSecondaryIndexAction // The name of an existing global secondary index to be removed. Delete *DeleteGlobalSecondaryIndexAction }
Represents one of the following:
- A new global secondary index to be added
to an existing table.
- New provisioned throughput parameters for an
existing global secondary index.
- An existing global secondary index to be
removed from an existing table.
type GlobalTable ¶
type GlobalTable struct { // The Regions where the global table has replicas. ReplicationGroup []*Replica // The global table name. GlobalTableName *string }
Represents the properties of a global table.
type GlobalTableAlreadyExistsException ¶
type GlobalTableAlreadyExistsException struct { Message *string }
The specified global table already exists.
func (*GlobalTableAlreadyExistsException) Error ¶
func (e *GlobalTableAlreadyExistsException) Error() string
func (*GlobalTableAlreadyExistsException) ErrorCode ¶
func (e *GlobalTableAlreadyExistsException) ErrorCode() string
func (*GlobalTableAlreadyExistsException) ErrorFault ¶
func (e *GlobalTableAlreadyExistsException) ErrorFault() smithy.ErrorFault
func (*GlobalTableAlreadyExistsException) ErrorMessage ¶
func (e *GlobalTableAlreadyExistsException) ErrorMessage() string
type GlobalTableDescription ¶
type GlobalTableDescription struct { // The creation time of the global table. CreationDateTime *time.Time // The Regions where the global table has replicas. ReplicationGroup []*ReplicaDescription // The current state of the global table: // // * CREATING - The global table is // being created. // // * UPDATING - The global table is being updated. // // * // DELETING - The global table is being deleted. // // * ACTIVE - The global table // is ready for use. GlobalTableStatus GlobalTableStatus // The global table name. GlobalTableName *string // The unique identifier of the global table. GlobalTableArn *string }
Contains details about the global table.
type GlobalTableGlobalSecondaryIndexSettingsUpdate ¶
type GlobalTableGlobalSecondaryIndexSettingsUpdate struct { // The maximum number of writes consumed per second before DynamoDB returns a // ThrottlingException. ProvisionedWriteCapacityUnits *int64 // The name of the global secondary index. The name must be unique among all other // indexes on this table. // // This member is required. IndexName *string // Auto scaling settings for managing a global secondary index's write capacity // units. ProvisionedWriteCapacityAutoScalingSettingsUpdate *AutoScalingSettingsUpdate }
Represents the settings of a global secondary index for a global table that will be modified.
type GlobalTableNotFoundException ¶
type GlobalTableNotFoundException struct { Message *string }
The specified global table does not exist.
func (*GlobalTableNotFoundException) Error ¶
func (e *GlobalTableNotFoundException) Error() string
func (*GlobalTableNotFoundException) ErrorCode ¶
func (e *GlobalTableNotFoundException) ErrorCode() string
func (*GlobalTableNotFoundException) ErrorFault ¶
func (e *GlobalTableNotFoundException) ErrorFault() smithy.ErrorFault
func (*GlobalTableNotFoundException) ErrorMessage ¶
func (e *GlobalTableNotFoundException) ErrorMessage() string
type GlobalTableStatus ¶
type GlobalTableStatus string
const ( GlobalTableStatusCreating GlobalTableStatus = "CREATING" GlobalTableStatusActive GlobalTableStatus = "ACTIVE" GlobalTableStatusDeleting GlobalTableStatus = "DELETING" GlobalTableStatusUpdating GlobalTableStatus = "UPDATING" )
Enum values for GlobalTableStatus
type IdempotentParameterMismatchException ¶
type IdempotentParameterMismatchException struct { Message *string }
DynamoDB rejected the request because you retried a request with a different payload but with an idempotent token that was already used.
func (*IdempotentParameterMismatchException) Error ¶
func (e *IdempotentParameterMismatchException) Error() string
func (*IdempotentParameterMismatchException) ErrorCode ¶
func (e *IdempotentParameterMismatchException) ErrorCode() string
func (*IdempotentParameterMismatchException) ErrorFault ¶
func (e *IdempotentParameterMismatchException) ErrorFault() smithy.ErrorFault
func (*IdempotentParameterMismatchException) ErrorMessage ¶
func (e *IdempotentParameterMismatchException) ErrorMessage() string
type IndexNotFoundException ¶
type IndexNotFoundException struct { Message *string }
The operation tried to access a nonexistent index.
func (*IndexNotFoundException) Error ¶
func (e *IndexNotFoundException) Error() string
func (*IndexNotFoundException) ErrorCode ¶
func (e *IndexNotFoundException) ErrorCode() string
func (*IndexNotFoundException) ErrorFault ¶
func (e *IndexNotFoundException) ErrorFault() smithy.ErrorFault
func (*IndexNotFoundException) ErrorMessage ¶
func (e *IndexNotFoundException) ErrorMessage() string
type IndexStatus ¶
type IndexStatus string
const ( IndexStatusCreating IndexStatus = "CREATING" IndexStatusUpdating IndexStatus = "UPDATING" IndexStatusDeleting IndexStatus = "DELETING" IndexStatusActive IndexStatus = "ACTIVE" )
Enum values for IndexStatus
type InternalServerError ¶
type InternalServerError struct { Message *string }
An error occurred on the server side.
func (*InternalServerError) Error ¶
func (e *InternalServerError) Error() string
func (*InternalServerError) ErrorCode ¶
func (e *InternalServerError) ErrorCode() string
func (*InternalServerError) ErrorFault ¶
func (e *InternalServerError) ErrorFault() smithy.ErrorFault
func (*InternalServerError) ErrorMessage ¶
func (e *InternalServerError) ErrorMessage() string
type InvalidEndpointException ¶
type InvalidEndpointException struct { Message *string }
func (*InvalidEndpointException) Error ¶
func (e *InvalidEndpointException) Error() string
func (*InvalidEndpointException) ErrorCode ¶
func (e *InvalidEndpointException) ErrorCode() string
func (*InvalidEndpointException) ErrorFault ¶
func (e *InvalidEndpointException) ErrorFault() smithy.ErrorFault
func (*InvalidEndpointException) ErrorMessage ¶
func (e *InvalidEndpointException) ErrorMessage() string
type InvalidRestoreTimeException ¶
type InvalidRestoreTimeException struct { Message *string }
An invalid restore time was specified. RestoreDateTime must be between EarliestRestorableDateTime and LatestRestorableDateTime.
func (*InvalidRestoreTimeException) Error ¶
func (e *InvalidRestoreTimeException) Error() string
func (*InvalidRestoreTimeException) ErrorCode ¶
func (e *InvalidRestoreTimeException) ErrorCode() string
func (*InvalidRestoreTimeException) ErrorFault ¶
func (e *InvalidRestoreTimeException) ErrorFault() smithy.ErrorFault
func (*InvalidRestoreTimeException) ErrorMessage ¶
func (e *InvalidRestoreTimeException) ErrorMessage() string
type ItemCollectionMetrics ¶
type ItemCollectionMetrics struct { // The partition key value of the item collection. This value is the same as the // partition key value of the item. ItemCollectionKey map[string]*AttributeValue // An estimate of item collection size, in gigabytes. This value is a two-element // array containing a lower bound and an upper bound for the estimate. The estimate // includes the size of all the items in the table, plus the size of all attributes // projected into all of the local secondary indexes on that table. Use this // estimate to measure whether a local secondary index is approaching its size // limit. The estimate is subject to change over time; therefore, do not rely on // the precision or accuracy of the estimate. SizeEstimateRangeGB []*float64 }
Information about item collections, if any, that were affected by the operation. ItemCollectionMetrics is only returned if the request asked for it. If the table does not have any local secondary indexes, this information is not returned in the response.
type ItemCollectionSizeLimitExceededException ¶
type ItemCollectionSizeLimitExceededException struct { Message *string }
An item collection is too large. This exception is only returned for tables that have one or more local secondary indexes.
func (*ItemCollectionSizeLimitExceededException) Error ¶
func (e *ItemCollectionSizeLimitExceededException) Error() string
func (*ItemCollectionSizeLimitExceededException) ErrorCode ¶
func (e *ItemCollectionSizeLimitExceededException) ErrorCode() string
func (*ItemCollectionSizeLimitExceededException) ErrorFault ¶
func (e *ItemCollectionSizeLimitExceededException) ErrorFault() smithy.ErrorFault
func (*ItemCollectionSizeLimitExceededException) ErrorMessage ¶
func (e *ItemCollectionSizeLimitExceededException) ErrorMessage() string
type ItemResponse ¶
type ItemResponse struct { // Map of attribute data consisting of the data type and attribute value. Item map[string]*AttributeValue }
Details for the requested item.
type KeySchemaElement ¶
type KeySchemaElement struct { // The role that this key attribute will assume: // // * HASH - partition key // // * // RANGE - sort key // // The partition key of an item is also known as its hash // attribute. The term "hash attribute" derives from DynamoDB's usage of an // internal hash function to evenly distribute data items across partitions, based // on their partition key values. The sort key of an item is also known as its // range attribute. The term "range attribute" derives from the way DynamoDB stores // items with the same partition key physically close together, in sorted order by // the sort key value. // // This member is required. KeyType KeyType // The name of a key attribute. // // This member is required. AttributeName *string }
Represents a single element of a key schema. A key schema specifies the attributes that make up the primary key of a table, or the key attributes of an index. A KeySchemaElement represents exactly one attribute of the primary key. For example, a simple primary key would be represented by one KeySchemaElement (for the partition key). A composite primary key would require one KeySchemaElement for the partition key, and another KeySchemaElement for the sort key. A KeySchemaElement must be a scalar, top-level attribute (not a nested attribute). The data type must be one of String, Number, or Binary. The attribute cannot be nested within a List or a Map.
type KeyType ¶
type KeyType string
Enum values for KeyType
type KeysAndAttributes ¶
type KeysAndAttributes struct { // A string that identifies one or more attributes to retrieve from the table. // These attributes can include scalars, sets, or elements of a JSON document. The // attributes in the ProjectionExpression must be separated by commas. If no // attribute names are specified, then all attributes will be returned. If any of // the requested attributes are not found, they will not appear in the result. For // more information, see Accessing Item Attributes // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html) // in the Amazon DynamoDB Developer Guide. ProjectionExpression *string // The primary key attribute values that define the items and the attributes // associated with the items. // // This member is required. Keys []map[string]*AttributeValue // The consistency of a read operation. If set to true, then a strongly consistent // read is used; otherwise, an eventually consistent read is used. ConsistentRead *bool // One or more substitution tokens for attribute names in an expression. The // following are some use cases for using ExpressionAttributeNames: // // * To // access an attribute whose name conflicts with a DynamoDB reserved word. // // * // To create a placeholder for repeating occurrences of an attribute name in an // expression. // // * To prevent special characters in an attribute name from being // misinterpreted in an expression. // // Use the # character in an expression to // dereference an attribute name. For example, consider the following attribute // name: // // * Percentile // // The name of this attribute conflicts with a reserved // word, so it cannot be used directly in an expression. (For the complete list of // reserved words, see Reserved Words // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html) // in the Amazon DynamoDB Developer Guide). To work around this, you could specify // the following for ExpressionAttributeNames: // // * {"#P":"Percentile"} // // You // could then use this substitution in an expression, as in this example: // // * #P // = :val // // Tokens that begin with the : character are expression attribute values, // which are placeholders for the actual value at runtime. For more information on // expression attribute names, see Accessing Item Attributes // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html) // in the Amazon DynamoDB Developer Guide. ExpressionAttributeNames map[string]*string // This is a legacy parameter. Use ProjectionExpression instead. For more // information, see Legacy Conditional Parameters // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.html) // in the Amazon DynamoDB Developer Guide. AttributesToGet []*string }
Represents a set of primary keys and, for each key, the attributes to retrieve from the table. For each primary key, you must provide all of the key attributes. For example, with a simple primary key, you only need to provide the partition key. For a composite primary key, you must provide both the partition key and the sort key.
type LimitExceededException ¶
type LimitExceededException struct { Message *string }
There is no limit to the number of daily on-demand backups that can be taken. Up to 50 simultaneous table operations are allowed per account. These operations include CreateTable, UpdateTable, DeleteTable,UpdateTimeToLive, RestoreTableFromBackup, and RestoreTableToPointInTime. The only exception is when you are creating a table with one or more secondary indexes. You can have up to 25 such requests running at a time; however, if the table or index specifications are complex, DynamoDB might temporarily reduce the number of concurrent operations. There is a soft account limit of 256 tables.
func (*LimitExceededException) Error ¶
func (e *LimitExceededException) Error() string
func (*LimitExceededException) ErrorCode ¶
func (e *LimitExceededException) ErrorCode() string
func (*LimitExceededException) ErrorFault ¶
func (e *LimitExceededException) ErrorFault() smithy.ErrorFault
func (*LimitExceededException) ErrorMessage ¶
func (e *LimitExceededException) ErrorMessage() string
type LocalSecondaryIndex ¶
type LocalSecondaryIndex struct { // Represents attributes that are copied (projected) from the table into the local // secondary index. These are in addition to the primary key attributes and index // key attributes, which are automatically projected. // // This member is required. Projection *Projection // The complete key schema for the local secondary index, consisting of one or more // pairs of attribute names and key types: // // * HASH - partition key // // * RANGE // - sort key // // The partition key of an item is also known as its hash attribute. // The term "hash attribute" derives from DynamoDB's usage of an internal hash // function to evenly distribute data items across partitions, based on their // partition key values. The sort key of an item is also known as its range // attribute. The term "range attribute" derives from the way DynamoDB stores items // with the same partition key physically close together, in sorted order by the // sort key value. // // This member is required. KeySchema []*KeySchemaElement // The name of the local secondary index. The name must be unique among all other // indexes on this table. // // This member is required. IndexName *string }
Represents the properties of a local secondary index.
type LocalSecondaryIndexDescription ¶
type LocalSecondaryIndexDescription struct { // The Amazon Resource Name (ARN) that uniquely identifies the index. IndexArn *string // Represents the name of the local secondary index. IndexName *string // Represents attributes that are copied (projected) from the table into the global // secondary index. These are in addition to the primary key attributes and index // key attributes, which are automatically projected. Projection *Projection // The total size of the specified index, in bytes. DynamoDB updates this value // approximately every six hours. Recent changes might not be reflected in this // value. IndexSizeBytes *int64 // The number of items in the specified index. DynamoDB updates this value // approximately every six hours. Recent changes might not be reflected in this // value. ItemCount *int64 // The complete key schema for the local secondary index, consisting of one or more // pairs of attribute names and key types: // // * HASH - partition key // // * RANGE // - sort key // // The partition key of an item is also known as its hash attribute. // The term "hash attribute" derives from DynamoDB's usage of an internal hash // function to evenly distribute data items across partitions, based on their // partition key values. The sort key of an item is also known as its range // attribute. The term "range attribute" derives from the way DynamoDB stores items // with the same partition key physically close together, in sorted order by the // sort key value. KeySchema []*KeySchemaElement }
Represents the properties of a local secondary index.
type LocalSecondaryIndexInfo ¶
type LocalSecondaryIndexInfo struct { // Represents the name of the local secondary index. IndexName *string // The complete key schema for a local secondary index, which consists of one or // more pairs of attribute names and key types: // // * HASH - partition key // // * // RANGE - sort key // // The partition key of an item is also known as its hash // attribute. The term "hash attribute" derives from DynamoDB's usage of an // internal hash function to evenly distribute data items across partitions, based // on their partition key values. The sort key of an item is also known as its // range attribute. The term "range attribute" derives from the way DynamoDB stores // items with the same partition key physically close together, in sorted order by // the sort key value. KeySchema []*KeySchemaElement // Represents attributes that are copied (projected) from the table into the global // secondary index. These are in addition to the primary key attributes and index // key attributes, which are automatically projected. Projection *Projection }
Represents the properties of a local secondary index for the table when the backup was created.
type PointInTimeRecoveryDescription ¶
type PointInTimeRecoveryDescription struct { // Specifies the earliest point in time you can restore your table to. You can // restore your table to any point in time during the last 35 days. EarliestRestorableDateTime *time.Time // The current state of point in time recovery: // // * ENABLING - Point in time // recovery is being enabled. // // * ENABLED - Point in time recovery is enabled. // // // * DISABLED - Point in time recovery is disabled. PointInTimeRecoveryStatus PointInTimeRecoveryStatus // LatestRestorableDateTime is typically 5 minutes before the current time. LatestRestorableDateTime *time.Time }
The description of the point in time settings applied to the table.
type PointInTimeRecoverySpecification ¶
type PointInTimeRecoverySpecification struct { // Indicates whether point in time recovery is enabled (true) or disabled (false) // on the table. // // This member is required. PointInTimeRecoveryEnabled *bool }
Represents the settings used to enable point in time recovery.
type PointInTimeRecoveryStatus ¶
type PointInTimeRecoveryStatus string
const ( PointInTimeRecoveryStatusEnabled PointInTimeRecoveryStatus = "ENABLED" PointInTimeRecoveryStatusDisabled PointInTimeRecoveryStatus = "DISABLED" )
Enum values for PointInTimeRecoveryStatus
type PointInTimeRecoveryUnavailableException ¶
type PointInTimeRecoveryUnavailableException struct { string }*
Point in time recovery has not yet been enabled for this source table.
func (*PointInTimeRecoveryUnavailableException) Error ¶
func (e *PointInTimeRecoveryUnavailableException) Error() string
func (*PointInTimeRecoveryUnavailableException) ErrorCode ¶
func (e *PointInTimeRecoveryUnavailableException) ErrorCode() string
func (*PointInTimeRecoveryUnavailableException) ErrorFault ¶
func (e *PointInTimeRecoveryUnavailableException) ErrorFault() smithy.ErrorFault
func (*PointInTimeRecoveryUnavailableException) ErrorMessage ¶
func (e *PointInTimeRecoveryUnavailableException) ErrorMessage() string
type Projection ¶
type Projection struct { // The set of attributes that are projected into the index: // // * KEYS_ONLY - Only // the index and primary keys are projected into the index. // // * INCLUDE - Only // the specified table attributes are projected into the index. The list of // projected attributes is in NonKeyAttributes. // // * ALL - All of the table // attributes are projected into the index. ProjectionType ProjectionType // Represents the non-key attribute names which will be projected into the index. // For local secondary indexes, the total count of NonKeyAttributes summed across // all of the local secondary indexes, must not exceed 20. If you project the same // attribute into two different indexes, this counts as two distinct attributes // when determining the total. NonKeyAttributes []*string }
Represents attributes that are copied (projected) from the table into an index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.
type ProjectionType ¶
type ProjectionType string
const ( ProjectionTypeAll ProjectionType = "ALL" ProjectionTypeKeys_only ProjectionType = "KEYS_ONLY" ProjectionTypeInclude ProjectionType = "INCLUDE" )
Enum values for ProjectionType
type ProvisionedThroughput ¶
type ProvisionedThroughput struct { // The maximum number of strongly consistent reads consumed per second before // DynamoDB returns a ThrottlingException. For more information, see Specifying // Read and Write Requirements // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html#ProvisionedThroughput) // in the Amazon DynamoDB Developer Guide. If read/write capacity mode is // PAY_PER_REQUEST the value is set to 0. // // This member is required. ReadCapacityUnits *int64 // The maximum number of writes consumed per second before DynamoDB returns a // ThrottlingException. For more information, see Specifying Read and Write // Requirements // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html#ProvisionedThroughput) // in the Amazon DynamoDB Developer Guide. If read/write capacity mode is // PAY_PER_REQUEST the value is set to 0. // // This member is required. WriteCapacityUnits *int64 }
Represents the provisioned throughput settings for a specified table or index. The settings can be modified using the UpdateTable operation. For current minimum and maximum provisioned throughput values, see Limits (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html) in the Amazon DynamoDB Developer Guide.
type ProvisionedThroughputDescription ¶
type ProvisionedThroughputDescription struct { // The maximum number of writes consumed per second before DynamoDB returns a // ThrottlingException. WriteCapacityUnits *int64 // The date and time of the last provisioned throughput increase for this table. LastIncreaseDateTime *time.Time // The number of provisioned throughput decreases for this table during this UTC // calendar day. For current maximums on provisioned throughput decreases, see // Limits // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html) // in the Amazon DynamoDB Developer Guide. NumberOfDecreasesToday *int64 // The date and time of the last provisioned throughput decrease for this table. LastDecreaseDateTime *time.Time // The maximum number of strongly consistent reads consumed per second before // DynamoDB returns a ThrottlingException. Eventually consistent reads require less // effort than strongly consistent reads, so a setting of 50 ReadCapacityUnits per // second provides 100 eventually consistent ReadCapacityUnits per second. ReadCapacityUnits *int64 }
Represents the provisioned throughput settings for the table, consisting of read and write capacity units, along with data about increases and decreases.
type ProvisionedThroughputExceededException ¶
type ProvisionedThroughputExceededException struct { Message *string }
Your request rate is too high. The AWS SDKs for DynamoDB automatically retry requests that receive this exception. Your request is eventually successful, unless your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff. For more information, go to Error Retries and Exponential Backoff (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.Errors.html#Programming.Errors.RetryAndBackoff) in the Amazon DynamoDB Developer Guide.
func (*ProvisionedThroughputExceededException) Error ¶
func (e *ProvisionedThroughputExceededException) Error() string
func (*ProvisionedThroughputExceededException) ErrorCode ¶
func (e *ProvisionedThroughputExceededException) ErrorCode() string
func (*ProvisionedThroughputExceededException) ErrorFault ¶
func (e *ProvisionedThroughputExceededException) ErrorFault() smithy.ErrorFault
func (*ProvisionedThroughputExceededException) ErrorMessage ¶
func (e *ProvisionedThroughputExceededException) ErrorMessage() string
type ProvisionedThroughputOverride ¶
type ProvisionedThroughputOverride struct { // Replica-specific read capacity units. If not specified, uses the source table's // read capacity settings. ReadCapacityUnits *int64 }
Replica-specific provisioned throughput settings. If not specified, uses the source table's provisioned throughput settings.
type Put ¶
type Put struct { // One or more values that can be substituted in an expression. ExpressionAttributeValues map[string]*AttributeValue // A condition that must be satisfied in order for a conditional update to succeed. ConditionExpression *string // Name of the table in which to write the item. // // This member is required. TableName *string // Use ReturnValuesOnConditionCheckFailure to get the item attributes if the Put // condition fails. For ReturnValuesOnConditionCheckFailure, the valid values are: // NONE and ALL_OLD. ReturnValuesOnConditionCheckFailure ReturnValuesOnConditionCheckFailure // One or more substitution tokens for attribute names in an expression. ExpressionAttributeNames map[string]*string // A map of attribute name to attribute values, representing the primary key of the // item to be written by PutItem. All of the table's primary key attributes must be // specified, and their data types must match those of the table's key schema. If // any attributes are present in the item that are part of an index key schema for // the table, their types must match the index key schema. // // This member is required. Item map[string]*AttributeValue }
Represents a request to perform a PutItem operation.
type PutRequest ¶
type PutRequest struct { // A map of attribute name to attribute values, representing the primary key of an // item to be processed by PutItem. All of the table's primary key attributes must // be specified, and their data types must match those of the table's key schema. // If any attributes are present in the item that are part of an index key schema // for the table, their types must match the index key schema. // // This member is required. Item map[string]*AttributeValue }
Represents a request to perform a PutItem operation on an item.
type Replica ¶
type Replica struct { // The Region where the replica needs to be created. RegionName *string }
Represents the properties of a replica.
type ReplicaAlreadyExistsException ¶
type ReplicaAlreadyExistsException struct { Message *string }
The specified replica is already part of the global table.
func (*ReplicaAlreadyExistsException) Error ¶
func (e *ReplicaAlreadyExistsException) Error() string
func (*ReplicaAlreadyExistsException) ErrorCode ¶
func (e *ReplicaAlreadyExistsException) ErrorCode() string
func (*ReplicaAlreadyExistsException) ErrorFault ¶
func (e *ReplicaAlreadyExistsException) ErrorFault() smithy.ErrorFault
func (*ReplicaAlreadyExistsException) ErrorMessage ¶
func (e *ReplicaAlreadyExistsException) ErrorMessage() string
type ReplicaAutoScalingDescription ¶
type ReplicaAutoScalingDescription struct { // The Region where the replica exists. RegionName *string // Represents the auto scaling settings for a global table or global secondary // index. ReplicaProvisionedReadCapacityAutoScalingSettings *AutoScalingSettingsDescription // Represents the auto scaling settings for a global table or global secondary // index. ReplicaProvisionedWriteCapacityAutoScalingSettings *AutoScalingSettingsDescription // The current state of the replica: // // * CREATING - The replica is being // created. // // * UPDATING - The replica is being updated. // // * DELETING - The // replica is being deleted. // // * ACTIVE - The replica is ready for use. ReplicaStatus ReplicaStatus // Replica-specific global secondary index auto scaling settings. GlobalSecondaryIndexes []*ReplicaGlobalSecondaryIndexAutoScalingDescription }
Represents the auto scaling settings of the replica.
type ReplicaAutoScalingUpdate ¶
type ReplicaAutoScalingUpdate struct { // Represents the auto scaling settings of global secondary indexes that will be // modified. ReplicaGlobalSecondaryIndexUpdates []*ReplicaGlobalSecondaryIndexAutoScalingUpdate // Represents the auto scaling settings to be modified for a global table or global // secondary index. ReplicaProvisionedReadCapacityAutoScalingUpdate *AutoScalingSettingsUpdate // The Region where the replica exists. // // This member is required. RegionName *string }
Represents the auto scaling settings of a replica that will be modified.
type ReplicaDescription ¶
type ReplicaDescription struct { // The name of the Region. RegionName *string // Replica-specific global secondary index settings. GlobalSecondaryIndexes []*ReplicaGlobalSecondaryIndexDescription // Replica-specific provisioned throughput. If not described, uses the source // table's provisioned throughput settings. ProvisionedThroughputOverride *ProvisionedThroughputOverride // The current state of the replica: // // * CREATING - The replica is being // created. // // * UPDATING - The replica is being updated. // // * DELETING - The // replica is being deleted. // // * ACTIVE - The replica is ready for use. ReplicaStatus ReplicaStatus // Specifies the progress of a Create, Update, or Delete action on the replica as a // percentage. ReplicaStatusPercentProgress *string // The AWS KMS customer master key (CMK) of the replica that will be used for AWS // KMS encryption. KMSMasterKeyId *string // Detailed information about the replica status. ReplicaStatusDescription *string }
Contains the details of the replica.
type ReplicaGlobalSecondaryIndex ¶
type ReplicaGlobalSecondaryIndex struct { // The name of the global secondary index. // // This member is required. IndexName *string // Replica table GSI-specific provisioned throughput. If not specified, uses the // source table GSI's read capacity settings. ProvisionedThroughputOverride *ProvisionedThroughputOverride }
Represents the properties of a replica global secondary index.
type ReplicaGlobalSecondaryIndexAutoScalingDescription ¶
type ReplicaGlobalSecondaryIndexAutoScalingDescription struct { // Represents the auto scaling settings for a global table or global secondary // index. ProvisionedWriteCapacityAutoScalingSettings *AutoScalingSettingsDescription // Represents the auto scaling settings for a global table or global secondary // index. ProvisionedReadCapacityAutoScalingSettings *AutoScalingSettingsDescription // The name of the global secondary index. IndexName *string // The current state of the replica global secondary index: // // * CREATING - The // index is being created. // // * UPDATING - The index is being updated. // // * // DELETING - The index is being deleted. // // * ACTIVE - The index is ready for // use. IndexStatus IndexStatus }
Represents the auto scaling configuration for a replica global secondary index.
type ReplicaGlobalSecondaryIndexAutoScalingUpdate ¶
type ReplicaGlobalSecondaryIndexAutoScalingUpdate struct { // Represents the auto scaling settings to be modified for a global table or global // secondary index. ProvisionedReadCapacityAutoScalingUpdate *AutoScalingSettingsUpdate // The name of the global secondary index. IndexName *string }
Represents the auto scaling settings of a global secondary index for a replica that will be modified.
type ReplicaGlobalSecondaryIndexDescription ¶
type ReplicaGlobalSecondaryIndexDescription struct { // If not described, uses the source table GSI's read capacity settings. ProvisionedThroughputOverride *ProvisionedThroughputOverride // The name of the global secondary index. IndexName *string }
Represents the properties of a replica global secondary index.
type ReplicaGlobalSecondaryIndexSettingsDescription ¶
type ReplicaGlobalSecondaryIndexSettingsDescription struct { // Auto scaling settings for a global secondary index replica's write capacity // units. ProvisionedWriteCapacityAutoScalingSettings *AutoScalingSettingsDescription // The current status of the global secondary index: // // * CREATING - The global // secondary index is being created. // // * UPDATING - The global secondary index // is being updated. // // * DELETING - The global secondary index is being // deleted. // // * ACTIVE - The global secondary index is ready for use. IndexStatus IndexStatus // The maximum number of writes consumed per second before DynamoDB returns a // ThrottlingException. ProvisionedWriteCapacityUnits *int64 // The name of the global secondary index. The name must be unique among all other // indexes on this table. // // This member is required. IndexName *string // Auto scaling settings for a global secondary index replica's read capacity // units. ProvisionedReadCapacityAutoScalingSettings *AutoScalingSettingsDescription // The maximum number of strongly consistent reads consumed per second before // DynamoDB returns a ThrottlingException. ProvisionedReadCapacityUnits *int64 }
Represents the properties of a global secondary index.
type ReplicaGlobalSecondaryIndexSettingsUpdate ¶
type ReplicaGlobalSecondaryIndexSettingsUpdate struct { // Auto scaling settings for managing a global secondary index replica's read // capacity units. ProvisionedReadCapacityAutoScalingSettingsUpdate *AutoScalingSettingsUpdate // The maximum number of strongly consistent reads consumed per second before // DynamoDB returns a ThrottlingException. ProvisionedReadCapacityUnits *int64 // The name of the global secondary index. The name must be unique among all other // indexes on this table. // // This member is required. IndexName *string }
Represents the settings of a global secondary index for a global table that will be modified.
type ReplicaNotFoundException ¶
type ReplicaNotFoundException struct { Message *string }
The specified replica is no longer part of the global table.
func (*ReplicaNotFoundException) Error ¶
func (e *ReplicaNotFoundException) Error() string
func (*ReplicaNotFoundException) ErrorCode ¶
func (e *ReplicaNotFoundException) ErrorCode() string
func (*ReplicaNotFoundException) ErrorFault ¶
func (e *ReplicaNotFoundException) ErrorFault() smithy.ErrorFault
func (*ReplicaNotFoundException) ErrorMessage ¶
func (e *ReplicaNotFoundException) ErrorMessage() string
type ReplicaSettingsDescription ¶
type ReplicaSettingsDescription struct { // Auto scaling settings for a global table replica's write capacity units. ReplicaProvisionedWriteCapacityAutoScalingSettings *AutoScalingSettingsDescription // The maximum number of strongly consistent reads consumed per second before // DynamoDB returns a ThrottlingException. For more information, see Specifying // Read and Write Requirements // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html#ProvisionedThroughput) // in the Amazon DynamoDB Developer Guide. ReplicaProvisionedReadCapacityUnits *int64 // Auto scaling settings for a global table replica's read capacity units. ReplicaProvisionedReadCapacityAutoScalingSettings *AutoScalingSettingsDescription // The maximum number of writes consumed per second before DynamoDB returns a // ThrottlingException. For more information, see Specifying Read and Write // Requirements // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html#ProvisionedThroughput) // in the Amazon DynamoDB Developer Guide. ReplicaProvisionedWriteCapacityUnits *int64 // The Region name of the replica. // // This member is required. RegionName *string // The current state of the Region: // // * CREATING - The Region is being // created. // // * UPDATING - The Region is being updated. // // * DELETING - The // Region is being deleted. // // * ACTIVE - The Region is ready for use. ReplicaStatus ReplicaStatus // The read/write capacity mode of the replica. ReplicaBillingModeSummary *BillingModeSummary // Replica global secondary index settings for the global table. ReplicaGlobalSecondaryIndexSettings []*ReplicaGlobalSecondaryIndexSettingsDescription }
Represents the properties of a replica.
type ReplicaSettingsUpdate ¶
type ReplicaSettingsUpdate struct { // Auto scaling settings for managing a global table replica's read capacity units. ReplicaProvisionedReadCapacityAutoScalingSettingsUpdate *AutoScalingSettingsUpdate // Represents the settings of a global secondary index for a global table that will // be modified. ReplicaGlobalSecondaryIndexSettingsUpdate []*ReplicaGlobalSecondaryIndexSettingsUpdate // The Region of the replica to be added. // // This member is required. RegionName *string // The maximum number of strongly consistent reads consumed per second before // DynamoDB returns a ThrottlingException. For more information, see Specifying // Read and Write Requirements // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html#ProvisionedThroughput) // in the Amazon DynamoDB Developer Guide. ReplicaProvisionedReadCapacityUnits *int64 }
Represents the settings for a global table in a Region that will be modified.
type ReplicaStatus ¶
type ReplicaStatus string
const ( ReplicaStatusCreating ReplicaStatus = "CREATING" ReplicaStatusCreation_failed ReplicaStatus = "CREATION_FAILED" ReplicaStatusUpdating ReplicaStatus = "UPDATING" ReplicaStatusDeleting ReplicaStatus = "DELETING" ReplicaStatusActive ReplicaStatus = "ACTIVE" )
Enum values for ReplicaStatus
type ReplicaUpdate ¶
type ReplicaUpdate struct { // The parameters required for creating a replica on an existing global table. Create *CreateReplicaAction // The name of the existing replica to be removed. Delete *DeleteReplicaAction }
Represents one of the following:
- A new replica to be added to an existing
global table.
New parameters for an existing replica.
An existing
replica to be removed from an existing global table.
type ReplicationGroupUpdate ¶
type ReplicationGroupUpdate struct { // The parameters required for deleting a replica for the table. Delete *DeleteReplicationGroupMemberAction // The parameters required for creating a replica for the table. Create *CreateReplicationGroupMemberAction // The parameters required for updating a replica for the table. Update *UpdateReplicationGroupMemberAction }
Represents one of the following:
- A new replica to be added to an existing
regional table or global table. This request invokes the CreateTableReplica action in the destination Region.
- New parameters for an existing replica.
This request invokes the UpdateTable action in the destination Region.
- An
existing replica to be deleted. The request invokes the DeleteTableReplica action in the destination Region, deleting the replica and all if its items in the destination Region.
type RequestLimitExceeded ¶
type RequestLimitExceeded struct { Message *string }
Throughput exceeds the current throughput limit for your account. Please contact AWS Support at AWS Support (https://aws.amazon.com/support) to request a limit increase.
func (*RequestLimitExceeded) Error ¶
func (e *RequestLimitExceeded) Error() string
func (*RequestLimitExceeded) ErrorCode ¶
func (e *RequestLimitExceeded) ErrorCode() string
func (*RequestLimitExceeded) ErrorFault ¶
func (e *RequestLimitExceeded) ErrorFault() smithy.ErrorFault
func (*RequestLimitExceeded) ErrorMessage ¶
func (e *RequestLimitExceeded) ErrorMessage() string
type ResourceInUseException ¶
type ResourceInUseException struct { Message *string }
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.
func (*ResourceInUseException) Error ¶
func (e *ResourceInUseException) Error() string
func (*ResourceInUseException) ErrorCode ¶
func (e *ResourceInUseException) ErrorCode() string
func (*ResourceInUseException) ErrorFault ¶
func (e *ResourceInUseException) ErrorFault() smithy.ErrorFault
func (*ResourceInUseException) ErrorMessage ¶
func (e *ResourceInUseException) ErrorMessage() string
type ResourceNotFoundException ¶
type ResourceNotFoundException struct { Message *string }
The operation tried to access a nonexistent table or index. The resource might not be specified correctly, or its status might not be ACTIVE.
func (*ResourceNotFoundException) Error ¶
func (e *ResourceNotFoundException) Error() string
func (*ResourceNotFoundException) ErrorCode ¶
func (e *ResourceNotFoundException) ErrorCode() string
func (*ResourceNotFoundException) ErrorFault ¶
func (e *ResourceNotFoundException) ErrorFault() smithy.ErrorFault
func (*ResourceNotFoundException) ErrorMessage ¶
func (e *ResourceNotFoundException) ErrorMessage() string
type RestoreSummary ¶
type RestoreSummary struct { // The Amazon Resource Name (ARN) of the backup from which the table was restored. SourceBackupArn *string // The ARN of the source table of the backup that is being restored. SourceTableArn *string // Point in time or source backup time. // // This member is required. RestoreDateTime *time.Time // Indicates if a restore is in progress or not. // // This member is required. RestoreInProgress *bool }
Contains details for the restore.
type ReturnConsumedCapacity ¶
type ReturnConsumedCapacity string
const ( ReturnConsumedCapacityIndexes ReturnConsumedCapacity = "INDEXES" ReturnConsumedCapacityTotal ReturnConsumedCapacity = "TOTAL" ReturnConsumedCapacityNone ReturnConsumedCapacity = "NONE" )
Enum values for ReturnConsumedCapacity
type ReturnItemCollectionMetrics ¶
type ReturnItemCollectionMetrics string
const ( ReturnItemCollectionMetricsSize ReturnItemCollectionMetrics = "SIZE" ReturnItemCollectionMetricsNone ReturnItemCollectionMetrics = "NONE" )
Enum values for ReturnItemCollectionMetrics
type ReturnValue ¶
type ReturnValue string
const ( ReturnValueNone ReturnValue = "NONE" ReturnValueAll_old ReturnValue = "ALL_OLD" ReturnValueUpdated_old ReturnValue = "UPDATED_OLD" ReturnValueAll_new ReturnValue = "ALL_NEW" ReturnValueUpdated_new ReturnValue = "UPDATED_NEW" )
Enum values for ReturnValue
type ReturnValuesOnConditionCheckFailure ¶
type ReturnValuesOnConditionCheckFailure string
const ( ReturnValuesOnConditionCheckFailureAll_old ReturnValuesOnConditionCheckFailure = "ALL_OLD" ReturnValuesOnConditionCheckFailureNone ReturnValuesOnConditionCheckFailure = "NONE" )
Enum values for ReturnValuesOnConditionCheckFailure
type SSEDescription ¶
type SSEDescription struct { // Indicates the time, in UNIX epoch date format, when DynamoDB detected that the // table's AWS KMS key was inaccessible. This attribute will automatically be // cleared when DynamoDB detects that the table's AWS KMS key is accessible again. // DynamoDB will initiate the table archival process when table's AWS KMS key // remains inaccessible for more than seven days from this date. InaccessibleEncryptionDateTime *time.Time // Represents the current state of server-side encryption. The only supported // values are: // // * ENABLED - Server-side encryption is enabled. // // * UPDATING // - Server-side encryption is being updated. Status SSEStatus // The AWS KMS customer master key (CMK) ARN used for the AWS KMS encryption. KMSMasterKeyArn *string // Server-side encryption type. The only supported value is: // // * KMS - // Server-side encryption that uses AWS Key Management Service. The key is stored // in your account and is managed by AWS KMS (AWS KMS charges apply). SSEType SSEType }
The description of the server-side encryption status on the specified table.
type SSESpecification ¶
type SSESpecification struct { // The AWS KMS customer master key (CMK) that should be used for the AWS KMS // encryption. To specify a CMK, use its key ID, Amazon Resource Name (ARN), alias // name, or alias ARN. Note that you should only provide this parameter if the key // is different from the default DynamoDB customer master key alias/aws/dynamodb. KMSMasterKeyId *string // Server-side encryption type. The only supported value is: // // * KMS - // Server-side encryption that uses AWS Key Management Service. The key is stored // in your account and is managed by AWS KMS (AWS KMS charges apply). SSEType SSEType // Indicates whether server-side encryption is done using an AWS managed CMK or an // AWS owned CMK. If enabled (true), server-side encryption type is set to KMS and // an AWS managed CMK is used (AWS KMS charges apply). If disabled (false) or not // specified, server-side encryption is set to AWS owned CMK. Enabled *bool }
Represents the settings used to enable server-side encryption.
type SSEStatus ¶
type SSEStatus string
const ( SSEStatusEnabling SSEStatus = "ENABLING" SSEStatusEnabled SSEStatus = "ENABLED" SSEStatusDisabling SSEStatus = "DISABLING" SSEStatusDisabled SSEStatus = "DISABLED" SSEStatusUpdating SSEStatus = "UPDATING" )
Enum values for SSEStatus
type SSEType ¶
type SSEType string
Enum values for SSEType
type ScalarAttributeType ¶
type ScalarAttributeType string
const ( ScalarAttributeTypeS ScalarAttributeType = "S" ScalarAttributeTypeN ScalarAttributeType = "N" ScalarAttributeTypeB ScalarAttributeType = "B" )
Enum values for ScalarAttributeType
type Select ¶
type Select string
const ( SelectAll_attributes Select = "ALL_ATTRIBUTES" SelectAll_projected_attributes Select = "ALL_PROJECTED_ATTRIBUTES" SelectSpecific_attributes Select = "SPECIFIC_ATTRIBUTES" SelectCount Select = "COUNT" )
Enum values for Select
type SourceTableDetails ¶
type SourceTableDetails struct { // Read IOPs and Write IOPS on the table when the backup was created. // // This member is required. ProvisionedThroughput *ProvisionedThroughput // Unique identifier for the table for which the backup was created. // // This member is required. TableId *string // The name of the table for which the backup was created. // // This member is required. TableName *string // Number of items in the table. Note that this is an approximate value. ItemCount *int64 // Size of the table in bytes. Note that this is an approximate value. TableSizeBytes *int64 // Time when the source table was created. // // This member is required. TableCreationDateTime *time.Time // ARN of the table for which backup was created. TableArn *string // Schema of the table. // // This member is required. KeySchema []*KeySchemaElement // Controls how you are charged for read and write throughput and how you manage // capacity. This setting can be changed later. // // * PROVISIONED - Sets the // read/write capacity mode to PROVISIONED. We recommend using PROVISIONED for // predictable workloads. // // * PAY_PER_REQUEST - Sets the read/write capacity // mode to PAY_PER_REQUEST. We recommend using PAY_PER_REQUEST for unpredictable // workloads. BillingMode BillingMode }
Contains the details of the table when the backup was created.
type SourceTableFeatureDetails ¶
type SourceTableFeatureDetails struct { // Represents the LSI properties for the table when the backup was created. It // includes the IndexName, KeySchema and Projection for the LSIs on the table at // the time of backup. LocalSecondaryIndexes []*LocalSecondaryIndexInfo // Time to Live settings on the table when the backup was created. TimeToLiveDescription *TimeToLiveDescription // The description of the server-side encryption status on the table when the // backup was created. SSEDescription *SSEDescription // Stream settings on the table when the backup was created. StreamDescription *StreamSpecification // Represents the GSI properties for the table when the backup was created. It // includes the IndexName, KeySchema, Projection, and ProvisionedThroughput for the // GSIs on the table at the time of backup. GlobalSecondaryIndexes []*GlobalSecondaryIndexInfo }
Contains the details of the features enabled on the table when the backup was created. For example, LSIs, GSIs, streams, TTL.
type StreamSpecification ¶
type StreamSpecification struct { // When an item in the table is modified, StreamViewType determines what // information is written to the stream for this table. Valid values for // StreamViewType are: // // * KEYS_ONLY - Only the key attributes of the modified // item are written to the stream. // // * NEW_IMAGE - The entire item, as it // appears after it was modified, is written to the stream. // // * OLD_IMAGE - The // entire item, as it appeared before it was modified, is written to the stream. // // // * NEW_AND_OLD_IMAGES - Both the new and the old item images of the item are // written to the stream. StreamViewType StreamViewType // Indicates whether DynamoDB Streams is enabled (true) or disabled (false) on the // table. // // This member is required. StreamEnabled *bool }
Represents the DynamoDB Streams configuration for a table in DynamoDB.
type StreamViewType ¶
type StreamViewType string
const ( StreamViewTypeNew_image StreamViewType = "NEW_IMAGE" StreamViewTypeOld_image StreamViewType = "OLD_IMAGE" StreamViewTypeNew_and_old_images StreamViewType = "NEW_AND_OLD_IMAGES" StreamViewTypeKeys_only StreamViewType = "KEYS_ONLY" )
Enum values for StreamViewType
type TableAlreadyExistsException ¶
type TableAlreadyExistsException struct { Message *string }
A target table with the specified name already exists.
func (*TableAlreadyExistsException) Error ¶
func (e *TableAlreadyExistsException) Error() string
func (*TableAlreadyExistsException) ErrorCode ¶
func (e *TableAlreadyExistsException) ErrorCode() string
func (*TableAlreadyExistsException) ErrorFault ¶
func (e *TableAlreadyExistsException) ErrorFault() smithy.ErrorFault
func (*TableAlreadyExistsException) ErrorMessage ¶
func (e *TableAlreadyExistsException) ErrorMessage() string
type TableAutoScalingDescription ¶
type TableAutoScalingDescription struct { // The current state of the table: // // * CREATING - The table is being created. // // // * UPDATING - The table is being updated. // // * DELETING - The table is being // deleted. // // * ACTIVE - The table is ready for use. TableStatus TableStatus // The name of the table. TableName *string // Represents replicas of the global table. Replicas []*ReplicaAutoScalingDescription }
Represents the auto scaling configuration for a global table.
type TableDescription ¶
type TableDescription struct { // The description of the server-side encryption status on the specified table. SSEDescription *SSEDescription // Contains information about the table archive. ArchivalSummary *ArchivalSummary // Contains the details for the read/write capacity mode. BillingModeSummary *BillingModeSummary // The Amazon Resource Name (ARN) that uniquely identifies the latest stream for // this table. LatestStreamArn *string // The global secondary indexes, if any, on the table. Each index is scoped to a // given partition key value. Each element is composed of: // // * Backfilling - If // true, then the index is currently in the backfilling phase. Backfilling occurs // only when a new global secondary index is added to the table. It is the process // by which DynamoDB populates the new index with data from the table. (This // attribute does not appear for indexes that were created during a CreateTable // operation.) You can delete an index that is being created during the Backfilling // phase when IndexStatus is set to CREATING and Backfilling is true. You can't // delete the index that is being created when IndexStatus is set to CREATING and // Backfilling is false. (This attribute does not appear for indexes that were // created during a CreateTable operation.) // // * IndexName - The name of the // global secondary index. // // * IndexSizeBytes - The total size of the global // secondary index, in bytes. DynamoDB updates this value approximately every six // hours. Recent changes might not be reflected in this value. // // * IndexStatus - // The current status of the global secondary index: // // * CREATING - The // index is being created. // // * UPDATING - The index is being updated. // // // * DELETING - The index is being deleted. // // * ACTIVE - The index is ready // for use. // // * ItemCount - The number of items in the global secondary index. // DynamoDB updates this value approximately every six hours. Recent changes might // not be reflected in this value. // // * KeySchema - Specifies the complete index // key schema. The attribute names in the key schema must be between 1 and 255 // characters (inclusive). The key schema must begin with the same partition key as // the table. // // * Projection - Specifies attributes that are copied (projected) // from the table into the index. These are in addition to the primary key // attributes and index key attributes, which are automatically projected. Each // attribute specification is composed of: // // * ProjectionType - One of the // following: // // * KEYS_ONLY - Only the index and primary keys are // projected into the index. // // * INCLUDE - Only the specified table // attributes are projected into the index. The list of projected attributes is in // NonKeyAttributes. // // * ALL - All of the table attributes are projected // into the index. // // * NonKeyAttributes - A list of one or more non-key // attribute names that are projected into the secondary index. The total count of // attributes provided in NonKeyAttributes, summed across all of the secondary // indexes, must not exceed 20. If you project the same attribute into two // different indexes, this counts as two distinct attributes when determining the // total. // // * ProvisionedThroughput - The provisioned throughput settings for // the global secondary index, consisting of read and write capacity units, along // with data about increases and decreases. // // If the table is in the DELETING state, // no information about indexes will be returned. GlobalSecondaryIndexes []*GlobalSecondaryIndexDescription // An array of AttributeDefinition objects. Each of these objects describes one // attribute in the table and index key schema. Each AttributeDefinition object in // this array is composed of: // // * AttributeName - The name of the attribute. // // // * AttributeType - The data type for the attribute. AttributeDefinitions []*AttributeDefinition // The Amazon Resource Name (ARN) that uniquely identifies the table. TableArn *string // Represents the version of global tables // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html) // in use, if the table is replicated across AWS Regions. GlobalTableVersion *string // The provisioned throughput settings for the table, consisting of read and write // capacity units, along with data about increases and decreases. ProvisionedThroughput *ProvisionedThroughputDescription // Represents replicas of the table. Replicas []*ReplicaDescription // Unique identifier for the table for which the backup was created. TableId *string // The total size of the specified table, in bytes. DynamoDB updates this value // approximately every six hours. Recent changes might not be reflected in this // value. TableSizeBytes *int64 // The current state of the table: // // * CREATING - The table is being created. // // // * UPDATING - The table is being updated. // // * DELETING - The table is being // deleted. // // * ACTIVE - The table is ready for use. // // * // INACCESSIBLE_ENCRYPTION_CREDENTIALS - The AWS KMS key used to encrypt the table // in inaccessible. Table operations may fail due to failure to use the AWS KMS // key. DynamoDB will initiate the table archival process when a table's AWS KMS // key remains inaccessible for more than seven days. // // * ARCHIVING - The table // is being archived. Operations are not allowed until archival is complete. // // * // ARCHIVED - The table has been archived. See the ArchivalReason for more // information. TableStatus TableStatus // The current DynamoDB Streams configuration for the table. StreamSpecification *StreamSpecification // The primary key structure for the table. Each KeySchemaElement consists of: // // // * AttributeName - The name of the attribute. // // * KeyType - The role of the // attribute: // // * HASH - partition key // // * RANGE - sort key // // The // partition key of an item is also known as its hash attribute. The term "hash // attribute" derives from DynamoDB's usage of an internal hash function to evenly // distribute data items across partitions, based on their partition key values. // The sort key of an item is also known as its range attribute. The term "range // attribute" derives from the way DynamoDB stores items with the same partition // key physically close together, in sorted order by the sort key value. </li> // </ul> <p>For more information about primary keys, see <a // href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DataModel.html#DataModelPrimaryKey">Primary // Key</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p> KeySchema []*KeySchemaElement // Contains details for the restore. RestoreSummary *RestoreSummary // Represents one or more local secondary indexes on the table. Each index is // scoped to a given partition key value. Tables with one or more local secondary // indexes are subject to an item collection size limit, where the amount of data // within a given item collection cannot exceed 10 GB. Each element is composed // of: // // * IndexName - The name of the local secondary index. // // * KeySchema - // Specifies the complete index key schema. The attribute names in the key schema // must be between 1 and 255 characters (inclusive). The key schema must begin with // the same partition key as the table. // // * Projection - Specifies attributes // that are copied (projected) from the table into the index. These are in addition // to the primary key attributes and index key attributes, which are automatically // projected. Each attribute specification is composed of: // // * // ProjectionType - One of the following: // // * KEYS_ONLY - Only the index // and primary keys are projected into the index. // // * INCLUDE - Only the // specified table attributes are projected into the index. The list of projected // attributes is in NonKeyAttributes. // // * ALL - All of the table // attributes are projected into the index. // // * NonKeyAttributes - A list of // one or more non-key attribute names that are projected into the secondary index. // The total count of attributes provided in NonKeyAttributes, summed across all of // the secondary indexes, must not exceed 20. If you project the same attribute // into two different indexes, this counts as two distinct attributes when // determining the total. // // * IndexSizeBytes - Represents the total size of the // index, in bytes. DynamoDB updates this value approximately every six hours. // Recent changes might not be reflected in this value. // // * ItemCount - // Represents the number of items in the index. DynamoDB updates this value // approximately every six hours. Recent changes might not be reflected in this // value. // // If the table is in the DELETING state, no information about indexes will // be returned. LocalSecondaryIndexes []*LocalSecondaryIndexDescription // A timestamp, in ISO 8601 format, for this stream. <p>Note that // <code>LatestStreamLabel</code> is not a unique identifier for the stream, // because it is possible that a stream from another table might have the same // timestamp. However, the combination of the following three elements is // guaranteed to be unique:</p> <ul> <li> <p>AWS customer ID</p> </li> <li> // <p>Table name</p> </li> <li> <p> <code>StreamLabel</code> </p> </li> </ul> LatestStreamLabel *string // The date and time when the table was created, in UNIX epoch time // (http://www.epochconverter.com/) format. CreationDateTime *time.Time // The name of the table. TableName *string // The number of items in the specified table. DynamoDB updates this value // approximately every six hours. Recent changes might not be reflected in this // value. ItemCount *int64 }
Represents the properties of a table.
type TableInUseException ¶
type TableInUseException struct { Message *string }
A target table with the specified name is either being created or deleted.
func (*TableInUseException) Error ¶
func (e *TableInUseException) Error() string
func (*TableInUseException) ErrorCode ¶
func (e *TableInUseException) ErrorCode() string
func (*TableInUseException) ErrorFault ¶
func (e *TableInUseException) ErrorFault() smithy.ErrorFault
func (*TableInUseException) ErrorMessage ¶
func (e *TableInUseException) ErrorMessage() string
type TableNotFoundException ¶
type TableNotFoundException struct { Message *string }
A source table with the name TableName does not currently exist within the subscriber's account.
func (*TableNotFoundException) Error ¶
func (e *TableNotFoundException) Error() string
func (*TableNotFoundException) ErrorCode ¶
func (e *TableNotFoundException) ErrorCode() string
func (*TableNotFoundException) ErrorFault ¶
func (e *TableNotFoundException) ErrorFault() smithy.ErrorFault
func (*TableNotFoundException) ErrorMessage ¶
func (e *TableNotFoundException) ErrorMessage() string
type TableStatus ¶
type TableStatus string
const ( TableStatusCreating TableStatus = "CREATING" TableStatusUpdating TableStatus = "UPDATING" TableStatusDeleting TableStatus = "DELETING" TableStatusActive TableStatus = "ACTIVE" TableStatusInaccessible_encryption_credentials TableStatus = "INACCESSIBLE_ENCRYPTION_CREDENTIALS" TableStatusArchiving TableStatus = "ARCHIVING" TableStatusArchived TableStatus = "ARCHIVED" )
Enum values for TableStatus
type Tag ¶
type Tag struct { // The key of the tag. Tag keys are case sensitive. Each DynamoDB table can only // have up to one tag with the same key. If you try to add an existing tag (same // key), the existing tag value will be updated to the new value. // // This member is required. Key *string // The value of the tag. Tag values are case-sensitive and can be null. // // This member is required. Value *string }
Describes a tag. A tag is a key-value pair. You can add up to 50 tags to a single DynamoDB table. AWS-assigned tag names and values are automatically assigned the aws: prefix, which the user cannot assign. AWS-assigned tag names do not count towards the tag limit of 50. User-assigned tag names have the prefix user: in the Cost Allocation Report. You cannot backdate the application of a tag. For an overview on tagging DynamoDB resources, see Tagging for DynamoDB (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.html) in the Amazon DynamoDB Developer Guide.
type TimeToLiveDescription ¶
type TimeToLiveDescription struct { // The TTL status for the table. TimeToLiveStatus TimeToLiveStatus // The name of the TTL attribute for items in the table. AttributeName *string }
The description of the Time to Live (TTL) status on the specified table.
type TimeToLiveSpecification ¶
type TimeToLiveSpecification struct { // Indicates whether TTL is to be enabled (true) or disabled (false) on the table. // // This member is required. Enabled *bool // The name of the TTL attribute used to store the expiration time for items in the // table. // // This member is required. AttributeName *string }
Represents the settings used to enable or disable Time to Live (TTL) for the specified table.
type TimeToLiveStatus ¶
type TimeToLiveStatus string
const ( TimeToLiveStatusEnabling TimeToLiveStatus = "ENABLING" TimeToLiveStatusDisabling TimeToLiveStatus = "DISABLING" TimeToLiveStatusEnabled TimeToLiveStatus = "ENABLED" TimeToLiveStatusDisabled TimeToLiveStatus = "DISABLED" )
Enum values for TimeToLiveStatus
type TransactGetItem ¶
type TransactGetItem struct { // Contains the primary key that identifies the item to get, together with the name // of the table that contains the item, and optionally the specific attributes of // the item to retrieve. // // This member is required. Get *Get }
Specifies an item to be retrieved as part of the transaction.
type TransactWriteItem ¶
type TransactWriteItem struct { // A request to perform a PutItem operation. Put *Put // A request to perform a check item operation. ConditionCheck *ConditionCheck // A request to perform an UpdateItem operation. Update *Update // A request to perform a DeleteItem operation. Delete *Delete }
A list of requests that can perform update, put, delete, or check operations on multiple items in one or more tables atomically.
type TransactionCanceledException ¶
type TransactionCanceledException struct { Message *string CancellationReasons []*CancellationReason }
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.
<p>DynamoDB cancels a
<code>TransactGetItems</code> request under the following circumstances:</p> <ul> <li> <p>There is an ongoing <code>TransactGetItems</code> operation that conflicts with a concurrent <code>PutItem</code>, <code>UpdateItem</code>, <code>DeleteItem</code> or <code>TransactWriteItems</code> request. In this case the <code>TransactGetItems</code> operation fails with a <code>TransactionCanceledException</code>.</p> </li> <li> <p>A table in the <code>TransactGetItems</code> request is in a different account or region.</p> </li> <li> <p>There is insufficient provisioned capacity for the transaction to be completed.</p> </li> <li> <p>There is a user error, such as an invalid data format.</p> </li> </ul> <note> <p>If using Java, DynamoDB lists the cancellation reasons on the <code>CancellationReasons</code> 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 <code>NONE</code> code and <code>Null</code> message.</p> </note> <p>Cancellation reason codes and possible error messages:</p> <ul> <li> <p>No Errors:</p> <ul> <li> <p>Code: <code>NONE</code> </p> </li> <li> <p>Message: <code>null</code> </p> </li> </ul> </li> <li> <p>Conditional Check Failed:</p> <ul> <li> <p>Code: <code>ConditionalCheckFailed</code> </p> </li> <li> <p>Message: The conditional request failed. </p> </li> </ul> </li> <li> <p>Item Collection Size Limit Exceeded:</p> <ul> <li> <p>Code: <code>ItemCollectionSizeLimitExceeded</code> </p> </li> <li> <p>Message: Collection size exceeded.</p> </li> </ul> </li> <li> <p>Transaction Conflict:</p> <ul> <li> <p>Code: <code>TransactionConflict</code> </p> </li> <li> <p>Message: Transaction is ongoing for the item.</p> </li> </ul> </li> <li> <p>Provisioned Throughput Exceeded:</p> <ul> <li> <p>Code: <code>ProvisionedThroughputExceeded</code> </p> </li> <li> <p>Messages: </p> <ul> <li> <p>The level of configured provisioned throughput for the table was exceeded. Consider increasing your provisioning level with the UpdateTable API.</p> <note> <p>This Message is received when provisioned throughput is exceeded is on a provisioned DynamoDB table.</p> </note> </li> <li> <p>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.</p> <note> <p>This message is returned when provisioned throughput is exceeded is on a provisioned GSI.</p> </note> </li> </ul> </li> </ul> </li> <li> <p>Throttling Error:</p> <ul> <li> <p>Code: <code>ThrottlingError</code> </p> </li> <li> <p>Messages: </p> <ul> <li> <p>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.</p> <note> <p>This message is returned when writes get throttled on an On-Demand table as DynamoDB is automatically scaling the table.</p> </note> </li> <li> <p>Throughput exceeds the current capacity for one or more global secondary indexes. DynamoDB is automatically scaling your index so please try again shortly.</p> <note> <p>This message is returned when when writes get throttled on an On-Demand GSI as DynamoDB is automatically scaling the GSI.</p> </note> </li> </ul> </li> </ul> </li> <li> <p>Validation Error:</p> <ul> <li> <p>Code: <code>ValidationError</code> </p> </li> <li> <p>Messages: </p> <ul> <li> <p>One or more parameter values were invalid.</p> </li> <li> <p>The update expression attempted to update the secondary index key beyond allowed size limits.</p> </li> <li> <p>The update expression attempted to update the secondary index key to unsupported type.</p> </li> <li> <p>An operand in the update expression has an incorrect data type.</p> </li> <li> <p>Item size to update has exceeded the maximum allowed size.</p> </li> <li> <p>Number overflow. Attempting to store a number with magnitude larger than supported range.</p> </li> <li> <p>Type mismatch for attribute to update.</p> </li> <li> <p>Nesting Levels have exceeded supported limits.</p> </li> <li> <p>The document path provided in the update expression is invalid for update.</p> </li> <li> <p>The provided expression refers to an attribute that does not exist in the item.</p> </li> </ul> </li> </ul> </li> </ul>
func (*TransactionCanceledException) Error ¶
func (e *TransactionCanceledException) Error() string
func (*TransactionCanceledException) ErrorCode ¶
func (e *TransactionCanceledException) ErrorCode() string
func (*TransactionCanceledException) ErrorFault ¶
func (e *TransactionCanceledException) ErrorFault() smithy.ErrorFault
func (*TransactionCanceledException) ErrorMessage ¶
func (e *TransactionCanceledException) ErrorMessage() string
type TransactionConflictException ¶
type TransactionConflictException struct { Message *string }
Operation was rejected because there is an ongoing transaction for the item.
func (*TransactionConflictException) Error ¶
func (e *TransactionConflictException) Error() string
func (*TransactionConflictException) ErrorCode ¶
func (e *TransactionConflictException) ErrorCode() string
func (*TransactionConflictException) ErrorFault ¶
func (e *TransactionConflictException) ErrorFault() smithy.ErrorFault
func (*TransactionConflictException) ErrorMessage ¶
func (e *TransactionConflictException) ErrorMessage() string
type TransactionInProgressException ¶
type TransactionInProgressException struct { Message *string }
The transaction with the given request token is already in progress.
func (*TransactionInProgressException) Error ¶
func (e *TransactionInProgressException) Error() string
func (*TransactionInProgressException) ErrorCode ¶
func (e *TransactionInProgressException) ErrorCode() string
func (*TransactionInProgressException) ErrorFault ¶
func (e *TransactionInProgressException) ErrorFault() smithy.ErrorFault
func (*TransactionInProgressException) ErrorMessage ¶
func (e *TransactionInProgressException) ErrorMessage() string
type Update ¶
type Update struct { // One or more substitution tokens for attribute names in an expression. ExpressionAttributeNames map[string]*string // An expression that defines one or more attributes to be updated, the action to // be performed on them, and new value(s) for them. // // This member is required. UpdateExpression *string // Name of the table for the UpdateItem request. // // This member is required. TableName *string // A condition that must be satisfied in order for a conditional update to succeed. ConditionExpression *string // The primary key of the item to be updated. Each element consists of an attribute // name and a value for that attribute. // // This member is required. Key map[string]*AttributeValue // One or more values that can be substituted in an expression. ExpressionAttributeValues map[string]*AttributeValue // Use ReturnValuesOnConditionCheckFailure to get the item attributes if the Update // condition fails. For ReturnValuesOnConditionCheckFailure, the valid values are: // NONE, ALL_OLD, UPDATED_OLD, ALL_NEW, UPDATED_NEW. ReturnValuesOnConditionCheckFailure ReturnValuesOnConditionCheckFailure }
Represents a request to perform an UpdateItem operation.
type UpdateGlobalSecondaryIndexAction ¶
type UpdateGlobalSecondaryIndexAction struct { // Represents the provisioned throughput settings for the specified global // secondary index. For current minimum and maximum provisioned throughput values, // see Limits // (https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html) // in the Amazon DynamoDB Developer Guide. // // This member is required. ProvisionedThroughput *ProvisionedThroughput // The name of the global secondary index to be updated. // // This member is required. IndexName *string }
Represents the new provisioned throughput settings to be applied to a global secondary index.
type UpdateReplicationGroupMemberAction ¶
type UpdateReplicationGroupMemberAction struct { // The Region where the replica exists. // // This member is required. RegionName *string // Replica-specific provisioned throughput. If not specified, uses the source // table's provisioned throughput settings. ProvisionedThroughputOverride *ProvisionedThroughputOverride // Replica-specific global secondary index settings. GlobalSecondaryIndexes []*ReplicaGlobalSecondaryIndex // The AWS KMS customer master key (CMK) of the replica that should be used for AWS // KMS encryption. To specify a CMK, use its key ID, Amazon Resource Name (ARN), // alias name, or alias ARN. Note that you should only provide this parameter if // the key is different from the default DynamoDB KMS master key // alias/aws/dynamodb. KMSMasterKeyId *string }
Represents a replica to be modified.
type WriteRequest ¶
type WriteRequest struct { // A request to perform a DeleteItem operation. DeleteRequest *DeleteRequest // A request to perform a PutItem operation. PutRequest *PutRequest }
Represents an operation to perform - either DeleteItem or PutItem. You can only request one of these operations, not both, in a single WriteRequest. If you do need to perform both of these operations, you need to provide two separate WriteRequest objects.
Source Files ¶
- Version
- v0.26.0
- Published
- Oct 1, 2020
- Platform
- js/wasm
- Imports
- 3 packages
- Last checked
- 28 seconds ago –
Tools for package owners.