Skip to content

PutObjectAnnotationRequest

Source code in docs_src/capo_s3/types/put_object_annotation_request.py
class PutObjectAnnotationRequest(TypedDict, closed=True):
    bucket: "capo_s3.types.bucket_name.BucketName"
    """<p>The name of the bucket that contains the object.</p>"""
    key: "capo_s3.types.object_key.ObjectKey"
    """<p>The object key.</p>"""
    version_id: NotRequired["capo_s3.types.object_version_id.ObjectVersionId"]
    """<p>The version ID of the object to attach the annotation to.</p>"""
    annotation_name: "capo_s3.types.annotation_name.AnnotationName"
    """<p>The name of the annotation.</p> <p>Length Constraints: Minimum length of 1. Maximum length of 512 bytes.</p>"""
    annotation_payload: "capo_s3.types.streaming_blob.StreamingBlob"
    """<p>The annotation payload. Must be between 1 byte and 1 MiB in size, and must be valid UTF-8 encoded text. If the payload contains invalid UTF-8 bytes, the request fails with HTTP 415 (Unsupported Media Type). To store binary data, encode the payload using Base64 before uploading.</p>"""
    object_if_match: NotRequired["capo_s3.types.object_if_match.ObjectIfMatch"]
    """<p>If specified, the operation only succeeds if the object's ETag matches the provided value.</p>"""
    checksum_algorithm: NotRequired[
        "capo_s3.types.checksum_algorithm.ChecksumAlgorithm"
    ]
    """<p>The checksum algorithm to use. Supported values: <code>CRC32</code>, <code>CRC32C</code>, <code>CRC64NVME</code>, <code>SHA1</code>, <code>SHA256</code>, <code>SHA512</code>, <code>MD5</code>, <code>XXHASH64</code>, <code>XXHASH3</code>, <code>XXHASH128</code>.</p>"""
    checksum_crc32: NotRequired["capo_s3.types.checksum_crc32.ChecksumCRC32"]
    """<p>Base64-encoded CRC32 checksum of the annotation payload.</p>"""
    checksum_crc32_c: NotRequired["capo_s3.types.checksum_crc32_c.ChecksumCRC32C"]
    """<p>Base64-encoded CRC32C checksum of the annotation payload.</p>"""
    checksum_crc64_nvme: NotRequired[
        "capo_s3.types.checksum_crc64_nvme.ChecksumCRC64NVME"
    ]
    """<p>Base64-encoded CRC64NVME checksum of the annotation payload.</p>"""
    checksum_sha1: NotRequired["capo_s3.types.checksum_sha1.ChecksumSHA1"]
    """<p>Base64-encoded SHA1 checksum of the annotation payload.</p>"""
    checksum_sha256: NotRequired["capo_s3.types.checksum_sha256.ChecksumSHA256"]
    """<p>Base64-encoded SHA256 checksum of the annotation payload.</p>"""
    checksum_sha512: NotRequired["capo_s3.types.checksum_sha512.ChecksumSHA512"]
    """<p>Base64-encoded SHA512 checksum of the annotation payload.</p>"""
    checksum_md5: NotRequired["capo_s3.types.checksum_md5.ChecksumMD5"]
    """<p>Base64-encoded MD5 checksum of the annotation payload.</p>"""
    checksum_xxhash64: NotRequired["capo_s3.types.checksum_xxhash64.ChecksumXXHASH64"]
    """<p>Base64-encoded XXHASH64 checksum of the annotation payload.</p>"""
    checksum_xxhash3: NotRequired["capo_s3.types.checksum_xxhash3.ChecksumXXHASH3"]
    """<p>Base64-encoded XXHASH3 checksum of the annotation payload.</p>"""
    checksum_xxhash128: NotRequired[
        "capo_s3.types.checksum_xxhash128.ChecksumXXHASH128"
    ]
    """<p>Base64-encoded XXHASH128 checksum of the annotation payload.</p>"""
    content_md5: NotRequired["capo_s3.types.content_md5.ContentMD5"]
    """<p>Base64-encoded MD5 digest of the message.</p>"""
    request_payer: NotRequired["capo_s3.types.request_payer.RequestPayer"]
    expected_bucket_owner: NotRequired["capo_s3.types.account_id.AccountId"]
    """<p>The account ID of the expected bucket owner. If the bucket is owned by a different account, the request fails with an HTTP 403 (Access Denied) error.</p>"""

annotation_name instance-attribute

annotation_name: AnnotationName

The name of the annotation.

Length Constraints: Minimum length of 1. Maximum length of 512 bytes.

annotation_payload instance-attribute

annotation_payload: StreamingBlob

The annotation payload. Must be between 1 byte and 1 MiB in size, and must be valid UTF-8 encoded text. If the payload contains invalid UTF-8 bytes, the request fails with HTTP 415 (Unsupported Media Type). To store binary data, encode the payload using Base64 before uploading.

bucket instance-attribute

bucket: BucketName

The name of the bucket that contains the object.

checksum_algorithm instance-attribute

checksum_algorithm: NotRequired[ChecksumAlgorithm]

The checksum algorithm to use. Supported values: CRC32, CRC32C, CRC64NVME, SHA1, SHA256, SHA512, MD5, XXHASH64, XXHASH3, XXHASH128.

checksum_crc32 instance-attribute

checksum_crc32: NotRequired[ChecksumCRC32]

Base64-encoded CRC32 checksum of the annotation payload.

checksum_crc32_c instance-attribute

checksum_crc32_c: NotRequired[ChecksumCRC32C]

Base64-encoded CRC32C checksum of the annotation payload.

checksum_crc64_nvme instance-attribute

checksum_crc64_nvme: NotRequired[ChecksumCRC64NVME]

Base64-encoded CRC64NVME checksum of the annotation payload.

checksum_md5 instance-attribute

checksum_md5: NotRequired[ChecksumMD5]

Base64-encoded MD5 checksum of the annotation payload.

checksum_sha1 instance-attribute

checksum_sha1: NotRequired[ChecksumSHA1]

Base64-encoded SHA1 checksum of the annotation payload.

checksum_sha256 instance-attribute

checksum_sha256: NotRequired[ChecksumSHA256]

Base64-encoded SHA256 checksum of the annotation payload.

checksum_sha512 instance-attribute

checksum_sha512: NotRequired[ChecksumSHA512]

Base64-encoded SHA512 checksum of the annotation payload.

checksum_xxhash128 instance-attribute

checksum_xxhash128: NotRequired[ChecksumXXHASH128]

Base64-encoded XXHASH128 checksum of the annotation payload.

checksum_xxhash3 instance-attribute

checksum_xxhash3: NotRequired[ChecksumXXHASH3]

Base64-encoded XXHASH3 checksum of the annotation payload.

checksum_xxhash64 instance-attribute

checksum_xxhash64: NotRequired[ChecksumXXHASH64]

Base64-encoded XXHASH64 checksum of the annotation payload.

content_md5 instance-attribute

content_md5: NotRequired[ContentMD5]

Base64-encoded MD5 digest of the message.

expected_bucket_owner instance-attribute

expected_bucket_owner: NotRequired[AccountId]

The account ID of the expected bucket owner. If the bucket is owned by a different account, the request fails with an HTTP 403 (Access Denied) error.

key instance-attribute

key: ObjectKey

The object key.

object_if_match instance-attribute

object_if_match: NotRequired[ObjectIfMatch]

If specified, the operation only succeeds if the object's ETag matches the provided value.

request_payer instance-attribute

request_payer: NotRequired[RequestPayer]

version_id instance-attribute

version_id: NotRequired[ObjectVersionId]

The version ID of the object to attach the annotation to.