s3

package
v1.15.46 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 1, 2018 License: Apache-2.0 Imports: 30 Imported by: 9,842

Documentation

Overview

Package s3 provides the client and types for making API requests to Amazon Simple Storage Service.

See https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01 for more information on this service.

See s3 package documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/s3/

Using the Client

To contact Amazon Simple Storage Service with the SDK use the New function to create a new service client. With that client you can make API requests to the service. These clients are safe to use concurrently.

See the SDK's documentation for more information on how to use the SDK. https://docs.aws.amazon.com/sdk-for-go/api/

See aws.Config documentation for more information on configuring SDK clients. https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config

See the Amazon Simple Storage Service client S3 for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/s3/#New

Upload Managers

The s3manager package's Uploader provides concurrent upload of content to S3 by taking advantage of S3's Multipart APIs. The Uploader also supports both io.Reader for streaming uploads, and will also take advantage of io.ReadSeeker for optimizations if the Body satisfies that type. Once the Uploader instance is created you can call Upload concurrently from multiple goroutines safely. 

// The session the S3 Uploader will use
sess := session.Must(session.NewSession())

// Create an uploader with the session and default options
uploader := s3manager.NewUploader(sess)

f, err  := os.Open(filename)
if err != nil {
    return fmt.Errorf("failed to open file %q, %v", filename, err)
}

// Upload the file to S3.
result, err := uploader.Upload(&s3manager.UploadInput{
    Bucket: aws.String(myBucket),
    Key:    aws.String(myString),
    Body:   f,
})
if err != nil {
    return fmt.Errorf("failed to upload file, %v", err)
}
fmt.Printf("file uploaded to, %s\n", aws.StringValue(result.Location))

See the s3manager package's Uploader type documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/s3/s3manager/#Uploader

Download Manager

The s3manager package's Downloader provides concurrently downloading of Objects from S3. The Downloader will write S3 Object content with an io.WriterAt. Once the Downloader instance is created you can call Download concurrently from multiple goroutines safely. 

// The session the S3 Downloader will use
sess := session.Must(session.NewSession())

// Create a downloader with the session and default options
downloader := s3manager.NewDownloader(sess)

// Create a file to write the S3 Object contents to.
f, err := os.Create(filename)
if err != nil {
    return fmt.Errorf("failed to create file %q, %v", filename, err)
}

// Write the contents of S3 Object to the file
n, err := downloader.Download(f, &s3.GetObjectInput{
    Bucket: aws.String(myBucket),
    Key:    aws.String(myString),
})
if err != nil {
    return fmt.Errorf("failed to download file, %v", err)
}
fmt.Printf("file downloaded, %d bytes\n", n)

See the s3manager package's Downloader type documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/s3/s3manager/#Downloader

Get Bucket Region

GetBucketRegion will attempt to get the region for a bucket using a region hint to determine which AWS partition to perform the query on. Use this utility to determine the region a bucket is in. 

sess := session.Must(session.NewSession())

bucket := "my-bucket"
region, err := s3manager.GetBucketRegion(ctx, sess, bucket, "us-west-2")
if err != nil {
    if aerr, ok := err.(awserr.Error); ok && aerr.Code() == "NotFound" {
         fmt.Fprintf(os.Stderr, "unable to find bucket %s's region not found\n", bucket)
    }
    return err
}
fmt.Printf("Bucket %s is in %s region\n", bucket, region)

See the s3manager package's GetBucketRegion function documentation for more information https://docs.aws.amazon.com/sdk-for-go/api/service/s3/s3manager/#GetBucketRegion

S3 Crypto Client

The s3crypto package provides the tools to upload and download encrypted content from S3. The Encryption and Decryption clients can be used concurrently once the client is created. 

sess := session.Must(session.NewSession())

// Create the decryption client.
svc := s3crypto.NewDecryptionClient(sess)

// The object will be downloaded from S3 and decrypted locally. By metadata
// about the object's encryption will instruct the decryption client how
// decrypt the content of the object. By default KMS is used for keys.
result, err := svc.GetObject(&s3.GetObjectInput {
    Bucket: aws.String(myBucket),
    Key: aws.String(myKey),
})

See the s3crypto package documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/s3/s3crypto/

Index

Examples

Constants

View Source 
const (
	// BucketAccelerateStatusEnabled is a BucketAccelerateStatus enum value
	BucketAccelerateStatusEnabled = "Enabled"

	// BucketAccelerateStatusSuspended is a BucketAccelerateStatus enum value
	BucketAccelerateStatusSuspended = "Suspended"
)
View Source 
const (
	// BucketCannedACLPrivate is a BucketCannedACL enum value
	BucketCannedACLPrivate = "private"

	// BucketCannedACLPublicRead is a BucketCannedACL enum value
	BucketCannedACLPublicRead = "public-read"

	// BucketCannedACLPublicReadWrite is a BucketCannedACL enum value
	BucketCannedACLPublicReadWrite = "public-read-write"

	// BucketCannedACLAuthenticatedRead is a BucketCannedACL enum value
	BucketCannedACLAuthenticatedRead = "authenticated-read"
)
View Source 
const (
	// BucketLocationConstraintEu is a BucketLocationConstraint enum value
	BucketLocationConstraintEu = "EU"

	// BucketLocationConstraintEuWest1 is a BucketLocationConstraint enum value
	BucketLocationConstraintEuWest1 = "eu-west-1"

	// BucketLocationConstraintUsWest1 is a BucketLocationConstraint enum value
	BucketLocationConstraintUsWest1 = "us-west-1"

	// BucketLocationConstraintUsWest2 is a BucketLocationConstraint enum value
	BucketLocationConstraintUsWest2 = "us-west-2"

	// BucketLocationConstraintApSouth1 is a BucketLocationConstraint enum value
	BucketLocationConstraintApSouth1 = "ap-south-1"

	// BucketLocationConstraintApSoutheast1 is a BucketLocationConstraint enum value
	BucketLocationConstraintApSoutheast1 = "ap-southeast-1"

	// BucketLocationConstraintApSoutheast2 is a BucketLocationConstraint enum value
	BucketLocationConstraintApSoutheast2 = "ap-southeast-2"

	// BucketLocationConstraintApNortheast1 is a BucketLocationConstraint enum value
	BucketLocationConstraintApNortheast1 = "ap-northeast-1"

	// BucketLocationConstraintSaEast1 is a BucketLocationConstraint enum value
	BucketLocationConstraintSaEast1 = "sa-east-1"

	// BucketLocationConstraintCnNorth1 is a BucketLocationConstraint enum value
	BucketLocationConstraintCnNorth1 = "cn-north-1"

	// BucketLocationConstraintEuCentral1 is a BucketLocationConstraint enum value
	BucketLocationConstraintEuCentral1 = "eu-central-1"
)
View Source 
const (
	// BucketLogsPermissionFullControl is a BucketLogsPermission enum value
	BucketLogsPermissionFullControl = "FULL_CONTROL"

	// BucketLogsPermissionRead is a BucketLogsPermission enum value
	BucketLogsPermissionRead = "READ"

	// BucketLogsPermissionWrite is a BucketLogsPermission enum value
	BucketLogsPermissionWrite = "WRITE"
)
View Source 
const (
	// BucketVersioningStatusEnabled is a BucketVersioningStatus enum value
	BucketVersioningStatusEnabled = "Enabled"

	// BucketVersioningStatusSuspended is a BucketVersioningStatus enum value
	BucketVersioningStatusSuspended = "Suspended"
)
View Source 
const (
	// CompressionTypeNone is a CompressionType enum value
	CompressionTypeNone = "NONE"

	// CompressionTypeGzip is a CompressionType enum value
	CompressionTypeGzip = "GZIP"

	// CompressionTypeBzip2 is a CompressionType enum value
	CompressionTypeBzip2 = "BZIP2"
)
View Source 
const (
	// DeleteMarkerReplicationStatusEnabled is a DeleteMarkerReplicationStatus enum value
	DeleteMarkerReplicationStatusEnabled = "Enabled"

	// DeleteMarkerReplicationStatusDisabled is a DeleteMarkerReplicationStatus enum value
	DeleteMarkerReplicationStatusDisabled = "Disabled"
)
View Source 
const (
	// EventS3ReducedRedundancyLostObject is a Event enum value
	EventS3ReducedRedundancyLostObject = "s3:ReducedRedundancyLostObject"

	// EventS3ObjectCreated is a Event enum value
	EventS3ObjectCreated = "s3:ObjectCreated:*"

	// EventS3ObjectCreatedPut is a Event enum value
	EventS3ObjectCreatedPut = "s3:ObjectCreated:Put"

	// EventS3ObjectCreatedPost is a Event enum value
	EventS3ObjectCreatedPost = "s3:ObjectCreated:Post"

	// EventS3ObjectCreatedCopy is a Event enum value
	EventS3ObjectCreatedCopy = "s3:ObjectCreated:Copy"

	// EventS3ObjectCreatedCompleteMultipartUpload is a Event enum value
	EventS3ObjectCreatedCompleteMultipartUpload = "s3:ObjectCreated:CompleteMultipartUpload"

	// EventS3ObjectRemoved is a Event enum value
	EventS3ObjectRemoved = "s3:ObjectRemoved:*"

	// EventS3ObjectRemovedDelete is a Event enum value
	EventS3ObjectRemovedDelete = "s3:ObjectRemoved:Delete"

	// EventS3ObjectRemovedDeleteMarkerCreated is a Event enum value
	EventS3ObjectRemovedDeleteMarkerCreated = "s3:ObjectRemoved:DeleteMarkerCreated"
)

Bucket event for which to send notifications.

View Source 
const (
	// ExpirationStatusEnabled is a ExpirationStatus enum value
	ExpirationStatusEnabled = "Enabled"

	// ExpirationStatusDisabled is a ExpirationStatus enum value
	ExpirationStatusDisabled = "Disabled"
)
View Source 
const (
	// FileHeaderInfoUse is a FileHeaderInfo enum value
	FileHeaderInfoUse = "USE"

	// FileHeaderInfoIgnore is a FileHeaderInfo enum value
	FileHeaderInfoIgnore = "IGNORE"

	// FileHeaderInfoNone is a FileHeaderInfo enum value
	FileHeaderInfoNone = "NONE"
)
View Source 
const (
	// FilterRuleNamePrefix is a FilterRuleName enum value
	FilterRuleNamePrefix = "prefix"

	// FilterRuleNameSuffix is a FilterRuleName enum value
	FilterRuleNameSuffix = "suffix"
)
View Source 
const (
	// InventoryFormatCsv is a InventoryFormat enum value
	InventoryFormatCsv = "CSV"

	// InventoryFormatOrc is a InventoryFormat enum value
	InventoryFormatOrc = "ORC"
)
View Source 
const (
	// InventoryFrequencyDaily is a InventoryFrequency enum value
	InventoryFrequencyDaily = "Daily"

	// InventoryFrequencyWeekly is a InventoryFrequency enum value
	InventoryFrequencyWeekly = "Weekly"
)
View Source 
const (
	// InventoryIncludedObjectVersionsAll is a InventoryIncludedObjectVersions enum value
	InventoryIncludedObjectVersionsAll = "All"

	// InventoryIncludedObjectVersionsCurrent is a InventoryIncludedObjectVersions enum value
	InventoryIncludedObjectVersionsCurrent = "Current"
)
View Source 
const (
	// InventoryOptionalFieldSize is a InventoryOptionalField enum value
	InventoryOptionalFieldSize = "Size"

	// InventoryOptionalFieldLastModifiedDate is a InventoryOptionalField enum value
	InventoryOptionalFieldLastModifiedDate = "LastModifiedDate"

	// InventoryOptionalFieldStorageClass is a InventoryOptionalField enum value
	InventoryOptionalFieldStorageClass = "StorageClass"

	// InventoryOptionalFieldEtag is a InventoryOptionalField enum value
	InventoryOptionalFieldEtag = "ETag"

	// InventoryOptionalFieldIsMultipartUploaded is a InventoryOptionalField enum value
	InventoryOptionalFieldIsMultipartUploaded = "IsMultipartUploaded"

	// InventoryOptionalFieldReplicationStatus is a InventoryOptionalField enum value
	InventoryOptionalFieldReplicationStatus = "ReplicationStatus"

	// InventoryOptionalFieldEncryptionStatus is a InventoryOptionalField enum value
	InventoryOptionalFieldEncryptionStatus = "EncryptionStatus"
)
View Source 
const (
	// JSONTypeDocument is a JSONType enum value
	JSONTypeDocument = "DOCUMENT"

	// JSONTypeLines is a JSONType enum value
	JSONTypeLines = "LINES"
)
View Source 
const (
	// MFADeleteEnabled is a MFADelete enum value
	MFADeleteEnabled = "Enabled"

	// MFADeleteDisabled is a MFADelete enum value
	MFADeleteDisabled = "Disabled"
)
View Source 
const (
	// MFADeleteStatusEnabled is a MFADeleteStatus enum value
	MFADeleteStatusEnabled = "Enabled"

	// MFADeleteStatusDisabled is a MFADeleteStatus enum value
	MFADeleteStatusDisabled = "Disabled"
)
View Source 
const (
	// MetadataDirectiveCopy is a MetadataDirective enum value
	MetadataDirectiveCopy = "COPY"

	// MetadataDirectiveReplace is a MetadataDirective enum value
	MetadataDirectiveReplace = "REPLACE"
)
View Source 
const (
	// ObjectCannedACLPrivate is a ObjectCannedACL enum value
	ObjectCannedACLPrivate = "private"

	// ObjectCannedACLPublicRead is a ObjectCannedACL enum value
	ObjectCannedACLPublicRead = "public-read"

	// ObjectCannedACLPublicReadWrite is a ObjectCannedACL enum value
	ObjectCannedACLPublicReadWrite = "public-read-write"

	// ObjectCannedACLAuthenticatedRead is a ObjectCannedACL enum value
	ObjectCannedACLAuthenticatedRead = "authenticated-read"

	// ObjectCannedACLAwsExecRead is a ObjectCannedACL enum value
	ObjectCannedACLAwsExecRead = "aws-exec-read"

	// ObjectCannedACLBucketOwnerRead is a ObjectCannedACL enum value
	ObjectCannedACLBucketOwnerRead = "bucket-owner-read"

	// ObjectCannedACLBucketOwnerFullControl is a ObjectCannedACL enum value
	ObjectCannedACLBucketOwnerFullControl = "bucket-owner-full-control"
)
View Source 
const (
	// ObjectStorageClassStandard is a ObjectStorageClass enum value
	ObjectStorageClassStandard = "STANDARD"

	// ObjectStorageClassReducedRedundancy is a ObjectStorageClass enum value
	ObjectStorageClassReducedRedundancy = "REDUCED_REDUNDANCY"

	// ObjectStorageClassGlacier is a ObjectStorageClass enum value
	ObjectStorageClassGlacier = "GLACIER"

	// ObjectStorageClassStandardIa is a ObjectStorageClass enum value
	ObjectStorageClassStandardIa = "STANDARD_IA"

	// ObjectStorageClassOnezoneIa is a ObjectStorageClass enum value
	ObjectStorageClassOnezoneIa = "ONEZONE_IA"
)
View Source 
const (
	// PayerRequester is a Payer enum value
	PayerRequester = "Requester"

	// PayerBucketOwner is a Payer enum value
	PayerBucketOwner = "BucketOwner"
)
View Source 
const (
	// PermissionFullControl is a Permission enum value
	PermissionFullControl = "FULL_CONTROL"

	// PermissionWrite is a Permission enum value
	PermissionWrite = "WRITE"

	// PermissionWriteAcp is a Permission enum value
	PermissionWriteAcp = "WRITE_ACP"

	// PermissionRead is a Permission enum value
	PermissionRead = "READ"

	// PermissionReadAcp is a Permission enum value
	PermissionReadAcp = "READ_ACP"
)
View Source 
const (
	// ProtocolHttp is a Protocol enum value
	ProtocolHttp = "http"

	// ProtocolHttps is a Protocol enum value
	ProtocolHttps = "https"
)
View Source 
const (
	// QuoteFieldsAlways is a QuoteFields enum value
	QuoteFieldsAlways = "ALWAYS"

	// QuoteFieldsAsneeded is a QuoteFields enum value
	QuoteFieldsAsneeded = "ASNEEDED"
)
View Source 
const (
	// ReplicationRuleStatusEnabled is a ReplicationRuleStatus enum value
	ReplicationRuleStatusEnabled = "Enabled"

	// ReplicationRuleStatusDisabled is a ReplicationRuleStatus enum value
	ReplicationRuleStatusDisabled = "Disabled"
)
View Source 
const (
	// ReplicationStatusComplete is a ReplicationStatus enum value
	ReplicationStatusComplete = "COMPLETE"

	// ReplicationStatusPending is a ReplicationStatus enum value
	ReplicationStatusPending = "PENDING"

	// ReplicationStatusFailed is a ReplicationStatus enum value
	ReplicationStatusFailed = "FAILED"

	// ReplicationStatusReplica is a ReplicationStatus enum value
	ReplicationStatusReplica = "REPLICA"
)
View Source 
const (
	// ServerSideEncryptionAes256 is a ServerSideEncryption enum value
	ServerSideEncryptionAes256 = "AES256"

	// ServerSideEncryptionAwsKms is a ServerSideEncryption enum value
	ServerSideEncryptionAwsKms = "aws:kms"
)
View Source 
const (
	// SseKmsEncryptedObjectsStatusEnabled is a SseKmsEncryptedObjectsStatus enum value
	SseKmsEncryptedObjectsStatusEnabled = "Enabled"

	// SseKmsEncryptedObjectsStatusDisabled is a SseKmsEncryptedObjectsStatus enum value
	SseKmsEncryptedObjectsStatusDisabled = "Disabled"
)
View Source 
const (
	// StorageClassStandard is a StorageClass enum value
	StorageClassStandard = "STANDARD"

	// StorageClassReducedRedundancy is a StorageClass enum value
	StorageClassReducedRedundancy = "REDUCED_REDUNDANCY"

	// StorageClassStandardIa is a StorageClass enum value
	StorageClassStandardIa = "STANDARD_IA"

	// StorageClassOnezoneIa is a StorageClass enum value
	StorageClassOnezoneIa = "ONEZONE_IA"
)
View Source 
const (
	// TaggingDirectiveCopy is a TaggingDirective enum value
	TaggingDirectiveCopy = "COPY"

	// TaggingDirectiveReplace is a TaggingDirective enum value
	TaggingDirectiveReplace = "REPLACE"
)
View Source 
const (
	// TierStandard is a Tier enum value
	TierStandard = "Standard"

	// TierBulk is a Tier enum value
	TierBulk = "Bulk"

	// TierExpedited is a Tier enum value
	TierExpedited = "Expedited"
)
View Source 
const (
	// TransitionStorageClassGlacier is a TransitionStorageClass enum value
	TransitionStorageClassGlacier = "GLACIER"

	// TransitionStorageClassStandardIa is a TransitionStorageClass enum value
	TransitionStorageClassStandardIa = "STANDARD_IA"

	// TransitionStorageClassOnezoneIa is a TransitionStorageClass enum value
	TransitionStorageClassOnezoneIa = "ONEZONE_IA"
)
View Source 
const (
	// TypeCanonicalUser is a Type enum value
	TypeCanonicalUser = "CanonicalUser"

	// TypeAmazonCustomerByEmail is a Type enum value
	TypeAmazonCustomerByEmail = "AmazonCustomerByEmail"

	// TypeGroup is a Type enum value
	TypeGroup = "Group"
)
View Source 
const (

	// ErrCodeBucketAlreadyExists for service response error code
	// "BucketAlreadyExists".
	//
	// The requested bucket name is not available. The bucket namespace is shared
	// by all users of the system. Please select a different name and try again.
	ErrCodeBucketAlreadyExists = "BucketAlreadyExists"

	// ErrCodeBucketAlreadyOwnedByYou for service response error code
	// "BucketAlreadyOwnedByYou".
	ErrCodeBucketAlreadyOwnedByYou = "BucketAlreadyOwnedByYou"

	// ErrCodeNoSuchBucket for service response error code
	// "NoSuchBucket".
	//
	// The specified bucket does not exist.
	ErrCodeNoSuchBucket = "NoSuchBucket"

	// ErrCodeNoSuchKey for service response error code
	// "NoSuchKey".
	//
	// The specified key does not exist.
	ErrCodeNoSuchKey = "NoSuchKey"

	// ErrCodeNoSuchUpload for service response error code
	// "NoSuchUpload".
	//
	// The specified multipart upload does not exist.
	ErrCodeNoSuchUpload = "NoSuchUpload"

	// ErrCodeObjectAlreadyInActiveTierError for service response error code
	// "ObjectAlreadyInActiveTierError".
	//
	// This operation is not allowed against this storage tier
	ErrCodeObjectAlreadyInActiveTierError = "ObjectAlreadyInActiveTierError"

	// ErrCodeObjectNotInActiveTierError for service response error code
	// "ObjectNotInActiveTierError".
	//
	// The source object of the COPY operation is not in the active tier and is
	// only stored in Amazon Glacier.
	ErrCodeObjectNotInActiveTierError = "ObjectNotInActiveTierError"
)
View Source 
const (
	ServiceName = "s3"        // Name of service.
	EndpointsID = ServiceName // ID to lookup a service endpoint with.
	ServiceID   = "S3"        // ServiceID is a unique identifer of a specific service.
)

Service information constants

View Source 
const (
	// AnalyticsS3ExportFileFormatCsv is a AnalyticsS3ExportFileFormat enum value
	AnalyticsS3ExportFileFormatCsv = "CSV"
)
View Source 
const (
	// EncodingTypeUrl is a EncodingType enum value
	EncodingTypeUrl = "url"
)

Requests Amazon S3 to encode the object keys in the response and specifies the encoding method to use. An object key may contain any Unicode character; however, XML 1.0 parser cannot parse some characters, such as characters with an ASCII value from 0 to 10. For characters that are not supported in XML 1.0, you can add this parameter to request that Amazon S3 encode the keys in the response.

View Source 
const (
	// ExpressionTypeSql is a ExpressionType enum value
	ExpressionTypeSql = "SQL"
)
View Source 
const (
	// ObjectVersionStorageClassStandard is a ObjectVersionStorageClass enum value
	ObjectVersionStorageClassStandard = "STANDARD"
)
View Source 
const (
	// OwnerOverrideDestination is a OwnerOverride enum value
	OwnerOverrideDestination = "Destination"
)
View Source 
const (
	// RequestChargedRequester is a RequestCharged enum value
	RequestChargedRequester = "requester"
)

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

View Source 
const (
	// RequestPayerRequester is a RequestPayer enum value
	RequestPayerRequester = "requester"
)

Confirms that the requester knows that she or he will be charged for the request. Bucket owners need not specify this parameter in their requests. Documentation on downloading objects from requester pays buckets can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html

View Source 
const (
	// RestoreRequestTypeSelect is a RestoreRequestType enum value
	RestoreRequestTypeSelect = "SELECT"
)
View Source 
const (
	// StorageClassAnalysisSchemaVersionV1 is a StorageClassAnalysisSchemaVersion enum value
	StorageClassAnalysisSchemaVersionV1 = "V_1"
)

Variables

View Source 
var NormalizeBucketLocationHandler = request.NamedHandler{
	Name: "awssdk.s3.NormalizeBucketLocation",
	Fn: func(req *request.Request) {
		if req.Error != nil {
			return
		}

		out := req.Data.(*GetBucketLocationOutput)
		loc := NormalizeBucketLocation(aws.StringValue(out.LocationConstraint))
		out.LocationConstraint = aws.String(loc)
	},
}

NormalizeBucketLocationHandler is a request handler which will update the GetBucketLocation's result LocationConstraint value to always be a region ID.

Replaces empty string with "us-east-1", and "EU" with "eu-west-1".

See http://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETlocation.html for more information on the values that can be returned. 

req, result := svc.GetBucketLocationRequest(&s3.GetBucketLocationInput{
    Bucket: aws.String(bucket),
})
req.Handlers.Unmarshal.PushBackNamed(NormalizeBucketLocationHandler)
err := req.Send()

Functions

func NormalizeBucketLocation added in v1.8.15 

func NormalizeBucketLocation(loc string) string

NormalizeBucketLocation is a utility function which will update the passed in value to always be a region ID. Generally this would be used with GetBucketLocation API operation.

Replaces empty string with "us-east-1", and "EU" with "eu-west-1".

See http://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETlocation.html for more information on the values that can be returned.

func WithNormalizeBucketLocation added in v1.8.15 

func WithNormalizeBucketLocation(r *request.Request)

WithNormalizeBucketLocation is a request option which will update the GetBucketLocation's result LocationConstraint value to always be a region ID.

Replaces empty string with "us-east-1", and "EU" with "eu-west-1".

See http://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETlocation.html for more information on the values that can be returned. 

result, err := svc.GetBucketLocationWithContext(ctx,
    &s3.GetBucketLocationInput{
        Bucket: aws.String(bucket),
    },
    s3.WithNormalizeBucketLocation,
)

Types

type AbortIncompleteMultipartUpload added in v1.1.12 

type AbortIncompleteMultipartUpload struct {

	// Indicates the number of days that must pass since initiation for Lifecycle
	// to abort an Incomplete Multipart Upload.
	DaysAfterInitiation *int64 `type:"integer"`
	// contains filtered or unexported fields
}

Specifies the days since the initiation of an Incomplete Multipart Upload that Lifecycle will wait before permanently removing all parts of the upload.

func (AbortIncompleteMultipartUpload) GoString added in v1.1.12 

func (s AbortIncompleteMultipartUpload) GoString() string

GoString returns the string representation

func (*AbortIncompleteMultipartUpload) SetDaysAfterInitiation added in v1.5.0 

func (s *AbortIncompleteMultipartUpload) SetDaysAfterInitiation(v int64) *AbortIncompleteMultipartUpload

SetDaysAfterInitiation sets the DaysAfterInitiation field's value.

func (AbortIncompleteMultipartUpload) String added in v1.1.12 

func (s AbortIncompleteMultipartUpload) String() string

String returns the string representation

type AbortMultipartUploadInput 

type AbortMultipartUploadInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`

	// UploadId is a required field
	UploadId *string `location:"querystring" locationName:"uploadId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (AbortMultipartUploadInput) GoString added in v0.6.5 

func (s AbortMultipartUploadInput) GoString() string

GoString returns the string representation

func (*AbortMultipartUploadInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*AbortMultipartUploadInput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*AbortMultipartUploadInput) SetRequestPayer added in v1.5.0 

func (s *AbortMultipartUploadInput) SetRequestPayer(v string) *AbortMultipartUploadInput

SetRequestPayer sets the RequestPayer field's value.

func (*AbortMultipartUploadInput) SetUploadId added in v1.5.0 

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

SetUploadId sets the UploadId field's value.

func (AbortMultipartUploadInput) String added in v0.6.5 

func (s AbortMultipartUploadInput) String() string

String returns the string representation

func (*AbortMultipartUploadInput) Validate added in v1.1.21 

func (s *AbortMultipartUploadInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type AbortMultipartUploadOutput 

type AbortMultipartUploadOutput struct {

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
	// contains filtered or unexported fields
}

func (AbortMultipartUploadOutput) GoString added in v0.6.5 

func (s AbortMultipartUploadOutput) GoString() string

GoString returns the string representation

func (*AbortMultipartUploadOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (AbortMultipartUploadOutput) String added in v0.6.5 

func (s AbortMultipartUploadOutput) String() string

String returns the string representation

type AccelerateConfiguration added in v1.1.19 

type AccelerateConfiguration struct {

	// The accelerate configuration of the bucket.
	Status *string `type:"string" enum:"BucketAccelerateStatus"`
	// contains filtered or unexported fields
}

func (AccelerateConfiguration) GoString added in v1.1.19 

func (s AccelerateConfiguration) GoString() string

GoString returns the string representation

func (*AccelerateConfiguration) SetStatus added in v1.5.0 

func (s *AccelerateConfiguration) SetStatus(v string) *AccelerateConfiguration

SetStatus sets the Status field's value.

func (AccelerateConfiguration) String added in v1.1.19 

func (s AccelerateConfiguration) String() string

String returns the string representation

type AccessControlPolicy 

type AccessControlPolicy struct {

	// A list of grants.
	Grants []*Grant `locationName:"AccessControlList" locationNameList:"Grant" type:"list"`

	Owner *Owner `type:"structure"`
	// contains filtered or unexported fields
}

func (AccessControlPolicy) GoString added in v0.6.5 

func (s AccessControlPolicy) GoString() string

GoString returns the string representation

func (*AccessControlPolicy) SetGrants added in v1.5.0 

func (s *AccessControlPolicy) SetGrants(v []*Grant) *AccessControlPolicy

SetGrants sets the Grants field's value.

func (*AccessControlPolicy) SetOwner added in v1.5.0 

func (s *AccessControlPolicy) SetOwner(v *Owner) *AccessControlPolicy

SetOwner sets the Owner field's value.

func (AccessControlPolicy) String added in v0.6.5 

func (s AccessControlPolicy) String() string

String returns the string representation

func (*AccessControlPolicy) Validate added in v1.1.21 

func (s *AccessControlPolicy) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type AccessControlTranslation added in v1.12.24 

type AccessControlTranslation struct {

	// The override value for the owner of the replica object.
	//
	// Owner is a required field
	Owner *string `type:"string" required:"true" enum:"OwnerOverride"`
	// contains filtered or unexported fields
}

Container for information regarding the access control for replicas.

func (AccessControlTranslation) GoString added in v1.12.24 

func (s AccessControlTranslation) GoString() string

GoString returns the string representation

func (*AccessControlTranslation) SetOwner added in v1.12.24 

func (s *AccessControlTranslation) SetOwner(v string) *AccessControlTranslation

SetOwner sets the Owner field's value.

func (AccessControlTranslation) String added in v1.12.24 

func (s AccessControlTranslation) String() string

String returns the string representation

func (*AccessControlTranslation) Validate added in v1.12.24 

func (s *AccessControlTranslation) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type AnalyticsAndOperator added in v1.5.11 

type AnalyticsAndOperator struct {

	// The prefix to use when evaluating an AND predicate.
	Prefix *string `type:"string"`

	// The list of tags to use when evaluating an AND predicate.
	Tags []*Tag `locationName:"Tag" locationNameList:"Tag" type:"list" flattened:"true"`
	// contains filtered or unexported fields
}

func (AnalyticsAndOperator) GoString added in v1.5.11 

func (s AnalyticsAndOperator) GoString() string

GoString returns the string representation

func (*AnalyticsAndOperator) SetPrefix added in v1.5.11 

func (s *AnalyticsAndOperator) SetPrefix(v string) *AnalyticsAndOperator

SetPrefix sets the Prefix field's value.

func (*AnalyticsAndOperator) SetTags added in v1.5.11 

func (s *AnalyticsAndOperator) SetTags(v []*Tag) *AnalyticsAndOperator

SetTags sets the Tags field's value.

func (AnalyticsAndOperator) String added in v1.5.11 

func (s AnalyticsAndOperator) String() string

String returns the string representation

func (*AnalyticsAndOperator) Validate added in v1.5.11 

func (s *AnalyticsAndOperator) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type AnalyticsConfiguration added in v1.5.11 

type AnalyticsConfiguration struct {

	// The filter used to describe a set of objects for analyses. A filter must
	// have exactly one prefix, one tag, or one conjunction (AnalyticsAndOperator).
	// If no filter is provided, all objects will be considered in any analysis.
	Filter *AnalyticsFilter `type:"structure"`

	// The identifier used to represent an analytics configuration.
	//
	// Id is a required field
	Id *string `type:"string" required:"true"`

	// If present, it indicates that data related to access patterns will be collected
	// and made available to analyze the tradeoffs between different storage classes.
	//
	// StorageClassAnalysis is a required field
	StorageClassAnalysis *StorageClassAnalysis `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

func (AnalyticsConfiguration) GoString added in v1.5.11 

func (s AnalyticsConfiguration) GoString() string

GoString returns the string representation

func (*AnalyticsConfiguration) SetFilter added in v1.5.11 

func (s *AnalyticsConfiguration) SetFilter(v *AnalyticsFilter) *AnalyticsConfiguration

SetFilter sets the Filter field's value.

func (*AnalyticsConfiguration) SetId added in v1.5.11 

func (s *AnalyticsConfiguration) SetId(v string) *AnalyticsConfiguration

SetId sets the Id field's value.

func (*AnalyticsConfiguration) SetStorageClassAnalysis added in v1.5.11 

func (s *AnalyticsConfiguration) SetStorageClassAnalysis(v *StorageClassAnalysis) *AnalyticsConfiguration

SetStorageClassAnalysis sets the StorageClassAnalysis field's value.

func (AnalyticsConfiguration) String added in v1.5.11 

func (s AnalyticsConfiguration) String() string

String returns the string representation

func (*AnalyticsConfiguration) Validate added in v1.5.11 

func (s *AnalyticsConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type AnalyticsExportDestination added in v1.5.11 

type AnalyticsExportDestination struct {

	// A destination signifying output to an S3 bucket.
	//
	// S3BucketDestination is a required field
	S3BucketDestination *AnalyticsS3BucketDestination `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

func (AnalyticsExportDestination) GoString added in v1.5.11 

func (s AnalyticsExportDestination) GoString() string

GoString returns the string representation

func (*AnalyticsExportDestination) SetS3BucketDestination added in v1.5.11 

func (s *AnalyticsExportDestination) SetS3BucketDestination(v *AnalyticsS3BucketDestination) *AnalyticsExportDestination

SetS3BucketDestination sets the S3BucketDestination field's value.

func (AnalyticsExportDestination) String added in v1.5.11 

func (s AnalyticsExportDestination) String() string

String returns the string representation

func (*AnalyticsExportDestination) Validate added in v1.5.11 

func (s *AnalyticsExportDestination) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type AnalyticsFilter added in v1.5.11 

type AnalyticsFilter struct {

	// A conjunction (logical AND) of predicates, which is used in evaluating an
	// analytics filter. The operator must have at least two predicates.
	And *AnalyticsAndOperator `type:"structure"`

	// The prefix to use when evaluating an analytics filter.
	Prefix *string `type:"string"`

	// The tag to use when evaluating an analytics filter.
	Tag *Tag `type:"structure"`
	// contains filtered or unexported fields
}

func (AnalyticsFilter) GoString added in v1.5.11 

func (s AnalyticsFilter) GoString() string

GoString returns the string representation

func (*AnalyticsFilter) SetAnd added in v1.5.11 

func (s *AnalyticsFilter) SetAnd(v *AnalyticsAndOperator) *AnalyticsFilter

SetAnd sets the And field's value.

func (*AnalyticsFilter) SetPrefix added in v1.5.11 

func (s *AnalyticsFilter) SetPrefix(v string) *AnalyticsFilter

SetPrefix sets the Prefix field's value.

func (*AnalyticsFilter) SetTag added in v1.5.11 

func (s *AnalyticsFilter) SetTag(v *Tag) *AnalyticsFilter

SetTag sets the Tag field's value.

func (AnalyticsFilter) String added in v1.5.11 

func (s AnalyticsFilter) String() string

String returns the string representation

func (*AnalyticsFilter) Validate added in v1.5.11 

func (s *AnalyticsFilter) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type AnalyticsS3BucketDestination added in v1.5.11 

type AnalyticsS3BucketDestination struct {

	// The Amazon resource name (ARN) of the bucket to which data is exported.
	//
	// Bucket is a required field
	Bucket *string `type:"string" required:"true"`

	// The account ID that owns the destination bucket. If no account ID is provided,
	// the owner will not be validated prior to exporting data.
	BucketAccountId *string `type:"string"`

	// The file format used when exporting data to Amazon S3.
	//
	// Format is a required field
	Format *string `type:"string" required:"true" enum:"AnalyticsS3ExportFileFormat"`

	// The prefix to use when exporting data. The exported data begins with this
	// prefix.
	Prefix *string `type:"string"`
	// contains filtered or unexported fields
}

func (AnalyticsS3BucketDestination) GoString added in v1.5.11 

func (s AnalyticsS3BucketDestination) GoString() string

GoString returns the string representation

func (*AnalyticsS3BucketDestination) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*AnalyticsS3BucketDestination) SetBucketAccountId added in v1.5.11 

func (s *AnalyticsS3BucketDestination) SetBucketAccountId(v string) *AnalyticsS3BucketDestination

SetBucketAccountId sets the BucketAccountId field's value.

func (*AnalyticsS3BucketDestination) SetFormat added in v1.5.11 

func (s *AnalyticsS3BucketDestination) SetFormat(v string) *AnalyticsS3BucketDestination

SetFormat sets the Format field's value.

func (*AnalyticsS3BucketDestination) SetPrefix added in v1.5.11 

func (s *AnalyticsS3BucketDestination) SetPrefix(v string) *AnalyticsS3BucketDestination

SetPrefix sets the Prefix field's value.

func (AnalyticsS3BucketDestination) String added in v1.5.11 

func (s AnalyticsS3BucketDestination) String() string

String returns the string representation

func (*AnalyticsS3BucketDestination) Validate added in v1.5.11 

func (s *AnalyticsS3BucketDestination) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type Bucket 

type Bucket struct {

	// Date the bucket was created.
	CreationDate *time.Time `type:"timestamp"`

	// The name of the bucket.
	Name *string `type:"string"`
	// contains filtered or unexported fields
}

func (Bucket) GoString added in v0.6.5 

func (s Bucket) GoString() string

GoString returns the string representation

func (*Bucket) SetCreationDate added in v1.5.0 

func (s *Bucket) SetCreationDate(v time.Time) *Bucket

SetCreationDate sets the CreationDate field's value.

func (*Bucket) SetName added in v1.5.0 

func (s *Bucket) SetName(v string) *Bucket

SetName sets the Name field's value.

func (Bucket) String added in v0.6.5 

func (s Bucket) String() string

String returns the string representation

type BucketLifecycleConfiguration added in v0.9.8 

type BucketLifecycleConfiguration struct {

	// Rules is a required field
	Rules []*LifecycleRule `locationName:"Rule" type:"list" flattened:"true" required:"true"`
	// contains filtered or unexported fields
}

func (BucketLifecycleConfiguration) GoString added in v0.9.8 

func (s BucketLifecycleConfiguration) GoString() string

GoString returns the string representation

func (*BucketLifecycleConfiguration) SetRules added in v1.5.0 

func (s *BucketLifecycleConfiguration) SetRules(v []*LifecycleRule) *BucketLifecycleConfiguration

SetRules sets the Rules field's value.

func (BucketLifecycleConfiguration) String added in v0.9.8 

func (s BucketLifecycleConfiguration) String() string

String returns the string representation

func (*BucketLifecycleConfiguration) Validate added in v1.1.21 

func (s *BucketLifecycleConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type BucketLoggingStatus 

type BucketLoggingStatus struct {

	// Container for logging information. Presence of this element indicates that
	// logging is enabled. Parameters TargetBucket and TargetPrefix are required
	// in this case.
	LoggingEnabled *LoggingEnabled `type:"structure"`
	// contains filtered or unexported fields
}

func (BucketLoggingStatus) GoString added in v0.6.5 

func (s BucketLoggingStatus) GoString() string

GoString returns the string representation

func (*BucketLoggingStatus) SetLoggingEnabled added in v1.5.0 

func (s *BucketLoggingStatus) SetLoggingEnabled(v *LoggingEnabled) *BucketLoggingStatus

SetLoggingEnabled sets the LoggingEnabled field's value.

func (BucketLoggingStatus) String added in v0.6.5 

func (s BucketLoggingStatus) String() string

String returns the string representation

func (*BucketLoggingStatus) Validate added in v1.1.21 

func (s *BucketLoggingStatus) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CORSConfiguration 

type CORSConfiguration struct {

	// CORSRules is a required field
	CORSRules []*CORSRule `locationName:"CORSRule" type:"list" flattened:"true" required:"true"`
	// contains filtered or unexported fields
}

func (CORSConfiguration) GoString added in v0.6.5 

func (s CORSConfiguration) GoString() string

GoString returns the string representation

func (*CORSConfiguration) SetCORSRules added in v1.5.0 

func (s *CORSConfiguration) SetCORSRules(v []*CORSRule) *CORSConfiguration

SetCORSRules sets the CORSRules field's value.

func (CORSConfiguration) String added in v0.6.5 

func (s CORSConfiguration) String() string

String returns the string representation

func (*CORSConfiguration) Validate added in v1.1.21 

func (s *CORSConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CORSRule 

type CORSRule struct {

	// Specifies which headers are allowed in a pre-flight OPTIONS request.
	AllowedHeaders []*string `locationName:"AllowedHeader" type:"list" flattened:"true"`

	// Identifies HTTP methods that the domain/origin specified in the rule is allowed
	// to execute.
	//
	// AllowedMethods is a required field
	AllowedMethods []*string `locationName:"AllowedMethod" type:"list" flattened:"true" required:"true"`

	// One or more origins you want customers to be able to access the bucket from.
	//
	// AllowedOrigins is a required field
	AllowedOrigins []*string `locationName:"AllowedOrigin" type:"list" flattened:"true" required:"true"`

	// One or more headers in the response that you want customers to be able to
	// access from their applications (for example, from a JavaScript XMLHttpRequest
	// object).
	ExposeHeaders []*string `locationName:"ExposeHeader" type:"list" flattened:"true"`

	// The time in seconds that your browser is to cache the preflight response
	// for the specified resource.
	MaxAgeSeconds *int64 `type:"integer"`
	// contains filtered or unexported fields
}

func (CORSRule) GoString added in v0.6.5 

func (s CORSRule) GoString() string

GoString returns the string representation

func (*CORSRule) SetAllowedHeaders added in v1.5.0 

func (s *CORSRule) SetAllowedHeaders(v []*string) *CORSRule

SetAllowedHeaders sets the AllowedHeaders field's value.

func (*CORSRule) SetAllowedMethods added in v1.5.0 

func (s *CORSRule) SetAllowedMethods(v []*string) *CORSRule

SetAllowedMethods sets the AllowedMethods field's value.

func (*CORSRule) SetAllowedOrigins added in v1.5.0 

func (s *CORSRule) SetAllowedOrigins(v []*string) *CORSRule

SetAllowedOrigins sets the AllowedOrigins field's value.

func (*CORSRule) SetExposeHeaders added in v1.5.0 

func (s *CORSRule) SetExposeHeaders(v []*string) *CORSRule

SetExposeHeaders sets the ExposeHeaders field's value.

func (*CORSRule) SetMaxAgeSeconds added in v1.5.0 

func (s *CORSRule) SetMaxAgeSeconds(v int64) *CORSRule

SetMaxAgeSeconds sets the MaxAgeSeconds field's value.

func (CORSRule) String added in v0.6.5 

func (s CORSRule) String() string

String returns the string representation

func (*CORSRule) Validate added in v1.1.21 

func (s *CORSRule) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CSVInput added in v1.12.36 

type CSVInput struct {

	// Specifies that CSV field values may contain quoted record delimiters and
	// such records should be allowed. Default value is FALSE. Setting this value
	// to TRUE may lower performance.
	AllowQuotedRecordDelimiter *bool `type:"boolean"`

	// Single character used to indicate a row should be ignored when present at
	// the start of a row.
	Comments *string `type:"string"`

	// Value used to separate individual fields in a record.
	FieldDelimiter *string `type:"string"`

	// Describes the first line of input. Valid values: None, Ignore, Use.
	FileHeaderInfo *string `type:"string" enum:"FileHeaderInfo"`

	// Value used for escaping where the field delimiter is part of the value.
	QuoteCharacter *string `type:"string"`

	// Single character used for escaping the quote character inside an already
	// escaped value.
	QuoteEscapeCharacter *string `type:"string"`

	// Value used to separate individual records.
	RecordDelimiter *string `type:"string"`
	// contains filtered or unexported fields
}

Describes how a CSV-formatted input object is formatted.

func (CSVInput) GoString added in v1.12.36 

func (s CSVInput) GoString() string

GoString returns the string representation

func (*CSVInput) SetAllowQuotedRecordDelimiter added in v1.14.14 

func (s *CSVInput) SetAllowQuotedRecordDelimiter(v bool) *CSVInput

SetAllowQuotedRecordDelimiter sets the AllowQuotedRecordDelimiter field's value.

func (*CSVInput) SetComments added in v1.12.36 

func (s *CSVInput) SetComments(v string) *CSVInput

SetComments sets the Comments field's value.

func (*CSVInput) SetFieldDelimiter added in v1.12.36 

func (s *CSVInput) SetFieldDelimiter(v string) *CSVInput

SetFieldDelimiter sets the FieldDelimiter field's value.

func (*CSVInput) SetFileHeaderInfo added in v1.12.36 

func (s *CSVInput) SetFileHeaderInfo(v string) *CSVInput

SetFileHeaderInfo sets the FileHeaderInfo field's value.

func (*CSVInput) SetQuoteCharacter added in v1.12.36 

func (s *CSVInput) SetQuoteCharacter(v string) *CSVInput

SetQuoteCharacter sets the QuoteCharacter field's value.

func (*CSVInput) SetQuoteEscapeCharacter added in v1.12.36 

func (s *CSVInput) SetQuoteEscapeCharacter(v string) *CSVInput

SetQuoteEscapeCharacter sets the QuoteEscapeCharacter field's value.

func (*CSVInput) SetRecordDelimiter added in v1.12.36 

func (s *CSVInput) SetRecordDelimiter(v string) *CSVInput

SetRecordDelimiter sets the RecordDelimiter field's value.

func (CSVInput) String added in v1.12.36 

func (s CSVInput) String() string

String returns the string representation

type CSVOutput added in v1.12.36 

type CSVOutput struct {

	// Value used to separate individual fields in a record.
	FieldDelimiter *string `type:"string"`

	// Value used for escaping where the field delimiter is part of the value.
	QuoteCharacter *string `type:"string"`

	// Single character used for escaping the quote character inside an already
	// escaped value.
	QuoteEscapeCharacter *string `type:"string"`

	// Indicates whether or not all output fields should be quoted.
	QuoteFields *string `type:"string" enum:"QuoteFields"`

	// Value used to separate individual records.
	RecordDelimiter *string `type:"string"`
	// contains filtered or unexported fields
}

Describes how CSV-formatted results are formatted.

func (CSVOutput) GoString added in v1.12.36 

func (s CSVOutput) GoString() string

GoString returns the string representation

func (*CSVOutput) SetFieldDelimiter added in v1.12.36 

func (s *CSVOutput) SetFieldDelimiter(v string) *CSVOutput

SetFieldDelimiter sets the FieldDelimiter field's value.

func (*CSVOutput) SetQuoteCharacter added in v1.12.36 

func (s *CSVOutput) SetQuoteCharacter(v string) *CSVOutput

SetQuoteCharacter sets the QuoteCharacter field's value.

func (*CSVOutput) SetQuoteEscapeCharacter added in v1.12.36 

func (s *CSVOutput) SetQuoteEscapeCharacter(v string) *CSVOutput

SetQuoteEscapeCharacter sets the QuoteEscapeCharacter field's value.

func (*CSVOutput) SetQuoteFields added in v1.12.36 

func (s *CSVOutput) SetQuoteFields(v string) *CSVOutput

SetQuoteFields sets the QuoteFields field's value.

func (*CSVOutput) SetRecordDelimiter added in v1.12.36 

func (s *CSVOutput) SetRecordDelimiter(v string) *CSVOutput

SetRecordDelimiter sets the RecordDelimiter field's value.

func (CSVOutput) String added in v1.12.36 

func (s CSVOutput) String() string

String returns the string representation

type CloudFunctionConfiguration 

type CloudFunctionConfiguration struct {
	CloudFunction *string `type:"string"`

	// Bucket event for which to send notifications.
	//
	// Deprecated: Event has been deprecated
	Event *string `deprecated:"true" type:"string" enum:"Event"`

	Events []*string `locationName:"Event" type:"list" flattened:"true"`

	// Optional unique identifier for configurations in a notification configuration.
	// If you don't provide one, Amazon S3 will assign an ID.
	Id *string `type:"string"`

	InvocationRole *string `type:"string"`
	// contains filtered or unexported fields
}

func (CloudFunctionConfiguration) GoString added in v0.6.5 

func (s CloudFunctionConfiguration) GoString() string

GoString returns the string representation

func (*CloudFunctionConfiguration) SetCloudFunction added in v1.5.0 

func (s *CloudFunctionConfiguration) SetCloudFunction(v string) *CloudFunctionConfiguration

SetCloudFunction sets the CloudFunction field's value.

func (*CloudFunctionConfiguration) SetEvent added in v1.5.0 

func (s *CloudFunctionConfiguration) SetEvent(v string) *CloudFunctionConfiguration

SetEvent sets the Event field's value.

func (*CloudFunctionConfiguration) SetEvents added in v1.5.0 

func (s *CloudFunctionConfiguration) SetEvents(v []*string) *CloudFunctionConfiguration

SetEvents sets the Events field's value.

func (*CloudFunctionConfiguration) SetId added in v1.5.0 

func (s *CloudFunctionConfiguration) SetId(v string) *CloudFunctionConfiguration

SetId sets the Id field's value.

func (*CloudFunctionConfiguration) SetInvocationRole added in v1.5.0 

func (s *CloudFunctionConfiguration) SetInvocationRole(v string) *CloudFunctionConfiguration

SetInvocationRole sets the InvocationRole field's value.

func (CloudFunctionConfiguration) String added in v0.6.5 

func (s CloudFunctionConfiguration) String() string

String returns the string representation

type CommonPrefix 

type CommonPrefix struct {
	Prefix *string `type:"string"`
	// contains filtered or unexported fields
}

func (CommonPrefix) GoString added in v0.6.5 

func (s CommonPrefix) GoString() string

GoString returns the string representation

func (*CommonPrefix) SetPrefix added in v1.5.0 

func (s *CommonPrefix) SetPrefix(v string) *CommonPrefix

SetPrefix sets the Prefix field's value.

func (CommonPrefix) String added in v0.6.5 

func (s CommonPrefix) String() string

String returns the string representation

type CompleteMultipartUploadInput 

type CompleteMultipartUploadInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	MultipartUpload *CompletedMultipartUpload `locationName:"CompleteMultipartUpload" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`

	// UploadId is a required field
	UploadId *string `location:"querystring" locationName:"uploadId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (CompleteMultipartUploadInput) GoString added in v0.6.5 

func (s CompleteMultipartUploadInput) GoString() string

GoString returns the string representation

func (*CompleteMultipartUploadInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*CompleteMultipartUploadInput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*CompleteMultipartUploadInput) SetMultipartUpload added in v1.5.0 

func (s *CompleteMultipartUploadInput) SetMultipartUpload(v *CompletedMultipartUpload) *CompleteMultipartUploadInput

SetMultipartUpload sets the MultipartUpload field's value.

func (*CompleteMultipartUploadInput) SetRequestPayer added in v1.5.0 

func (s *CompleteMultipartUploadInput) SetRequestPayer(v string) *CompleteMultipartUploadInput

SetRequestPayer sets the RequestPayer field's value.

func (*CompleteMultipartUploadInput) SetUploadId added in v1.5.0 

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

SetUploadId sets the UploadId field's value.

func (CompleteMultipartUploadInput) String added in v0.6.5 

func (s CompleteMultipartUploadInput) String() string

String returns the string representation

func (*CompleteMultipartUploadInput) Validate added in v1.1.21 

func (s *CompleteMultipartUploadInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CompleteMultipartUploadOutput 

type CompleteMultipartUploadOutput struct {
	Bucket *string `type:"string"`

	// Entity tag of the object.
	ETag *string `type:"string"`

	// If the object expiration is configured, this will contain the expiration
	// date (expiry-date) and rule ID (rule-id). The value of rule-id is URL encoded.
	Expiration *string `location:"header" locationName:"x-amz-expiration" type:"string"`

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

	Location *string `type:"string"`

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`

	// If present, specifies the ID of the AWS Key Management Service (KMS) master
	// encryption key that was used for the object.
	SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string"`

	// The Server-side encryption algorithm used when storing this object in S3
	// (e.g., AES256, aws:kms).
	ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`

	// Version of the object.
	VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
	// contains filtered or unexported fields
}

func (CompleteMultipartUploadOutput) GoString added in v0.6.5 

func (s CompleteMultipartUploadOutput) GoString() string

GoString returns the string representation

func (*CompleteMultipartUploadOutput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*CompleteMultipartUploadOutput) SetETag added in v1.5.0 

func (s *CompleteMultipartUploadOutput) SetETag(v string) *CompleteMultipartUploadOutput

SetETag sets the ETag field's value.

func (*CompleteMultipartUploadOutput) SetExpiration added in v1.5.0 

func (s *CompleteMultipartUploadOutput) SetExpiration(v string) *CompleteMultipartUploadOutput

SetExpiration sets the Expiration field's value.

func (*CompleteMultipartUploadOutput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*CompleteMultipartUploadOutput) SetLocation added in v1.5.0 

func (s *CompleteMultipartUploadOutput) SetLocation(v string) *CompleteMultipartUploadOutput

SetLocation sets the Location field's value.

func (*CompleteMultipartUploadOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (*CompleteMultipartUploadOutput) SetSSEKMSKeyId added in v1.5.0 

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

SetSSEKMSKeyId sets the SSEKMSKeyId field's value.

func (*CompleteMultipartUploadOutput) SetServerSideEncryption added in v1.5.0 

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

SetServerSideEncryption sets the ServerSideEncryption field's value.

func (*CompleteMultipartUploadOutput) SetVersionId added in v1.5.0 

func (s *CompleteMultipartUploadOutput) SetVersionId(v string) *CompleteMultipartUploadOutput

SetVersionId sets the VersionId field's value.

func (CompleteMultipartUploadOutput) String added in v0.6.5 

func (s CompleteMultipartUploadOutput) String() string

String returns the string representation

type CompletedMultipartUpload 

type CompletedMultipartUpload struct {
	Parts []*CompletedPart `locationName:"Part" type:"list" flattened:"true"`
	// contains filtered or unexported fields
}

func (CompletedMultipartUpload) GoString added in v0.6.5 

func (s CompletedMultipartUpload) GoString() string

GoString returns the string representation

func (*CompletedMultipartUpload) SetParts added in v1.5.0 

func (s *CompletedMultipartUpload) SetParts(v []*CompletedPart) *CompletedMultipartUpload

SetParts sets the Parts field's value.

func (CompletedMultipartUpload) String added in v0.6.5 

func (s CompletedMultipartUpload) String() string

String returns the string representation

type CompletedPart 

type CompletedPart struct {

	// Entity tag returned when the part was uploaded.
	ETag *string `type:"string"`

	// Part number that identifies the part. This is a positive integer between
	// 1 and 10,000.
	PartNumber *int64 `type:"integer"`
	// contains filtered or unexported fields
}

func (CompletedPart) GoString added in v0.6.5 

func (s CompletedPart) GoString() string

GoString returns the string representation

func (*CompletedPart) SetETag added in v1.5.0 

func (s *CompletedPart) SetETag(v string) *CompletedPart

SetETag sets the ETag field's value.

func (*CompletedPart) SetPartNumber added in v1.5.0 

func (s *CompletedPart) SetPartNumber(v int64) *CompletedPart

SetPartNumber sets the PartNumber field's value.

func (CompletedPart) String added in v0.6.5 

func (s CompletedPart) String() string

String returns the string representation

type Condition 

type Condition struct {

	// The HTTP error code when the redirect is applied. In the event of an error,
	// if the error code equals this value, then the specified redirect is applied.
	// Required when parent element Condition is specified and sibling KeyPrefixEquals
	// is not specified. If both are specified, then both must be true for the redirect
	// to be applied.
	HttpErrorCodeReturnedEquals *string `type:"string"`

	// The object key name prefix when the redirect is applied. For example, to
	// redirect requests for ExamplePage.html, the key prefix will be ExamplePage.html.
	// To redirect request for all pages with the prefix docs/, the key prefix will
	// be /docs, which identifies all objects in the docs/ folder. Required when
	// the parent element Condition is specified and sibling HttpErrorCodeReturnedEquals
	// is not specified. If both conditions are specified, both must be true for
	// the redirect to be applied.
	KeyPrefixEquals *string `type:"string"`
	// contains filtered or unexported fields
}

func (Condition) GoString added in v0.6.5 

func (s Condition) GoString() string

GoString returns the string representation

func (*Condition) SetHttpErrorCodeReturnedEquals added in v1.5.0 

func (s *Condition) SetHttpErrorCodeReturnedEquals(v string) *Condition

SetHttpErrorCodeReturnedEquals sets the HttpErrorCodeReturnedEquals field's value.

func (*Condition) SetKeyPrefixEquals added in v1.5.0 

func (s *Condition) SetKeyPrefixEquals(v string) *Condition

SetKeyPrefixEquals sets the KeyPrefixEquals field's value.

func (Condition) String added in v0.6.5 

func (s Condition) String() string

String returns the string representation

type ContinuationEvent added in v1.14.0 

type ContinuationEvent struct {
	// contains filtered or unexported fields
}

func (ContinuationEvent) GoString added in v1.14.0 

func (s ContinuationEvent) GoString() string

GoString returns the string representation

func (ContinuationEvent) String added in v1.14.0 

func (s ContinuationEvent) String() string

String returns the string representation

func (*ContinuationEvent) UnmarshalEvent added in v1.14.0 

func (s *ContinuationEvent) UnmarshalEvent(
	payloadUnmarshaler protocol.PayloadUnmarshaler,
	msg eventstream.Message,
) error

UnmarshalEvent unmarshals the EventStream Message into the ContinuationEvent value. This method is only used internally within the SDK's EventStream handling.

type CopyObjectInput 

type CopyObjectInput struct {

	// The canned ACL to apply to the object.
	ACL *string `location:"header" locationName:"x-amz-acl" type:"string" enum:"ObjectCannedACL"`

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Specifies caching behavior along the request/reply chain.
	CacheControl *string `location:"header" locationName:"Cache-Control" type:"string"`

	// Specifies presentational information for the object.
	ContentDisposition *string `location:"header" locationName:"Content-Disposition" type:"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.
	ContentEncoding *string `location:"header" locationName:"Content-Encoding" type:"string"`

	// The language the content is in.
	ContentLanguage *string `location:"header" locationName:"Content-Language" type:"string"`

	// A standard MIME type describing the format of the object data.
	ContentType *string `location:"header" locationName:"Content-Type" type:"string"`

	// The name of the source bucket and key name of the source object, separated
	// by a slash (/). Must be URL-encoded.
	//
	// CopySource is a required field
	CopySource *string `location:"header" locationName:"x-amz-copy-source" type:"string" required:"true"`

	// Copies the object if its entity tag (ETag) matches the specified tag.
	CopySourceIfMatch *string `location:"header" locationName:"x-amz-copy-source-if-match" type:"string"`

	// Copies the object if it has been modified since the specified time.
	CopySourceIfModifiedSince *time.Time `location:"header" locationName:"x-amz-copy-source-if-modified-since" type:"timestamp"`

	// Copies the object if its entity tag (ETag) is different than the specified
	// ETag.
	CopySourceIfNoneMatch *string `location:"header" locationName:"x-amz-copy-source-if-none-match" type:"string"`

	// Copies the object if it hasn't been modified since the specified time.
	CopySourceIfUnmodifiedSince *time.Time `location:"header" locationName:"x-amz-copy-source-if-unmodified-since" type:"timestamp"`

	// Specifies the algorithm to use when decrypting the source object (e.g., AES256).
	CopySourceSSECustomerAlgorithm *string `location:"header" locationName:"x-amz-copy-source-server-side-encryption-customer-algorithm" type:"string"`

	// Specifies the customer-provided encryption key for Amazon S3 to use to decrypt
	// the source object. The encryption key provided in this header must be one
	// that was used when the source object was created.
	CopySourceSSECustomerKey *string `location:"header" locationName:"x-amz-copy-source-server-side-encryption-customer-key" type:"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 the encryption
	// key was transmitted without error.
	CopySourceSSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-copy-source-server-side-encryption-customer-key-MD5" type:"string"`

	// The date and time at which the object is no longer cacheable.
	Expires *time.Time `location:"header" locationName:"Expires" type:"timestamp"`

	// Gives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object.
	GrantFullControl *string `location:"header" locationName:"x-amz-grant-full-control" type:"string"`

	// Allows grantee to read the object data and its metadata.
	GrantRead *string `location:"header" locationName:"x-amz-grant-read" type:"string"`

	// Allows grantee to read the object ACL.
	GrantReadACP *string `location:"header" locationName:"x-amz-grant-read-acp" type:"string"`

	// Allows grantee to write the ACL for the applicable object.
	GrantWriteACP *string `location:"header" locationName:"x-amz-grant-write-acp" type:"string"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// A map of metadata to store with the object in S3.
	Metadata map[string]*string `location:"headers" locationName:"x-amz-meta-" type:"map"`

	// Specifies whether the metadata is copied from the source object or replaced
	// with metadata provided in the request.
	MetadataDirective *string `location:"header" locationName:"x-amz-metadata-directive" type:"string" enum:"MetadataDirective"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`

	// Specifies the algorithm to use to when encrypting the object (e.g., AES256).
	SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"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
	// 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 `location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"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 the encryption
	// key was transmitted without error.
	SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`

	// 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
	SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string"`

	// The Server-side encryption algorithm used when storing this object in S3
	// (e.g., AES256, aws:kms).
	ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`

	// The type of storage to use for the object. Defaults to 'STANDARD'.
	StorageClass *string `location:"header" locationName:"x-amz-storage-class" type:"string" enum:"StorageClass"`

	// The tag-set for the object destination object this value must be used in
	// conjunction with the TaggingDirective. The tag-set must be encoded as URL
	// Query parameters
	Tagging *string `location:"header" locationName:"x-amz-tagging" type:"string"`

	// Specifies whether the object tag-set are copied from the source object or
	// replaced with tag-set provided in the request.
	TaggingDirective *string `location:"header" locationName:"x-amz-tagging-directive" type:"string" enum:"TaggingDirective"`

	// 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.
	WebsiteRedirectLocation *string `location:"header" locationName:"x-amz-website-redirect-location" type:"string"`
	// contains filtered or unexported fields
}

func (CopyObjectInput) GoString added in v0.6.5 

func (s CopyObjectInput) GoString() string

GoString returns the string representation

func (*CopyObjectInput) SetACL added in v1.5.0 

func (s *CopyObjectInput) SetACL(v string) *CopyObjectInput

SetACL sets the ACL field's value.

func (*CopyObjectInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*CopyObjectInput) SetCacheControl added in v1.5.0 

func (s *CopyObjectInput) SetCacheControl(v string) *CopyObjectInput

SetCacheControl sets the CacheControl field's value.

func (*CopyObjectInput) SetContentDisposition added in v1.5.0 

func (s *CopyObjectInput) SetContentDisposition(v string) *CopyObjectInput

SetContentDisposition sets the ContentDisposition field's value.

func (*CopyObjectInput) SetContentEncoding added in v1.5.0 

func (s *CopyObjectInput) SetContentEncoding(v string) *CopyObjectInput

SetContentEncoding sets the ContentEncoding field's value.

func (*CopyObjectInput) SetContentLanguage added in v1.5.0 

func (s *CopyObjectInput) SetContentLanguage(v string) *CopyObjectInput

SetContentLanguage sets the ContentLanguage field's value.

func (*CopyObjectInput) SetContentType added in v1.5.0 

func (s *CopyObjectInput) SetContentType(v string) *CopyObjectInput

SetContentType sets the ContentType field's value.

func (*CopyObjectInput) SetCopySource added in v1.5.0 

func (s *CopyObjectInput) SetCopySource(v string) *CopyObjectInput

SetCopySource sets the CopySource field's value.

func (*CopyObjectInput) SetCopySourceIfMatch added in v1.5.0 

func (s *CopyObjectInput) SetCopySourceIfMatch(v string) *CopyObjectInput

SetCopySourceIfMatch sets the CopySourceIfMatch field's value.

func (*CopyObjectInput) SetCopySourceIfModifiedSince added in v1.5.0 

func (s *CopyObjectInput) SetCopySourceIfModifiedSince(v time.Time) *CopyObjectInput

SetCopySourceIfModifiedSince sets the CopySourceIfModifiedSince field's value.

func (*CopyObjectInput) SetCopySourceIfNoneMatch added in v1.5.0 

func (s *CopyObjectInput) SetCopySourceIfNoneMatch(v string) *CopyObjectInput

SetCopySourceIfNoneMatch sets the CopySourceIfNoneMatch field's value.

func (*CopyObjectInput) SetCopySourceIfUnmodifiedSince added in v1.5.0 

func (s *CopyObjectInput) SetCopySourceIfUnmodifiedSince(v time.Time) *CopyObjectInput

SetCopySourceIfUnmodifiedSince sets the CopySourceIfUnmodifiedSince field's value.

func (*CopyObjectInput) SetCopySourceSSECustomerAlgorithm added in v1.5.0 

func (s *CopyObjectInput) SetCopySourceSSECustomerAlgorithm(v string) *CopyObjectInput

SetCopySourceSSECustomerAlgorithm sets the CopySourceSSECustomerAlgorithm field's value.

func (*CopyObjectInput) SetCopySourceSSECustomerKey added in v1.5.0 

func (s *CopyObjectInput) SetCopySourceSSECustomerKey(v string) *CopyObjectInput

SetCopySourceSSECustomerKey sets the CopySourceSSECustomerKey field's value.

func (*CopyObjectInput) SetCopySourceSSECustomerKeyMD5 added in v1.5.0 

func (s *CopyObjectInput) SetCopySourceSSECustomerKeyMD5(v string) *CopyObjectInput

SetCopySourceSSECustomerKeyMD5 sets the CopySourceSSECustomerKeyMD5 field's value.

func (*CopyObjectInput) SetExpires added in v1.5.0 

func (s *CopyObjectInput) SetExpires(v time.Time) *CopyObjectInput

SetExpires sets the Expires field's value.

func (*CopyObjectInput) SetGrantFullControl added in v1.5.0 

func (s *CopyObjectInput) SetGrantFullControl(v string) *CopyObjectInput

SetGrantFullControl sets the GrantFullControl field's value.

func (*CopyObjectInput) SetGrantRead added in v1.5.0 

func (s *CopyObjectInput) SetGrantRead(v string) *CopyObjectInput

SetGrantRead sets the GrantRead field's value.

func (*CopyObjectInput) SetGrantReadACP added in v1.5.0 

func (s *CopyObjectInput) SetGrantReadACP(v string) *CopyObjectInput

SetGrantReadACP sets the GrantReadACP field's value.

func (*CopyObjectInput) SetGrantWriteACP added in v1.5.0 

func (s *CopyObjectInput) SetGrantWriteACP(v string) *CopyObjectInput

SetGrantWriteACP sets the GrantWriteACP field's value.

func (*CopyObjectInput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*CopyObjectInput) SetMetadata added in v1.5.0 

func (s *CopyObjectInput) SetMetadata(v map[string]*string) *CopyObjectInput

SetMetadata sets the Metadata field's value.

func (*CopyObjectInput) SetMetadataDirective added in v1.5.0 

func (s *CopyObjectInput) SetMetadataDirective(v string) *CopyObjectInput

SetMetadataDirective sets the MetadataDirective field's value.

func (*CopyObjectInput) SetRequestPayer added in v1.5.0 

func (s *CopyObjectInput) SetRequestPayer(v string) *CopyObjectInput

SetRequestPayer sets the RequestPayer field's value.

func (*CopyObjectInput) SetSSECustomerAlgorithm added in v1.5.0 

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

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.

func (*CopyObjectInput) SetSSECustomerKey added in v1.5.0 

func (s *CopyObjectInput) SetSSECustomerKey(v string) *CopyObjectInput

SetSSECustomerKey sets the SSECustomerKey field's value.

func (*CopyObjectInput) SetSSECustomerKeyMD5 added in v1.5.0 

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

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.

func (*CopyObjectInput) SetSSEKMSKeyId added in v1.5.0 

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

SetSSEKMSKeyId sets the SSEKMSKeyId field's value.

func (*CopyObjectInput) SetServerSideEncryption added in v1.5.0 

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

SetServerSideEncryption sets the ServerSideEncryption field's value.

func (*CopyObjectInput) SetStorageClass added in v1.5.0 

func (s *CopyObjectInput) SetStorageClass(v string) *CopyObjectInput

SetStorageClass sets the StorageClass field's value.

func (*CopyObjectInput) SetTagging added in v1.5.11 

func (s *CopyObjectInput) SetTagging(v string) *CopyObjectInput

SetTagging sets the Tagging field's value.

func (*CopyObjectInput) SetTaggingDirective added in v1.5.11 

func (s *CopyObjectInput) SetTaggingDirective(v string) *CopyObjectInput

SetTaggingDirective sets the TaggingDirective field's value.

func (*CopyObjectInput) SetWebsiteRedirectLocation added in v1.5.0 

func (s *CopyObjectInput) SetWebsiteRedirectLocation(v string) *CopyObjectInput

SetWebsiteRedirectLocation sets the WebsiteRedirectLocation field's value.

func (CopyObjectInput) String added in v0.6.5 

func (s CopyObjectInput) String() string

String returns the string representation

func (*CopyObjectInput) Validate added in v1.1.21 

func (s *CopyObjectInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CopyObjectOutput 

type CopyObjectOutput struct {
	CopyObjectResult *CopyObjectResult `type:"structure"`

	CopySourceVersionId *string `location:"header" locationName:"x-amz-copy-source-version-id" type:"string"`

	// If the object expiration is configured, the response includes this header.
	Expiration *string `location:"header" locationName:"x-amz-expiration" type:"string"`

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"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 `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 to provide round trip message integrity
	// verification of the customer-provided encryption key.
	SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`

	// If present, specifies the ID of the AWS Key Management Service (KMS) master
	// encryption key that was used for the object.
	SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string"`

	// The Server-side encryption algorithm used when storing this object in S3
	// (e.g., AES256, aws:kms).
	ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`

	// Version ID of the newly created copy.
	VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
	// contains filtered or unexported fields
}

func (CopyObjectOutput) GoString added in v0.6.5 

func (s CopyObjectOutput) GoString() string

GoString returns the string representation

func (*CopyObjectOutput) SetCopyObjectResult added in v1.5.0 

func (s *CopyObjectOutput) SetCopyObjectResult(v *CopyObjectResult) *CopyObjectOutput

SetCopyObjectResult sets the CopyObjectResult field's value.

func (*CopyObjectOutput) SetCopySourceVersionId added in v1.5.0 

func (s *CopyObjectOutput) SetCopySourceVersionId(v string) *CopyObjectOutput

SetCopySourceVersionId sets the CopySourceVersionId field's value.

func (*CopyObjectOutput) SetExpiration added in v1.5.0 

func (s *CopyObjectOutput) SetExpiration(v string) *CopyObjectOutput

SetExpiration sets the Expiration field's value.

func (*CopyObjectOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (*CopyObjectOutput) SetSSECustomerAlgorithm added in v1.5.0 

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

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.

func (*CopyObjectOutput) SetSSECustomerKeyMD5 added in v1.5.0 

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

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.

func (*CopyObjectOutput) SetSSEKMSKeyId added in v1.5.0 

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

SetSSEKMSKeyId sets the SSEKMSKeyId field's value.

func (*CopyObjectOutput) SetServerSideEncryption added in v1.5.0 

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

SetServerSideEncryption sets the ServerSideEncryption field's value.

func (*CopyObjectOutput) SetVersionId added in v1.5.0 

func (s *CopyObjectOutput) SetVersionId(v string) *CopyObjectOutput

SetVersionId sets the VersionId field's value.

func (CopyObjectOutput) String added in v0.6.5 

func (s CopyObjectOutput) String() string

String returns the string representation

type CopyObjectResult 

type CopyObjectResult struct {
	ETag *string `type:"string"`

	LastModified *time.Time `type:"timestamp"`
	// contains filtered or unexported fields
}

func (CopyObjectResult) GoString added in v0.6.5 

func (s CopyObjectResult) GoString() string

GoString returns the string representation

func (*CopyObjectResult) SetETag added in v1.5.0 

func (s *CopyObjectResult) SetETag(v string) *CopyObjectResult

SetETag sets the ETag field's value.

func (*CopyObjectResult) SetLastModified added in v1.5.0 

func (s *CopyObjectResult) SetLastModified(v time.Time) *CopyObjectResult

SetLastModified sets the LastModified field's value.

func (CopyObjectResult) String added in v0.6.5 

func (s CopyObjectResult) String() string

String returns the string representation

type CopyPartResult 

type CopyPartResult struct {

	// Entity tag of the object.
	ETag *string `type:"string"`

	// Date and time at which the object was uploaded.
	LastModified *time.Time `type:"timestamp"`
	// contains filtered or unexported fields
}

func (CopyPartResult) GoString added in v0.6.5 

func (s CopyPartResult) GoString() string

GoString returns the string representation

func (*CopyPartResult) SetETag added in v1.5.0 

func (s *CopyPartResult) SetETag(v string) *CopyPartResult

SetETag sets the ETag field's value.

func (*CopyPartResult) SetLastModified added in v1.5.0 

func (s *CopyPartResult) SetLastModified(v time.Time) *CopyPartResult

SetLastModified sets the LastModified field's value.

func (CopyPartResult) String added in v0.6.5 

func (s CopyPartResult) String() string

String returns the string representation

type CreateBucketConfiguration 

type CreateBucketConfiguration struct {

	// Specifies the region where the bucket will be created. If you don't specify
	// a region, the bucket will be created in US Standard.
	LocationConstraint *string `type:"string" enum:"BucketLocationConstraint"`
	// contains filtered or unexported fields
}

func (CreateBucketConfiguration) GoString added in v0.6.5 

func (s CreateBucketConfiguration) GoString() string

GoString returns the string representation

func (*CreateBucketConfiguration) SetLocationConstraint added in v1.5.0 

func (s *CreateBucketConfiguration) SetLocationConstraint(v string) *CreateBucketConfiguration

SetLocationConstraint sets the LocationConstraint field's value.

func (CreateBucketConfiguration) String added in v0.6.5 

func (s CreateBucketConfiguration) String() string

String returns the string representation

type CreateBucketInput 

type CreateBucketInput struct {

	// The canned ACL to apply to the bucket.
	ACL *string `location:"header" locationName:"x-amz-acl" type:"string" enum:"BucketCannedACL"`

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	CreateBucketConfiguration *CreateBucketConfiguration `locationName:"CreateBucketConfiguration" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`

	// Allows grantee the read, write, read ACP, and write ACP permissions on the
	// bucket.
	GrantFullControl *string `location:"header" locationName:"x-amz-grant-full-control" type:"string"`

	// Allows grantee to list the objects in the bucket.
	GrantRead *string `location:"header" locationName:"x-amz-grant-read" type:"string"`

	// Allows grantee to read the bucket ACL.
	GrantReadACP *string `location:"header" locationName:"x-amz-grant-read-acp" type:"string"`

	// Allows grantee to create, overwrite, and delete any object in the bucket.
	GrantWrite *string `location:"header" locationName:"x-amz-grant-write" type:"string"`

	// Allows grantee to write the ACL for the applicable bucket.
	GrantWriteACP *string `location:"header" locationName:"x-amz-grant-write-acp" type:"string"`
	// contains filtered or unexported fields
}

func (CreateBucketInput) GoString added in v0.6.5 

func (s CreateBucketInput) GoString() string

GoString returns the string representation

func (*CreateBucketInput) SetACL added in v1.5.0 

func (s *CreateBucketInput) SetACL(v string) *CreateBucketInput

SetACL sets the ACL field's value.

func (*CreateBucketInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*CreateBucketInput) SetCreateBucketConfiguration added in v1.5.0 

func (s *CreateBucketInput) SetCreateBucketConfiguration(v *CreateBucketConfiguration) *CreateBucketInput

SetCreateBucketConfiguration sets the CreateBucketConfiguration field's value.

func (*CreateBucketInput) SetGrantFullControl added in v1.5.0 

func (s *CreateBucketInput) SetGrantFullControl(v string) *CreateBucketInput

SetGrantFullControl sets the GrantFullControl field's value.

func (*CreateBucketInput) SetGrantRead added in v1.5.0 

func (s *CreateBucketInput) SetGrantRead(v string) *CreateBucketInput

SetGrantRead sets the GrantRead field's value.

func (*CreateBucketInput) SetGrantReadACP added in v1.5.0 

func (s *CreateBucketInput) SetGrantReadACP(v string) *CreateBucketInput

SetGrantReadACP sets the GrantReadACP field's value.

func (*CreateBucketInput) SetGrantWrite added in v1.5.0 

func (s *CreateBucketInput) SetGrantWrite(v string) *CreateBucketInput

SetGrantWrite sets the GrantWrite field's value.

func (*CreateBucketInput) SetGrantWriteACP added in v1.5.0 

func (s *CreateBucketInput) SetGrantWriteACP(v string) *CreateBucketInput

SetGrantWriteACP sets the GrantWriteACP field's value.

func (CreateBucketInput) String added in v0.6.5 

func (s CreateBucketInput) String() string

String returns the string representation

func (*CreateBucketInput) Validate added in v1.1.21 

func (s *CreateBucketInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreateBucketOutput 

type CreateBucketOutput struct {
	Location *string `location:"header" locationName:"Location" type:"string"`
	// contains filtered or unexported fields
}

func (CreateBucketOutput) GoString added in v0.6.5 

func (s CreateBucketOutput) GoString() string

GoString returns the string representation

func (*CreateBucketOutput) SetLocation added in v1.5.0 

func (s *CreateBucketOutput) SetLocation(v string) *CreateBucketOutput

SetLocation sets the Location field's value.

func (CreateBucketOutput) String added in v0.6.5 

func (s CreateBucketOutput) String() string

String returns the string representation

type CreateMultipartUploadInput 

type CreateMultipartUploadInput struct {

	// The canned ACL to apply to the object.
	ACL *string `location:"header" locationName:"x-amz-acl" type:"string" enum:"ObjectCannedACL"`

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Specifies caching behavior along the request/reply chain.
	CacheControl *string `location:"header" locationName:"Cache-Control" type:"string"`

	// Specifies presentational information for the object.
	ContentDisposition *string `location:"header" locationName:"Content-Disposition" type:"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.
	ContentEncoding *string `location:"header" locationName:"Content-Encoding" type:"string"`

	// The language the content is in.
	ContentLanguage *string `location:"header" locationName:"Content-Language" type:"string"`

	// A standard MIME type describing the format of the object data.
	ContentType *string `location:"header" locationName:"Content-Type" type:"string"`

	// The date and time at which the object is no longer cacheable.
	Expires *time.Time `location:"header" locationName:"Expires" type:"timestamp"`

	// Gives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object.
	GrantFullControl *string `location:"header" locationName:"x-amz-grant-full-control" type:"string"`

	// Allows grantee to read the object data and its metadata.
	GrantRead *string `location:"header" locationName:"x-amz-grant-read" type:"string"`

	// Allows grantee to read the object ACL.
	GrantReadACP *string `location:"header" locationName:"x-amz-grant-read-acp" type:"string"`

	// Allows grantee to write the ACL for the applicable object.
	GrantWriteACP *string `location:"header" locationName:"x-amz-grant-write-acp" type:"string"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// A map of metadata to store with the object in S3.
	Metadata map[string]*string `location:"headers" locationName:"x-amz-meta-" type:"map"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`

	// Specifies the algorithm to use to when encrypting the object (e.g., AES256).
	SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"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
	// 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 `location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"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 the encryption
	// key was transmitted without error.
	SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`

	// 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
	SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string"`

	// The Server-side encryption algorithm used when storing this object in S3
	// (e.g., AES256, aws:kms).
	ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`

	// The type of storage to use for the object. Defaults to 'STANDARD'.
	StorageClass *string `location:"header" locationName:"x-amz-storage-class" type:"string" enum:"StorageClass"`

	// The tag-set for the object. The tag-set must be encoded as URL Query parameters
	Tagging *string `location:"header" locationName:"x-amz-tagging" type:"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.
	WebsiteRedirectLocation *string `location:"header" locationName:"x-amz-website-redirect-location" type:"string"`
	// contains filtered or unexported fields
}

func (CreateMultipartUploadInput) GoString added in v0.6.5 

func (s CreateMultipartUploadInput) GoString() string

GoString returns the string representation

func (*CreateMultipartUploadInput) SetACL added in v1.5.0 

func (s *CreateMultipartUploadInput) SetACL(v string) *CreateMultipartUploadInput

SetACL sets the ACL field's value.

func (*CreateMultipartUploadInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*CreateMultipartUploadInput) SetCacheControl added in v1.5.0 

func (s *CreateMultipartUploadInput) SetCacheControl(v string) *CreateMultipartUploadInput

SetCacheControl sets the CacheControl field's value.

func (*CreateMultipartUploadInput) SetContentDisposition added in v1.5.0 

func (s *CreateMultipartUploadInput) SetContentDisposition(v string) *CreateMultipartUploadInput

SetContentDisposition sets the ContentDisposition field's value.

func (*CreateMultipartUploadInput) SetContentEncoding added in v1.5.0 

func (s *CreateMultipartUploadInput) SetContentEncoding(v string) *CreateMultipartUploadInput

SetContentEncoding sets the ContentEncoding field's value.

func (*CreateMultipartUploadInput) SetContentLanguage added in v1.5.0 

func (s *CreateMultipartUploadInput) SetContentLanguage(v string) *CreateMultipartUploadInput

SetContentLanguage sets the ContentLanguage field's value.

func (*CreateMultipartUploadInput) SetContentType added in v1.5.0 

func (s *CreateMultipartUploadInput) SetContentType(v string) *CreateMultipartUploadInput

SetContentType sets the ContentType field's value.

func (*CreateMultipartUploadInput) SetExpires added in v1.5.0 

func (s *CreateMultipartUploadInput) SetExpires(v time.Time) *CreateMultipartUploadInput

SetExpires sets the Expires field's value.

func (*CreateMultipartUploadInput) SetGrantFullControl added in v1.5.0 

func (s *CreateMultipartUploadInput) SetGrantFullControl(v string) *CreateMultipartUploadInput

SetGrantFullControl sets the GrantFullControl field's value.

func (*CreateMultipartUploadInput) SetGrantRead added in v1.5.0 

func (s *CreateMultipartUploadInput) SetGrantRead(v string) *CreateMultipartUploadInput

SetGrantRead sets the GrantRead field's value.

func (*CreateMultipartUploadInput) SetGrantReadACP added in v1.5.0 

func (s *CreateMultipartUploadInput) SetGrantReadACP(v string) *CreateMultipartUploadInput

SetGrantReadACP sets the GrantReadACP field's value.

func (*CreateMultipartUploadInput) SetGrantWriteACP added in v1.5.0 

func (s *CreateMultipartUploadInput) SetGrantWriteACP(v string) *CreateMultipartUploadInput

SetGrantWriteACP sets the GrantWriteACP field's value.

func (*CreateMultipartUploadInput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*CreateMultipartUploadInput) SetMetadata added in v1.5.0 

func (s *CreateMultipartUploadInput) SetMetadata(v map[string]*string) *CreateMultipartUploadInput

SetMetadata sets the Metadata field's value.

func (*CreateMultipartUploadInput) SetRequestPayer added in v1.5.0 

func (s *CreateMultipartUploadInput) SetRequestPayer(v string) *CreateMultipartUploadInput

SetRequestPayer sets the RequestPayer field's value.

func (*CreateMultipartUploadInput) SetSSECustomerAlgorithm added in v1.5.0 

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

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.

func (*CreateMultipartUploadInput) SetSSECustomerKey added in v1.5.0 

func (s *CreateMultipartUploadInput) SetSSECustomerKey(v string) *CreateMultipartUploadInput

SetSSECustomerKey sets the SSECustomerKey field's value.

func (*CreateMultipartUploadInput) SetSSECustomerKeyMD5 added in v1.5.0 

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

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.

func (*CreateMultipartUploadInput) SetSSEKMSKeyId added in v1.5.0 

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

SetSSEKMSKeyId sets the SSEKMSKeyId field's value.

func (*CreateMultipartUploadInput) SetServerSideEncryption added in v1.5.0 

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

SetServerSideEncryption sets the ServerSideEncryption field's value.

func (*CreateMultipartUploadInput) SetStorageClass added in v1.5.0 

func (s *CreateMultipartUploadInput) SetStorageClass(v string) *CreateMultipartUploadInput

SetStorageClass sets the StorageClass field's value.

func (*CreateMultipartUploadInput) SetTagging added in v1.10.6 

func (s *CreateMultipartUploadInput) SetTagging(v string) *CreateMultipartUploadInput

SetTagging sets the Tagging field's value.

func (*CreateMultipartUploadInput) SetWebsiteRedirectLocation added in v1.5.0 

func (s *CreateMultipartUploadInput) SetWebsiteRedirectLocation(v string) *CreateMultipartUploadInput

SetWebsiteRedirectLocation sets the WebsiteRedirectLocation field's value.

func (CreateMultipartUploadInput) String added in v0.6.5 

func (s CreateMultipartUploadInput) String() string

String returns the string representation

func (*CreateMultipartUploadInput) Validate added in v1.1.21 

func (s *CreateMultipartUploadInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreateMultipartUploadOutput 

type CreateMultipartUploadOutput struct {

	// Date when multipart upload will become eligible for abort operation by lifecycle.
	AbortDate *time.Time `location:"header" locationName:"x-amz-abort-date" type:"timestamp"`

	// Id of the lifecycle rule that makes a multipart upload eligible for abort
	// operation.
	AbortRuleId *string `location:"header" locationName:"x-amz-abort-rule-id" type:"string"`

	// Name of the bucket to which the multipart upload was initiated.
	Bucket *string `locationName:"Bucket" type:"string"`

	// Object key for which the multipart upload was initiated.
	Key *string `min:"1" type:"string"`

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"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 `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 to provide round trip message integrity
	// verification of the customer-provided encryption key.
	SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`

	// If present, specifies the ID of the AWS Key Management Service (KMS) master
	// encryption key that was used for the object.
	SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string"`

	// The Server-side encryption algorithm used when storing this object in S3
	// (e.g., AES256, aws:kms).
	ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`

	// ID for the initiated multipart upload.
	UploadId *string `type:"string"`
	// contains filtered or unexported fields
}

func (CreateMultipartUploadOutput) GoString added in v0.6.5 

func (s CreateMultipartUploadOutput) GoString() string

GoString returns the string representation

func (*CreateMultipartUploadOutput) SetAbortDate added in v1.5.0 

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

SetAbortDate sets the AbortDate field's value.

func (*CreateMultipartUploadOutput) SetAbortRuleId added in v1.5.0 

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

SetAbortRuleId sets the AbortRuleId field's value.

func (*CreateMultipartUploadOutput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*CreateMultipartUploadOutput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*CreateMultipartUploadOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (*CreateMultipartUploadOutput) SetSSECustomerAlgorithm added in v1.5.0 

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

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.

func (*CreateMultipartUploadOutput) SetSSECustomerKeyMD5 added in v1.5.0 

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

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.

func (*CreateMultipartUploadOutput) SetSSEKMSKeyId added in v1.5.0 

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

SetSSEKMSKeyId sets the SSEKMSKeyId field's value.

func (*CreateMultipartUploadOutput) SetServerSideEncryption added in v1.5.0 

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

SetServerSideEncryption sets the ServerSideEncryption field's value.

func (*CreateMultipartUploadOutput) SetUploadId added in v1.5.0 

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

SetUploadId sets the UploadId field's value.

func (CreateMultipartUploadOutput) String added in v0.6.5 

func (s CreateMultipartUploadOutput) String() string

String returns the string representation

type Delete 

type Delete struct {

	// Objects is a required field
	Objects []*ObjectIdentifier `locationName:"Object" type:"list" flattened:"true" required:"true"`

	// Element to enable quiet mode for the request. When you add this element,
	// you must set its value to true.
	Quiet *bool `type:"boolean"`
	// contains filtered or unexported fields
}

func (Delete) GoString added in v0.6.5 

func (s Delete) GoString() string

GoString returns the string representation

func (*Delete) SetObjects added in v1.5.0 

func (s *Delete) SetObjects(v []*ObjectIdentifier) *Delete

SetObjects sets the Objects field's value.

func (*Delete) SetQuiet added in v1.5.0 

func (s *Delete) SetQuiet(v bool) *Delete

SetQuiet sets the Quiet field's value.

func (Delete) String added in v0.6.5 

func (s Delete) String() string

String returns the string representation

func (*Delete) Validate added in v1.1.21 

func (s *Delete) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteBucketAnalyticsConfigurationInput added in v1.5.11 

type DeleteBucketAnalyticsConfigurationInput struct {

	// The name of the bucket from which an analytics configuration is deleted.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// The identifier used to represent an analytics configuration.
	//
	// Id is a required field
	Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteBucketAnalyticsConfigurationInput) GoString added in v1.5.11 

func (s DeleteBucketAnalyticsConfigurationInput) GoString() string

GoString returns the string representation

func (*DeleteBucketAnalyticsConfigurationInput) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*DeleteBucketAnalyticsConfigurationInput) SetId added in v1.5.11 

func (s *DeleteBucketAnalyticsConfigurationInput) SetId(v string) *DeleteBucketAnalyticsConfigurationInput

SetId sets the Id field's value.

func (DeleteBucketAnalyticsConfigurationInput) String added in v1.5.11 

func (s DeleteBucketAnalyticsConfigurationInput) String() string

String returns the string representation

func (*DeleteBucketAnalyticsConfigurationInput) Validate added in v1.5.11 

func (s *DeleteBucketAnalyticsConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteBucketAnalyticsConfigurationOutput added in v1.5.11 

type DeleteBucketAnalyticsConfigurationOutput struct {
	// contains filtered or unexported fields
}

func (DeleteBucketAnalyticsConfigurationOutput) GoString added in v1.5.11 

func (s DeleteBucketAnalyticsConfigurationOutput) GoString() string

GoString returns the string representation

func (DeleteBucketAnalyticsConfigurationOutput) String added in v1.5.11 

func (s DeleteBucketAnalyticsConfigurationOutput) String() string

String returns the string representation

type DeleteBucketCorsInput added in v0.9.5 

type DeleteBucketCorsInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteBucketCorsInput) GoString added in v0.9.5 

func (s DeleteBucketCorsInput) GoString() string

GoString returns the string representation

func (*DeleteBucketCorsInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (DeleteBucketCorsInput) String added in v0.9.5 

func (s DeleteBucketCorsInput) String() string

String returns the string representation

func (*DeleteBucketCorsInput) Validate added in v1.1.21 

func (s *DeleteBucketCorsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteBucketCorsOutput added in v0.9.5 

type DeleteBucketCorsOutput struct {
	// contains filtered or unexported fields
}

func (DeleteBucketCorsOutput) GoString added in v0.9.5 

func (s DeleteBucketCorsOutput) GoString() string

GoString returns the string representation

func (DeleteBucketCorsOutput) String added in v0.9.5 

func (s DeleteBucketCorsOutput) String() string

String returns the string representation

type DeleteBucketEncryptionInput added in v1.12.24 

type DeleteBucketEncryptionInput struct {

	// The name of the bucket containing the server-side encryption configuration
	// to delete.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteBucketEncryptionInput) GoString added in v1.12.24 

func (s DeleteBucketEncryptionInput) GoString() string

GoString returns the string representation

func (*DeleteBucketEncryptionInput) SetBucket added in v1.12.24 

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

SetBucket sets the Bucket field's value.

func (DeleteBucketEncryptionInput) String added in v1.12.24 

func (s DeleteBucketEncryptionInput) String() string

String returns the string representation

func (*DeleteBucketEncryptionInput) Validate added in v1.12.24 

func (s *DeleteBucketEncryptionInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteBucketEncryptionOutput added in v1.12.24 

type DeleteBucketEncryptionOutput struct {
	// contains filtered or unexported fields
}

func (DeleteBucketEncryptionOutput) GoString added in v1.12.24 

func (s DeleteBucketEncryptionOutput) GoString() string

GoString returns the string representation

func (DeleteBucketEncryptionOutput) String added in v1.12.24 

func (s DeleteBucketEncryptionOutput) String() string

String returns the string representation

type DeleteBucketInput 

type DeleteBucketInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteBucketInput) GoString added in v0.6.5 

func (s DeleteBucketInput) GoString() string

GoString returns the string representation

func (*DeleteBucketInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (DeleteBucketInput) String added in v0.6.5 

func (s DeleteBucketInput) String() string

String returns the string representation

func (*DeleteBucketInput) Validate added in v1.1.21 

func (s *DeleteBucketInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteBucketInventoryConfigurationInput added in v1.5.11 

type DeleteBucketInventoryConfigurationInput struct {

	// The name of the bucket containing the inventory configuration to delete.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// The ID used to identify the inventory configuration.
	//
	// Id is a required field
	Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteBucketInventoryConfigurationInput) GoString added in v1.5.11 

func (s DeleteBucketInventoryConfigurationInput) GoString() string

GoString returns the string representation

func (*DeleteBucketInventoryConfigurationInput) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*DeleteBucketInventoryConfigurationInput) SetId added in v1.5.11 

func (s *DeleteBucketInventoryConfigurationInput) SetId(v string) *DeleteBucketInventoryConfigurationInput

SetId sets the Id field's value.

func (DeleteBucketInventoryConfigurationInput) String added in v1.5.11 

func (s DeleteBucketInventoryConfigurationInput) String() string

String returns the string representation

func (*DeleteBucketInventoryConfigurationInput) Validate added in v1.5.11 

func (s *DeleteBucketInventoryConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteBucketInventoryConfigurationOutput added in v1.5.11 

type DeleteBucketInventoryConfigurationOutput struct {
	// contains filtered or unexported fields
}

func (DeleteBucketInventoryConfigurationOutput) GoString added in v1.5.11 

func (s DeleteBucketInventoryConfigurationOutput) GoString() string

GoString returns the string representation

func (DeleteBucketInventoryConfigurationOutput) String added in v1.5.11 

func (s DeleteBucketInventoryConfigurationOutput) String() string

String returns the string representation

type DeleteBucketLifecycleInput 

type DeleteBucketLifecycleInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteBucketLifecycleInput) GoString added in v0.6.5 

func (s DeleteBucketLifecycleInput) GoString() string

GoString returns the string representation

func (*DeleteBucketLifecycleInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (DeleteBucketLifecycleInput) String added in v0.6.5 

func (s DeleteBucketLifecycleInput) String() string

String returns the string representation

func (*DeleteBucketLifecycleInput) Validate added in v1.1.21 

func (s *DeleteBucketLifecycleInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteBucketLifecycleOutput 

type DeleteBucketLifecycleOutput struct {
	// contains filtered or unexported fields
}

func (DeleteBucketLifecycleOutput) GoString added in v0.6.5 

func (s DeleteBucketLifecycleOutput) GoString() string

GoString returns the string representation

func (DeleteBucketLifecycleOutput) String added in v0.6.5 

func (s DeleteBucketLifecycleOutput) String() string

String returns the string representation

type DeleteBucketMetricsConfigurationInput added in v1.5.11 

type DeleteBucketMetricsConfigurationInput struct {

	// The name of the bucket containing the metrics configuration to delete.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// The ID used to identify the metrics configuration.
	//
	// Id is a required field
	Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteBucketMetricsConfigurationInput) GoString added in v1.5.11 

func (s DeleteBucketMetricsConfigurationInput) GoString() string

GoString returns the string representation

func (*DeleteBucketMetricsConfigurationInput) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*DeleteBucketMetricsConfigurationInput) SetId added in v1.5.11 

func (s *DeleteBucketMetricsConfigurationInput) SetId(v string) *DeleteBucketMetricsConfigurationInput

SetId sets the Id field's value.

func (DeleteBucketMetricsConfigurationInput) String added in v1.5.11 

func (s DeleteBucketMetricsConfigurationInput) String() string

String returns the string representation

func (*DeleteBucketMetricsConfigurationInput) Validate added in v1.5.11 

func (s *DeleteBucketMetricsConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteBucketMetricsConfigurationOutput added in v1.5.11 

type DeleteBucketMetricsConfigurationOutput struct {
	// contains filtered or unexported fields
}

func (DeleteBucketMetricsConfigurationOutput) GoString added in v1.5.11 

func (s DeleteBucketMetricsConfigurationOutput) GoString() string

GoString returns the string representation

func (DeleteBucketMetricsConfigurationOutput) String added in v1.5.11 

func (s DeleteBucketMetricsConfigurationOutput) String() string

String returns the string representation

type DeleteBucketOutput 

type DeleteBucketOutput struct {
	// contains filtered or unexported fields
}

func (DeleteBucketOutput) GoString added in v0.6.5 

func (s DeleteBucketOutput) GoString() string

GoString returns the string representation

func (DeleteBucketOutput) String added in v0.6.5 

func (s DeleteBucketOutput) String() string

String returns the string representation

type DeleteBucketPolicyInput 

type DeleteBucketPolicyInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteBucketPolicyInput) GoString added in v0.6.5 

func (s DeleteBucketPolicyInput) GoString() string

GoString returns the string representation

func (*DeleteBucketPolicyInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (DeleteBucketPolicyInput) String added in v0.6.5 

func (s DeleteBucketPolicyInput) String() string

String returns the string representation

func (*DeleteBucketPolicyInput) Validate added in v1.1.21 

func (s *DeleteBucketPolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteBucketPolicyOutput 

type DeleteBucketPolicyOutput struct {
	// contains filtered or unexported fields
}

func (DeleteBucketPolicyOutput) GoString added in v0.6.5 

func (s DeleteBucketPolicyOutput) GoString() string

GoString returns the string representation

func (DeleteBucketPolicyOutput) String added in v0.6.5 

func (s DeleteBucketPolicyOutput) String() string

String returns the string representation

type DeleteBucketReplicationInput 

type DeleteBucketReplicationInput struct {

	// Deletes the replication subresource associated with the specified bucket.
	//
	// There is usually some time lag before replication configuration deletion
	// is fully propagated to all the Amazon S3 systems.
	//
	// For more information, see Cross-Region Replication (CRR) ( https://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html)
	// in the Amazon S3 Developer Guide.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteBucketReplicationInput) GoString added in v0.6.5 

func (s DeleteBucketReplicationInput) GoString() string

GoString returns the string representation

func (*DeleteBucketReplicationInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (DeleteBucketReplicationInput) String added in v0.6.5 

func (s DeleteBucketReplicationInput) String() string

String returns the string representation

func (*DeleteBucketReplicationInput) Validate added in v1.1.21 

func (s *DeleteBucketReplicationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteBucketReplicationOutput 

type DeleteBucketReplicationOutput struct {
	// contains filtered or unexported fields
}

func (DeleteBucketReplicationOutput) GoString added in v0.6.5 

func (s DeleteBucketReplicationOutput) GoString() string

GoString returns the string representation

func (DeleteBucketReplicationOutput) String added in v0.6.5 

func (s DeleteBucketReplicationOutput) String() string

String returns the string representation

type DeleteBucketTaggingInput 

type DeleteBucketTaggingInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteBucketTaggingInput) GoString added in v0.6.5 

func (s DeleteBucketTaggingInput) GoString() string

GoString returns the string representation

func (*DeleteBucketTaggingInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (DeleteBucketTaggingInput) String added in v0.6.5 

func (s DeleteBucketTaggingInput) String() string

String returns the string representation

func (*DeleteBucketTaggingInput) Validate added in v1.1.21 

func (s *DeleteBucketTaggingInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteBucketTaggingOutput 

type DeleteBucketTaggingOutput struct {
	// contains filtered or unexported fields
}

func (DeleteBucketTaggingOutput) GoString added in v0.6.5 

func (s DeleteBucketTaggingOutput) GoString() string

GoString returns the string representation

func (DeleteBucketTaggingOutput) String added in v0.6.5 

func (s DeleteBucketTaggingOutput) String() string

String returns the string representation

type DeleteBucketWebsiteInput 

type DeleteBucketWebsiteInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteBucketWebsiteInput) GoString added in v0.6.5 

func (s DeleteBucketWebsiteInput) GoString() string

GoString returns the string representation

func (*DeleteBucketWebsiteInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (DeleteBucketWebsiteInput) String added in v0.6.5 

func (s DeleteBucketWebsiteInput) String() string

String returns the string representation

func (*DeleteBucketWebsiteInput) Validate added in v1.1.21 

func (s *DeleteBucketWebsiteInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteBucketWebsiteOutput 

type DeleteBucketWebsiteOutput struct {
	// contains filtered or unexported fields
}

func (DeleteBucketWebsiteOutput) GoString added in v0.6.5 

func (s DeleteBucketWebsiteOutput) GoString() string

GoString returns the string representation

func (DeleteBucketWebsiteOutput) String added in v0.6.5 

func (s DeleteBucketWebsiteOutput) String() string

String returns the string representation

type DeleteMarkerEntry 

type DeleteMarkerEntry struct {

	// Specifies whether the object is (true) or is not (false) the latest version
	// of an object.
	IsLatest *bool `type:"boolean"`

	// The object key.
	Key *string `min:"1" type:"string"`

	// Date and time the object was last modified.
	LastModified *time.Time `type:"timestamp"`

	Owner *Owner `type:"structure"`

	// Version ID of an object.
	VersionId *string `type:"string"`
	// contains filtered or unexported fields
}

func (DeleteMarkerEntry) GoString added in v0.6.5 

func (s DeleteMarkerEntry) GoString() string

GoString returns the string representation

func (*DeleteMarkerEntry) SetIsLatest added in v1.5.0 

func (s *DeleteMarkerEntry) SetIsLatest(v bool) *DeleteMarkerEntry

SetIsLatest sets the IsLatest field's value.

func (*DeleteMarkerEntry) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*DeleteMarkerEntry) SetLastModified added in v1.5.0 

func (s *DeleteMarkerEntry) SetLastModified(v time.Time) *DeleteMarkerEntry

SetLastModified sets the LastModified field's value.

func (*DeleteMarkerEntry) SetOwner added in v1.5.0 

func (s *DeleteMarkerEntry) SetOwner(v *Owner) *DeleteMarkerEntry

SetOwner sets the Owner field's value.

func (*DeleteMarkerEntry) SetVersionId added in v1.5.0 

func (s *DeleteMarkerEntry) SetVersionId(v string) *DeleteMarkerEntry

SetVersionId sets the VersionId field's value.

func (DeleteMarkerEntry) String added in v0.6.5 

func (s DeleteMarkerEntry) String() string

String returns the string representation

type DeleteMarkerReplication added in v1.15.38 

type DeleteMarkerReplication struct {

	// The status of the delete marker replication.
	//
	// In the current implementation, Amazon S3 does not replicate the delete markers.
	// Therefore, the status must be Disabled.
	Status *string `type:"string" enum:"DeleteMarkerReplicationStatus"`
	// contains filtered or unexported fields
}

Specifies whether Amazon S3 should replicate delete makers.

func (DeleteMarkerReplication) GoString added in v1.15.38 

func (s DeleteMarkerReplication) GoString() string

GoString returns the string representation

func (*DeleteMarkerReplication) SetStatus added in v1.15.38 

func (s *DeleteMarkerReplication) SetStatus(v string) *DeleteMarkerReplication

SetStatus sets the Status field's value.

func (DeleteMarkerReplication) String added in v1.15.38 

func (s DeleteMarkerReplication) String() string

String returns the string representation

type DeleteObjectInput 

type DeleteObjectInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// The concatenation of the authentication device's serial number, a space,
	// and the value that is displayed on your authentication device.
	MFA *string `location:"header" locationName:"x-amz-mfa" type:"string"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`

	// VersionId used to reference a specific version of the object.
	VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
	// contains filtered or unexported fields
}

func (DeleteObjectInput) GoString added in v0.6.5 

func (s DeleteObjectInput) GoString() string

GoString returns the string representation

func (*DeleteObjectInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*DeleteObjectInput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*DeleteObjectInput) SetMFA added in v1.5.0 

func (s *DeleteObjectInput) SetMFA(v string) *DeleteObjectInput

SetMFA sets the MFA field's value.

func (*DeleteObjectInput) SetRequestPayer added in v1.5.0 

func (s *DeleteObjectInput) SetRequestPayer(v string) *DeleteObjectInput

SetRequestPayer sets the RequestPayer field's value.

func (*DeleteObjectInput) SetVersionId added in v1.5.0 

func (s *DeleteObjectInput) SetVersionId(v string) *DeleteObjectInput

SetVersionId sets the VersionId field's value.

func (DeleteObjectInput) String added in v0.6.5 

func (s DeleteObjectInput) String() string

String returns the string representation

func (*DeleteObjectInput) Validate added in v1.1.21 

func (s *DeleteObjectInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteObjectOutput 

type DeleteObjectOutput struct {

	// Specifies whether the versioned object that was permanently deleted was (true)
	// or was not (false) a delete marker.
	DeleteMarker *bool `location:"header" locationName:"x-amz-delete-marker" type:"boolean"`

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`

	// Returns the version ID of the delete marker created as a result of the DELETE
	// operation.
	VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
	// contains filtered or unexported fields
}

func (DeleteObjectOutput) GoString added in v0.6.5 

func (s DeleteObjectOutput) GoString() string

GoString returns the string representation

func (*DeleteObjectOutput) SetDeleteMarker added in v1.5.0 

func (s *DeleteObjectOutput) SetDeleteMarker(v bool) *DeleteObjectOutput

SetDeleteMarker sets the DeleteMarker field's value.

func (*DeleteObjectOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (*DeleteObjectOutput) SetVersionId added in v1.5.0 

func (s *DeleteObjectOutput) SetVersionId(v string) *DeleteObjectOutput

SetVersionId sets the VersionId field's value.

func (DeleteObjectOutput) String added in v0.6.5 

func (s DeleteObjectOutput) String() string

String returns the string representation

type DeleteObjectTaggingInput added in v1.5.11 

type DeleteObjectTaggingInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// The versionId of the object that the tag-set will be removed from.
	VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
	// contains filtered or unexported fields
}

func (DeleteObjectTaggingInput) GoString added in v1.5.11 

func (s DeleteObjectTaggingInput) GoString() string

GoString returns the string representation

func (*DeleteObjectTaggingInput) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*DeleteObjectTaggingInput) SetKey added in v1.5.11 

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

SetKey sets the Key field's value.

func (*DeleteObjectTaggingInput) SetVersionId added in v1.5.11 

func (s *DeleteObjectTaggingInput) SetVersionId(v string) *DeleteObjectTaggingInput

SetVersionId sets the VersionId field's value.

func (DeleteObjectTaggingInput) String added in v1.5.11 

func (s DeleteObjectTaggingInput) String() string

String returns the string representation

func (*DeleteObjectTaggingInput) Validate added in v1.5.11 

func (s *DeleteObjectTaggingInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteObjectTaggingOutput added in v1.5.11 

type DeleteObjectTaggingOutput struct {

	// The versionId of the object the tag-set was removed from.
	VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
	// contains filtered or unexported fields
}

func (DeleteObjectTaggingOutput) GoString added in v1.5.11 

func (s DeleteObjectTaggingOutput) GoString() string

GoString returns the string representation

func (*DeleteObjectTaggingOutput) SetVersionId added in v1.5.11 

func (s *DeleteObjectTaggingOutput) SetVersionId(v string) *DeleteObjectTaggingOutput

SetVersionId sets the VersionId field's value.

func (DeleteObjectTaggingOutput) String added in v1.5.11 

func (s DeleteObjectTaggingOutput) String() string

String returns the string representation

type DeleteObjectsInput 

type DeleteObjectsInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Delete is a required field
	Delete *Delete `locationName:"Delete" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`

	// The concatenation of the authentication device's serial number, a space,
	// and the value that is displayed on your authentication device.
	MFA *string `location:"header" locationName:"x-amz-mfa" type:"string"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
	// contains filtered or unexported fields
}

func (DeleteObjectsInput) GoString added in v0.6.5 

func (s DeleteObjectsInput) GoString() string

GoString returns the string representation

func (*DeleteObjectsInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*DeleteObjectsInput) SetDelete added in v1.5.0 

func (s *DeleteObjectsInput) SetDelete(v *Delete) *DeleteObjectsInput

SetDelete sets the Delete field's value.

func (*DeleteObjectsInput) SetMFA added in v1.5.0 

func (s *DeleteObjectsInput) SetMFA(v string) *DeleteObjectsInput

SetMFA sets the MFA field's value.

func (*DeleteObjectsInput) SetRequestPayer added in v1.5.0 

func (s *DeleteObjectsInput) SetRequestPayer(v string) *DeleteObjectsInput

SetRequestPayer sets the RequestPayer field's value.

func (DeleteObjectsInput) String added in v0.6.5 

func (s DeleteObjectsInput) String() string

String returns the string representation

func (*DeleteObjectsInput) Validate added in v1.1.21 

func (s *DeleteObjectsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteObjectsOutput 

type DeleteObjectsOutput struct {
	Deleted []*DeletedObject `type:"list" flattened:"true"`

	Errors []*Error `locationName:"Error" type:"list" flattened:"true"`

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
	// contains filtered or unexported fields
}

func (DeleteObjectsOutput) GoString added in v0.6.5 

func (s DeleteObjectsOutput) GoString() string

GoString returns the string representation

func (*DeleteObjectsOutput) SetDeleted added in v1.5.0 

func (s *DeleteObjectsOutput) SetDeleted(v []*DeletedObject) *DeleteObjectsOutput

SetDeleted sets the Deleted field's value.

func (*DeleteObjectsOutput) SetErrors added in v1.5.0 

func (s *DeleteObjectsOutput) SetErrors(v []*Error) *DeleteObjectsOutput

SetErrors sets the Errors field's value.

func (*DeleteObjectsOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (DeleteObjectsOutput) String added in v0.6.5 

func (s DeleteObjectsOutput) String() string

String returns the string representation

type DeletedObject 

type DeletedObject struct {
	DeleteMarker *bool `type:"boolean"`

	DeleteMarkerVersionId *string `type:"string"`

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

	VersionId *string `type:"string"`
	// contains filtered or unexported fields
}

func (DeletedObject) GoString added in v0.6.5 

func (s DeletedObject) GoString() string

GoString returns the string representation

func (*DeletedObject) SetDeleteMarker added in v1.5.0 

func (s *DeletedObject) SetDeleteMarker(v bool) *DeletedObject

SetDeleteMarker sets the DeleteMarker field's value.

func (*DeletedObject) SetDeleteMarkerVersionId added in v1.5.0 

func (s *DeletedObject) SetDeleteMarkerVersionId(v string) *DeletedObject

SetDeleteMarkerVersionId sets the DeleteMarkerVersionId field's value.

func (*DeletedObject) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*DeletedObject) SetVersionId added in v1.5.0 

func (s *DeletedObject) SetVersionId(v string) *DeletedObject

SetVersionId sets the VersionId field's value.

func (DeletedObject) String added in v0.6.5 

func (s DeletedObject) String() string

String returns the string representation

type Destination 

type Destination struct {

	// Container for information regarding the access control for replicas.
	//
	// Use only in a cross-account scenario, where source and destination bucket
	// owners are not the same, when you want to change replica ownership to the
	// AWS account that owns the destination bucket. If you don't add this element
	// to the replication configuration, the replicas are owned by same AWS account
	// that owns the source object.
	AccessControlTranslation *AccessControlTranslation `type:"structure"`

	// Account ID of the destination bucket. Currently Amazon S3 verifies this value
	// only if Access Control Translation is enabled.
	//
	// In a cross-account scenario, if you tell Amazon S3 to change replica ownership
	// to the AWS account that owns the destination bucket by adding the AccessControlTranslation
	// element, this is the account ID of the destination bucket owner.
	Account *string `type:"string"`

	// Amazon resource name (ARN) of the bucket where you want Amazon S3 to store
	// replicas of the object identified by the rule.
	//
	// If you have multiple rules in your replication configuration, all rules must
	// specify the same bucket as the destination. A replication configuration can
	// replicate objects only to one destination bucket.
	//
	// Bucket is a required field
	Bucket *string `type:"string" required:"true"`

	// Container that provides encryption-related information. You must specify
	// this element if the SourceSelectionCriteria is specified.
	EncryptionConfiguration *EncryptionConfiguration `type:"structure"`

	// The class of storage used to store the object.
	StorageClass *string `type:"string" enum:"StorageClass"`
	// contains filtered or unexported fields
}

Container for replication destination information.

func (Destination) GoString added in v0.6.5 

func (s Destination) GoString() string

GoString returns the string representation

func (*Destination) SetAccessControlTranslation added in v1.12.24 

func (s *Destination) SetAccessControlTranslation(v *AccessControlTranslation) *Destination

SetAccessControlTranslation sets the AccessControlTranslation field's value.

func (*Destination) SetAccount added in v1.12.24 

func (s *Destination) SetAccount(v string) *Destination

SetAccount sets the Account field's value.

func (*Destination) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*Destination) SetEncryptionConfiguration added in v1.12.24 

func (s *Destination) SetEncryptionConfiguration(v *EncryptionConfiguration) *Destination

SetEncryptionConfiguration sets the EncryptionConfiguration field's value.

func (*Destination) SetStorageClass added in v1.5.0 

func (s *Destination) SetStorageClass(v string) *Destination

SetStorageClass sets the StorageClass field's value.

func (Destination) String added in v0.6.5 

func (s Destination) String() string

String returns the string representation

func (*Destination) Validate added in v1.1.21 

func (s *Destination) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type Encryption added in v1.12.36 

type Encryption struct {

	// The server-side encryption algorithm used when storing job results in Amazon
	// S3 (e.g., AES256, aws:kms).
	//
	// EncryptionType is a required field
	EncryptionType *string `type:"string" required:"true" enum:"ServerSideEncryption"`

	// If the encryption type is aws:kms, this optional value can be used to specify
	// the encryption context for the restore results.
	KMSContext *string `type:"string"`

	// If the encryption type is aws:kms, this optional value specifies the AWS
	// KMS key ID to use for encryption of job results.
	KMSKeyId *string `type:"string"`
	// contains filtered or unexported fields
}

Describes the server-side encryption that will be applied to the restore results.

func (Encryption) GoString added in v1.12.36 

func (s Encryption) GoString() string

GoString returns the string representation

func (*Encryption) SetEncryptionType added in v1.12.36 

func (s *Encryption) SetEncryptionType(v string) *Encryption

SetEncryptionType sets the EncryptionType field's value.

func (*Encryption) SetKMSContext added in v1.12.36 

func (s *Encryption) SetKMSContext(v string) *Encryption

SetKMSContext sets the KMSContext field's value.

func (*Encryption) SetKMSKeyId added in v1.12.36 

func (s *Encryption) SetKMSKeyId(v string) *Encryption

SetKMSKeyId sets the KMSKeyId field's value.

func (Encryption) String added in v1.12.36 

func (s Encryption) String() string

String returns the string representation

func (*Encryption) Validate added in v1.12.36 

func (s *Encryption) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type EncryptionConfiguration added in v1.12.24 

type EncryptionConfiguration struct {

	// The ID of the AWS KMS key for the region where the destination bucket resides.
	// Amazon S3 uses this key to encrypt the replica object.
	ReplicaKmsKeyID *string `type:"string"`
	// contains filtered or unexported fields
}

Container for information regarding encryption based configuration for replicas.

func (EncryptionConfiguration) GoString added in v1.12.24 

func (s EncryptionConfiguration) GoString() string

GoString returns the string representation

func (*EncryptionConfiguration) SetReplicaKmsKeyID added in v1.12.24 

func (s *EncryptionConfiguration) SetReplicaKmsKeyID(v string) *EncryptionConfiguration

SetReplicaKmsKeyID sets the ReplicaKmsKeyID field's value.

func (EncryptionConfiguration) String added in v1.12.24 

func (s EncryptionConfiguration) String() string

String returns the string representation

type EndEvent added in v1.14.0 

type EndEvent struct {
	// contains filtered or unexported fields
}

func (EndEvent) GoString added in v1.14.0 

func (s EndEvent) GoString() string

GoString returns the string representation

func (EndEvent) String added in v1.14.0 

func (s EndEvent) String() string

String returns the string representation

func (*EndEvent) UnmarshalEvent added in v1.14.0 

func (s *EndEvent) UnmarshalEvent(
	payloadUnmarshaler protocol.PayloadUnmarshaler,
	msg eventstream.Message,
) error

UnmarshalEvent unmarshals the EventStream Message into the EndEvent value. This method is only used internally within the SDK's EventStream handling.

type Error 

type Error struct {
	Code *string `type:"string"`

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

	Message *string `type:"string"`

	VersionId *string `type:"string"`
	// contains filtered or unexported fields
}

func (Error) GoString added in v0.6.5 

func (s Error) GoString() string

GoString returns the string representation

func (*Error) SetCode added in v1.5.0 

func (s *Error) SetCode(v string) *Error

SetCode sets the Code field's value.

func (*Error) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*Error) SetMessage added in v1.5.0 

func (s *Error) SetMessage(v string) *Error

SetMessage sets the Message field's value.

func (*Error) SetVersionId added in v1.5.0 

func (s *Error) SetVersionId(v string) *Error

SetVersionId sets the VersionId field's value.

func (Error) String added in v0.6.5 

func (s Error) String() string

String returns the string representation

type ErrorDocument 

type ErrorDocument struct {

	// The object key name to use when a 4XX class error occurs.
	//
	// Key is a required field
	Key *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (ErrorDocument) GoString added in v0.6.5 

func (s ErrorDocument) GoString() string

GoString returns the string representation

func (*ErrorDocument) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (ErrorDocument) String added in v0.6.5 

func (s ErrorDocument) String() string

String returns the string representation

func (*ErrorDocument) Validate added in v1.1.21 

func (s *ErrorDocument) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type FilterRule added in v0.9.5 

type FilterRule struct {

	// Object key name prefix or suffix identifying one or more objects to which
	// the filtering rule applies. Maximum prefix length can be up to 1,024 characters.
	// Overlapping prefixes and suffixes are not supported. For more information,
	// go to Configuring Event Notifications (http://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html)
	// in the Amazon Simple Storage Service Developer Guide.
	Name *string `type:"string" enum:"FilterRuleName"`

	Value *string `type:"string"`
	// contains filtered or unexported fields
}

Container for key value pair that defines the criteria for the filter rule.

func (FilterRule) GoString added in v0.9.5 

func (s FilterRule) GoString() string

GoString returns the string representation

func (*FilterRule) SetName added in v1.5.0 

func (s *FilterRule) SetName(v string) *FilterRule

SetName sets the Name field's value.

func (*FilterRule) SetValue added in v1.5.0 

func (s *FilterRule) SetValue(v string) *FilterRule

SetValue sets the Value field's value.

func (FilterRule) String added in v0.9.5 

func (s FilterRule) String() string

String returns the string representation

type GetBucketAccelerateConfigurationInput added in v1.1.19 

type GetBucketAccelerateConfigurationInput struct {

	// Name of the bucket for which the accelerate configuration is retrieved.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketAccelerateConfigurationInput) GoString added in v1.1.19 

func (s GetBucketAccelerateConfigurationInput) GoString() string

GoString returns the string representation

func (*GetBucketAccelerateConfigurationInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (GetBucketAccelerateConfigurationInput) String added in v1.1.19 

func (s GetBucketAccelerateConfigurationInput) String() string

String returns the string representation

func (*GetBucketAccelerateConfigurationInput) Validate added in v1.1.21 

func (s *GetBucketAccelerateConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketAccelerateConfigurationOutput added in v1.1.19 

type GetBucketAccelerateConfigurationOutput struct {

	// The accelerate configuration of the bucket.
	Status *string `type:"string" enum:"BucketAccelerateStatus"`
	// contains filtered or unexported fields
}

func (GetBucketAccelerateConfigurationOutput) GoString added in v1.1.19 

func (s GetBucketAccelerateConfigurationOutput) GoString() string

GoString returns the string representation

func (*GetBucketAccelerateConfigurationOutput) SetStatus added in v1.5.0 

func (s *GetBucketAccelerateConfigurationOutput) SetStatus(v string) *GetBucketAccelerateConfigurationOutput

SetStatus sets the Status field's value.

func (GetBucketAccelerateConfigurationOutput) String added in v1.1.19 

func (s GetBucketAccelerateConfigurationOutput) String() string

String returns the string representation

type GetBucketAclInput added in v0.9.5 

type GetBucketAclInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketAclInput) GoString added in v0.9.5 

func (s GetBucketAclInput) GoString() string

GoString returns the string representation

func (*GetBucketAclInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (GetBucketAclInput) String added in v0.9.5 

func (s GetBucketAclInput) String() string

String returns the string representation

func (*GetBucketAclInput) Validate added in v1.1.21 

func (s *GetBucketAclInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketAclOutput added in v0.9.5 

type GetBucketAclOutput struct {

	// A list of grants.
	Grants []*Grant `locationName:"AccessControlList" locationNameList:"Grant" type:"list"`

	Owner *Owner `type:"structure"`
	// contains filtered or unexported fields
}

func (GetBucketAclOutput) GoString added in v0.9.5 

func (s GetBucketAclOutput) GoString() string

GoString returns the string representation

func (*GetBucketAclOutput) SetGrants added in v1.5.0 

func (s *GetBucketAclOutput) SetGrants(v []*Grant) *GetBucketAclOutput

SetGrants sets the Grants field's value.

func (*GetBucketAclOutput) SetOwner added in v1.5.0 

func (s *GetBucketAclOutput) SetOwner(v *Owner) *GetBucketAclOutput

SetOwner sets the Owner field's value.

func (GetBucketAclOutput) String added in v0.9.5 

func (s GetBucketAclOutput) String() string

String returns the string representation

type GetBucketAnalyticsConfigurationInput added in v1.5.11 

type GetBucketAnalyticsConfigurationInput struct {

	// The name of the bucket from which an analytics configuration is retrieved.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// The identifier used to represent an analytics configuration.
	//
	// Id is a required field
	Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketAnalyticsConfigurationInput) GoString added in v1.5.11 

func (s GetBucketAnalyticsConfigurationInput) GoString() string

GoString returns the string representation

func (*GetBucketAnalyticsConfigurationInput) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*GetBucketAnalyticsConfigurationInput) SetId added in v1.5.11 

func (s *GetBucketAnalyticsConfigurationInput) SetId(v string) *GetBucketAnalyticsConfigurationInput

SetId sets the Id field's value.

func (GetBucketAnalyticsConfigurationInput) String added in v1.5.11 

func (s GetBucketAnalyticsConfigurationInput) String() string

String returns the string representation

func (*GetBucketAnalyticsConfigurationInput) Validate added in v1.5.11 

func (s *GetBucketAnalyticsConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketAnalyticsConfigurationOutput added in v1.5.11 

type GetBucketAnalyticsConfigurationOutput struct {

	// The configuration and any analyses for the analytics filter.
	AnalyticsConfiguration *AnalyticsConfiguration `type:"structure"`
	// contains filtered or unexported fields
}

func (GetBucketAnalyticsConfigurationOutput) GoString added in v1.5.11 

func (s GetBucketAnalyticsConfigurationOutput) GoString() string

GoString returns the string representation

func (*GetBucketAnalyticsConfigurationOutput) SetAnalyticsConfiguration added in v1.5.11 

func (s *GetBucketAnalyticsConfigurationOutput) SetAnalyticsConfiguration(v *AnalyticsConfiguration) *GetBucketAnalyticsConfigurationOutput

SetAnalyticsConfiguration sets the AnalyticsConfiguration field's value.

func (GetBucketAnalyticsConfigurationOutput) String added in v1.5.11 

func (s GetBucketAnalyticsConfigurationOutput) String() string

String returns the string representation

type GetBucketCorsInput added in v0.9.5 

type GetBucketCorsInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketCorsInput) GoString added in v0.9.5 

func (s GetBucketCorsInput) GoString() string

GoString returns the string representation

func (*GetBucketCorsInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (GetBucketCorsInput) String added in v0.9.5 

func (s GetBucketCorsInput) String() string

String returns the string representation

func (*GetBucketCorsInput) Validate added in v1.1.21 

func (s *GetBucketCorsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketCorsOutput added in v0.9.5 

type GetBucketCorsOutput struct {
	CORSRules []*CORSRule `locationName:"CORSRule" type:"list" flattened:"true"`
	// contains filtered or unexported fields
}

func (GetBucketCorsOutput) GoString added in v0.9.5 

func (s GetBucketCorsOutput) GoString() string

GoString returns the string representation

func (*GetBucketCorsOutput) SetCORSRules added in v1.5.0 

func (s *GetBucketCorsOutput) SetCORSRules(v []*CORSRule) *GetBucketCorsOutput

SetCORSRules sets the CORSRules field's value.

func (GetBucketCorsOutput) String added in v0.9.5 

func (s GetBucketCorsOutput) String() string

String returns the string representation

type GetBucketEncryptionInput added in v1.12.24 

type GetBucketEncryptionInput struct {

	// The name of the bucket from which the server-side encryption configuration
	// is retrieved.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketEncryptionInput) GoString added in v1.12.24 

func (s GetBucketEncryptionInput) GoString() string

GoString returns the string representation

func (*GetBucketEncryptionInput) SetBucket added in v1.12.24 

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

SetBucket sets the Bucket field's value.

func (GetBucketEncryptionInput) String added in v1.12.24 

func (s GetBucketEncryptionInput) String() string

String returns the string representation

func (*GetBucketEncryptionInput) Validate added in v1.12.24 

func (s *GetBucketEncryptionInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketEncryptionOutput added in v1.12.24 

type GetBucketEncryptionOutput struct {

	// Container for server-side encryption configuration rules. Currently S3 supports
	// one rule only.
	ServerSideEncryptionConfiguration *ServerSideEncryptionConfiguration `type:"structure"`
	// contains filtered or unexported fields
}

func (GetBucketEncryptionOutput) GoString added in v1.12.24 

func (s GetBucketEncryptionOutput) GoString() string

GoString returns the string representation

func (*GetBucketEncryptionOutput) SetServerSideEncryptionConfiguration added in v1.12.24 

func (s *GetBucketEncryptionOutput) SetServerSideEncryptionConfiguration(v *ServerSideEncryptionConfiguration) *GetBucketEncryptionOutput

SetServerSideEncryptionConfiguration sets the ServerSideEncryptionConfiguration field's value.

func (GetBucketEncryptionOutput) String added in v1.12.24 

func (s GetBucketEncryptionOutput) String() string

String returns the string representation

type GetBucketInventoryConfigurationInput added in v1.5.11 

type GetBucketInventoryConfigurationInput struct {

	// The name of the bucket containing the inventory configuration to retrieve.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// The ID used to identify the inventory configuration.
	//
	// Id is a required field
	Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketInventoryConfigurationInput) GoString added in v1.5.11 

func (s GetBucketInventoryConfigurationInput) GoString() string

GoString returns the string representation

func (*GetBucketInventoryConfigurationInput) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*GetBucketInventoryConfigurationInput) SetId added in v1.5.11 

func (s *GetBucketInventoryConfigurationInput) SetId(v string) *GetBucketInventoryConfigurationInput

SetId sets the Id field's value.

func (GetBucketInventoryConfigurationInput) String added in v1.5.11 

func (s GetBucketInventoryConfigurationInput) String() string

String returns the string representation

func (*GetBucketInventoryConfigurationInput) Validate added in v1.5.11 

func (s *GetBucketInventoryConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketInventoryConfigurationOutput added in v1.5.11 

type GetBucketInventoryConfigurationOutput struct {

	// Specifies the inventory configuration.
	InventoryConfiguration *InventoryConfiguration `type:"structure"`
	// contains filtered or unexported fields
}

func (GetBucketInventoryConfigurationOutput) GoString added in v1.5.11 

func (s GetBucketInventoryConfigurationOutput) GoString() string

GoString returns the string representation

func (*GetBucketInventoryConfigurationOutput) SetInventoryConfiguration added in v1.5.11 

func (s *GetBucketInventoryConfigurationOutput) SetInventoryConfiguration(v *InventoryConfiguration) *GetBucketInventoryConfigurationOutput

SetInventoryConfiguration sets the InventoryConfiguration field's value.

func (GetBucketInventoryConfigurationOutput) String added in v1.5.11 

func (s GetBucketInventoryConfigurationOutput) String() string

String returns the string representation

type GetBucketLifecycleConfigurationInput added in v0.9.8 

type GetBucketLifecycleConfigurationInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketLifecycleConfigurationInput) GoString added in v0.9.8 

func (s GetBucketLifecycleConfigurationInput) GoString() string

GoString returns the string representation

func (*GetBucketLifecycleConfigurationInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (GetBucketLifecycleConfigurationInput) String added in v0.9.8 

func (s GetBucketLifecycleConfigurationInput) String() string

String returns the string representation

func (*GetBucketLifecycleConfigurationInput) Validate added in v1.1.21 

func (s *GetBucketLifecycleConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketLifecycleConfigurationOutput added in v0.9.8 

type GetBucketLifecycleConfigurationOutput struct {
	Rules []*LifecycleRule `locationName:"Rule" type:"list" flattened:"true"`
	// contains filtered or unexported fields
}

func (GetBucketLifecycleConfigurationOutput) GoString added in v0.9.8 

func (s GetBucketLifecycleConfigurationOutput) GoString() string

GoString returns the string representation

func (*GetBucketLifecycleConfigurationOutput) SetRules added in v1.5.0 

func (s *GetBucketLifecycleConfigurationOutput) SetRules(v []*LifecycleRule) *GetBucketLifecycleConfigurationOutput

SetRules sets the Rules field's value.

func (GetBucketLifecycleConfigurationOutput) String added in v0.9.8 

func (s GetBucketLifecycleConfigurationOutput) String() string

String returns the string representation

type GetBucketLifecycleInput 

type GetBucketLifecycleInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketLifecycleInput) GoString added in v0.6.5 

func (s GetBucketLifecycleInput) GoString() string

GoString returns the string representation

func (*GetBucketLifecycleInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (GetBucketLifecycleInput) String added in v0.6.5 

func (s GetBucketLifecycleInput) String() string

String returns the string representation

func (*GetBucketLifecycleInput) Validate added in v1.1.21 

func (s *GetBucketLifecycleInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketLifecycleOutput 

type GetBucketLifecycleOutput struct {
	Rules []*Rule `locationName:"Rule" type:"list" flattened:"true"`
	// contains filtered or unexported fields
}

func (GetBucketLifecycleOutput) GoString added in v0.6.5 

func (s GetBucketLifecycleOutput) GoString() string

GoString returns the string representation

func (*GetBucketLifecycleOutput) SetRules added in v1.5.0 

func (s *GetBucketLifecycleOutput) SetRules(v []*Rule) *GetBucketLifecycleOutput

SetRules sets the Rules field's value.

func (GetBucketLifecycleOutput) String added in v0.6.5 

func (s GetBucketLifecycleOutput) String() string

String returns the string representation

type GetBucketLocationInput 

type GetBucketLocationInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketLocationInput) GoString added in v0.6.5 

func (s GetBucketLocationInput) GoString() string

GoString returns the string representation

func (*GetBucketLocationInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (GetBucketLocationInput) String added in v0.6.5 

func (s GetBucketLocationInput) String() string

String returns the string representation

func (*GetBucketLocationInput) Validate added in v1.1.21 

func (s *GetBucketLocationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketLocationOutput 

type GetBucketLocationOutput struct {
	LocationConstraint *string `type:"string" enum:"BucketLocationConstraint"`
	// contains filtered or unexported fields
}

func (GetBucketLocationOutput) GoString added in v0.6.5 

func (s GetBucketLocationOutput) GoString() string

GoString returns the string representation

func (*GetBucketLocationOutput) SetLocationConstraint added in v1.5.0 

func (s *GetBucketLocationOutput) SetLocationConstraint(v string) *GetBucketLocationOutput

SetLocationConstraint sets the LocationConstraint field's value.

func (GetBucketLocationOutput) String added in v0.6.5 

func (s GetBucketLocationOutput) String() string

String returns the string representation

type GetBucketLoggingInput 

type GetBucketLoggingInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketLoggingInput) GoString added in v0.6.5 

func (s GetBucketLoggingInput) GoString() string

GoString returns the string representation

func (*GetBucketLoggingInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (GetBucketLoggingInput) String added in v0.6.5 

func (s GetBucketLoggingInput) String() string

String returns the string representation

func (*GetBucketLoggingInput) Validate added in v1.1.21 

func (s *GetBucketLoggingInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketLoggingOutput 

type GetBucketLoggingOutput struct {

	// Container for logging information. Presence of this element indicates that
	// logging is enabled. Parameters TargetBucket and TargetPrefix are required
	// in this case.
	LoggingEnabled *LoggingEnabled `type:"structure"`
	// contains filtered or unexported fields
}

func (GetBucketLoggingOutput) GoString added in v0.6.5 

func (s GetBucketLoggingOutput) GoString() string

GoString returns the string representation

func (*GetBucketLoggingOutput) SetLoggingEnabled added in v1.5.0 

func (s *GetBucketLoggingOutput) SetLoggingEnabled(v *LoggingEnabled) *GetBucketLoggingOutput

SetLoggingEnabled sets the LoggingEnabled field's value.

func (GetBucketLoggingOutput) String added in v0.6.5 

func (s GetBucketLoggingOutput) String() string

String returns the string representation

type GetBucketMetricsConfigurationInput added in v1.5.11 

type GetBucketMetricsConfigurationInput struct {

	// The name of the bucket containing the metrics configuration to retrieve.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// The ID used to identify the metrics configuration.
	//
	// Id is a required field
	Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketMetricsConfigurationInput) GoString added in v1.5.11 

func (s GetBucketMetricsConfigurationInput) GoString() string

GoString returns the string representation

func (*GetBucketMetricsConfigurationInput) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*GetBucketMetricsConfigurationInput) SetId added in v1.5.11 

func (s *GetBucketMetricsConfigurationInput) SetId(v string) *GetBucketMetricsConfigurationInput

SetId sets the Id field's value.

func (GetBucketMetricsConfigurationInput) String added in v1.5.11 

func (s GetBucketMetricsConfigurationInput) String() string

String returns the string representation

func (*GetBucketMetricsConfigurationInput) Validate added in v1.5.11 

func (s *GetBucketMetricsConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketMetricsConfigurationOutput added in v1.5.11 

type GetBucketMetricsConfigurationOutput struct {

	// Specifies the metrics configuration.
	MetricsConfiguration *MetricsConfiguration `type:"structure"`
	// contains filtered or unexported fields
}

func (GetBucketMetricsConfigurationOutput) GoString added in v1.5.11 

func (s GetBucketMetricsConfigurationOutput) GoString() string

GoString returns the string representation

func (*GetBucketMetricsConfigurationOutput) SetMetricsConfiguration added in v1.5.11 

func (s *GetBucketMetricsConfigurationOutput) SetMetricsConfiguration(v *MetricsConfiguration) *GetBucketMetricsConfigurationOutput

SetMetricsConfiguration sets the MetricsConfiguration field's value.

func (GetBucketMetricsConfigurationOutput) String added in v1.5.11 

func (s GetBucketMetricsConfigurationOutput) String() string

String returns the string representation

type GetBucketNotificationConfigurationRequest 

type GetBucketNotificationConfigurationRequest struct {

	// Name of the bucket to get the notification configuration for.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketNotificationConfigurationRequest) GoString added in v0.6.5 

func (s GetBucketNotificationConfigurationRequest) GoString() string

GoString returns the string representation

func (*GetBucketNotificationConfigurationRequest) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (GetBucketNotificationConfigurationRequest) String added in v0.6.5 

func (s GetBucketNotificationConfigurationRequest) String() string

String returns the string representation

func (*GetBucketNotificationConfigurationRequest) Validate added in v1.1.21 

func (s *GetBucketNotificationConfigurationRequest) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketPolicyInput 

type GetBucketPolicyInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketPolicyInput) GoString added in v0.6.5 

func (s GetBucketPolicyInput) GoString() string

GoString returns the string representation

func (*GetBucketPolicyInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (GetBucketPolicyInput) String added in v0.6.5 

func (s GetBucketPolicyInput) String() string

String returns the string representation

func (*GetBucketPolicyInput) Validate added in v1.1.21 

func (s *GetBucketPolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketPolicyOutput 

type GetBucketPolicyOutput struct {

	// The bucket policy as a JSON document.
	Policy *string `type:"string"`
	// contains filtered or unexported fields
}

func (GetBucketPolicyOutput) GoString added in v0.6.5 

func (s GetBucketPolicyOutput) GoString() string

GoString returns the string representation

func (*GetBucketPolicyOutput) SetPolicy added in v1.5.0 

func (s *GetBucketPolicyOutput) SetPolicy(v string) *GetBucketPolicyOutput

SetPolicy sets the Policy field's value.

func (GetBucketPolicyOutput) String added in v0.6.5 

func (s GetBucketPolicyOutput) String() string

String returns the string representation

type GetBucketReplicationInput 

type GetBucketReplicationInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketReplicationInput) GoString added in v0.6.5 

func (s GetBucketReplicationInput) GoString() string

GoString returns the string representation

func (*GetBucketReplicationInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (GetBucketReplicationInput) String added in v0.6.5 

func (s GetBucketReplicationInput) String() string

String returns the string representation

func (*GetBucketReplicationInput) Validate added in v1.1.21 

func (s *GetBucketReplicationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketReplicationOutput 

type GetBucketReplicationOutput struct {

	// Container for replication rules. You can add as many as 1,000 rules. Total
	// replication configuration size can be up to 2 MB.
	ReplicationConfiguration *ReplicationConfiguration `type:"structure"`
	// contains filtered or unexported fields
}

func (GetBucketReplicationOutput) GoString added in v0.6.5 

func (s GetBucketReplicationOutput) GoString() string

GoString returns the string representation

func (*GetBucketReplicationOutput) SetReplicationConfiguration added in v1.5.0 

func (s *GetBucketReplicationOutput) SetReplicationConfiguration(v *ReplicationConfiguration) *GetBucketReplicationOutput

SetReplicationConfiguration sets the ReplicationConfiguration field's value.

func (GetBucketReplicationOutput) String added in v0.6.5 

func (s GetBucketReplicationOutput) String() string

String returns the string representation

type GetBucketRequestPaymentInput 

type GetBucketRequestPaymentInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketRequestPaymentInput) GoString added in v0.6.5 

func (s GetBucketRequestPaymentInput) GoString() string

GoString returns the string representation

func (*GetBucketRequestPaymentInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (GetBucketRequestPaymentInput) String added in v0.6.5 

func (s GetBucketRequestPaymentInput) String() string

String returns the string representation

func (*GetBucketRequestPaymentInput) Validate added in v1.1.21 

func (s *GetBucketRequestPaymentInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketRequestPaymentOutput 

type GetBucketRequestPaymentOutput struct {

	// Specifies who pays for the download and request fees.
	Payer *string `type:"string" enum:"Payer"`
	// contains filtered or unexported fields
}

func (GetBucketRequestPaymentOutput) GoString added in v0.6.5 

func (s GetBucketRequestPaymentOutput) GoString() string

GoString returns the string representation

func (*GetBucketRequestPaymentOutput) SetPayer added in v1.5.0 

func (s *GetBucketRequestPaymentOutput) SetPayer(v string) *GetBucketRequestPaymentOutput

SetPayer sets the Payer field's value.

func (GetBucketRequestPaymentOutput) String added in v0.6.5 

func (s GetBucketRequestPaymentOutput) String() string

String returns the string representation

type GetBucketTaggingInput 

type GetBucketTaggingInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketTaggingInput) GoString added in v0.6.5 

func (s GetBucketTaggingInput) GoString() string

GoString returns the string representation

func (*GetBucketTaggingInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (GetBucketTaggingInput) String added in v0.6.5 

func (s GetBucketTaggingInput) String() string

String returns the string representation

func (*GetBucketTaggingInput) Validate added in v1.1.21 

func (s *GetBucketTaggingInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketTaggingOutput 

type GetBucketTaggingOutput struct {

	// TagSet is a required field
	TagSet []*Tag `locationNameList:"Tag" type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketTaggingOutput) GoString added in v0.6.5 

func (s GetBucketTaggingOutput) GoString() string

GoString returns the string representation

func (*GetBucketTaggingOutput) SetTagSet added in v1.5.0 

func (s *GetBucketTaggingOutput) SetTagSet(v []*Tag) *GetBucketTaggingOutput

SetTagSet sets the TagSet field's value.

func (GetBucketTaggingOutput) String added in v0.6.5 

func (s GetBucketTaggingOutput) String() string

String returns the string representation

type GetBucketVersioningInput 

type GetBucketVersioningInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketVersioningInput) GoString added in v0.6.5 

func (s GetBucketVersioningInput) GoString() string

GoString returns the string representation

func (*GetBucketVersioningInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (GetBucketVersioningInput) String added in v0.6.5 

func (s GetBucketVersioningInput) String() string

String returns the string representation

func (*GetBucketVersioningInput) Validate added in v1.1.21 

func (s *GetBucketVersioningInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketVersioningOutput 

type GetBucketVersioningOutput struct {

	// Specifies whether MFA delete is enabled in the bucket versioning configuration.
	// This element is only returned if the bucket has been configured with MFA
	// delete. If the bucket has never been so configured, this element is not returned.
	MFADelete *string `locationName:"MfaDelete" type:"string" enum:"MFADeleteStatus"`

	// The versioning state of the bucket.
	Status *string `type:"string" enum:"BucketVersioningStatus"`
	// contains filtered or unexported fields
}

func (GetBucketVersioningOutput) GoString added in v0.6.5 

func (s GetBucketVersioningOutput) GoString() string

GoString returns the string representation

func (*GetBucketVersioningOutput) SetMFADelete added in v1.5.0 

func (s *GetBucketVersioningOutput) SetMFADelete(v string) *GetBucketVersioningOutput

SetMFADelete sets the MFADelete field's value.

func (*GetBucketVersioningOutput) SetStatus added in v1.5.0 

func (s *GetBucketVersioningOutput) SetStatus(v string) *GetBucketVersioningOutput

SetStatus sets the Status field's value.

func (GetBucketVersioningOutput) String added in v0.6.5 

func (s GetBucketVersioningOutput) String() string

String returns the string representation

type GetBucketWebsiteInput 

type GetBucketWebsiteInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetBucketWebsiteInput) GoString added in v0.6.5 

func (s GetBucketWebsiteInput) GoString() string

GoString returns the string representation

func (*GetBucketWebsiteInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (GetBucketWebsiteInput) String added in v0.6.5 

func (s GetBucketWebsiteInput) String() string

String returns the string representation

func (*GetBucketWebsiteInput) Validate added in v1.1.21 

func (s *GetBucketWebsiteInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetBucketWebsiteOutput 

type GetBucketWebsiteOutput struct {
	ErrorDocument *ErrorDocument `type:"structure"`

	IndexDocument *IndexDocument `type:"structure"`

	RedirectAllRequestsTo *RedirectAllRequestsTo `type:"structure"`

	RoutingRules []*RoutingRule `locationNameList:"RoutingRule" type:"list"`
	// contains filtered or unexported fields
}

func (GetBucketWebsiteOutput) GoString added in v0.6.5 

func (s GetBucketWebsiteOutput) GoString() string

GoString returns the string representation

func (*GetBucketWebsiteOutput) SetErrorDocument added in v1.5.0 

func (s *GetBucketWebsiteOutput) SetErrorDocument(v *ErrorDocument) *GetBucketWebsiteOutput

SetErrorDocument sets the ErrorDocument field's value.

func (*GetBucketWebsiteOutput) SetIndexDocument added in v1.5.0 

func (s *GetBucketWebsiteOutput) SetIndexDocument(v *IndexDocument) *GetBucketWebsiteOutput

SetIndexDocument sets the IndexDocument field's value.

func (*GetBucketWebsiteOutput) SetRedirectAllRequestsTo added in v1.5.0 

func (s *GetBucketWebsiteOutput) SetRedirectAllRequestsTo(v *RedirectAllRequestsTo) *GetBucketWebsiteOutput

SetRedirectAllRequestsTo sets the RedirectAllRequestsTo field's value.

func (*GetBucketWebsiteOutput) SetRoutingRules added in v1.5.0 

func (s *GetBucketWebsiteOutput) SetRoutingRules(v []*RoutingRule) *GetBucketWebsiteOutput

SetRoutingRules sets the RoutingRules field's value.

func (GetBucketWebsiteOutput) String added in v0.6.5 

func (s GetBucketWebsiteOutput) String() string

String returns the string representation

type GetObjectAclInput added in v0.9.5 

type GetObjectAclInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`

	// VersionId used to reference a specific version of the object.
	VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
	// contains filtered or unexported fields
}

func (GetObjectAclInput) GoString added in v0.9.5 

func (s GetObjectAclInput) GoString() string

GoString returns the string representation

func (*GetObjectAclInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*GetObjectAclInput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*GetObjectAclInput) SetRequestPayer added in v1.5.0 

func (s *GetObjectAclInput) SetRequestPayer(v string) *GetObjectAclInput

SetRequestPayer sets the RequestPayer field's value.

func (*GetObjectAclInput) SetVersionId added in v1.5.0 

func (s *GetObjectAclInput) SetVersionId(v string) *GetObjectAclInput

SetVersionId sets the VersionId field's value.

func (GetObjectAclInput) String added in v0.9.5 

func (s GetObjectAclInput) String() string

String returns the string representation

func (*GetObjectAclInput) Validate added in v1.1.21 

func (s *GetObjectAclInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetObjectAclOutput added in v0.9.5 

type GetObjectAclOutput struct {

	// A list of grants.
	Grants []*Grant `locationName:"AccessControlList" locationNameList:"Grant" type:"list"`

	Owner *Owner `type:"structure"`

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
	// contains filtered or unexported fields
}

func (GetObjectAclOutput) GoString added in v0.9.5 

func (s GetObjectAclOutput) GoString() string

GoString returns the string representation

func (*GetObjectAclOutput) SetGrants added in v1.5.0 

func (s *GetObjectAclOutput) SetGrants(v []*Grant) *GetObjectAclOutput

SetGrants sets the Grants field's value.

func (*GetObjectAclOutput) SetOwner added in v1.5.0 

func (s *GetObjectAclOutput) SetOwner(v *Owner) *GetObjectAclOutput

SetOwner sets the Owner field's value.

func (*GetObjectAclOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (GetObjectAclOutput) String added in v0.9.5 

func (s GetObjectAclOutput) String() string

String returns the string representation

type GetObjectInput 

type GetObjectInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Return the object only if its entity tag (ETag) is the same as the one specified,
	// otherwise return a 412 (precondition failed).
	IfMatch *string `location:"header" locationName:"If-Match" type:"string"`

	// Return the object only if it has been modified since the specified time,
	// otherwise return a 304 (not modified).
	IfModifiedSince *time.Time `location:"header" locationName:"If-Modified-Since" type:"timestamp"`

	// Return the object only if its entity tag (ETag) is different from the one
	// specified, otherwise return a 304 (not modified).
	IfNoneMatch *string `location:"header" locationName:"If-None-Match" type:"string"`

	// Return the object only if it has not been modified since the specified time,
	// otherwise return a 412 (precondition failed).
	IfUnmodifiedSince *time.Time `location:"header" locationName:"If-Unmodified-Since" type:"timestamp"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// Part number of the object being read. This is a positive integer between
	// 1 and 10,000. Effectively performs a 'ranged' GET request for the part specified.
	// Useful for downloading just a part of an object.
	PartNumber *int64 `location:"querystring" locationName:"partNumber" type:"integer"`

	// Downloads the specified range bytes of an object. For more information about
	// the HTTP Range header, go to http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35.
	Range *string `location:"header" locationName:"Range" type:"string"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`

	// Sets the Cache-Control header of the response.
	ResponseCacheControl *string `location:"querystring" locationName:"response-cache-control" type:"string"`

	// Sets the Content-Disposition header of the response
	ResponseContentDisposition *string `location:"querystring" locationName:"response-content-disposition" type:"string"`

	// Sets the Content-Encoding header of the response.
	ResponseContentEncoding *string `location:"querystring" locationName:"response-content-encoding" type:"string"`

	// Sets the Content-Language header of the response.
	ResponseContentLanguage *string `location:"querystring" locationName:"response-content-language" type:"string"`

	// Sets the Content-Type header of the response.
	ResponseContentType *string `location:"querystring" locationName:"response-content-type" type:"string"`

	// Sets the Expires header of the response.
	ResponseExpires *time.Time `location:"querystring" locationName:"response-expires" type:"timestamp"`

	// Specifies the algorithm to use to when encrypting the object (e.g., AES256).
	SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"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
	// 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 `location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"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 the encryption
	// key was transmitted without error.
	SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`

	// VersionId used to reference a specific version of the object.
	VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
	// contains filtered or unexported fields
}

func (GetObjectInput) GoString added in v0.6.5 

func (s GetObjectInput) GoString() string

GoString returns the string representation

func (*GetObjectInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*GetObjectInput) SetIfMatch added in v1.5.0 

func (s *GetObjectInput) SetIfMatch(v string) *GetObjectInput

SetIfMatch sets the IfMatch field's value.

func (*GetObjectInput) SetIfModifiedSince added in v1.5.0 

func (s *GetObjectInput) SetIfModifiedSince(v time.Time) *GetObjectInput

SetIfModifiedSince sets the IfModifiedSince field's value.

func (*GetObjectInput) SetIfNoneMatch added in v1.5.0 

func (s *GetObjectInput) SetIfNoneMatch(v string) *GetObjectInput

SetIfNoneMatch sets the IfNoneMatch field's value.

func (*GetObjectInput) SetIfUnmodifiedSince added in v1.5.0 

func (s *GetObjectInput) SetIfUnmodifiedSince(v time.Time) *GetObjectInput

SetIfUnmodifiedSince sets the IfUnmodifiedSince field's value.

func (*GetObjectInput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*GetObjectInput) SetPartNumber added in v1.5.0 

func (s *GetObjectInput) SetPartNumber(v int64) *GetObjectInput

SetPartNumber sets the PartNumber field's value.

func (*GetObjectInput) SetRange added in v1.5.0 

func (s *GetObjectInput) SetRange(v string) *GetObjectInput

SetRange sets the Range field's value.

func (*GetObjectInput) SetRequestPayer added in v1.5.0 

func (s *GetObjectInput) SetRequestPayer(v string) *GetObjectInput

SetRequestPayer sets the RequestPayer field's value.

func (*GetObjectInput) SetResponseCacheControl added in v1.5.0 

func (s *GetObjectInput) SetResponseCacheControl(v string) *GetObjectInput

SetResponseCacheControl sets the ResponseCacheControl field's value.

func (*GetObjectInput) SetResponseContentDisposition added in v1.5.0 

func (s *GetObjectInput) SetResponseContentDisposition(v string) *GetObjectInput

SetResponseContentDisposition sets the ResponseContentDisposition field's value.

func (*GetObjectInput) SetResponseContentEncoding added in v1.5.0 

func (s *GetObjectInput) SetResponseContentEncoding(v string) *GetObjectInput

SetResponseContentEncoding sets the ResponseContentEncoding field's value.

func (*GetObjectInput) SetResponseContentLanguage added in v1.5.0 

func (s *GetObjectInput) SetResponseContentLanguage(v string) *GetObjectInput

SetResponseContentLanguage sets the ResponseContentLanguage field's value.

func (*GetObjectInput) SetResponseContentType added in v1.5.0 

func (s *GetObjectInput) SetResponseContentType(v string) *GetObjectInput

SetResponseContentType sets the ResponseContentType field's value.

func (*GetObjectInput) SetResponseExpires added in v1.5.0 

func (s *GetObjectInput) SetResponseExpires(v time.Time) *GetObjectInput

SetResponseExpires sets the ResponseExpires field's value.

func (*GetObjectInput) SetSSECustomerAlgorithm added in v1.5.0 

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

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.

func (*GetObjectInput) SetSSECustomerKey added in v1.5.0 

func (s *GetObjectInput) SetSSECustomerKey(v string) *GetObjectInput

SetSSECustomerKey sets the SSECustomerKey field's value.

func (*GetObjectInput) SetSSECustomerKeyMD5 added in v1.5.0 

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

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.

func (*GetObjectInput) SetVersionId added in v1.5.0 

func (s *GetObjectInput) SetVersionId(v string) *GetObjectInput

SetVersionId sets the VersionId field's value.

func (GetObjectInput) String added in v0.6.5 

func (s GetObjectInput) String() string

String returns the string representation

func (*GetObjectInput) Validate added in v1.1.21 

func (s *GetObjectInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetObjectOutput 

type GetObjectOutput struct {
	AcceptRanges *string `location:"header" locationName:"accept-ranges" type:"string"`

	// Object data.
	Body io.ReadCloser `type:"blob"`

	// Specifies caching behavior along the request/reply chain.
	CacheControl *string `location:"header" locationName:"Cache-Control" type:"string"`

	// Specifies presentational information for the object.
	ContentDisposition *string `location:"header" locationName:"Content-Disposition" type:"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.
	ContentEncoding *string `location:"header" locationName:"Content-Encoding" type:"string"`

	// The language the content is in.
	ContentLanguage *string `location:"header" locationName:"Content-Language" type:"string"`

	// Size of the body in bytes.
	ContentLength *int64 `location:"header" locationName:"Content-Length" type:"long"`

	// The portion of the object returned in the response.
	ContentRange *string `location:"header" locationName:"Content-Range" type:"string"`

	// A standard MIME type describing the format of the object data.
	ContentType *string `location:"header" locationName:"Content-Type" type:"string"`

	// Specifies whether the object retrieved was (true) or was not (false) a Delete
	// Marker. If false, this response header does not appear in the response.
	DeleteMarker *bool `location:"header" locationName:"x-amz-delete-marker" type:"boolean"`

	// An ETag is an opaque identifier assigned by a web server to a specific version
	// of a resource found at a URL
	ETag *string `location:"header" locationName:"ETag" type:"string"`

	// If the object expiration is configured (see PUT Bucket lifecycle), the response
	// includes this header. It includes the expiry-date and rule-id key value pairs
	// providing object expiration information. The value of the rule-id is URL
	// encoded.
	Expiration *string `location:"header" locationName:"x-amz-expiration" type:"string"`

	// The date and time at which the object is no longer cacheable.
	Expires *string `location:"header" locationName:"Expires" type:"string"`

	// Last modified date of the object
	LastModified *time.Time `location:"header" locationName:"Last-Modified" type:"timestamp"`

	// A map of metadata to store with the object in S3.
	Metadata map[string]*string `location:"headers" locationName:"x-amz-meta-" type:"map"`

	// This is set to the number of metadata entries not returned in x-amz-meta
	// headers. This can happen if you create metadata using an API like SOAP that
	// supports more flexible metadata than the REST API. For example, using SOAP,
	// you can create metadata whose values are not legal HTTP headers.
	MissingMeta *int64 `location:"header" locationName:"x-amz-missing-meta" type:"integer"`

	// The count of parts this object has.
	PartsCount *int64 `location:"header" locationName:"x-amz-mp-parts-count" type:"integer"`

	ReplicationStatus *string `location:"header" locationName:"x-amz-replication-status" type:"string" enum:"ReplicationStatus"`

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`

	// Provides information about object restoration operation and expiration time
	// of the restored object copy.
	Restore *string `location:"header" locationName:"x-amz-restore" 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.
	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 to provide round trip message integrity
	// verification of the customer-provided encryption key.
	SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`

	// If present, specifies the ID of the AWS Key Management Service (KMS) master
	// encryption key that was used for the object.
	SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string"`

	// The Server-side encryption algorithm used when storing this object in S3
	// (e.g., AES256, aws:kms).
	ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`

	StorageClass *string `location:"header" locationName:"x-amz-storage-class" type:"string" enum:"StorageClass"`

	// The number of tags, if any, on the object.
	TagCount *int64 `location:"header" locationName:"x-amz-tagging-count" type:"integer"`

	// Version of the object.
	VersionId *string `location:"header" locationName:"x-amz-version-id" type:"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.
	WebsiteRedirectLocation *string `location:"header" locationName:"x-amz-website-redirect-location" type:"string"`
	// contains filtered or unexported fields
}

func (GetObjectOutput) GoString added in v0.6.5 

func (s GetObjectOutput) GoString() string

GoString returns the string representation

func (*GetObjectOutput) SetAcceptRanges added in v1.5.0 

func (s *GetObjectOutput) SetAcceptRanges(v string) *GetObjectOutput

SetAcceptRanges sets the AcceptRanges field's value.

func (*GetObjectOutput) SetBody added in v1.5.0 

func (s *GetObjectOutput) SetBody(v io.ReadCloser) *GetObjectOutput

SetBody sets the Body field's value.

func (*GetObjectOutput) SetCacheControl added in v1.5.0 

func (s *GetObjectOutput) SetCacheControl(v string) *GetObjectOutput

SetCacheControl sets the CacheControl field's value.

func (*GetObjectOutput) SetContentDisposition added in v1.5.0 

func (s *GetObjectOutput) SetContentDisposition(v string) *GetObjectOutput

SetContentDisposition sets the ContentDisposition field's value.

func (*GetObjectOutput) SetContentEncoding added in v1.5.0 

func (s *GetObjectOutput) SetContentEncoding(v string) *GetObjectOutput

SetContentEncoding sets the ContentEncoding field's value.

func (*GetObjectOutput) SetContentLanguage added in v1.5.0 

func (s *GetObjectOutput) SetContentLanguage(v string) *GetObjectOutput

SetContentLanguage sets the ContentLanguage field's value.

func (*GetObjectOutput) SetContentLength added in v1.5.0 

func (s *GetObjectOutput) SetContentLength(v int64) *GetObjectOutput

SetContentLength sets the ContentLength field's value.

func (*GetObjectOutput) SetContentRange added in v1.5.0 

func (s *GetObjectOutput) SetContentRange(v string) *GetObjectOutput

SetContentRange sets the ContentRange field's value.

func (*GetObjectOutput) SetContentType added in v1.5.0 

func (s *GetObjectOutput) SetContentType(v string) *GetObjectOutput

SetContentType sets the ContentType field's value.

func (*GetObjectOutput) SetDeleteMarker added in v1.5.0 

func (s *GetObjectOutput) SetDeleteMarker(v bool) *GetObjectOutput

SetDeleteMarker sets the DeleteMarker field's value.

func (*GetObjectOutput) SetETag added in v1.5.0 

func (s *GetObjectOutput) SetETag(v string) *GetObjectOutput

SetETag sets the ETag field's value.

func (*GetObjectOutput) SetExpiration added in v1.5.0 

func (s *GetObjectOutput) SetExpiration(v string) *GetObjectOutput

SetExpiration sets the Expiration field's value.

func (*GetObjectOutput) SetExpires added in v1.5.0 

func (s *GetObjectOutput) SetExpires(v string) *GetObjectOutput

SetExpires sets the Expires field's value.

func (*GetObjectOutput) SetLastModified added in v1.5.0 

func (s *GetObjectOutput) SetLastModified(v time.Time) *GetObjectOutput

SetLastModified sets the LastModified field's value.

func (*GetObjectOutput) SetMetadata added in v1.5.0 

func (s *GetObjectOutput) SetMetadata(v map[string]*string) *GetObjectOutput

SetMetadata sets the Metadata field's value.

func (*GetObjectOutput) SetMissingMeta added in v1.5.0 

func (s *GetObjectOutput) SetMissingMeta(v int64) *GetObjectOutput

SetMissingMeta sets the MissingMeta field's value.

func (*GetObjectOutput) SetPartsCount added in v1.5.0 

func (s *GetObjectOutput) SetPartsCount(v int64) *GetObjectOutput

SetPartsCount sets the PartsCount field's value.

func (*GetObjectOutput) SetReplicationStatus added in v1.5.0 

func (s *GetObjectOutput) SetReplicationStatus(v string) *GetObjectOutput

SetReplicationStatus sets the ReplicationStatus field's value.

func (*GetObjectOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (*GetObjectOutput) SetRestore added in v1.5.0 

func (s *GetObjectOutput) SetRestore(v string) *GetObjectOutput

SetRestore sets the Restore field's value.

func (*GetObjectOutput) SetSSECustomerAlgorithm added in v1.5.0 

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

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.

func (*GetObjectOutput) SetSSECustomerKeyMD5 added in v1.5.0 

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

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.

func (*GetObjectOutput) SetSSEKMSKeyId added in v1.5.0 

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

SetSSEKMSKeyId sets the SSEKMSKeyId field's value.

func (*GetObjectOutput) SetServerSideEncryption added in v1.5.0 

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

SetServerSideEncryption sets the ServerSideEncryption field's value.

func (*GetObjectOutput) SetStorageClass added in v1.5.0 

func (s *GetObjectOutput) SetStorageClass(v string) *GetObjectOutput

SetStorageClass sets the StorageClass field's value.

func (*GetObjectOutput) SetTagCount added in v1.5.11 

func (s *GetObjectOutput) SetTagCount(v int64) *GetObjectOutput

SetTagCount sets the TagCount field's value.

func (*GetObjectOutput) SetVersionId added in v1.5.0 

func (s *GetObjectOutput) SetVersionId(v string) *GetObjectOutput

SetVersionId sets the VersionId field's value.

func (*GetObjectOutput) SetWebsiteRedirectLocation added in v1.5.0 

func (s *GetObjectOutput) SetWebsiteRedirectLocation(v string) *GetObjectOutput

SetWebsiteRedirectLocation sets the WebsiteRedirectLocation field's value.

func (GetObjectOutput) String added in v0.6.5 

func (s GetObjectOutput) String() string

String returns the string representation

type GetObjectTaggingInput added in v1.5.11 

type GetObjectTaggingInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
	// contains filtered or unexported fields
}

func (GetObjectTaggingInput) GoString added in v1.5.11 

func (s GetObjectTaggingInput) GoString() string

GoString returns the string representation

func (*GetObjectTaggingInput) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*GetObjectTaggingInput) SetKey added in v1.5.11 

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

SetKey sets the Key field's value.

func (*GetObjectTaggingInput) SetVersionId added in v1.5.11 

func (s *GetObjectTaggingInput) SetVersionId(v string) *GetObjectTaggingInput

SetVersionId sets the VersionId field's value.

func (GetObjectTaggingInput) String added in v1.5.11 

func (s GetObjectTaggingInput) String() string

String returns the string representation

func (*GetObjectTaggingInput) Validate added in v1.5.11 

func (s *GetObjectTaggingInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetObjectTaggingOutput added in v1.5.11 

type GetObjectTaggingOutput struct {

	// TagSet is a required field
	TagSet []*Tag `locationNameList:"Tag" type:"list" required:"true"`

	VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
	// contains filtered or unexported fields
}

func (GetObjectTaggingOutput) GoString added in v1.5.11 

func (s GetObjectTaggingOutput) GoString() string

GoString returns the string representation

func (*GetObjectTaggingOutput) SetTagSet added in v1.5.11 

func (s *GetObjectTaggingOutput) SetTagSet(v []*Tag) *GetObjectTaggingOutput

SetTagSet sets the TagSet field's value.

func (*GetObjectTaggingOutput) SetVersionId added in v1.5.11 

func (s *GetObjectTaggingOutput) SetVersionId(v string) *GetObjectTaggingOutput

SetVersionId sets the VersionId field's value.

func (GetObjectTaggingOutput) String added in v1.5.11 

func (s GetObjectTaggingOutput) String() string

String returns the string representation

type GetObjectTorrentInput 

type GetObjectTorrentInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
	// contains filtered or unexported fields
}

func (GetObjectTorrentInput) GoString added in v0.6.5 

func (s GetObjectTorrentInput) GoString() string

GoString returns the string representation

func (*GetObjectTorrentInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*GetObjectTorrentInput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*GetObjectTorrentInput) SetRequestPayer added in v1.5.0 

func (s *GetObjectTorrentInput) SetRequestPayer(v string) *GetObjectTorrentInput

SetRequestPayer sets the RequestPayer field's value.

func (GetObjectTorrentInput) String added in v0.6.5 

func (s GetObjectTorrentInput) String() string

String returns the string representation

func (*GetObjectTorrentInput) Validate added in v1.1.21 

func (s *GetObjectTorrentInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetObjectTorrentOutput 

type GetObjectTorrentOutput struct {
	Body io.ReadCloser `type:"blob"`

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
	// contains filtered or unexported fields
}

func (GetObjectTorrentOutput) GoString added in v0.6.5 

func (s GetObjectTorrentOutput) GoString() string

GoString returns the string representation

func (*GetObjectTorrentOutput) SetBody added in v1.5.0 

func (s *GetObjectTorrentOutput) SetBody(v io.ReadCloser) *GetObjectTorrentOutput

SetBody sets the Body field's value.

func (*GetObjectTorrentOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (GetObjectTorrentOutput) String added in v0.6.5 

func (s GetObjectTorrentOutput) String() string

String returns the string representation

type GlacierJobParameters added in v1.5.10 

type GlacierJobParameters struct {

	// Glacier retrieval tier at which the restore will be processed.
	//
	// Tier is a required field
	Tier *string `type:"string" required:"true" enum:"Tier"`
	// contains filtered or unexported fields
}

func (GlacierJobParameters) GoString added in v1.5.10 

func (s GlacierJobParameters) GoString() string

GoString returns the string representation

func (*GlacierJobParameters) SetTier added in v1.5.10 

func (s *GlacierJobParameters) SetTier(v string) *GlacierJobParameters

SetTier sets the Tier field's value.

func (GlacierJobParameters) String added in v1.5.10 

func (s GlacierJobParameters) String() string

String returns the string representation

func (*GlacierJobParameters) Validate added in v1.5.10 

func (s *GlacierJobParameters) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type Grant 

type Grant struct {
	Grantee *Grantee `type:"structure" xmlPrefix:"xsi" xmlURI:"http://www.w3.org/2001/XMLSchema-instance"`

	// Specifies the permission given to the grantee.
	Permission *string `type:"string" enum:"Permission"`
	// contains filtered or unexported fields
}

func (Grant) GoString added in v0.6.5 

func (s Grant) GoString() string

GoString returns the string representation

func (*Grant) SetGrantee added in v1.5.0 

func (s *Grant) SetGrantee(v *Grantee) *Grant

SetGrantee sets the Grantee field's value.

func (*Grant) SetPermission added in v1.5.0 

func (s *Grant) SetPermission(v string) *Grant

SetPermission sets the Permission field's value.

func (Grant) String added in v0.6.5 

func (s Grant) String() string

String returns the string representation

func (*Grant) Validate added in v1.1.21 

func (s *Grant) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type Grantee 

type Grantee struct {

	// Screen name of the grantee.
	DisplayName *string `type:"string"`

	// Email address of the grantee.
	EmailAddress *string `type:"string"`

	// The canonical user ID of the grantee.
	ID *string `type:"string"`

	// Type of grantee
	//
	// Type is a required field
	Type *string `locationName:"xsi:type" type:"string" xmlAttribute:"true" required:"true" enum:"Type"`

	// URI of the grantee group.
	URI *string `type:"string"`
	// contains filtered or unexported fields
}

func (Grantee) GoString added in v0.6.5 

func (s Grantee) GoString() string

GoString returns the string representation

func (*Grantee) SetDisplayName added in v1.5.0 

func (s *Grantee) SetDisplayName(v string) *Grantee

SetDisplayName sets the DisplayName field's value.

func (*Grantee) SetEmailAddress added in v1.5.0 

func (s *Grantee) SetEmailAddress(v string) *Grantee

SetEmailAddress sets the EmailAddress field's value.

func (*Grantee) SetID added in v1.5.0 

func (s *Grantee) SetID(v string) *Grantee

SetID sets the ID field's value.

func (*Grantee) SetType added in v1.5.0 

func (s *Grantee) SetType(v string) *Grantee

SetType sets the Type field's value.

func (*Grantee) SetURI added in v1.5.0 

func (s *Grantee) SetURI(v string) *Grantee

SetURI sets the URI field's value.

func (Grantee) String added in v0.6.5 

func (s Grantee) String() string

String returns the string representation

func (*Grantee) Validate added in v1.1.21 

func (s *Grantee) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type HeadBucketInput 

type HeadBucketInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (HeadBucketInput) GoString added in v0.6.5 

func (s HeadBucketInput) GoString() string

GoString returns the string representation

func (*HeadBucketInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (HeadBucketInput) String added in v0.6.5 

func (s HeadBucketInput) String() string

String returns the string representation

func (*HeadBucketInput) Validate added in v1.1.21 

func (s *HeadBucketInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type HeadBucketOutput 

type HeadBucketOutput struct {
	// contains filtered or unexported fields
}

func (HeadBucketOutput) GoString added in v0.6.5 

func (s HeadBucketOutput) GoString() string

GoString returns the string representation

func (HeadBucketOutput) String added in v0.6.5 

func (s HeadBucketOutput) String() string

String returns the string representation

type HeadObjectInput 

type HeadObjectInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Return the object only if its entity tag (ETag) is the same as the one specified,
	// otherwise return a 412 (precondition failed).
	IfMatch *string `location:"header" locationName:"If-Match" type:"string"`

	// Return the object only if it has been modified since the specified time,
	// otherwise return a 304 (not modified).
	IfModifiedSince *time.Time `location:"header" locationName:"If-Modified-Since" type:"timestamp"`

	// Return the object only if its entity tag (ETag) is different from the one
	// specified, otherwise return a 304 (not modified).
	IfNoneMatch *string `location:"header" locationName:"If-None-Match" type:"string"`

	// Return the object only if it has not been modified since the specified time,
	// otherwise return a 412 (precondition failed).
	IfUnmodifiedSince *time.Time `location:"header" locationName:"If-Unmodified-Since" type:"timestamp"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// Part number of the object being read. This is a positive integer between
	// 1 and 10,000. Effectively performs a 'ranged' HEAD request for the part specified.
	// Useful querying about the size of the part and the number of parts in this
	// object.
	PartNumber *int64 `location:"querystring" locationName:"partNumber" type:"integer"`

	// Downloads the specified range bytes of an object. For more information about
	// the HTTP Range header, go to http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35.
	Range *string `location:"header" locationName:"Range" type:"string"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`

	// Specifies the algorithm to use to when encrypting the object (e.g., AES256).
	SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"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
	// 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 `location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"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 the encryption
	// key was transmitted without error.
	SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`

	// VersionId used to reference a specific version of the object.
	VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
	// contains filtered or unexported fields
}

func (HeadObjectInput) GoString added in v0.6.5 

func (s HeadObjectInput) GoString() string

GoString returns the string representation

func (*HeadObjectInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*HeadObjectInput) SetIfMatch added in v1.5.0 

func (s *HeadObjectInput) SetIfMatch(v string) *HeadObjectInput

SetIfMatch sets the IfMatch field's value.

func (*HeadObjectInput) SetIfModifiedSince added in v1.5.0 

func (s *HeadObjectInput) SetIfModifiedSince(v time.Time) *HeadObjectInput

SetIfModifiedSince sets the IfModifiedSince field's value.

func (*HeadObjectInput) SetIfNoneMatch added in v1.5.0 

func (s *HeadObjectInput) SetIfNoneMatch(v string) *HeadObjectInput

SetIfNoneMatch sets the IfNoneMatch field's value.

func (*HeadObjectInput) SetIfUnmodifiedSince added in v1.5.0 

func (s *HeadObjectInput) SetIfUnmodifiedSince(v time.Time) *HeadObjectInput

SetIfUnmodifiedSince sets the IfUnmodifiedSince field's value.

func (*HeadObjectInput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*HeadObjectInput) SetPartNumber added in v1.5.0 

func (s *HeadObjectInput) SetPartNumber(v int64) *HeadObjectInput

SetPartNumber sets the PartNumber field's value.

func (*HeadObjectInput) SetRange added in v1.5.0 

func (s *HeadObjectInput) SetRange(v string) *HeadObjectInput

SetRange sets the Range field's value.

func (*HeadObjectInput) SetRequestPayer added in v1.5.0 

func (s *HeadObjectInput) SetRequestPayer(v string) *HeadObjectInput

SetRequestPayer sets the RequestPayer field's value.

func (*HeadObjectInput) SetSSECustomerAlgorithm added in v1.5.0 

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

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.

func (*HeadObjectInput) SetSSECustomerKey added in v1.5.0 

func (s *HeadObjectInput) SetSSECustomerKey(v string) *HeadObjectInput

SetSSECustomerKey sets the SSECustomerKey field's value.

func (*HeadObjectInput) SetSSECustomerKeyMD5 added in v1.5.0 

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

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.

func (*HeadObjectInput) SetVersionId added in v1.5.0 

func (s *HeadObjectInput) SetVersionId(v string) *HeadObjectInput

SetVersionId sets the VersionId field's value.

func (HeadObjectInput) String added in v0.6.5 

func (s HeadObjectInput) String() string

String returns the string representation

func (*HeadObjectInput) Validate added in v1.1.21 

func (s *HeadObjectInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type HeadObjectOutput 

type HeadObjectOutput struct {
	AcceptRanges *string `location:"header" locationName:"accept-ranges" type:"string"`

	// Specifies caching behavior along the request/reply chain.
	CacheControl *string `location:"header" locationName:"Cache-Control" type:"string"`

	// Specifies presentational information for the object.
	ContentDisposition *string `location:"header" locationName:"Content-Disposition" type:"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.
	ContentEncoding *string `location:"header" locationName:"Content-Encoding" type:"string"`

	// The language the content is in.
	ContentLanguage *string `location:"header" locationName:"Content-Language" type:"string"`

	// Size of the body in bytes.
	ContentLength *int64 `location:"header" locationName:"Content-Length" type:"long"`

	// A standard MIME type describing the format of the object data.
	ContentType *string `location:"header" locationName:"Content-Type" type:"string"`

	// Specifies whether the object retrieved was (true) or was not (false) a Delete
	// Marker. If false, this response header does not appear in the response.
	DeleteMarker *bool `location:"header" locationName:"x-amz-delete-marker" type:"boolean"`

	// An ETag is an opaque identifier assigned by a web server to a specific version
	// of a resource found at a URL
	ETag *string `location:"header" locationName:"ETag" type:"string"`

	// If the object expiration is configured (see PUT Bucket lifecycle), the response
	// includes this header. It includes the expiry-date and rule-id key value pairs
	// providing object expiration information. The value of the rule-id is URL
	// encoded.
	Expiration *string `location:"header" locationName:"x-amz-expiration" type:"string"`

	// The date and time at which the object is no longer cacheable.
	Expires *string `location:"header" locationName:"Expires" type:"string"`

	// Last modified date of the object
	LastModified *time.Time `location:"header" locationName:"Last-Modified" type:"timestamp"`

	// A map of metadata to store with the object in S3.
	Metadata map[string]*string `location:"headers" locationName:"x-amz-meta-" type:"map"`

	// This is set to the number of metadata entries not returned in x-amz-meta
	// headers. This can happen if you create metadata using an API like SOAP that
	// supports more flexible metadata than the REST API. For example, using SOAP,
	// you can create metadata whose values are not legal HTTP headers.
	MissingMeta *int64 `location:"header" locationName:"x-amz-missing-meta" type:"integer"`

	// The count of parts this object has.
	PartsCount *int64 `location:"header" locationName:"x-amz-mp-parts-count" type:"integer"`

	ReplicationStatus *string `location:"header" locationName:"x-amz-replication-status" type:"string" enum:"ReplicationStatus"`

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`

	// Provides information about object restoration operation and expiration time
	// of the restored object copy.
	Restore *string `location:"header" locationName:"x-amz-restore" 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.
	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 to provide round trip message integrity
	// verification of the customer-provided encryption key.
	SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`

	// If present, specifies the ID of the AWS Key Management Service (KMS) master
	// encryption key that was used for the object.
	SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string"`

	// The Server-side encryption algorithm used when storing this object in S3
	// (e.g., AES256, aws:kms).
	ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`

	StorageClass *string `location:"header" locationName:"x-amz-storage-class" type:"string" enum:"StorageClass"`

	// Version of the object.
	VersionId *string `location:"header" locationName:"x-amz-version-id" type:"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.
	WebsiteRedirectLocation *string `location:"header" locationName:"x-amz-website-redirect-location" type:"string"`
	// contains filtered or unexported fields
}

func (HeadObjectOutput) GoString added in v0.6.5 

func (s HeadObjectOutput) GoString() string

GoString returns the string representation

func (*HeadObjectOutput) SetAcceptRanges added in v1.5.0 

func (s *HeadObjectOutput) SetAcceptRanges(v string) *HeadObjectOutput

SetAcceptRanges sets the AcceptRanges field's value.

func (*HeadObjectOutput) SetCacheControl added in v1.5.0 

func (s *HeadObjectOutput) SetCacheControl(v string) *HeadObjectOutput

SetCacheControl sets the CacheControl field's value.

func (*HeadObjectOutput) SetContentDisposition added in v1.5.0 

func (s *HeadObjectOutput) SetContentDisposition(v string) *HeadObjectOutput

SetContentDisposition sets the ContentDisposition field's value.

func (*HeadObjectOutput) SetContentEncoding added in v1.5.0 

func (s *HeadObjectOutput) SetContentEncoding(v string) *HeadObjectOutput

SetContentEncoding sets the ContentEncoding field's value.

func (*HeadObjectOutput) SetContentLanguage added in v1.5.0 

func (s *HeadObjectOutput) SetContentLanguage(v string) *HeadObjectOutput

SetContentLanguage sets the ContentLanguage field's value.

func (*HeadObjectOutput) SetContentLength added in v1.5.0 

func (s *HeadObjectOutput) SetContentLength(v int64) *HeadObjectOutput

SetContentLength sets the ContentLength field's value.

func (*HeadObjectOutput) SetContentType added in v1.5.0 

func (s *HeadObjectOutput) SetContentType(v string) *HeadObjectOutput

SetContentType sets the ContentType field's value.

func (*HeadObjectOutput) SetDeleteMarker added in v1.5.0 

func (s *HeadObjectOutput) SetDeleteMarker(v bool) *HeadObjectOutput

SetDeleteMarker sets the DeleteMarker field's value.

func (*HeadObjectOutput) SetETag added in v1.5.0 

func (s *HeadObjectOutput) SetETag(v string) *HeadObjectOutput

SetETag sets the ETag field's value.

func (*HeadObjectOutput) SetExpiration added in v1.5.0 

func (s *HeadObjectOutput) SetExpiration(v string) *HeadObjectOutput

SetExpiration sets the Expiration field's value.

func (*HeadObjectOutput) SetExpires added in v1.5.0 

func (s *HeadObjectOutput) SetExpires(v string) *HeadObjectOutput

SetExpires sets the Expires field's value.

func (*HeadObjectOutput) SetLastModified added in v1.5.0 

func (s *HeadObjectOutput) SetLastModified(v time.Time) *HeadObjectOutput

SetLastModified sets the LastModified field's value.

func (*HeadObjectOutput) SetMetadata added in v1.5.0 

func (s *HeadObjectOutput) SetMetadata(v map[string]*string) *HeadObjectOutput

SetMetadata sets the Metadata field's value.

func (*HeadObjectOutput) SetMissingMeta added in v1.5.0 

func (s *HeadObjectOutput) SetMissingMeta(v int64) *HeadObjectOutput

SetMissingMeta sets the MissingMeta field's value.

func (*HeadObjectOutput) SetPartsCount added in v1.5.0 

func (s *HeadObjectOutput) SetPartsCount(v int64) *HeadObjectOutput

SetPartsCount sets the PartsCount field's value.

func (*HeadObjectOutput) SetReplicationStatus added in v1.5.0 

func (s *HeadObjectOutput) SetReplicationStatus(v string) *HeadObjectOutput

SetReplicationStatus sets the ReplicationStatus field's value.

func (*HeadObjectOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (*HeadObjectOutput) SetRestore added in v1.5.0 

func (s *HeadObjectOutput) SetRestore(v string) *HeadObjectOutput

SetRestore sets the Restore field's value.

func (*HeadObjectOutput) SetSSECustomerAlgorithm added in v1.5.0 

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

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.

func (*HeadObjectOutput) SetSSECustomerKeyMD5 added in v1.5.0 

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

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.

func (*HeadObjectOutput) SetSSEKMSKeyId added in v1.5.0 

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

SetSSEKMSKeyId sets the SSEKMSKeyId field's value.

func (*HeadObjectOutput) SetServerSideEncryption added in v1.5.0 

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

SetServerSideEncryption sets the ServerSideEncryption field's value.

func (*HeadObjectOutput) SetStorageClass added in v1.5.0 

func (s *HeadObjectOutput) SetStorageClass(v string) *HeadObjectOutput

SetStorageClass sets the StorageClass field's value.

func (*HeadObjectOutput) SetVersionId added in v1.5.0 

func (s *HeadObjectOutput) SetVersionId(v string) *HeadObjectOutput

SetVersionId sets the VersionId field's value.

func (*HeadObjectOutput) SetWebsiteRedirectLocation added in v1.5.0 

func (s *HeadObjectOutput) SetWebsiteRedirectLocation(v string) *HeadObjectOutput

SetWebsiteRedirectLocation sets the WebsiteRedirectLocation field's value.

func (HeadObjectOutput) String added in v0.6.5 

func (s HeadObjectOutput) String() string

String returns the string representation

type IndexDocument 

type IndexDocument struct {

	// A suffix that is appended to a request that is for a directory on the website
	// endpoint (e.g. if the suffix is index.html and you make a request to samplebucket/images/
	// the data that is returned will be for the object with the key name images/index.html)
	// The suffix must not be empty and must not include a slash character.
	//
	// Suffix is a required field
	Suffix *string `type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (IndexDocument) GoString added in v0.6.5 

func (s IndexDocument) GoString() string

GoString returns the string representation

func (*IndexDocument) SetSuffix added in v1.5.0 

func (s *IndexDocument) SetSuffix(v string) *IndexDocument

SetSuffix sets the Suffix field's value.

func (IndexDocument) String added in v0.6.5 

func (s IndexDocument) String() string

String returns the string representation

func (*IndexDocument) Validate added in v1.1.21 

func (s *IndexDocument) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type Initiator 

type Initiator struct {

	// Name of the Principal.
	DisplayName *string `type:"string"`

	// If the principal is an AWS account, it provides the Canonical User ID. If
	// the principal is an IAM User, it provides a user ARN value.
	ID *string `type:"string"`
	// contains filtered or unexported fields
}

func (Initiator) GoString added in v0.6.5 

func (s Initiator) GoString() string

GoString returns the string representation

func (*Initiator) SetDisplayName added in v1.5.0 

func (s *Initiator) SetDisplayName(v string) *Initiator

SetDisplayName sets the DisplayName field's value.

func (*Initiator) SetID added in v1.5.0 

func (s *Initiator) SetID(v string) *Initiator

SetID sets the ID field's value.

func (Initiator) String added in v0.6.5 

func (s Initiator) String() string

String returns the string representation

type InputSerialization added in v1.12.36 

type InputSerialization struct {

	// Describes the serialization of a CSV-encoded object.
	CSV *CSVInput `type:"structure"`

	// Specifies object's compression format. Valid values: NONE, GZIP, BZIP2. Default
	// Value: NONE.
	CompressionType *string `type:"string" enum:"CompressionType"`

	// Specifies JSON as object's input serialization format.
	JSON *JSONInput `type:"structure"`

	// Specifies Parquet as object's input serialization format.
	Parquet *ParquetInput `type:"structure"`
	// contains filtered or unexported fields
}

Describes the serialization format of the object.

func (InputSerialization) GoString added in v1.12.36 

func (s InputSerialization) GoString() string

GoString returns the string representation

func (*InputSerialization) SetCSV added in v1.12.36 

func (s *InputSerialization) SetCSV(v *CSVInput) *InputSerialization

SetCSV sets the CSV field's value.

func (*InputSerialization) SetCompressionType added in v1.13.28 

func (s *InputSerialization) SetCompressionType(v string) *InputSerialization

SetCompressionType sets the CompressionType field's value.

func (*InputSerialization) SetJSON added in v1.13.28 

func (s *InputSerialization) SetJSON(v *JSONInput) *InputSerialization

SetJSON sets the JSON field's value.

func (*InputSerialization) SetParquet added in v1.15.28 

func (s *InputSerialization) SetParquet(v *ParquetInput) *InputSerialization

SetParquet sets the Parquet field's value.

func (InputSerialization) String added in v1.12.36 

func (s InputSerialization) String() string

String returns the string representation

type InventoryConfiguration added in v1.5.11 

type InventoryConfiguration struct {

	// Contains information about where to publish the inventory results.
	//
	// Destination is a required field
	Destination *InventoryDestination `type:"structure" required:"true"`

	// Specifies an inventory filter. The inventory only includes objects that meet
	// the filter's criteria.
	Filter *InventoryFilter `type:"structure"`

	// The ID used to identify the inventory configuration.
	//
	// Id is a required field
	Id *string `type:"string" required:"true"`

	// Specifies which object version(s) to included in the inventory results.
	//
	// IncludedObjectVersions is a required field
	IncludedObjectVersions *string `type:"string" required:"true" enum:"InventoryIncludedObjectVersions"`

	// Specifies whether the inventory is enabled or disabled.
	//
	// IsEnabled is a required field
	IsEnabled *bool `type:"boolean" required:"true"`

	// Contains the optional fields that are included in the inventory results.
	OptionalFields []*string `locationNameList:"Field" type:"list"`

	// Specifies the schedule for generating inventory results.
	//
	// Schedule is a required field
	Schedule *InventorySchedule `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

func (InventoryConfiguration) GoString added in v1.5.11 

func (s InventoryConfiguration) GoString() string

GoString returns the string representation

func (*InventoryConfiguration) SetDestination added in v1.5.11 

func (s *InventoryConfiguration) SetDestination(v *InventoryDestination) *InventoryConfiguration

SetDestination sets the Destination field's value.

func (*InventoryConfiguration) SetFilter added in v1.5.11 

func (s *InventoryConfiguration) SetFilter(v *InventoryFilter) *InventoryConfiguration

SetFilter sets the Filter field's value.

func (*InventoryConfiguration) SetId added in v1.5.11 

func (s *InventoryConfiguration) SetId(v string) *InventoryConfiguration

SetId sets the Id field's value.

func (*InventoryConfiguration) SetIncludedObjectVersions added in v1.5.11 

func (s *InventoryConfiguration) SetIncludedObjectVersions(v string) *InventoryConfiguration

SetIncludedObjectVersions sets the IncludedObjectVersions field's value.

func (*InventoryConfiguration) SetIsEnabled added in v1.5.11 

func (s *InventoryConfiguration) SetIsEnabled(v bool) *InventoryConfiguration

SetIsEnabled sets the IsEnabled field's value.

func (*InventoryConfiguration) SetOptionalFields added in v1.5.11 

func (s *InventoryConfiguration) SetOptionalFields(v []*string) *InventoryConfiguration

SetOptionalFields sets the OptionalFields field's value.

func (*InventoryConfiguration) SetSchedule added in v1.5.11 

func (s *InventoryConfiguration) SetSchedule(v *InventorySchedule) *InventoryConfiguration

SetSchedule sets the Schedule field's value.

func (InventoryConfiguration) String added in v1.5.11 

func (s InventoryConfiguration) String() string

String returns the string representation

func (*InventoryConfiguration) Validate added in v1.5.11 

func (s *InventoryConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type InventoryDestination added in v1.5.11 

type InventoryDestination struct {

	// Contains the bucket name, file format, bucket owner (optional), and prefix
	// (optional) where inventory results are published.
	//
	// S3BucketDestination is a required field
	S3BucketDestination *InventoryS3BucketDestination `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

func (InventoryDestination) GoString added in v1.5.11 

func (s InventoryDestination) GoString() string

GoString returns the string representation

func (*InventoryDestination) SetS3BucketDestination added in v1.5.11 

func (s *InventoryDestination) SetS3BucketDestination(v *InventoryS3BucketDestination) *InventoryDestination

SetS3BucketDestination sets the S3BucketDestination field's value.

func (InventoryDestination) String added in v1.5.11 

func (s InventoryDestination) String() string

String returns the string representation

func (*InventoryDestination) Validate added in v1.5.11 

func (s *InventoryDestination) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type InventoryEncryption added in v1.12.24 

type InventoryEncryption struct {

	// Specifies the use of SSE-KMS to encrypt delievered Inventory reports.
	SSEKMS *SSEKMS `locationName:"SSE-KMS" type:"structure"`

	// Specifies the use of SSE-S3 to encrypt delievered Inventory reports.
	SSES3 *SSES3 `locationName:"SSE-S3" type:"structure"`
	// contains filtered or unexported fields
}

Contains the type of server-side encryption used to encrypt the inventory results.

func (InventoryEncryption) GoString added in v1.12.24 

func (s InventoryEncryption) GoString() string

GoString returns the string representation

func (*InventoryEncryption) SetSSEKMS added in v1.12.24 

func (s *InventoryEncryption) SetSSEKMS(v *SSEKMS) *InventoryEncryption

SetSSEKMS sets the SSEKMS field's value.

func (*InventoryEncryption) SetSSES3 added in v1.12.24 

func (s *InventoryEncryption) SetSSES3(v *SSES3) *InventoryEncryption

SetSSES3 sets the SSES3 field's value.

func (InventoryEncryption) String added in v1.12.24 

func (s InventoryEncryption) String() string

String returns the string representation

func (*InventoryEncryption) Validate added in v1.12.24 

func (s *InventoryEncryption) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type InventoryFilter added in v1.5.11 

type InventoryFilter struct {

	// The prefix that an object must have to be included in the inventory results.
	//
	// Prefix is a required field
	Prefix *string `type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (InventoryFilter) GoString added in v1.5.11 

func (s InventoryFilter) GoString() string

GoString returns the string representation

func (*InventoryFilter) SetPrefix added in v1.5.11 

func (s *InventoryFilter) SetPrefix(v string) *InventoryFilter

SetPrefix sets the Prefix field's value.

func (InventoryFilter) String added in v1.5.11 

func (s InventoryFilter) String() string

String returns the string representation

func (*InventoryFilter) Validate added in v1.5.11 

func (s *InventoryFilter) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type InventoryS3BucketDestination added in v1.5.11 

type InventoryS3BucketDestination struct {

	// The ID of the account that owns the destination bucket.
	AccountId *string `type:"string"`

	// The Amazon resource name (ARN) of the bucket where inventory results will
	// be published.
	//
	// Bucket is a required field
	Bucket *string `type:"string" required:"true"`

	// Contains the type of server-side encryption used to encrypt the inventory
	// results.
	Encryption *InventoryEncryption `type:"structure"`

	// Specifies the output format of the inventory results.
	//
	// Format is a required field
	Format *string `type:"string" required:"true" enum:"InventoryFormat"`

	// The prefix that is prepended to all inventory results.
	Prefix *string `type:"string"`
	// contains filtered or unexported fields
}

func (InventoryS3BucketDestination) GoString added in v1.5.11 

func (s InventoryS3BucketDestination) GoString() string

GoString returns the string representation

func (*InventoryS3BucketDestination) SetAccountId added in v1.5.11 

func (s *InventoryS3BucketDestination) SetAccountId(v string) *InventoryS3BucketDestination

SetAccountId sets the AccountId field's value.

func (*InventoryS3BucketDestination) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*InventoryS3BucketDestination) SetEncryption added in v1.12.24 

func (s *InventoryS3BucketDestination) SetEncryption(v *InventoryEncryption) *InventoryS3BucketDestination

SetEncryption sets the Encryption field's value.

func (*InventoryS3BucketDestination) SetFormat added in v1.5.11 

func (s *InventoryS3BucketDestination) SetFormat(v string) *InventoryS3BucketDestination

SetFormat sets the Format field's value.

func (*InventoryS3BucketDestination) SetPrefix added in v1.5.11 

func (s *InventoryS3BucketDestination) SetPrefix(v string) *InventoryS3BucketDestination

SetPrefix sets the Prefix field's value.

func (InventoryS3BucketDestination) String added in v1.5.11 

func (s InventoryS3BucketDestination) String() string

String returns the string representation

func (*InventoryS3BucketDestination) Validate added in v1.5.11 

func (s *InventoryS3BucketDestination) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type InventorySchedule added in v1.5.11 

type InventorySchedule struct {

	// Specifies how frequently inventory results are produced.
	//
	// Frequency is a required field
	Frequency *string `type:"string" required:"true" enum:"InventoryFrequency"`
	// contains filtered or unexported fields
}

func (InventorySchedule) GoString added in v1.5.11 

func (s InventorySchedule) GoString() string

GoString returns the string representation

func (*InventorySchedule) SetFrequency added in v1.5.11 

func (s *InventorySchedule) SetFrequency(v string) *InventorySchedule

SetFrequency sets the Frequency field's value.

func (InventorySchedule) String added in v1.5.11 

func (s InventorySchedule) String() string

String returns the string representation

func (*InventorySchedule) Validate added in v1.5.11 

func (s *InventorySchedule) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type JSONInput added in v1.13.28 

type JSONInput struct {

	// The type of JSON. Valid values: Document, Lines.
	Type *string `type:"string" enum:"JSONType"`
	// contains filtered or unexported fields
}

func (JSONInput) GoString added in v1.13.28 

func (s JSONInput) GoString() string

GoString returns the string representation

func (*JSONInput) SetType added in v1.13.28 

func (s *JSONInput) SetType(v string) *JSONInput

SetType sets the Type field's value.

func (JSONInput) String added in v1.13.28 

func (s JSONInput) String() string

String returns the string representation

type JSONOutput added in v1.13.28 

type JSONOutput struct {

	// The value used to separate individual records in the output.
	RecordDelimiter *string `type:"string"`
	// contains filtered or unexported fields
}

func (JSONOutput) GoString added in v1.13.28 

func (s JSONOutput) GoString() string

GoString returns the string representation

func (*JSONOutput) SetRecordDelimiter added in v1.13.28 

func (s *JSONOutput) SetRecordDelimiter(v string) *JSONOutput

SetRecordDelimiter sets the RecordDelimiter field's value.

func (JSONOutput) String added in v1.13.28 

func (s JSONOutput) String() string

String returns the string representation

type KeyFilter added in v0.9.5 

type KeyFilter struct {

	// A list of containers for key value pair that defines the criteria for the
	// filter rule.
	FilterRules []*FilterRule `locationName:"FilterRule" type:"list" flattened:"true"`
	// contains filtered or unexported fields
}

Container for object key name prefix and suffix filtering rules.

func (KeyFilter) GoString added in v0.9.5 

func (s KeyFilter) GoString() string

GoString returns the string representation

func (*KeyFilter) SetFilterRules added in v1.5.0 

func (s *KeyFilter) SetFilterRules(v []*FilterRule) *KeyFilter

SetFilterRules sets the FilterRules field's value.

func (KeyFilter) String added in v0.9.5 

func (s KeyFilter) String() string

String returns the string representation

type LambdaFunctionConfiguration 

type LambdaFunctionConfiguration struct {

	// Events is a required field
	Events []*string `locationName:"Event" type:"list" flattened:"true" required:"true"`

	// Container for object key name filtering rules. For information about key
	// name filtering, go to Configuring Event Notifications (http://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html)
	// in the Amazon Simple Storage Service Developer Guide.
	Filter *NotificationConfigurationFilter `type:"structure"`

	// Optional unique identifier for configurations in a notification configuration.
	// If you don't provide one, Amazon S3 will assign an ID.
	Id *string `type:"string"`

	// Lambda cloud function ARN that Amazon S3 can invoke when it detects events
	// of the specified type.
	//
	// LambdaFunctionArn is a required field
	LambdaFunctionArn *string `locationName:"CloudFunction" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Container for specifying the AWS Lambda notification configuration.

func (LambdaFunctionConfiguration) GoString added in v0.6.5 

func (s LambdaFunctionConfiguration) GoString() string

GoString returns the string representation

func (*LambdaFunctionConfiguration) SetEvents added in v1.5.0 

func (s *LambdaFunctionConfiguration) SetEvents(v []*string) *LambdaFunctionConfiguration

SetEvents sets the Events field's value.

func (*LambdaFunctionConfiguration) SetFilter added in v1.5.0 

func (s *LambdaFunctionConfiguration) SetFilter(v *NotificationConfigurationFilter) *LambdaFunctionConfiguration

SetFilter sets the Filter field's value.

func (*LambdaFunctionConfiguration) SetId added in v1.5.0 

func (s *LambdaFunctionConfiguration) SetId(v string) *LambdaFunctionConfiguration

SetId sets the Id field's value.

func (*LambdaFunctionConfiguration) SetLambdaFunctionArn added in v1.5.0 

func (s *LambdaFunctionConfiguration) SetLambdaFunctionArn(v string) *LambdaFunctionConfiguration

SetLambdaFunctionArn sets the LambdaFunctionArn field's value.

func (LambdaFunctionConfiguration) String added in v0.6.5 

func (s LambdaFunctionConfiguration) String() string

String returns the string representation

func (*LambdaFunctionConfiguration) Validate added in v1.1.21 

func (s *LambdaFunctionConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type LifecycleConfiguration 

type LifecycleConfiguration struct {

	// Rules is a required field
	Rules []*Rule `locationName:"Rule" type:"list" flattened:"true" required:"true"`
	// contains filtered or unexported fields
}

func (LifecycleConfiguration) GoString added in v0.6.5 

func (s LifecycleConfiguration) GoString() string

GoString returns the string representation

func (*LifecycleConfiguration) SetRules added in v1.5.0 

func (s *LifecycleConfiguration) SetRules(v []*Rule) *LifecycleConfiguration

SetRules sets the Rules field's value.

func (LifecycleConfiguration) String added in v0.6.5 

func (s LifecycleConfiguration) String() string

String returns the string representation

func (*LifecycleConfiguration) Validate added in v1.1.21 

func (s *LifecycleConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type LifecycleExpiration 

type LifecycleExpiration struct {

	// Indicates at what date the object is to be moved or deleted. Should be in
	// GMT ISO 8601 Format.
	Date *time.Time `type:"timestamp" timestampFormat:"iso8601"`

	// Indicates the lifetime, in days, of the objects that are subject to the rule.
	// The value must be a non-zero positive integer.
	Days *int64 `type:"integer"`

	// Indicates whether Amazon S3 will remove a delete marker with no noncurrent
	// versions. If set to true, the delete marker will be expired; if set to false
	// the policy takes no action. This cannot be specified with Days or Date in
	// a Lifecycle Expiration Policy.
	ExpiredObjectDeleteMarker *bool `type:"boolean"`
	// contains filtered or unexported fields
}

func (LifecycleExpiration) GoString added in v0.6.5 

func (s LifecycleExpiration) GoString() string

GoString returns the string representation

func (*LifecycleExpiration) SetDate added in v1.5.0 

func (s *LifecycleExpiration) SetDate(v time.Time) *LifecycleExpiration

SetDate sets the Date field's value.

func (*LifecycleExpiration) SetDays added in v1.5.0 

func (s *LifecycleExpiration) SetDays(v int64) *LifecycleExpiration

SetDays sets the Days field's value.

func (*LifecycleExpiration) SetExpiredObjectDeleteMarker added in v1.5.0 

func (s *LifecycleExpiration) SetExpiredObjectDeleteMarker(v bool) *LifecycleExpiration

SetExpiredObjectDeleteMarker sets the ExpiredObjectDeleteMarker field's value.

func (LifecycleExpiration) String added in v0.6.5 

func (s LifecycleExpiration) String() string

String returns the string representation

type LifecycleRule 

type LifecycleRule struct {

	// Specifies the days since the initiation of an Incomplete Multipart Upload
	// that Lifecycle will wait before permanently removing all parts of the upload.
	AbortIncompleteMultipartUpload *AbortIncompleteMultipartUpload `type:"structure"`

	Expiration *LifecycleExpiration `type:"structure"`

	// The Filter is used to identify objects that a Lifecycle Rule applies to.
	// A Filter must have exactly one of Prefix, Tag, or And specified.
	Filter *LifecycleRuleFilter `type:"structure"`

	// Unique identifier for the rule. The value cannot be longer than 255 characters.
	ID *string `type:"string"`

	// Specifies when noncurrent object versions expire. Upon expiration, Amazon
	// S3 permanently deletes the noncurrent object versions. You set this lifecycle
	// configuration action on a bucket that has versioning enabled (or suspended)
	// to request that Amazon S3 delete noncurrent object versions at a specific
	// period in the object's lifetime.
	NoncurrentVersionExpiration *NoncurrentVersionExpiration `type:"structure"`

	NoncurrentVersionTransitions []*NoncurrentVersionTransition `locationName:"NoncurrentVersionTransition" type:"list" flattened:"true"`

	// Prefix identifying one or more objects to which the rule applies. This is
	// deprecated; use Filter instead.
	//
	// Deprecated: Prefix has been deprecated
	Prefix *string `deprecated:"true" type:"string"`

	// If 'Enabled', the rule is currently being applied. If 'Disabled', the rule
	// is not currently being applied.
	//
	// Status is a required field
	Status *string `type:"string" required:"true" enum:"ExpirationStatus"`

	Transitions []*Transition `locationName:"Transition" type:"list" flattened:"true"`
	// contains filtered or unexported fields
}

func (LifecycleRule) GoString added in v0.6.5 

func (s LifecycleRule) GoString() string

GoString returns the string representation

func (*LifecycleRule) SetAbortIncompleteMultipartUpload added in v1.5.0 

func (s *LifecycleRule) SetAbortIncompleteMultipartUpload(v *AbortIncompleteMultipartUpload) *LifecycleRule

SetAbortIncompleteMultipartUpload sets the AbortIncompleteMultipartUpload field's value.

func (*LifecycleRule) SetExpiration added in v1.5.0 

func (s *LifecycleRule) SetExpiration(v *LifecycleExpiration) *LifecycleRule

SetExpiration sets the Expiration field's value.

func (*LifecycleRule) SetFilter added in v1.5.11 

func (s *LifecycleRule) SetFilter(v *LifecycleRuleFilter) *LifecycleRule

SetFilter sets the Filter field's value.

func (*LifecycleRule) SetID added in v1.5.0 

func (s *LifecycleRule) SetID(v string) *LifecycleRule

SetID sets the ID field's value.

func (*LifecycleRule) SetNoncurrentVersionExpiration added in v1.5.0 

func (s *LifecycleRule) SetNoncurrentVersionExpiration(v *NoncurrentVersionExpiration) *LifecycleRule

SetNoncurrentVersionExpiration sets the NoncurrentVersionExpiration field's value.

func (*LifecycleRule) SetNoncurrentVersionTransitions added in v1.5.0 

func (s *LifecycleRule) SetNoncurrentVersionTransitions(v []*NoncurrentVersionTransition) *LifecycleRule

SetNoncurrentVersionTransitions sets the NoncurrentVersionTransitions field's value.

func (*LifecycleRule) SetPrefix added in v1.5.0 

func (s *LifecycleRule) SetPrefix(v string) *LifecycleRule

SetPrefix sets the Prefix field's value.

func (*LifecycleRule) SetStatus added in v1.5.0 

func (s *LifecycleRule) SetStatus(v string) *LifecycleRule

SetStatus sets the Status field's value.

func (*LifecycleRule) SetTransitions added in v1.5.0 

func (s *LifecycleRule) SetTransitions(v []*Transition) *LifecycleRule

SetTransitions sets the Transitions field's value.

func (LifecycleRule) String added in v0.6.5 

func (s LifecycleRule) String() string

String returns the string representation

func (*LifecycleRule) Validate added in v1.1.21 

func (s *LifecycleRule) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type LifecycleRuleAndOperator added in v1.5.11 

type LifecycleRuleAndOperator struct {
	Prefix *string `type:"string"`

	// All of these tags must exist in the object's tag set in order for the rule
	// to apply.
	Tags []*Tag `locationName:"Tag" locationNameList:"Tag" type:"list" flattened:"true"`
	// contains filtered or unexported fields
}

This is used in a Lifecycle Rule Filter to apply a logical AND to two or more predicates. The Lifecycle Rule will apply to any object matching all of the predicates configured inside the And operator.

func (LifecycleRuleAndOperator) GoString added in v1.5.11 

func (s LifecycleRuleAndOperator) GoString() string

GoString returns the string representation

func (*LifecycleRuleAndOperator) SetPrefix added in v1.5.11 

func (s *LifecycleRuleAndOperator) SetPrefix(v string) *LifecycleRuleAndOperator

SetPrefix sets the Prefix field's value.

func (*LifecycleRuleAndOperator) SetTags added in v1.5.11 

func (s *LifecycleRuleAndOperator) SetTags(v []*Tag) *LifecycleRuleAndOperator

SetTags sets the Tags field's value.

func (LifecycleRuleAndOperator) String added in v1.5.11 

func (s LifecycleRuleAndOperator) String() string

String returns the string representation

func (*LifecycleRuleAndOperator) Validate added in v1.5.11 

func (s *LifecycleRuleAndOperator) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type LifecycleRuleFilter added in v1.5.11 

type LifecycleRuleFilter struct {

	// This is used in a Lifecycle Rule Filter to apply a logical AND to two or
	// more predicates. The Lifecycle Rule will apply to any object matching all
	// of the predicates configured inside the And operator.
	And *LifecycleRuleAndOperator `type:"structure"`

	// Prefix identifying one or more objects to which the rule applies.
	Prefix *string `type:"string"`

	// This tag must exist in the object's tag set in order for the rule to apply.
	Tag *Tag `type:"structure"`
	// contains filtered or unexported fields
}

The Filter is used to identify objects that a Lifecycle Rule applies to. A Filter must have exactly one of Prefix, Tag, or And specified.

func (LifecycleRuleFilter) GoString added in v1.5.11 

func (s LifecycleRuleFilter) GoString() string

GoString returns the string representation

func (*LifecycleRuleFilter) SetAnd added in v1.5.11 

func (s *LifecycleRuleFilter) SetAnd(v *LifecycleRuleAndOperator) *LifecycleRuleFilter

SetAnd sets the And field's value.

func (*LifecycleRuleFilter) SetPrefix added in v1.5.11 

func (s *LifecycleRuleFilter) SetPrefix(v string) *LifecycleRuleFilter

SetPrefix sets the Prefix field's value.

func (*LifecycleRuleFilter) SetTag added in v1.5.11 

func (s *LifecycleRuleFilter) SetTag(v *Tag) *LifecycleRuleFilter

SetTag sets the Tag field's value.

func (LifecycleRuleFilter) String added in v1.5.11 

func (s LifecycleRuleFilter) String() string

String returns the string representation

func (*LifecycleRuleFilter) Validate added in v1.5.11 

func (s *LifecycleRuleFilter) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListBucketAnalyticsConfigurationsInput added in v1.5.11 

type ListBucketAnalyticsConfigurationsInput struct {

	// The name of the bucket from which analytics configurations are retrieved.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// The ContinuationToken that represents a placeholder from where this request
	// should begin.
	ContinuationToken *string `location:"querystring" locationName:"continuation-token" type:"string"`
	// contains filtered or unexported fields
}

func (ListBucketAnalyticsConfigurationsInput) GoString added in v1.5.11 

func (s ListBucketAnalyticsConfigurationsInput) GoString() string

GoString returns the string representation

func (*ListBucketAnalyticsConfigurationsInput) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*ListBucketAnalyticsConfigurationsInput) SetContinuationToken added in v1.5.11 

func (s *ListBucketAnalyticsConfigurationsInput) SetContinuationToken(v string) *ListBucketAnalyticsConfigurationsInput

SetContinuationToken sets the ContinuationToken field's value.

func (ListBucketAnalyticsConfigurationsInput) String added in v1.5.11 

func (s ListBucketAnalyticsConfigurationsInput) String() string

String returns the string representation

func (*ListBucketAnalyticsConfigurationsInput) Validate added in v1.5.11 

func (s *ListBucketAnalyticsConfigurationsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListBucketAnalyticsConfigurationsOutput added in v1.5.11 

type ListBucketAnalyticsConfigurationsOutput struct {

	// The list of analytics configurations for a bucket.
	AnalyticsConfigurationList []*AnalyticsConfiguration `locationName:"AnalyticsConfiguration" type:"list" flattened:"true"`

	// The ContinuationToken that represents where this request began.
	ContinuationToken *string `type:"string"`

	// Indicates whether the returned list of analytics configurations is complete.
	// A value of true indicates that the list is not complete and the NextContinuationToken
	// will be provided for a subsequent request.
	IsTruncated *bool `type:"boolean"`

	// NextContinuationToken is sent when isTruncated is true, which indicates that
	// there are more analytics configurations to list. The next request must include
	// this NextContinuationToken. The token is obfuscated and is not a usable value.
	NextContinuationToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (ListBucketAnalyticsConfigurationsOutput) GoString added in v1.5.11 

func (s ListBucketAnalyticsConfigurationsOutput) GoString() string

GoString returns the string representation

func (*ListBucketAnalyticsConfigurationsOutput) SetAnalyticsConfigurationList added in v1.5.11 

func (s *ListBucketAnalyticsConfigurationsOutput) SetAnalyticsConfigurationList(v []*AnalyticsConfiguration) *ListBucketAnalyticsConfigurationsOutput

SetAnalyticsConfigurationList sets the AnalyticsConfigurationList field's value.

func (*ListBucketAnalyticsConfigurationsOutput) SetContinuationToken added in v1.5.11 

func (s *ListBucketAnalyticsConfigurationsOutput) SetContinuationToken(v string) *ListBucketAnalyticsConfigurationsOutput

SetContinuationToken sets the ContinuationToken field's value.

func (*ListBucketAnalyticsConfigurationsOutput) SetIsTruncated added in v1.5.11 

func (s *ListBucketAnalyticsConfigurationsOutput) SetIsTruncated(v bool) *ListBucketAnalyticsConfigurationsOutput

SetIsTruncated sets the IsTruncated field's value.

func (*ListBucketAnalyticsConfigurationsOutput) SetNextContinuationToken added in v1.5.11 

func (s *ListBucketAnalyticsConfigurationsOutput) SetNextContinuationToken(v string) *ListBucketAnalyticsConfigurationsOutput

SetNextContinuationToken sets the NextContinuationToken field's value.

func (ListBucketAnalyticsConfigurationsOutput) String added in v1.5.11 

func (s ListBucketAnalyticsConfigurationsOutput) String() string

String returns the string representation

type ListBucketInventoryConfigurationsInput added in v1.5.11 

type ListBucketInventoryConfigurationsInput struct {

	// The name of the bucket containing the inventory configurations to retrieve.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// The marker used to continue an inventory configuration listing that has been
	// truncated. Use the NextContinuationToken from a previously truncated list
	// response to continue the listing. The continuation token is an opaque value
	// that Amazon S3 understands.
	ContinuationToken *string `location:"querystring" locationName:"continuation-token" type:"string"`
	// contains filtered or unexported fields
}

func (ListBucketInventoryConfigurationsInput) GoString added in v1.5.11 

func (s ListBucketInventoryConfigurationsInput) GoString() string

GoString returns the string representation

func (*ListBucketInventoryConfigurationsInput) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*ListBucketInventoryConfigurationsInput) SetContinuationToken added in v1.5.11 

func (s *ListBucketInventoryConfigurationsInput) SetContinuationToken(v string) *ListBucketInventoryConfigurationsInput

SetContinuationToken sets the ContinuationToken field's value.

func (ListBucketInventoryConfigurationsInput) String added in v1.5.11 

func (s ListBucketInventoryConfigurationsInput) String() string

String returns the string representation

func (*ListBucketInventoryConfigurationsInput) Validate added in v1.5.11 

func (s *ListBucketInventoryConfigurationsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListBucketInventoryConfigurationsOutput added in v1.5.11 

type ListBucketInventoryConfigurationsOutput struct {

	// If sent in the request, the marker that is used as a starting point for this
	// inventory configuration list response.
	ContinuationToken *string `type:"string"`

	// The list of inventory configurations for a bucket.
	InventoryConfigurationList []*InventoryConfiguration `locationName:"InventoryConfiguration" type:"list" flattened:"true"`

	// Indicates whether the returned list of inventory configurations is truncated
	// in this response. A value of true indicates that the list is truncated.
	IsTruncated *bool `type:"boolean"`

	// The marker used to continue this inventory configuration listing. Use the
	// NextContinuationToken from this response to continue the listing in a subsequent
	// request. The continuation token is an opaque value that Amazon S3 understands.
	NextContinuationToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (ListBucketInventoryConfigurationsOutput) GoString added in v1.5.11 

func (s ListBucketInventoryConfigurationsOutput) GoString() string

GoString returns the string representation

func (*ListBucketInventoryConfigurationsOutput) SetContinuationToken added in v1.5.11 

func (s *ListBucketInventoryConfigurationsOutput) SetContinuationToken(v string) *ListBucketInventoryConfigurationsOutput

SetContinuationToken sets the ContinuationToken field's value.

func (*ListBucketInventoryConfigurationsOutput) SetInventoryConfigurationList added in v1.5.11 

func (s *ListBucketInventoryConfigurationsOutput) SetInventoryConfigurationList(v []*InventoryConfiguration) *ListBucketInventoryConfigurationsOutput

SetInventoryConfigurationList sets the InventoryConfigurationList field's value.

func (*ListBucketInventoryConfigurationsOutput) SetIsTruncated added in v1.5.11 

func (s *ListBucketInventoryConfigurationsOutput) SetIsTruncated(v bool) *ListBucketInventoryConfigurationsOutput

SetIsTruncated sets the IsTruncated field's value.

func (*ListBucketInventoryConfigurationsOutput) SetNextContinuationToken added in v1.5.11 

func (s *ListBucketInventoryConfigurationsOutput) SetNextContinuationToken(v string) *ListBucketInventoryConfigurationsOutput

SetNextContinuationToken sets the NextContinuationToken field's value.

func (ListBucketInventoryConfigurationsOutput) String added in v1.5.11 

func (s ListBucketInventoryConfigurationsOutput) String() string

String returns the string representation

type ListBucketMetricsConfigurationsInput added in v1.5.11 

type ListBucketMetricsConfigurationsInput struct {

	// The name of the bucket containing the metrics configurations to retrieve.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// The marker that is used to continue a metrics configuration listing that
	// has been truncated. Use the NextContinuationToken from a previously truncated
	// list response to continue the listing. The continuation token is an opaque
	// value that Amazon S3 understands.
	ContinuationToken *string `location:"querystring" locationName:"continuation-token" type:"string"`
	// contains filtered or unexported fields
}

func (ListBucketMetricsConfigurationsInput) GoString added in v1.5.11 

func (s ListBucketMetricsConfigurationsInput) GoString() string

GoString returns the string representation

func (*ListBucketMetricsConfigurationsInput) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*ListBucketMetricsConfigurationsInput) SetContinuationToken added in v1.5.11 

func (s *ListBucketMetricsConfigurationsInput) SetContinuationToken(v string) *ListBucketMetricsConfigurationsInput

SetContinuationToken sets the ContinuationToken field's value.

func (ListBucketMetricsConfigurationsInput) String added in v1.5.11 

func (s ListBucketMetricsConfigurationsInput) String() string

String returns the string representation

func (*ListBucketMetricsConfigurationsInput) Validate added in v1.5.11 

func (s *ListBucketMetricsConfigurationsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListBucketMetricsConfigurationsOutput added in v1.5.11 

type ListBucketMetricsConfigurationsOutput struct {

	// The marker that is used as a starting point for this metrics configuration
	// list response. This value is present if it was sent in the request.
	ContinuationToken *string `type:"string"`

	// Indicates whether the returned list of metrics configurations is complete.
	// A value of true indicates that the list is not complete and the NextContinuationToken
	// will be provided for a subsequent request.
	IsTruncated *bool `type:"boolean"`

	// The list of metrics configurations for a bucket.
	MetricsConfigurationList []*MetricsConfiguration `locationName:"MetricsConfiguration" type:"list" flattened:"true"`

	// The marker used to continue a metrics configuration listing that has been
	// truncated. Use the NextContinuationToken from a previously truncated list
	// response to continue the listing. The continuation token is an opaque value
	// that Amazon S3 understands.
	NextContinuationToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (ListBucketMetricsConfigurationsOutput) GoString added in v1.5.11 

func (s ListBucketMetricsConfigurationsOutput) GoString() string

GoString returns the string representation

func (*ListBucketMetricsConfigurationsOutput) SetContinuationToken added in v1.5.11 

func (s *ListBucketMetricsConfigurationsOutput) SetContinuationToken(v string) *ListBucketMetricsConfigurationsOutput

SetContinuationToken sets the ContinuationToken field's value.

func (*ListBucketMetricsConfigurationsOutput) SetIsTruncated added in v1.5.11 

func (s *ListBucketMetricsConfigurationsOutput) SetIsTruncated(v bool) *ListBucketMetricsConfigurationsOutput

SetIsTruncated sets the IsTruncated field's value.

func (*ListBucketMetricsConfigurationsOutput) SetMetricsConfigurationList added in v1.5.11 

func (s *ListBucketMetricsConfigurationsOutput) SetMetricsConfigurationList(v []*MetricsConfiguration) *ListBucketMetricsConfigurationsOutput

SetMetricsConfigurationList sets the MetricsConfigurationList field's value.

func (*ListBucketMetricsConfigurationsOutput) SetNextContinuationToken added in v1.5.11 

func (s *ListBucketMetricsConfigurationsOutput) SetNextContinuationToken(v string) *ListBucketMetricsConfigurationsOutput

SetNextContinuationToken sets the NextContinuationToken field's value.

func (ListBucketMetricsConfigurationsOutput) String added in v1.5.11 

func (s ListBucketMetricsConfigurationsOutput) String() string

String returns the string representation

type ListBucketsInput 

type ListBucketsInput struct {
	// contains filtered or unexported fields
}

func (ListBucketsInput) GoString added in v0.6.5 

func (s ListBucketsInput) GoString() string

GoString returns the string representation

func (ListBucketsInput) String added in v0.6.5 

func (s ListBucketsInput) String() string

String returns the string representation

type ListBucketsOutput 

type ListBucketsOutput struct {
	Buckets []*Bucket `locationNameList:"Bucket" type:"list"`

	Owner *Owner `type:"structure"`
	// contains filtered or unexported fields
}

func (ListBucketsOutput) GoString added in v0.6.5 

func (s ListBucketsOutput) GoString() string

GoString returns the string representation

func (*ListBucketsOutput) SetBuckets added in v1.5.0 

func (s *ListBucketsOutput) SetBuckets(v []*Bucket) *ListBucketsOutput

SetBuckets sets the Buckets field's value.

func (*ListBucketsOutput) SetOwner added in v1.5.0 

func (s *ListBucketsOutput) SetOwner(v *Owner) *ListBucketsOutput

SetOwner sets the Owner field's value.

func (ListBucketsOutput) String added in v0.6.5 

func (s ListBucketsOutput) String() string

String returns the string representation

type ListMultipartUploadsInput 

type ListMultipartUploadsInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Character you use to group keys.
	Delimiter *string `location:"querystring" locationName:"delimiter" type:"string"`

	// Requests Amazon S3 to encode the object keys in the response and specifies
	// the encoding method to use. An object key may contain any Unicode character;
	// however, XML 1.0 parser cannot parse some characters, such as characters
	// with an ASCII value from 0 to 10. For characters that are not supported in
	// XML 1.0, you can add this parameter to request that Amazon S3 encode the
	// keys in the response.
	EncodingType *string `location:"querystring" locationName:"encoding-type" type:"string" enum:"EncodingType"`

	// Together with upload-id-marker, this parameter specifies the multipart upload
	// after which listing should begin.
	KeyMarker *string `location:"querystring" locationName:"key-marker" type:"string"`

	// Sets the maximum number of multipart uploads, from 1 to 1,000, to return
	// in the response body. 1,000 is the maximum number of uploads that can be
	// returned in a response.
	MaxUploads *int64 `location:"querystring" locationName:"max-uploads" type:"integer"`

	// Lists in-progress uploads only for those keys that begin with the specified
	// prefix.
	Prefix *string `location:"querystring" locationName:"prefix" type:"string"`

	// Together with key-marker, specifies the multipart upload after which listing
	// should begin. If key-marker is not specified, the upload-id-marker parameter
	// is ignored.
	UploadIdMarker *string `location:"querystring" locationName:"upload-id-marker" type:"string"`
	// contains filtered or unexported fields
}

func (ListMultipartUploadsInput) GoString added in v0.6.5 

func (s ListMultipartUploadsInput) GoString() string

GoString returns the string representation

func (*ListMultipartUploadsInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*ListMultipartUploadsInput) SetDelimiter added in v1.5.0 

func (s *ListMultipartUploadsInput) SetDelimiter(v string) *ListMultipartUploadsInput

SetDelimiter sets the Delimiter field's value.

func (*ListMultipartUploadsInput) SetEncodingType added in v1.5.0 

func (s *ListMultipartUploadsInput) SetEncodingType(v string) *ListMultipartUploadsInput

SetEncodingType sets the EncodingType field's value.

func (*ListMultipartUploadsInput) SetKeyMarker added in v1.5.0 

func (s *ListMultipartUploadsInput) SetKeyMarker(v string) *ListMultipartUploadsInput

SetKeyMarker sets the KeyMarker field's value.

func (*ListMultipartUploadsInput) SetMaxUploads added in v1.5.0 

func (s *ListMultipartUploadsInput) SetMaxUploads(v int64) *ListMultipartUploadsInput

SetMaxUploads sets the MaxUploads field's value.

func (*ListMultipartUploadsInput) SetPrefix added in v1.5.0 

func (s *ListMultipartUploadsInput) SetPrefix(v string) *ListMultipartUploadsInput

SetPrefix sets the Prefix field's value.

func (*ListMultipartUploadsInput) SetUploadIdMarker added in v1.5.0 

func (s *ListMultipartUploadsInput) SetUploadIdMarker(v string) *ListMultipartUploadsInput

SetUploadIdMarker sets the UploadIdMarker field's value.

func (ListMultipartUploadsInput) String added in v0.6.5 

func (s ListMultipartUploadsInput) String() string

String returns the string representation

func (*ListMultipartUploadsInput) Validate added in v1.1.21 

func (s *ListMultipartUploadsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListMultipartUploadsOutput 

type ListMultipartUploadsOutput struct {

	// Name of the bucket to which the multipart upload was initiated.
	Bucket *string `type:"string"`

	CommonPrefixes []*CommonPrefix `type:"list" flattened:"true"`

	Delimiter *string `type:"string"`

	// Encoding type used by Amazon S3 to encode object keys in the response.
	EncodingType *string `type:"string" enum:"EncodingType"`

	// Indicates whether the returned list of multipart uploads is truncated. A
	// value of true indicates that the list was truncated. The list can be truncated
	// if the number of multipart uploads exceeds the limit allowed or specified
	// by max uploads.
	IsTruncated *bool `type:"boolean"`

	// The key at or after which the listing began.
	KeyMarker *string `type:"string"`

	// Maximum number of multipart uploads that could have been included in the
	// response.
	MaxUploads *int64 `type:"integer"`

	// When a list is truncated, this element specifies the value that should be
	// used for the key-marker request parameter in a subsequent request.
	NextKeyMarker *string `type:"string"`

	// When a list is truncated, this element specifies the value that should be
	// used for the upload-id-marker request parameter in a subsequent request.
	NextUploadIdMarker *string `type:"string"`

	// When a prefix is provided in the request, this field contains the specified
	// prefix. The result contains only keys starting with the specified prefix.
	Prefix *string `type:"string"`

	// Upload ID after which listing began.
	UploadIdMarker *string `type:"string"`

	Uploads []*MultipartUpload `locationName:"Upload" type:"list" flattened:"true"`
	// contains filtered or unexported fields
}

func (ListMultipartUploadsOutput) GoString added in v0.6.5 

func (s ListMultipartUploadsOutput) GoString() string

GoString returns the string representation

func (*ListMultipartUploadsOutput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*ListMultipartUploadsOutput) SetCommonPrefixes added in v1.5.0 

func (s *ListMultipartUploadsOutput) SetCommonPrefixes(v []*CommonPrefix) *ListMultipartUploadsOutput

SetCommonPrefixes sets the CommonPrefixes field's value.

func (*ListMultipartUploadsOutput) SetDelimiter added in v1.5.0 

func (s *ListMultipartUploadsOutput) SetDelimiter(v string) *ListMultipartUploadsOutput

SetDelimiter sets the Delimiter field's value.

func (*ListMultipartUploadsOutput) SetEncodingType added in v1.5.0 

func (s *ListMultipartUploadsOutput) SetEncodingType(v string) *ListMultipartUploadsOutput

SetEncodingType sets the EncodingType field's value.

func (*ListMultipartUploadsOutput) SetIsTruncated added in v1.5.0 

func (s *ListMultipartUploadsOutput) SetIsTruncated(v bool) *ListMultipartUploadsOutput

SetIsTruncated sets the IsTruncated field's value.

func (*ListMultipartUploadsOutput) SetKeyMarker added in v1.5.0 

func (s *ListMultipartUploadsOutput) SetKeyMarker(v string) *ListMultipartUploadsOutput

SetKeyMarker sets the KeyMarker field's value.

func (*ListMultipartUploadsOutput) SetMaxUploads added in v1.5.0 

func (s *ListMultipartUploadsOutput) SetMaxUploads(v int64) *ListMultipartUploadsOutput

SetMaxUploads sets the MaxUploads field's value.

func (*ListMultipartUploadsOutput) SetNextKeyMarker added in v1.5.0 

func (s *ListMultipartUploadsOutput) SetNextKeyMarker(v string) *ListMultipartUploadsOutput

SetNextKeyMarker sets the NextKeyMarker field's value.

func (*ListMultipartUploadsOutput) SetNextUploadIdMarker added in v1.5.0 

func (s *ListMultipartUploadsOutput) SetNextUploadIdMarker(v string) *ListMultipartUploadsOutput

SetNextUploadIdMarker sets the NextUploadIdMarker field's value.

func (*ListMultipartUploadsOutput) SetPrefix added in v1.5.0 

func (s *ListMultipartUploadsOutput) SetPrefix(v string) *ListMultipartUploadsOutput

SetPrefix sets the Prefix field's value.

func (*ListMultipartUploadsOutput) SetUploadIdMarker added in v1.5.0 

func (s *ListMultipartUploadsOutput) SetUploadIdMarker(v string) *ListMultipartUploadsOutput

SetUploadIdMarker sets the UploadIdMarker field's value.

func (*ListMultipartUploadsOutput) SetUploads added in v1.5.0 

func (s *ListMultipartUploadsOutput) SetUploads(v []*MultipartUpload) *ListMultipartUploadsOutput

SetUploads sets the Uploads field's value.

func (ListMultipartUploadsOutput) String added in v0.6.5 

func (s ListMultipartUploadsOutput) String() string

String returns the string representation

type ListObjectVersionsInput 

type ListObjectVersionsInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// A delimiter is a character you use to group keys.
	Delimiter *string `location:"querystring" locationName:"delimiter" type:"string"`

	// Requests Amazon S3 to encode the object keys in the response and specifies
	// the encoding method to use. An object key may contain any Unicode character;
	// however, XML 1.0 parser cannot parse some characters, such as characters
	// with an ASCII value from 0 to 10. For characters that are not supported in
	// XML 1.0, you can add this parameter to request that Amazon S3 encode the
	// keys in the response.
	EncodingType *string `location:"querystring" locationName:"encoding-type" type:"string" enum:"EncodingType"`

	// Specifies the key to start with when listing objects in a bucket.
	KeyMarker *string `location:"querystring" locationName:"key-marker" type:"string"`

	// Sets the maximum number of keys returned in the response. The response might
	// contain fewer keys but will never contain more.
	MaxKeys *int64 `location:"querystring" locationName:"max-keys" type:"integer"`

	// Limits the response to keys that begin with the specified prefix.
	Prefix *string `location:"querystring" locationName:"prefix" type:"string"`

	// Specifies the object version you want to start listing from.
	VersionIdMarker *string `location:"querystring" locationName:"version-id-marker" type:"string"`
	// contains filtered or unexported fields
}

func (ListObjectVersionsInput) GoString added in v0.6.5 

func (s ListObjectVersionsInput) GoString() string

GoString returns the string representation

func (*ListObjectVersionsInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*ListObjectVersionsInput) SetDelimiter added in v1.5.0 

func (s *ListObjectVersionsInput) SetDelimiter(v string) *ListObjectVersionsInput

SetDelimiter sets the Delimiter field's value.

func (*ListObjectVersionsInput) SetEncodingType added in v1.5.0 

func (s *ListObjectVersionsInput) SetEncodingType(v string) *ListObjectVersionsInput

SetEncodingType sets the EncodingType field's value.

func (*ListObjectVersionsInput) SetKeyMarker added in v1.5.0 

func (s *ListObjectVersionsInput) SetKeyMarker(v string) *ListObjectVersionsInput

SetKeyMarker sets the KeyMarker field's value.

func (*ListObjectVersionsInput) SetMaxKeys added in v1.5.0 

func (s *ListObjectVersionsInput) SetMaxKeys(v int64) *ListObjectVersionsInput

SetMaxKeys sets the MaxKeys field's value.

func (*ListObjectVersionsInput) SetPrefix added in v1.5.0 

func (s *ListObjectVersionsInput) SetPrefix(v string) *ListObjectVersionsInput

SetPrefix sets the Prefix field's value.

func (*ListObjectVersionsInput) SetVersionIdMarker added in v1.5.0 

func (s *ListObjectVersionsInput) SetVersionIdMarker(v string) *ListObjectVersionsInput

SetVersionIdMarker sets the VersionIdMarker field's value.

func (ListObjectVersionsInput) String added in v0.6.5 

func (s ListObjectVersionsInput) String() string

String returns the string representation

func (*ListObjectVersionsInput) Validate added in v1.1.21 

func (s *ListObjectVersionsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListObjectVersionsOutput 

type ListObjectVersionsOutput struct {
	CommonPrefixes []*CommonPrefix `type:"list" flattened:"true"`

	DeleteMarkers []*DeleteMarkerEntry `locationName:"DeleteMarker" type:"list" flattened:"true"`

	Delimiter *string `type:"string"`

	// Encoding type used by Amazon S3 to encode object keys in the response.
	EncodingType *string `type:"string" enum:"EncodingType"`

	// A flag that indicates whether or not Amazon S3 returned all of the results
	// that satisfied the search criteria. If your results were truncated, you can
	// make a follow-up paginated request using the NextKeyMarker and NextVersionIdMarker
	// response parameters as a starting place in another request to return the
	// rest of the results.
	IsTruncated *bool `type:"boolean"`

	// Marks the last Key returned in a truncated response.
	KeyMarker *string `type:"string"`

	MaxKeys *int64 `type:"integer"`

	Name *string `type:"string"`

	// Use this value for the key marker request parameter in a subsequent request.
	NextKeyMarker *string `type:"string"`

	// Use this value for the next version id marker parameter in a subsequent request.
	NextVersionIdMarker *string `type:"string"`

	Prefix *string `type:"string"`

	VersionIdMarker *string `type:"string"`

	Versions []*ObjectVersion `locationName:"Version" type:"list" flattened:"true"`
	// contains filtered or unexported fields
}

func (ListObjectVersionsOutput) GoString added in v0.6.5 

func (s ListObjectVersionsOutput) GoString() string

GoString returns the string representation

func (*ListObjectVersionsOutput) SetCommonPrefixes added in v1.5.0 

func (s *ListObjectVersionsOutput) SetCommonPrefixes(v []*CommonPrefix) *ListObjectVersionsOutput

SetCommonPrefixes sets the CommonPrefixes field's value.

func (*ListObjectVersionsOutput) SetDeleteMarkers added in v1.5.0 

func (s *ListObjectVersionsOutput) SetDeleteMarkers(v []*DeleteMarkerEntry) *ListObjectVersionsOutput

SetDeleteMarkers sets the DeleteMarkers field's value.

func (*ListObjectVersionsOutput) SetDelimiter added in v1.5.0 

func (s *ListObjectVersionsOutput) SetDelimiter(v string) *ListObjectVersionsOutput

SetDelimiter sets the Delimiter field's value.

func (*ListObjectVersionsOutput) SetEncodingType added in v1.5.0 

func (s *ListObjectVersionsOutput) SetEncodingType(v string) *ListObjectVersionsOutput

SetEncodingType sets the EncodingType field's value.

func (*ListObjectVersionsOutput) SetIsTruncated added in v1.5.0 

func (s *ListObjectVersionsOutput) SetIsTruncated(v bool) *ListObjectVersionsOutput

SetIsTruncated sets the IsTruncated field's value.

func (*ListObjectVersionsOutput) SetKeyMarker added in v1.5.0 

func (s *ListObjectVersionsOutput) SetKeyMarker(v string) *ListObjectVersionsOutput

SetKeyMarker sets the KeyMarker field's value.

func (*ListObjectVersionsOutput) SetMaxKeys added in v1.5.0 

func (s *ListObjectVersionsOutput) SetMaxKeys(v int64) *ListObjectVersionsOutput

SetMaxKeys sets the MaxKeys field's value.

func (*ListObjectVersionsOutput) SetName added in v1.5.0 

func (s *ListObjectVersionsOutput) SetName(v string) *ListObjectVersionsOutput

SetName sets the Name field's value.

func (*ListObjectVersionsOutput) SetNextKeyMarker added in v1.5.0 

func (s *ListObjectVersionsOutput) SetNextKeyMarker(v string) *ListObjectVersionsOutput

SetNextKeyMarker sets the NextKeyMarker field's value.

func (*ListObjectVersionsOutput) SetNextVersionIdMarker added in v1.5.0 

func (s *ListObjectVersionsOutput) SetNextVersionIdMarker(v string) *ListObjectVersionsOutput

SetNextVersionIdMarker sets the NextVersionIdMarker field's value.

func (*ListObjectVersionsOutput) SetPrefix added in v1.5.0 

func (s *ListObjectVersionsOutput) SetPrefix(v string) *ListObjectVersionsOutput

SetPrefix sets the Prefix field's value.

func (*ListObjectVersionsOutput) SetVersionIdMarker added in v1.5.0 

func (s *ListObjectVersionsOutput) SetVersionIdMarker(v string) *ListObjectVersionsOutput

SetVersionIdMarker sets the VersionIdMarker field's value.

func (*ListObjectVersionsOutput) SetVersions added in v1.5.0 

func (s *ListObjectVersionsOutput) SetVersions(v []*ObjectVersion) *ListObjectVersionsOutput

SetVersions sets the Versions field's value.

func (ListObjectVersionsOutput) String added in v0.6.5 

func (s ListObjectVersionsOutput) String() string

String returns the string representation

type ListObjectsInput 

type ListObjectsInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// A delimiter is a character you use to group keys.
	Delimiter *string `location:"querystring" locationName:"delimiter" type:"string"`

	// Requests Amazon S3 to encode the object keys in the response and specifies
	// the encoding method to use. An object key may contain any Unicode character;
	// however, XML 1.0 parser cannot parse some characters, such as characters
	// with an ASCII value from 0 to 10. For characters that are not supported in
	// XML 1.0, you can add this parameter to request that Amazon S3 encode the
	// keys in the response.
	EncodingType *string `location:"querystring" locationName:"encoding-type" type:"string" enum:"EncodingType"`

	// Specifies the key to start with when listing objects in a bucket.
	Marker *string `location:"querystring" locationName:"marker" type:"string"`

	// Sets the maximum number of keys returned in the response. The response might
	// contain fewer keys but will never contain more.
	MaxKeys *int64 `location:"querystring" locationName:"max-keys" type:"integer"`

	// Limits the response to keys that begin with the specified prefix.
	Prefix *string `location:"querystring" locationName:"prefix" type:"string"`

	// Confirms that the requester knows that she or he will be charged for the
	// list objects request. Bucket owners need not specify this parameter in their
	// requests.
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
	// contains filtered or unexported fields
}

func (ListObjectsInput) GoString added in v0.6.5 

func (s ListObjectsInput) GoString() string

GoString returns the string representation

func (*ListObjectsInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*ListObjectsInput) SetDelimiter added in v1.5.0 

func (s *ListObjectsInput) SetDelimiter(v string) *ListObjectsInput

SetDelimiter sets the Delimiter field's value.

func (*ListObjectsInput) SetEncodingType added in v1.5.0 

func (s *ListObjectsInput) SetEncodingType(v string) *ListObjectsInput

SetEncodingType sets the EncodingType field's value.

func (*ListObjectsInput) SetMarker added in v1.5.0 

func (s *ListObjectsInput) SetMarker(v string) *ListObjectsInput

SetMarker sets the Marker field's value.

func (*ListObjectsInput) SetMaxKeys added in v1.5.0 

func (s *ListObjectsInput) SetMaxKeys(v int64) *ListObjectsInput

SetMaxKeys sets the MaxKeys field's value.

func (*ListObjectsInput) SetPrefix added in v1.5.0 

func (s *ListObjectsInput) SetPrefix(v string) *ListObjectsInput

SetPrefix sets the Prefix field's value.

func (*ListObjectsInput) SetRequestPayer added in v1.5.0 

func (s *ListObjectsInput) SetRequestPayer(v string) *ListObjectsInput

SetRequestPayer sets the RequestPayer field's value.

func (ListObjectsInput) String added in v0.6.5 

func (s ListObjectsInput) String() string

String returns the string representation

func (*ListObjectsInput) Validate added in v1.1.21 

func (s *ListObjectsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListObjectsOutput 

type ListObjectsOutput struct {
	CommonPrefixes []*CommonPrefix `type:"list" flattened:"true"`

	Contents []*Object `type:"list" flattened:"true"`

	Delimiter *string `type:"string"`

	// Encoding type used by Amazon S3 to encode object keys in the response.
	EncodingType *string `type:"string" enum:"EncodingType"`

	// A flag that indicates whether or not Amazon S3 returned all of the results
	// that satisfied the search criteria.
	IsTruncated *bool `type:"boolean"`

	Marker *string `type:"string"`

	MaxKeys *int64 `type:"integer"`

	Name *string `type:"string"`

	// When response is truncated (the IsTruncated element value in the response
	// is true), you can use the key name in this field as marker in the subsequent
	// request to get next set of objects. Amazon S3 lists objects in alphabetical
	// order Note: This element is returned only if you have delimiter request parameter
	// specified. If response does not include the NextMaker and it is truncated,
	// you can use the value of the last Key in the response as the marker in the
	// subsequent request to get the next set of object keys.
	NextMarker *string `type:"string"`

	Prefix *string `type:"string"`
	// contains filtered or unexported fields
}

func (ListObjectsOutput) GoString added in v0.6.5 

func (s ListObjectsOutput) GoString() string

GoString returns the string representation

func (*ListObjectsOutput) SetCommonPrefixes added in v1.5.0 

func (s *ListObjectsOutput) SetCommonPrefixes(v []*CommonPrefix) *ListObjectsOutput

SetCommonPrefixes sets the CommonPrefixes field's value.

func (*ListObjectsOutput) SetContents added in v1.5.0 

func (s *ListObjectsOutput) SetContents(v []*Object) *ListObjectsOutput

SetContents sets the Contents field's value.

func (*ListObjectsOutput) SetDelimiter added in v1.5.0 

func (s *ListObjectsOutput) SetDelimiter(v string) *ListObjectsOutput

SetDelimiter sets the Delimiter field's value.

func (*ListObjectsOutput) SetEncodingType added in v1.5.0 

func (s *ListObjectsOutput) SetEncodingType(v string) *ListObjectsOutput

SetEncodingType sets the EncodingType field's value.

func (*ListObjectsOutput) SetIsTruncated added in v1.5.0 

func (s *ListObjectsOutput) SetIsTruncated(v bool) *ListObjectsOutput

SetIsTruncated sets the IsTruncated field's value.

func (*ListObjectsOutput) SetMarker added in v1.5.0 

func (s *ListObjectsOutput) SetMarker(v string) *ListObjectsOutput

SetMarker sets the Marker field's value.

func (*ListObjectsOutput) SetMaxKeys added in v1.5.0 

func (s *ListObjectsOutput) SetMaxKeys(v int64) *ListObjectsOutput

SetMaxKeys sets the MaxKeys field's value.

func (*ListObjectsOutput) SetName added in v1.5.0 

func (s *ListObjectsOutput) SetName(v string) *ListObjectsOutput

SetName sets the Name field's value.

func (*ListObjectsOutput) SetNextMarker added in v1.5.0 

func (s *ListObjectsOutput) SetNextMarker(v string) *ListObjectsOutput

SetNextMarker sets the NextMarker field's value.

func (*ListObjectsOutput) SetPrefix added in v1.5.0 

func (s *ListObjectsOutput) SetPrefix(v string) *ListObjectsOutput

SetPrefix sets the Prefix field's value.

func (ListObjectsOutput) String added in v0.6.5 

func (s ListObjectsOutput) String() string

String returns the string representation

type ListObjectsV2Input added in v1.1.24 

type ListObjectsV2Input struct {

	// Name of the bucket to list.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// ContinuationToken indicates Amazon S3 that the list is being continued on
	// this bucket with a token. ContinuationToken is obfuscated and is not a real
	// key
	ContinuationToken *string `location:"querystring" locationName:"continuation-token" type:"string"`

	// A delimiter is a character you use to group keys.
	Delimiter *string `location:"querystring" locationName:"delimiter" type:"string"`

	// Encoding type used by Amazon S3 to encode object keys in the response.
	EncodingType *string `location:"querystring" locationName:"encoding-type" type:"string" enum:"EncodingType"`

	// The owner field is not present in listV2 by default, if you want to return
	// owner field with each key in the result then set the fetch owner field to
	// true
	FetchOwner *bool `location:"querystring" locationName:"fetch-owner" type:"boolean"`

	// Sets the maximum number of keys returned in the response. The response might
	// contain fewer keys but will never contain more.
	MaxKeys *int64 `location:"querystring" locationName:"max-keys" type:"integer"`

	// Limits the response to keys that begin with the specified prefix.
	Prefix *string `location:"querystring" locationName:"prefix" type:"string"`

	// Confirms that the requester knows that she or he will be charged for the
	// list objects request in V2 style. Bucket owners need not specify this parameter
	// in their requests.
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`

	// StartAfter is where you want Amazon S3 to start listing from. Amazon S3 starts
	// listing after this specified key. StartAfter can be any key in the bucket
	StartAfter *string `location:"querystring" locationName:"start-after" type:"string"`
	// contains filtered or unexported fields
}

func (ListObjectsV2Input) GoString added in v1.1.24 

func (s ListObjectsV2Input) GoString() string

GoString returns the string representation

func (*ListObjectsV2Input) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*ListObjectsV2Input) SetContinuationToken added in v1.5.0 

func (s *ListObjectsV2Input) SetContinuationToken(v string) *ListObjectsV2Input

SetContinuationToken sets the ContinuationToken field's value.

func (*ListObjectsV2Input) SetDelimiter added in v1.5.0 

func (s *ListObjectsV2Input) SetDelimiter(v string) *ListObjectsV2Input

SetDelimiter sets the Delimiter field's value.

func (*ListObjectsV2Input) SetEncodingType added in v1.5.0 

func (s *ListObjectsV2Input) SetEncodingType(v string) *ListObjectsV2Input

SetEncodingType sets the EncodingType field's value.

func (*ListObjectsV2Input) SetFetchOwner added in v1.5.0 

func (s *ListObjectsV2Input) SetFetchOwner(v bool) *ListObjectsV2Input

SetFetchOwner sets the FetchOwner field's value.

func (*ListObjectsV2Input) SetMaxKeys added in v1.5.0 

func (s *ListObjectsV2Input) SetMaxKeys(v int64) *ListObjectsV2Input

SetMaxKeys sets the MaxKeys field's value.

func (*ListObjectsV2Input) SetPrefix added in v1.5.0 

func (s *ListObjectsV2Input) SetPrefix(v string) *ListObjectsV2Input

SetPrefix sets the Prefix field's value.

func (*ListObjectsV2Input) SetRequestPayer added in v1.5.0 

func (s *ListObjectsV2Input) SetRequestPayer(v string) *ListObjectsV2Input

SetRequestPayer sets the RequestPayer field's value.

func (*ListObjectsV2Input) SetStartAfter added in v1.5.0 

func (s *ListObjectsV2Input) SetStartAfter(v string) *ListObjectsV2Input

SetStartAfter sets the StartAfter field's value.

func (ListObjectsV2Input) String added in v1.1.24 

func (s ListObjectsV2Input) String() string

String returns the string representation

func (*ListObjectsV2Input) Validate added in v1.1.24 

func (s *ListObjectsV2Input) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListObjectsV2Output added in v1.1.24 

type ListObjectsV2Output struct {

	// CommonPrefixes contains all (if there are any) keys between Prefix and the
	// next occurrence of the string specified by delimiter
	CommonPrefixes []*CommonPrefix `type:"list" flattened:"true"`

	// Metadata about each object returned.
	Contents []*Object `type:"list" flattened:"true"`

	// ContinuationToken indicates Amazon S3 that the list is being continued on
	// this bucket with a token. ContinuationToken is obfuscated and is not a real
	// key
	ContinuationToken *string `type:"string"`

	// A delimiter is a character you use to group keys.
	Delimiter *string `type:"string"`

	// Encoding type used by Amazon S3 to encode object keys in the response.
	EncodingType *string `type:"string" enum:"EncodingType"`

	// A flag that indicates whether or not Amazon S3 returned all of the results
	// that satisfied the search criteria.
	IsTruncated *bool `type:"boolean"`

	// KeyCount is the number of keys returned with this request. KeyCount will
	// always be less than equals to MaxKeys field. Say you ask for 50 keys, your
	// result will include less than equals 50 keys
	KeyCount *int64 `type:"integer"`

	// Sets the maximum number of keys returned in the response. The response might
	// contain fewer keys but will never contain more.
	MaxKeys *int64 `type:"integer"`

	// Name of the bucket to list.
	Name *string `type:"string"`

	// NextContinuationToken is sent when isTruncated is true which means there
	// are more keys in the bucket that can be listed. The next list requests to
	// Amazon S3 can be continued with this NextContinuationToken. NextContinuationToken
	// is obfuscated and is not a real key
	NextContinuationToken *string `type:"string"`

	// Limits the response to keys that begin with the specified prefix.
	Prefix *string `type:"string"`

	// StartAfter is where you want Amazon S3 to start listing from. Amazon S3 starts
	// listing after this specified key. StartAfter can be any key in the bucket
	StartAfter *string `type:"string"`
	// contains filtered or unexported fields
}

func (ListObjectsV2Output) GoString added in v1.1.24 

func (s ListObjectsV2Output) GoString() string

GoString returns the string representation

func (*ListObjectsV2Output) SetCommonPrefixes added in v1.5.0 

func (s *ListObjectsV2Output) SetCommonPrefixes(v []*CommonPrefix) *ListObjectsV2Output

SetCommonPrefixes sets the CommonPrefixes field's value.

func (*ListObjectsV2Output) SetContents added in v1.5.0 

func (s *ListObjectsV2Output) SetContents(v []*Object) *ListObjectsV2Output

SetContents sets the Contents field's value.

func (*ListObjectsV2Output) SetContinuationToken added in v1.5.0 

func (s *ListObjectsV2Output) SetContinuationToken(v string) *ListObjectsV2Output

SetContinuationToken sets the ContinuationToken field's value.

func (*ListObjectsV2Output) SetDelimiter added in v1.5.0 

func (s *ListObjectsV2Output) SetDelimiter(v string) *ListObjectsV2Output

SetDelimiter sets the Delimiter field's value.

func (*ListObjectsV2Output) SetEncodingType added in v1.5.0 

func (s *ListObjectsV2Output) SetEncodingType(v string) *ListObjectsV2Output

SetEncodingType sets the EncodingType field's value.

func (*ListObjectsV2Output) SetIsTruncated added in v1.5.0 

func (s *ListObjectsV2Output) SetIsTruncated(v bool) *ListObjectsV2Output

SetIsTruncated sets the IsTruncated field's value.

func (*ListObjectsV2Output) SetKeyCount added in v1.5.0 

func (s *ListObjectsV2Output) SetKeyCount(v int64) *ListObjectsV2Output

SetKeyCount sets the KeyCount field's value.

func (*ListObjectsV2Output) SetMaxKeys added in v1.5.0 

func (s *ListObjectsV2Output) SetMaxKeys(v int64) *ListObjectsV2Output

SetMaxKeys sets the MaxKeys field's value.

func (*ListObjectsV2Output) SetName added in v1.5.0 

func (s *ListObjectsV2Output) SetName(v string) *ListObjectsV2Output

SetName sets the Name field's value.

func (*ListObjectsV2Output) SetNextContinuationToken added in v1.5.0 

func (s *ListObjectsV2Output) SetNextContinuationToken(v string) *ListObjectsV2Output

SetNextContinuationToken sets the NextContinuationToken field's value.

func (*ListObjectsV2Output) SetPrefix added in v1.5.0 

func (s *ListObjectsV2Output) SetPrefix(v string) *ListObjectsV2Output

SetPrefix sets the Prefix field's value.

func (*ListObjectsV2Output) SetStartAfter added in v1.5.0 

func (s *ListObjectsV2Output) SetStartAfter(v string) *ListObjectsV2Output

SetStartAfter sets the StartAfter field's value.

func (ListObjectsV2Output) String added in v1.1.24 

func (s ListObjectsV2Output) String() string

String returns the string representation

type ListPartsInput 

type ListPartsInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// Sets the maximum number of parts to return.
	MaxParts *int64 `location:"querystring" locationName:"max-parts" type:"integer"`

	// Specifies the part after which listing should begin. Only parts with higher
	// part numbers will be listed.
	PartNumberMarker *int64 `location:"querystring" locationName:"part-number-marker" type:"integer"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`

	// Upload ID identifying the multipart upload whose parts are being listed.
	//
	// UploadId is a required field
	UploadId *string `location:"querystring" locationName:"uploadId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (ListPartsInput) GoString added in v0.6.5 

func (s ListPartsInput) GoString() string

GoString returns the string representation

func (*ListPartsInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*ListPartsInput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*ListPartsInput) SetMaxParts added in v1.5.0 

func (s *ListPartsInput) SetMaxParts(v int64) *ListPartsInput

SetMaxParts sets the MaxParts field's value.

func (*ListPartsInput) SetPartNumberMarker added in v1.5.0 

func (s *ListPartsInput) SetPartNumberMarker(v int64) *ListPartsInput

SetPartNumberMarker sets the PartNumberMarker field's value.

func (*ListPartsInput) SetRequestPayer added in v1.5.0 

func (s *ListPartsInput) SetRequestPayer(v string) *ListPartsInput

SetRequestPayer sets the RequestPayer field's value.

func (*ListPartsInput) SetUploadId added in v1.5.0 

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

SetUploadId sets the UploadId field's value.

func (ListPartsInput) String added in v0.6.5 

func (s ListPartsInput) String() string

String returns the string representation

func (*ListPartsInput) Validate added in v1.1.21 

func (s *ListPartsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListPartsOutput 

type ListPartsOutput struct {

	// Date when multipart upload will become eligible for abort operation by lifecycle.
	AbortDate *time.Time `location:"header" locationName:"x-amz-abort-date" type:"timestamp"`

	// Id of the lifecycle rule that makes a multipart upload eligible for abort
	// operation.
	AbortRuleId *string `location:"header" locationName:"x-amz-abort-rule-id" type:"string"`

	// Name of the bucket to which the multipart upload was initiated.
	Bucket *string `type:"string"`

	// Identifies who initiated the multipart upload.
	Initiator *Initiator `type:"structure"`

	// Indicates whether the returned list of parts is truncated.
	IsTruncated *bool `type:"boolean"`

	// Object key for which the multipart upload was initiated.
	Key *string `min:"1" type:"string"`

	// Maximum number of parts that were allowed in the response.
	MaxParts *int64 `type:"integer"`

	// When a list is truncated, this element specifies the last part in the list,
	// as well as the value to use for the part-number-marker request parameter
	// in a subsequent request.
	NextPartNumberMarker *int64 `type:"integer"`

	Owner *Owner `type:"structure"`

	// Part number after which listing begins.
	PartNumberMarker *int64 `type:"integer"`

	Parts []*Part `locationName:"Part" type:"list" flattened:"true"`

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`

	// The class of storage used to store the object.
	StorageClass *string `type:"string" enum:"StorageClass"`

	// Upload ID identifying the multipart upload whose parts are being listed.
	UploadId *string `type:"string"`
	// contains filtered or unexported fields
}

func (ListPartsOutput) GoString added in v0.6.5 

func (s ListPartsOutput) GoString() string

GoString returns the string representation

func (*ListPartsOutput) SetAbortDate added in v1.5.0 

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

SetAbortDate sets the AbortDate field's value.

func (*ListPartsOutput) SetAbortRuleId added in v1.5.0 

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

SetAbortRuleId sets the AbortRuleId field's value.

func (*ListPartsOutput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*ListPartsOutput) SetInitiator added in v1.5.0 

func (s *ListPartsOutput) SetInitiator(v *Initiator) *ListPartsOutput

SetInitiator sets the Initiator field's value.

func (*ListPartsOutput) SetIsTruncated added in v1.5.0 

func (s *ListPartsOutput) SetIsTruncated(v bool) *ListPartsOutput

SetIsTruncated sets the IsTruncated field's value.

func (*ListPartsOutput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*ListPartsOutput) SetMaxParts added in v1.5.0 

func (s *ListPartsOutput) SetMaxParts(v int64) *ListPartsOutput

SetMaxParts sets the MaxParts field's value.

func (*ListPartsOutput) SetNextPartNumberMarker added in v1.5.0 

func (s *ListPartsOutput) SetNextPartNumberMarker(v int64) *ListPartsOutput

SetNextPartNumberMarker sets the NextPartNumberMarker field's value.

func (*ListPartsOutput) SetOwner added in v1.5.0 

func (s *ListPartsOutput) SetOwner(v *Owner) *ListPartsOutput

SetOwner sets the Owner field's value.

func (*ListPartsOutput) SetPartNumberMarker added in v1.5.0 

func (s *ListPartsOutput) SetPartNumberMarker(v int64) *ListPartsOutput

SetPartNumberMarker sets the PartNumberMarker field's value.

func (*ListPartsOutput) SetParts added in v1.5.0 

func (s *ListPartsOutput) SetParts(v []*Part) *ListPartsOutput

SetParts sets the Parts field's value.

func (*ListPartsOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (*ListPartsOutput) SetStorageClass added in v1.5.0 

func (s *ListPartsOutput) SetStorageClass(v string) *ListPartsOutput

SetStorageClass sets the StorageClass field's value.

func (*ListPartsOutput) SetUploadId added in v1.5.0 

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

SetUploadId sets the UploadId field's value.

func (ListPartsOutput) String added in v0.6.5 

func (s ListPartsOutput) String() string

String returns the string representation

type Location added in v1.12.36 

type Location struct {

	// A list of grants that control access to the staged results.
	AccessControlList []*Grant `locationNameList:"Grant" type:"list"`

	// The name of the bucket where the restore results will be placed.
	//
	// BucketName is a required field
	BucketName *string `type:"string" required:"true"`

	// The canned ACL to apply to the restore results.
	CannedACL *string `type:"string" enum:"ObjectCannedACL"`

	// Describes the server-side encryption that will be applied to the restore
	// results.
	Encryption *Encryption `type:"structure"`

	// The prefix that is prepended to the restore results for this request.
	//
	// Prefix is a required field
	Prefix *string `type:"string" required:"true"`

	// The class of storage used to store the restore results.
	StorageClass *string `type:"string" enum:"StorageClass"`

	// The tag-set that is applied to the restore results.
	Tagging *Tagging `type:"structure"`

	// A list of metadata to store with the restore results in S3.
	UserMetadata []*MetadataEntry `locationNameList:"MetadataEntry" type:"list"`
	// contains filtered or unexported fields
}

Describes an S3 location that will receive the results of the restore request.

func (Location) GoString added in v1.12.36 

func (s Location) GoString() string

GoString returns the string representation

func (*Location) SetAccessControlList added in v1.12.36 

func (s *Location) SetAccessControlList(v []*Grant) *Location

SetAccessControlList sets the AccessControlList field's value.

func (*Location) SetBucketName added in v1.12.36 

func (s *Location) SetBucketName(v string) *Location

SetBucketName sets the BucketName field's value.

func (*Location) SetCannedACL added in v1.12.36 

func (s *Location) SetCannedACL(v string) *Location

SetCannedACL sets the CannedACL field's value.

func (*Location) SetEncryption added in v1.12.36 

func (s *Location) SetEncryption(v *Encryption) *Location

SetEncryption sets the Encryption field's value.

func (*Location) SetPrefix added in v1.12.36 

func (s *Location) SetPrefix(v string) *Location

SetPrefix sets the Prefix field's value.

func (*Location) SetStorageClass added in v1.12.36 

func (s *Location) SetStorageClass(v string) *Location

SetStorageClass sets the StorageClass field's value.

func (*Location) SetTagging added in v1.12.36 

func (s *Location) SetTagging(v *Tagging) *Location

SetTagging sets the Tagging field's value.

func (*Location) SetUserMetadata added in v1.12.36 

func (s *Location) SetUserMetadata(v []*MetadataEntry) *Location

SetUserMetadata sets the UserMetadata field's value.

func (Location) String added in v1.12.36 

func (s Location) String() string

String returns the string representation

func (*Location) Validate added in v1.12.36 

func (s *Location) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type LoggingEnabled 

type LoggingEnabled struct {

	// Specifies the bucket where you want Amazon S3 to store server access logs.
	// You can have your logs delivered to any bucket that you own, including the
	// same bucket that is being logged. You can also configure multiple buckets
	// to deliver their logs to the same target bucket. In this case you should
	// choose a different TargetPrefix for each source bucket so that the delivered
	// log files can be distinguished by key.
	//
	// TargetBucket is a required field
	TargetBucket *string `type:"string" required:"true"`

	TargetGrants []*TargetGrant `locationNameList:"Grant" type:"list"`

	// This element lets you specify a prefix for the keys that the log files will
	// be stored under.
	//
	// TargetPrefix is a required field
	TargetPrefix *string `type:"string" required:"true"`
	// contains filtered or unexported fields
}

Container for logging information. Presence of this element indicates that logging is enabled. Parameters TargetBucket and TargetPrefix are required in this case.

func (LoggingEnabled) GoString added in v0.6.5 

func (s LoggingEnabled) GoString() string

GoString returns the string representation

func (*LoggingEnabled) SetTargetBucket added in v1.5.0 

func (s *LoggingEnabled) SetTargetBucket(v string) *LoggingEnabled

SetTargetBucket sets the TargetBucket field's value.

func (*LoggingEnabled) SetTargetGrants added in v1.5.0 

func (s *LoggingEnabled) SetTargetGrants(v []*TargetGrant) *LoggingEnabled

SetTargetGrants sets the TargetGrants field's value.

func (*LoggingEnabled) SetTargetPrefix added in v1.5.0 

func (s *LoggingEnabled) SetTargetPrefix(v string) *LoggingEnabled

SetTargetPrefix sets the TargetPrefix field's value.

func (LoggingEnabled) String added in v0.6.5 

func (s LoggingEnabled) String() string

String returns the string representation

func (*LoggingEnabled) Validate added in v1.1.21 

func (s *LoggingEnabled) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type MetadataEntry added in v1.12.36 

type MetadataEntry struct {
	Name *string `type:"string"`

	Value *string `type:"string"`
	// contains filtered or unexported fields
}

A metadata key-value pair to store with an object.

func (MetadataEntry) GoString added in v1.12.36 

func (s MetadataEntry) GoString() string

GoString returns the string representation

func (*MetadataEntry) SetName added in v1.12.36 

func (s *MetadataEntry) SetName(v string) *MetadataEntry

SetName sets the Name field's value.

func (*MetadataEntry) SetValue added in v1.12.36 

func (s *MetadataEntry) SetValue(v string) *MetadataEntry

SetValue sets the Value field's value.

func (MetadataEntry) String added in v1.12.36 

func (s MetadataEntry) String() string

String returns the string representation

type MetricsAndOperator added in v1.5.11 

type MetricsAndOperator struct {

	// The prefix used when evaluating an AND predicate.
	Prefix *string `type:"string"`

	// The list of tags used when evaluating an AND predicate.
	Tags []*Tag `locationName:"Tag" locationNameList:"Tag" type:"list" flattened:"true"`
	// contains filtered or unexported fields
}

func (MetricsAndOperator) GoString added in v1.5.11 

func (s MetricsAndOperator) GoString() string

GoString returns the string representation

func (*MetricsAndOperator) SetPrefix added in v1.5.11 

func (s *MetricsAndOperator) SetPrefix(v string) *MetricsAndOperator

SetPrefix sets the Prefix field's value.

func (*MetricsAndOperator) SetTags added in v1.5.11 

func (s *MetricsAndOperator) SetTags(v []*Tag) *MetricsAndOperator

SetTags sets the Tags field's value.

func (MetricsAndOperator) String added in v1.5.11 

func (s MetricsAndOperator) String() string

String returns the string representation

func (*MetricsAndOperator) Validate added in v1.5.11 

func (s *MetricsAndOperator) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type MetricsConfiguration added in v1.5.11 

type MetricsConfiguration struct {

	// Specifies a metrics configuration filter. The metrics configuration will
	// only include objects that meet the filter's criteria. A filter must be a
	// prefix, a tag, or a conjunction (MetricsAndOperator).
	Filter *MetricsFilter `type:"structure"`

	// The ID used to identify the metrics configuration.
	//
	// Id is a required field
	Id *string `type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (MetricsConfiguration) GoString added in v1.5.11 

func (s MetricsConfiguration) GoString() string

GoString returns the string representation

func (*MetricsConfiguration) SetFilter added in v1.5.11 

func (s *MetricsConfiguration) SetFilter(v *MetricsFilter) *MetricsConfiguration

SetFilter sets the Filter field's value.

func (*MetricsConfiguration) SetId added in v1.5.11 

func (s *MetricsConfiguration) SetId(v string) *MetricsConfiguration

SetId sets the Id field's value.

func (MetricsConfiguration) String added in v1.5.11 

func (s MetricsConfiguration) String() string

String returns the string representation

func (*MetricsConfiguration) Validate added in v1.5.11 

func (s *MetricsConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type MetricsFilter added in v1.5.11 

type MetricsFilter struct {

	// A conjunction (logical AND) of predicates, which is used in evaluating a
	// metrics filter. The operator must have at least two predicates, and an object
	// must match all of the predicates in order for the filter to apply.
	And *MetricsAndOperator `type:"structure"`

	// The prefix used when evaluating a metrics filter.
	Prefix *string `type:"string"`

	// The tag used when evaluating a metrics filter.
	Tag *Tag `type:"structure"`
	// contains filtered or unexported fields
}

func (MetricsFilter) GoString added in v1.5.11 

func (s MetricsFilter) GoString() string

GoString returns the string representation

func (*MetricsFilter) SetAnd added in v1.5.11 

func (s *MetricsFilter) SetAnd(v *MetricsAndOperator) *MetricsFilter

SetAnd sets the And field's value.

func (*MetricsFilter) SetPrefix added in v1.5.11 

func (s *MetricsFilter) SetPrefix(v string) *MetricsFilter

SetPrefix sets the Prefix field's value.

func (*MetricsFilter) SetTag added in v1.5.11 

func (s *MetricsFilter) SetTag(v *Tag) *MetricsFilter

SetTag sets the Tag field's value.

func (MetricsFilter) String added in v1.5.11 

func (s MetricsFilter) String() string

String returns the string representation

func (*MetricsFilter) Validate added in v1.5.11 

func (s *MetricsFilter) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type MultipartUpload 

type MultipartUpload struct {

	// Date and time at which the multipart upload was initiated.
	Initiated *time.Time `type:"timestamp"`

	// Identifies who initiated the multipart upload.
	Initiator *Initiator `type:"structure"`

	// Key of the object for which the multipart upload was initiated.
	Key *string `min:"1" type:"string"`

	Owner *Owner `type:"structure"`

	// The class of storage used to store the object.
	StorageClass *string `type:"string" enum:"StorageClass"`

	// Upload ID that identifies the multipart upload.
	UploadId *string `type:"string"`
	// contains filtered or unexported fields
}

func (MultipartUpload) GoString added in v0.6.5 

func (s MultipartUpload) GoString() string

GoString returns the string representation

func (*MultipartUpload) SetInitiated added in v1.5.0 

func (s *MultipartUpload) SetInitiated(v time.Time) *MultipartUpload

SetInitiated sets the Initiated field's value.

func (*MultipartUpload) SetInitiator added in v1.5.0 

func (s *MultipartUpload) SetInitiator(v *Initiator) *MultipartUpload

SetInitiator sets the Initiator field's value.

func (*MultipartUpload) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*MultipartUpload) SetOwner added in v1.5.0 

func (s *MultipartUpload) SetOwner(v *Owner) *MultipartUpload

SetOwner sets the Owner field's value.

func (*MultipartUpload) SetStorageClass added in v1.5.0 

func (s *MultipartUpload) SetStorageClass(v string) *MultipartUpload

SetStorageClass sets the StorageClass field's value.

func (*MultipartUpload) SetUploadId added in v1.5.0 

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

SetUploadId sets the UploadId field's value.

func (MultipartUpload) String added in v0.6.5 

func (s MultipartUpload) String() string

String returns the string representation

type NoncurrentVersionExpiration 

type NoncurrentVersionExpiration struct {

	// Specifies the number of days an object is noncurrent before Amazon S3 can
	// perform the associated action. For information about the noncurrent days
	// calculations, see How Amazon S3 Calculates When an Object Became Noncurrent
	// (http://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html) in
	// the Amazon Simple Storage Service Developer Guide.
	NoncurrentDays *int64 `type:"integer"`
	// contains filtered or unexported fields
}

Specifies when noncurrent object versions expire. Upon expiration, Amazon S3 permanently deletes the noncurrent object versions. You set this lifecycle configuration action on a bucket that has versioning enabled (or suspended) to request that Amazon S3 delete noncurrent object versions at a specific period in the object's lifetime.

func (NoncurrentVersionExpiration) GoString added in v0.6.5 

func (s NoncurrentVersionExpiration) GoString() string

GoString returns the string representation

func (*NoncurrentVersionExpiration) SetNoncurrentDays added in v1.5.0 

func (s *NoncurrentVersionExpiration) SetNoncurrentDays(v int64) *NoncurrentVersionExpiration

SetNoncurrentDays sets the NoncurrentDays field's value.

func (NoncurrentVersionExpiration) String added in v0.6.5 

func (s NoncurrentVersionExpiration) String() string

String returns the string representation

type NoncurrentVersionTransition 

type NoncurrentVersionTransition struct {

	// Specifies the number of days an object is noncurrent before Amazon S3 can
	// perform the associated action. For information about the noncurrent days
	// calculations, see How Amazon S3 Calculates When an Object Became Noncurrent
	// (http://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html) in
	// the Amazon Simple Storage Service Developer Guide.
	NoncurrentDays *int64 `type:"integer"`

	// The class of storage used to store the object.
	StorageClass *string `type:"string" enum:"TransitionStorageClass"`
	// contains filtered or unexported fields
}

Container for the transition rule that describes when noncurrent objects transition to the STANDARD_IA, ONEZONE_IA or GLACIER storage class. If your bucket is versioning-enabled (or versioning is suspended), you can set this action to request that Amazon S3 transition noncurrent object versions to the STANDARD_IA, ONEZONE_IA or GLACIER storage class at a specific period in the object's lifetime.

func (NoncurrentVersionTransition) GoString added in v0.6.5 

func (s NoncurrentVersionTransition) GoString() string

GoString returns the string representation

func (*NoncurrentVersionTransition) SetNoncurrentDays added in v1.5.0 

func (s *NoncurrentVersionTransition) SetNoncurrentDays(v int64) *NoncurrentVersionTransition

SetNoncurrentDays sets the NoncurrentDays field's value.

func (*NoncurrentVersionTransition) SetStorageClass added in v1.5.0 

func (s *NoncurrentVersionTransition) SetStorageClass(v string) *NoncurrentVersionTransition

SetStorageClass sets the StorageClass field's value.

func (NoncurrentVersionTransition) String added in v0.6.5 

func (s NoncurrentVersionTransition) String() string

String returns the string representation

type NotificationConfiguration 

type NotificationConfiguration struct {
	LambdaFunctionConfigurations []*LambdaFunctionConfiguration `locationName:"CloudFunctionConfiguration" type:"list" flattened:"true"`

	QueueConfigurations []*QueueConfiguration `locationName:"QueueConfiguration" type:"list" flattened:"true"`

	TopicConfigurations []*TopicConfiguration `locationName:"TopicConfiguration" type:"list" flattened:"true"`
	// contains filtered or unexported fields
}

Container for specifying the notification configuration of the bucket. If this element is empty, notifications are turned off on the bucket.

func (NotificationConfiguration) GoString added in v0.6.5 

func (s NotificationConfiguration) GoString() string

GoString returns the string representation

func (*NotificationConfiguration) SetLambdaFunctionConfigurations added in v1.5.0 

func (s *NotificationConfiguration) SetLambdaFunctionConfigurations(v []*LambdaFunctionConfiguration) *NotificationConfiguration

SetLambdaFunctionConfigurations sets the LambdaFunctionConfigurations field's value.

func (*NotificationConfiguration) SetQueueConfigurations added in v1.5.0 

func (s *NotificationConfiguration) SetQueueConfigurations(v []*QueueConfiguration) *NotificationConfiguration

SetQueueConfigurations sets the QueueConfigurations field's value.

func (*NotificationConfiguration) SetTopicConfigurations added in v1.5.0 

func (s *NotificationConfiguration) SetTopicConfigurations(v []*TopicConfiguration) *NotificationConfiguration

SetTopicConfigurations sets the TopicConfigurations field's value.

func (NotificationConfiguration) String added in v0.6.5 

func (s NotificationConfiguration) String() string

String returns the string representation

func (*NotificationConfiguration) Validate added in v1.1.21 

func (s *NotificationConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type NotificationConfigurationDeprecated 

type NotificationConfigurationDeprecated struct {
	CloudFunctionConfiguration *CloudFunctionConfiguration `type:"structure"`

	QueueConfiguration *QueueConfigurationDeprecated `type:"structure"`

	TopicConfiguration *TopicConfigurationDeprecated `type:"structure"`
	// contains filtered or unexported fields
}

func (NotificationConfigurationDeprecated) GoString added in v0.6.5 

func (s NotificationConfigurationDeprecated) GoString() string

GoString returns the string representation

func (*NotificationConfigurationDeprecated) SetCloudFunctionConfiguration added in v1.5.0 

func (s *NotificationConfigurationDeprecated) SetCloudFunctionConfiguration(v *CloudFunctionConfiguration) *NotificationConfigurationDeprecated

SetCloudFunctionConfiguration sets the CloudFunctionConfiguration field's value.

func (*NotificationConfigurationDeprecated) SetQueueConfiguration added in v1.5.0 

func (s *NotificationConfigurationDeprecated) SetQueueConfiguration(v *QueueConfigurationDeprecated) *NotificationConfigurationDeprecated

SetQueueConfiguration sets the QueueConfiguration field's value.

func (*NotificationConfigurationDeprecated) SetTopicConfiguration added in v1.5.0 

func (s *NotificationConfigurationDeprecated) SetTopicConfiguration(v *TopicConfigurationDeprecated) *NotificationConfigurationDeprecated

SetTopicConfiguration sets the TopicConfiguration field's value.

func (NotificationConfigurationDeprecated) String added in v0.6.5 

func (s NotificationConfigurationDeprecated) String() string

String returns the string representation

type NotificationConfigurationFilter added in v0.9.5 

type NotificationConfigurationFilter struct {

	// Container for object key name prefix and suffix filtering rules.
	Key *KeyFilter `locationName:"S3Key" type:"structure"`
	// contains filtered or unexported fields
}

Container for object key name filtering rules. For information about key name filtering, go to Configuring Event Notifications (http://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html) in the Amazon Simple Storage Service Developer Guide.

func (NotificationConfigurationFilter) GoString added in v0.9.5 

func (s NotificationConfigurationFilter) GoString() string

GoString returns the string representation

func (*NotificationConfigurationFilter) SetKey added in v1.5.0 

func (s *NotificationConfigurationFilter) SetKey(v *KeyFilter) *NotificationConfigurationFilter

SetKey sets the Key field's value.

func (NotificationConfigurationFilter) String added in v0.9.5 

func (s NotificationConfigurationFilter) String() string

String returns the string representation

type Object 

type Object struct {
	ETag *string `type:"string"`

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

	LastModified *time.Time `type:"timestamp"`

	Owner *Owner `type:"structure"`

	Size *int64 `type:"integer"`

	// The class of storage used to store the object.
	StorageClass *string `type:"string" enum:"ObjectStorageClass"`
	// contains filtered or unexported fields
}

func (Object) GoString added in v0.6.5 

func (s Object) GoString() string

GoString returns the string representation

func (*Object) SetETag added in v1.5.0 

func (s *Object) SetETag(v string) *Object

SetETag sets the ETag field's value.

func (*Object) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*Object) SetLastModified added in v1.5.0 

func (s *Object) SetLastModified(v time.Time) *Object

SetLastModified sets the LastModified field's value.

func (*Object) SetOwner added in v1.5.0 

func (s *Object) SetOwner(v *Owner) *Object

SetOwner sets the Owner field's value.

func (*Object) SetSize added in v1.5.0 

func (s *Object) SetSize(v int64) *Object

SetSize sets the Size field's value.

func (*Object) SetStorageClass added in v1.5.0 

func (s *Object) SetStorageClass(v string) *Object

SetStorageClass sets the StorageClass field's value.

func (Object) String added in v0.6.5 

func (s Object) String() string

String returns the string representation

type ObjectIdentifier 

type ObjectIdentifier struct {

	// Key name of the object to delete.
	//
	// Key is a required field
	Key *string `min:"1" type:"string" required:"true"`

	// VersionId for the specific version of the object to delete.
	VersionId *string `type:"string"`
	// contains filtered or unexported fields
}

func (ObjectIdentifier) GoString added in v0.6.5 

func (s ObjectIdentifier) GoString() string

GoString returns the string representation

func (*ObjectIdentifier) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*ObjectIdentifier) SetVersionId added in v1.5.0 

func (s *ObjectIdentifier) SetVersionId(v string) *ObjectIdentifier

SetVersionId sets the VersionId field's value.

func (ObjectIdentifier) String added in v0.6.5 

func (s ObjectIdentifier) String() string

String returns the string representation

func (*ObjectIdentifier) Validate added in v1.1.21 

func (s *ObjectIdentifier) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ObjectVersion 

type ObjectVersion struct {
	ETag *string `type:"string"`

	// Specifies whether the object is (true) or is not (false) the latest version
	// of an object.
	IsLatest *bool `type:"boolean"`

	// The object key.
	Key *string `min:"1" type:"string"`

	// Date and time the object was last modified.
	LastModified *time.Time `type:"timestamp"`

	Owner *Owner `type:"structure"`

	// Size in bytes of the object.
	Size *int64 `type:"integer"`

	// The class of storage used to store the object.
	StorageClass *string `type:"string" enum:"ObjectVersionStorageClass"`

	// Version ID of an object.
	VersionId *string `type:"string"`
	// contains filtered or unexported fields
}

func (ObjectVersion) GoString added in v0.6.5 

func (s ObjectVersion) GoString() string

GoString returns the string representation

func (*ObjectVersion) SetETag added in v1.5.0 

func (s *ObjectVersion) SetETag(v string) *ObjectVersion

SetETag sets the ETag field's value.

func (*ObjectVersion) SetIsLatest added in v1.5.0 

func (s *ObjectVersion) SetIsLatest(v bool) *ObjectVersion

SetIsLatest sets the IsLatest field's value.

func (*ObjectVersion) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*ObjectVersion) SetLastModified added in v1.5.0 

func (s *ObjectVersion) SetLastModified(v time.Time) *ObjectVersion

SetLastModified sets the LastModified field's value.

func (*ObjectVersion) SetOwner added in v1.5.0 

func (s *ObjectVersion) SetOwner(v *Owner) *ObjectVersion

SetOwner sets the Owner field's value.

func (*ObjectVersion) SetSize added in v1.5.0 

func (s *ObjectVersion) SetSize(v int64) *ObjectVersion

SetSize sets the Size field's value.

func (*ObjectVersion) SetStorageClass added in v1.5.0 

func (s *ObjectVersion) SetStorageClass(v string) *ObjectVersion

SetStorageClass sets the StorageClass field's value.

func (*ObjectVersion) SetVersionId added in v1.5.0 

func (s *ObjectVersion) SetVersionId(v string) *ObjectVersion

SetVersionId sets the VersionId field's value.

func (ObjectVersion) String added in v0.6.5 

func (s ObjectVersion) String() string

String returns the string representation

type OutputLocation added in v1.12.36 

type OutputLocation struct {

	// Describes an S3 location that will receive the results of the restore request.
	S3 *Location `type:"structure"`
	// contains filtered or unexported fields
}

Describes the location where the restore job's output is stored.

func (OutputLocation) GoString added in v1.12.36 

func (s OutputLocation) GoString() string

GoString returns the string representation

func (*OutputLocation) SetS3 added in v1.12.36 

func (s *OutputLocation) SetS3(v *Location) *OutputLocation

SetS3 sets the S3 field's value.

func (OutputLocation) String added in v1.12.36 

func (s OutputLocation) String() string

String returns the string representation

func (*OutputLocation) Validate added in v1.12.36 

func (s *OutputLocation) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type OutputSerialization added in v1.12.36 

type OutputSerialization struct {

	// Describes the serialization of CSV-encoded Select results.
	CSV *CSVOutput `type:"structure"`

	// Specifies JSON as request's output serialization format.
	JSON *JSONOutput `type:"structure"`
	// contains filtered or unexported fields
}

Describes how results of the Select job are serialized.

func (OutputSerialization) GoString added in v1.12.36 

func (s OutputSerialization) GoString() string

GoString returns the string representation

func (*OutputSerialization) SetCSV added in v1.12.36 

func (s *OutputSerialization) SetCSV(v *CSVOutput) *OutputSerialization

SetCSV sets the CSV field's value.

func (*OutputSerialization) SetJSON added in v1.13.28 

func (s *OutputSerialization) SetJSON(v *JSONOutput) *OutputSerialization

SetJSON sets the JSON field's value.

func (OutputSerialization) String added in v1.12.36 

func (s OutputSerialization) String() string

String returns the string representation

type Owner 

type Owner struct {
	DisplayName *string `type:"string"`

	ID *string `type:"string"`
	// contains filtered or unexported fields
}

func (Owner) GoString added in v0.6.5 

func (s Owner) GoString() string

GoString returns the string representation

func (*Owner) SetDisplayName added in v1.5.0 

func (s *Owner) SetDisplayName(v string) *Owner

SetDisplayName sets the DisplayName field's value.

func (*Owner) SetID added in v1.5.0 

func (s *Owner) SetID(v string) *Owner

SetID sets the ID field's value.

func (Owner) String added in v0.6.5 

func (s Owner) String() string

String returns the string representation

type ParquetInput added in v1.15.28 

type ParquetInput struct {
	// contains filtered or unexported fields
}

func (ParquetInput) GoString added in v1.15.28 

func (s ParquetInput) GoString() string

GoString returns the string representation

func (ParquetInput) String added in v1.15.28 

func (s ParquetInput) String() string

String returns the string representation

type Part 

type Part struct {

	// Entity tag returned when the part was uploaded.
	ETag *string `type:"string"`

	// Date and time at which the part was uploaded.
	LastModified *time.Time `type:"timestamp"`

	// Part number identifying the part. This is a positive integer between 1 and
	// 10,000.
	PartNumber *int64 `type:"integer"`

	// Size of the uploaded part data.
	Size *int64 `type:"integer"`
	// contains filtered or unexported fields
}

func (Part) GoString added in v0.6.5 

func (s Part) GoString() string

GoString returns the string representation

func (*Part) SetETag added in v1.5.0 

func (s *Part) SetETag(v string) *Part

SetETag sets the ETag field's value.

func (*Part) SetLastModified added in v1.5.0 

func (s *Part) SetLastModified(v time.Time) *Part

SetLastModified sets the LastModified field's value.

func (*Part) SetPartNumber added in v1.5.0 

func (s *Part) SetPartNumber(v int64) *Part

SetPartNumber sets the PartNumber field's value.

func (*Part) SetSize added in v1.5.0 

func (s *Part) SetSize(v int64) *Part

SetSize sets the Size field's value.

func (Part) String added in v0.6.5 

func (s Part) String() string

String returns the string representation

type Progress added in v1.14.0 

type Progress struct {

	// Current number of uncompressed object bytes processed.
	BytesProcessed *int64 `type:"long"`

	// Current number of bytes of records payload data returned.
	BytesReturned *int64 `type:"long"`

	// Current number of object bytes scanned.
	BytesScanned *int64 `type:"long"`
	// contains filtered or unexported fields
}

func (Progress) GoString added in v1.14.0 

func (s Progress) GoString() string

GoString returns the string representation

func (*Progress) SetBytesProcessed added in v1.14.0 

func (s *Progress) SetBytesProcessed(v int64) *Progress

SetBytesProcessed sets the BytesProcessed field's value.

func (*Progress) SetBytesReturned added in v1.14.0 

func (s *Progress) SetBytesReturned(v int64) *Progress

SetBytesReturned sets the BytesReturned field's value.

func (*Progress) SetBytesScanned added in v1.14.0 

func (s *Progress) SetBytesScanned(v int64) *Progress

SetBytesScanned sets the BytesScanned field's value.

func (Progress) String added in v1.14.0 

func (s Progress) String() string

String returns the string representation

type ProgressEvent added in v1.14.0 

type ProgressEvent struct {

	// The Progress event details.
	Details *Progress `locationName:"Details" type:"structure"`
	// contains filtered or unexported fields
}

func (ProgressEvent) GoString added in v1.14.0 

func (s ProgressEvent) GoString() string

GoString returns the string representation

func (*ProgressEvent) SetDetails added in v1.14.0 

func (s *ProgressEvent) SetDetails(v *Progress) *ProgressEvent

SetDetails sets the Details field's value.

func (ProgressEvent) String added in v1.14.0 

func (s ProgressEvent) String() string

String returns the string representation

func (*ProgressEvent) UnmarshalEvent added in v1.14.0 

func (s *ProgressEvent) UnmarshalEvent(
	payloadUnmarshaler protocol.PayloadUnmarshaler,
	msg eventstream.Message,
) error

UnmarshalEvent unmarshals the EventStream Message into the ProgressEvent value. This method is only used internally within the SDK's EventStream handling.

type PutBucketAccelerateConfigurationInput added in v1.1.19 

type PutBucketAccelerateConfigurationInput struct {

	// Specifies the Accelerate Configuration you want to set for the bucket.
	//
	// AccelerateConfiguration is a required field
	AccelerateConfiguration *AccelerateConfiguration `locationName:"AccelerateConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`

	// Name of the bucket for which the accelerate configuration is set.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (PutBucketAccelerateConfigurationInput) GoString added in v1.1.19 

func (s PutBucketAccelerateConfigurationInput) GoString() string

GoString returns the string representation

func (*PutBucketAccelerateConfigurationInput) SetAccelerateConfiguration added in v1.5.0 

func (s *PutBucketAccelerateConfigurationInput) SetAccelerateConfiguration(v *AccelerateConfiguration) *PutBucketAccelerateConfigurationInput

SetAccelerateConfiguration sets the AccelerateConfiguration field's value.

func (*PutBucketAccelerateConfigurationInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (PutBucketAccelerateConfigurationInput) String added in v1.1.19 

func (s PutBucketAccelerateConfigurationInput) String() string

String returns the string representation

func (*PutBucketAccelerateConfigurationInput) Validate added in v1.1.21 

func (s *PutBucketAccelerateConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketAccelerateConfigurationOutput added in v1.1.19 

type PutBucketAccelerateConfigurationOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketAccelerateConfigurationOutput) GoString added in v1.1.19 

func (s PutBucketAccelerateConfigurationOutput) GoString() string

GoString returns the string representation

func (PutBucketAccelerateConfigurationOutput) String added in v1.1.19 

func (s PutBucketAccelerateConfigurationOutput) String() string

String returns the string representation

type PutBucketAclInput added in v0.9.5 

type PutBucketAclInput struct {

	// The canned ACL to apply to the bucket.
	ACL *string `location:"header" locationName:"x-amz-acl" type:"string" enum:"BucketCannedACL"`

	AccessControlPolicy *AccessControlPolicy `locationName:"AccessControlPolicy" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Allows grantee the read, write, read ACP, and write ACP permissions on the
	// bucket.
	GrantFullControl *string `location:"header" locationName:"x-amz-grant-full-control" type:"string"`

	// Allows grantee to list the objects in the bucket.
	GrantRead *string `location:"header" locationName:"x-amz-grant-read" type:"string"`

	// Allows grantee to read the bucket ACL.
	GrantReadACP *string `location:"header" locationName:"x-amz-grant-read-acp" type:"string"`

	// Allows grantee to create, overwrite, and delete any object in the bucket.
	GrantWrite *string `location:"header" locationName:"x-amz-grant-write" type:"string"`

	// Allows grantee to write the ACL for the applicable bucket.
	GrantWriteACP *string `location:"header" locationName:"x-amz-grant-write-acp" type:"string"`
	// contains filtered or unexported fields
}

func (PutBucketAclInput) GoString added in v0.9.5 

func (s PutBucketAclInput) GoString() string

GoString returns the string representation

func (*PutBucketAclInput) SetACL added in v1.5.0 

func (s *PutBucketAclInput) SetACL(v string) *PutBucketAclInput

SetACL sets the ACL field's value.

func (*PutBucketAclInput) SetAccessControlPolicy added in v1.5.0 

func (s *PutBucketAclInput) SetAccessControlPolicy(v *AccessControlPolicy) *PutBucketAclInput

SetAccessControlPolicy sets the AccessControlPolicy field's value.

func (*PutBucketAclInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*PutBucketAclInput) SetGrantFullControl added in v1.5.0 

func (s *PutBucketAclInput) SetGrantFullControl(v string) *PutBucketAclInput

SetGrantFullControl sets the GrantFullControl field's value.

func (*PutBucketAclInput) SetGrantRead added in v1.5.0 

func (s *PutBucketAclInput) SetGrantRead(v string) *PutBucketAclInput

SetGrantRead sets the GrantRead field's value.

func (*PutBucketAclInput) SetGrantReadACP added in v1.5.0 

func (s *PutBucketAclInput) SetGrantReadACP(v string) *PutBucketAclInput

SetGrantReadACP sets the GrantReadACP field's value.

func (*PutBucketAclInput) SetGrantWrite added in v1.5.0 

func (s *PutBucketAclInput) SetGrantWrite(v string) *PutBucketAclInput

SetGrantWrite sets the GrantWrite field's value.

func (*PutBucketAclInput) SetGrantWriteACP added in v1.5.0 

func (s *PutBucketAclInput) SetGrantWriteACP(v string) *PutBucketAclInput

SetGrantWriteACP sets the GrantWriteACP field's value.

func (PutBucketAclInput) String added in v0.9.5 

func (s PutBucketAclInput) String() string

String returns the string representation

func (*PutBucketAclInput) Validate added in v1.1.21 

func (s *PutBucketAclInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketAclOutput added in v0.9.5 

type PutBucketAclOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketAclOutput) GoString added in v0.9.5 

func (s PutBucketAclOutput) GoString() string

GoString returns the string representation

func (PutBucketAclOutput) String added in v0.9.5 

func (s PutBucketAclOutput) String() string

String returns the string representation

type PutBucketAnalyticsConfigurationInput added in v1.5.11 

type PutBucketAnalyticsConfigurationInput struct {

	// The configuration and any analyses for the analytics filter.
	//
	// AnalyticsConfiguration is a required field
	AnalyticsConfiguration *AnalyticsConfiguration `locationName:"AnalyticsConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`

	// The name of the bucket to which an analytics configuration is stored.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// The identifier used to represent an analytics configuration.
	//
	// Id is a required field
	Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (PutBucketAnalyticsConfigurationInput) GoString added in v1.5.11 

func (s PutBucketAnalyticsConfigurationInput) GoString() string

GoString returns the string representation

func (*PutBucketAnalyticsConfigurationInput) SetAnalyticsConfiguration added in v1.5.11 

func (s *PutBucketAnalyticsConfigurationInput) SetAnalyticsConfiguration(v *AnalyticsConfiguration) *PutBucketAnalyticsConfigurationInput

SetAnalyticsConfiguration sets the AnalyticsConfiguration field's value.

func (*PutBucketAnalyticsConfigurationInput) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*PutBucketAnalyticsConfigurationInput) SetId added in v1.5.11 

func (s *PutBucketAnalyticsConfigurationInput) SetId(v string) *PutBucketAnalyticsConfigurationInput

SetId sets the Id field's value.

func (PutBucketAnalyticsConfigurationInput) String added in v1.5.11 

func (s PutBucketAnalyticsConfigurationInput) String() string

String returns the string representation

func (*PutBucketAnalyticsConfigurationInput) Validate added in v1.5.11 

func (s *PutBucketAnalyticsConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketAnalyticsConfigurationOutput added in v1.5.11 

type PutBucketAnalyticsConfigurationOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketAnalyticsConfigurationOutput) GoString added in v1.5.11 

func (s PutBucketAnalyticsConfigurationOutput) GoString() string

GoString returns the string representation

func (PutBucketAnalyticsConfigurationOutput) String added in v1.5.11 

func (s PutBucketAnalyticsConfigurationOutput) String() string

String returns the string representation

type PutBucketCorsInput added in v0.9.5 

type PutBucketCorsInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// CORSConfiguration is a required field
	CORSConfiguration *CORSConfiguration `locationName:"CORSConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
	// contains filtered or unexported fields
}

func (PutBucketCorsInput) GoString added in v0.9.5 

func (s PutBucketCorsInput) GoString() string

GoString returns the string representation

func (*PutBucketCorsInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*PutBucketCorsInput) SetCORSConfiguration added in v1.5.0 

func (s *PutBucketCorsInput) SetCORSConfiguration(v *CORSConfiguration) *PutBucketCorsInput

SetCORSConfiguration sets the CORSConfiguration field's value.

func (PutBucketCorsInput) String added in v0.9.5 

func (s PutBucketCorsInput) String() string

String returns the string representation

func (*PutBucketCorsInput) Validate added in v1.1.21 

func (s *PutBucketCorsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketCorsOutput added in v0.9.5 

type PutBucketCorsOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketCorsOutput) GoString added in v0.9.5 

func (s PutBucketCorsOutput) GoString() string

GoString returns the string representation

func (PutBucketCorsOutput) String added in v0.9.5 

func (s PutBucketCorsOutput) String() string

String returns the string representation

type PutBucketEncryptionInput added in v1.12.24 

type PutBucketEncryptionInput struct {

	// The name of the bucket for which the server-side encryption configuration
	// is set.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Container for server-side encryption configuration rules. Currently S3 supports
	// one rule only.
	//
	// ServerSideEncryptionConfiguration is a required field
	ServerSideEncryptionConfiguration *ServerSideEncryptionConfiguration `` /* 130-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (PutBucketEncryptionInput) GoString added in v1.12.24 

func (s PutBucketEncryptionInput) GoString() string

GoString returns the string representation

func (*PutBucketEncryptionInput) SetBucket added in v1.12.24 

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

SetBucket sets the Bucket field's value.

func (*PutBucketEncryptionInput) SetServerSideEncryptionConfiguration added in v1.12.24 

func (s *PutBucketEncryptionInput) SetServerSideEncryptionConfiguration(v *ServerSideEncryptionConfiguration) *PutBucketEncryptionInput

SetServerSideEncryptionConfiguration sets the ServerSideEncryptionConfiguration field's value.

func (PutBucketEncryptionInput) String added in v1.12.24 

func (s PutBucketEncryptionInput) String() string

String returns the string representation

func (*PutBucketEncryptionInput) Validate added in v1.12.24 

func (s *PutBucketEncryptionInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketEncryptionOutput added in v1.12.24 

type PutBucketEncryptionOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketEncryptionOutput) GoString added in v1.12.24 

func (s PutBucketEncryptionOutput) GoString() string

GoString returns the string representation

func (PutBucketEncryptionOutput) String added in v1.12.24 

func (s PutBucketEncryptionOutput) String() string

String returns the string representation

type PutBucketInventoryConfigurationInput added in v1.5.11 

type PutBucketInventoryConfigurationInput struct {

	// The name of the bucket where the inventory configuration will be stored.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// The ID used to identify the inventory configuration.
	//
	// Id is a required field
	Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`

	// Specifies the inventory configuration.
	//
	// InventoryConfiguration is a required field
	InventoryConfiguration *InventoryConfiguration `locationName:"InventoryConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
	// contains filtered or unexported fields
}

func (PutBucketInventoryConfigurationInput) GoString added in v1.5.11 

func (s PutBucketInventoryConfigurationInput) GoString() string

GoString returns the string representation

func (*PutBucketInventoryConfigurationInput) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*PutBucketInventoryConfigurationInput) SetId added in v1.5.11 

func (s *PutBucketInventoryConfigurationInput) SetId(v string) *PutBucketInventoryConfigurationInput

SetId sets the Id field's value.

func (*PutBucketInventoryConfigurationInput) SetInventoryConfiguration added in v1.5.11 

func (s *PutBucketInventoryConfigurationInput) SetInventoryConfiguration(v *InventoryConfiguration) *PutBucketInventoryConfigurationInput

SetInventoryConfiguration sets the InventoryConfiguration field's value.

func (PutBucketInventoryConfigurationInput) String added in v1.5.11 

func (s PutBucketInventoryConfigurationInput) String() string

String returns the string representation

func (*PutBucketInventoryConfigurationInput) Validate added in v1.5.11 

func (s *PutBucketInventoryConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketInventoryConfigurationOutput added in v1.5.11 

type PutBucketInventoryConfigurationOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketInventoryConfigurationOutput) GoString added in v1.5.11 

func (s PutBucketInventoryConfigurationOutput) GoString() string

GoString returns the string representation

func (PutBucketInventoryConfigurationOutput) String added in v1.5.11 

func (s PutBucketInventoryConfigurationOutput) String() string

String returns the string representation

type PutBucketLifecycleConfigurationInput added in v0.9.8 

type PutBucketLifecycleConfigurationInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	LifecycleConfiguration *BucketLifecycleConfiguration `locationName:"LifecycleConfiguration" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
	// contains filtered or unexported fields
}

func (PutBucketLifecycleConfigurationInput) GoString added in v0.9.8 

func (s PutBucketLifecycleConfigurationInput) GoString() string

GoString returns the string representation

func (*PutBucketLifecycleConfigurationInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*PutBucketLifecycleConfigurationInput) SetLifecycleConfiguration added in v1.5.0 

func (s *PutBucketLifecycleConfigurationInput) SetLifecycleConfiguration(v *BucketLifecycleConfiguration) *PutBucketLifecycleConfigurationInput

SetLifecycleConfiguration sets the LifecycleConfiguration field's value.

func (PutBucketLifecycleConfigurationInput) String added in v0.9.8 

func (s PutBucketLifecycleConfigurationInput) String() string

String returns the string representation

func (*PutBucketLifecycleConfigurationInput) Validate added in v1.1.21 

func (s *PutBucketLifecycleConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketLifecycleConfigurationOutput added in v0.9.8 

type PutBucketLifecycleConfigurationOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketLifecycleConfigurationOutput) GoString added in v0.9.8 

func (s PutBucketLifecycleConfigurationOutput) GoString() string

GoString returns the string representation

func (PutBucketLifecycleConfigurationOutput) String added in v0.9.8 

func (s PutBucketLifecycleConfigurationOutput) String() string

String returns the string representation

type PutBucketLifecycleInput 

type PutBucketLifecycleInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	LifecycleConfiguration *LifecycleConfiguration `locationName:"LifecycleConfiguration" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
	// contains filtered or unexported fields
}

func (PutBucketLifecycleInput) GoString added in v0.6.5 

func (s PutBucketLifecycleInput) GoString() string

GoString returns the string representation

func (*PutBucketLifecycleInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*PutBucketLifecycleInput) SetLifecycleConfiguration added in v1.5.0 

func (s *PutBucketLifecycleInput) SetLifecycleConfiguration(v *LifecycleConfiguration) *PutBucketLifecycleInput

SetLifecycleConfiguration sets the LifecycleConfiguration field's value.

func (PutBucketLifecycleInput) String added in v0.6.5 

func (s PutBucketLifecycleInput) String() string

String returns the string representation

func (*PutBucketLifecycleInput) Validate added in v1.1.21 

func (s *PutBucketLifecycleInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketLifecycleOutput 

type PutBucketLifecycleOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketLifecycleOutput) GoString added in v0.6.5 

func (s PutBucketLifecycleOutput) GoString() string

GoString returns the string representation

func (PutBucketLifecycleOutput) String added in v0.6.5 

func (s PutBucketLifecycleOutput) String() string

String returns the string representation

type PutBucketLoggingInput 

type PutBucketLoggingInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// BucketLoggingStatus is a required field
	BucketLoggingStatus *BucketLoggingStatus `locationName:"BucketLoggingStatus" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
	// contains filtered or unexported fields
}

func (PutBucketLoggingInput) GoString added in v0.6.5 

func (s PutBucketLoggingInput) GoString() string

GoString returns the string representation

func (*PutBucketLoggingInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*PutBucketLoggingInput) SetBucketLoggingStatus added in v1.5.0 

func (s *PutBucketLoggingInput) SetBucketLoggingStatus(v *BucketLoggingStatus) *PutBucketLoggingInput

SetBucketLoggingStatus sets the BucketLoggingStatus field's value.

func (PutBucketLoggingInput) String added in v0.6.5 

func (s PutBucketLoggingInput) String() string

String returns the string representation

func (*PutBucketLoggingInput) Validate added in v1.1.21 

func (s *PutBucketLoggingInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketLoggingOutput 

type PutBucketLoggingOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketLoggingOutput) GoString added in v0.6.5 

func (s PutBucketLoggingOutput) GoString() string

GoString returns the string representation

func (PutBucketLoggingOutput) String added in v0.6.5 

func (s PutBucketLoggingOutput) String() string

String returns the string representation

type PutBucketMetricsConfigurationInput added in v1.5.11 

type PutBucketMetricsConfigurationInput struct {

	// The name of the bucket for which the metrics configuration is set.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// The ID used to identify the metrics configuration.
	//
	// Id is a required field
	Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`

	// Specifies the metrics configuration.
	//
	// MetricsConfiguration is a required field
	MetricsConfiguration *MetricsConfiguration `locationName:"MetricsConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
	// contains filtered or unexported fields
}

func (PutBucketMetricsConfigurationInput) GoString added in v1.5.11 

func (s PutBucketMetricsConfigurationInput) GoString() string

GoString returns the string representation

func (*PutBucketMetricsConfigurationInput) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*PutBucketMetricsConfigurationInput) SetId added in v1.5.11 

func (s *PutBucketMetricsConfigurationInput) SetId(v string) *PutBucketMetricsConfigurationInput

SetId sets the Id field's value.

func (*PutBucketMetricsConfigurationInput) SetMetricsConfiguration added in v1.5.11 

func (s *PutBucketMetricsConfigurationInput) SetMetricsConfiguration(v *MetricsConfiguration) *PutBucketMetricsConfigurationInput

SetMetricsConfiguration sets the MetricsConfiguration field's value.

func (PutBucketMetricsConfigurationInput) String added in v1.5.11 

func (s PutBucketMetricsConfigurationInput) String() string

String returns the string representation

func (*PutBucketMetricsConfigurationInput) Validate added in v1.5.11 

func (s *PutBucketMetricsConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketMetricsConfigurationOutput added in v1.5.11 

type PutBucketMetricsConfigurationOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketMetricsConfigurationOutput) GoString added in v1.5.11 

func (s PutBucketMetricsConfigurationOutput) GoString() string

GoString returns the string representation

func (PutBucketMetricsConfigurationOutput) String added in v1.5.11 

func (s PutBucketMetricsConfigurationOutput) String() string

String returns the string representation

type PutBucketNotificationConfigurationInput 

type PutBucketNotificationConfigurationInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Container for specifying the notification configuration of the bucket. If
	// this element is empty, notifications are turned off on the bucket.
	//
	// NotificationConfiguration is a required field
	NotificationConfiguration *NotificationConfiguration `locationName:"NotificationConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
	// contains filtered or unexported fields
}

func (PutBucketNotificationConfigurationInput) GoString added in v0.6.5 

func (s PutBucketNotificationConfigurationInput) GoString() string

GoString returns the string representation

func (*PutBucketNotificationConfigurationInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*PutBucketNotificationConfigurationInput) SetNotificationConfiguration added in v1.5.0 

func (s *PutBucketNotificationConfigurationInput) SetNotificationConfiguration(v *NotificationConfiguration) *PutBucketNotificationConfigurationInput

SetNotificationConfiguration sets the NotificationConfiguration field's value.

func (PutBucketNotificationConfigurationInput) String added in v0.6.5 

func (s PutBucketNotificationConfigurationInput) String() string

String returns the string representation

func (*PutBucketNotificationConfigurationInput) Validate added in v1.1.21 

func (s *PutBucketNotificationConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketNotificationConfigurationOutput 

type PutBucketNotificationConfigurationOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketNotificationConfigurationOutput) GoString added in v0.6.5 

func (s PutBucketNotificationConfigurationOutput) GoString() string

GoString returns the string representation

func (PutBucketNotificationConfigurationOutput) String added in v0.6.5 

func (s PutBucketNotificationConfigurationOutput) String() string

String returns the string representation

type PutBucketNotificationInput 

type PutBucketNotificationInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// NotificationConfiguration is a required field
	NotificationConfiguration *NotificationConfigurationDeprecated `locationName:"NotificationConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
	// contains filtered or unexported fields
}

func (PutBucketNotificationInput) GoString added in v0.6.5 

func (s PutBucketNotificationInput) GoString() string

GoString returns the string representation

func (*PutBucketNotificationInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*PutBucketNotificationInput) SetNotificationConfiguration added in v1.5.0 

func (s *PutBucketNotificationInput) SetNotificationConfiguration(v *NotificationConfigurationDeprecated) *PutBucketNotificationInput

SetNotificationConfiguration sets the NotificationConfiguration field's value.

func (PutBucketNotificationInput) String added in v0.6.5 

func (s PutBucketNotificationInput) String() string

String returns the string representation

func (*PutBucketNotificationInput) Validate added in v1.1.21 

func (s *PutBucketNotificationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketNotificationOutput 

type PutBucketNotificationOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketNotificationOutput) GoString added in v0.6.5 

func (s PutBucketNotificationOutput) GoString() string

GoString returns the string representation

func (PutBucketNotificationOutput) String added in v0.6.5 

func (s PutBucketNotificationOutput) String() string

String returns the string representation

type PutBucketPolicyInput 

type PutBucketPolicyInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Set this parameter to true to confirm that you want to remove your permissions
	// to change this bucket policy in the future.
	ConfirmRemoveSelfBucketAccess *bool `location:"header" locationName:"x-amz-confirm-remove-self-bucket-access" type:"boolean"`

	// The bucket policy as a JSON document.
	//
	// Policy is a required field
	Policy *string `type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (PutBucketPolicyInput) GoString added in v0.6.5 

func (s PutBucketPolicyInput) GoString() string

GoString returns the string representation

func (*PutBucketPolicyInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*PutBucketPolicyInput) SetConfirmRemoveSelfBucketAccess added in v1.12.24 

func (s *PutBucketPolicyInput) SetConfirmRemoveSelfBucketAccess(v bool) *PutBucketPolicyInput

SetConfirmRemoveSelfBucketAccess sets the ConfirmRemoveSelfBucketAccess field's value.

func (*PutBucketPolicyInput) SetPolicy added in v1.5.0 

func (s *PutBucketPolicyInput) SetPolicy(v string) *PutBucketPolicyInput

SetPolicy sets the Policy field's value.

func (PutBucketPolicyInput) String added in v0.6.5 

func (s PutBucketPolicyInput) String() string

String returns the string representation

func (*PutBucketPolicyInput) Validate added in v1.1.21 

func (s *PutBucketPolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketPolicyOutput 

type PutBucketPolicyOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketPolicyOutput) GoString added in v0.6.5 

func (s PutBucketPolicyOutput) GoString() string

GoString returns the string representation

func (PutBucketPolicyOutput) String added in v0.6.5 

func (s PutBucketPolicyOutput) String() string

String returns the string representation

type PutBucketReplicationInput 

type PutBucketReplicationInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Container for replication rules. You can add as many as 1,000 rules. Total
	// replication configuration size can be up to 2 MB.
	//
	// ReplicationConfiguration is a required field
	ReplicationConfiguration *ReplicationConfiguration `locationName:"ReplicationConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
	// contains filtered or unexported fields
}

func (PutBucketReplicationInput) GoString added in v0.6.5 

func (s PutBucketReplicationInput) GoString() string

GoString returns the string representation

func (*PutBucketReplicationInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*PutBucketReplicationInput) SetReplicationConfiguration added in v1.5.0 

func (s *PutBucketReplicationInput) SetReplicationConfiguration(v *ReplicationConfiguration) *PutBucketReplicationInput

SetReplicationConfiguration sets the ReplicationConfiguration field's value.

func (PutBucketReplicationInput) String added in v0.6.5 

func (s PutBucketReplicationInput) String() string

String returns the string representation

func (*PutBucketReplicationInput) Validate added in v1.1.21 

func (s *PutBucketReplicationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketReplicationOutput 

type PutBucketReplicationOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketReplicationOutput) GoString added in v0.6.5 

func (s PutBucketReplicationOutput) GoString() string

GoString returns the string representation

func (PutBucketReplicationOutput) String added in v0.6.5 

func (s PutBucketReplicationOutput) String() string

String returns the string representation

type PutBucketRequestPaymentInput 

type PutBucketRequestPaymentInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// RequestPaymentConfiguration is a required field
	RequestPaymentConfiguration *RequestPaymentConfiguration `locationName:"RequestPaymentConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
	// contains filtered or unexported fields
}

func (PutBucketRequestPaymentInput) GoString added in v0.6.5 

func (s PutBucketRequestPaymentInput) GoString() string

GoString returns the string representation

func (*PutBucketRequestPaymentInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*PutBucketRequestPaymentInput) SetRequestPaymentConfiguration added in v1.5.0 

func (s *PutBucketRequestPaymentInput) SetRequestPaymentConfiguration(v *RequestPaymentConfiguration) *PutBucketRequestPaymentInput

SetRequestPaymentConfiguration sets the RequestPaymentConfiguration field's value.

func (PutBucketRequestPaymentInput) String added in v0.6.5 

func (s PutBucketRequestPaymentInput) String() string

String returns the string representation

func (*PutBucketRequestPaymentInput) Validate added in v1.1.21 

func (s *PutBucketRequestPaymentInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketRequestPaymentOutput 

type PutBucketRequestPaymentOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketRequestPaymentOutput) GoString added in v0.6.5 

func (s PutBucketRequestPaymentOutput) GoString() string

GoString returns the string representation

func (PutBucketRequestPaymentOutput) String added in v0.6.5 

func (s PutBucketRequestPaymentOutput) String() string

String returns the string representation

type PutBucketTaggingInput 

type PutBucketTaggingInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Tagging is a required field
	Tagging *Tagging `locationName:"Tagging" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
	// contains filtered or unexported fields
}

func (PutBucketTaggingInput) GoString added in v0.6.5 

func (s PutBucketTaggingInput) GoString() string

GoString returns the string representation

func (*PutBucketTaggingInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*PutBucketTaggingInput) SetTagging added in v1.5.0 

func (s *PutBucketTaggingInput) SetTagging(v *Tagging) *PutBucketTaggingInput

SetTagging sets the Tagging field's value.

func (PutBucketTaggingInput) String added in v0.6.5 

func (s PutBucketTaggingInput) String() string

String returns the string representation

func (*PutBucketTaggingInput) Validate added in v1.1.21 

func (s *PutBucketTaggingInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketTaggingOutput 

type PutBucketTaggingOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketTaggingOutput) GoString added in v0.6.5 

func (s PutBucketTaggingOutput) GoString() string

GoString returns the string representation

func (PutBucketTaggingOutput) String added in v0.6.5 

func (s PutBucketTaggingOutput) String() string

String returns the string representation

type PutBucketVersioningInput 

type PutBucketVersioningInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// The concatenation of the authentication device's serial number, a space,
	// and the value that is displayed on your authentication device.
	MFA *string `location:"header" locationName:"x-amz-mfa" type:"string"`

	// VersioningConfiguration is a required field
	VersioningConfiguration *VersioningConfiguration `locationName:"VersioningConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
	// contains filtered or unexported fields
}

func (PutBucketVersioningInput) GoString added in v0.6.5 

func (s PutBucketVersioningInput) GoString() string

GoString returns the string representation

func (*PutBucketVersioningInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*PutBucketVersioningInput) SetMFA added in v1.5.0 

func (s *PutBucketVersioningInput) SetMFA(v string) *PutBucketVersioningInput

SetMFA sets the MFA field's value.

func (*PutBucketVersioningInput) SetVersioningConfiguration added in v1.5.0 

func (s *PutBucketVersioningInput) SetVersioningConfiguration(v *VersioningConfiguration) *PutBucketVersioningInput

SetVersioningConfiguration sets the VersioningConfiguration field's value.

func (PutBucketVersioningInput) String added in v0.6.5 

func (s PutBucketVersioningInput) String() string

String returns the string representation

func (*PutBucketVersioningInput) Validate added in v1.1.21 

func (s *PutBucketVersioningInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketVersioningOutput 

type PutBucketVersioningOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketVersioningOutput) GoString added in v0.6.5 

func (s PutBucketVersioningOutput) GoString() string

GoString returns the string representation

func (PutBucketVersioningOutput) String added in v0.6.5 

func (s PutBucketVersioningOutput) String() string

String returns the string representation

type PutBucketWebsiteInput 

type PutBucketWebsiteInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// WebsiteConfiguration is a required field
	WebsiteConfiguration *WebsiteConfiguration `locationName:"WebsiteConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
	// contains filtered or unexported fields
}

func (PutBucketWebsiteInput) GoString added in v0.6.5 

func (s PutBucketWebsiteInput) GoString() string

GoString returns the string representation

func (*PutBucketWebsiteInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*PutBucketWebsiteInput) SetWebsiteConfiguration added in v1.5.0 

func (s *PutBucketWebsiteInput) SetWebsiteConfiguration(v *WebsiteConfiguration) *PutBucketWebsiteInput

SetWebsiteConfiguration sets the WebsiteConfiguration field's value.

func (PutBucketWebsiteInput) String added in v0.6.5 

func (s PutBucketWebsiteInput) String() string

String returns the string representation

func (*PutBucketWebsiteInput) Validate added in v1.1.21 

func (s *PutBucketWebsiteInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutBucketWebsiteOutput 

type PutBucketWebsiteOutput struct {
	// contains filtered or unexported fields
}

func (PutBucketWebsiteOutput) GoString added in v0.6.5 

func (s PutBucketWebsiteOutput) GoString() string

GoString returns the string representation

func (PutBucketWebsiteOutput) String added in v0.6.5 

func (s PutBucketWebsiteOutput) String() string

String returns the string representation

type PutObjectAclInput added in v0.9.5 

type PutObjectAclInput struct {

	// The canned ACL to apply to the object.
	ACL *string `location:"header" locationName:"x-amz-acl" type:"string" enum:"ObjectCannedACL"`

	AccessControlPolicy *AccessControlPolicy `locationName:"AccessControlPolicy" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Allows grantee the read, write, read ACP, and write ACP permissions on the
	// bucket.
	GrantFullControl *string `location:"header" locationName:"x-amz-grant-full-control" type:"string"`

	// Allows grantee to list the objects in the bucket.
	GrantRead *string `location:"header" locationName:"x-amz-grant-read" type:"string"`

	// Allows grantee to read the bucket ACL.
	GrantReadACP *string `location:"header" locationName:"x-amz-grant-read-acp" type:"string"`

	// Allows grantee to create, overwrite, and delete any object in the bucket.
	GrantWrite *string `location:"header" locationName:"x-amz-grant-write" type:"string"`

	// Allows grantee to write the ACL for the applicable bucket.
	GrantWriteACP *string `location:"header" locationName:"x-amz-grant-write-acp" type:"string"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`

	// VersionId used to reference a specific version of the object.
	VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
	// contains filtered or unexported fields
}

func (PutObjectAclInput) GoString added in v0.9.5 

func (s PutObjectAclInput) GoString() string

GoString returns the string representation

func (*PutObjectAclInput) SetACL added in v1.5.0 

func (s *PutObjectAclInput) SetACL(v string) *PutObjectAclInput

SetACL sets the ACL field's value.

func (*PutObjectAclInput) SetAccessControlPolicy added in v1.5.0 

func (s *PutObjectAclInput) SetAccessControlPolicy(v *AccessControlPolicy) *PutObjectAclInput

SetAccessControlPolicy sets the AccessControlPolicy field's value.

func (*PutObjectAclInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*PutObjectAclInput) SetGrantFullControl added in v1.5.0 

func (s *PutObjectAclInput) SetGrantFullControl(v string) *PutObjectAclInput

SetGrantFullControl sets the GrantFullControl field's value.

func (*PutObjectAclInput) SetGrantRead added in v1.5.0 

func (s *PutObjectAclInput) SetGrantRead(v string) *PutObjectAclInput

SetGrantRead sets the GrantRead field's value.

func (*PutObjectAclInput) SetGrantReadACP added in v1.5.0 

func (s *PutObjectAclInput) SetGrantReadACP(v string) *PutObjectAclInput

SetGrantReadACP sets the GrantReadACP field's value.

func (*PutObjectAclInput) SetGrantWrite added in v1.5.0 

func (s *PutObjectAclInput) SetGrantWrite(v string) *PutObjectAclInput

SetGrantWrite sets the GrantWrite field's value.

func (*PutObjectAclInput) SetGrantWriteACP added in v1.5.0 

func (s *PutObjectAclInput) SetGrantWriteACP(v string) *PutObjectAclInput

SetGrantWriteACP sets the GrantWriteACP field's value.

func (*PutObjectAclInput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*PutObjectAclInput) SetRequestPayer added in v1.5.0 

func (s *PutObjectAclInput) SetRequestPayer(v string) *PutObjectAclInput

SetRequestPayer sets the RequestPayer field's value.

func (*PutObjectAclInput) SetVersionId added in v1.5.0 

func (s *PutObjectAclInput) SetVersionId(v string) *PutObjectAclInput

SetVersionId sets the VersionId field's value.

func (PutObjectAclInput) String added in v0.9.5 

func (s PutObjectAclInput) String() string

String returns the string representation

func (*PutObjectAclInput) Validate added in v1.1.21 

func (s *PutObjectAclInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutObjectAclOutput added in v0.9.5 

type PutObjectAclOutput struct {

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
	// contains filtered or unexported fields
}

func (PutObjectAclOutput) GoString added in v0.9.5 

func (s PutObjectAclOutput) GoString() string

GoString returns the string representation

func (*PutObjectAclOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (PutObjectAclOutput) String added in v0.9.5 

func (s PutObjectAclOutput) String() string

String returns the string representation

type PutObjectInput 

type PutObjectInput struct {

	// The canned ACL to apply to the object.
	ACL *string `location:"header" locationName:"x-amz-acl" type:"string" enum:"ObjectCannedACL"`

	// Object data.
	Body io.ReadSeeker `type:"blob"`

	// Name of the bucket to which the PUT operation was initiated.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Specifies caching behavior along the request/reply chain.
	CacheControl *string `location:"header" locationName:"Cache-Control" type:"string"`

	// Specifies presentational information for the object.
	ContentDisposition *string `location:"header" locationName:"Content-Disposition" type:"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.
	ContentEncoding *string `location:"header" locationName:"Content-Encoding" type:"string"`

	// The language the content is in.
	ContentLanguage *string `location:"header" locationName:"Content-Language" type:"string"`

	// Size of the body in bytes. This parameter is useful when the size of the
	// body cannot be determined automatically.
	ContentLength *int64 `location:"header" locationName:"Content-Length" type:"long"`

	// The base64-encoded 128-bit MD5 digest of the part data.
	ContentMD5 *string `location:"header" locationName:"Content-MD5" type:"string"`

	// A standard MIME type describing the format of the object data.
	ContentType *string `location:"header" locationName:"Content-Type" type:"string"`

	// The date and time at which the object is no longer cacheable.
	Expires *time.Time `location:"header" locationName:"Expires" type:"timestamp"`

	// Gives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object.
	GrantFullControl *string `location:"header" locationName:"x-amz-grant-full-control" type:"string"`

	// Allows grantee to read the object data and its metadata.
	GrantRead *string `location:"header" locationName:"x-amz-grant-read" type:"string"`

	// Allows grantee to read the object ACL.
	GrantReadACP *string `location:"header" locationName:"x-amz-grant-read-acp" type:"string"`

	// Allows grantee to write the ACL for the applicable object.
	GrantWriteACP *string `location:"header" locationName:"x-amz-grant-write-acp" type:"string"`

	// Object key for which the PUT operation was initiated.
	//
	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// A map of metadata to store with the object in S3.
	Metadata map[string]*string `location:"headers" locationName:"x-amz-meta-" type:"map"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`

	// Specifies the algorithm to use to when encrypting the object (e.g., AES256).
	SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"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
	// 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 `location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"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 the encryption
	// key was transmitted without error.
	SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`

	// 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
	SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string"`

	// The Server-side encryption algorithm used when storing this object in S3
	// (e.g., AES256, aws:kms).
	ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`

	// The type of storage to use for the object. Defaults to 'STANDARD'.
	StorageClass *string `location:"header" locationName:"x-amz-storage-class" type:"string" enum:"StorageClass"`

	// The tag-set for the object. The tag-set must be encoded as URL Query parameters
	Tagging *string `location:"header" locationName:"x-amz-tagging" type:"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.
	WebsiteRedirectLocation *string `location:"header" locationName:"x-amz-website-redirect-location" type:"string"`
	// contains filtered or unexported fields
}

func (PutObjectInput) GoString added in v0.6.5 

func (s PutObjectInput) GoString() string

GoString returns the string representation

func (*PutObjectInput) SetACL added in v1.5.0 

func (s *PutObjectInput) SetACL(v string) *PutObjectInput

SetACL sets the ACL field's value.

func (*PutObjectInput) SetBody added in v1.5.0 

func (s *PutObjectInput) SetBody(v io.ReadSeeker) *PutObjectInput

SetBody sets the Body field's value.

func (*PutObjectInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*PutObjectInput) SetCacheControl added in v1.5.0 

func (s *PutObjectInput) SetCacheControl(v string) *PutObjectInput

SetCacheControl sets the CacheControl field's value.

func (*PutObjectInput) SetContentDisposition added in v1.5.0 

func (s *PutObjectInput) SetContentDisposition(v string) *PutObjectInput

SetContentDisposition sets the ContentDisposition field's value.

func (*PutObjectInput) SetContentEncoding added in v1.5.0 

func (s *PutObjectInput) SetContentEncoding(v string) *PutObjectInput

SetContentEncoding sets the ContentEncoding field's value.

func (*PutObjectInput) SetContentLanguage added in v1.5.0 

func (s *PutObjectInput) SetContentLanguage(v string) *PutObjectInput

SetContentLanguage sets the ContentLanguage field's value.

func (*PutObjectInput) SetContentLength added in v1.5.0 

func (s *PutObjectInput) SetContentLength(v int64) *PutObjectInput

SetContentLength sets the ContentLength field's value.

func (*PutObjectInput) SetContentMD5 added in v1.12.2 

func (s *PutObjectInput) SetContentMD5(v string) *PutObjectInput

SetContentMD5 sets the ContentMD5 field's value.

func (*PutObjectInput) SetContentType added in v1.5.0 

func (s *PutObjectInput) SetContentType(v string) *PutObjectInput

SetContentType sets the ContentType field's value.

func (*PutObjectInput) SetExpires added in v1.5.0 

func (s *PutObjectInput) SetExpires(v time.Time) *PutObjectInput

SetExpires sets the Expires field's value.

func (*PutObjectInput) SetGrantFullControl added in v1.5.0 

func (s *PutObjectInput) SetGrantFullControl(v string) *PutObjectInput

SetGrantFullControl sets the GrantFullControl field's value.

func (*PutObjectInput) SetGrantRead added in v1.5.0 

func (s *PutObjectInput) SetGrantRead(v string) *PutObjectInput

SetGrantRead sets the GrantRead field's value.

func (*PutObjectInput) SetGrantReadACP added in v1.5.0 

func (s *PutObjectInput) SetGrantReadACP(v string) *PutObjectInput

SetGrantReadACP sets the GrantReadACP field's value.

func (*PutObjectInput) SetGrantWriteACP added in v1.5.0 

func (s *PutObjectInput) SetGrantWriteACP(v string) *PutObjectInput

SetGrantWriteACP sets the GrantWriteACP field's value.

func (*PutObjectInput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*PutObjectInput) SetMetadata added in v1.5.0 

func (s *PutObjectInput) SetMetadata(v map[string]*string) *PutObjectInput

SetMetadata sets the Metadata field's value.

func (*PutObjectInput) SetRequestPayer added in v1.5.0 

func (s *PutObjectInput) SetRequestPayer(v string) *PutObjectInput

SetRequestPayer sets the RequestPayer field's value.

func (*PutObjectInput) SetSSECustomerAlgorithm added in v1.5.0 

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

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.

func (*PutObjectInput) SetSSECustomerKey added in v1.5.0 

func (s *PutObjectInput) SetSSECustomerKey(v string) *PutObjectInput

SetSSECustomerKey sets the SSECustomerKey field's value.

func (*PutObjectInput) SetSSECustomerKeyMD5 added in v1.5.0 

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

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.

func (*PutObjectInput) SetSSEKMSKeyId added in v1.5.0 

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

SetSSEKMSKeyId sets the SSEKMSKeyId field's value.

func (*PutObjectInput) SetServerSideEncryption added in v1.5.0 

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

SetServerSideEncryption sets the ServerSideEncryption field's value.

func (*PutObjectInput) SetStorageClass added in v1.5.0 

func (s *PutObjectInput) SetStorageClass(v string) *PutObjectInput

SetStorageClass sets the StorageClass field's value.

func (*PutObjectInput) SetTagging added in v1.5.11 

func (s *PutObjectInput) SetTagging(v string) *PutObjectInput

SetTagging sets the Tagging field's value.

func (*PutObjectInput) SetWebsiteRedirectLocation added in v1.5.0 

func (s *PutObjectInput) SetWebsiteRedirectLocation(v string) *PutObjectInput

SetWebsiteRedirectLocation sets the WebsiteRedirectLocation field's value.

func (PutObjectInput) String added in v0.6.5 

func (s PutObjectInput) String() string

String returns the string representation

func (*PutObjectInput) Validate added in v1.1.21 

func (s *PutObjectInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutObjectOutput 

type PutObjectOutput struct {

	// Entity tag for the uploaded object.
	ETag *string `location:"header" locationName:"ETag" type:"string"`

	// If the object expiration is configured, this will contain the expiration
	// date (expiry-date) and rule ID (rule-id). The value of rule-id is URL encoded.
	Expiration *string `location:"header" locationName:"x-amz-expiration" type:"string"`

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"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 `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 to provide round trip message integrity
	// verification of the customer-provided encryption key.
	SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`

	// If present, specifies the ID of the AWS Key Management Service (KMS) master
	// encryption key that was used for the object.
	SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string"`

	// The Server-side encryption algorithm used when storing this object in S3
	// (e.g., AES256, aws:kms).
	ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`

	// Version of the object.
	VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
	// contains filtered or unexported fields
}

func (PutObjectOutput) GoString added in v0.6.5 

func (s PutObjectOutput) GoString() string

GoString returns the string representation

func (*PutObjectOutput) SetETag added in v1.5.0 

func (s *PutObjectOutput) SetETag(v string) *PutObjectOutput

SetETag sets the ETag field's value.

func (*PutObjectOutput) SetExpiration added in v1.5.0 

func (s *PutObjectOutput) SetExpiration(v string) *PutObjectOutput

SetExpiration sets the Expiration field's value.

func (*PutObjectOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (*PutObjectOutput) SetSSECustomerAlgorithm added in v1.5.0 

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

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.

func (*PutObjectOutput) SetSSECustomerKeyMD5 added in v1.5.0 

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

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.

func (*PutObjectOutput) SetSSEKMSKeyId added in v1.5.0 

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

SetSSEKMSKeyId sets the SSEKMSKeyId field's value.

func (*PutObjectOutput) SetServerSideEncryption added in v1.5.0 

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

SetServerSideEncryption sets the ServerSideEncryption field's value.

func (*PutObjectOutput) SetVersionId added in v1.5.0 

func (s *PutObjectOutput) SetVersionId(v string) *PutObjectOutput

SetVersionId sets the VersionId field's value.

func (PutObjectOutput) String added in v0.6.5 

func (s PutObjectOutput) String() string

String returns the string representation

type PutObjectTaggingInput added in v1.5.11 

type PutObjectTaggingInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// Tagging is a required field
	Tagging *Tagging `locationName:"Tagging" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`

	VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
	// contains filtered or unexported fields
}

func (PutObjectTaggingInput) GoString added in v1.5.11 

func (s PutObjectTaggingInput) GoString() string

GoString returns the string representation

func (*PutObjectTaggingInput) SetBucket added in v1.5.11 

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

SetBucket sets the Bucket field's value.

func (*PutObjectTaggingInput) SetKey added in v1.5.11 

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

SetKey sets the Key field's value.

func (*PutObjectTaggingInput) SetTagging added in v1.5.11 

func (s *PutObjectTaggingInput) SetTagging(v *Tagging) *PutObjectTaggingInput

SetTagging sets the Tagging field's value.

func (*PutObjectTaggingInput) SetVersionId added in v1.5.11 

func (s *PutObjectTaggingInput) SetVersionId(v string) *PutObjectTaggingInput

SetVersionId sets the VersionId field's value.

func (PutObjectTaggingInput) String added in v1.5.11 

func (s PutObjectTaggingInput) String() string

String returns the string representation

func (*PutObjectTaggingInput) Validate added in v1.5.11 

func (s *PutObjectTaggingInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutObjectTaggingOutput added in v1.5.11 

type PutObjectTaggingOutput struct {
	VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
	// contains filtered or unexported fields
}

func (PutObjectTaggingOutput) GoString added in v1.5.11 

func (s PutObjectTaggingOutput) GoString() string

GoString returns the string representation

func (*PutObjectTaggingOutput) SetVersionId added in v1.5.11 

func (s *PutObjectTaggingOutput) SetVersionId(v string) *PutObjectTaggingOutput

SetVersionId sets the VersionId field's value.

func (PutObjectTaggingOutput) String added in v1.5.11 

func (s PutObjectTaggingOutput) String() string

String returns the string representation

type QueueConfiguration 

type QueueConfiguration struct {

	// Events is a required field
	Events []*string `locationName:"Event" type:"list" flattened:"true" required:"true"`

	// Container for object key name filtering rules. For information about key
	// name filtering, go to Configuring Event Notifications (http://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html)
	// in the Amazon Simple Storage Service Developer Guide.
	Filter *NotificationConfigurationFilter `type:"structure"`

	// Optional unique identifier for configurations in a notification configuration.
	// If you don't provide one, Amazon S3 will assign an ID.
	Id *string `type:"string"`

	// Amazon SQS queue ARN to which Amazon S3 will publish a message when it detects
	// events of specified type.
	//
	// QueueArn is a required field
	QueueArn *string `locationName:"Queue" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Container for specifying an configuration when you want Amazon S3 to publish events to an Amazon Simple Queue Service (Amazon SQS) queue.

func (QueueConfiguration) GoString added in v0.6.5 

func (s QueueConfiguration) GoString() string

GoString returns the string representation

func (*QueueConfiguration) SetEvents added in v1.5.0 

func (s *QueueConfiguration) SetEvents(v []*string) *QueueConfiguration

SetEvents sets the Events field's value.

func (*QueueConfiguration) SetFilter added in v1.5.0 

func (s *QueueConfiguration) SetFilter(v *NotificationConfigurationFilter) *QueueConfiguration

SetFilter sets the Filter field's value.

func (*QueueConfiguration) SetId added in v1.5.0 

func (s *QueueConfiguration) SetId(v string) *QueueConfiguration

SetId sets the Id field's value.

func (*QueueConfiguration) SetQueueArn added in v1.5.0 

func (s *QueueConfiguration) SetQueueArn(v string) *QueueConfiguration

SetQueueArn sets the QueueArn field's value.

func (QueueConfiguration) String added in v0.6.5 

func (s QueueConfiguration) String() string

String returns the string representation

func (*QueueConfiguration) Validate added in v1.1.21 

func (s *QueueConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type QueueConfigurationDeprecated 

type QueueConfigurationDeprecated struct {

	// Bucket event for which to send notifications.
	//
	// Deprecated: Event has been deprecated
	Event *string `deprecated:"true" type:"string" enum:"Event"`

	Events []*string `locationName:"Event" type:"list" flattened:"true"`

	// Optional unique identifier for configurations in a notification configuration.
	// If you don't provide one, Amazon S3 will assign an ID.
	Id *string `type:"string"`

	Queue *string `type:"string"`
	// contains filtered or unexported fields
}

func (QueueConfigurationDeprecated) GoString added in v0.6.5 

func (s QueueConfigurationDeprecated) GoString() string

GoString returns the string representation

func (*QueueConfigurationDeprecated) SetEvent added in v1.5.0 

func (s *QueueConfigurationDeprecated) SetEvent(v string) *QueueConfigurationDeprecated

SetEvent sets the Event field's value.

func (*QueueConfigurationDeprecated) SetEvents added in v1.5.0 

func (s *QueueConfigurationDeprecated) SetEvents(v []*string) *QueueConfigurationDeprecated

SetEvents sets the Events field's value.

func (*QueueConfigurationDeprecated) SetId added in v1.5.0 

func (s *QueueConfigurationDeprecated) SetId(v string) *QueueConfigurationDeprecated

SetId sets the Id field's value.

func (*QueueConfigurationDeprecated) SetQueue added in v1.5.0 

func (s *QueueConfigurationDeprecated) SetQueue(v string) *QueueConfigurationDeprecated

SetQueue sets the Queue field's value.

func (QueueConfigurationDeprecated) String added in v0.6.5 

func (s QueueConfigurationDeprecated) String() string

String returns the string representation

type RecordsEvent added in v1.14.0 

type RecordsEvent struct {

	// The byte array of partial, one or more result records.
	//
	// Payload is automatically base64 encoded/decoded by the SDK.
	Payload []byte `type:"blob"`
	// contains filtered or unexported fields
}

func (RecordsEvent) GoString added in v1.14.0 

func (s RecordsEvent) GoString() string

GoString returns the string representation

func (*RecordsEvent) SetPayload added in v1.14.0 

func (s *RecordsEvent) SetPayload(v []byte) *RecordsEvent

SetPayload sets the Payload field's value.

func (RecordsEvent) String added in v1.14.0 

func (s RecordsEvent) String() string

String returns the string representation

func (*RecordsEvent) UnmarshalEvent added in v1.14.0 

func (s *RecordsEvent) UnmarshalEvent(
	payloadUnmarshaler protocol.PayloadUnmarshaler,
	msg eventstream.Message,
) error

UnmarshalEvent unmarshals the EventStream Message into the RecordsEvent value. This method is only used internally within the SDK's EventStream handling.

type Redirect 

type Redirect struct {

	// The host name to use in the redirect request.
	HostName *string `type:"string"`

	// The HTTP redirect code to use on the response. Not required if one of the
	// siblings is present.
	HttpRedirectCode *string `type:"string"`

	// Protocol to use (http, https) when redirecting requests. The default is the
	// protocol that is used in the original request.
	Protocol *string `type:"string" enum:"Protocol"`

	// The object key prefix to use in the redirect request. For example, to redirect
	// requests for all pages with prefix docs/ (objects in the docs/ folder) to
	// documents/, you can set a condition block with KeyPrefixEquals set to docs/
	// and in the Redirect set ReplaceKeyPrefixWith to /documents. Not required
	// if one of the siblings is present. Can be present only if ReplaceKeyWith
	// is not provided.
	ReplaceKeyPrefixWith *string `type:"string"`

	// The specific object key to use in the redirect request. For example, redirect
	// request to error.html. Not required if one of the sibling is present. Can
	// be present only if ReplaceKeyPrefixWith is not provided.
	ReplaceKeyWith *string `type:"string"`
	// contains filtered or unexported fields
}

func (Redirect) GoString added in v0.6.5 

func (s Redirect) GoString() string

GoString returns the string representation

func (*Redirect) SetHostName added in v1.5.0 

func (s *Redirect) SetHostName(v string) *Redirect

SetHostName sets the HostName field's value.

func (*Redirect) SetHttpRedirectCode added in v1.5.0 

func (s *Redirect) SetHttpRedirectCode(v string) *Redirect

SetHttpRedirectCode sets the HttpRedirectCode field's value.

func (*Redirect) SetProtocol added in v1.5.0 

func (s *Redirect) SetProtocol(v string) *Redirect

SetProtocol sets the Protocol field's value.

func (*Redirect) SetReplaceKeyPrefixWith added in v1.5.0 

func (s *Redirect) SetReplaceKeyPrefixWith(v string) *Redirect

SetReplaceKeyPrefixWith sets the ReplaceKeyPrefixWith field's value.

func (*Redirect) SetReplaceKeyWith added in v1.5.0 

func (s *Redirect) SetReplaceKeyWith(v string) *Redirect

SetReplaceKeyWith sets the ReplaceKeyWith field's value.

func (Redirect) String added in v0.6.5 

func (s Redirect) String() string

String returns the string representation

type RedirectAllRequestsTo 

type RedirectAllRequestsTo struct {

	// Name of the host where requests will be redirected.
	//
	// HostName is a required field
	HostName *string `type:"string" required:"true"`

	// Protocol to use (http, https) when redirecting requests. The default is the
	// protocol that is used in the original request.
	Protocol *string `type:"string" enum:"Protocol"`
	// contains filtered or unexported fields
}

func (RedirectAllRequestsTo) GoString added in v0.6.5 

func (s RedirectAllRequestsTo) GoString() string

GoString returns the string representation

func (*RedirectAllRequestsTo) SetHostName added in v1.5.0 

func (s *RedirectAllRequestsTo) SetHostName(v string) *RedirectAllRequestsTo

SetHostName sets the HostName field's value.

func (*RedirectAllRequestsTo) SetProtocol added in v1.5.0 

func (s *RedirectAllRequestsTo) SetProtocol(v string) *RedirectAllRequestsTo

SetProtocol sets the Protocol field's value.

func (RedirectAllRequestsTo) String added in v0.6.5 

func (s RedirectAllRequestsTo) String() string

String returns the string representation

func (*RedirectAllRequestsTo) Validate added in v1.1.21 

func (s *RedirectAllRequestsTo) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ReplicationConfiguration 

type ReplicationConfiguration struct {

	// Amazon Resource Name (ARN) of an IAM role for Amazon S3 to assume when replicating
	// the objects.
	//
	// Role is a required field
	Role *string `type:"string" required:"true"`

	// Container for one or more replication rules. Replication configuration must
	// have at least one rule and can contain up to 1,000 rules.
	//
	// Rules is a required field
	Rules []*ReplicationRule `locationName:"Rule" type:"list" flattened:"true" required:"true"`
	// contains filtered or unexported fields
}

Container for replication rules. You can add as many as 1,000 rules. Total replication configuration size can be up to 2 MB.

func (ReplicationConfiguration) GoString added in v0.6.5 

func (s ReplicationConfiguration) GoString() string

GoString returns the string representation

func (*ReplicationConfiguration) SetRole added in v1.5.0 

func (s *ReplicationConfiguration) SetRole(v string) *ReplicationConfiguration

SetRole sets the Role field's value.

func (*ReplicationConfiguration) SetRules added in v1.5.0 

func (s *ReplicationConfiguration) SetRules(v []*ReplicationRule) *ReplicationConfiguration

SetRules sets the Rules field's value.

func (ReplicationConfiguration) String added in v0.6.5 

func (s ReplicationConfiguration) String() string

String returns the string representation

func (*ReplicationConfiguration) Validate added in v1.1.21 

func (s *ReplicationConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ReplicationRule 

type ReplicationRule struct {

	// Specifies whether Amazon S3 should replicate delete makers.
	DeleteMarkerReplication *DeleteMarkerReplication `type:"structure"`

	// Container for replication destination information.
	//
	// Destination is a required field
	Destination *Destination `type:"structure" required:"true"`

	// Filter that identifies subset of objects to which the replication rule applies.
	// A Filter must specify exactly one Prefix, Tag, or an And child element.
	Filter *ReplicationRuleFilter `type:"structure"`

	// Unique identifier for the rule. The value cannot be longer than 255 characters.
	ID *string `type:"string"`

	// Object keyname prefix identifying one or more objects to which the rule applies.
	// Maximum prefix length can be up to 1,024 characters.
	//
	// Deprecated: Prefix has been deprecated
	Prefix *string `deprecated:"true" type:"string"`

	// The priority associated with the rule. If you specify multiple rules in a
	// replication configuration, then Amazon S3 applies rule priority in the event
	// there are conflicts (two or more rules identify the same object based on
	// filter specified). The rule with higher priority takes precedence. For example,
	//
	//    * Same object quality prefix based filter criteria If prefixes you specified
	//    in multiple rules overlap.
	//
	//    * Same object qualify tag based filter criteria specified in multiple
	//    rules
	//
	// For more information, see Cross-Region Replication (CRR) ( https://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html)
	// in the Amazon S3 Developer Guide.
	Priority *int64 `type:"integer"`

	// Container that describes additional filters in identifying source objects
	// that you want to replicate. Currently, Amazon S3 supports only the filter
	// that you can specify for objects created with server-side encryption using
	// an AWS KMS-managed key. You can choose to enable or disable replication of
	// these objects.
	//
	// if you want Amazon S3 to replicate objects created with server-side encryption
	// using AWS KMS-managed keys.
	SourceSelectionCriteria *SourceSelectionCriteria `type:"structure"`

	// The rule is ignored if status is not Enabled.
	//
	// Status is a required field
	Status *string `type:"string" required:"true" enum:"ReplicationRuleStatus"`
	// contains filtered or unexported fields
}

Container for information about a particular replication rule.

func (ReplicationRule) GoString added in v0.6.5 

func (s ReplicationRule) GoString() string

GoString returns the string representation

func (*ReplicationRule) SetDeleteMarkerReplication added in v1.15.38 

func (s *ReplicationRule) SetDeleteMarkerReplication(v *DeleteMarkerReplication) *ReplicationRule

SetDeleteMarkerReplication sets the DeleteMarkerReplication field's value.

func (*ReplicationRule) SetDestination added in v1.5.0 

func (s *ReplicationRule) SetDestination(v *Destination) *ReplicationRule

SetDestination sets the Destination field's value.

func (*ReplicationRule) SetFilter added in v1.15.38 

func (s *ReplicationRule) SetFilter(v *ReplicationRuleFilter) *ReplicationRule

SetFilter sets the Filter field's value.

func (*ReplicationRule) SetID added in v1.5.0 

func (s *ReplicationRule) SetID(v string) *ReplicationRule

SetID sets the ID field's value.

func (*ReplicationRule) SetPrefix added in v1.5.0 

func (s *ReplicationRule) SetPrefix(v string) *ReplicationRule

SetPrefix sets the Prefix field's value.

func (*ReplicationRule) SetPriority added in v1.15.38 

func (s *ReplicationRule) SetPriority(v int64) *ReplicationRule

SetPriority sets the Priority field's value.

func (*ReplicationRule) SetSourceSelectionCriteria added in v1.12.24 

func (s *ReplicationRule) SetSourceSelectionCriteria(v *SourceSelectionCriteria) *ReplicationRule

SetSourceSelectionCriteria sets the SourceSelectionCriteria field's value.

func (*ReplicationRule) SetStatus added in v1.5.0 

func (s *ReplicationRule) SetStatus(v string) *ReplicationRule

SetStatus sets the Status field's value.

func (ReplicationRule) String added in v0.6.5 

func (s ReplicationRule) String() string

String returns the string representation

func (*ReplicationRule) Validate added in v1.1.21 

func (s *ReplicationRule) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ReplicationRuleAndOperator added in v1.15.38 

type ReplicationRuleAndOperator struct {
	Prefix *string `type:"string"`

	Tags []*Tag `locationName:"Tag" locationNameList:"Tag" type:"list" flattened:"true"`
	// contains filtered or unexported fields
}

func (ReplicationRuleAndOperator) GoString added in v1.15.38 

func (s ReplicationRuleAndOperator) GoString() string

GoString returns the string representation

func (*ReplicationRuleAndOperator) SetPrefix added in v1.15.38 

func (s *ReplicationRuleAndOperator) SetPrefix(v string) *ReplicationRuleAndOperator

SetPrefix sets the Prefix field's value.

func (*ReplicationRuleAndOperator) SetTags added in v1.15.38 

func (s *ReplicationRuleAndOperator) SetTags(v []*Tag) *ReplicationRuleAndOperator

SetTags sets the Tags field's value.

func (ReplicationRuleAndOperator) String added in v1.15.38 

func (s ReplicationRuleAndOperator) String() string

String returns the string representation

func (*ReplicationRuleAndOperator) Validate added in v1.15.38 

func (s *ReplicationRuleAndOperator) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ReplicationRuleFilter added in v1.15.38 

type ReplicationRuleFilter struct {

	// Container for specifying rule filters. These filters determine the subset
	// of objects to which the rule applies. The element is required only if you
	// specify more than one filter. For example:
	//
	//    * You specify both a Prefix and a Tag filters. Then you wrap these in
	//    an And tag.
	//
	//    * You specify filter based on multiple tags. Then you wrap the Tag elements
	//    in an And tag.
	And *ReplicationRuleAndOperator `type:"structure"`

	// Object keyname prefix that identifies subset of objects to which the rule
	// applies.
	Prefix *string `type:"string"`

	// Container for specifying a tag key and value.
	//
	// The rule applies only to objects having the tag in its tagset.
	Tag *Tag `type:"structure"`
	// contains filtered or unexported fields
}

Filter that identifies subset of objects to which the replication rule applies. A Filter must specify exactly one Prefix, Tag, or an And child element.

func (ReplicationRuleFilter) GoString added in v1.15.38 

func (s ReplicationRuleFilter) GoString() string

GoString returns the string representation

func (*ReplicationRuleFilter) SetAnd added in v1.15.38 

func (s *ReplicationRuleFilter) SetAnd(v *ReplicationRuleAndOperator) *ReplicationRuleFilter

SetAnd sets the And field's value.

func (*ReplicationRuleFilter) SetPrefix added in v1.15.38 

func (s *ReplicationRuleFilter) SetPrefix(v string) *ReplicationRuleFilter

SetPrefix sets the Prefix field's value.

func (*ReplicationRuleFilter) SetTag added in v1.15.38 

func (s *ReplicationRuleFilter) SetTag(v *Tag) *ReplicationRuleFilter

SetTag sets the Tag field's value.

func (ReplicationRuleFilter) String added in v1.15.38 

func (s ReplicationRuleFilter) String() string

String returns the string representation

func (*ReplicationRuleFilter) Validate added in v1.15.38 

func (s *ReplicationRuleFilter) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type RequestFailure added in v1.8.0 

type RequestFailure interface {
	awserr.RequestFailure

	// Host ID is the S3 Host ID needed for debug, and contacting support
	HostID() string
}

A RequestFailure provides access to the S3 Request ID and Host ID values returned from API operation errors. Getting the error as a string will return the formated error with the same information as awserr.RequestFailure, while also adding the HostID value from the response.

type RequestPaymentConfiguration 

type RequestPaymentConfiguration struct {

	// Specifies who pays for the download and request fees.
	//
	// Payer is a required field
	Payer *string `type:"string" required:"true" enum:"Payer"`
	// contains filtered or unexported fields
}

func (RequestPaymentConfiguration) GoString added in v0.6.5 

func (s RequestPaymentConfiguration) GoString() string

GoString returns the string representation

func (*RequestPaymentConfiguration) SetPayer added in v1.5.0 

func (s *RequestPaymentConfiguration) SetPayer(v string) *RequestPaymentConfiguration

SetPayer sets the Payer field's value.

func (RequestPaymentConfiguration) String added in v0.6.5 

func (s RequestPaymentConfiguration) String() string

String returns the string representation

func (*RequestPaymentConfiguration) Validate added in v1.1.21 

func (s *RequestPaymentConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type RequestProgress added in v1.14.0 

type RequestProgress struct {

	// Specifies whether periodic QueryProgress frames should be sent. Valid values:
	// TRUE, FALSE. Default value: FALSE.
	Enabled *bool `type:"boolean"`
	// contains filtered or unexported fields
}

func (RequestProgress) GoString added in v1.14.0 

func (s RequestProgress) GoString() string

GoString returns the string representation

func (*RequestProgress) SetEnabled added in v1.14.0 

func (s *RequestProgress) SetEnabled(v bool) *RequestProgress

SetEnabled sets the Enabled field's value.

func (RequestProgress) String added in v1.14.0 

func (s RequestProgress) String() string

String returns the string representation

type RestoreObjectInput 

type RestoreObjectInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`

	// Container for restore job parameters.
	RestoreRequest *RestoreRequest `locationName:"RestoreRequest" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`

	VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
	// contains filtered or unexported fields
}

func (RestoreObjectInput) GoString added in v0.6.5 

func (s RestoreObjectInput) GoString() string

GoString returns the string representation

func (*RestoreObjectInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*RestoreObjectInput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*RestoreObjectInput) SetRequestPayer added in v1.5.0 

func (s *RestoreObjectInput) SetRequestPayer(v string) *RestoreObjectInput

SetRequestPayer sets the RequestPayer field's value.

func (*RestoreObjectInput) SetRestoreRequest added in v1.5.0 

func (s *RestoreObjectInput) SetRestoreRequest(v *RestoreRequest) *RestoreObjectInput

SetRestoreRequest sets the RestoreRequest field's value.

func (*RestoreObjectInput) SetVersionId added in v1.5.0 

func (s *RestoreObjectInput) SetVersionId(v string) *RestoreObjectInput

SetVersionId sets the VersionId field's value.

func (RestoreObjectInput) String added in v0.6.5 

func (s RestoreObjectInput) String() string

String returns the string representation

func (*RestoreObjectInput) Validate added in v1.1.21 

func (s *RestoreObjectInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type RestoreObjectOutput 

type RestoreObjectOutput struct {

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`

	// Indicates the path in the provided S3 output location where Select results
	// will be restored to.
	RestoreOutputPath *string `location:"header" locationName:"x-amz-restore-output-path" type:"string"`
	// contains filtered or unexported fields
}

func (RestoreObjectOutput) GoString added in v0.6.5 

func (s RestoreObjectOutput) GoString() string

GoString returns the string representation

func (*RestoreObjectOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (*RestoreObjectOutput) SetRestoreOutputPath added in v1.12.36 

func (s *RestoreObjectOutput) SetRestoreOutputPath(v string) *RestoreObjectOutput

SetRestoreOutputPath sets the RestoreOutputPath field's value.

func (RestoreObjectOutput) String added in v0.6.5 

func (s RestoreObjectOutput) String() string

String returns the string representation

type RestoreRequest 

type RestoreRequest struct {

	// Lifetime of the active copy in days. Do not use with restores that specify
	// OutputLocation.
	Days *int64 `type:"integer"`

	// The optional description for the job.
	Description *string `type:"string"`

	// Glacier related parameters pertaining to this job. Do not use with restores
	// that specify OutputLocation.
	GlacierJobParameters *GlacierJobParameters `type:"structure"`

	// Describes the location where the restore job's output is stored.
	OutputLocation *OutputLocation `type:"structure"`

	// Describes the parameters for Select job types.
	SelectParameters *SelectParameters `type:"structure"`

	// Glacier retrieval tier at which the restore will be processed.
	Tier *string `type:"string" enum:"Tier"`

	// Type of restore request.
	Type *string `type:"string" enum:"RestoreRequestType"`
	// contains filtered or unexported fields
}

Container for restore job parameters.

func (RestoreRequest) GoString added in v0.6.5 

func (s RestoreRequest) GoString() string

GoString returns the string representation

func (*RestoreRequest) SetDays added in v1.5.0 

func (s *RestoreRequest) SetDays(v int64) *RestoreRequest

SetDays sets the Days field's value.

func (*RestoreRequest) SetDescription added in v1.12.36 

func (s *RestoreRequest) SetDescription(v string) *RestoreRequest

SetDescription sets the Description field's value.

func (*RestoreRequest) SetGlacierJobParameters added in v1.5.10 

func (s *RestoreRequest) SetGlacierJobParameters(v *GlacierJobParameters) *RestoreRequest

SetGlacierJobParameters sets the GlacierJobParameters field's value.

func (*RestoreRequest) SetOutputLocation added in v1.12.36 

func (s *RestoreRequest) SetOutputLocation(v *OutputLocation) *RestoreRequest

SetOutputLocation sets the OutputLocation field's value.

func (*RestoreRequest) SetSelectParameters added in v1.12.36 

func (s *RestoreRequest) SetSelectParameters(v *SelectParameters) *RestoreRequest

SetSelectParameters sets the SelectParameters field's value.

func (*RestoreRequest) SetTier added in v1.12.36 

func (s *RestoreRequest) SetTier(v string) *RestoreRequest

SetTier sets the Tier field's value.

func (*RestoreRequest) SetType added in v1.12.36 

func (s *RestoreRequest) SetType(v string) *RestoreRequest

SetType sets the Type field's value.

func (RestoreRequest) String added in v0.6.5 

func (s RestoreRequest) String() string

String returns the string representation

func (*RestoreRequest) Validate added in v1.1.21 

func (s *RestoreRequest) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type RoutingRule 

type RoutingRule struct {

	// A container for describing a condition that must be met for the specified
	// redirect to apply. For example, 1. If request is for pages in the /docs folder,
	// redirect to the /documents folder. 2. If request results in HTTP error 4xx,
	// redirect request to another host where you might process the error.
	Condition *Condition `type:"structure"`

	// Container for redirect information. You can redirect requests to another
	// host, to another page, or with another protocol. In the event of an error,
	// you can can specify a different error code to return.
	//
	// Redirect is a required field
	Redirect *Redirect `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

func (RoutingRule) GoString added in v0.6.5 

func (s RoutingRule) GoString() string

GoString returns the string representation

func (*RoutingRule) SetCondition added in v1.5.0 

func (s *RoutingRule) SetCondition(v *Condition) *RoutingRule

SetCondition sets the Condition field's value.

func (*RoutingRule) SetRedirect added in v1.5.0 

func (s *RoutingRule) SetRedirect(v *Redirect) *RoutingRule

SetRedirect sets the Redirect field's value.

func (RoutingRule) String added in v0.6.5 

func (s RoutingRule) String() string

String returns the string representation

func (*RoutingRule) Validate added in v1.1.21 

func (s *RoutingRule) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type Rule added in v0.9.8 

type Rule struct {

	// Specifies the days since the initiation of an Incomplete Multipart Upload
	// that Lifecycle will wait before permanently removing all parts of the upload.
	AbortIncompleteMultipartUpload *AbortIncompleteMultipartUpload `type:"structure"`

	Expiration *LifecycleExpiration `type:"structure"`

	// Unique identifier for the rule. The value cannot be longer than 255 characters.
	ID *string `type:"string"`

	// Specifies when noncurrent object versions expire. Upon expiration, Amazon
	// S3 permanently deletes the noncurrent object versions. You set this lifecycle
	// configuration action on a bucket that has versioning enabled (or suspended)
	// to request that Amazon S3 delete noncurrent object versions at a specific
	// period in the object's lifetime.
	NoncurrentVersionExpiration *NoncurrentVersionExpiration `type:"structure"`

	// Container for the transition rule that describes when noncurrent objects
	// transition to the STANDARD_IA, ONEZONE_IA or GLACIER storage class. If your
	// bucket is versioning-enabled (or versioning is suspended), you can set this
	// action to request that Amazon S3 transition noncurrent object versions to
	// the STANDARD_IA, ONEZONE_IA or GLACIER storage class at a specific period
	// in the object's lifetime.
	NoncurrentVersionTransition *NoncurrentVersionTransition `type:"structure"`

	// Prefix identifying one or more objects to which the rule applies.
	//
	// Prefix is a required field
	Prefix *string `type:"string" required:"true"`

	// If 'Enabled', the rule is currently being applied. If 'Disabled', the rule
	// is not currently being applied.
	//
	// Status is a required field
	Status *string `type:"string" required:"true" enum:"ExpirationStatus"`

	Transition *Transition `type:"structure"`
	// contains filtered or unexported fields
}

func (Rule) GoString added in v0.9.8 

func (s Rule) GoString() string

GoString returns the string representation

func (*Rule) SetAbortIncompleteMultipartUpload added in v1.5.0 

func (s *Rule) SetAbortIncompleteMultipartUpload(v *AbortIncompleteMultipartUpload) *Rule

SetAbortIncompleteMultipartUpload sets the AbortIncompleteMultipartUpload field's value.

func (*Rule) SetExpiration added in v1.5.0 

func (s *Rule) SetExpiration(v *LifecycleExpiration) *Rule

SetExpiration sets the Expiration field's value.

func (*Rule) SetID added in v1.5.0 

func (s *Rule) SetID(v string) *Rule

SetID sets the ID field's value.

func (*Rule) SetNoncurrentVersionExpiration added in v1.5.0 

func (s *Rule) SetNoncurrentVersionExpiration(v *NoncurrentVersionExpiration) *Rule

SetNoncurrentVersionExpiration sets the NoncurrentVersionExpiration field's value.

func (*Rule) SetNoncurrentVersionTransition added in v1.5.0 

func (s *Rule) SetNoncurrentVersionTransition(v *NoncurrentVersionTransition) *Rule

SetNoncurrentVersionTransition sets the NoncurrentVersionTransition field's value.

func (*Rule) SetPrefix added in v1.5.0 

func (s *Rule) SetPrefix(v string) *Rule

SetPrefix sets the Prefix field's value.

func (*Rule) SetStatus added in v1.5.0 

func (s *Rule) SetStatus(v string) *Rule

SetStatus sets the Status field's value.

func (*Rule) SetTransition added in v1.5.0 

func (s *Rule) SetTransition(v *Transition) *Rule

SetTransition sets the Transition field's value.

func (Rule) String added in v0.9.8 

func (s Rule) String() string

String returns the string representation

func (*Rule) Validate added in v1.1.21 

func (s *Rule) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type S3 

type S3 struct {
	*client.Client
}

S3 provides the API operation methods for making requests to Amazon Simple Storage Service. See this package's package overview docs for details on the service.

S3 methods are safe to use concurrently. It is not safe to modify mutate any of the struct's properties though.

func New 

func New(p client.ConfigProvider, cfgs ...*aws.Config) *S3

New creates a new instance of the S3 client with a session. If additional configuration is needed for the client instance use the optional aws.Config parameter to add your extra config.

Example: 

// Create a S3 client from just a session.
svc := s3.New(mySession)

// Create a S3 client with additional configuration
svc := s3.New(mySession, aws.NewConfig().WithRegion("us-west-2"))

func (*S3) AbortMultipartUpload 

func (c *S3) AbortMultipartUpload(input *AbortMultipartUploadInput) (*AbortMultipartUploadOutput, error)

AbortMultipartUpload API operation for Amazon Simple Storage Service.

Aborts a multipart upload.

To verify that all parts have been removed, so you don't get charged for the part storage, you should call the List Parts operation and ensure the parts list is empty.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation AbortMultipartUpload for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchUpload "NoSuchUpload" The specified multipart upload does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/AbortMultipartUpload

Example (Shared00)

To abort a multipart upload

The following example aborts a multipart upload. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.AbortMultipartUploadInput{
		Bucket:   aws.String("examplebucket"),
		Key:      aws.String("bigobject"),
		UploadId: aws.String("xadcOB_7YPBOJuoFiQ9cz4P3Pe6FIZwO4f7wN93uHsNBEw97pl5eNwzExg0LAT2dUN91cOmrEQHDsP3WA60CEg--"),
	}

	result, err := svc.AbortMultipartUpload(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case s3.ErrCodeNoSuchUpload:
				fmt.Println(s3.ErrCodeNoSuchUpload, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) AbortMultipartUploadRequest 

func (c *S3) AbortMultipartUploadRequest(input *AbortMultipartUploadInput) (req *request.Request, output *AbortMultipartUploadOutput)

AbortMultipartUploadRequest generates a "aws/request.Request" representing the client's request for the AbortMultipartUpload operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See AbortMultipartUpload for more information on using the AbortMultipartUpload API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the AbortMultipartUploadRequest method.
req, resp := client.AbortMultipartUploadRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/AbortMultipartUpload

func (*S3) AbortMultipartUploadWithContext added in v1.8.0 

func (c *S3) AbortMultipartUploadWithContext(ctx aws.Context, input *AbortMultipartUploadInput, opts ...request.Option) (*AbortMultipartUploadOutput, error)

AbortMultipartUploadWithContext is the same as AbortMultipartUpload with the addition of the ability to pass a context and additional request options.

See AbortMultipartUpload for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) CompleteMultipartUpload 

func (c *S3) CompleteMultipartUpload(input *CompleteMultipartUploadInput) (*CompleteMultipartUploadOutput, error)

CompleteMultipartUpload API operation for Amazon Simple Storage Service.

Completes a multipart upload by assembling previously uploaded parts.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation CompleteMultipartUpload for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CompleteMultipartUpload

Example (Shared00)

To complete multipart upload

The following example completes a multipart upload. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.CompleteMultipartUploadInput{
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("bigobject"),
		MultipartUpload: &s3.CompletedMultipartUpload{
			Parts: []*s3.CompletedPart{
				{
					ETag:       aws.String("\"d8c2eafd90c266e19ab9dcacc479f8af\""),
					PartNumber: aws.Int64(1),
				},
				{
					ETag:       aws.String("\"d8c2eafd90c266e19ab9dcacc479f8af\""),
					PartNumber: aws.Int64(2),
				},
			},
		},
		UploadId: aws.String("7YPBOJuoFiQ9cz4P3Pe6FIZwO4f7wN93uHsNBEw97pl5eNwzExg0LAT2dUN91cOmrEQHDsP3WA60CEg--"),
	}

	result, err := svc.CompleteMultipartUpload(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) CompleteMultipartUploadRequest 

func (c *S3) CompleteMultipartUploadRequest(input *CompleteMultipartUploadInput) (req *request.Request, output *CompleteMultipartUploadOutput)

CompleteMultipartUploadRequest generates a "aws/request.Request" representing the client's request for the CompleteMultipartUpload operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CompleteMultipartUpload for more information on using the CompleteMultipartUpload API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the CompleteMultipartUploadRequest method.
req, resp := client.CompleteMultipartUploadRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CompleteMultipartUpload

func (*S3) CompleteMultipartUploadWithContext added in v1.8.0 

func (c *S3) CompleteMultipartUploadWithContext(ctx aws.Context, input *CompleteMultipartUploadInput, opts ...request.Option) (*CompleteMultipartUploadOutput, error)

CompleteMultipartUploadWithContext is the same as CompleteMultipartUpload with the addition of the ability to pass a context and additional request options.

See CompleteMultipartUpload for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) CopyObject 

func (c *S3) CopyObject(input *CopyObjectInput) (*CopyObjectOutput, error)

CopyObject API operation for Amazon Simple Storage Service.

Creates a copy of an object that is already stored in Amazon S3.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation CopyObject for usage and error information.

Returned Error Codes:

  • ErrCodeObjectNotInActiveTierError "ObjectNotInActiveTierError" The source object of the COPY operation is not in the active tier and is only stored in Amazon Glacier.

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CopyObject

Example (Shared00)

To copy an object

The following example copies an object from one bucket to another. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.CopyObjectInput{
		Bucket:     aws.String("destinationbucket"),
		CopySource: aws.String("/sourcebucket/HappyFacejpg"),
		Key:        aws.String("HappyFaceCopyjpg"),
	}

	result, err := svc.CopyObject(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case s3.ErrCodeObjectNotInActiveTierError:
				fmt.Println(s3.ErrCodeObjectNotInActiveTierError, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) CopyObjectRequest 

func (c *S3) CopyObjectRequest(input *CopyObjectInput) (req *request.Request, output *CopyObjectOutput)

CopyObjectRequest generates a "aws/request.Request" representing the client's request for the CopyObject operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CopyObject for more information on using the CopyObject API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the CopyObjectRequest method.
req, resp := client.CopyObjectRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CopyObject

func (*S3) CopyObjectWithContext added in v1.8.0 

func (c *S3) CopyObjectWithContext(ctx aws.Context, input *CopyObjectInput, opts ...request.Option) (*CopyObjectOutput, error)

CopyObjectWithContext is the same as CopyObject with the addition of the ability to pass a context and additional request options.

See CopyObject for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) CreateBucket 

func (c *S3) CreateBucket(input *CreateBucketInput) (*CreateBucketOutput, error)

CreateBucket API operation for Amazon Simple Storage Service.

Creates a new bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation CreateBucket for usage and error information.

Returned Error Codes:

  • ErrCodeBucketAlreadyExists "BucketAlreadyExists" The requested bucket name is not available. The bucket namespace is shared by all users of the system. Please select a different name and try again.

  • ErrCodeBucketAlreadyOwnedByYou "BucketAlreadyOwnedByYou"

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucket

Example (Shared00)

To create a bucket in a specific region

The following example creates a bucket. The request specifies an AWS region where to create the bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.CreateBucketInput{
		Bucket: aws.String("examplebucket"),
		CreateBucketConfiguration: &s3.CreateBucketConfiguration{
			LocationConstraint: aws.String("eu-west-1"),
		},
	}

	result, err := svc.CreateBucket(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case s3.ErrCodeBucketAlreadyExists:
				fmt.Println(s3.ErrCodeBucketAlreadyExists, aerr.Error())
			case s3.ErrCodeBucketAlreadyOwnedByYou:
				fmt.Println(s3.ErrCodeBucketAlreadyOwnedByYou, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:
Example (Shared01)

To create a bucket

The following example creates a bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.CreateBucketInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.CreateBucket(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case s3.ErrCodeBucketAlreadyExists:
				fmt.Println(s3.ErrCodeBucketAlreadyExists, aerr.Error())
			case s3.ErrCodeBucketAlreadyOwnedByYou:
				fmt.Println(s3.ErrCodeBucketAlreadyOwnedByYou, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) CreateBucketRequest 

func (c *S3) CreateBucketRequest(input *CreateBucketInput) (req *request.Request, output *CreateBucketOutput)

CreateBucketRequest generates a "aws/request.Request" representing the client's request for the CreateBucket operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateBucket for more information on using the CreateBucket API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the CreateBucketRequest method.
req, resp := client.CreateBucketRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucket

func (*S3) CreateBucketWithContext added in v1.8.0 

func (c *S3) CreateBucketWithContext(ctx aws.Context, input *CreateBucketInput, opts ...request.Option) (*CreateBucketOutput, error)

CreateBucketWithContext is the same as CreateBucket with the addition of the ability to pass a context and additional request options.

See CreateBucket for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) CreateMultipartUpload 

func (c *S3) CreateMultipartUpload(input *CreateMultipartUploadInput) (*CreateMultipartUploadOutput, error)

CreateMultipartUpload API operation for Amazon Simple Storage Service.

Initiates a multipart upload and returns an upload ID.

Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation CreateMultipartUpload for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateMultipartUpload

Example (Shared00)

To initiate a multipart upload

The following example initiates a multipart upload. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.CreateMultipartUploadInput{
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("largeobject"),
	}

	result, err := svc.CreateMultipartUpload(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) CreateMultipartUploadRequest 

func (c *S3) CreateMultipartUploadRequest(input *CreateMultipartUploadInput) (req *request.Request, output *CreateMultipartUploadOutput)

CreateMultipartUploadRequest generates a "aws/request.Request" representing the client's request for the CreateMultipartUpload operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateMultipartUpload for more information on using the CreateMultipartUpload API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the CreateMultipartUploadRequest method.
req, resp := client.CreateMultipartUploadRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateMultipartUpload

func (*S3) CreateMultipartUploadWithContext added in v1.8.0 

func (c *S3) CreateMultipartUploadWithContext(ctx aws.Context, input *CreateMultipartUploadInput, opts ...request.Option) (*CreateMultipartUploadOutput, error)

CreateMultipartUploadWithContext is the same as CreateMultipartUpload with the addition of the ability to pass a context and additional request options.

See CreateMultipartUpload for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) DeleteBucket 

func (c *S3) DeleteBucket(input *DeleteBucketInput) (*DeleteBucketOutput, error)

DeleteBucket API operation for Amazon Simple Storage Service.

Deletes the bucket. All objects (including all object versions and Delete Markers) in the bucket must be deleted before the bucket itself can be deleted.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation DeleteBucket for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucket

Example (Shared00)

To delete a bucket

The following example deletes the specified bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.DeleteBucketInput{
		Bucket: aws.String("forrandall2"),
	}

	result, err := svc.DeleteBucket(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) DeleteBucketAnalyticsConfiguration added in v1.5.11 

func (c *S3) DeleteBucketAnalyticsConfiguration(input *DeleteBucketAnalyticsConfigurationInput) (*DeleteBucketAnalyticsConfigurationOutput, error)

DeleteBucketAnalyticsConfiguration API operation for Amazon Simple Storage Service.

Deletes an analytics configuration for the bucket (specified by the analytics configuration ID).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation DeleteBucketAnalyticsConfiguration for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketAnalyticsConfiguration

func (*S3) DeleteBucketAnalyticsConfigurationRequest added in v1.5.11 

func (c *S3) DeleteBucketAnalyticsConfigurationRequest(input *DeleteBucketAnalyticsConfigurationInput) (req *request.Request, output *DeleteBucketAnalyticsConfigurationOutput)

DeleteBucketAnalyticsConfigurationRequest generates a "aws/request.Request" representing the client's request for the DeleteBucketAnalyticsConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteBucketAnalyticsConfiguration for more information on using the DeleteBucketAnalyticsConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the DeleteBucketAnalyticsConfigurationRequest method.
req, resp := client.DeleteBucketAnalyticsConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketAnalyticsConfiguration

func (*S3) DeleteBucketAnalyticsConfigurationWithContext added in v1.8.0 

func (c *S3) DeleteBucketAnalyticsConfigurationWithContext(ctx aws.Context, input *DeleteBucketAnalyticsConfigurationInput, opts ...request.Option) (*DeleteBucketAnalyticsConfigurationOutput, error)

DeleteBucketAnalyticsConfigurationWithContext is the same as DeleteBucketAnalyticsConfiguration with the addition of the ability to pass a context and additional request options.

See DeleteBucketAnalyticsConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) DeleteBucketCors added in v0.9.5 

func (c *S3) DeleteBucketCors(input *DeleteBucketCorsInput) (*DeleteBucketCorsOutput, error)

DeleteBucketCors API operation for Amazon Simple Storage Service.

Deletes the cors configuration information set for the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation DeleteBucketCors for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketCors

Example (Shared00)

To delete cors configuration on a bucket.

The following example deletes CORS configuration on a bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.DeleteBucketCorsInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.DeleteBucketCors(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) DeleteBucketCorsRequest added in v0.9.5 

func (c *S3) DeleteBucketCorsRequest(input *DeleteBucketCorsInput) (req *request.Request, output *DeleteBucketCorsOutput)

DeleteBucketCorsRequest generates a "aws/request.Request" representing the client's request for the DeleteBucketCors operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteBucketCors for more information on using the DeleteBucketCors API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the DeleteBucketCorsRequest method.
req, resp := client.DeleteBucketCorsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketCors

func (*S3) DeleteBucketCorsWithContext added in v1.8.0 

func (c *S3) DeleteBucketCorsWithContext(ctx aws.Context, input *DeleteBucketCorsInput, opts ...request.Option) (*DeleteBucketCorsOutput, error)

DeleteBucketCorsWithContext is the same as DeleteBucketCors with the addition of the ability to pass a context and additional request options.

See DeleteBucketCors for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) DeleteBucketEncryption added in v1.12.24 

func (c *S3) DeleteBucketEncryption(input *DeleteBucketEncryptionInput) (*DeleteBucketEncryptionOutput, error)

DeleteBucketEncryption API operation for Amazon Simple Storage Service.

Deletes the server-side encryption configuration from the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation DeleteBucketEncryption for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketEncryption

func (*S3) DeleteBucketEncryptionRequest added in v1.12.24 

func (c *S3) DeleteBucketEncryptionRequest(input *DeleteBucketEncryptionInput) (req *request.Request, output *DeleteBucketEncryptionOutput)

DeleteBucketEncryptionRequest generates a "aws/request.Request" representing the client's request for the DeleteBucketEncryption operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteBucketEncryption for more information on using the DeleteBucketEncryption API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the DeleteBucketEncryptionRequest method.
req, resp := client.DeleteBucketEncryptionRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketEncryption

func (*S3) DeleteBucketEncryptionWithContext added in v1.12.24 

func (c *S3) DeleteBucketEncryptionWithContext(ctx aws.Context, input *DeleteBucketEncryptionInput, opts ...request.Option) (*DeleteBucketEncryptionOutput, error)

DeleteBucketEncryptionWithContext is the same as DeleteBucketEncryption with the addition of the ability to pass a context and additional request options.

See DeleteBucketEncryption for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) DeleteBucketInventoryConfiguration added in v1.5.11 

func (c *S3) DeleteBucketInventoryConfiguration(input *DeleteBucketInventoryConfigurationInput) (*DeleteBucketInventoryConfigurationOutput, error)

DeleteBucketInventoryConfiguration API operation for Amazon Simple Storage Service.

Deletes an inventory configuration (identified by the inventory ID) from the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation DeleteBucketInventoryConfiguration for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketInventoryConfiguration

func (*S3) DeleteBucketInventoryConfigurationRequest added in v1.5.11 

func (c *S3) DeleteBucketInventoryConfigurationRequest(input *DeleteBucketInventoryConfigurationInput) (req *request.Request, output *DeleteBucketInventoryConfigurationOutput)

DeleteBucketInventoryConfigurationRequest generates a "aws/request.Request" representing the client's request for the DeleteBucketInventoryConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteBucketInventoryConfiguration for more information on using the DeleteBucketInventoryConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the DeleteBucketInventoryConfigurationRequest method.
req, resp := client.DeleteBucketInventoryConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketInventoryConfiguration

func (*S3) DeleteBucketInventoryConfigurationWithContext added in v1.8.0 

func (c *S3) DeleteBucketInventoryConfigurationWithContext(ctx aws.Context, input *DeleteBucketInventoryConfigurationInput, opts ...request.Option) (*DeleteBucketInventoryConfigurationOutput, error)

DeleteBucketInventoryConfigurationWithContext is the same as DeleteBucketInventoryConfiguration with the addition of the ability to pass a context and additional request options.

See DeleteBucketInventoryConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) DeleteBucketLifecycle 

func (c *S3) DeleteBucketLifecycle(input *DeleteBucketLifecycleInput) (*DeleteBucketLifecycleOutput, error)

DeleteBucketLifecycle API operation for Amazon Simple Storage Service.

Deletes the lifecycle configuration from the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation DeleteBucketLifecycle for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketLifecycle

Example (Shared00)

To delete lifecycle configuration on a bucket.

The following example deletes lifecycle configuration on a bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.DeleteBucketLifecycleInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.DeleteBucketLifecycle(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) DeleteBucketLifecycleRequest 

func (c *S3) DeleteBucketLifecycleRequest(input *DeleteBucketLifecycleInput) (req *request.Request, output *DeleteBucketLifecycleOutput)

DeleteBucketLifecycleRequest generates a "aws/request.Request" representing the client's request for the DeleteBucketLifecycle operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteBucketLifecycle for more information on using the DeleteBucketLifecycle API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the DeleteBucketLifecycleRequest method.
req, resp := client.DeleteBucketLifecycleRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketLifecycle

func (*S3) DeleteBucketLifecycleWithContext added in v1.8.0 

func (c *S3) DeleteBucketLifecycleWithContext(ctx aws.Context, input *DeleteBucketLifecycleInput, opts ...request.Option) (*DeleteBucketLifecycleOutput, error)

DeleteBucketLifecycleWithContext is the same as DeleteBucketLifecycle with the addition of the ability to pass a context and additional request options.

See DeleteBucketLifecycle for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) DeleteBucketMetricsConfiguration added in v1.5.11 

func (c *S3) DeleteBucketMetricsConfiguration(input *DeleteBucketMetricsConfigurationInput) (*DeleteBucketMetricsConfigurationOutput, error)

DeleteBucketMetricsConfiguration API operation for Amazon Simple Storage Service.

Deletes a metrics configuration (specified by the metrics configuration ID) from the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation DeleteBucketMetricsConfiguration for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketMetricsConfiguration

func (*S3) DeleteBucketMetricsConfigurationRequest added in v1.5.11 

func (c *S3) DeleteBucketMetricsConfigurationRequest(input *DeleteBucketMetricsConfigurationInput) (req *request.Request, output *DeleteBucketMetricsConfigurationOutput)

DeleteBucketMetricsConfigurationRequest generates a "aws/request.Request" representing the client's request for the DeleteBucketMetricsConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteBucketMetricsConfiguration for more information on using the DeleteBucketMetricsConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the DeleteBucketMetricsConfigurationRequest method.
req, resp := client.DeleteBucketMetricsConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketMetricsConfiguration

func (*S3) DeleteBucketMetricsConfigurationWithContext added in v1.8.0 

func (c *S3) DeleteBucketMetricsConfigurationWithContext(ctx aws.Context, input *DeleteBucketMetricsConfigurationInput, opts ...request.Option) (*DeleteBucketMetricsConfigurationOutput, error)

DeleteBucketMetricsConfigurationWithContext is the same as DeleteBucketMetricsConfiguration with the addition of the ability to pass a context and additional request options.

See DeleteBucketMetricsConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) DeleteBucketPolicy 

func (c *S3) DeleteBucketPolicy(input *DeleteBucketPolicyInput) (*DeleteBucketPolicyOutput, error)

DeleteBucketPolicy API operation for Amazon Simple Storage Service.

Deletes the policy from the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation DeleteBucketPolicy for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketPolicy

Example (Shared00)

To delete bucket policy

The following example deletes bucket policy on the specified bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.DeleteBucketPolicyInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.DeleteBucketPolicy(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) DeleteBucketPolicyRequest 

func (c *S3) DeleteBucketPolicyRequest(input *DeleteBucketPolicyInput) (req *request.Request, output *DeleteBucketPolicyOutput)

DeleteBucketPolicyRequest generates a "aws/request.Request" representing the client's request for the DeleteBucketPolicy operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteBucketPolicy for more information on using the DeleteBucketPolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the DeleteBucketPolicyRequest method.
req, resp := client.DeleteBucketPolicyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketPolicy

func (*S3) DeleteBucketPolicyWithContext added in v1.8.0 

func (c *S3) DeleteBucketPolicyWithContext(ctx aws.Context, input *DeleteBucketPolicyInput, opts ...request.Option) (*DeleteBucketPolicyOutput, error)

DeleteBucketPolicyWithContext is the same as DeleteBucketPolicy with the addition of the ability to pass a context and additional request options.

See DeleteBucketPolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) DeleteBucketReplication 

func (c *S3) DeleteBucketReplication(input *DeleteBucketReplicationInput) (*DeleteBucketReplicationOutput, error)

DeleteBucketReplication API operation for Amazon Simple Storage Service.

Deletes the replication configuration from the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation DeleteBucketReplication for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketReplication

Example (Shared00)

To delete bucket replication configuration

The following example deletes replication configuration set on bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.DeleteBucketReplicationInput{
		Bucket: aws.String("example"),
	}

	result, err := svc.DeleteBucketReplication(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) DeleteBucketReplicationRequest 

func (c *S3) DeleteBucketReplicationRequest(input *DeleteBucketReplicationInput) (req *request.Request, output *DeleteBucketReplicationOutput)

DeleteBucketReplicationRequest generates a "aws/request.Request" representing the client's request for the DeleteBucketReplication operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteBucketReplication for more information on using the DeleteBucketReplication API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the DeleteBucketReplicationRequest method.
req, resp := client.DeleteBucketReplicationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketReplication

func (*S3) DeleteBucketReplicationWithContext added in v1.8.0 

func (c *S3) DeleteBucketReplicationWithContext(ctx aws.Context, input *DeleteBucketReplicationInput, opts ...request.Option) (*DeleteBucketReplicationOutput, error)

DeleteBucketReplicationWithContext is the same as DeleteBucketReplication with the addition of the ability to pass a context and additional request options.

See DeleteBucketReplication for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) DeleteBucketRequest 

func (c *S3) DeleteBucketRequest(input *DeleteBucketInput) (req *request.Request, output *DeleteBucketOutput)

DeleteBucketRequest generates a "aws/request.Request" representing the client's request for the DeleteBucket operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteBucket for more information on using the DeleteBucket API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the DeleteBucketRequest method.
req, resp := client.DeleteBucketRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucket

func (*S3) DeleteBucketTagging 

func (c *S3) DeleteBucketTagging(input *DeleteBucketTaggingInput) (*DeleteBucketTaggingOutput, error)

DeleteBucketTagging API operation for Amazon Simple Storage Service.

Deletes the tags from the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation DeleteBucketTagging for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketTagging

Example (Shared00)

To delete bucket tags

The following example deletes bucket tags. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.DeleteBucketTaggingInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.DeleteBucketTagging(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) DeleteBucketTaggingRequest 

func (c *S3) DeleteBucketTaggingRequest(input *DeleteBucketTaggingInput) (req *request.Request, output *DeleteBucketTaggingOutput)

DeleteBucketTaggingRequest generates a "aws/request.Request" representing the client's request for the DeleteBucketTagging operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteBucketTagging for more information on using the DeleteBucketTagging API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the DeleteBucketTaggingRequest method.
req, resp := client.DeleteBucketTaggingRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketTagging

func (*S3) DeleteBucketTaggingWithContext added in v1.8.0 

func (c *S3) DeleteBucketTaggingWithContext(ctx aws.Context, input *DeleteBucketTaggingInput, opts ...request.Option) (*DeleteBucketTaggingOutput, error)

DeleteBucketTaggingWithContext is the same as DeleteBucketTagging with the addition of the ability to pass a context and additional request options.

See DeleteBucketTagging for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) DeleteBucketWebsite 

func (c *S3) DeleteBucketWebsite(input *DeleteBucketWebsiteInput) (*DeleteBucketWebsiteOutput, error)

DeleteBucketWebsite API operation for Amazon Simple Storage Service.

This operation removes the website configuration from the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation DeleteBucketWebsite for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketWebsite

Example (Shared00)

To delete bucket website configuration

The following example deletes bucket website configuration. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.DeleteBucketWebsiteInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.DeleteBucketWebsite(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) DeleteBucketWebsiteRequest 

func (c *S3) DeleteBucketWebsiteRequest(input *DeleteBucketWebsiteInput) (req *request.Request, output *DeleteBucketWebsiteOutput)

DeleteBucketWebsiteRequest generates a "aws/request.Request" representing the client's request for the DeleteBucketWebsite operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteBucketWebsite for more information on using the DeleteBucketWebsite API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the DeleteBucketWebsiteRequest method.
req, resp := client.DeleteBucketWebsiteRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketWebsite

func (*S3) DeleteBucketWebsiteWithContext added in v1.8.0 

func (c *S3) DeleteBucketWebsiteWithContext(ctx aws.Context, input *DeleteBucketWebsiteInput, opts ...request.Option) (*DeleteBucketWebsiteOutput, error)

DeleteBucketWebsiteWithContext is the same as DeleteBucketWebsite with the addition of the ability to pass a context and additional request options.

See DeleteBucketWebsite for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) DeleteBucketWithContext added in v1.8.0 

func (c *S3) DeleteBucketWithContext(ctx aws.Context, input *DeleteBucketInput, opts ...request.Option) (*DeleteBucketOutput, error)

DeleteBucketWithContext is the same as DeleteBucket with the addition of the ability to pass a context and additional request options.

See DeleteBucket for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) DeleteObject 

func (c *S3) DeleteObject(input *DeleteObjectInput) (*DeleteObjectOutput, error)

DeleteObject API operation for Amazon Simple Storage Service.

Removes the null version (if there is one) of an object and inserts a delete marker, which becomes the latest version of the object. If there isn't a null version, Amazon S3 does not remove any objects.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation DeleteObject for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObject

Example (Shared00)

To delete an object

The following example deletes an object from an S3 bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.DeleteObjectInput{
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("objectkey.jpg"),
	}

	result, err := svc.DeleteObject(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:
Example (Shared01)

To delete an object (from a non-versioned bucket)

The following example deletes an object from a non-versioned bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.DeleteObjectInput{
		Bucket: aws.String("ExampleBucket"),
		Key:    aws.String("HappyFace.jpg"),
	}

	result, err := svc.DeleteObject(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) DeleteObjectRequest 

func (c *S3) DeleteObjectRequest(input *DeleteObjectInput) (req *request.Request, output *DeleteObjectOutput)

DeleteObjectRequest generates a "aws/request.Request" representing the client's request for the DeleteObject operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteObject for more information on using the DeleteObject API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the DeleteObjectRequest method.
req, resp := client.DeleteObjectRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObject

func (*S3) DeleteObjectTagging added in v1.5.11 

func (c *S3) DeleteObjectTagging(input *DeleteObjectTaggingInput) (*DeleteObjectTaggingOutput, error)

DeleteObjectTagging API operation for Amazon Simple Storage Service.

Removes the tag-set from an existing object.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation DeleteObjectTagging for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObjectTagging

Example (Shared00)

To remove tag set from an object version

The following example removes tag set associated with the specified object version. The request specifies both the object key and object version. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.DeleteObjectTaggingInput{
		Bucket:    aws.String("examplebucket"),
		Key:       aws.String("HappyFace.jpg"),
		VersionId: aws.String("ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"),
	}

	result, err := svc.DeleteObjectTagging(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:
Example (Shared01)

To remove tag set from an object

The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the operation removes tag set from the latest object version. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.DeleteObjectTaggingInput{
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("HappyFace.jpg"),
	}

	result, err := svc.DeleteObjectTagging(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) DeleteObjectTaggingRequest added in v1.5.11 

func (c *S3) DeleteObjectTaggingRequest(input *DeleteObjectTaggingInput) (req *request.Request, output *DeleteObjectTaggingOutput)

DeleteObjectTaggingRequest generates a "aws/request.Request" representing the client's request for the DeleteObjectTagging operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteObjectTagging for more information on using the DeleteObjectTagging API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the DeleteObjectTaggingRequest method.
req, resp := client.DeleteObjectTaggingRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObjectTagging

func (*S3) DeleteObjectTaggingWithContext added in v1.8.0 

func (c *S3) DeleteObjectTaggingWithContext(ctx aws.Context, input *DeleteObjectTaggingInput, opts ...request.Option) (*DeleteObjectTaggingOutput, error)

DeleteObjectTaggingWithContext is the same as DeleteObjectTagging with the addition of the ability to pass a context and additional request options.

See DeleteObjectTagging for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) DeleteObjectWithContext added in v1.8.0 

func (c *S3) DeleteObjectWithContext(ctx aws.Context, input *DeleteObjectInput, opts ...request.Option) (*DeleteObjectOutput, error)

DeleteObjectWithContext is the same as DeleteObject with the addition of the ability to pass a context and additional request options.

See DeleteObject for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) DeleteObjects 

func (c *S3) DeleteObjects(input *DeleteObjectsInput) (*DeleteObjectsOutput, error)

DeleteObjects API operation for Amazon Simple Storage Service.

This operation enables you to delete multiple objects from a bucket using a single HTTP request. You may specify up to 1000 keys.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation DeleteObjects for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObjects

Example (Shared00)

To delete multiple object versions from a versioned bucket

The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object versions and returns the key and versions of deleted objects in the response. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.DeleteObjectsInput{
		Bucket: aws.String("examplebucket"),
		Delete: &s3.Delete{
			Objects: []*s3.ObjectIdentifier{
				{
					Key:       aws.String("HappyFace.jpg"),
					VersionId: aws.String("2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"),
				},
				{
					Key:       aws.String("HappyFace.jpg"),
					VersionId: aws.String("yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"),
				},
			},
			Quiet: aws.Bool(false),
		},
	}

	result, err := svc.DeleteObjects(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:
Example (Shared01)

To delete multiple objects from a versioned bucket

The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.DeleteObjectsInput{
		Bucket: aws.String("examplebucket"),
		Delete: &s3.Delete{
			Objects: []*s3.ObjectIdentifier{
				{
					Key: aws.String("objectkey1"),
				},
				{
					Key: aws.String("objectkey2"),
				},
			},
			Quiet: aws.Bool(false),
		},
	}

	result, err := svc.DeleteObjects(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) DeleteObjectsRequest 

func (c *S3) DeleteObjectsRequest(input *DeleteObjectsInput) (req *request.Request, output *DeleteObjectsOutput)

DeleteObjectsRequest generates a "aws/request.Request" representing the client's request for the DeleteObjects operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteObjects for more information on using the DeleteObjects API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the DeleteObjectsRequest method.
req, resp := client.DeleteObjectsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObjects

func (*S3) DeleteObjectsWithContext added in v1.8.0 

func (c *S3) DeleteObjectsWithContext(ctx aws.Context, input *DeleteObjectsInput, opts ...request.Option) (*DeleteObjectsOutput, error)

DeleteObjectsWithContext is the same as DeleteObjects with the addition of the ability to pass a context and additional request options.

See DeleteObjects for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketAccelerateConfiguration added in v1.1.19 

func (c *S3) GetBucketAccelerateConfiguration(input *GetBucketAccelerateConfigurationInput) (*GetBucketAccelerateConfigurationOutput, error)

GetBucketAccelerateConfiguration API operation for Amazon Simple Storage Service.

Returns the accelerate configuration of a bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketAccelerateConfiguration for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAccelerateConfiguration

func (*S3) GetBucketAccelerateConfigurationRequest added in v1.1.19 

func (c *S3) GetBucketAccelerateConfigurationRequest(input *GetBucketAccelerateConfigurationInput) (req *request.Request, output *GetBucketAccelerateConfigurationOutput)

GetBucketAccelerateConfigurationRequest generates a "aws/request.Request" representing the client's request for the GetBucketAccelerateConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketAccelerateConfiguration for more information on using the GetBucketAccelerateConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketAccelerateConfigurationRequest method.
req, resp := client.GetBucketAccelerateConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAccelerateConfiguration

func (*S3) GetBucketAccelerateConfigurationWithContext added in v1.8.0 

func (c *S3) GetBucketAccelerateConfigurationWithContext(ctx aws.Context, input *GetBucketAccelerateConfigurationInput, opts ...request.Option) (*GetBucketAccelerateConfigurationOutput, error)

GetBucketAccelerateConfigurationWithContext is the same as GetBucketAccelerateConfiguration with the addition of the ability to pass a context and additional request options.

See GetBucketAccelerateConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketAcl added in v0.9.5 

func (c *S3) GetBucketAcl(input *GetBucketAclInput) (*GetBucketAclOutput, error)

GetBucketAcl API operation for Amazon Simple Storage Service.

Gets the access control policy for the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketAcl for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAcl

func (*S3) GetBucketAclRequest added in v0.9.5 

func (c *S3) GetBucketAclRequest(input *GetBucketAclInput) (req *request.Request, output *GetBucketAclOutput)

GetBucketAclRequest generates a "aws/request.Request" representing the client's request for the GetBucketAcl operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketAcl for more information on using the GetBucketAcl API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketAclRequest method.
req, resp := client.GetBucketAclRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAcl

func (*S3) GetBucketAclWithContext added in v1.8.0 

func (c *S3) GetBucketAclWithContext(ctx aws.Context, input *GetBucketAclInput, opts ...request.Option) (*GetBucketAclOutput, error)

GetBucketAclWithContext is the same as GetBucketAcl with the addition of the ability to pass a context and additional request options.

See GetBucketAcl for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketAnalyticsConfiguration added in v1.5.11 

func (c *S3) GetBucketAnalyticsConfiguration(input *GetBucketAnalyticsConfigurationInput) (*GetBucketAnalyticsConfigurationOutput, error)

GetBucketAnalyticsConfiguration API operation for Amazon Simple Storage Service.

Gets an analytics configuration for the bucket (specified by the analytics configuration ID).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketAnalyticsConfiguration for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAnalyticsConfiguration

func (*S3) GetBucketAnalyticsConfigurationRequest added in v1.5.11 

func (c *S3) GetBucketAnalyticsConfigurationRequest(input *GetBucketAnalyticsConfigurationInput) (req *request.Request, output *GetBucketAnalyticsConfigurationOutput)

GetBucketAnalyticsConfigurationRequest generates a "aws/request.Request" representing the client's request for the GetBucketAnalyticsConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketAnalyticsConfiguration for more information on using the GetBucketAnalyticsConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketAnalyticsConfigurationRequest method.
req, resp := client.GetBucketAnalyticsConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAnalyticsConfiguration

func (*S3) GetBucketAnalyticsConfigurationWithContext added in v1.8.0 

func (c *S3) GetBucketAnalyticsConfigurationWithContext(ctx aws.Context, input *GetBucketAnalyticsConfigurationInput, opts ...request.Option) (*GetBucketAnalyticsConfigurationOutput, error)

GetBucketAnalyticsConfigurationWithContext is the same as GetBucketAnalyticsConfiguration with the addition of the ability to pass a context and additional request options.

See GetBucketAnalyticsConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketCors added in v0.9.5 

func (c *S3) GetBucketCors(input *GetBucketCorsInput) (*GetBucketCorsOutput, error)

GetBucketCors API operation for Amazon Simple Storage Service.

Returns the cors configuration for the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketCors for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketCors

Example (Shared00)

To get cors configuration set on a bucket

The following example returns cross-origin resource sharing (CORS) configuration set on a bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetBucketCorsInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.GetBucketCors(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) GetBucketCorsRequest added in v0.9.5 

func (c *S3) GetBucketCorsRequest(input *GetBucketCorsInput) (req *request.Request, output *GetBucketCorsOutput)

GetBucketCorsRequest generates a "aws/request.Request" representing the client's request for the GetBucketCors operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketCors for more information on using the GetBucketCors API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketCorsRequest method.
req, resp := client.GetBucketCorsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketCors

func (*S3) GetBucketCorsWithContext added in v1.8.0 

func (c *S3) GetBucketCorsWithContext(ctx aws.Context, input *GetBucketCorsInput, opts ...request.Option) (*GetBucketCorsOutput, error)

GetBucketCorsWithContext is the same as GetBucketCors with the addition of the ability to pass a context and additional request options.

See GetBucketCors for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketEncryption added in v1.12.24 

func (c *S3) GetBucketEncryption(input *GetBucketEncryptionInput) (*GetBucketEncryptionOutput, error)

GetBucketEncryption API operation for Amazon Simple Storage Service.

Returns the server-side encryption configuration of a bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketEncryption for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketEncryption

func (*S3) GetBucketEncryptionRequest added in v1.12.24 

func (c *S3) GetBucketEncryptionRequest(input *GetBucketEncryptionInput) (req *request.Request, output *GetBucketEncryptionOutput)

GetBucketEncryptionRequest generates a "aws/request.Request" representing the client's request for the GetBucketEncryption operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketEncryption for more information on using the GetBucketEncryption API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketEncryptionRequest method.
req, resp := client.GetBucketEncryptionRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketEncryption

func (*S3) GetBucketEncryptionWithContext added in v1.12.24 

func (c *S3) GetBucketEncryptionWithContext(ctx aws.Context, input *GetBucketEncryptionInput, opts ...request.Option) (*GetBucketEncryptionOutput, error)

GetBucketEncryptionWithContext is the same as GetBucketEncryption with the addition of the ability to pass a context and additional request options.

See GetBucketEncryption for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketInventoryConfiguration added in v1.5.11 

func (c *S3) GetBucketInventoryConfiguration(input *GetBucketInventoryConfigurationInput) (*GetBucketInventoryConfigurationOutput, error)

GetBucketInventoryConfiguration API operation for Amazon Simple Storage Service.

Returns an inventory configuration (identified by the inventory ID) from the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketInventoryConfiguration for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketInventoryConfiguration

func (*S3) GetBucketInventoryConfigurationRequest added in v1.5.11 

func (c *S3) GetBucketInventoryConfigurationRequest(input *GetBucketInventoryConfigurationInput) (req *request.Request, output *GetBucketInventoryConfigurationOutput)

GetBucketInventoryConfigurationRequest generates a "aws/request.Request" representing the client's request for the GetBucketInventoryConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketInventoryConfiguration for more information on using the GetBucketInventoryConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketInventoryConfigurationRequest method.
req, resp := client.GetBucketInventoryConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketInventoryConfiguration

func (*S3) GetBucketInventoryConfigurationWithContext added in v1.8.0 

func (c *S3) GetBucketInventoryConfigurationWithContext(ctx aws.Context, input *GetBucketInventoryConfigurationInput, opts ...request.Option) (*GetBucketInventoryConfigurationOutput, error)

GetBucketInventoryConfigurationWithContext is the same as GetBucketInventoryConfiguration with the addition of the ability to pass a context and additional request options.

See GetBucketInventoryConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketLifecycle deprecated 

func (c *S3) GetBucketLifecycle(input *GetBucketLifecycleInput) (*GetBucketLifecycleOutput, error)

GetBucketLifecycle API operation for Amazon Simple Storage Service.

Deprecated, see the GetBucketLifecycleConfiguration operation.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketLifecycle for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLifecycle

Deprecated: GetBucketLifecycle has been deprecated

Example (Shared00)

To get a bucket acl

The following example gets ACL on the specified bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetBucketLifecycleInput{
		Bucket: aws.String("acl1"),
	}

	result, err := svc.GetBucketLifecycle(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) GetBucketLifecycleConfiguration added in v0.9.8 

func (c *S3) GetBucketLifecycleConfiguration(input *GetBucketLifecycleConfigurationInput) (*GetBucketLifecycleConfigurationOutput, error)

GetBucketLifecycleConfiguration API operation for Amazon Simple Storage Service.

Returns the lifecycle configuration information set on the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketLifecycleConfiguration for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLifecycleConfiguration

Example (Shared00)

To get lifecycle configuration on a bucket

The following example retrieves lifecycle configuration on set on a bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetBucketLifecycleConfigurationInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.GetBucketLifecycleConfiguration(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) GetBucketLifecycleConfigurationRequest added in v0.9.8 

func (c *S3) GetBucketLifecycleConfigurationRequest(input *GetBucketLifecycleConfigurationInput) (req *request.Request, output *GetBucketLifecycleConfigurationOutput)

GetBucketLifecycleConfigurationRequest generates a "aws/request.Request" representing the client's request for the GetBucketLifecycleConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketLifecycleConfiguration for more information on using the GetBucketLifecycleConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketLifecycleConfigurationRequest method.
req, resp := client.GetBucketLifecycleConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLifecycleConfiguration

func (*S3) GetBucketLifecycleConfigurationWithContext added in v1.8.0 

func (c *S3) GetBucketLifecycleConfigurationWithContext(ctx aws.Context, input *GetBucketLifecycleConfigurationInput, opts ...request.Option) (*GetBucketLifecycleConfigurationOutput, error)

GetBucketLifecycleConfigurationWithContext is the same as GetBucketLifecycleConfiguration with the addition of the ability to pass a context and additional request options.

See GetBucketLifecycleConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketLifecycleRequest deprecated 

func (c *S3) GetBucketLifecycleRequest(input *GetBucketLifecycleInput) (req *request.Request, output *GetBucketLifecycleOutput)

GetBucketLifecycleRequest generates a "aws/request.Request" representing the client's request for the GetBucketLifecycle operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketLifecycle for more information on using the GetBucketLifecycle API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketLifecycleRequest method.
req, resp := client.GetBucketLifecycleRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLifecycle

Deprecated: GetBucketLifecycle has been deprecated

func (*S3) GetBucketLifecycleWithContext deprecated added in v1.8.0 

func (c *S3) GetBucketLifecycleWithContext(ctx aws.Context, input *GetBucketLifecycleInput, opts ...request.Option) (*GetBucketLifecycleOutput, error)

GetBucketLifecycleWithContext is the same as GetBucketLifecycle with the addition of the ability to pass a context and additional request options.

See GetBucketLifecycle for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

Deprecated: GetBucketLifecycleWithContext has been deprecated

func (*S3) GetBucketLocation 

func (c *S3) GetBucketLocation(input *GetBucketLocationInput) (*GetBucketLocationOutput, error)

GetBucketLocation API operation for Amazon Simple Storage Service.

Returns the region the bucket resides in.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketLocation for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLocation

Example (Shared00)

To get bucket location

The following example returns bucket location. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetBucketLocationInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.GetBucketLocation(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) GetBucketLocationRequest 

func (c *S3) GetBucketLocationRequest(input *GetBucketLocationInput) (req *request.Request, output *GetBucketLocationOutput)

GetBucketLocationRequest generates a "aws/request.Request" representing the client's request for the GetBucketLocation operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketLocation for more information on using the GetBucketLocation API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketLocationRequest method.
req, resp := client.GetBucketLocationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLocation

func (*S3) GetBucketLocationWithContext added in v1.8.0 

func (c *S3) GetBucketLocationWithContext(ctx aws.Context, input *GetBucketLocationInput, opts ...request.Option) (*GetBucketLocationOutput, error)

GetBucketLocationWithContext is the same as GetBucketLocation with the addition of the ability to pass a context and additional request options.

See GetBucketLocation for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketLogging 

func (c *S3) GetBucketLogging(input *GetBucketLoggingInput) (*GetBucketLoggingOutput, error)

GetBucketLogging API operation for Amazon Simple Storage Service.

Returns the logging status of a bucket and the permissions users have to view and modify that status. To use GET, you must be the bucket owner.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketLogging for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLogging

func (*S3) GetBucketLoggingRequest 

func (c *S3) GetBucketLoggingRequest(input *GetBucketLoggingInput) (req *request.Request, output *GetBucketLoggingOutput)

GetBucketLoggingRequest generates a "aws/request.Request" representing the client's request for the GetBucketLogging operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketLogging for more information on using the GetBucketLogging API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketLoggingRequest method.
req, resp := client.GetBucketLoggingRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLogging

func (*S3) GetBucketLoggingWithContext added in v1.8.0 

func (c *S3) GetBucketLoggingWithContext(ctx aws.Context, input *GetBucketLoggingInput, opts ...request.Option) (*GetBucketLoggingOutput, error)

GetBucketLoggingWithContext is the same as GetBucketLogging with the addition of the ability to pass a context and additional request options.

See GetBucketLogging for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketMetricsConfiguration added in v1.5.11 

func (c *S3) GetBucketMetricsConfiguration(input *GetBucketMetricsConfigurationInput) (*GetBucketMetricsConfigurationOutput, error)

GetBucketMetricsConfiguration API operation for Amazon Simple Storage Service.

Gets a metrics configuration (specified by the metrics configuration ID) from the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketMetricsConfiguration for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetricsConfiguration

func (*S3) GetBucketMetricsConfigurationRequest added in v1.5.11 

func (c *S3) GetBucketMetricsConfigurationRequest(input *GetBucketMetricsConfigurationInput) (req *request.Request, output *GetBucketMetricsConfigurationOutput)

GetBucketMetricsConfigurationRequest generates a "aws/request.Request" representing the client's request for the GetBucketMetricsConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketMetricsConfiguration for more information on using the GetBucketMetricsConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketMetricsConfigurationRequest method.
req, resp := client.GetBucketMetricsConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetricsConfiguration

func (*S3) GetBucketMetricsConfigurationWithContext added in v1.8.0 

func (c *S3) GetBucketMetricsConfigurationWithContext(ctx aws.Context, input *GetBucketMetricsConfigurationInput, opts ...request.Option) (*GetBucketMetricsConfigurationOutput, error)

GetBucketMetricsConfigurationWithContext is the same as GetBucketMetricsConfiguration with the addition of the ability to pass a context and additional request options.

See GetBucketMetricsConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketNotification deprecated 

func (c *S3) GetBucketNotification(input *GetBucketNotificationConfigurationRequest) (*NotificationConfigurationDeprecated, error)

GetBucketNotification API operation for Amazon Simple Storage Service.

Deprecated, see the GetBucketNotificationConfiguration operation.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketNotification for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketNotification

Deprecated: GetBucketNotification has been deprecated

Example (Shared00)

To get notification configuration set on a bucket

The following example returns notification configuration set on a bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetBucketNotificationConfigurationRequest{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.GetBucketNotification(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:
Example (Shared01)

To get notification configuration set on a bucket

The following example returns notification configuration set on a bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetBucketNotificationConfigurationRequest{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.GetBucketNotification(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) GetBucketNotificationConfiguration 

func (c *S3) GetBucketNotificationConfiguration(input *GetBucketNotificationConfigurationRequest) (*NotificationConfiguration, error)

GetBucketNotificationConfiguration API operation for Amazon Simple Storage Service.

Returns the notification configuration of a bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketNotificationConfiguration for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketNotificationConfiguration

func (*S3) GetBucketNotificationConfigurationRequest 

func (c *S3) GetBucketNotificationConfigurationRequest(input *GetBucketNotificationConfigurationRequest) (req *request.Request, output *NotificationConfiguration)

GetBucketNotificationConfigurationRequest generates a "aws/request.Request" representing the client's request for the GetBucketNotificationConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketNotificationConfiguration for more information on using the GetBucketNotificationConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketNotificationConfigurationRequest method.
req, resp := client.GetBucketNotificationConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketNotificationConfiguration

func (*S3) GetBucketNotificationConfigurationWithContext added in v1.8.0 

func (c *S3) GetBucketNotificationConfigurationWithContext(ctx aws.Context, input *GetBucketNotificationConfigurationRequest, opts ...request.Option) (*NotificationConfiguration, error)

GetBucketNotificationConfigurationWithContext is the same as GetBucketNotificationConfiguration with the addition of the ability to pass a context and additional request options.

See GetBucketNotificationConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketNotificationRequest deprecated 

func (c *S3) GetBucketNotificationRequest(input *GetBucketNotificationConfigurationRequest) (req *request.Request, output *NotificationConfigurationDeprecated)

GetBucketNotificationRequest generates a "aws/request.Request" representing the client's request for the GetBucketNotification operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketNotification for more information on using the GetBucketNotification API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketNotificationRequest method.
req, resp := client.GetBucketNotificationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketNotification

Deprecated: GetBucketNotification has been deprecated

func (*S3) GetBucketNotificationWithContext deprecated added in v1.8.0 

func (c *S3) GetBucketNotificationWithContext(ctx aws.Context, input *GetBucketNotificationConfigurationRequest, opts ...request.Option) (*NotificationConfigurationDeprecated, error)

GetBucketNotificationWithContext is the same as GetBucketNotification with the addition of the ability to pass a context and additional request options.

See GetBucketNotification for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

Deprecated: GetBucketNotificationWithContext has been deprecated

func (*S3) GetBucketPolicy 

func (c *S3) GetBucketPolicy(input *GetBucketPolicyInput) (*GetBucketPolicyOutput, error)

GetBucketPolicy API operation for Amazon Simple Storage Service.

Returns the policy of a specified bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketPolicy for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketPolicy

Example (Shared00)

To get bucket policy

The following example returns bucket policy associated with a bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetBucketPolicyInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.GetBucketPolicy(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) GetBucketPolicyRequest 

func (c *S3) GetBucketPolicyRequest(input *GetBucketPolicyInput) (req *request.Request, output *GetBucketPolicyOutput)

GetBucketPolicyRequest generates a "aws/request.Request" representing the client's request for the GetBucketPolicy operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketPolicy for more information on using the GetBucketPolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketPolicyRequest method.
req, resp := client.GetBucketPolicyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketPolicy

func (*S3) GetBucketPolicyWithContext added in v1.8.0 

func (c *S3) GetBucketPolicyWithContext(ctx aws.Context, input *GetBucketPolicyInput, opts ...request.Option) (*GetBucketPolicyOutput, error)

GetBucketPolicyWithContext is the same as GetBucketPolicy with the addition of the ability to pass a context and additional request options.

See GetBucketPolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketReplication 

func (c *S3) GetBucketReplication(input *GetBucketReplicationInput) (*GetBucketReplicationOutput, error)

GetBucketReplication API operation for Amazon Simple Storage Service.

Returns the replication configuration of a bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketReplication for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketReplication

Example (Shared00)

To get replication configuration set on a bucket

The following example returns replication configuration set on a bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetBucketReplicationInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.GetBucketReplication(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) GetBucketReplicationRequest 

func (c *S3) GetBucketReplicationRequest(input *GetBucketReplicationInput) (req *request.Request, output *GetBucketReplicationOutput)

GetBucketReplicationRequest generates a "aws/request.Request" representing the client's request for the GetBucketReplication operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketReplication for more information on using the GetBucketReplication API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketReplicationRequest method.
req, resp := client.GetBucketReplicationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketReplication

func (*S3) GetBucketReplicationWithContext added in v1.8.0 

func (c *S3) GetBucketReplicationWithContext(ctx aws.Context, input *GetBucketReplicationInput, opts ...request.Option) (*GetBucketReplicationOutput, error)

GetBucketReplicationWithContext is the same as GetBucketReplication with the addition of the ability to pass a context and additional request options.

See GetBucketReplication for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketRequestPayment 

func (c *S3) GetBucketRequestPayment(input *GetBucketRequestPaymentInput) (*GetBucketRequestPaymentOutput, error)

GetBucketRequestPayment API operation for Amazon Simple Storage Service.

Returns the request payment configuration of a bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketRequestPayment for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketRequestPayment

Example (Shared00)

To get bucket versioning configuration

The following example retrieves bucket versioning configuration. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetBucketRequestPaymentInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.GetBucketRequestPayment(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) GetBucketRequestPaymentRequest 

func (c *S3) GetBucketRequestPaymentRequest(input *GetBucketRequestPaymentInput) (req *request.Request, output *GetBucketRequestPaymentOutput)

GetBucketRequestPaymentRequest generates a "aws/request.Request" representing the client's request for the GetBucketRequestPayment operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketRequestPayment for more information on using the GetBucketRequestPayment API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketRequestPaymentRequest method.
req, resp := client.GetBucketRequestPaymentRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketRequestPayment

func (*S3) GetBucketRequestPaymentWithContext added in v1.8.0 

func (c *S3) GetBucketRequestPaymentWithContext(ctx aws.Context, input *GetBucketRequestPaymentInput, opts ...request.Option) (*GetBucketRequestPaymentOutput, error)

GetBucketRequestPaymentWithContext is the same as GetBucketRequestPayment with the addition of the ability to pass a context and additional request options.

See GetBucketRequestPayment for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketTagging 

func (c *S3) GetBucketTagging(input *GetBucketTaggingInput) (*GetBucketTaggingOutput, error)

GetBucketTagging API operation for Amazon Simple Storage Service.

Returns the tag set associated with the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketTagging for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketTagging

Example (Shared00)

To get tag set associated with a bucket

The following example returns tag set associated with a bucket 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetBucketTaggingInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.GetBucketTagging(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) GetBucketTaggingRequest 

func (c *S3) GetBucketTaggingRequest(input *GetBucketTaggingInput) (req *request.Request, output *GetBucketTaggingOutput)

GetBucketTaggingRequest generates a "aws/request.Request" representing the client's request for the GetBucketTagging operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketTagging for more information on using the GetBucketTagging API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketTaggingRequest method.
req, resp := client.GetBucketTaggingRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketTagging

func (*S3) GetBucketTaggingWithContext added in v1.8.0 

func (c *S3) GetBucketTaggingWithContext(ctx aws.Context, input *GetBucketTaggingInput, opts ...request.Option) (*GetBucketTaggingOutput, error)

GetBucketTaggingWithContext is the same as GetBucketTagging with the addition of the ability to pass a context and additional request options.

See GetBucketTagging for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketVersioning 

func (c *S3) GetBucketVersioning(input *GetBucketVersioningInput) (*GetBucketVersioningOutput, error)

GetBucketVersioning API operation for Amazon Simple Storage Service.

Returns the versioning state of a bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketVersioning for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketVersioning

Example (Shared00)

To get bucket versioning configuration

The following example retrieves bucket versioning configuration. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetBucketVersioningInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.GetBucketVersioning(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) GetBucketVersioningRequest 

func (c *S3) GetBucketVersioningRequest(input *GetBucketVersioningInput) (req *request.Request, output *GetBucketVersioningOutput)

GetBucketVersioningRequest generates a "aws/request.Request" representing the client's request for the GetBucketVersioning operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketVersioning for more information on using the GetBucketVersioning API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketVersioningRequest method.
req, resp := client.GetBucketVersioningRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketVersioning

func (*S3) GetBucketVersioningWithContext added in v1.8.0 

func (c *S3) GetBucketVersioningWithContext(ctx aws.Context, input *GetBucketVersioningInput, opts ...request.Option) (*GetBucketVersioningOutput, error)

GetBucketVersioningWithContext is the same as GetBucketVersioning with the addition of the ability to pass a context and additional request options.

See GetBucketVersioning for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetBucketWebsite 

func (c *S3) GetBucketWebsite(input *GetBucketWebsiteInput) (*GetBucketWebsiteOutput, error)

GetBucketWebsite API operation for Amazon Simple Storage Service.

Returns the website configuration for a bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetBucketWebsite for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketWebsite

Example (Shared00)

To get bucket website configuration

The following example retrieves website configuration of a bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetBucketWebsiteInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.GetBucketWebsite(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) GetBucketWebsiteRequest 

func (c *S3) GetBucketWebsiteRequest(input *GetBucketWebsiteInput) (req *request.Request, output *GetBucketWebsiteOutput)

GetBucketWebsiteRequest generates a "aws/request.Request" representing the client's request for the GetBucketWebsite operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetBucketWebsite for more information on using the GetBucketWebsite API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetBucketWebsiteRequest method.
req, resp := client.GetBucketWebsiteRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketWebsite

func (*S3) GetBucketWebsiteWithContext added in v1.8.0 

func (c *S3) GetBucketWebsiteWithContext(ctx aws.Context, input *GetBucketWebsiteInput, opts ...request.Option) (*GetBucketWebsiteOutput, error)

GetBucketWebsiteWithContext is the same as GetBucketWebsite with the addition of the ability to pass a context and additional request options.

See GetBucketWebsite for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetObject 

func (c *S3) GetObject(input *GetObjectInput) (*GetObjectOutput, error)

GetObject API operation for Amazon Simple Storage Service.

Retrieves objects from Amazon S3.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetObject for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchKey "NoSuchKey" The specified key does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObject

Example (Shared00)

To retrieve an object

The following example retrieves an object for an S3 bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetObjectInput{
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("HappyFace.jpg"),
	}

	result, err := svc.GetObject(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case s3.ErrCodeNoSuchKey:
				fmt.Println(s3.ErrCodeNoSuchKey, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:
Example (Shared01)

To retrieve a byte range of an object

The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a specific byte range. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetObjectInput{
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("SampleFile.txt"),
		Range:  aws.String("bytes=0-9"),
	}

	result, err := svc.GetObject(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case s3.ErrCodeNoSuchKey:
				fmt.Println(s3.ErrCodeNoSuchKey, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) GetObjectAcl added in v0.9.5 

func (c *S3) GetObjectAcl(input *GetObjectAclInput) (*GetObjectAclOutput, error)

GetObjectAcl API operation for Amazon Simple Storage Service.

Returns the access control list (ACL) of an object.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetObjectAcl for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchKey "NoSuchKey" The specified key does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectAcl

Example (Shared00)

To retrieve object ACL

The following example retrieves access control list (ACL) of an object. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetObjectAclInput{
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("HappyFace.jpg"),
	}

	result, err := svc.GetObjectAcl(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case s3.ErrCodeNoSuchKey:
				fmt.Println(s3.ErrCodeNoSuchKey, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) GetObjectAclRequest added in v0.9.5 

func (c *S3) GetObjectAclRequest(input *GetObjectAclInput) (req *request.Request, output *GetObjectAclOutput)

GetObjectAclRequest generates a "aws/request.Request" representing the client's request for the GetObjectAcl operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetObjectAcl for more information on using the GetObjectAcl API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetObjectAclRequest method.
req, resp := client.GetObjectAclRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectAcl

func (*S3) GetObjectAclWithContext added in v1.8.0 

func (c *S3) GetObjectAclWithContext(ctx aws.Context, input *GetObjectAclInput, opts ...request.Option) (*GetObjectAclOutput, error)

GetObjectAclWithContext is the same as GetObjectAcl with the addition of the ability to pass a context and additional request options.

See GetObjectAcl for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetObjectRequest 

func (c *S3) GetObjectRequest(input *GetObjectInput) (req *request.Request, output *GetObjectOutput)

GetObjectRequest generates a "aws/request.Request" representing the client's request for the GetObject operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetObject for more information on using the GetObject API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetObjectRequest method.
req, resp := client.GetObjectRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObject

func (*S3) GetObjectTagging added in v1.5.11 

func (c *S3) GetObjectTagging(input *GetObjectTaggingInput) (*GetObjectTaggingOutput, error)

GetObjectTagging API operation for Amazon Simple Storage Service.

Returns the tag-set of an object.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetObjectTagging for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectTagging

Example (Shared00)

To retrieve tag set of an object

The following example retrieves tag set of an object. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetObjectTaggingInput{
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("HappyFace.jpg"),
	}

	result, err := svc.GetObjectTagging(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:
Example (Shared01)

To retrieve tag set of a specific object version

The following example retrieves tag set of an object. The request specifies object version. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetObjectTaggingInput{
		Bucket:    aws.String("examplebucket"),
		Key:       aws.String("exampleobject"),
		VersionId: aws.String("ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"),
	}

	result, err := svc.GetObjectTagging(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) GetObjectTaggingRequest added in v1.5.11 

func (c *S3) GetObjectTaggingRequest(input *GetObjectTaggingInput) (req *request.Request, output *GetObjectTaggingOutput)

GetObjectTaggingRequest generates a "aws/request.Request" representing the client's request for the GetObjectTagging operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetObjectTagging for more information on using the GetObjectTagging API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetObjectTaggingRequest method.
req, resp := client.GetObjectTaggingRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectTagging

func (*S3) GetObjectTaggingWithContext added in v1.8.0 

func (c *S3) GetObjectTaggingWithContext(ctx aws.Context, input *GetObjectTaggingInput, opts ...request.Option) (*GetObjectTaggingOutput, error)

GetObjectTaggingWithContext is the same as GetObjectTagging with the addition of the ability to pass a context and additional request options.

See GetObjectTagging for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetObjectTorrent 

func (c *S3) GetObjectTorrent(input *GetObjectTorrentInput) (*GetObjectTorrentOutput, error)

GetObjectTorrent API operation for Amazon Simple Storage Service.

Return torrent files from a bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation GetObjectTorrent for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectTorrent

Example (Shared00)

To retrieve torrent files for an object

The following example retrieves torrent files of an object. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.GetObjectTorrentInput{
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("HappyFace.jpg"),
	}

	result, err := svc.GetObjectTorrent(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) GetObjectTorrentRequest 

func (c *S3) GetObjectTorrentRequest(input *GetObjectTorrentInput) (req *request.Request, output *GetObjectTorrentOutput)

GetObjectTorrentRequest generates a "aws/request.Request" representing the client's request for the GetObjectTorrent operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetObjectTorrent for more information on using the GetObjectTorrent API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetObjectTorrentRequest method.
req, resp := client.GetObjectTorrentRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectTorrent

func (*S3) GetObjectTorrentWithContext added in v1.8.0 

func (c *S3) GetObjectTorrentWithContext(ctx aws.Context, input *GetObjectTorrentInput, opts ...request.Option) (*GetObjectTorrentOutput, error)

GetObjectTorrentWithContext is the same as GetObjectTorrent with the addition of the ability to pass a context and additional request options.

See GetObjectTorrent for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) GetObjectWithContext added in v1.8.0 

func (c *S3) GetObjectWithContext(ctx aws.Context, input *GetObjectInput, opts ...request.Option) (*GetObjectOutput, error)

GetObjectWithContext is the same as GetObject with the addition of the ability to pass a context and additional request options.

See GetObject for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) HeadBucket 

func (c *S3) HeadBucket(input *HeadBucketInput) (*HeadBucketOutput, error)

HeadBucket API operation for Amazon Simple Storage Service.

This operation is useful to determine if a bucket exists and you have permission to access it.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation HeadBucket for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchBucket "NoSuchBucket" The specified bucket does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/HeadBucket

Example (Shared00)

To determine if bucket exists

This operation checks to see if a bucket exists. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.HeadBucketInput{
		Bucket: aws.String("acl1"),
	}

	result, err := svc.HeadBucket(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case s3.ErrCodeNoSuchBucket:
				fmt.Println(s3.ErrCodeNoSuchBucket, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) HeadBucketRequest 

func (c *S3) HeadBucketRequest(input *HeadBucketInput) (req *request.Request, output *HeadBucketOutput)

HeadBucketRequest generates a "aws/request.Request" representing the client's request for the HeadBucket operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See HeadBucket for more information on using the HeadBucket API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the HeadBucketRequest method.
req, resp := client.HeadBucketRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/HeadBucket

func (*S3) HeadBucketWithContext added in v1.8.0 

func (c *S3) HeadBucketWithContext(ctx aws.Context, input *HeadBucketInput, opts ...request.Option) (*HeadBucketOutput, error)

HeadBucketWithContext is the same as HeadBucket with the addition of the ability to pass a context and additional request options.

See HeadBucket for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) HeadObject 

func (c *S3) HeadObject(input *HeadObjectInput) (*HeadObjectOutput, error)

HeadObject API operation for Amazon Simple Storage Service.

The HEAD operation retrieves metadata from an object without returning the object itself. This operation is useful if you're only interested in an object's metadata. To use HEAD, you must have READ access to the object.

See http://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#RESTErrorResponses for more information on returned errors.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation HeadObject for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/HeadObject

Example (Shared00)

To retrieve metadata of an object without returning the object itself

The following example retrieves an object metadata. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.HeadObjectInput{
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("HappyFace.jpg"),
	}

	result, err := svc.HeadObject(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) HeadObjectRequest 

func (c *S3) HeadObjectRequest(input *HeadObjectInput) (req *request.Request, output *HeadObjectOutput)

HeadObjectRequest generates a "aws/request.Request" representing the client's request for the HeadObject operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See HeadObject for more information on using the HeadObject API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the HeadObjectRequest method.
req, resp := client.HeadObjectRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/HeadObject

func (*S3) HeadObjectWithContext added in v1.8.0 

func (c *S3) HeadObjectWithContext(ctx aws.Context, input *HeadObjectInput, opts ...request.Option) (*HeadObjectOutput, error)

HeadObjectWithContext is the same as HeadObject with the addition of the ability to pass a context and additional request options.

See HeadObject for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) ListBucketAnalyticsConfigurations added in v1.5.11 

func (c *S3) ListBucketAnalyticsConfigurations(input *ListBucketAnalyticsConfigurationsInput) (*ListBucketAnalyticsConfigurationsOutput, error)

ListBucketAnalyticsConfigurations API operation for Amazon Simple Storage Service.

Lists the analytics configurations for the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation ListBucketAnalyticsConfigurations for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketAnalyticsConfigurations

func (*S3) ListBucketAnalyticsConfigurationsRequest added in v1.5.11 

func (c *S3) ListBucketAnalyticsConfigurationsRequest(input *ListBucketAnalyticsConfigurationsInput) (req *request.Request, output *ListBucketAnalyticsConfigurationsOutput)

ListBucketAnalyticsConfigurationsRequest generates a "aws/request.Request" representing the client's request for the ListBucketAnalyticsConfigurations operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListBucketAnalyticsConfigurations for more information on using the ListBucketAnalyticsConfigurations API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the ListBucketAnalyticsConfigurationsRequest method.
req, resp := client.ListBucketAnalyticsConfigurationsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketAnalyticsConfigurations

func (*S3) ListBucketAnalyticsConfigurationsWithContext added in v1.8.0 

func (c *S3) ListBucketAnalyticsConfigurationsWithContext(ctx aws.Context, input *ListBucketAnalyticsConfigurationsInput, opts ...request.Option) (*ListBucketAnalyticsConfigurationsOutput, error)

ListBucketAnalyticsConfigurationsWithContext is the same as ListBucketAnalyticsConfigurations with the addition of the ability to pass a context and additional request options.

See ListBucketAnalyticsConfigurations for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) ListBucketInventoryConfigurations added in v1.5.11 

func (c *S3) ListBucketInventoryConfigurations(input *ListBucketInventoryConfigurationsInput) (*ListBucketInventoryConfigurationsOutput, error)

ListBucketInventoryConfigurations API operation for Amazon Simple Storage Service.

Returns a list of inventory configurations for the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation ListBucketInventoryConfigurations for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketInventoryConfigurations

func (*S3) ListBucketInventoryConfigurationsRequest added in v1.5.11 

func (c *S3) ListBucketInventoryConfigurationsRequest(input *ListBucketInventoryConfigurationsInput) (req *request.Request, output *ListBucketInventoryConfigurationsOutput)

ListBucketInventoryConfigurationsRequest generates a "aws/request.Request" representing the client's request for the ListBucketInventoryConfigurations operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListBucketInventoryConfigurations for more information on using the ListBucketInventoryConfigurations API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the ListBucketInventoryConfigurationsRequest method.
req, resp := client.ListBucketInventoryConfigurationsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketInventoryConfigurations

func (*S3) ListBucketInventoryConfigurationsWithContext added in v1.8.0 

func (c *S3) ListBucketInventoryConfigurationsWithContext(ctx aws.Context, input *ListBucketInventoryConfigurationsInput, opts ...request.Option) (*ListBucketInventoryConfigurationsOutput, error)

ListBucketInventoryConfigurationsWithContext is the same as ListBucketInventoryConfigurations with the addition of the ability to pass a context and additional request options.

See ListBucketInventoryConfigurations for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) ListBucketMetricsConfigurations added in v1.5.11 

func (c *S3) ListBucketMetricsConfigurations(input *ListBucketMetricsConfigurationsInput) (*ListBucketMetricsConfigurationsOutput, error)

ListBucketMetricsConfigurations API operation for Amazon Simple Storage Service.

Lists the metrics configurations for the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation ListBucketMetricsConfigurations for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketMetricsConfigurations

func (*S3) ListBucketMetricsConfigurationsRequest added in v1.5.11 

func (c *S3) ListBucketMetricsConfigurationsRequest(input *ListBucketMetricsConfigurationsInput) (req *request.Request, output *ListBucketMetricsConfigurationsOutput)

ListBucketMetricsConfigurationsRequest generates a "aws/request.Request" representing the client's request for the ListBucketMetricsConfigurations operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListBucketMetricsConfigurations for more information on using the ListBucketMetricsConfigurations API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the ListBucketMetricsConfigurationsRequest method.
req, resp := client.ListBucketMetricsConfigurationsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketMetricsConfigurations

func (*S3) ListBucketMetricsConfigurationsWithContext added in v1.8.0 

func (c *S3) ListBucketMetricsConfigurationsWithContext(ctx aws.Context, input *ListBucketMetricsConfigurationsInput, opts ...request.Option) (*ListBucketMetricsConfigurationsOutput, error)

ListBucketMetricsConfigurationsWithContext is the same as ListBucketMetricsConfigurations with the addition of the ability to pass a context and additional request options.

See ListBucketMetricsConfigurations for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) ListBuckets 

func (c *S3) ListBuckets(input *ListBucketsInput) (*ListBucketsOutput, error)

ListBuckets API operation for Amazon Simple Storage Service.

Returns a list of all buckets owned by the authenticated sender of the request.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation ListBuckets for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBuckets

Example (Shared00)

To list object versions

The following example return versions of an object with specific key name prefix. The request limits the number of items returned to two. If there are are more than two object version, S3 returns NextToken in the response. You can specify this token value in your next request to fetch next set of object versions. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.ListBucketsInput{}

	result, err := svc.ListBuckets(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) ListBucketsRequest 

func (c *S3) ListBucketsRequest(input *ListBucketsInput) (req *request.Request, output *ListBucketsOutput)

ListBucketsRequest generates a "aws/request.Request" representing the client's request for the ListBuckets operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListBuckets for more information on using the ListBuckets API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the ListBucketsRequest method.
req, resp := client.ListBucketsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBuckets

func (*S3) ListBucketsWithContext added in v1.8.0 

func (c *S3) ListBucketsWithContext(ctx aws.Context, input *ListBucketsInput, opts ...request.Option) (*ListBucketsOutput, error)

ListBucketsWithContext is the same as ListBuckets with the addition of the ability to pass a context and additional request options.

See ListBuckets for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) ListMultipartUploads 

func (c *S3) ListMultipartUploads(input *ListMultipartUploadsInput) (*ListMultipartUploadsOutput, error)

ListMultipartUploads API operation for Amazon Simple Storage Service.

This operation lists in-progress multipart uploads.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation ListMultipartUploads for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListMultipartUploads

Example (Shared00)

To list in-progress multipart uploads on a bucket

The following example lists in-progress multipart uploads on a specific bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.ListMultipartUploadsInput{
		Bucket: aws.String("examplebucket"),
	}

	result, err := svc.ListMultipartUploads(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:
Example (Shared01)

List next set of multipart uploads when previous result is truncated

The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next setup of multipart uploads. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.ListMultipartUploadsInput{
		Bucket:         aws.String("examplebucket"),
		KeyMarker:      aws.String("nextkeyfrompreviousresponse"),
		MaxUploads:     aws.Int64(2),
		UploadIdMarker: aws.String("valuefrompreviousresponse"),
	}

	result, err := svc.ListMultipartUploads(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) ListMultipartUploadsPages 

func (c *S3) ListMultipartUploadsPages(input *ListMultipartUploadsInput, fn func(*ListMultipartUploadsOutput, bool) bool) error

ListMultipartUploadsPages iterates over the pages of a ListMultipartUploads operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListMultipartUploads method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service. 

// Example iterating over at most 3 pages of a ListMultipartUploads operation.
pageNum := 0
err := client.ListMultipartUploadsPages(params,
    func(page *ListMultipartUploadsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*S3) ListMultipartUploadsPagesWithContext added in v1.8.0 

func (c *S3) ListMultipartUploadsPagesWithContext(ctx aws.Context, input *ListMultipartUploadsInput, fn func(*ListMultipartUploadsOutput, bool) bool, opts ...request.Option) error

ListMultipartUploadsPagesWithContext same as ListMultipartUploadsPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) ListMultipartUploadsRequest 

func (c *S3) ListMultipartUploadsRequest(input *ListMultipartUploadsInput) (req *request.Request, output *ListMultipartUploadsOutput)

ListMultipartUploadsRequest generates a "aws/request.Request" representing the client's request for the ListMultipartUploads operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListMultipartUploads for more information on using the ListMultipartUploads API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the ListMultipartUploadsRequest method.
req, resp := client.ListMultipartUploadsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListMultipartUploads

func (*S3) ListMultipartUploadsWithContext added in v1.8.0 

func (c *S3) ListMultipartUploadsWithContext(ctx aws.Context, input *ListMultipartUploadsInput, opts ...request.Option) (*ListMultipartUploadsOutput, error)

ListMultipartUploadsWithContext is the same as ListMultipartUploads with the addition of the ability to pass a context and additional request options.

See ListMultipartUploads for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) ListObjectVersions 

func (c *S3) ListObjectVersions(input *ListObjectVersionsInput) (*ListObjectVersionsOutput, error)

ListObjectVersions API operation for Amazon Simple Storage Service.

Returns metadata about all of the versions of objects in a bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation ListObjectVersions for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectVersions

Example (Shared00)

To list object versions

The following example return versions of an object with specific key name prefix. The request limits the number of items returned to two. If there are are more than two object version, S3 returns NextToken in the response. You can specify this token value in your next request to fetch next set of object versions. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.ListObjectVersionsInput{
		Bucket: aws.String("examplebucket"),
		Prefix: aws.String("HappyFace.jpg"),
	}

	result, err := svc.ListObjectVersions(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) ListObjectVersionsPages 

func (c *S3) ListObjectVersionsPages(input *ListObjectVersionsInput, fn func(*ListObjectVersionsOutput, bool) bool) error

ListObjectVersionsPages iterates over the pages of a ListObjectVersions operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListObjectVersions method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service. 

// Example iterating over at most 3 pages of a ListObjectVersions operation.
pageNum := 0
err := client.ListObjectVersionsPages(params,
    func(page *ListObjectVersionsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*S3) ListObjectVersionsPagesWithContext added in v1.8.0 

func (c *S3) ListObjectVersionsPagesWithContext(ctx aws.Context, input *ListObjectVersionsInput, fn func(*ListObjectVersionsOutput, bool) bool, opts ...request.Option) error

ListObjectVersionsPagesWithContext same as ListObjectVersionsPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) ListObjectVersionsRequest 

func (c *S3) ListObjectVersionsRequest(input *ListObjectVersionsInput) (req *request.Request, output *ListObjectVersionsOutput)

ListObjectVersionsRequest generates a "aws/request.Request" representing the client's request for the ListObjectVersions operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListObjectVersions for more information on using the ListObjectVersions API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the ListObjectVersionsRequest method.
req, resp := client.ListObjectVersionsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectVersions

func (*S3) ListObjectVersionsWithContext added in v1.8.0 

func (c *S3) ListObjectVersionsWithContext(ctx aws.Context, input *ListObjectVersionsInput, opts ...request.Option) (*ListObjectVersionsOutput, error)

ListObjectVersionsWithContext is the same as ListObjectVersions with the addition of the ability to pass a context and additional request options.

See ListObjectVersions for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) ListObjects 

func (c *S3) ListObjects(input *ListObjectsInput) (*ListObjectsOutput, error)

ListObjects API operation for Amazon Simple Storage Service.

Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation ListObjects for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchBucket "NoSuchBucket" The specified bucket does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjects

Example (Shared00)

To list objects in a bucket

The following example list two objects in a bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.ListObjectsInput{
		Bucket:  aws.String("examplebucket"),
		MaxKeys: aws.Int64(2),
	}

	result, err := svc.ListObjects(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case s3.ErrCodeNoSuchBucket:
				fmt.Println(s3.ErrCodeNoSuchBucket, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) ListObjectsPages 

func (c *S3) ListObjectsPages(input *ListObjectsInput, fn func(*ListObjectsOutput, bool) bool) error

ListObjectsPages iterates over the pages of a ListObjects operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListObjects method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service. 

// Example iterating over at most 3 pages of a ListObjects operation.
pageNum := 0
err := client.ListObjectsPages(params,
    func(page *ListObjectsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*S3) ListObjectsPagesWithContext added in v1.8.0 

func (c *S3) ListObjectsPagesWithContext(ctx aws.Context, input *ListObjectsInput, fn func(*ListObjectsOutput, bool) bool, opts ...request.Option) error

ListObjectsPagesWithContext same as ListObjectsPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) ListObjectsRequest 

func (c *S3) ListObjectsRequest(input *ListObjectsInput) (req *request.Request, output *ListObjectsOutput)

ListObjectsRequest generates a "aws/request.Request" representing the client's request for the ListObjects operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListObjects for more information on using the ListObjects API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the ListObjectsRequest method.
req, resp := client.ListObjectsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjects

func (*S3) ListObjectsV2 added in v1.1.24 

func (c *S3) ListObjectsV2(input *ListObjectsV2Input) (*ListObjectsV2Output, error)

ListObjectsV2 API operation for Amazon Simple Storage Service.

Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket. Note: ListObjectsV2 is the revised List Objects API and we recommend you use this revised API for new application development.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation ListObjectsV2 for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchBucket "NoSuchBucket" The specified bucket does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectsV2

Example (Shared00)

To get object list

The following example retrieves object list. The request specifies max keys to limit response to include only 2 object keys. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.ListObjectsV2Input{
		Bucket:  aws.String("examplebucket"),
		MaxKeys: aws.Int64(2),
	}

	result, err := svc.ListObjectsV2(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case s3.ErrCodeNoSuchBucket:
				fmt.Println(s3.ErrCodeNoSuchBucket, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) ListObjectsV2Pages added in v1.1.34 

func (c *S3) ListObjectsV2Pages(input *ListObjectsV2Input, fn func(*ListObjectsV2Output, bool) bool) error

ListObjectsV2Pages iterates over the pages of a ListObjectsV2 operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListObjectsV2 method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service. 

// Example iterating over at most 3 pages of a ListObjectsV2 operation.
pageNum := 0
err := client.ListObjectsV2Pages(params,
    func(page *ListObjectsV2Output, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*S3) ListObjectsV2PagesWithContext added in v1.8.0 

func (c *S3) ListObjectsV2PagesWithContext(ctx aws.Context, input *ListObjectsV2Input, fn func(*ListObjectsV2Output, bool) bool, opts ...request.Option) error

ListObjectsV2PagesWithContext same as ListObjectsV2Pages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) ListObjectsV2Request added in v1.1.24 

func (c *S3) ListObjectsV2Request(input *ListObjectsV2Input) (req *request.Request, output *ListObjectsV2Output)

ListObjectsV2Request generates a "aws/request.Request" representing the client's request for the ListObjectsV2 operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListObjectsV2 for more information on using the ListObjectsV2 API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the ListObjectsV2Request method.
req, resp := client.ListObjectsV2Request(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectsV2

func (*S3) ListObjectsV2WithContext added in v1.8.0 

func (c *S3) ListObjectsV2WithContext(ctx aws.Context, input *ListObjectsV2Input, opts ...request.Option) (*ListObjectsV2Output, error)

ListObjectsV2WithContext is the same as ListObjectsV2 with the addition of the ability to pass a context and additional request options.

See ListObjectsV2 for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) ListObjectsWithContext added in v1.8.0 

func (c *S3) ListObjectsWithContext(ctx aws.Context, input *ListObjectsInput, opts ...request.Option) (*ListObjectsOutput, error)

ListObjectsWithContext is the same as ListObjects with the addition of the ability to pass a context and additional request options.

See ListObjects for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) ListParts 

func (c *S3) ListParts(input *ListPartsInput) (*ListPartsOutput, error)

ListParts API operation for Amazon Simple Storage Service.

Lists the parts that have been uploaded for a specific multipart upload.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation ListParts for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListParts

Example (Shared00)

To list parts of a multipart upload.

The following example lists parts uploaded for a specific multipart upload. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.ListPartsInput{
		Bucket:   aws.String("examplebucket"),
		Key:      aws.String("bigobject"),
		UploadId: aws.String("example7YPBOJuoFiQ9cz4P3Pe6FIZwO4f7wN93uHsNBEw97pl5eNwzExg0LAT2dUN91cOmrEQHDsP3WA60CEg--"),
	}

	result, err := svc.ListParts(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) ListPartsPages 

func (c *S3) ListPartsPages(input *ListPartsInput, fn func(*ListPartsOutput, bool) bool) error

ListPartsPages iterates over the pages of a ListParts operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListParts method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service. 

// Example iterating over at most 3 pages of a ListParts operation.
pageNum := 0
err := client.ListPartsPages(params,
    func(page *ListPartsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*S3) ListPartsPagesWithContext added in v1.8.0 

func (c *S3) ListPartsPagesWithContext(ctx aws.Context, input *ListPartsInput, fn func(*ListPartsOutput, bool) bool, opts ...request.Option) error

ListPartsPagesWithContext same as ListPartsPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) ListPartsRequest 

func (c *S3) ListPartsRequest(input *ListPartsInput) (req *request.Request, output *ListPartsOutput)

ListPartsRequest generates a "aws/request.Request" representing the client's request for the ListParts operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListParts for more information on using the ListParts API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the ListPartsRequest method.
req, resp := client.ListPartsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListParts

func (*S3) ListPartsWithContext added in v1.8.0 

func (c *S3) ListPartsWithContext(ctx aws.Context, input *ListPartsInput, opts ...request.Option) (*ListPartsOutput, error)

ListPartsWithContext is the same as ListParts with the addition of the ability to pass a context and additional request options.

See ListParts for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketAccelerateConfiguration added in v1.1.19 

func (c *S3) PutBucketAccelerateConfiguration(input *PutBucketAccelerateConfigurationInput) (*PutBucketAccelerateConfigurationOutput, error)

PutBucketAccelerateConfiguration API operation for Amazon Simple Storage Service.

Sets the accelerate configuration of an existing bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketAccelerateConfiguration for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAccelerateConfiguration

func (*S3) PutBucketAccelerateConfigurationRequest added in v1.1.19 

func (c *S3) PutBucketAccelerateConfigurationRequest(input *PutBucketAccelerateConfigurationInput) (req *request.Request, output *PutBucketAccelerateConfigurationOutput)

PutBucketAccelerateConfigurationRequest generates a "aws/request.Request" representing the client's request for the PutBucketAccelerateConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketAccelerateConfiguration for more information on using the PutBucketAccelerateConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketAccelerateConfigurationRequest method.
req, resp := client.PutBucketAccelerateConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAccelerateConfiguration

func (*S3) PutBucketAccelerateConfigurationWithContext added in v1.8.0 

func (c *S3) PutBucketAccelerateConfigurationWithContext(ctx aws.Context, input *PutBucketAccelerateConfigurationInput, opts ...request.Option) (*PutBucketAccelerateConfigurationOutput, error)

PutBucketAccelerateConfigurationWithContext is the same as PutBucketAccelerateConfiguration with the addition of the ability to pass a context and additional request options.

See PutBucketAccelerateConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketAcl added in v0.9.5 

func (c *S3) PutBucketAcl(input *PutBucketAclInput) (*PutBucketAclOutput, error)

PutBucketAcl API operation for Amazon Simple Storage Service.

Sets the permissions on a bucket using access control lists (ACL).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketAcl for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAcl

Example (Shared00)

Put bucket acl

The following example replaces existing ACL on a bucket. The ACL grants the bucket owner (specified using the owner ID) and write permission to the LogDelivery group. Because this is a replace operation, you must specify all the grants in your request. To incrementally add or remove ACL grants, you might use the console. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutBucketAclInput{
		Bucket:           aws.String("examplebucket"),
		GrantFullControl: aws.String("id=examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484"),
		GrantWrite:       aws.String("uri=http://acs.amazonaws.com/groups/s3/LogDelivery"),
	}

	result, err := svc.PutBucketAcl(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) PutBucketAclRequest added in v0.9.5 

func (c *S3) PutBucketAclRequest(input *PutBucketAclInput) (req *request.Request, output *PutBucketAclOutput)

PutBucketAclRequest generates a "aws/request.Request" representing the client's request for the PutBucketAcl operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketAcl for more information on using the PutBucketAcl API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketAclRequest method.
req, resp := client.PutBucketAclRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAcl

func (*S3) PutBucketAclWithContext added in v1.8.0 

func (c *S3) PutBucketAclWithContext(ctx aws.Context, input *PutBucketAclInput, opts ...request.Option) (*PutBucketAclOutput, error)

PutBucketAclWithContext is the same as PutBucketAcl with the addition of the ability to pass a context and additional request options.

See PutBucketAcl for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketAnalyticsConfiguration added in v1.5.11 

func (c *S3) PutBucketAnalyticsConfiguration(input *PutBucketAnalyticsConfigurationInput) (*PutBucketAnalyticsConfigurationOutput, error)

PutBucketAnalyticsConfiguration API operation for Amazon Simple Storage Service.

Sets an analytics configuration for the bucket (specified by the analytics configuration ID).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketAnalyticsConfiguration for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAnalyticsConfiguration

func (*S3) PutBucketAnalyticsConfigurationRequest added in v1.5.11 

func (c *S3) PutBucketAnalyticsConfigurationRequest(input *PutBucketAnalyticsConfigurationInput) (req *request.Request, output *PutBucketAnalyticsConfigurationOutput)

PutBucketAnalyticsConfigurationRequest generates a "aws/request.Request" representing the client's request for the PutBucketAnalyticsConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketAnalyticsConfiguration for more information on using the PutBucketAnalyticsConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketAnalyticsConfigurationRequest method.
req, resp := client.PutBucketAnalyticsConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAnalyticsConfiguration

func (*S3) PutBucketAnalyticsConfigurationWithContext added in v1.8.0 

func (c *S3) PutBucketAnalyticsConfigurationWithContext(ctx aws.Context, input *PutBucketAnalyticsConfigurationInput, opts ...request.Option) (*PutBucketAnalyticsConfigurationOutput, error)

PutBucketAnalyticsConfigurationWithContext is the same as PutBucketAnalyticsConfiguration with the addition of the ability to pass a context and additional request options.

See PutBucketAnalyticsConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketCors added in v0.9.5 

func (c *S3) PutBucketCors(input *PutBucketCorsInput) (*PutBucketCorsOutput, error)

PutBucketCors API operation for Amazon Simple Storage Service.

Sets the cors configuration for a bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketCors for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketCors

Example (Shared00)

To set cors configuration on a bucket.

The following example enables PUT, POST, and DELETE requests from www.example.com, and enables GET requests from any domain. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutBucketCorsInput{
		Bucket: aws.String(""),
		CORSConfiguration: &s3.CORSConfiguration{
			CORSRules: []*s3.CORSRule{
				{
					AllowedHeaders: []*string{
						aws.String("*"),
					},
					AllowedMethods: []*string{
						aws.String("PUT"),
						aws.String("POST"),
						aws.String("DELETE"),
					},
					AllowedOrigins: []*string{
						aws.String("http://www.example.com"),
					},
					ExposeHeaders: []*string{
						aws.String("x-amz-server-side-encryption"),
					},
					MaxAgeSeconds: aws.Int64(3000),
				},
				{
					AllowedHeaders: []*string{
						aws.String("Authorization"),
					},
					AllowedMethods: []*string{
						aws.String("GET"),
					},
					AllowedOrigins: []*string{
						aws.String("*"),
					},
					MaxAgeSeconds: aws.Int64(3000),
				},
			},
		},
	}

	result, err := svc.PutBucketCors(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) PutBucketCorsRequest added in v0.9.5 

func (c *S3) PutBucketCorsRequest(input *PutBucketCorsInput) (req *request.Request, output *PutBucketCorsOutput)

PutBucketCorsRequest generates a "aws/request.Request" representing the client's request for the PutBucketCors operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketCors for more information on using the PutBucketCors API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketCorsRequest method.
req, resp := client.PutBucketCorsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketCors

func (*S3) PutBucketCorsWithContext added in v1.8.0 

func (c *S3) PutBucketCorsWithContext(ctx aws.Context, input *PutBucketCorsInput, opts ...request.Option) (*PutBucketCorsOutput, error)

PutBucketCorsWithContext is the same as PutBucketCors with the addition of the ability to pass a context and additional request options.

See PutBucketCors for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketEncryption added in v1.12.24 

func (c *S3) PutBucketEncryption(input *PutBucketEncryptionInput) (*PutBucketEncryptionOutput, error)

PutBucketEncryption API operation for Amazon Simple Storage Service.

Creates a new server-side encryption configuration (or replaces an existing one, if present).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketEncryption for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketEncryption

func (*S3) PutBucketEncryptionRequest added in v1.12.24 

func (c *S3) PutBucketEncryptionRequest(input *PutBucketEncryptionInput) (req *request.Request, output *PutBucketEncryptionOutput)

PutBucketEncryptionRequest generates a "aws/request.Request" representing the client's request for the PutBucketEncryption operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketEncryption for more information on using the PutBucketEncryption API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketEncryptionRequest method.
req, resp := client.PutBucketEncryptionRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketEncryption

func (*S3) PutBucketEncryptionWithContext added in v1.12.24 

func (c *S3) PutBucketEncryptionWithContext(ctx aws.Context, input *PutBucketEncryptionInput, opts ...request.Option) (*PutBucketEncryptionOutput, error)

PutBucketEncryptionWithContext is the same as PutBucketEncryption with the addition of the ability to pass a context and additional request options.

See PutBucketEncryption for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketInventoryConfiguration added in v1.5.11 

func (c *S3) PutBucketInventoryConfiguration(input *PutBucketInventoryConfigurationInput) (*PutBucketInventoryConfigurationOutput, error)

PutBucketInventoryConfiguration API operation for Amazon Simple Storage Service.

Adds an inventory configuration (identified by the inventory ID) from the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketInventoryConfiguration for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketInventoryConfiguration

func (*S3) PutBucketInventoryConfigurationRequest added in v1.5.11 

func (c *S3) PutBucketInventoryConfigurationRequest(input *PutBucketInventoryConfigurationInput) (req *request.Request, output *PutBucketInventoryConfigurationOutput)

PutBucketInventoryConfigurationRequest generates a "aws/request.Request" representing the client's request for the PutBucketInventoryConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketInventoryConfiguration for more information on using the PutBucketInventoryConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketInventoryConfigurationRequest method.
req, resp := client.PutBucketInventoryConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketInventoryConfiguration

func (*S3) PutBucketInventoryConfigurationWithContext added in v1.8.0 

func (c *S3) PutBucketInventoryConfigurationWithContext(ctx aws.Context, input *PutBucketInventoryConfigurationInput, opts ...request.Option) (*PutBucketInventoryConfigurationOutput, error)

PutBucketInventoryConfigurationWithContext is the same as PutBucketInventoryConfiguration with the addition of the ability to pass a context and additional request options.

See PutBucketInventoryConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketLifecycle deprecated 

func (c *S3) PutBucketLifecycle(input *PutBucketLifecycleInput) (*PutBucketLifecycleOutput, error)

PutBucketLifecycle API operation for Amazon Simple Storage Service.

Deprecated, see the PutBucketLifecycleConfiguration operation.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketLifecycle for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLifecycle

Deprecated: PutBucketLifecycle has been deprecated

func (*S3) PutBucketLifecycleConfiguration added in v0.9.8 

func (c *S3) PutBucketLifecycleConfiguration(input *PutBucketLifecycleConfigurationInput) (*PutBucketLifecycleConfigurationOutput, error)

PutBucketLifecycleConfiguration API operation for Amazon Simple Storage Service.

Sets lifecycle configuration for your bucket. If a lifecycle configuration exists, it replaces it.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketLifecycleConfiguration for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLifecycleConfiguration

Example (Shared00)

Put bucket lifecycle

The following example replaces existing lifecycle configuration, if any, on the specified bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutBucketLifecycleConfigurationInput{
		Bucket: aws.String("examplebucket"),
		LifecycleConfiguration: &s3.BucketLifecycleConfiguration{
			Rules: []*s3.LifecycleRule{
				{
					Expiration: &s3.LifecycleExpiration{
						Days: aws.Int64(3650),
					},
					Filter: &s3.LifecycleRuleFilter{
						Prefix: aws.String("documents/"),
					},
					ID:     aws.String("TestOnly"),
					Status: aws.String("Enabled"),
					Transitions: []*s3.Transition{
						{
							Days:         aws.Int64(365),
							StorageClass: aws.String("GLACIER"),
						},
					},
				},
			},
		},
	}

	result, err := svc.PutBucketLifecycleConfiguration(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) PutBucketLifecycleConfigurationRequest added in v0.9.8 

func (c *S3) PutBucketLifecycleConfigurationRequest(input *PutBucketLifecycleConfigurationInput) (req *request.Request, output *PutBucketLifecycleConfigurationOutput)

PutBucketLifecycleConfigurationRequest generates a "aws/request.Request" representing the client's request for the PutBucketLifecycleConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketLifecycleConfiguration for more information on using the PutBucketLifecycleConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketLifecycleConfigurationRequest method.
req, resp := client.PutBucketLifecycleConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLifecycleConfiguration

func (*S3) PutBucketLifecycleConfigurationWithContext added in v1.8.0 

func (c *S3) PutBucketLifecycleConfigurationWithContext(ctx aws.Context, input *PutBucketLifecycleConfigurationInput, opts ...request.Option) (*PutBucketLifecycleConfigurationOutput, error)

PutBucketLifecycleConfigurationWithContext is the same as PutBucketLifecycleConfiguration with the addition of the ability to pass a context and additional request options.

See PutBucketLifecycleConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketLifecycleRequest deprecated 

func (c *S3) PutBucketLifecycleRequest(input *PutBucketLifecycleInput) (req *request.Request, output *PutBucketLifecycleOutput)

PutBucketLifecycleRequest generates a "aws/request.Request" representing the client's request for the PutBucketLifecycle operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketLifecycle for more information on using the PutBucketLifecycle API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketLifecycleRequest method.
req, resp := client.PutBucketLifecycleRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLifecycle

Deprecated: PutBucketLifecycle has been deprecated

func (*S3) PutBucketLifecycleWithContext deprecated added in v1.8.0 

func (c *S3) PutBucketLifecycleWithContext(ctx aws.Context, input *PutBucketLifecycleInput, opts ...request.Option) (*PutBucketLifecycleOutput, error)

PutBucketLifecycleWithContext is the same as PutBucketLifecycle with the addition of the ability to pass a context and additional request options.

See PutBucketLifecycle for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

Deprecated: PutBucketLifecycleWithContext has been deprecated

func (*S3) PutBucketLogging 

func (c *S3) PutBucketLogging(input *PutBucketLoggingInput) (*PutBucketLoggingOutput, error)

PutBucketLogging API operation for Amazon Simple Storage Service.

Set the logging parameters for a bucket and to specify permissions for who can view and modify the logging parameters. To set the logging status of a bucket, you must be the bucket owner.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketLogging for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLogging

Example (Shared00)

Set logging configuration for a bucket

The following example sets logging policy on a bucket. For the Log Delivery group to deliver logs to the destination bucket, it needs permission for the READ_ACP action which the policy grants. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutBucketLoggingInput{
		Bucket: aws.String("sourcebucket"),
		BucketLoggingStatus: &s3.BucketLoggingStatus{
			LoggingEnabled: &s3.LoggingEnabled{
				TargetBucket: aws.String("targetbucket"),
				TargetGrants: []*s3.TargetGrant{
					{
						Grantee: &s3.Grantee{
							Type: aws.String("Group"),
							URI:  aws.String("http://acs.amazonaws.com/groups/global/AllUsers"),
						},
						Permission: aws.String("READ"),
					},
				},
				TargetPrefix: aws.String("MyBucketLogs/"),
			},
		},
	}

	result, err := svc.PutBucketLogging(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) PutBucketLoggingRequest 

func (c *S3) PutBucketLoggingRequest(input *PutBucketLoggingInput) (req *request.Request, output *PutBucketLoggingOutput)

PutBucketLoggingRequest generates a "aws/request.Request" representing the client's request for the PutBucketLogging operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketLogging for more information on using the PutBucketLogging API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketLoggingRequest method.
req, resp := client.PutBucketLoggingRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLogging

func (*S3) PutBucketLoggingWithContext added in v1.8.0 

func (c *S3) PutBucketLoggingWithContext(ctx aws.Context, input *PutBucketLoggingInput, opts ...request.Option) (*PutBucketLoggingOutput, error)

PutBucketLoggingWithContext is the same as PutBucketLogging with the addition of the ability to pass a context and additional request options.

See PutBucketLogging for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketMetricsConfiguration added in v1.5.11 

func (c *S3) PutBucketMetricsConfiguration(input *PutBucketMetricsConfigurationInput) (*PutBucketMetricsConfigurationOutput, error)

PutBucketMetricsConfiguration API operation for Amazon Simple Storage Service.

Sets a metrics configuration (specified by the metrics configuration ID) for the bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketMetricsConfiguration for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketMetricsConfiguration

func (*S3) PutBucketMetricsConfigurationRequest added in v1.5.11 

func (c *S3) PutBucketMetricsConfigurationRequest(input *PutBucketMetricsConfigurationInput) (req *request.Request, output *PutBucketMetricsConfigurationOutput)

PutBucketMetricsConfigurationRequest generates a "aws/request.Request" representing the client's request for the PutBucketMetricsConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketMetricsConfiguration for more information on using the PutBucketMetricsConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketMetricsConfigurationRequest method.
req, resp := client.PutBucketMetricsConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketMetricsConfiguration

func (*S3) PutBucketMetricsConfigurationWithContext added in v1.8.0 

func (c *S3) PutBucketMetricsConfigurationWithContext(ctx aws.Context, input *PutBucketMetricsConfigurationInput, opts ...request.Option) (*PutBucketMetricsConfigurationOutput, error)

PutBucketMetricsConfigurationWithContext is the same as PutBucketMetricsConfiguration with the addition of the ability to pass a context and additional request options.

See PutBucketMetricsConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketNotification deprecated 

func (c *S3) PutBucketNotification(input *PutBucketNotificationInput) (*PutBucketNotificationOutput, error)

PutBucketNotification API operation for Amazon Simple Storage Service.

Deprecated, see the PutBucketNotificationConfiguraiton operation.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketNotification for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketNotification

Deprecated: PutBucketNotification has been deprecated

func (*S3) PutBucketNotificationConfiguration 

func (c *S3) PutBucketNotificationConfiguration(input *PutBucketNotificationConfigurationInput) (*PutBucketNotificationConfigurationOutput, error)

PutBucketNotificationConfiguration API operation for Amazon Simple Storage Service.

Enables notifications of specified events for a bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketNotificationConfiguration for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketNotificationConfiguration

Example (Shared00)

Set notification configuration for a bucket

The following example sets notification configuration on a bucket to publish the object created events to an SNS topic. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutBucketNotificationConfigurationInput{
		Bucket: aws.String("examplebucket"),
		NotificationConfiguration: &s3.NotificationConfiguration{
			TopicConfigurations: []*s3.TopicConfiguration{
				{
					Events: []*string{
						aws.String("s3:ObjectCreated:*"),
					},
					TopicArn: aws.String("arn:aws:sns:us-west-2:123456789012:s3-notification-topic"),
				},
			},
		},
	}

	result, err := svc.PutBucketNotificationConfiguration(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) PutBucketNotificationConfigurationRequest 

func (c *S3) PutBucketNotificationConfigurationRequest(input *PutBucketNotificationConfigurationInput) (req *request.Request, output *PutBucketNotificationConfigurationOutput)

PutBucketNotificationConfigurationRequest generates a "aws/request.Request" representing the client's request for the PutBucketNotificationConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketNotificationConfiguration for more information on using the PutBucketNotificationConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketNotificationConfigurationRequest method.
req, resp := client.PutBucketNotificationConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketNotificationConfiguration

func (*S3) PutBucketNotificationConfigurationWithContext added in v1.8.0 

func (c *S3) PutBucketNotificationConfigurationWithContext(ctx aws.Context, input *PutBucketNotificationConfigurationInput, opts ...request.Option) (*PutBucketNotificationConfigurationOutput, error)

PutBucketNotificationConfigurationWithContext is the same as PutBucketNotificationConfiguration with the addition of the ability to pass a context and additional request options.

See PutBucketNotificationConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketNotificationRequest deprecated 

func (c *S3) PutBucketNotificationRequest(input *PutBucketNotificationInput) (req *request.Request, output *PutBucketNotificationOutput)

PutBucketNotificationRequest generates a "aws/request.Request" representing the client's request for the PutBucketNotification operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketNotification for more information on using the PutBucketNotification API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketNotificationRequest method.
req, resp := client.PutBucketNotificationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketNotification

Deprecated: PutBucketNotification has been deprecated

func (*S3) PutBucketNotificationWithContext deprecated added in v1.8.0 

func (c *S3) PutBucketNotificationWithContext(ctx aws.Context, input *PutBucketNotificationInput, opts ...request.Option) (*PutBucketNotificationOutput, error)

PutBucketNotificationWithContext is the same as PutBucketNotification with the addition of the ability to pass a context and additional request options.

See PutBucketNotification for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

Deprecated: PutBucketNotificationWithContext has been deprecated

func (*S3) PutBucketPolicy 

func (c *S3) PutBucketPolicy(input *PutBucketPolicyInput) (*PutBucketPolicyOutput, error)

PutBucketPolicy API operation for Amazon Simple Storage Service.

Replaces a policy on a bucket. If the bucket already has a policy, the one in this request completely replaces it.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketPolicy for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketPolicy

Example (Shared00)

Set bucket policy

The following example sets a permission policy on a bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutBucketPolicyInput{
		Bucket: aws.String("examplebucket"),
		Policy: aws.String("{\"Version\": \"2012-10-17\", \"Statement\": [{ \"Sid\": \"id-1\",\"Effect\": \"Allow\",\"Principal\": {\"AWS\": \"arn:aws:iam::123456789012:root\"}, \"Action\": [ \"s3:PutObject\",\"s3:PutObjectAcl\"], \"Resource\": [\"arn:aws:s3:::acl3/*\" ] } ]}"),
	}

	result, err := svc.PutBucketPolicy(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) PutBucketPolicyRequest 

func (c *S3) PutBucketPolicyRequest(input *PutBucketPolicyInput) (req *request.Request, output *PutBucketPolicyOutput)

PutBucketPolicyRequest generates a "aws/request.Request" representing the client's request for the PutBucketPolicy operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketPolicy for more information on using the PutBucketPolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketPolicyRequest method.
req, resp := client.PutBucketPolicyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketPolicy

func (*S3) PutBucketPolicyWithContext added in v1.8.0 

func (c *S3) PutBucketPolicyWithContext(ctx aws.Context, input *PutBucketPolicyInput, opts ...request.Option) (*PutBucketPolicyOutput, error)

PutBucketPolicyWithContext is the same as PutBucketPolicy with the addition of the ability to pass a context and additional request options.

See PutBucketPolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketReplication 

func (c *S3) PutBucketReplication(input *PutBucketReplicationInput) (*PutBucketReplicationOutput, error)

PutBucketReplication API operation for Amazon Simple Storage Service.

Creates a new replication configuration (or replaces an existing one, if present). For more information, see Cross-Region Replication (CRR) ( https://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html) in the Amazon S3 Developer Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketReplication for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketReplication

Example (Shared00)

Set replication configuration on a bucket

The following example sets replication configuration on a bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutBucketReplicationInput{
		Bucket: aws.String("examplebucket"),
		ReplicationConfiguration: &s3.ReplicationConfiguration{
			Role: aws.String("arn:aws:iam::123456789012:role/examplerole"),
			Rules: []*s3.ReplicationRule{
				{
					Destination: &s3.Destination{
						Bucket:       aws.String("arn:aws:s3:::destinationbucket"),
						StorageClass: aws.String("STANDARD"),
					},
					Prefix: aws.String(""),
					Status: aws.String("Enabled"),
				},
			},
		},
	}

	result, err := svc.PutBucketReplication(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) PutBucketReplicationRequest 

func (c *S3) PutBucketReplicationRequest(input *PutBucketReplicationInput) (req *request.Request, output *PutBucketReplicationOutput)

PutBucketReplicationRequest generates a "aws/request.Request" representing the client's request for the PutBucketReplication operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketReplication for more information on using the PutBucketReplication API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketReplicationRequest method.
req, resp := client.PutBucketReplicationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketReplication

func (*S3) PutBucketReplicationWithContext added in v1.8.0 

func (c *S3) PutBucketReplicationWithContext(ctx aws.Context, input *PutBucketReplicationInput, opts ...request.Option) (*PutBucketReplicationOutput, error)

PutBucketReplicationWithContext is the same as PutBucketReplication with the addition of the ability to pass a context and additional request options.

See PutBucketReplication for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketRequestPayment 

func (c *S3) PutBucketRequestPayment(input *PutBucketRequestPaymentInput) (*PutBucketRequestPaymentOutput, error)

PutBucketRequestPayment API operation for Amazon Simple Storage Service.

Sets the request payment configuration for a bucket. By default, the bucket owner pays for downloads from the bucket. This configuration parameter enables the bucket owner (only) to specify that the person requesting the download will be charged for the download. Documentation on requester pays buckets can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketRequestPayment for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketRequestPayment

Example (Shared00)

Set request payment configuration on a bucket.

The following example sets request payment configuration on a bucket so that person requesting the download is charged. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutBucketRequestPaymentInput{
		Bucket: aws.String("examplebucket"),
		RequestPaymentConfiguration: &s3.RequestPaymentConfiguration{
			Payer: aws.String("Requester"),
		},
	}

	result, err := svc.PutBucketRequestPayment(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) PutBucketRequestPaymentRequest 

func (c *S3) PutBucketRequestPaymentRequest(input *PutBucketRequestPaymentInput) (req *request.Request, output *PutBucketRequestPaymentOutput)

PutBucketRequestPaymentRequest generates a "aws/request.Request" representing the client's request for the PutBucketRequestPayment operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketRequestPayment for more information on using the PutBucketRequestPayment API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketRequestPaymentRequest method.
req, resp := client.PutBucketRequestPaymentRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketRequestPayment

func (*S3) PutBucketRequestPaymentWithContext added in v1.8.0 

func (c *S3) PutBucketRequestPaymentWithContext(ctx aws.Context, input *PutBucketRequestPaymentInput, opts ...request.Option) (*PutBucketRequestPaymentOutput, error)

PutBucketRequestPaymentWithContext is the same as PutBucketRequestPayment with the addition of the ability to pass a context and additional request options.

See PutBucketRequestPayment for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketTagging 

func (c *S3) PutBucketTagging(input *PutBucketTaggingInput) (*PutBucketTaggingOutput, error)

PutBucketTagging API operation for Amazon Simple Storage Service.

Sets the tags for a bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketTagging for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketTagging

Example (Shared00)

Set tags on a bucket

The following example sets tags on a bucket. Any existing tags are replaced. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutBucketTaggingInput{
		Bucket: aws.String("examplebucket"),
		Tagging: &s3.Tagging{
			TagSet: []*s3.Tag{
				{
					Key:   aws.String("Key1"),
					Value: aws.String("Value1"),
				},
				{
					Key:   aws.String("Key2"),
					Value: aws.String("Value2"),
				},
			},
		},
	}

	result, err := svc.PutBucketTagging(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) PutBucketTaggingRequest 

func (c *S3) PutBucketTaggingRequest(input *PutBucketTaggingInput) (req *request.Request, output *PutBucketTaggingOutput)

PutBucketTaggingRequest generates a "aws/request.Request" representing the client's request for the PutBucketTagging operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketTagging for more information on using the PutBucketTagging API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketTaggingRequest method.
req, resp := client.PutBucketTaggingRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketTagging

func (*S3) PutBucketTaggingWithContext added in v1.8.0 

func (c *S3) PutBucketTaggingWithContext(ctx aws.Context, input *PutBucketTaggingInput, opts ...request.Option) (*PutBucketTaggingOutput, error)

PutBucketTaggingWithContext is the same as PutBucketTagging with the addition of the ability to pass a context and additional request options.

See PutBucketTagging for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketVersioning 

func (c *S3) PutBucketVersioning(input *PutBucketVersioningInput) (*PutBucketVersioningOutput, error)

PutBucketVersioning API operation for Amazon Simple Storage Service.

Sets the versioning state of an existing bucket. To set the versioning state, you must be the bucket owner.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketVersioning for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketVersioning

Example (Shared00)

Set versioning configuration on a bucket

The following example sets versioning configuration on bucket. The configuration enables versioning on the bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutBucketVersioningInput{
		Bucket: aws.String("examplebucket"),
		VersioningConfiguration: &s3.VersioningConfiguration{
			MFADelete: aws.String("Disabled"),
			Status:    aws.String("Enabled"),
		},
	}

	result, err := svc.PutBucketVersioning(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) PutBucketVersioningRequest 

func (c *S3) PutBucketVersioningRequest(input *PutBucketVersioningInput) (req *request.Request, output *PutBucketVersioningOutput)

PutBucketVersioningRequest generates a "aws/request.Request" representing the client's request for the PutBucketVersioning operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketVersioning for more information on using the PutBucketVersioning API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketVersioningRequest method.
req, resp := client.PutBucketVersioningRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketVersioning

func (*S3) PutBucketVersioningWithContext added in v1.8.0 

func (c *S3) PutBucketVersioningWithContext(ctx aws.Context, input *PutBucketVersioningInput, opts ...request.Option) (*PutBucketVersioningOutput, error)

PutBucketVersioningWithContext is the same as PutBucketVersioning with the addition of the ability to pass a context and additional request options.

See PutBucketVersioning for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutBucketWebsite 

func (c *S3) PutBucketWebsite(input *PutBucketWebsiteInput) (*PutBucketWebsiteOutput, error)

PutBucketWebsite API operation for Amazon Simple Storage Service.

Set the website configuration for a bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutBucketWebsite for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketWebsite

Example (Shared00)

Set website configuration on a bucket

The following example adds website configuration to a bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutBucketWebsiteInput{
		Bucket: aws.String("examplebucket"),
		WebsiteConfiguration: &s3.WebsiteConfiguration{
			ErrorDocument: &s3.ErrorDocument{
				Key: aws.String("error.html"),
			},
			IndexDocument: &s3.IndexDocument{
				Suffix: aws.String("index.html"),
			},
		},
	}

	result, err := svc.PutBucketWebsite(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) PutBucketWebsiteRequest 

func (c *S3) PutBucketWebsiteRequest(input *PutBucketWebsiteInput) (req *request.Request, output *PutBucketWebsiteOutput)

PutBucketWebsiteRequest generates a "aws/request.Request" representing the client's request for the PutBucketWebsite operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutBucketWebsite for more information on using the PutBucketWebsite API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutBucketWebsiteRequest method.
req, resp := client.PutBucketWebsiteRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketWebsite

func (*S3) PutBucketWebsiteWithContext added in v1.8.0 

func (c *S3) PutBucketWebsiteWithContext(ctx aws.Context, input *PutBucketWebsiteInput, opts ...request.Option) (*PutBucketWebsiteOutput, error)

PutBucketWebsiteWithContext is the same as PutBucketWebsite with the addition of the ability to pass a context and additional request options.

See PutBucketWebsite for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutObject 

func (c *S3) PutObject(input *PutObjectInput) (*PutObjectOutput, error)

PutObject API operation for Amazon Simple Storage Service.

Adds an object to a bucket.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutObject for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObject

Example (Shared00)

To create an object.

The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response. 

package main

import (
	"fmt"
	"strings"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutObjectInput{
		Body:   aws.ReadSeekCloser(strings.NewReader("filetoupload")),
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("objectkey"),
	}

	result, err := svc.PutObject(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:
Example (Shared01)

To upload an object (specify optional headers)

The following example uploads an object. The request specifies optional request headers to directs S3 to use specific storage class and use server-side encryption. 

package main

import (
	"fmt"
	"strings"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutObjectInput{
		Body:                 aws.ReadSeekCloser(strings.NewReader("HappyFace.jpg")),
		Bucket:               aws.String("examplebucket"),
		Key:                  aws.String("HappyFace.jpg"),
		ServerSideEncryption: aws.String("AES256"),
		StorageClass:         aws.String("STANDARD_IA"),
	}

	result, err := svc.PutObject(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:
Example (Shared02)

To upload an object and specify canned ACL.

The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response. 

package main

import (
	"fmt"
	"strings"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutObjectInput{
		ACL:    aws.String("authenticated-read"),
		Body:   aws.ReadSeekCloser(strings.NewReader("filetoupload")),
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("exampleobject"),
	}

	result, err := svc.PutObject(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:
Example (Shared03)

To upload an object

The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file syntax. S3 returns VersionId of the newly created object. 

package main

import (
	"fmt"
	"strings"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutObjectInput{
		Body:   aws.ReadSeekCloser(strings.NewReader("HappyFace.jpg")),
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("HappyFace.jpg"),
	}

	result, err := svc.PutObject(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:
Example (Shared04)

To upload object and specify user-defined metadata

The following example creates an object. The request also specifies optional metadata. If the bucket is versioning enabled, S3 returns version ID in response. 

package main

import (
	"fmt"
	"strings"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutObjectInput{
		Body:   aws.ReadSeekCloser(strings.NewReader("filetoupload")),
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("exampleobject"),
		Metadata: map[string]*string{
			"metadata1": aws.String("value1"),
			"metadata2": aws.String("value2"),
		},
	}

	result, err := svc.PutObject(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:
Example (Shared05)

To upload an object and specify optional tags

The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore S3 returns version ID of the newly created object. 

package main

import (
	"fmt"
	"strings"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutObjectInput{
		Body:    aws.ReadSeekCloser(strings.NewReader("c:\\HappyFace.jpg")),
		Bucket:  aws.String("examplebucket"),
		Key:     aws.String("HappyFace.jpg"),
		Tagging: aws.String("key1=value1&key2=value2"),
	}

	result, err := svc.PutObject(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:
Example (Shared06)

To upload an object and specify server-side encryption and object tags

The following example uploads and object. The request specifies the optional server-side encryption option. The request also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response. 

package main

import (
	"fmt"
	"strings"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutObjectInput{
		Body:                 aws.ReadSeekCloser(strings.NewReader("filetoupload")),
		Bucket:               aws.String("examplebucket"),
		Key:                  aws.String("exampleobject"),
		ServerSideEncryption: aws.String("AES256"),
		Tagging:              aws.String("key1=value1&key2=value2"),
	}

	result, err := svc.PutObject(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) PutObjectAcl added in v0.9.5 

func (c *S3) PutObjectAcl(input *PutObjectAclInput) (*PutObjectAclOutput, error)

PutObjectAcl API operation for Amazon Simple Storage Service.

uses the acl subresource to set the access control list (ACL) permissions for an object that already exists in a bucket

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutObjectAcl for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchKey "NoSuchKey" The specified key does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectAcl

Example (Shared00)

To grant permissions using object ACL

The following example adds grants to an object ACL. The first permission grants user1 and user2 FULL_CONTROL and the AllUsers group READ permission. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutObjectAclInput{
		AccessControlPolicy: &s3.AccessControlPolicy{},
		Bucket:              aws.String("examplebucket"),
		GrantFullControl:    aws.String("emailaddress=user1@example.com,emailaddress=user2@example.com"),
		GrantRead:           aws.String("uri=http://acs.amazonaws.com/groups/global/AllUsers"),
		Key:                 aws.String("HappyFace.jpg"),
	}

	result, err := svc.PutObjectAcl(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case s3.ErrCodeNoSuchKey:
				fmt.Println(s3.ErrCodeNoSuchKey, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) PutObjectAclRequest added in v0.9.5 

func (c *S3) PutObjectAclRequest(input *PutObjectAclInput) (req *request.Request, output *PutObjectAclOutput)

PutObjectAclRequest generates a "aws/request.Request" representing the client's request for the PutObjectAcl operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutObjectAcl for more information on using the PutObjectAcl API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutObjectAclRequest method.
req, resp := client.PutObjectAclRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectAcl

func (*S3) PutObjectAclWithContext added in v1.8.0 

func (c *S3) PutObjectAclWithContext(ctx aws.Context, input *PutObjectAclInput, opts ...request.Option) (*PutObjectAclOutput, error)

PutObjectAclWithContext is the same as PutObjectAcl with the addition of the ability to pass a context and additional request options.

See PutObjectAcl for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutObjectRequest 

func (c *S3) PutObjectRequest(input *PutObjectInput) (req *request.Request, output *PutObjectOutput)

PutObjectRequest generates a "aws/request.Request" representing the client's request for the PutObject operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutObject for more information on using the PutObject API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutObjectRequest method.
req, resp := client.PutObjectRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObject

func (*S3) PutObjectTagging added in v1.5.11 

func (c *S3) PutObjectTagging(input *PutObjectTaggingInput) (*PutObjectTaggingOutput, error)

PutObjectTagging API operation for Amazon Simple Storage Service.

Sets the supplied tag-set to an object that already exists in a bucket

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation PutObjectTagging for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectTagging

Example (Shared00)

To add tags to an existing object

The following example adds tags to an existing object. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.PutObjectTaggingInput{
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("HappyFace.jpg"),
		Tagging: &s3.Tagging{
			TagSet: []*s3.Tag{
				{
					Key:   aws.String("Key3"),
					Value: aws.String("Value3"),
				},
				{
					Key:   aws.String("Key4"),
					Value: aws.String("Value4"),
				},
			},
		},
	}

	result, err := svc.PutObjectTagging(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) PutObjectTaggingRequest added in v1.5.11 

func (c *S3) PutObjectTaggingRequest(input *PutObjectTaggingInput) (req *request.Request, output *PutObjectTaggingOutput)

PutObjectTaggingRequest generates a "aws/request.Request" representing the client's request for the PutObjectTagging operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutObjectTagging for more information on using the PutObjectTagging API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the PutObjectTaggingRequest method.
req, resp := client.PutObjectTaggingRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectTagging

func (*S3) PutObjectTaggingWithContext added in v1.8.0 

func (c *S3) PutObjectTaggingWithContext(ctx aws.Context, input *PutObjectTaggingInput, opts ...request.Option) (*PutObjectTaggingOutput, error)

PutObjectTaggingWithContext is the same as PutObjectTagging with the addition of the ability to pass a context and additional request options.

See PutObjectTagging for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) PutObjectWithContext added in v1.8.0 

func (c *S3) PutObjectWithContext(ctx aws.Context, input *PutObjectInput, opts ...request.Option) (*PutObjectOutput, error)

PutObjectWithContext is the same as PutObject with the addition of the ability to pass a context and additional request options.

See PutObject for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) RestoreObject 

func (c *S3) RestoreObject(input *RestoreObjectInput) (*RestoreObjectOutput, error)

RestoreObject API operation for Amazon Simple Storage Service.

Restores an archived copy of an object back into Amazon S3

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation RestoreObject for usage and error information.

Returned Error Codes:

  • ErrCodeObjectAlreadyInActiveTierError "ObjectAlreadyInActiveTierError" This operation is not allowed against this storage tier

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/RestoreObject

Example (Shared00)

To restore an archived object

The following example restores for one day an archived copy of an object back into Amazon S3 bucket. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.RestoreObjectInput{
		Bucket: aws.String("examplebucket"),
		Key:    aws.String("archivedobjectkey"),
		RestoreRequest: &s3.RestoreRequest{
			Days: aws.Int64(1),
			GlacierJobParameters: &s3.GlacierJobParameters{
				Tier: aws.String("Expedited"),
			},
		},
	}

	result, err := svc.RestoreObject(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case s3.ErrCodeObjectAlreadyInActiveTierError:
				fmt.Println(s3.ErrCodeObjectAlreadyInActiveTierError, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) RestoreObjectRequest 

func (c *S3) RestoreObjectRequest(input *RestoreObjectInput) (req *request.Request, output *RestoreObjectOutput)

RestoreObjectRequest generates a "aws/request.Request" representing the client's request for the RestoreObject operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See RestoreObject for more information on using the RestoreObject API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the RestoreObjectRequest method.
req, resp := client.RestoreObjectRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/RestoreObject

func (*S3) RestoreObjectWithContext added in v1.8.0 

func (c *S3) RestoreObjectWithContext(ctx aws.Context, input *RestoreObjectInput, opts ...request.Option) (*RestoreObjectOutput, error)

RestoreObjectWithContext is the same as RestoreObject with the addition of the ability to pass a context and additional request options.

See RestoreObject for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) SelectObjectContent added in v1.14.0 

func (c *S3) SelectObjectContent(input *SelectObjectContentInput) (*SelectObjectContentOutput, error)

SelectObjectContent API operation for Amazon Simple Storage Service.

This operation filters the contents of an Amazon S3 object based on a simple Structured Query Language (SQL) statement. In the request, along with the SQL expression, you must also specify a data serialization format (JSON or CSV) of the object. Amazon S3 uses this to parse object data into records, and returns only records that match the specified SQL expression. You must also specify the data serialization format for the response.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation SelectObjectContent for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/SelectObjectContent

Example 
sess := session.Must(session.NewSession())
svc := New(sess)

/*
   Example myObjectKey CSV content:

   name,number
   gopher,0
   ᵷodɥǝɹ,1
*/

// Make the Select Object Content API request using the object uploaded.
resp, err := svc.SelectObjectContent(&SelectObjectContentInput{
	Bucket:         aws.String("myBucket"),
	Key:            aws.String("myObjectKey"),
	Expression:     aws.String("SELECT name FROM S3Object WHERE cast(number as int) < 1"),
	ExpressionType: aws.String(ExpressionTypeSql),
	InputSerialization: &InputSerialization{
		CSV: &CSVInput{
			FileHeaderInfo: aws.String(FileHeaderInfoUse),
		},
	},
	OutputSerialization: &OutputSerialization{
		CSV: &CSVOutput{},
	},
})
if err != nil {
	fmt.Fprintf(os.Stderr, "failed making API request, %v\n", err)
	return
}
defer resp.EventStream.Close()

results, resultWriter := io.Pipe()
go func() {
	defer resultWriter.Close()
	for event := range resp.EventStream.Events() {
		switch e := event.(type) {
		case *RecordsEvent:
			resultWriter.Write(e.Payload)
		case *StatsEvent:
			fmt.Printf("Processed %d bytes\n", *e.Details.BytesProcessed)
		}
	}
}()

// Printout the results
resReader := csv.NewReader(results)
for {
	record, err := resReader.Read()
	if err == io.EOF {
		break
	}
	fmt.Println(record)
}

if err := resp.EventStream.Err(); err != nil {
	fmt.Fprintf(os.Stderr, "reading from event stream failed, %v\n", err)
}

Output:

func (*S3) SelectObjectContentRequest added in v1.14.0 

func (c *S3) SelectObjectContentRequest(input *SelectObjectContentInput) (req *request.Request, output *SelectObjectContentOutput)

SelectObjectContentRequest generates a "aws/request.Request" representing the client's request for the SelectObjectContent operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SelectObjectContent for more information on using the SelectObjectContent API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the SelectObjectContentRequest method.
req, resp := client.SelectObjectContentRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/SelectObjectContent

func (*S3) SelectObjectContentWithContext added in v1.14.0 

func (c *S3) SelectObjectContentWithContext(ctx aws.Context, input *SelectObjectContentInput, opts ...request.Option) (*SelectObjectContentOutput, error)

SelectObjectContentWithContext is the same as SelectObjectContent with the addition of the ability to pass a context and additional request options.

See SelectObjectContent for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) UploadPart 

func (c *S3) UploadPart(input *UploadPartInput) (*UploadPartOutput, error)

UploadPart API operation for Amazon Simple Storage Service.

Uploads a part in a multipart upload.

Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation UploadPart for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/UploadPart

Example (Shared00)

To upload a part

The following example uploads part 1 of a multipart upload. The example specifies a file name for the part data. The Upload ID is same that is returned by the initiate multipart upload. 

package main

import (
	"fmt"
	"strings"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.UploadPartInput{
		Body:       aws.ReadSeekCloser(strings.NewReader("fileToUpload")),
		Bucket:     aws.String("examplebucket"),
		Key:        aws.String("examplelargeobject"),
		PartNumber: aws.Int64(1),
		UploadId:   aws.String("xadcOB_7YPBOJuoFiQ9cz4P3Pe6FIZwO4f7wN93uHsNBEw97pl5eNwzExg0LAT2dUN91cOmrEQHDsP3WA60CEg--"),
	}

	result, err := svc.UploadPart(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) UploadPartCopy 

func (c *S3) UploadPartCopy(input *UploadPartCopyInput) (*UploadPartCopyOutput, error)

UploadPartCopy API operation for Amazon Simple Storage Service.

Uploads a part by copying data from an existing object as data source.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Storage Service's API operation UploadPartCopy for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/UploadPartCopy

Example (Shared00)

To upload a part by copying data from an existing object as data source

The following example uploads a part of a multipart upload by copying data from an existing object as data source. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.UploadPartCopyInput{
		Bucket:     aws.String("examplebucket"),
		CopySource: aws.String("/bucketname/sourceobjectkey"),
		Key:        aws.String("examplelargeobject"),
		PartNumber: aws.Int64(1),
		UploadId:   aws.String("exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--"),
	}

	result, err := svc.UploadPartCopy(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:
Example (Shared01)

To upload a part by copying byte range from an existing object as data source

The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as data source. 

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	svc := s3.New(session.New())
	input := &s3.UploadPartCopyInput{
		Bucket:          aws.String("examplebucket"),
		CopySource:      aws.String("/bucketname/sourceobjectkey"),
		CopySourceRange: aws.String("bytes=1-100000"),
		Key:             aws.String("examplelargeobject"),
		PartNumber:      aws.Int64(2),
		UploadId:        aws.String("exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--"),
	}

	result, err := svc.UploadPartCopy(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}

Output:

func (*S3) UploadPartCopyRequest 

func (c *S3) UploadPartCopyRequest(input *UploadPartCopyInput) (req *request.Request, output *UploadPartCopyOutput)

UploadPartCopyRequest generates a "aws/request.Request" representing the client's request for the UploadPartCopy operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UploadPartCopy for more information on using the UploadPartCopy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the UploadPartCopyRequest method.
req, resp := client.UploadPartCopyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/UploadPartCopy

func (*S3) UploadPartCopyWithContext added in v1.8.0 

func (c *S3) UploadPartCopyWithContext(ctx aws.Context, input *UploadPartCopyInput, opts ...request.Option) (*UploadPartCopyOutput, error)

UploadPartCopyWithContext is the same as UploadPartCopy with the addition of the ability to pass a context and additional request options.

See UploadPartCopy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) UploadPartRequest 

func (c *S3) UploadPartRequest(input *UploadPartInput) (req *request.Request, output *UploadPartOutput)

UploadPartRequest generates a "aws/request.Request" representing the client's request for the UploadPart operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UploadPart for more information on using the UploadPart API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the UploadPartRequest method.
req, resp := client.UploadPartRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/UploadPart

func (*S3) UploadPartWithContext added in v1.8.0 

func (c *S3) UploadPartWithContext(ctx aws.Context, input *UploadPartInput, opts ...request.Option) (*UploadPartOutput, error)

UploadPartWithContext is the same as UploadPart with the addition of the ability to pass a context and additional request options.

See UploadPart for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) WaitUntilBucketExists added in v0.10.3 

func (c *S3) WaitUntilBucketExists(input *HeadBucketInput) error

WaitUntilBucketExists uses the Amazon S3 API operation HeadBucket to wait for a condition to be met before returning. If the condition is not met within the max attempt window, an error will be returned.

func (*S3) WaitUntilBucketExistsWithContext added in v1.8.0 

func (c *S3) WaitUntilBucketExistsWithContext(ctx aws.Context, input *HeadBucketInput, opts ...request.WaiterOption) error

WaitUntilBucketExistsWithContext is an extended version of WaitUntilBucketExists. With the support for passing in a context and options to configure the Waiter and the underlying request options.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) WaitUntilBucketNotExists added in v0.10.3 

func (c *S3) WaitUntilBucketNotExists(input *HeadBucketInput) error

WaitUntilBucketNotExists uses the Amazon S3 API operation HeadBucket to wait for a condition to be met before returning. If the condition is not met within the max attempt window, an error will be returned.

func (*S3) WaitUntilBucketNotExistsWithContext added in v1.8.0 

func (c *S3) WaitUntilBucketNotExistsWithContext(ctx aws.Context, input *HeadBucketInput, opts ...request.WaiterOption) error

WaitUntilBucketNotExistsWithContext is an extended version of WaitUntilBucketNotExists. With the support for passing in a context and options to configure the Waiter and the underlying request options.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) WaitUntilObjectExists added in v0.10.3 

func (c *S3) WaitUntilObjectExists(input *HeadObjectInput) error

WaitUntilObjectExists uses the Amazon S3 API operation HeadObject to wait for a condition to be met before returning. If the condition is not met within the max attempt window, an error will be returned.

func (*S3) WaitUntilObjectExistsWithContext added in v1.8.0 

func (c *S3) WaitUntilObjectExistsWithContext(ctx aws.Context, input *HeadObjectInput, opts ...request.WaiterOption) error

WaitUntilObjectExistsWithContext is an extended version of WaitUntilObjectExists. With the support for passing in a context and options to configure the Waiter and the underlying request options.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*S3) WaitUntilObjectNotExists added in v0.10.3 

func (c *S3) WaitUntilObjectNotExists(input *HeadObjectInput) error

WaitUntilObjectNotExists uses the Amazon S3 API operation HeadObject to wait for a condition to be met before returning. If the condition is not met within the max attempt window, an error will be returned.

func (*S3) WaitUntilObjectNotExistsWithContext added in v1.8.0 

func (c *S3) WaitUntilObjectNotExistsWithContext(ctx aws.Context, input *HeadObjectInput, opts ...request.WaiterOption) error

WaitUntilObjectNotExistsWithContext is an extended version of WaitUntilObjectNotExists. With the support for passing in a context and options to configure the Waiter and the underlying request options.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

type SSEKMS added in v1.12.24 

type SSEKMS struct {

	// Specifies the ID of the AWS Key Management Service (KMS) master encryption
	// key to use for encrypting Inventory reports.
	//
	// KeyId is a required field
	KeyId *string `type:"string" required:"true"`
	// contains filtered or unexported fields
}

Specifies the use of SSE-KMS to encrypt delievered Inventory reports.

func (SSEKMS) GoString added in v1.12.24 

func (s SSEKMS) GoString() string

GoString returns the string representation

func (*SSEKMS) SetKeyId added in v1.12.24 

func (s *SSEKMS) SetKeyId(v string) *SSEKMS

SetKeyId sets the KeyId field's value.

func (SSEKMS) String added in v1.12.24 

func (s SSEKMS) String() string

String returns the string representation

func (*SSEKMS) Validate added in v1.12.24 

func (s *SSEKMS) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type SSES3 added in v1.12.24 

type SSES3 struct {
	// contains filtered or unexported fields
}

Specifies the use of SSE-S3 to encrypt delievered Inventory reports.

func (SSES3) GoString added in v1.12.24 

func (s SSES3) GoString() string

GoString returns the string representation

func (SSES3) String added in v1.12.24 

func (s SSES3) String() string

String returns the string representation

type SelectObjectContentEventStream added in v1.14.0 

type SelectObjectContentEventStream struct {
	// Reader is the EventStream reader for the SelectObjectContentEventStream
	// events. This value is automatically set by the SDK when the API call is made
	// Use this member when unit testing your code with the SDK to mock out the
	// EventStream Reader.
	//
	// Must not be nil.
	Reader SelectObjectContentEventStreamReader

	// StreamCloser is the io.Closer for the EventStream connection. For HTTP
	// EventStream this is the response Body. The stream will be closed when
	// the Close method of the EventStream is called.
	StreamCloser io.Closer
}

SelectObjectContentEventStream provides handling of EventStreams for the SelectObjectContent API.

Use this type to receive SelectObjectContentEventStream events. The events can be read from the Events channel member.

The events that can be received are:

  • ContinuationEvent
  • EndEvent
  • ProgressEvent
  • RecordsEvent
  • StatsEvent

func (*SelectObjectContentEventStream) Close added in v1.14.0 

func (es *SelectObjectContentEventStream) Close() (err error)

Close closes the EventStream. This will also cause the Events channel to be closed. You can use the closing of the Events channel to terminate your application's read from the API's EventStream.

Will close the underlying EventStream reader. For EventStream over HTTP connection this will also close the HTTP connection.

Close must be called when done using the EventStream API. Not calling Close may result in resource leaks.

func (*SelectObjectContentEventStream) Err added in v1.14.0 

func (es *SelectObjectContentEventStream) Err() error

Err returns any error that occurred while reading EventStream Events from the service API's response. Returns nil if there were no errors.

func (*SelectObjectContentEventStream) Events added in v1.14.0 

func (es *SelectObjectContentEventStream) Events() <-chan SelectObjectContentEventStreamEvent

Events returns a channel to read EventStream Events from the SelectObjectContent API.

These events are:

  • ContinuationEvent
  • EndEvent
  • ProgressEvent
  • RecordsEvent
  • StatsEvent

type SelectObjectContentEventStreamEvent added in v1.14.0 

type SelectObjectContentEventStreamEvent interface {
	// contains filtered or unexported methods
}

SelectObjectContentEventStreamEvent groups together all EventStream events read from the SelectObjectContent API.

These events are:

  • ContinuationEvent
  • EndEvent
  • ProgressEvent
  • RecordsEvent
  • StatsEvent

type SelectObjectContentEventStreamReader added in v1.14.0 

type SelectObjectContentEventStreamReader interface {
	// Returns a channel of events as they are read from the event stream.
	Events() <-chan SelectObjectContentEventStreamEvent

	// Close will close the underlying event stream reader. For event stream over
	// HTTP this will also close the HTTP connection.
	Close() error

	// Returns any error that has occured while reading from the event stream.
	Err() error
}

SelectObjectContentEventStreamReader provides the interface for reading EventStream Events from the SelectObjectContent API. The default implementation for this interface will be SelectObjectContentEventStream.

The reader's Close method must allow multiple concurrent calls.

These events are:

  • ContinuationEvent
  • EndEvent
  • ProgressEvent
  • RecordsEvent
  • StatsEvent

type SelectObjectContentInput added in v1.14.0 

type SelectObjectContentInput struct {

	// The S3 Bucket.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// The expression that is used to query the object.
	//
	// Expression is a required field
	Expression *string `type:"string" required:"true"`

	// The type of the provided expression (e.g., SQL).
	//
	// ExpressionType is a required field
	ExpressionType *string `type:"string" required:"true" enum:"ExpressionType"`

	// Describes the format of the data in the object that is being queried.
	//
	// InputSerialization is a required field
	InputSerialization *InputSerialization `type:"structure" required:"true"`

	// The Object Key.
	//
	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// Describes the format of the data that you want Amazon S3 to return in response.
	//
	// OutputSerialization is a required field
	OutputSerialization *OutputSerialization `type:"structure" required:"true"`

	// Specifies if periodic request progress information should be enabled.
	RequestProgress *RequestProgress `type:"structure"`

	// The SSE Algorithm used to encrypt the object. For more information, go to
	//  Server-Side Encryption (Using Customer-Provided Encryption Keys (http://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html).
	SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`

	// The SSE Customer Key. For more information, go to  Server-Side Encryption
	// (Using Customer-Provided Encryption Keys (http://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html).
	SSECustomerKey *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"string"`

	// The SSE Customer Key MD5. For more information, go to  Server-Side Encryption
	// (Using Customer-Provided Encryption Keys (http://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html).
	SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
	// contains filtered or unexported fields
}

Request to filter the contents of an Amazon S3 object based on a simple Structured Query Language (SQL) statement. In the request, along with the SQL expression, you must also specify a data serialization format (JSON or CSV) of the object. Amazon S3 uses this to parse object data into records, and returns only records that match the specified SQL expression. You must also specify the data serialization format for the response. For more information, go to S3Select API Documentation (http://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html).

func (SelectObjectContentInput) GoString added in v1.14.0 

func (s SelectObjectContentInput) GoString() string

GoString returns the string representation

func (*SelectObjectContentInput) SetBucket added in v1.14.0 

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

SetBucket sets the Bucket field's value.

func (*SelectObjectContentInput) SetExpression added in v1.14.0 

func (s *SelectObjectContentInput) SetExpression(v string) *SelectObjectContentInput

SetExpression sets the Expression field's value.

func (*SelectObjectContentInput) SetExpressionType added in v1.14.0 

func (s *SelectObjectContentInput) SetExpressionType(v string) *SelectObjectContentInput

SetExpressionType sets the ExpressionType field's value.

func (*SelectObjectContentInput) SetInputSerialization added in v1.14.0 

func (s *SelectObjectContentInput) SetInputSerialization(v *InputSerialization) *SelectObjectContentInput

SetInputSerialization sets the InputSerialization field's value.

func (*SelectObjectContentInput) SetKey added in v1.14.0 

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

SetKey sets the Key field's value.

func (*SelectObjectContentInput) SetOutputSerialization added in v1.14.0 

func (s *SelectObjectContentInput) SetOutputSerialization(v *OutputSerialization) *SelectObjectContentInput

SetOutputSerialization sets the OutputSerialization field's value.

func (*SelectObjectContentInput) SetRequestProgress added in v1.14.0 

func (s *SelectObjectContentInput) SetRequestProgress(v *RequestProgress) *SelectObjectContentInput

SetRequestProgress sets the RequestProgress field's value.

func (*SelectObjectContentInput) SetSSECustomerAlgorithm added in v1.14.0 

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

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.

func (*SelectObjectContentInput) SetSSECustomerKey added in v1.14.0 

func (s *SelectObjectContentInput) SetSSECustomerKey(v string) *SelectObjectContentInput

SetSSECustomerKey sets the SSECustomerKey field's value.

func (*SelectObjectContentInput) SetSSECustomerKeyMD5 added in v1.14.0 

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

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.

func (SelectObjectContentInput) String added in v1.14.0 

func (s SelectObjectContentInput) String() string

String returns the string representation

func (*SelectObjectContentInput) Validate added in v1.14.0 

func (s *SelectObjectContentInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type SelectObjectContentOutput added in v1.14.0 

type SelectObjectContentOutput struct {

	// Use EventStream to use the API's stream.
	EventStream *SelectObjectContentEventStream `type:"structure"`
	// contains filtered or unexported fields
}

func (SelectObjectContentOutput) GoString added in v1.14.0 

func (s SelectObjectContentOutput) GoString() string

GoString returns the string representation

func (*SelectObjectContentOutput) SetEventStream added in v1.14.0 

func (s *SelectObjectContentOutput) SetEventStream(v *SelectObjectContentEventStream) *SelectObjectContentOutput

SetEventStream sets the EventStream field's value.

func (SelectObjectContentOutput) String added in v1.14.0 

func (s SelectObjectContentOutput) String() string

String returns the string representation

type SelectParameters added in v1.12.36 

type SelectParameters struct {

	// The expression that is used to query the object.
	//
	// Expression is a required field
	Expression *string `type:"string" required:"true"`

	// The type of the provided expression (e.g., SQL).
	//
	// ExpressionType is a required field
	ExpressionType *string `type:"string" required:"true" enum:"ExpressionType"`

	// Describes the serialization format of the object.
	//
	// InputSerialization is a required field
	InputSerialization *InputSerialization `type:"structure" required:"true"`

	// Describes how the results of the Select job are serialized.
	//
	// OutputSerialization is a required field
	OutputSerialization *OutputSerialization `type:"structure" required:"true"`
	// contains filtered or unexported fields
}

Describes the parameters for Select job types.

func (SelectParameters) GoString added in v1.12.36 

func (s SelectParameters) GoString() string

GoString returns the string representation

func (*SelectParameters) SetExpression added in v1.12.36 

func (s *SelectParameters) SetExpression(v string) *SelectParameters

SetExpression sets the Expression field's value.

func (*SelectParameters) SetExpressionType added in v1.12.36 

func (s *SelectParameters) SetExpressionType(v string) *SelectParameters

SetExpressionType sets the ExpressionType field's value.

func (*SelectParameters) SetInputSerialization added in v1.12.36 

func (s *SelectParameters) SetInputSerialization(v *InputSerialization) *SelectParameters

SetInputSerialization sets the InputSerialization field's value.

func (*SelectParameters) SetOutputSerialization added in v1.12.36 

func (s *SelectParameters) SetOutputSerialization(v *OutputSerialization) *SelectParameters

SetOutputSerialization sets the OutputSerialization field's value.

func (SelectParameters) String added in v1.12.36 

func (s SelectParameters) String() string

String returns the string representation

func (*SelectParameters) Validate added in v1.12.36 

func (s *SelectParameters) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ServerSideEncryptionByDefault added in v1.12.24 

type ServerSideEncryptionByDefault struct {

	// KMS master key ID to use for the default encryption. This parameter is allowed
	// if SSEAlgorithm is aws:kms.
	KMSMasterKeyID *string `type:"string"`

	// Server-side encryption algorithm to use for the default encryption.
	//
	// SSEAlgorithm is a required field
	SSEAlgorithm *string `type:"string" required:"true" enum:"ServerSideEncryption"`
	// contains filtered or unexported fields
}

Describes the default server-side encryption to apply to new objects in the bucket. If Put Object request does not specify any server-side encryption, this default encryption will be applied.

func (ServerSideEncryptionByDefault) GoString added in v1.12.24 

func (s ServerSideEncryptionByDefault) GoString() string

GoString returns the string representation

func (*ServerSideEncryptionByDefault) SetKMSMasterKeyID added in v1.12.24 

func (s *ServerSideEncryptionByDefault) SetKMSMasterKeyID(v string) *ServerSideEncryptionByDefault

SetKMSMasterKeyID sets the KMSMasterKeyID field's value.

func (*ServerSideEncryptionByDefault) SetSSEAlgorithm added in v1.12.24 

func (s *ServerSideEncryptionByDefault) SetSSEAlgorithm(v string) *ServerSideEncryptionByDefault

SetSSEAlgorithm sets the SSEAlgorithm field's value.

func (ServerSideEncryptionByDefault) String added in v1.12.24 

func (s ServerSideEncryptionByDefault) String() string

String returns the string representation

func (*ServerSideEncryptionByDefault) Validate added in v1.12.24 

func (s *ServerSideEncryptionByDefault) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ServerSideEncryptionConfiguration added in v1.12.24 

type ServerSideEncryptionConfiguration struct {

	// Container for information about a particular server-side encryption configuration
	// rule.
	//
	// Rules is a required field
	Rules []*ServerSideEncryptionRule `locationName:"Rule" type:"list" flattened:"true" required:"true"`
	// contains filtered or unexported fields
}

Container for server-side encryption configuration rules. Currently S3 supports one rule only.

func (ServerSideEncryptionConfiguration) GoString added in v1.12.24 

func (s ServerSideEncryptionConfiguration) GoString() string

GoString returns the string representation

func (*ServerSideEncryptionConfiguration) SetRules added in v1.12.24 

func (s *ServerSideEncryptionConfiguration) SetRules(v []*ServerSideEncryptionRule) *ServerSideEncryptionConfiguration

SetRules sets the Rules field's value.

func (ServerSideEncryptionConfiguration) String added in v1.12.24 

func (s ServerSideEncryptionConfiguration) String() string

String returns the string representation

func (*ServerSideEncryptionConfiguration) Validate added in v1.12.24 

func (s *ServerSideEncryptionConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ServerSideEncryptionRule added in v1.12.24 

type ServerSideEncryptionRule struct {

	// Describes the default server-side encryption to apply to new objects in the
	// bucket. If Put Object request does not specify any server-side encryption,
	// this default encryption will be applied.
	ApplyServerSideEncryptionByDefault *ServerSideEncryptionByDefault `type:"structure"`
	// contains filtered or unexported fields
}

Container for information about a particular server-side encryption configuration rule.

func (ServerSideEncryptionRule) GoString added in v1.12.24 

func (s ServerSideEncryptionRule) GoString() string

GoString returns the string representation

func (*ServerSideEncryptionRule) SetApplyServerSideEncryptionByDefault added in v1.12.24 

func (s *ServerSideEncryptionRule) SetApplyServerSideEncryptionByDefault(v *ServerSideEncryptionByDefault) *ServerSideEncryptionRule

SetApplyServerSideEncryptionByDefault sets the ApplyServerSideEncryptionByDefault field's value.

func (ServerSideEncryptionRule) String added in v1.12.24 

func (s ServerSideEncryptionRule) String() string

String returns the string representation

func (*ServerSideEncryptionRule) Validate added in v1.12.24 

func (s *ServerSideEncryptionRule) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type SourceSelectionCriteria added in v1.12.24 

type SourceSelectionCriteria struct {

	// Container for filter information of selection of KMS Encrypted S3 objects.
	// The element is required if you include SourceSelectionCriteria in the replication
	// configuration.
	SseKmsEncryptedObjects *SseKmsEncryptedObjects `type:"structure"`
	// contains filtered or unexported fields
}

Container for filters that define which source objects should be replicated.

func (SourceSelectionCriteria) GoString added in v1.12.24 

func (s SourceSelectionCriteria) GoString() string

GoString returns the string representation

func (*SourceSelectionCriteria) SetSseKmsEncryptedObjects added in v1.12.24 

func (s *SourceSelectionCriteria) SetSseKmsEncryptedObjects(v *SseKmsEncryptedObjects) *SourceSelectionCriteria

SetSseKmsEncryptedObjects sets the SseKmsEncryptedObjects field's value.

func (SourceSelectionCriteria) String added in v1.12.24 

func (s SourceSelectionCriteria) String() string

String returns the string representation

func (*SourceSelectionCriteria) Validate added in v1.12.24 

func (s *SourceSelectionCriteria) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type SseKmsEncryptedObjects added in v1.12.24 

type SseKmsEncryptedObjects struct {

	// The replication for KMS encrypted S3 objects is disabled if status is not
	// Enabled.
	//
	// Status is a required field
	Status *string `type:"string" required:"true" enum:"SseKmsEncryptedObjectsStatus"`
	// contains filtered or unexported fields
}

Container for filter information of selection of KMS Encrypted S3 objects.

func (SseKmsEncryptedObjects) GoString added in v1.12.24 

func (s SseKmsEncryptedObjects) GoString() string

GoString returns the string representation

func (*SseKmsEncryptedObjects) SetStatus added in v1.12.24 

func (s *SseKmsEncryptedObjects) SetStatus(v string) *SseKmsEncryptedObjects

SetStatus sets the Status field's value.

func (SseKmsEncryptedObjects) String added in v1.12.24 

func (s SseKmsEncryptedObjects) String() string

String returns the string representation

func (*SseKmsEncryptedObjects) Validate added in v1.12.24 

func (s *SseKmsEncryptedObjects) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type Stats added in v1.14.0 

type Stats struct {

	// Total number of uncompressed object bytes processed.
	BytesProcessed *int64 `type:"long"`

	// Total number of bytes of records payload data returned.
	BytesReturned *int64 `type:"long"`

	// Total number of object bytes scanned.
	BytesScanned *int64 `type:"long"`
	// contains filtered or unexported fields
}

func (Stats) GoString added in v1.14.0 

func (s Stats) GoString() string

GoString returns the string representation

func (*Stats) SetBytesProcessed added in v1.14.0 

func (s *Stats) SetBytesProcessed(v int64) *Stats

SetBytesProcessed sets the BytesProcessed field's value.

func (*Stats) SetBytesReturned added in v1.14.0 

func (s *Stats) SetBytesReturned(v int64) *Stats

SetBytesReturned sets the BytesReturned field's value.

func (*Stats) SetBytesScanned added in v1.14.0 

func (s *Stats) SetBytesScanned(v int64) *Stats

SetBytesScanned sets the BytesScanned field's value.

func (Stats) String added in v1.14.0 

func (s Stats) String() string

String returns the string representation

type StatsEvent added in v1.14.0 

type StatsEvent struct {

	// The Stats event details.
	Details *Stats `locationName:"Details" type:"structure"`
	// contains filtered or unexported fields
}

func (StatsEvent) GoString added in v1.14.0 

func (s StatsEvent) GoString() string

GoString returns the string representation

func (*StatsEvent) SetDetails added in v1.14.0 

func (s *StatsEvent) SetDetails(v *Stats) *StatsEvent

SetDetails sets the Details field's value.

func (StatsEvent) String added in v1.14.0 

func (s StatsEvent) String() string

String returns the string representation

func (*StatsEvent) UnmarshalEvent added in v1.14.0 

func (s *StatsEvent) UnmarshalEvent(
	payloadUnmarshaler protocol.PayloadUnmarshaler,
	msg eventstream.Message,
) error

UnmarshalEvent unmarshals the EventStream Message into the StatsEvent value. This method is only used internally within the SDK's EventStream handling.

type StorageClassAnalysis added in v1.5.11 

type StorageClassAnalysis struct {

	// A container used to describe how data related to the storage class analysis
	// should be exported.
	DataExport *StorageClassAnalysisDataExport `type:"structure"`
	// contains filtered or unexported fields
}

func (StorageClassAnalysis) GoString added in v1.5.11 

func (s StorageClassAnalysis) GoString() string

GoString returns the string representation

func (*StorageClassAnalysis) SetDataExport added in v1.5.11 

func (s *StorageClassAnalysis) SetDataExport(v *StorageClassAnalysisDataExport) *StorageClassAnalysis

SetDataExport sets the DataExport field's value.

func (StorageClassAnalysis) String added in v1.5.11 

func (s StorageClassAnalysis) String() string

String returns the string representation

func (*StorageClassAnalysis) Validate added in v1.5.11 

func (s *StorageClassAnalysis) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type StorageClassAnalysisDataExport added in v1.5.11 

type StorageClassAnalysisDataExport struct {

	// The place to store the data for an analysis.
	//
	// Destination is a required field
	Destination *AnalyticsExportDestination `type:"structure" required:"true"`

	// The version of the output schema to use when exporting data. Must be V_1.
	//
	// OutputSchemaVersion is a required field
	OutputSchemaVersion *string `type:"string" required:"true" enum:"StorageClassAnalysisSchemaVersion"`
	// contains filtered or unexported fields
}

func (StorageClassAnalysisDataExport) GoString added in v1.5.11 

func (s StorageClassAnalysisDataExport) GoString() string

GoString returns the string representation

func (*StorageClassAnalysisDataExport) SetDestination added in v1.5.11 

func (s *StorageClassAnalysisDataExport) SetDestination(v *AnalyticsExportDestination) *StorageClassAnalysisDataExport

SetDestination sets the Destination field's value.

func (*StorageClassAnalysisDataExport) SetOutputSchemaVersion added in v1.5.11 

func (s *StorageClassAnalysisDataExport) SetOutputSchemaVersion(v string) *StorageClassAnalysisDataExport

SetOutputSchemaVersion sets the OutputSchemaVersion field's value.

func (StorageClassAnalysisDataExport) String added in v1.5.11 

func (s StorageClassAnalysisDataExport) String() string

String returns the string representation

func (*StorageClassAnalysisDataExport) Validate added in v1.5.11 

func (s *StorageClassAnalysisDataExport) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type Tag 

type Tag struct {

	// Name of the tag.
	//
	// Key is a required field
	Key *string `min:"1" type:"string" required:"true"`

	// Value of the tag.
	//
	// Value is a required field
	Value *string `type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (Tag) GoString added in v0.6.5 

func (s Tag) GoString() string

GoString returns the string representation

func (*Tag) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*Tag) SetValue added in v1.5.0 

func (s *Tag) SetValue(v string) *Tag

SetValue sets the Value field's value.

func (Tag) String added in v0.6.5 

func (s Tag) String() string

String returns the string representation

func (*Tag) Validate added in v1.1.21 

func (s *Tag) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type Tagging 

type Tagging struct {

	// TagSet is a required field
	TagSet []*Tag `locationNameList:"Tag" type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (Tagging) GoString added in v0.6.5 

func (s Tagging) GoString() string

GoString returns the string representation

func (*Tagging) SetTagSet added in v1.5.0 

func (s *Tagging) SetTagSet(v []*Tag) *Tagging

SetTagSet sets the TagSet field's value.

func (Tagging) String added in v0.6.5 

func (s Tagging) String() string

String returns the string representation

func (*Tagging) Validate added in v1.1.21 

func (s *Tagging) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type TargetGrant 

type TargetGrant struct {
	Grantee *Grantee `type:"structure" xmlPrefix:"xsi" xmlURI:"http://www.w3.org/2001/XMLSchema-instance"`

	// Logging permissions assigned to the Grantee for the bucket.
	Permission *string `type:"string" enum:"BucketLogsPermission"`
	// contains filtered or unexported fields
}

func (TargetGrant) GoString added in v0.6.5 

func (s TargetGrant) GoString() string

GoString returns the string representation

func (*TargetGrant) SetGrantee added in v1.5.0 

func (s *TargetGrant) SetGrantee(v *Grantee) *TargetGrant

SetGrantee sets the Grantee field's value.

func (*TargetGrant) SetPermission added in v1.5.0 

func (s *TargetGrant) SetPermission(v string) *TargetGrant

SetPermission sets the Permission field's value.

func (TargetGrant) String added in v0.6.5 

func (s TargetGrant) String() string

String returns the string representation

func (*TargetGrant) Validate added in v1.1.21 

func (s *TargetGrant) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type TopicConfiguration 

type TopicConfiguration struct {

	// Events is a required field
	Events []*string `locationName:"Event" type:"list" flattened:"true" required:"true"`

	// Container for object key name filtering rules. For information about key
	// name filtering, go to Configuring Event Notifications (http://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html)
	// in the Amazon Simple Storage Service Developer Guide.
	Filter *NotificationConfigurationFilter `type:"structure"`

	// Optional unique identifier for configurations in a notification configuration.
	// If you don't provide one, Amazon S3 will assign an ID.
	Id *string `type:"string"`

	// Amazon SNS topic ARN to which Amazon S3 will publish a message when it detects
	// events of specified type.
	//
	// TopicArn is a required field
	TopicArn *string `locationName:"Topic" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Container for specifying the configuration when you want Amazon S3 to publish events to an Amazon Simple Notification Service (Amazon SNS) topic.

func (TopicConfiguration) GoString added in v0.6.5 

func (s TopicConfiguration) GoString() string

GoString returns the string representation

func (*TopicConfiguration) SetEvents added in v1.5.0 

func (s *TopicConfiguration) SetEvents(v []*string) *TopicConfiguration

SetEvents sets the Events field's value.

func (*TopicConfiguration) SetFilter added in v1.5.0 

func (s *TopicConfiguration) SetFilter(v *NotificationConfigurationFilter) *TopicConfiguration

SetFilter sets the Filter field's value.

func (*TopicConfiguration) SetId added in v1.5.0 

func (s *TopicConfiguration) SetId(v string) *TopicConfiguration

SetId sets the Id field's value.

func (*TopicConfiguration) SetTopicArn added in v1.5.0 

func (s *TopicConfiguration) SetTopicArn(v string) *TopicConfiguration

SetTopicArn sets the TopicArn field's value.

func (TopicConfiguration) String added in v0.6.5 

func (s TopicConfiguration) String() string

String returns the string representation

func (*TopicConfiguration) Validate added in v1.1.21 

func (s *TopicConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type TopicConfigurationDeprecated 

type TopicConfigurationDeprecated struct {

	// Bucket event for which to send notifications.
	//
	// Deprecated: Event has been deprecated
	Event *string `deprecated:"true" type:"string" enum:"Event"`

	Events []*string `locationName:"Event" type:"list" flattened:"true"`

	// Optional unique identifier for configurations in a notification configuration.
	// If you don't provide one, Amazon S3 will assign an ID.
	Id *string `type:"string"`

	// Amazon SNS topic to which Amazon S3 will publish a message to report the
	// specified events for the bucket.
	Topic *string `type:"string"`
	// contains filtered or unexported fields
}

func (TopicConfigurationDeprecated) GoString added in v0.6.5 

func (s TopicConfigurationDeprecated) GoString() string

GoString returns the string representation

func (*TopicConfigurationDeprecated) SetEvent added in v1.5.0 

func (s *TopicConfigurationDeprecated) SetEvent(v string) *TopicConfigurationDeprecated

SetEvent sets the Event field's value.

func (*TopicConfigurationDeprecated) SetEvents added in v1.5.0 

func (s *TopicConfigurationDeprecated) SetEvents(v []*string) *TopicConfigurationDeprecated

SetEvents sets the Events field's value.

func (*TopicConfigurationDeprecated) SetId added in v1.5.0 

func (s *TopicConfigurationDeprecated) SetId(v string) *TopicConfigurationDeprecated

SetId sets the Id field's value.

func (*TopicConfigurationDeprecated) SetTopic added in v1.5.0 

func (s *TopicConfigurationDeprecated) SetTopic(v string) *TopicConfigurationDeprecated

SetTopic sets the Topic field's value.

func (TopicConfigurationDeprecated) String added in v0.6.5 

func (s TopicConfigurationDeprecated) String() string

String returns the string representation

type Transition 

type Transition struct {

	// Indicates at what date the object is to be moved or deleted. Should be in
	// GMT ISO 8601 Format.
	Date *time.Time `type:"timestamp" timestampFormat:"iso8601"`

	// Indicates the lifetime, in days, of the objects that are subject to the rule.
	// The value must be a non-zero positive integer.
	Days *int64 `type:"integer"`

	// The class of storage used to store the object.
	StorageClass *string `type:"string" enum:"TransitionStorageClass"`
	// contains filtered or unexported fields
}

func (Transition) GoString added in v0.6.5 

func (s Transition) GoString() string

GoString returns the string representation

func (*Transition) SetDate added in v1.5.0 

func (s *Transition) SetDate(v time.Time) *Transition

SetDate sets the Date field's value.

func (*Transition) SetDays added in v1.5.0 

func (s *Transition) SetDays(v int64) *Transition

SetDays sets the Days field's value.

func (*Transition) SetStorageClass added in v1.5.0 

func (s *Transition) SetStorageClass(v string) *Transition

SetStorageClass sets the StorageClass field's value.

func (Transition) String added in v0.6.5 

func (s Transition) String() string

String returns the string representation

type UploadPartCopyInput 

type UploadPartCopyInput struct {

	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// The name of the source bucket and key name of the source object, separated
	// by a slash (/). Must be URL-encoded.
	//
	// CopySource is a required field
	CopySource *string `location:"header" locationName:"x-amz-copy-source" type:"string" required:"true"`

	// Copies the object if its entity tag (ETag) matches the specified tag.
	CopySourceIfMatch *string `location:"header" locationName:"x-amz-copy-source-if-match" type:"string"`

	// Copies the object if it has been modified since the specified time.
	CopySourceIfModifiedSince *time.Time `location:"header" locationName:"x-amz-copy-source-if-modified-since" type:"timestamp"`

	// Copies the object if its entity tag (ETag) is different than the specified
	// ETag.
	CopySourceIfNoneMatch *string `location:"header" locationName:"x-amz-copy-source-if-none-match" type:"string"`

	// Copies the object if it hasn't been modified since the specified time.
	CopySourceIfUnmodifiedSince *time.Time `location:"header" locationName:"x-amz-copy-source-if-unmodified-since" type:"timestamp"`

	// The range of bytes to copy from the source object. The range value must use
	// the form bytes=first-last, where the first and last are the zero-based byte
	// offsets to copy. For example, bytes=0-9 indicates that you want to copy the
	// first ten bytes of the source. You can copy a range only if the source object
	// is greater than 5 GB.
	CopySourceRange *string `location:"header" locationName:"x-amz-copy-source-range" type:"string"`

	// Specifies the algorithm to use when decrypting the source object (e.g., AES256).
	CopySourceSSECustomerAlgorithm *string `location:"header" locationName:"x-amz-copy-source-server-side-encryption-customer-algorithm" type:"string"`

	// Specifies the customer-provided encryption key for Amazon S3 to use to decrypt
	// the source object. The encryption key provided in this header must be one
	// that was used when the source object was created.
	CopySourceSSECustomerKey *string `location:"header" locationName:"x-amz-copy-source-server-side-encryption-customer-key" type:"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 the encryption
	// key was transmitted without error.
	CopySourceSSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-copy-source-server-side-encryption-customer-key-MD5" type:"string"`

	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// Part number of part being copied. This is a positive integer between 1 and
	// 10,000.
	//
	// PartNumber is a required field
	PartNumber *int64 `location:"querystring" locationName:"partNumber" type:"integer" required:"true"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`

	// Specifies the algorithm to use to when encrypting the object (e.g., AES256).
	SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"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
	// 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. This must be the same encryption key specified in the initiate multipart
	// upload request.
	SSECustomerKey *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"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 the encryption
	// key was transmitted without error.
	SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`

	// Upload ID identifying the multipart upload whose part is being copied.
	//
	// UploadId is a required field
	UploadId *string `location:"querystring" locationName:"uploadId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (UploadPartCopyInput) GoString added in v0.6.5 

func (s UploadPartCopyInput) GoString() string

GoString returns the string representation

func (*UploadPartCopyInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*UploadPartCopyInput) SetCopySource added in v1.5.0 

func (s *UploadPartCopyInput) SetCopySource(v string) *UploadPartCopyInput

SetCopySource sets the CopySource field's value.

func (*UploadPartCopyInput) SetCopySourceIfMatch added in v1.5.0 

func (s *UploadPartCopyInput) SetCopySourceIfMatch(v string) *UploadPartCopyInput

SetCopySourceIfMatch sets the CopySourceIfMatch field's value.

func (*UploadPartCopyInput) SetCopySourceIfModifiedSince added in v1.5.0 

func (s *UploadPartCopyInput) SetCopySourceIfModifiedSince(v time.Time) *UploadPartCopyInput

SetCopySourceIfModifiedSince sets the CopySourceIfModifiedSince field's value.

func (*UploadPartCopyInput) SetCopySourceIfNoneMatch added in v1.5.0 

func (s *UploadPartCopyInput) SetCopySourceIfNoneMatch(v string) *UploadPartCopyInput

SetCopySourceIfNoneMatch sets the CopySourceIfNoneMatch field's value.

func (*UploadPartCopyInput) SetCopySourceIfUnmodifiedSince added in v1.5.0 

func (s *UploadPartCopyInput) SetCopySourceIfUnmodifiedSince(v time.Time) *UploadPartCopyInput

SetCopySourceIfUnmodifiedSince sets the CopySourceIfUnmodifiedSince field's value.

func (*UploadPartCopyInput) SetCopySourceRange added in v1.5.0 

func (s *UploadPartCopyInput) SetCopySourceRange(v string) *UploadPartCopyInput

SetCopySourceRange sets the CopySourceRange field's value.

func (*UploadPartCopyInput) SetCopySourceSSECustomerAlgorithm added in v1.5.0 

func (s *UploadPartCopyInput) SetCopySourceSSECustomerAlgorithm(v string) *UploadPartCopyInput

SetCopySourceSSECustomerAlgorithm sets the CopySourceSSECustomerAlgorithm field's value.

func (*UploadPartCopyInput) SetCopySourceSSECustomerKey added in v1.5.0 

func (s *UploadPartCopyInput) SetCopySourceSSECustomerKey(v string) *UploadPartCopyInput

SetCopySourceSSECustomerKey sets the CopySourceSSECustomerKey field's value.

func (*UploadPartCopyInput) SetCopySourceSSECustomerKeyMD5 added in v1.5.0 

func (s *UploadPartCopyInput) SetCopySourceSSECustomerKeyMD5(v string) *UploadPartCopyInput

SetCopySourceSSECustomerKeyMD5 sets the CopySourceSSECustomerKeyMD5 field's value.

func (*UploadPartCopyInput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*UploadPartCopyInput) SetPartNumber added in v1.5.0 

func (s *UploadPartCopyInput) SetPartNumber(v int64) *UploadPartCopyInput

SetPartNumber sets the PartNumber field's value.

func (*UploadPartCopyInput) SetRequestPayer added in v1.5.0 

func (s *UploadPartCopyInput) SetRequestPayer(v string) *UploadPartCopyInput

SetRequestPayer sets the RequestPayer field's value.

func (*UploadPartCopyInput) SetSSECustomerAlgorithm added in v1.5.0 

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

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.

func (*UploadPartCopyInput) SetSSECustomerKey added in v1.5.0 

func (s *UploadPartCopyInput) SetSSECustomerKey(v string) *UploadPartCopyInput

SetSSECustomerKey sets the SSECustomerKey field's value.

func (*UploadPartCopyInput) SetSSECustomerKeyMD5 added in v1.5.0 

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

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.

func (*UploadPartCopyInput) SetUploadId added in v1.5.0 

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

SetUploadId sets the UploadId field's value.

func (UploadPartCopyInput) String added in v0.6.5 

func (s UploadPartCopyInput) String() string

String returns the string representation

func (*UploadPartCopyInput) Validate added in v1.1.21 

func (s *UploadPartCopyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type UploadPartCopyOutput 

type UploadPartCopyOutput struct {
	CopyPartResult *CopyPartResult `type:"structure"`

	// The version of the source object that was copied, if you have enabled versioning
	// on the source bucket.
	CopySourceVersionId *string `location:"header" locationName:"x-amz-copy-source-version-id" type:"string"`

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"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 `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 to provide round trip message integrity
	// verification of the customer-provided encryption key.
	SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`

	// If present, specifies the ID of the AWS Key Management Service (KMS) master
	// encryption key that was used for the object.
	SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string"`

	// The Server-side encryption algorithm used when storing this object in S3
	// (e.g., AES256, aws:kms).
	ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`
	// contains filtered or unexported fields
}

func (UploadPartCopyOutput) GoString added in v0.6.5 

func (s UploadPartCopyOutput) GoString() string

GoString returns the string representation

func (*UploadPartCopyOutput) SetCopyPartResult added in v1.5.0 

func (s *UploadPartCopyOutput) SetCopyPartResult(v *CopyPartResult) *UploadPartCopyOutput

SetCopyPartResult sets the CopyPartResult field's value.

func (*UploadPartCopyOutput) SetCopySourceVersionId added in v1.5.0 

func (s *UploadPartCopyOutput) SetCopySourceVersionId(v string) *UploadPartCopyOutput

SetCopySourceVersionId sets the CopySourceVersionId field's value.

func (*UploadPartCopyOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (*UploadPartCopyOutput) SetSSECustomerAlgorithm added in v1.5.0 

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

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.

func (*UploadPartCopyOutput) SetSSECustomerKeyMD5 added in v1.5.0 

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

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.

func (*UploadPartCopyOutput) SetSSEKMSKeyId added in v1.5.0 

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

SetSSEKMSKeyId sets the SSEKMSKeyId field's value.

func (*UploadPartCopyOutput) SetServerSideEncryption added in v1.5.0 

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

SetServerSideEncryption sets the ServerSideEncryption field's value.

func (UploadPartCopyOutput) String added in v0.6.5 

func (s UploadPartCopyOutput) String() string

String returns the string representation

type UploadPartInput 

type UploadPartInput struct {

	// Object data.
	Body io.ReadSeeker `type:"blob"`

	// Name of the bucket to which the multipart upload was initiated.
	//
	// Bucket is a required field
	Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

	// Size of the body in bytes. This parameter is useful when the size of the
	// body cannot be determined automatically.
	ContentLength *int64 `location:"header" locationName:"Content-Length" type:"long"`

	// The base64-encoded 128-bit MD5 digest of the part data.
	ContentMD5 *string `location:"header" locationName:"Content-MD5" type:"string"`

	// Object key for which the multipart upload was initiated.
	//
	// Key is a required field
	Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

	// Part number of part being uploaded. This is a positive integer between 1
	// and 10,000.
	//
	// PartNumber is a required field
	PartNumber *int64 `location:"querystring" locationName:"partNumber" type:"integer" required:"true"`

	// Confirms that the requester knows that she or he will be charged for the
	// request. Bucket owners need not specify this parameter in their requests.
	// Documentation on downloading objects from requester pays buckets can be found
	// at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
	RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`

	// Specifies the algorithm to use to when encrypting the object (e.g., AES256).
	SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"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
	// 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. This must be the same encryption key specified in the initiate multipart
	// upload request.
	SSECustomerKey *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"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 the encryption
	// key was transmitted without error.
	SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`

	// Upload ID identifying the multipart upload whose part is being uploaded.
	//
	// UploadId is a required field
	UploadId *string `location:"querystring" locationName:"uploadId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (UploadPartInput) GoString added in v0.6.5 

func (s UploadPartInput) GoString() string

GoString returns the string representation

func (*UploadPartInput) SetBody added in v1.5.0 

func (s *UploadPartInput) SetBody(v io.ReadSeeker) *UploadPartInput

SetBody sets the Body field's value.

func (*UploadPartInput) SetBucket added in v1.5.0 

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

SetBucket sets the Bucket field's value.

func (*UploadPartInput) SetContentLength added in v1.5.0 

func (s *UploadPartInput) SetContentLength(v int64) *UploadPartInput

SetContentLength sets the ContentLength field's value.

func (*UploadPartInput) SetContentMD5 added in v1.12.2 

func (s *UploadPartInput) SetContentMD5(v string) *UploadPartInput

SetContentMD5 sets the ContentMD5 field's value.

func (*UploadPartInput) SetKey added in v1.5.0 

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

SetKey sets the Key field's value.

func (*UploadPartInput) SetPartNumber added in v1.5.0 

func (s *UploadPartInput) SetPartNumber(v int64) *UploadPartInput

SetPartNumber sets the PartNumber field's value.

func (*UploadPartInput) SetRequestPayer added in v1.5.0 

func (s *UploadPartInput) SetRequestPayer(v string) *UploadPartInput

SetRequestPayer sets the RequestPayer field's value.

func (*UploadPartInput) SetSSECustomerAlgorithm added in v1.5.0 

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

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.

func (*UploadPartInput) SetSSECustomerKey added in v1.5.0 

func (s *UploadPartInput) SetSSECustomerKey(v string) *UploadPartInput

SetSSECustomerKey sets the SSECustomerKey field's value.

func (*UploadPartInput) SetSSECustomerKeyMD5 added in v1.5.0 

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

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.

func (*UploadPartInput) SetUploadId added in v1.5.0 

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

SetUploadId sets the UploadId field's value.

func (UploadPartInput) String added in v0.6.5 

func (s UploadPartInput) String() string

String returns the string representation

func (*UploadPartInput) Validate added in v1.1.21 

func (s *UploadPartInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type UploadPartOutput 

type UploadPartOutput struct {

	// Entity tag for the uploaded object.
	ETag *string `location:"header" locationName:"ETag" type:"string"`

	// If present, indicates that the requester was successfully charged for the
	// request.
	RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"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 `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 to provide round trip message integrity
	// verification of the customer-provided encryption key.
	SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`

	// If present, specifies the ID of the AWS Key Management Service (KMS) master
	// encryption key that was used for the object.
	SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string"`

	// The Server-side encryption algorithm used when storing this object in S3
	// (e.g., AES256, aws:kms).
	ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`
	// contains filtered or unexported fields
}

func (UploadPartOutput) GoString added in v0.6.5 

func (s UploadPartOutput) GoString() string

GoString returns the string representation

func (*UploadPartOutput) SetETag added in v1.5.0 

func (s *UploadPartOutput) SetETag(v string) *UploadPartOutput

SetETag sets the ETag field's value.

func (*UploadPartOutput) SetRequestCharged added in v1.5.0 

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

SetRequestCharged sets the RequestCharged field's value.

func (*UploadPartOutput) SetSSECustomerAlgorithm added in v1.5.0 

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

SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.

func (*UploadPartOutput) SetSSECustomerKeyMD5 added in v1.5.0 

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

SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.

func (*UploadPartOutput) SetSSEKMSKeyId added in v1.5.0 

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

SetSSEKMSKeyId sets the SSEKMSKeyId field's value.

func (*UploadPartOutput) SetServerSideEncryption added in v1.5.0 

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

SetServerSideEncryption sets the ServerSideEncryption field's value.

func (UploadPartOutput) String added in v0.6.5 

func (s UploadPartOutput) String() string

String returns the string representation

type VersioningConfiguration 

type VersioningConfiguration struct {

	// Specifies whether MFA delete is enabled in the bucket versioning configuration.
	// This element is only returned if the bucket has been configured with MFA
	// delete. If the bucket has never been so configured, this element is not returned.
	MFADelete *string `locationName:"MfaDelete" type:"string" enum:"MFADelete"`

	// The versioning state of the bucket.
	Status *string `type:"string" enum:"BucketVersioningStatus"`
	// contains filtered or unexported fields
}

func (VersioningConfiguration) GoString added in v0.6.5 

func (s VersioningConfiguration) GoString() string

GoString returns the string representation

func (*VersioningConfiguration) SetMFADelete added in v1.5.0 

func (s *VersioningConfiguration) SetMFADelete(v string) *VersioningConfiguration

SetMFADelete sets the MFADelete field's value.

func (*VersioningConfiguration) SetStatus added in v1.5.0 

func (s *VersioningConfiguration) SetStatus(v string) *VersioningConfiguration

SetStatus sets the Status field's value.

func (VersioningConfiguration) String added in v0.6.5 

func (s VersioningConfiguration) String() string

String returns the string representation

type WebsiteConfiguration 

type WebsiteConfiguration struct {
	ErrorDocument *ErrorDocument `type:"structure"`

	IndexDocument *IndexDocument `type:"structure"`

	RedirectAllRequestsTo *RedirectAllRequestsTo `type:"structure"`

	RoutingRules []*RoutingRule `locationNameList:"RoutingRule" type:"list"`
	// contains filtered or unexported fields
}

func (WebsiteConfiguration) GoString added in v0.6.5 

func (s WebsiteConfiguration) GoString() string

GoString returns the string representation

func (*WebsiteConfiguration) SetErrorDocument added in v1.5.0 

func (s *WebsiteConfiguration) SetErrorDocument(v *ErrorDocument) *WebsiteConfiguration

SetErrorDocument sets the ErrorDocument field's value.

func (*WebsiteConfiguration) SetIndexDocument added in v1.5.0 

func (s *WebsiteConfiguration) SetIndexDocument(v *IndexDocument) *WebsiteConfiguration

SetIndexDocument sets the IndexDocument field's value.

func (*WebsiteConfiguration) SetRedirectAllRequestsTo added in v1.5.0 

func (s *WebsiteConfiguration) SetRedirectAllRequestsTo(v *RedirectAllRequestsTo) *WebsiteConfiguration

SetRedirectAllRequestsTo sets the RedirectAllRequestsTo field's value.

func (*WebsiteConfiguration) SetRoutingRules added in v1.5.0 

func (s *WebsiteConfiguration) SetRoutingRules(v []*RoutingRule) *WebsiteConfiguration

SetRoutingRules sets the RoutingRules field's value.

func (WebsiteConfiguration) String added in v0.6.5 

func (s WebsiteConfiguration) String() string

String returns the string representation

func (*WebsiteConfiguration) Validate added in v1.1.21 

func (s *WebsiteConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

Source Files

View all Source files

Directories

Path Synopsis
Package s3crypto provides encryption to S3 using KMS and AES GCM.
 Package s3crypto provides encryption to S3 using KMS and AES GCM.
Package s3iface provides an interface to enable mocking the Amazon Simple Storage Service service client for testing your code.
 Package s3iface provides an interface to enable mocking the Amazon Simple Storage Service service client for testing your code.
Package s3manager provides utilities to upload and download objects from S3 concurrently.
 Package s3manager provides utilities to upload and download objects from S3 concurrently.
s3manageriface
Package s3manageriface provides an interface for the s3manager package
 Package s3manageriface provides an interface for the s3manager package

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.