Struct: s3.CreateMultipartUploadOutput

import "../ibm-cos-sdk-go/service/s3"

Implemented Interfaces

s3crypto.Cipher, s3manager.ReadSeekerWriteTo, s3manager.WriterReadFrom

Structure Field Summary collapse

Service Operations collapse

Structure Field Details

AbortDate *time.Time `location:"header" locationName:"x-amz-abort-date" type:"timestamp"`

If the bucket has a lifecycle rule configured with an action to abort incomplete multipart uploads and the prefix in the lifecycle rule matches the object name in the request, the response includes this header. The header indicates when the initiated multipart upload becomes eligible for an abort operation. For more information, see Aborting Incomplete Multipart Uploads Using a Bucket Lifecycle Configuration (docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config).

The response also includes the x-amz-abort-rule-id header that provides the ID of the lifecycle configuration rule that defines this action.

AbortRuleId *string `location:"header" locationName:"x-amz-abort-rule-id" type:"string"`

This header is returned along with the x-amz-abort-date header. It identifies the applicable lifecycle configuration rule that defines the action to abort incomplete multipart uploads.

Bucket *string `locationName:"Bucket" type:"string"`

The name of the bucket to which the multipart upload was initiated. Does not return the access point ARN or access point alias if used.

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 (docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) in the Amazon S3 User Guide.

When you use 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 you use this action with S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see What is S3 on Outposts? (docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html) in the Amazon S3 User Guide.

Key *string `min:"1" type:"string"`

Object key for which the multipart upload was initiated.

RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`

If present, indicates that the requester was successfully charged for the request.

SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`

If server-side encryption with a customer-provided encryption key was requested, the response will include this header confirming the encryption algorithm used.

SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"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.

SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string" sensitive:"true"`

If present, specifies the ID of the Key Management Service (KMS) symmetric encryption customer managed key that was used for the object.

SSEKMSKeyId is a sensitive parameter and its value will be replaced with “sensitive” in string returned by CreateMultipartUploadOutput's String and GoString methods.

ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`

The server-side encryption algorithm used when storing this object in Amazon S3 (for example, AES256, aws:kms).

UploadId *string `type:"string"`

ID for the initiated multipart upload.

_ struct{} `type:"structure"`

Method Details

func (s CreateMultipartUploadOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as “sensitive” in the API will not be included in the string output. The member name will be present, but the value will be replaced with “sensitive”.



9735
9736
9737
// File 'service/s3/api.go', line 9735

func (s CreateMultipartUploadOutput) GoString() string { return s.String() }

func (s *CreateMultipartUploadOutput) SetAbortDate(v time.Time) *CreateMultipartUploadOutput

SetAbortDate sets the AbortDate field's value.



9740
9741
9742
9743
// File 'service/s3/api.go', line 9740

func (s *CreateMultipartUploadOutput) SetAbortDate(v time.Time) *CreateMultipartUploadOutput { s.AbortDate = &v return s }

func (s *CreateMultipartUploadOutput) SetAbortRuleId(v string) *CreateMultipartUploadOutput

SetAbortRuleId sets the AbortRuleId field's value.



9746
9747
9748
9749
// File 'service/s3/api.go', line 9746

func (s *CreateMultipartUploadOutput) SetAbortRuleId(v string) *CreateMultipartUploadOutput { s.AbortRuleId = &v return s }

func (s *CreateMultipartUploadOutput) SetBucket(v string) *CreateMultipartUploadOutput

SetBucket sets the Bucket field's value.



9752
9753
9754
9755
// File 'service/s3/api.go', line 9752

func (s *CreateMultipartUploadOutput) SetBucket(v string) *CreateMultipartUploadOutput { s.Bucket = &v return s }

func (s *CreateMultipartUploadOutput) SetKey(v string) *CreateMultipartUploadOutput

SetKey sets the Key field's value.



9765
9766
9767
9768
// File 'service/s3/api.go', line 9765

func (s *CreateMultipartUploadOutput) SetKey(v string) *CreateMultipartUploadOutput { s.Key = &v return s }

func (s *CreateMultipartUploadOutput) SetRequestCharged(v string) *CreateMultipartUploadOutput

SetRequestCharged sets the RequestCharged field's value.



9771
9772
9773
9774
// File 'service/s3/api.go', line 9771

func (s *CreateMultipartUploadOutput) SetRequestCharged(v string) *CreateMultipartUploadOutput { s.RequestCharged = &v return s }

func (s *CreateMultipartUploadOutput) SetServerSideEncryption(v string) *CreateMultipartUploadOutput

SetServerSideEncryption sets the ServerSideEncryption field's value.



9795
9796
9797
9798
// File 'service/s3/api.go', line 9795

func (s *CreateMultipartUploadOutput) SetServerSideEncryption(v string) *CreateMultipartUploadOutput { s.ServerSideEncryption = &v return s }

func (s *CreateMultipartUploadOutput) SetSSECustomerAlgorithm(v string) *CreateMultipartUploadOutput

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.



9777
9778
9779
9780
// File 'service/s3/api.go', line 9777

func (s *CreateMultipartUploadOutput) SetSSECustomerAlgorithm(v string) *CreateMultipartUploadOutput { s.SSECustomerAlgorithm = &v return s }

func (s *CreateMultipartUploadOutput) SetSSECustomerKeyMD5(v string) *CreateMultipartUploadOutput

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.



9783
9784
9785
9786
// File 'service/s3/api.go', line 9783

func (s *CreateMultipartUploadOutput) SetSSECustomerKeyMD5(v string) *CreateMultipartUploadOutput { s.SSECustomerKeyMD5 = &v return s }

func (s *CreateMultipartUploadOutput) SetSSEKMSKeyId(v string) *CreateMultipartUploadOutput

SetSSEKMSKeyId sets the SSEKMSKeyId field's value.



9789
9790
9791
9792
// File 'service/s3/api.go', line 9789

func (s *CreateMultipartUploadOutput) SetSSEKMSKeyId(v string) *CreateMultipartUploadOutput { s.SSEKMSKeyId = &v return s }

func (s *CreateMultipartUploadOutput) SetUploadId(v string) *CreateMultipartUploadOutput

SetUploadId sets the UploadId field's value.



9801
9802
9803
9804
// File 'service/s3/api.go', line 9801

func (s *CreateMultipartUploadOutput) SetUploadId(v string) *CreateMultipartUploadOutput { s.UploadId = &v return s }

func (s CreateMultipartUploadOutput) String() string

String returns the string representation.

API parameter values that are decorated as “sensitive” in the API will not be included in the string output. The member name will be present, but the value will be replaced with “sensitive”.



9726
9727
9728
// File 'service/s3/api.go', line 9726

func (s CreateMultipartUploadOutput) String() string { return awsutil.Prettify(s) }