|
|
// Code generated by smithy-go-codegen DO NOT EDIT.
|
|
|
|
|
|
package s3
|
|
|
|
|
|
import (
|
|
|
"context"
|
|
|
awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware"
|
|
|
"github.com/aws/aws-sdk-go-v2/aws/signer/v4"
|
|
|
awshttp "github.com/aws/aws-sdk-go-v2/aws/transport/http"
|
|
|
internalChecksum "github.com/aws/aws-sdk-go-v2/service/internal/checksum"
|
|
|
s3cust "github.com/aws/aws-sdk-go-v2/service/s3/internal/customizations"
|
|
|
"github.com/aws/aws-sdk-go-v2/service/s3/types"
|
|
|
"github.com/aws/smithy-go/middleware"
|
|
|
smithyhttp "github.com/aws/smithy-go/transport/http"
|
|
|
"io"
|
|
|
"time"
|
|
|
)
|
|
|
|
|
|
// Adds an object to a bucket. You must have WRITE permissions on a bucket to add
|
|
|
// an object to it. Amazon S3 never adds partial objects; if you receive a success
|
|
|
// response, Amazon S3 added the entire object to the bucket. Amazon S3 is a
|
|
|
// distributed system. If it receives multiple write requests for the same object
|
|
|
// simultaneously, it overwrites all but the last object written. Amazon S3 does
|
|
|
// not provide object locking; if you need this, make sure to build it into your
|
|
|
// application layer or use versioning instead. To ensure that data is not
|
|
|
// corrupted traversing the network, use the Content-MD5 header. When you use this
|
|
|
// header, Amazon S3 checks the object against the provided MD5 value and, if they
|
|
|
// do not match, returns an error. Additionally, you can calculate the MD5 while
|
|
|
// putting an object to Amazon S3 and compare the returned ETag to the calculated
|
|
|
// MD5 value.
|
|
|
//
|
|
|
// * To successfully complete the PutObject request, you must have the
|
|
|
// s3:PutObject in your IAM permissions.
|
|
|
//
|
|
|
// * To successfully change the objects acl
|
|
|
// of your PutObject request, you must have the s3:PutObjectAcl in your IAM
|
|
|
// permissions.
|
|
|
//
|
|
|
// * The Content-MD5 header is required for any request to upload an
|
|
|
// object with a retention period configured using Amazon S3 Object Lock. For more
|
|
|
// information about Amazon S3 Object Lock, see Amazon S3 Object Lock Overview
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html) in
|
|
|
// the Amazon S3 User Guide.
|
|
|
//
|
|
|
// Server-side Encryption You can optionally request
|
|
|
// server-side encryption. With server-side encryption, Amazon S3 encrypts your
|
|
|
// data as it writes it to disks in its data centers and decrypts the data when you
|
|
|
// access it. You have the option to provide your own encryption key or use Amazon
|
|
|
// Web Services managed encryption keys (SSE-S3 or SSE-KMS). For more information,
|
|
|
// see Using Server-Side Encryption
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html).
|
|
|
// If you request server-side encryption using Amazon Web Services Key Management
|
|
|
// Service (SSE-KMS), you can enable an S3 Bucket Key at the object-level. For more
|
|
|
// information, see Amazon S3 Bucket Keys
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html) in the Amazon
|
|
|
// S3 User Guide. Access Control List (ACL)-Specific Request Headers You can use
|
|
|
// headers to grant ACL- based permissions. By default, all objects are private.
|
|
|
// Only the owner has full access control. When adding a new object, you can grant
|
|
|
// permissions to individual Amazon Web Services accounts or to predefined groups
|
|
|
// defined by Amazon S3. These permissions are then added to the ACL on the object.
|
|
|
// For more information, see Access Control List (ACL) Overview
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html) and Managing
|
|
|
// ACLs Using the REST API
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html). If
|
|
|
// the bucket that you're uploading objects to uses the bucket owner enforced
|
|
|
// setting for S3 Object Ownership, ACLs are disabled and no longer affect
|
|
|
// permissions. Buckets that use this setting only accept PUT requests that don't
|
|
|
// specify an ACL or PUT requests that specify bucket owner full control ACLs, such
|
|
|
// as the bucket-owner-full-control canned ACL or an equivalent form of this ACL
|
|
|
// expressed in the XML format. PUT requests that contain other ACLs (for example,
|
|
|
// custom grants to certain Amazon Web Services accounts) fail and return a 400
|
|
|
// error with the error code AccessControlListNotSupported. For more information,
|
|
|
// see Controlling ownership of objects and disabling ACLs
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html)
|
|
|
// in the Amazon S3 User Guide. If your bucket uses the bucket owner enforced
|
|
|
// setting for Object Ownership, all objects written to the bucket by any account
|
|
|
// will be owned by the bucket owner. Storage Class Options By default, Amazon S3
|
|
|
// uses the STANDARD Storage Class to store newly created objects. The STANDARD
|
|
|
// storage class provides high durability and high availability. Depending on
|
|
|
// performance needs, you can specify a different Storage Class. Amazon S3 on
|
|
|
// Outposts only uses the OUTPOSTS Storage Class. For more information, see Storage
|
|
|
// Classes
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html) in
|
|
|
// the Amazon S3 User Guide. Versioning If you enable versioning for a bucket,
|
|
|
// Amazon S3 automatically generates a unique version ID for the object being
|
|
|
// stored. Amazon S3 returns this ID in the response. When you enable versioning
|
|
|
// for a bucket, if Amazon S3 receives multiple write requests for the same object
|
|
|
// simultaneously, it stores all of the objects. For more information about
|
|
|
// versioning, see Adding Objects to Versioning Enabled Buckets
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html).
|
|
|
// For information about returning the versioning state of a bucket, see
|
|
|
// GetBucketVersioning
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html).
|
|
|
// Related Resources
|
|
|
//
|
|
|
// * CopyObject
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html)
|
|
|
//
|
|
|
// *
|
|
|
// DeleteObject
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)
|
|
|
func (c *Client) PutObject(ctx context.Context, params *PutObjectInput, optFns ...func(*Options)) (*PutObjectOutput, error) {
|
|
|
if params == nil {
|
|
|
params = &PutObjectInput{}
|
|
|
}
|
|
|
|
|
|
result, metadata, err := c.invokeOperation(ctx, "PutObject", params, optFns, c.addOperationPutObjectMiddlewares)
|
|
|
if err != nil {
|
|
|
return nil, err
|
|
|
}
|
|
|
|
|
|
out := result.(*PutObjectOutput)
|
|
|
out.ResultMetadata = metadata
|
|
|
return out, nil
|
|
|
}
|
|
|
|
|
|
type PutObjectInput struct {
|
|
|
|
|
|
// The bucket name to which the PUT action was initiated. When using this action
|
|
|
// with an access point, you must direct requests to the access point hostname. The
|
|
|
// access point hostname takes the form
|
|
|
// AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com. When using this
|
|
|
// action with an access point through the Amazon Web Services SDKs, you provide
|
|
|
// the access point ARN in place of the bucket name. For more information about
|
|
|
// access point ARNs, see Using access points
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
|
|
|
// in the Amazon S3 User Guide. When using this action with Amazon S3 on Outposts,
|
|
|
// you must direct requests to the S3 on Outposts hostname. The S3 on Outposts
|
|
|
// hostname takes the form
|
|
|
// AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When using
|
|
|
// this action with S3 on Outposts through the Amazon Web Services SDKs, you
|
|
|
// provide the Outposts bucket ARN in place of the bucket name. For more
|
|
|
// information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the
|
|
|
// Amazon S3 User Guide.
|
|
|
//
|
|
|
// This member is required.
|
|
|
Bucket *string
|
|
|
|
|
|
// Object key for which the PUT action was initiated.
|
|
|
//
|
|
|
// This member is required.
|
|
|
Key *string
|
|
|
|
|
|
// The canned ACL to apply to the object. For more information, see Canned ACL
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL).
|
|
|
// This action is not supported by Amazon S3 on Outposts.
|
|
|
ACL types.ObjectCannedACL
|
|
|
|
|
|
// Object data.
|
|
|
Body io.Reader
|
|
|
|
|
|
// Specifies whether Amazon S3 should use an S3 Bucket Key for object encryption
|
|
|
// with server-side encryption using AWS KMS (SSE-KMS). Setting this header to true
|
|
|
// causes Amazon S3 to use an S3 Bucket Key for object encryption with SSE-KMS.
|
|
|
// Specifying this header with a PUT action doesn’t affect bucket-level settings
|
|
|
// for S3 Bucket Key.
|
|
|
BucketKeyEnabled bool
|
|
|
|
|
|
// Can be used to specify caching behavior along the request/reply chain. For more
|
|
|
// information, see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9
|
|
|
// (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9).
|
|
|
CacheControl *string
|
|
|
|
|
|
// Indicates the algorithm used to create the checksum for the object when using
|
|
|
// the SDK. This header will not provide any additional functionality if not using
|
|
|
// the SDK. When sending this header, there must be a corresponding x-amz-checksum
|
|
|
// or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with the
|
|
|
// HTTP status code 400 Bad Request. For more information, see Checking object
|
|
|
// integrity
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
|
|
|
// in the Amazon S3 User Guide. If you provide an individual checksum, Amazon S3
|
|
|
// ignores any provided ChecksumAlgorithm parameter.
|
|
|
ChecksumAlgorithm types.ChecksumAlgorithm
|
|
|
|
|
|
// 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, 32-bit CRC32 checksum of the object. For more information, see
|
|
|
// Checking object integrity
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
|
|
|
// in the Amazon S3 User Guide.
|
|
|
ChecksumCRC32 *string
|
|
|
|
|
|
// 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, 32-bit CRC32C checksum of the object. For more information, see
|
|
|
// Checking object integrity
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
|
|
|
// in the Amazon S3 User Guide.
|
|
|
ChecksumCRC32C *string
|
|
|
|
|
|
// 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, 160-bit SHA-1 digest of the object. For more information, see
|
|
|
// Checking object integrity
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
|
|
|
// in the Amazon S3 User Guide.
|
|
|
ChecksumSHA1 *string
|
|
|
|
|
|
// 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, 256-bit SHA-256 digest of the object. For more information, see
|
|
|
// Checking object integrity
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
|
|
|
// in the Amazon S3 User Guide.
|
|
|
ChecksumSHA256 *string
|
|
|
|
|
|
// Specifies presentational information for the object. For more information, see
|
|
|
// http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1
|
|
|
// (http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1).
|
|
|
ContentDisposition *string
|
|
|
|
|
|
// 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. For more information, see
|
|
|
// http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11
|
|
|
// (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11).
|
|
|
ContentEncoding *string
|
|
|
|
|
|
// The language the content is in.
|
|
|
ContentLanguage *string
|
|
|
|
|
|
// Size of the body in bytes. This parameter is useful when the size of the body
|
|
|
// cannot be determined automatically. For more information, see
|
|
|
// http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13
|
|
|
// (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13).
|
|
|
ContentLength int64
|
|
|
|
|
|
// The base64-encoded 128-bit MD5 digest of the message (without the headers)
|
|
|
// according to RFC 1864. This header can be used as a message integrity check to
|
|
|
// verify that the data is the same data that was originally sent. Although it is
|
|
|
// optional, we recommend using the Content-MD5 mechanism as an end-to-end
|
|
|
// integrity check. For more information about REST request authentication, see
|
|
|
// REST Authentication
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html).
|
|
|
ContentMD5 *string
|
|
|
|
|
|
// A standard MIME type describing the format of the contents. For more
|
|
|
// information, see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17
|
|
|
// (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17).
|
|
|
ContentType *string
|
|
|
|
|
|
// The account ID of the expected bucket owner. If the bucket is owned by a
|
|
|
// different account, the request fails with the HTTP status code 403 Forbidden
|
|
|
// (access denied).
|
|
|
ExpectedBucketOwner *string
|
|
|
|
|
|
// The date and time at which the object is no longer cacheable. For more
|
|
|
// information, see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21
|
|
|
// (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21).
|
|
|
Expires *time.Time
|
|
|
|
|
|
// Gives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object. This
|
|
|
// action is not supported by Amazon S3 on Outposts.
|
|
|
GrantFullControl *string
|
|
|
|
|
|
// Allows grantee to read the object data and its metadata. This action is not
|
|
|
// supported by Amazon S3 on Outposts.
|
|
|
GrantRead *string
|
|
|
|
|
|
// Allows grantee to read the object ACL. This action is not supported by Amazon S3
|
|
|
// on Outposts.
|
|
|
GrantReadACP *string
|
|
|
|
|
|
// Allows grantee to write the ACL for the applicable object. This action is not
|
|
|
// supported by Amazon S3 on Outposts.
|
|
|
GrantWriteACP *string
|
|
|
|
|
|
// A map of metadata to store with the object in S3.
|
|
|
Metadata map[string]string
|
|
|
|
|
|
// Specifies whether a legal hold will be applied to this object. For more
|
|
|
// information about S3 Object Lock, see Object Lock
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html).
|
|
|
ObjectLockLegalHoldStatus types.ObjectLockLegalHoldStatus
|
|
|
|
|
|
// The Object Lock mode that you want to apply to this object.
|
|
|
ObjectLockMode types.ObjectLockMode
|
|
|
|
|
|
// The date and time when you want this object's Object Lock to expire. Must be
|
|
|
// formatted as a timestamp parameter.
|
|
|
ObjectLockRetainUntilDate *time.Time
|
|
|
|
|
|
// Confirms that the requester knows that they will be charged for the request.
|
|
|
// Bucket owners need not specify this parameter in their requests. For information
|
|
|
// about downloading objects from Requester Pays buckets, see Downloading Objects
|
|
|
// in Requester Pays Buckets
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
|
|
|
// in the Amazon S3 User Guide.
|
|
|
RequestPayer types.RequestPayer
|
|
|
|
|
|
// Specifies the algorithm to use to when encrypting the object (for example,
|
|
|
// AES256).
|
|
|
SSECustomerAlgorithm *string
|
|
|
|
|
|
// 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 S3 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.
|
|
|
SSECustomerKey *string
|
|
|
|
|
|
// 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 that the
|
|
|
// encryption key was transmitted without error.
|
|
|
SSECustomerKeyMD5 *string
|
|
|
|
|
|
// Specifies the Amazon Web Services KMS Encryption Context to use for object
|
|
|
// encryption. The value of this header is a base64-encoded UTF-8 string holding
|
|
|
// JSON with the encryption context key-value pairs.
|
|
|
SSEKMSEncryptionContext *string
|
|
|
|
|
|
// If x-amz-server-side-encryption is present and has the value of aws:kms, this
|
|
|
// header specifies the ID of the Amazon Web Services Key Management Service
|
|
|
// (Amazon Web Services KMS) symmetrical customer managed key that was used for the
|
|
|
// object. If you specify x-amz-server-side-encryption:aws:kms, but do not provide
|
|
|
// x-amz-server-side-encryption-aws-kms-key-id, Amazon S3 uses the Amazon Web
|
|
|
// Services managed key to protect the data. If the KMS key does not exist in the
|
|
|
// same account issuing the command, you must use the full ARN and not just the ID.
|
|
|
SSEKMSKeyId *string
|
|
|
|
|
|
// The server-side encryption algorithm used when storing this object in Amazon S3
|
|
|
// (for example, AES256, aws:kms).
|
|
|
ServerSideEncryption types.ServerSideEncryption
|
|
|
|
|
|
// By default, Amazon S3 uses the STANDARD Storage Class to store newly created
|
|
|
// objects. The STANDARD storage class provides high durability and high
|
|
|
// availability. Depending on performance needs, you can specify a different
|
|
|
// Storage Class. Amazon S3 on Outposts only uses the OUTPOSTS Storage Class. For
|
|
|
// more information, see Storage Classes
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html) in
|
|
|
// the Amazon S3 User Guide.
|
|
|
StorageClass types.StorageClass
|
|
|
|
|
|
// The tag-set for the object. The tag-set must be encoded as URL Query parameters.
|
|
|
// (For example, "Key1=Value1")
|
|
|
Tagging *string
|
|
|
|
|
|
// 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. For information about object
|
|
|
// metadata, see Object Key and Metadata
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html). In the
|
|
|
// following example, the request header sets the redirect to an object
|
|
|
// (anotherPage.html) in the same bucket: x-amz-website-redirect-location:
|
|
|
// /anotherPage.html In the following example, the request header sets the object
|
|
|
// redirect to another website: x-amz-website-redirect-location:
|
|
|
// http://www.example.com/ For more information about website hosting in Amazon S3,
|
|
|
// see Hosting Websites on Amazon S3
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html) and How to
|
|
|
// Configure Website Page Redirects
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/dev/how-to-page-redirect.html).
|
|
|
WebsiteRedirectLocation *string
|
|
|
|
|
|
noSmithyDocumentSerde
|
|
|
}
|
|
|
|
|
|
type PutObjectOutput struct {
|
|
|
|
|
|
// Indicates whether the uploaded object uses an S3 Bucket Key for server-side
|
|
|
// encryption with Amazon Web Services KMS (SSE-KMS).
|
|
|
BucketKeyEnabled bool
|
|
|
|
|
|
// The base64-encoded, 32-bit CRC32 checksum of the object. This will only be
|
|
|
// present if it was uploaded with the object. With multipart uploads, this may not
|
|
|
// be a checksum value of the object. For more information about how checksums are
|
|
|
// calculated with multipart uploads, see Checking object integrity
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
|
|
|
// in the Amazon S3 User Guide.
|
|
|
ChecksumCRC32 *string
|
|
|
|
|
|
// The base64-encoded, 32-bit CRC32C checksum of the object. This will only be
|
|
|
// present if it was uploaded with the object. With multipart uploads, this may not
|
|
|
// be a checksum value of the object. For more information about how checksums are
|
|
|
// calculated with multipart uploads, see Checking object integrity
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
|
|
|
// in the Amazon S3 User Guide.
|
|
|
ChecksumCRC32C *string
|
|
|
|
|
|
// The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
|
|
|
// present if it was uploaded with the object. With multipart uploads, this may not
|
|
|
// be a checksum value of the object. For more information about how checksums are
|
|
|
// calculated with multipart uploads, see Checking object integrity
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
|
|
|
// in the Amazon S3 User Guide.
|
|
|
ChecksumSHA1 *string
|
|
|
|
|
|
// The base64-encoded, 256-bit SHA-256 digest of the object. This will only be
|
|
|
// present if it was uploaded with the object. With multipart uploads, this may not
|
|
|
// be a checksum value of the object. For more information about how checksums are
|
|
|
// calculated with multipart uploads, see Checking object integrity
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
|
|
|
// in the Amazon S3 User Guide.
|
|
|
ChecksumSHA256 *string
|
|
|
|
|
|
// Entity tag for the uploaded object.
|
|
|
ETag *string
|
|
|
|
|
|
// If the expiration is configured for the object (see
|
|
|
// PutBucketLifecycleConfiguration
|
|
|
// (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html)),
|
|
|
// the response includes this header. It includes the expiry-date and rule-id
|
|
|
// key-value pairs that provide information about object expiration. The value of
|
|
|
// the rule-id is URL-encoded.
|
|
|
Expiration *string
|
|
|
|
|
|
// If present, indicates that the requester was successfully charged for the
|
|
|
// request.
|
|
|
RequestCharged types.RequestCharged
|
|
|
|
|
|
// If server-side encryption with a customer-provided encryption key was requested,
|
|
|
// the response will include this header confirming the encryption algorithm used.
|
|
|
SSECustomerAlgorithm *string
|
|
|
|
|
|
// If server-side encryption with a customer-provided encryption key was requested,
|
|
|
// the response will include this header to provide round-trip message integrity
|
|
|
// verification of the customer-provided encryption key.
|
|
|
SSECustomerKeyMD5 *string
|
|
|
|
|
|
// If present, specifies the Amazon Web Services KMS Encryption Context to use for
|
|
|
// object encryption. The value of this header is a base64-encoded UTF-8 string
|
|
|
// holding JSON with the encryption context key-value pairs.
|
|
|
SSEKMSEncryptionContext *string
|
|
|
|
|
|
// If x-amz-server-side-encryption is present and has the value of aws:kms, this
|
|
|
// header specifies the ID of the Amazon Web Services Key Management Service
|
|
|
// (Amazon Web Services KMS) symmetric customer managed key that was used for the
|
|
|
// object.
|
|
|
SSEKMSKeyId *string
|
|
|
|
|
|
// If you specified server-side encryption either with an Amazon Web Services KMS
|
|
|
// key or Amazon S3-managed encryption key in your PUT request, the response
|
|
|
// includes this header. It confirms the encryption algorithm that Amazon S3 used
|
|
|
// to encrypt the object.
|
|
|
ServerSideEncryption types.ServerSideEncryption
|
|
|
|
|
|
// Version of the object.
|
|
|
VersionId *string
|
|
|
|
|
|
// Metadata pertaining to the operation's result.
|
|
|
ResultMetadata middleware.Metadata
|
|
|
|
|
|
noSmithyDocumentSerde
|
|
|
}
|
|
|
|
|
|
func (c *Client) addOperationPutObjectMiddlewares(stack *middleware.Stack, options Options) (err error) {
|
|
|
err = stack.Serialize.Add(&awsRestxml_serializeOpPutObject{}, middleware.After)
|
|
|
if err != nil {
|
|
|
return err
|
|
|
}
|
|
|
err = stack.Deserialize.Add(&awsRestxml_deserializeOpPutObject{}, middleware.After)
|
|
|
if err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = addSetLoggerMiddleware(stack, options); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = addResolveEndpointMiddleware(stack, options); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = addRetryMiddlewares(stack, options); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = addHTTPSignerV4Middleware(stack, options); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = addClientUserAgent(stack); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = swapWithCustomHTTPSignerMiddleware(stack, options); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = addOpPutObjectValidationMiddleware(stack); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = stack.Initialize.Add(newServiceMetadataMiddleware_opPutObject(options.Region), middleware.Before); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = addMetadataRetrieverMiddleware(stack); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = addPutObjectInputChecksumMiddlewares(stack, options); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = addPutObjectUpdateEndpoint(stack, options); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = addResponseErrorMiddleware(stack); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = v4.AddContentSHA256HeaderMiddleware(stack); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = v4.UseDynamicPayloadSigningMiddleware(stack); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = disableAcceptEncodingGzip(stack); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
if err = addRequestResponseLogging(stack, options); err != nil {
|
|
|
return err
|
|
|
}
|
|
|
return nil
|
|
|
}
|
|
|
|
|
|
func newServiceMetadataMiddleware_opPutObject(region string) *awsmiddleware.RegisterServiceMetadata {
|
|
|
return &awsmiddleware.RegisterServiceMetadata{
|
|
|
Region: region,
|
|
|
ServiceID: ServiceID,
|
|
|
SigningName: "s3",
|
|
|
OperationName: "PutObject",
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// getPutObjectRequestAlgorithmMember gets the request checksum algorithm value
|
|
|
// provided as input.
|
|
|
func getPutObjectRequestAlgorithmMember(input interface{}) (string, bool) {
|
|
|
in := input.(*PutObjectInput)
|
|
|
if len(in.ChecksumAlgorithm) == 0 {
|
|
|
return "", false
|
|
|
}
|
|
|
return string(in.ChecksumAlgorithm), true
|
|
|
}
|
|
|
|
|
|
func addPutObjectInputChecksumMiddlewares(stack *middleware.Stack, options Options) error {
|
|
|
return internalChecksum.AddInputMiddleware(stack, internalChecksum.InputMiddlewareOptions{
|
|
|
GetAlgorithm: getPutObjectRequestAlgorithmMember,
|
|
|
RequireChecksum: false,
|
|
|
EnableTrailingChecksum: true,
|
|
|
EnableComputeSHA256PayloadHash: true,
|
|
|
EnableDecodedContentLengthHeader: true,
|
|
|
})
|
|
|
}
|
|
|
|
|
|
// getPutObjectBucketMember returns a pointer to string denoting a provided bucket
|
|
|
// member valueand a boolean indicating if the input has a modeled bucket name,
|
|
|
func getPutObjectBucketMember(input interface{}) (*string, bool) {
|
|
|
in := input.(*PutObjectInput)
|
|
|
if in.Bucket == nil {
|
|
|
return nil, false
|
|
|
}
|
|
|
return in.Bucket, true
|
|
|
}
|
|
|
func addPutObjectUpdateEndpoint(stack *middleware.Stack, options Options) error {
|
|
|
return s3cust.UpdateEndpoint(stack, s3cust.UpdateEndpointOptions{
|
|
|
Accessor: s3cust.UpdateEndpointParameterAccessor{
|
|
|
GetBucketFromInput: getPutObjectBucketMember,
|
|
|
},
|
|
|
UsePathStyle: options.UsePathStyle,
|
|
|
UseAccelerate: options.UseAccelerate,
|
|
|
SupportsAccelerate: true,
|
|
|
TargetS3ObjectLambda: false,
|
|
|
EndpointResolver: options.EndpointResolver,
|
|
|
EndpointResolverOptions: options.EndpointOptions,
|
|
|
UseARNRegion: options.UseARNRegion,
|
|
|
DisableMultiRegionAccessPoints: options.DisableMultiRegionAccessPoints,
|
|
|
})
|
|
|
}
|
|
|
|
|
|
// PresignPutObject is used to generate a presigned HTTP Request which contains
|
|
|
// presigned URL, signed headers and HTTP method used.
|
|
|
func (c *PresignClient) PresignPutObject(ctx context.Context, params *PutObjectInput, optFns ...func(*PresignOptions)) (*v4.PresignedHTTPRequest, error) {
|
|
|
if params == nil {
|
|
|
params = &PutObjectInput{}
|
|
|
}
|
|
|
options := c.options.copy()
|
|
|
for _, fn := range optFns {
|
|
|
fn(&options)
|
|
|
}
|
|
|
clientOptFns := append(options.ClientOptions, withNopHTTPClientAPIOption)
|
|
|
|
|
|
result, _, err := c.client.invokeOperation(ctx, "PutObject", params, clientOptFns,
|
|
|
c.client.addOperationPutObjectMiddlewares,
|
|
|
presignConverter(options).convertToPresignMiddleware,
|
|
|
func(stack *middleware.Stack, options Options) error {
|
|
|
return awshttp.RemoveContentTypeHeader(stack)
|
|
|
},
|
|
|
addPutObjectPayloadAsUnsigned,
|
|
|
)
|
|
|
if err != nil {
|
|
|
return nil, err
|
|
|
}
|
|
|
|
|
|
out := result.(*v4.PresignedHTTPRequest)
|
|
|
return out, nil
|
|
|
}
|
|
|
|
|
|
func addPutObjectPayloadAsUnsigned(stack *middleware.Stack, options Options) error {
|
|
|
v4.RemoveContentSHA256HeaderMiddleware(stack)
|
|
|
v4.RemoveComputePayloadSHA256Middleware(stack)
|
|
|
return v4.AddUnsignedPayloadMiddleware(stack)
|
|
|
}
|