Package software.amazon.awssdk.services.s3.model

Class PutObjectRequest

java.lang.Object

software.amazon.awssdk.AmazonWebServiceRequest

software.amazon.awssdk.services.s3.model.PutObjectRequest

All Implemented Interfaces:

Cloneable, ReadLimitInfo, ToCopyableBuilder<PutObjectRequest.Builder,PutObjectRequest>

@Generated("software.amazon.awssdk:codegen")
public class PutObjectRequest
extends AmazonWebServiceRequest
implements ToCopyableBuilder<PutObjectRequest.Builder,PutObjectRequest>

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	PutObjectRequest.Builder

Field Summary

Fields inherited from class software.amazon.awssdk.AmazonWebServiceRequest

NOOP

Method Summary

Modifier and Type	Method	Description
String	acl()	The canned ACL to apply to the object.
String	bucket()	Name of the bucket to which the PUT operation was initiated.
static PutObjectRequest.Builder	builder()
String	cacheControl()	Specifies caching behavior along the request/reply chain.
String	contentDisposition()	Specifies presentational information for the object.
String	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.
String	contentLanguage()	The language the content is in.
Long	contentLength()	Size of the body in bytes.
String	contentMD5()	The base64-encoded 128-bit MD5 digest of the part data.
String	contentType()	A standard MIME type describing the format of the object data.
boolean	equals(Object obj)
Date	expires()	The date and time at which the object is no longer cacheable.
String	grantFullControl()	Gives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object.
String	grantRead()	Allows grantee to read the object data and its metadata.
String	grantReadACP()	Allows grantee to read the object ACL.
String	grantWriteACP()	Allows grantee to write the ACL for the applicable object.
int	hashCode()
String	key()	Object key for which the PUT operation was initiated.
Map<String,String>	metadata()	A map of metadata to store with the object in S3.
String	requestPayer()
static Class<? extends PutObjectRequest.Builder>	serializableBuilderClass()
String	serverSideEncryption()	The Server-side encryption algorithm used when storing this object in S3 (e.g., AES256, aws:kms).
String	sseCustomerAlgorithm()	Specifies the algorithm to use to when encrypting the object (e.g., AES256).
String	sseCustomerKey()	Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data.
String	sseCustomerKeyMD5()	Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321.
String	ssekmsKeyId()	Specifies the AWS KMS key ID to use for object encryption.
String	storageClass()	The type of storage to use for the object.
String	tagging()	The tag-set for the object.
PutObjectRequest.Builder	toBuilder()	Take this object and create a builder that contains all of the current property values of this object.
String	toString()
String	websiteRedirectLocation()	If the bucket is configured as a website, redirects requests for this object to another object in the same bucket or to an external URL.

Methods inherited from class software.amazon.awssdk.AmazonWebServiceRequest

clone, getCloneRoot, getCloneSource, getCustomQueryParameters, getCustomRequestHeaders, getGeneralProgressListener, getReadLimit, getRequestClientOptions, getRequestCredentialsProvider, getRequestMetricCollector, getSdkClientExecutionTimeout, putCustomQueryParameter, putCustomRequestHeader, setGeneralProgressListener, setRequestCredentials, setRequestCredentialsProvider, setRequestMetricCollector, setSdkClientExecutionTimeout, withGeneralProgressListener, withRequestMetricCollector, withSdkClientExecutionTimeout

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Detail

acl

public String acl()

The canned ACL to apply to the object.

Returns:

The canned ACL to apply to the object.

See Also:

ObjectCannedACL

bucket

public String bucket()

Name of the bucket to which the PUT operation was initiated.

Returns:

Name of the bucket to which the PUT operation was initiated.

cacheControl

public String cacheControl()

Specifies caching behavior along the request/reply chain.

Returns:

Specifies caching behavior along the request/reply chain.

contentDisposition

public String contentDisposition()

Specifies presentational information for the object.

Returns:

Specifies presentational information for the object.

contentEncoding

public String 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.

Returns:

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

public String contentLanguage()

The language the content is in.

Returns:

The language the content is in.

contentLength

public Long contentLength()

Size of the body in bytes. This parameter is useful when the size of the body cannot be determined automatically.

Returns:

Size of the body in bytes. This parameter is useful when the size of the body cannot be determined automatically.

contentMD5

public String contentMD5()

The base64-encoded 128-bit MD5 digest of the part data.

Returns:

The base64-encoded 128-bit MD5 digest of the part data.

contentType

public String contentType()

A standard MIME type describing the format of the object data.

Returns:

A standard MIME type describing the format of the object data.

expires

public Date expires()

The date and time at which the object is no longer cacheable.

Returns:

The date and time at which the object is no longer cacheable.

grantFullControl

public String grantFullControl()

Gives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object.

Returns:

Gives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object.

grantRead

public String grantRead()

Allows grantee to read the object data and its metadata.

Returns:

Allows grantee to read the object data and its metadata.

grantReadACP

public String grantReadACP()

Allows grantee to read the object ACL.

Returns:

Allows grantee to read the object ACL.

grantWriteACP

public String grantWriteACP()

Allows grantee to write the ACL for the applicable object.

Returns:

Allows grantee to write the ACL for the applicable object.

key

public String key()

Object key for which the PUT operation was initiated.

Returns:

Object key for which the PUT operation was initiated.

metadata

public Map<String,String> metadata()

A map of metadata to store with the object in S3.

Returns:

A map of metadata to store with the object in S3.

serverSideEncryption

public String serverSideEncryption()

The Server-side encryption algorithm used when storing this object in S3 (e.g., AES256, aws:kms).

Returns:

The Server-side encryption algorithm used when storing this object in S3 (e.g., AES256, aws:kms).

See Also:

ServerSideEncryption

storageClass

public String storageClass()

The type of storage to use for the object. Defaults to 'STANDARD'.

Returns:

The type of storage to use for the object. Defaults to 'STANDARD'.

See Also:

StorageClass

websiteRedirectLocation

public String websiteRedirectLocation()

If the bucket is configured as a website, redirects requests for this object to another object in the same bucket or to an external URL. Amazon S3 stores the value of this header in the object metadata.

Returns:

If the bucket is configured as a website, redirects requests for this object to another object in the same bucket or to an external URL. Amazon S3 stores the value of this header in the object metadata.

sseCustomerAlgorithm

public String sseCustomerAlgorithm()

Specifies the algorithm to use to when encrypting the object (e.g., AES256).

Returns:

Specifies the algorithm to use to when encrypting the object (e.g., AES256).

sseCustomerKey

public String sseCustomerKey()

Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon does not store the encryption key. The key must be appropriate for use with the algorithm specified in the x-amz-server-side-encryption-customer-algorithm header.

Returns:

Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon does not store the encryption key. The key must be appropriate for use with the algorithm specified in the x-amz-server-side-encryption-customer-algorithm header.

sseCustomerKeyMD5

public String sseCustomerKeyMD5()

Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure the encryption key was transmitted without error.

Returns:

Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure the encryption key was transmitted without error.

ssekmsKeyId

public String ssekmsKeyId()

Specifies the AWS KMS key ID to use for object encryption. All GET and PUT requests for an object protected by AWS KMS will fail if not made via SSL or using SigV4. Documentation on configuring any of the officially supported AWS SDKs and CLI can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version

Returns:

Specifies the AWS KMS key ID to use for object encryption. All GET and PUT requests for an object protected by AWS KMS will fail if not made via SSL or using SigV4. Documentation on configuring any of the officially supported AWS SDKs and CLI can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version

requestPayer

public String requestPayer()

Returns:

See Also:

RequestPayer

tagging

public String tagging()

The tag-set for the object. The tag-set must be encoded as URL Query parameters

Returns:

The tag-set for the object. The tag-set must be encoded as URL Query parameters

toBuilder

public PutObjectRequest.Builder toBuilder()

Description copied from interface: ToCopyableBuilder

Take this object and create a builder that contains all of the current property values of this object.

Specified by:

toBuilder in interface ToCopyableBuilder<PutObjectRequest.Builder,PutObjectRequest>

Returns:

a builder for type T

builder

public static PutObjectRequest.Builder builder()

serializableBuilderClass

public static Class<? extends PutObjectRequest.Builder> serializableBuilderClass()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object