Write Get Object Response
| s3_write_get_object_response | R Documentation |
This operation is not supported for directory buckets¶
Description¶
This operation is not supported for directory buckets.
Passes transformed objects to a get_object operation when using Object
Lambda access points. For information about Object Lambda access points,
see Transforming objects with Object Lambda access
points
in the Amazon S3 User Guide.
This operation supports metadata that can be returned by get_object,
in addition to RequestRoute, RequestToken, StatusCode,
ErrorCode, and ErrorMessage. The get_object response metadata is
supported so that the write_get_object_response caller, typically an
Lambda function, can provide the same metadata when it internally
invokes get_object. When write_get_object_response is called by a
customer-owned Lambda function, the metadata returned to the end user
get_object call might differ from what Amazon S3 would normally
return.
You can include any number of metadata headers. When including a
metadata header, it should be prefaced with x-amz-meta. For example,
x-amz-meta-my-custom-header: MyCustomValue. The primary use case for
this is to forward get_object metadata.
Amazon Web Services provides some prebuilt Lambda functions that you can use with S3 Object Lambda to detect and redact personally identifiable information (PII) and decompress S3 objects. These Lambda functions are available in the Amazon Web Services Serverless Application Repository, and can be selected through the Amazon Web Services Management Console when you create your Object Lambda access point.
Example 1: PII Access Control - This Lambda function uses Amazon Comprehend, a natural language processing (NLP) service using machine learning to find insights and relationships in text. It automatically detects personally identifiable information (PII) such as names, addresses, dates, credit card numbers, and social security numbers from documents in your Amazon S3 bucket.
Example 2: PII Redaction - This Lambda function uses Amazon Comprehend, a natural language processing (NLP) service using machine learning to find insights and relationships in text. It automatically redacts personally identifiable information (PII) such as names, addresses, dates, credit card numbers, and social security numbers from documents in your Amazon S3 bucket.
Example 3: Decompression - The Lambda function S3ObjectLambdaDecompression, is equipped to decompress objects stored in S3 in one of six compressed file formats including bzip2, gzip, snappy, zlib, zstandard and ZIP.
For information on how to view and use these functions, see Using Amazon Web Services built Lambda functions in the Amazon S3 User Guide.
Usage¶
s3_write_get_object_response(RequestRoute, RequestToken, Body,
StatusCode, ErrorCode, ErrorMessage, AcceptRanges, CacheControl,
ContentDisposition, ContentEncoding, ContentLanguage, ContentLength,
ContentRange, ContentType, ChecksumCRC32, ChecksumCRC32C,
ChecksumCRC64NVME, ChecksumSHA1, ChecksumSHA256, DeleteMarker, ETag,
Expires, Expiration, LastModified, MissingMeta, Metadata,
ObjectLockMode, ObjectLockLegalHoldStatus, ObjectLockRetainUntilDate,
PartsCount, ReplicationStatus, RequestCharged, Restore,
ServerSideEncryption, SSECustomerAlgorithm, SSEKMSKeyId,
SSECustomerKeyMD5, StorageClass, TagCount, VersionId, BucketKeyEnabled)
Arguments¶
RequestRoute |
[required] Route prefix to the HTTP URL generated. |
RequestToken |
[required] A single use encrypted token that maps
|
Body |
The object data. |
StatusCode |
The integer status code for an HTTP response of a corresponding
|
ErrorCode |
A string that uniquely identifies an error condition. Returned in
the \<Code\> tag of the error XML response for a corresponding
|
ErrorMessage |
Contains a generic description of the error condition. Returned
in the \<Message\> tag of the error XML response for a
corresponding |
AcceptRanges |
Indicates that a range of bytes was specified. |
CacheControl |
Specifies caching behavior along the request/reply chain. |
ContentDisposition |
Specifies presentational information for the object. |
ContentEncoding |
Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. |
ContentLanguage |
The language the content is in. |
ContentLength |
The size of the content body in bytes. |
ContentRange |
The portion of the object returned in the response. |
ContentType |
A standard MIME type describing the format of the object data. |
ChecksumCRC32 |
This header can be used as a data integrity check to verify that
the data received is the same data that was originally sent. This
specifies the Base64 encoded, 32-bit Only one checksum header can be specified at a time. If you supply multiple checksum headers, this request will fail. |
ChecksumCRC32C |
This header can be used as a data integrity check to verify that
the data received is the same data that was originally sent. This
specifies the Base64 encoded, 32-bit Only one checksum header can be specified at a time. If you supply multiple checksum headers, this request will fail. |
ChecksumCRC64NVME |
This header can be used as a data integrity check to verify that
the data received is the same data that was originally sent. This header
specifies the Base64 encoded, 64-bit |
ChecksumSHA1 |
This header can be used as a data integrity check to verify that
the data received is the same data that was originally sent. This
specifies the Base64 encoded, 160-bit Only one checksum header can be specified at a time. If you supply multiple checksum headers, this request will fail. |
ChecksumSHA256 |
This header can be used as a data integrity check to verify that
the data received is the same data that was originally sent. This
specifies the Base64 encoded, 256-bit Only one checksum header can be specified at a time. If you supply multiple checksum headers, this request will fail. |
DeleteMarker |
Specifies whether an object stored in Amazon S3 is
( |
ETag |
An opaque identifier assigned by a web server to a specific version of a resource found at a URL. |
Expires |
The date and time at which the object is no longer cacheable. |
Expiration |
If the object expiration is configured (see PUT Bucket
lifecycle), the response includes this header. It includes the
|
LastModified |
The date and time that the object was last modified. |
MissingMeta |
Set to the number of metadata entries not returned in
|
Metadata |
A map of metadata to store with the object in S3. |
ObjectLockMode |
Indicates whether an object stored in Amazon S3 has Object Lock enabled. For more information about S3 Object Lock, see Object Lock. |
ObjectLockLegalHoldStatus |
Indicates whether an object stored in Amazon S3 has an active legal hold. |
ObjectLockRetainUntilDate |
The date and time when Object Lock is configured to expire. |
PartsCount |
The count of parts this object has. |
ReplicationStatus |
Indicates if request involves bucket that is either a source or destination in a Replication rule. For more information about S3 Replication, see Replication. |
RequestCharged |
|
Restore |
Provides information about object restoration operation and expiration time of the restored object copy. |
ServerSideEncryption |
The server-side encryption algorithm used when storing requested
object in Amazon S3 (for example, AES256,
|
SSECustomerAlgorithm |
Encryption algorithm used if server-side encryption with a customer-provided encryption key was specified for object stored in Amazon S3. |
SSEKMSKeyId |
If present, specifies the ID (Key ID, Key ARN, or Key Alias) of the Amazon Web Services Key Management Service (Amazon Web Services KMS) symmetric encryption customer managed key that was used for stored in Amazon S3 object. |
SSECustomerKeyMD5 |
128-bit MD5 digest of customer-provided encryption key used in Amazon S3 to encrypt data stored in S3. For more information, see Protecting data using server-side encryption with customer-provided encryption keys (SSE-C). |
StorageClass |
Provides storage class information of the object. Amazon S3 returns this header for all objects except for S3 Standard storage class objects. For more information, see Storage Classes. |
TagCount |
The number of tags, if any, on the object. |
VersionId |
An ID used to reference a specific version of the object. |
BucketKeyEnabled |
Indicates whether the object stored in Amazon S3 uses an S3 bucket key for server-side encryption with Amazon Web Services KMS (SSE-KMS). |
Value¶
An empty list.
Request syntax¶
svc$write_get_object_response(
RequestRoute = "string",
RequestToken = "string",
Body = raw,
StatusCode = 123,
ErrorCode = "string",
ErrorMessage = "string",
AcceptRanges = "string",
CacheControl = "string",
ContentDisposition = "string",
ContentEncoding = "string",
ContentLanguage = "string",
ContentLength = 123,
ContentRange = "string",
ContentType = "string",
ChecksumCRC32 = "string",
ChecksumCRC32C = "string",
ChecksumCRC64NVME = "string",
ChecksumSHA1 = "string",
ChecksumSHA256 = "string",
DeleteMarker = TRUE|FALSE,
ETag = "string",
Expires = as.POSIXct(
"2015-01-01"
),
Expiration = "string",
LastModified = as.POSIXct(
"2015-01-01"
),
MissingMeta = 123,
Metadata = list(
"string"
),
ObjectLockMode = "GOVERNANCE"|"COMPLIANCE",
ObjectLockLegalHoldStatus = "ON"|"OFF",
ObjectLockRetainUntilDate = as.POSIXct(
"2015-01-01"
),
PartsCount = 123,
ReplicationStatus = "COMPLETE"|"PENDING"|"FAILED"|"REPLICA"|"COMPLETED",
RequestCharged = "requester",
Restore = "string",
ServerSideEncryption = "AES256"|"aws:kms"|"aws:kms:dsse",
SSECustomerAlgorithm = "string",
SSEKMSKeyId = "string",
SSECustomerKeyMD5 = "string",
StorageClass = "STANDARD"|"REDUCED_REDUNDANCY"|"STANDARD_IA"|"ONEZONE_IA"|"INTELLIGENT_TIERING"|"GLACIER"|"DEEP_ARCHIVE"|"OUTPOSTS"|"GLACIER_IR"|"SNOW"|"EXPRESS_ONEZONE",
TagCount = 123,
VersionId = "string",
BucketKeyEnabled = TRUE|FALSE
)