Class IdempotencyPolicy (2.20.0)

Define the interface for the idempotency policy.

The idempotency policy controls which requests are treated as idempotent and therefore safe to retry on a transient failure. Non-idempotent operations can result in data loss. For example, consider DeleteObject(), if this operation is called without pre-conditions retrying this operation may delete more than one version of an object, which may not have the desired effect. Even operations that "add" data can result in data loss, consider InsertObjectMedia(), if called without pre-conditions retrying this operation will insert multiple new versions, possibly deleting old data if the bucket is configured to keep only N versions of each object.

Some applications are designed to handle duplicate requests without data loss, or the library may be used in an environment where the risk of data loss due to duplicate requests is negligible or zero.

This policy allows application developers to control the behavior of the library with respect to retrying non-idempotent operations. Application developers can configure the library to only retry operations that are known to be idempotent (that is, they will succeed only once). Application may also configure the library to retry all operations, regardless of whether the operations are idempotent or not.

Functions

IsIdempotent(internal::ListBucketsRequest const &) const

Bucket resource operations

Parameter
Name	Description
`request`	`internal::ListBucketsRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::CreateBucketRequest const &) const

Bucket resource operations

Parameter
Name	Description
`request`	`internal::CreateBucketRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::GetBucketMetadataRequest const &) const

Bucket resource operations

Parameter
Name	Description
`request`	`internal::GetBucketMetadataRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::DeleteBucketRequest const &) const

Bucket resource operations

Parameter
Name	Description
`request`	`internal::DeleteBucketRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::UpdateBucketRequest const &) const

Bucket resource operations

Parameter
Name	Description
`request`	`internal::UpdateBucketRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::PatchBucketRequest const &) const

Bucket resource operations

Parameter
Name	Description
`request`	`internal::PatchBucketRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::GetBucketIamPolicyRequest const &) const

Bucket resource operations

Parameter
Name	Description
`request`	`internal::GetBucketIamPolicyRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::SetNativeBucketIamPolicyRequest const &) const

Bucket resource operations

Parameter
Name	Description
`request`	`internal::SetNativeBucketIamPolicyRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::TestBucketIamPermissionsRequest const &) const

Bucket resource operations

Parameter
Name	Description
`request`	`internal::TestBucketIamPermissionsRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::LockBucketRetentionPolicyRequest const &) const

Bucket resource operations

Parameter
Name	Description
`request`	`internal::LockBucketRetentionPolicyRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::InsertObjectMediaRequest const &) const

Object resource operations

Parameter
Name	Description
`request`	`internal::InsertObjectMediaRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::CopyObjectRequest const &) const

Object resource operations

Parameter
Name	Description
`request`	`internal::CopyObjectRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::GetObjectMetadataRequest const &) const

Object resource operations

Parameter
Name	Description
`request`	`internal::GetObjectMetadataRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::ReadObjectRangeRequest const &) const

Object resource operations

Parameter
Name	Description
`request`	`internal::ReadObjectRangeRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::ListObjectsRequest const &) const

Object resource operations

Parameter
Name	Description
`request`	`internal::ListObjectsRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::DeleteObjectRequest const &) const

Object resource operations

Parameter
Name	Description
`request`	`internal::DeleteObjectRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::UpdateObjectRequest const &) const

Object resource operations

Parameter
Name	Description
`request`	`internal::UpdateObjectRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::PatchObjectRequest const &) const

Object resource operations

Parameter
Name	Description
`request`	`internal::PatchObjectRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::ComposeObjectRequest const &) const

Object resource operations

Parameter
Name	Description
`request`	`internal::ComposeObjectRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::RewriteObjectRequest const &) const

Object resource operations

Parameter
Name	Description
`request`	`internal::RewriteObjectRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::ResumableUploadRequest const &) const

Object resource operations

Parameter
Name	Description
`request`	`internal::ResumableUploadRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::UploadChunkRequest const &) const

Object resource operations

Parameter
Name	Description
`request`	`internal::UploadChunkRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::ListBucketAclRequest const &) const

BucketAccessControls resource operations

Parameter
Name	Description
`request`	`internal::ListBucketAclRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::CreateBucketAclRequest const &) const

BucketAccessControls resource operations

Parameter
Name	Description
`request`	`internal::CreateBucketAclRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::DeleteBucketAclRequest const &) const

BucketAccessControls resource operations

Parameter
Name	Description
`request`	`internal::DeleteBucketAclRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::GetBucketAclRequest const &) const

BucketAccessControls resource operations

Parameter
Name	Description
`request`	`internal::GetBucketAclRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::UpdateBucketAclRequest const &) const

BucketAccessControls resource operations

Parameter
Name	Description
`request`	`internal::UpdateBucketAclRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::PatchBucketAclRequest const &) const

BucketAccessControls resource operations

Parameter
Name	Description
`request`	`internal::PatchBucketAclRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::ListObjectAclRequest const &) const

ObjectAccessControls operations

Parameter
Name	Description
`request`	`internal::ListObjectAclRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::CreateObjectAclRequest const &) const

ObjectAccessControls operations

Parameter
Name	Description
`request`	`internal::CreateObjectAclRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::DeleteObjectAclRequest const &) const

ObjectAccessControls operations

Parameter
Name	Description
`request`	`internal::DeleteObjectAclRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::GetObjectAclRequest const &) const

ObjectAccessControls operations

Parameter
Name	Description
`request`	`internal::GetObjectAclRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::UpdateObjectAclRequest const &) const

ObjectAccessControls operations

Parameter
Name	Description
`request`	`internal::UpdateObjectAclRequest const &`

Returns
Type	Description
`bool`

IsIdempotent(internal::PatchObjectAclRequest const &) const

ObjectAccessControls operations

Parameter
Name	Description
`request`	`internal::PatchObjectAclRequest const &`

Returns
Type	Description
`bool`