Documentation ¶
Overview ¶
Package s3 provides a client for Amazon Simple Storage Service.
Index ¶
- Constants
- type AbortIncompleteMultipartUpload
- type AbortMultipartUploadInput
- type AbortMultipartUploadOutput
- type AccelerateConfiguration
- type AccessControlPolicy
- type Bucket
- type BucketLifecycleConfiguration
- type BucketLoggingStatus
- type CORSConfiguration
- type CORSRule
- type CloudFunctionConfiguration
- type CommonPrefix
- type CompleteMultipartUploadInput
- type CompleteMultipartUploadOutput
- type CompletedMultipartUpload
- type CompletedPart
- type Condition
- type CopyObjectInput
- type CopyObjectOutput
- type CopyObjectResult
- type CopyPartResult
- type CreateBucketConfiguration
- type CreateBucketInput
- type CreateBucketOutput
- type CreateMultipartUploadInput
- type CreateMultipartUploadOutput
- type Delete
- type DeleteBucketCorsInput
- type DeleteBucketCorsOutput
- type DeleteBucketInput
- type DeleteBucketLifecycleInput
- type DeleteBucketLifecycleOutput
- type DeleteBucketOutput
- type DeleteBucketPolicyInput
- type DeleteBucketPolicyOutput
- type DeleteBucketReplicationInput
- type DeleteBucketReplicationOutput
- type DeleteBucketTaggingInput
- type DeleteBucketTaggingOutput
- type DeleteBucketWebsiteInput
- type DeleteBucketWebsiteOutput
- type DeleteMarkerEntry
- type DeleteObjectInput
- type DeleteObjectOutput
- type DeleteObjectsInput
- type DeleteObjectsOutput
- type DeletedObject
- type Destination
- type Error
- type ErrorDocument
- type FilterRule
- type GetBucketAccelerateConfigurationInput
- type GetBucketAccelerateConfigurationOutput
- type GetBucketAclInput
- type GetBucketAclOutput
- type GetBucketCorsInput
- type GetBucketCorsOutput
- type GetBucketLifecycleConfigurationInput
- type GetBucketLifecycleConfigurationOutput
- type GetBucketLifecycleInput
- type GetBucketLifecycleOutput
- type GetBucketLocationInput
- type GetBucketLocationOutput
- type GetBucketLoggingInput
- type GetBucketLoggingOutput
- type GetBucketNotificationConfigurationRequest
- type GetBucketPolicyInput
- type GetBucketPolicyOutput
- type GetBucketReplicationInput
- type GetBucketReplicationOutput
- type GetBucketRequestPaymentInput
- type GetBucketRequestPaymentOutput
- type GetBucketTaggingInput
- type GetBucketTaggingOutput
- type GetBucketVersioningInput
- type GetBucketVersioningOutput
- type GetBucketWebsiteInput
- type GetBucketWebsiteOutput
- type GetObjectAclInput
- type GetObjectAclOutput
- type GetObjectInput
- type GetObjectOutput
- type GetObjectTorrentInput
- type GetObjectTorrentOutput
- type Grant
- type Grantee
- type HeadBucketInput
- type HeadBucketOutput
- type HeadObjectInput
- type HeadObjectOutput
- type IndexDocument
- type Initiator
- type KeyFilter
- type LambdaFunctionConfiguration
- type LifecycleConfiguration
- type LifecycleExpiration
- type LifecycleRule
- type ListBucketsInput
- type ListBucketsOutput
- type ListMultipartUploadsInput
- type ListMultipartUploadsOutput
- type ListObjectVersionsInput
- type ListObjectVersionsOutput
- type ListObjectsInput
- type ListObjectsOutput
- type ListObjectsV2Input
- type ListObjectsV2Output
- type ListPartsInput
- type ListPartsOutput
- type LoggingEnabled
- type MultipartUpload
- type NoncurrentVersionExpiration
- type NoncurrentVersionTransition
- type NotificationConfiguration
- type NotificationConfigurationDeprecated
- type NotificationConfigurationFilter
- type Object
- type ObjectIdentifier
- type ObjectVersion
- type Owner
- type Part
- type PutBucketAccelerateConfigurationInput
- type PutBucketAccelerateConfigurationOutput
- type PutBucketAclInput
- type PutBucketAclOutput
- type PutBucketCorsInput
- type PutBucketCorsOutput
- type PutBucketLifecycleConfigurationInput
- type PutBucketLifecycleConfigurationOutput
- type PutBucketLifecycleInput
- type PutBucketLifecycleOutput
- type PutBucketLoggingInput
- type PutBucketLoggingOutput
- type PutBucketNotificationConfigurationInput
- type PutBucketNotificationConfigurationOutput
- type PutBucketNotificationInput
- type PutBucketNotificationOutput
- type PutBucketPolicyInput
- type PutBucketPolicyOutput
- type PutBucketReplicationInput
- type PutBucketReplicationOutput
- type PutBucketRequestPaymentInput
- type PutBucketRequestPaymentOutput
- type PutBucketTaggingInput
- type PutBucketTaggingOutput
- type PutBucketVersioningInput
- type PutBucketVersioningOutput
- type PutBucketWebsiteInput
- type PutBucketWebsiteOutput
- type PutObjectAclInput
- type PutObjectAclOutput
- type PutObjectInput
- type PutObjectOutput
- type QueueConfiguration
- type QueueConfigurationDeprecated
- type Redirect
- type RedirectAllRequestsTo
- type ReplicationConfiguration
- type ReplicationRule
- type RequestPaymentConfiguration
- type RestoreObjectInput
- type RestoreObjectOutput
- type RestoreRequest
- type RoutingRule
- type Rule
- type S3
- func (c *S3) AbortMultipartUpload(input *AbortMultipartUploadInput) (*AbortMultipartUploadOutput, error)
- func (c *S3) AbortMultipartUploadRequest(input *AbortMultipartUploadInput) (req *request.Request, output *AbortMultipartUploadOutput)
- func (c *S3) CompleteMultipartUpload(input *CompleteMultipartUploadInput) (*CompleteMultipartUploadOutput, error)
- func (c *S3) CompleteMultipartUploadRequest(input *CompleteMultipartUploadInput) (req *request.Request, output *CompleteMultipartUploadOutput)
- func (c *S3) CopyObject(input *CopyObjectInput) (*CopyObjectOutput, error)
- func (c *S3) CopyObjectRequest(input *CopyObjectInput) (req *request.Request, output *CopyObjectOutput)
- func (c *S3) CreateBucket(input *CreateBucketInput) (*CreateBucketOutput, error)
- func (c *S3) CreateBucketRequest(input *CreateBucketInput) (req *request.Request, output *CreateBucketOutput)
- func (c *S3) CreateMultipartUpload(input *CreateMultipartUploadInput) (*CreateMultipartUploadOutput, error)
- func (c *S3) CreateMultipartUploadRequest(input *CreateMultipartUploadInput) (req *request.Request, output *CreateMultipartUploadOutput)
- func (c *S3) DeleteBucket(input *DeleteBucketInput) (*DeleteBucketOutput, error)
- func (c *S3) DeleteBucketCors(input *DeleteBucketCorsInput) (*DeleteBucketCorsOutput, error)
- func (c *S3) DeleteBucketCorsRequest(input *DeleteBucketCorsInput) (req *request.Request, output *DeleteBucketCorsOutput)
- func (c *S3) DeleteBucketLifecycle(input *DeleteBucketLifecycleInput) (*DeleteBucketLifecycleOutput, error)
- func (c *S3) DeleteBucketLifecycleRequest(input *DeleteBucketLifecycleInput) (req *request.Request, output *DeleteBucketLifecycleOutput)
- func (c *S3) DeleteBucketPolicy(input *DeleteBucketPolicyInput) (*DeleteBucketPolicyOutput, error)
- func (c *S3) DeleteBucketPolicyRequest(input *DeleteBucketPolicyInput) (req *request.Request, output *DeleteBucketPolicyOutput)
- func (c *S3) DeleteBucketReplication(input *DeleteBucketReplicationInput) (*DeleteBucketReplicationOutput, error)
- func (c *S3) DeleteBucketReplicationRequest(input *DeleteBucketReplicationInput) (req *request.Request, output *DeleteBucketReplicationOutput)
- func (c *S3) DeleteBucketRequest(input *DeleteBucketInput) (req *request.Request, output *DeleteBucketOutput)
- func (c *S3) DeleteBucketTagging(input *DeleteBucketTaggingInput) (*DeleteBucketTaggingOutput, error)
- func (c *S3) DeleteBucketTaggingRequest(input *DeleteBucketTaggingInput) (req *request.Request, output *DeleteBucketTaggingOutput)
- func (c *S3) DeleteBucketWebsite(input *DeleteBucketWebsiteInput) (*DeleteBucketWebsiteOutput, error)
- func (c *S3) DeleteBucketWebsiteRequest(input *DeleteBucketWebsiteInput) (req *request.Request, output *DeleteBucketWebsiteOutput)
- func (c *S3) DeleteObject(input *DeleteObjectInput) (*DeleteObjectOutput, error)
- func (c *S3) DeleteObjectRequest(input *DeleteObjectInput) (req *request.Request, output *DeleteObjectOutput)
- func (c *S3) DeleteObjects(input *DeleteObjectsInput) (*DeleteObjectsOutput, error)
- func (c *S3) DeleteObjectsRequest(input *DeleteObjectsInput) (req *request.Request, output *DeleteObjectsOutput)
- func (c *S3) GetBucketAccelerateConfiguration(input *GetBucketAccelerateConfigurationInput) (*GetBucketAccelerateConfigurationOutput, error)
- func (c *S3) GetBucketAccelerateConfigurationRequest(input *GetBucketAccelerateConfigurationInput) (req *request.Request, output *GetBucketAccelerateConfigurationOutput)
- func (c *S3) GetBucketAcl(input *GetBucketAclInput) (*GetBucketAclOutput, error)
- func (c *S3) GetBucketAclRequest(input *GetBucketAclInput) (req *request.Request, output *GetBucketAclOutput)
- func (c *S3) GetBucketCors(input *GetBucketCorsInput) (*GetBucketCorsOutput, error)
- func (c *S3) GetBucketCorsRequest(input *GetBucketCorsInput) (req *request.Request, output *GetBucketCorsOutput)
- func (c *S3) GetBucketLifecycle(input *GetBucketLifecycleInput) (*GetBucketLifecycleOutput, error)
- func (c *S3) GetBucketLifecycleConfiguration(input *GetBucketLifecycleConfigurationInput) (*GetBucketLifecycleConfigurationOutput, error)
- func (c *S3) GetBucketLifecycleConfigurationRequest(input *GetBucketLifecycleConfigurationInput) (req *request.Request, output *GetBucketLifecycleConfigurationOutput)
- func (c *S3) GetBucketLifecycleRequest(input *GetBucketLifecycleInput) (req *request.Request, output *GetBucketLifecycleOutput)
- func (c *S3) GetBucketLocation(input *GetBucketLocationInput) (*GetBucketLocationOutput, error)
- func (c *S3) GetBucketLocationRequest(input *GetBucketLocationInput) (req *request.Request, output *GetBucketLocationOutput)
- func (c *S3) GetBucketLogging(input *GetBucketLoggingInput) (*GetBucketLoggingOutput, error)
- func (c *S3) GetBucketLoggingRequest(input *GetBucketLoggingInput) (req *request.Request, output *GetBucketLoggingOutput)
- func (c *S3) GetBucketNotification(input *GetBucketNotificationConfigurationRequest) (*NotificationConfigurationDeprecated, error)
- func (c *S3) GetBucketNotificationConfiguration(input *GetBucketNotificationConfigurationRequest) (*NotificationConfiguration, error)
- func (c *S3) GetBucketNotificationConfigurationRequest(input *GetBucketNotificationConfigurationRequest) (req *request.Request, output *NotificationConfiguration)
- func (c *S3) GetBucketNotificationRequest(input *GetBucketNotificationConfigurationRequest) (req *request.Request, output *NotificationConfigurationDeprecated)
- func (c *S3) GetBucketPolicy(input *GetBucketPolicyInput) (*GetBucketPolicyOutput, error)
- func (c *S3) GetBucketPolicyRequest(input *GetBucketPolicyInput) (req *request.Request, output *GetBucketPolicyOutput)
- func (c *S3) GetBucketReplication(input *GetBucketReplicationInput) (*GetBucketReplicationOutput, error)
- func (c *S3) GetBucketReplicationRequest(input *GetBucketReplicationInput) (req *request.Request, output *GetBucketReplicationOutput)
- func (c *S3) GetBucketRequestPayment(input *GetBucketRequestPaymentInput) (*GetBucketRequestPaymentOutput, error)
- func (c *S3) GetBucketRequestPaymentRequest(input *GetBucketRequestPaymentInput) (req *request.Request, output *GetBucketRequestPaymentOutput)
- func (c *S3) GetBucketTagging(input *GetBucketTaggingInput) (*GetBucketTaggingOutput, error)
- func (c *S3) GetBucketTaggingRequest(input *GetBucketTaggingInput) (req *request.Request, output *GetBucketTaggingOutput)
- func (c *S3) GetBucketVersioning(input *GetBucketVersioningInput) (*GetBucketVersioningOutput, error)
- func (c *S3) GetBucketVersioningRequest(input *GetBucketVersioningInput) (req *request.Request, output *GetBucketVersioningOutput)
- func (c *S3) GetBucketWebsite(input *GetBucketWebsiteInput) (*GetBucketWebsiteOutput, error)
- func (c *S3) GetBucketWebsiteRequest(input *GetBucketWebsiteInput) (req *request.Request, output *GetBucketWebsiteOutput)
- func (c *S3) GetObject(input *GetObjectInput) (*GetObjectOutput, error)
- func (c *S3) GetObjectAcl(input *GetObjectAclInput) (*GetObjectAclOutput, error)
- func (c *S3) GetObjectAclRequest(input *GetObjectAclInput) (req *request.Request, output *GetObjectAclOutput)
- func (c *S3) GetObjectRequest(input *GetObjectInput) (req *request.Request, output *GetObjectOutput)
- func (c *S3) GetObjectTorrent(input *GetObjectTorrentInput) (*GetObjectTorrentOutput, error)
- func (c *S3) GetObjectTorrentRequest(input *GetObjectTorrentInput) (req *request.Request, output *GetObjectTorrentOutput)
- func (c *S3) HeadBucket(input *HeadBucketInput) (*HeadBucketOutput, error)
- func (c *S3) HeadBucketRequest(input *HeadBucketInput) (req *request.Request, output *HeadBucketOutput)
- func (c *S3) HeadObject(input *HeadObjectInput) (*HeadObjectOutput, error)
- func (c *S3) HeadObjectRequest(input *HeadObjectInput) (req *request.Request, output *HeadObjectOutput)
- func (c *S3) ListBuckets(input *ListBucketsInput) (*ListBucketsOutput, error)
- func (c *S3) ListBucketsRequest(input *ListBucketsInput) (req *request.Request, output *ListBucketsOutput)
- func (c *S3) ListMultipartUploads(input *ListMultipartUploadsInput) (*ListMultipartUploadsOutput, error)
- func (c *S3) ListMultipartUploadsPages(input *ListMultipartUploadsInput, ...) error
- func (c *S3) ListMultipartUploadsRequest(input *ListMultipartUploadsInput) (req *request.Request, output *ListMultipartUploadsOutput)
- func (c *S3) ListObjectVersions(input *ListObjectVersionsInput) (*ListObjectVersionsOutput, error)
- func (c *S3) ListObjectVersionsPages(input *ListObjectVersionsInput, ...) error
- func (c *S3) ListObjectVersionsRequest(input *ListObjectVersionsInput) (req *request.Request, output *ListObjectVersionsOutput)
- func (c *S3) ListObjects(input *ListObjectsInput) (*ListObjectsOutput, error)
- func (c *S3) ListObjectsPages(input *ListObjectsInput, ...) error
- func (c *S3) ListObjectsRequest(input *ListObjectsInput) (req *request.Request, output *ListObjectsOutput)
- func (c *S3) ListObjectsV2(input *ListObjectsV2Input) (*ListObjectsV2Output, error)
- func (c *S3) ListObjectsV2Pages(input *ListObjectsV2Input, ...) error
- func (c *S3) ListObjectsV2Request(input *ListObjectsV2Input) (req *request.Request, output *ListObjectsV2Output)
- func (c *S3) ListParts(input *ListPartsInput) (*ListPartsOutput, error)
- func (c *S3) ListPartsPages(input *ListPartsInput, ...) error
- func (c *S3) ListPartsRequest(input *ListPartsInput) (req *request.Request, output *ListPartsOutput)
- func (c *S3) PutBucketAccelerateConfiguration(input *PutBucketAccelerateConfigurationInput) (*PutBucketAccelerateConfigurationOutput, error)
- func (c *S3) PutBucketAccelerateConfigurationRequest(input *PutBucketAccelerateConfigurationInput) (req *request.Request, output *PutBucketAccelerateConfigurationOutput)
- func (c *S3) PutBucketAcl(input *PutBucketAclInput) (*PutBucketAclOutput, error)
- func (c *S3) PutBucketAclRequest(input *PutBucketAclInput) (req *request.Request, output *PutBucketAclOutput)
- func (c *S3) PutBucketCors(input *PutBucketCorsInput) (*PutBucketCorsOutput, error)
- func (c *S3) PutBucketCorsRequest(input *PutBucketCorsInput) (req *request.Request, output *PutBucketCorsOutput)
- func (c *S3) PutBucketLifecycle(input *PutBucketLifecycleInput) (*PutBucketLifecycleOutput, error)
- func (c *S3) PutBucketLifecycleConfiguration(input *PutBucketLifecycleConfigurationInput) (*PutBucketLifecycleConfigurationOutput, error)
- func (c *S3) PutBucketLifecycleConfigurationRequest(input *PutBucketLifecycleConfigurationInput) (req *request.Request, output *PutBucketLifecycleConfigurationOutput)
- func (c *S3) PutBucketLifecycleRequest(input *PutBucketLifecycleInput) (req *request.Request, output *PutBucketLifecycleOutput)
- func (c *S3) PutBucketLogging(input *PutBucketLoggingInput) (*PutBucketLoggingOutput, error)
- func (c *S3) PutBucketLoggingRequest(input *PutBucketLoggingInput) (req *request.Request, output *PutBucketLoggingOutput)
- func (c *S3) PutBucketNotification(input *PutBucketNotificationInput) (*PutBucketNotificationOutput, error)
- func (c *S3) PutBucketNotificationConfiguration(input *PutBucketNotificationConfigurationInput) (*PutBucketNotificationConfigurationOutput, error)
- func (c *S3) PutBucketNotificationConfigurationRequest(input *PutBucketNotificationConfigurationInput) (req *request.Request, output *PutBucketNotificationConfigurationOutput)
- func (c *S3) PutBucketNotificationRequest(input *PutBucketNotificationInput) (req *request.Request, output *PutBucketNotificationOutput)
- func (c *S3) PutBucketPolicy(input *PutBucketPolicyInput) (*PutBucketPolicyOutput, error)
- func (c *S3) PutBucketPolicyRequest(input *PutBucketPolicyInput) (req *request.Request, output *PutBucketPolicyOutput)
- func (c *S3) PutBucketReplication(input *PutBucketReplicationInput) (*PutBucketReplicationOutput, error)
- func (c *S3) PutBucketReplicationRequest(input *PutBucketReplicationInput) (req *request.Request, output *PutBucketReplicationOutput)
- func (c *S3) PutBucketRequestPayment(input *PutBucketRequestPaymentInput) (*PutBucketRequestPaymentOutput, error)
- func (c *S3) PutBucketRequestPaymentRequest(input *PutBucketRequestPaymentInput) (req *request.Request, output *PutBucketRequestPaymentOutput)
- func (c *S3) PutBucketTagging(input *PutBucketTaggingInput) (*PutBucketTaggingOutput, error)
- func (c *S3) PutBucketTaggingRequest(input *PutBucketTaggingInput) (req *request.Request, output *PutBucketTaggingOutput)
- func (c *S3) PutBucketVersioning(input *PutBucketVersioningInput) (*PutBucketVersioningOutput, error)
- func (c *S3) PutBucketVersioningRequest(input *PutBucketVersioningInput) (req *request.Request, output *PutBucketVersioningOutput)
- func (c *S3) PutBucketWebsite(input *PutBucketWebsiteInput) (*PutBucketWebsiteOutput, error)
- func (c *S3) PutBucketWebsiteRequest(input *PutBucketWebsiteInput) (req *request.Request, output *PutBucketWebsiteOutput)
- func (c *S3) PutObject(input *PutObjectInput) (*PutObjectOutput, error)
- func (c *S3) PutObjectAcl(input *PutObjectAclInput) (*PutObjectAclOutput, error)
- func (c *S3) PutObjectAclRequest(input *PutObjectAclInput) (req *request.Request, output *PutObjectAclOutput)
- func (c *S3) PutObjectRequest(input *PutObjectInput) (req *request.Request, output *PutObjectOutput)
- func (c *S3) RestoreObject(input *RestoreObjectInput) (*RestoreObjectOutput, error)
- func (c *S3) RestoreObjectRequest(input *RestoreObjectInput) (req *request.Request, output *RestoreObjectOutput)
- func (c *S3) UploadPart(input *UploadPartInput) (*UploadPartOutput, error)
- func (c *S3) UploadPartCopy(input *UploadPartCopyInput) (*UploadPartCopyOutput, error)
- func (c *S3) UploadPartCopyRequest(input *UploadPartCopyInput) (req *request.Request, output *UploadPartCopyOutput)
- func (c *S3) UploadPartRequest(input *UploadPartInput) (req *request.Request, output *UploadPartOutput)
- func (c *S3) WaitUntilBucketExists(input *HeadBucketInput) error
- func (c *S3) WaitUntilBucketNotExists(input *HeadBucketInput) error
- func (c *S3) WaitUntilObjectExists(input *HeadObjectInput) error
- func (c *S3) WaitUntilObjectNotExists(input *HeadObjectInput) error
- type Tag
- type Tagging
- type TargetGrant
- type TopicConfiguration
- type TopicConfigurationDeprecated
- type Transition
- type UploadPartCopyInput
- type UploadPartCopyOutput
- type UploadPartInput
- type UploadPartOutput
- type VersioningConfiguration
- type WebsiteConfiguration
Examples ¶
- S3.AbortMultipartUpload
- S3.CompleteMultipartUpload
- S3.CopyObject
- S3.CreateBucket
- S3.CreateMultipartUpload
- S3.DeleteBucket
- S3.DeleteBucketCors
- S3.DeleteBucketLifecycle
- S3.DeleteBucketPolicy
- S3.DeleteBucketReplication
- S3.DeleteBucketTagging
- S3.DeleteBucketWebsite
- S3.DeleteObject
- S3.DeleteObjects
- S3.GetBucketAccelerateConfiguration
- S3.GetBucketAcl
- S3.GetBucketCors
- S3.GetBucketLifecycle
- S3.GetBucketLifecycleConfiguration
- S3.GetBucketLocation
- S3.GetBucketLogging
- S3.GetBucketNotification
- S3.GetBucketNotificationConfiguration
- S3.GetBucketPolicy
- S3.GetBucketReplication
- S3.GetBucketRequestPayment
- S3.GetBucketTagging
- S3.GetBucketVersioning
- S3.GetBucketWebsite
- S3.GetObject
- S3.GetObjectAcl
- S3.GetObjectTorrent
- S3.HeadBucket
- S3.HeadObject
- S3.ListBuckets
- S3.ListMultipartUploads
- S3.ListObjectVersions
- S3.ListObjects
- S3.ListObjectsV2
- S3.ListParts
- S3.PutBucketAccelerateConfiguration
- S3.PutBucketAcl
- S3.PutBucketCors
- S3.PutBucketLifecycle
- S3.PutBucketLifecycleConfiguration
- S3.PutBucketLogging
- S3.PutBucketNotification
- S3.PutBucketNotificationConfiguration
- S3.PutBucketPolicy
- S3.PutBucketReplication
- S3.PutBucketRequestPayment
- S3.PutBucketTagging
- S3.PutBucketVersioning
- S3.PutBucketWebsite
- S3.PutObject
- S3.PutObjectAcl
- S3.RestoreObject
- S3.UploadPart
- S3.UploadPartCopy
Constants ¶
const ( // @enum BucketAccelerateStatus BucketAccelerateStatusEnabled = "Enabled" // @enum BucketAccelerateStatus BucketAccelerateStatusSuspended = "Suspended" )
const ( // @enum BucketCannedACL BucketCannedACLPrivate = "private" // @enum BucketCannedACL BucketCannedACLPublicRead = "public-read" // @enum BucketCannedACL BucketCannedACLPublicReadWrite = "public-read-write" // @enum BucketCannedACL BucketCannedACLAuthenticatedRead = "authenticated-read" )
const ( // @enum BucketLocationConstraint BucketLocationConstraintEu = "EU" // @enum BucketLocationConstraint BucketLocationConstraintEuWest1 = "eu-west-1" // @enum BucketLocationConstraint BucketLocationConstraintUsWest1 = "us-west-1" // @enum BucketLocationConstraint BucketLocationConstraintUsWest2 = "us-west-2" // @enum BucketLocationConstraint BucketLocationConstraintApSouth1 = "ap-south-1" // @enum BucketLocationConstraint BucketLocationConstraintApSoutheast1 = "ap-southeast-1" // @enum BucketLocationConstraint BucketLocationConstraintApSoutheast2 = "ap-southeast-2" // @enum BucketLocationConstraint BucketLocationConstraintApNortheast1 = "ap-northeast-1" // @enum BucketLocationConstraint BucketLocationConstraintSaEast1 = "sa-east-1" // @enum BucketLocationConstraint BucketLocationConstraintCnNorth1 = "cn-north-1" // @enum BucketLocationConstraint BucketLocationConstraintEuCentral1 = "eu-central-1" )
const ( // @enum BucketLogsPermission BucketLogsPermissionFullControl = "FULL_CONTROL" // @enum BucketLogsPermission BucketLogsPermissionRead = "READ" // @enum BucketLogsPermission BucketLogsPermissionWrite = "WRITE" )
const ( // @enum BucketVersioningStatus BucketVersioningStatusEnabled = "Enabled" // @enum BucketVersioningStatus BucketVersioningStatusSuspended = "Suspended" )
const ( // @enum Event EventS3ReducedRedundancyLostObject = "s3:ReducedRedundancyLostObject" // @enum Event EventS3ObjectCreated = "s3:ObjectCreated:*" // @enum Event EventS3ObjectCreatedPut = "s3:ObjectCreated:Put" // @enum Event EventS3ObjectCreatedPost = "s3:ObjectCreated:Post" // @enum Event EventS3ObjectCreatedCopy = "s3:ObjectCreated:Copy" // @enum Event EventS3ObjectCreatedCompleteMultipartUpload = "s3:ObjectCreated:CompleteMultipartUpload" // @enum Event EventS3ObjectRemoved = "s3:ObjectRemoved:*" // @enum Event EventS3ObjectRemovedDelete = "s3:ObjectRemoved:Delete" // @enum Event EventS3ObjectRemovedDeleteMarkerCreated = "s3:ObjectRemoved:DeleteMarkerCreated" )
Bucket event for which to send notifications.
const ( // @enum ExpirationStatus ExpirationStatusEnabled = "Enabled" // @enum ExpirationStatus ExpirationStatusDisabled = "Disabled" )
const ( // @enum FilterRuleName FilterRuleNamePrefix = "prefix" // @enum FilterRuleName FilterRuleNameSuffix = "suffix" )
const ( // @enum MFADelete MFADeleteEnabled = "Enabled" // @enum MFADelete MFADeleteDisabled = "Disabled" )
const ( // @enum MFADeleteStatus MFADeleteStatusEnabled = "Enabled" // @enum MFADeleteStatus MFADeleteStatusDisabled = "Disabled" )
const ( // @enum MetadataDirective MetadataDirectiveCopy = "COPY" // @enum MetadataDirective MetadataDirectiveReplace = "REPLACE" )
const ( // @enum ObjectCannedACL ObjectCannedACLPrivate = "private" // @enum ObjectCannedACL ObjectCannedACLPublicRead = "public-read" // @enum ObjectCannedACL ObjectCannedACLPublicReadWrite = "public-read-write" // @enum ObjectCannedACL ObjectCannedACLAuthenticatedRead = "authenticated-read" // @enum ObjectCannedACL ObjectCannedACLAwsExecRead = "aws-exec-read" // @enum ObjectCannedACL ObjectCannedACLBucketOwnerRead = "bucket-owner-read" // @enum ObjectCannedACL ObjectCannedACLBucketOwnerFullControl = "bucket-owner-full-control" )
const ( // @enum ObjectStorageClass ObjectStorageClassStandard = "STANDARD" // @enum ObjectStorageClass ObjectStorageClassReducedRedundancy = "REDUCED_REDUNDANCY" // @enum ObjectStorageClass ObjectStorageClassGlacier = "GLACIER" )
const ( // @enum Payer PayerRequester = "Requester" // @enum Payer PayerBucketOwner = "BucketOwner" )
const ( // @enum Permission PermissionFullControl = "FULL_CONTROL" // @enum Permission PermissionWrite = "WRITE" // @enum Permission PermissionWriteAcp = "WRITE_ACP" // @enum Permission PermissionRead = "READ" // @enum Permission PermissionReadAcp = "READ_ACP" )
const ( // @enum Protocol ProtocolHttp = "http" // @enum Protocol ProtocolHttps = "https" )
const ( // @enum ReplicationRuleStatus ReplicationRuleStatusEnabled = "Enabled" // @enum ReplicationRuleStatus ReplicationRuleStatusDisabled = "Disabled" )
const ( // @enum ReplicationStatus ReplicationStatusComplete = "COMPLETE" // @enum ReplicationStatus ReplicationStatusPending = "PENDING" // @enum ReplicationStatus ReplicationStatusFailed = "FAILED" // @enum ReplicationStatus ReplicationStatusReplica = "REPLICA" )
const ( // @enum ServerSideEncryption ServerSideEncryptionAes256 = "AES256" // @enum ServerSideEncryption ServerSideEncryptionAwsKms = "aws:kms" )
const ( // @enum StorageClass StorageClassStandard = "STANDARD" // @enum StorageClass StorageClassReducedRedundancy = "REDUCED_REDUNDANCY" // @enum StorageClass StorageClassStandardIa = "STANDARD_IA" )
const ( // @enum TransitionStorageClass TransitionStorageClassGlacier = "GLACIER" // @enum TransitionStorageClass TransitionStorageClassStandardIa = "STANDARD_IA" )
const ( // @enum Type TypeCanonicalUser = "CanonicalUser" // @enum Type TypeAmazonCustomerByEmail = "AmazonCustomerByEmail" // @enum Type TypeGroup = "Group" )
const (
// @enum EncodingType
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.
const (
// @enum ObjectVersionStorageClass
ObjectVersionStorageClassStandard = "STANDARD"
)
const (
// @enum RequestCharged
RequestChargedRequester = "requester"
)
If present, indicates that the requester was successfully charged for the request.
const (
// @enum RequestPayer
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
const ServiceName = "s3"
A ServiceName is the name of the service the client will make API calls to.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
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) String ¶ added in v1.1.12
func (s AbortIncompleteMultipartUpload) String() string
String returns the string representation
type AbortMultipartUploadInput ¶
type AbortMultipartUploadInput struct { Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` 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 *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) 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) 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) 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) 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 Bucket ¶
type Bucket struct { // Date the bucket was created. CreationDate *time.Time `type:"timestamp" timestampFormat:"iso8601"` // The name of the bucket. Name *string `type:"string"` // contains filtered or unexported fields }
type BucketLifecycleConfiguration ¶ added in v0.9.8
type BucketLifecycleConfiguration struct { 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) 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 { 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) 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 []*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) 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 []*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 []*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 }
type CloudFunctionConfiguration ¶
type CloudFunctionConfiguration struct { CloudFunction *string `type:"string"` // Bucket event for which to send notifications. 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) 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) String ¶ added in v0.6.5
func (s CommonPrefix) String() string
String returns the string representation
type CompleteMultipartUploadInput ¶
type CompleteMultipartUploadInput struct { Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"` MultipartUpload *CompletedMultipartUpload `locationName:"CompleteMultipartUpload" type:"structure"` // 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 *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) 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) 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) 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) 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 }
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 *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 *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" timestampFormat:"rfc822"` // 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" timestampFormat:"rfc822"` // 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" timestampFormat:"rfc822"` // 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 *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"` // 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) 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) 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" timestampFormat:"iso8601"` // 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) 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" timestampFormat:"iso8601"` // 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) 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) 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 *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` CreateBucketConfiguration *CreateBucketConfiguration `locationName:"CreateBucketConfiguration" type:"structure"` // 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) 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) 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 *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" timestampFormat:"rfc822"` // 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 *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"` // 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) 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" timestampFormat:"rfc822"` // 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) String ¶ added in v0.6.5
func (s CreateMultipartUploadOutput) String() string
String returns the string representation
type Delete ¶
type Delete struct { 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 }
type DeleteBucketCorsInput ¶ added in v0.9.5
type DeleteBucketCorsInput struct { 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) 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 DeleteBucketInput ¶
type DeleteBucketInput struct { 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) 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 DeleteBucketLifecycleInput ¶
type DeleteBucketLifecycleInput struct { 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) 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 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 *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) 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 { 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) 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 *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) 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 *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) 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" timestampFormat:"iso8601"` 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) String ¶ added in v0.6.5
func (s DeleteMarkerEntry) String() string
String returns the string representation
type DeleteObjectInput ¶
type DeleteObjectInput struct { Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` 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) 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) String ¶ added in v0.6.5
func (s DeleteObjectOutput) String() string
String returns the string representation
type DeleteObjectsInput ¶
type DeleteObjectsInput struct { Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` Delete *Delete `locationName:"Delete" type:"structure" 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"` // 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) 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) 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) String ¶ added in v0.6.5
func (s DeletedObject) String() string
String returns the string representation
type Destination ¶
type Destination struct { // Amazon resource name (ARN) of the bucket where you want Amazon S3 to store // replicas of the object identified by the rule. Bucket *string `type:"string" required:"true"` // The class of storage used to store the object. StorageClass *string `type:"string" enum:"StorageClass"` // contains filtered or unexported fields }
func (Destination) GoString ¶ added in v0.6.5
func (s Destination) GoString() string
GoString returns the string representation
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 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 }
type ErrorDocument ¶
type ErrorDocument struct { // The object key name to use when a 4XX class error occurs. 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) 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) 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 *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) 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) 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 *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) 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) String ¶ added in v0.9.5
func (s GetBucketAclOutput) String() string
String returns the string representation
type GetBucketCorsInput ¶ added in v0.9.5
type GetBucketCorsInput struct { 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) 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) String ¶ added in v0.9.5
func (s GetBucketCorsOutput) String() string
String returns the string representation
type GetBucketLifecycleConfigurationInput ¶ added in v0.9.8
type GetBucketLifecycleConfigurationInput struct { 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) 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) String ¶ added in v0.9.8
func (s GetBucketLifecycleConfigurationOutput) String() string
String returns the string representation
type GetBucketLifecycleInput ¶
type GetBucketLifecycleInput struct { 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) 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) String ¶ added in v0.6.5
func (s GetBucketLifecycleOutput) String() string
String returns the string representation
type GetBucketLocationInput ¶
type GetBucketLocationInput struct { 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) 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) String ¶ added in v0.6.5
func (s GetBucketLocationOutput) String() string
String returns the string representation
type GetBucketLoggingInput ¶
type GetBucketLoggingInput struct { 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) 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 { 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) String ¶ added in v0.6.5
func (s GetBucketLoggingOutput) String() string
String returns the string representation
type GetBucketNotificationConfigurationRequest ¶
type GetBucketNotificationConfigurationRequest struct { // Name of the bucket to get the notification configuration for. 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) 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 *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) 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) String ¶ added in v0.6.5
func (s GetBucketPolicyOutput) String() string
String returns the string representation
type GetBucketReplicationInput ¶
type GetBucketReplicationInput struct { 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) 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) String ¶ added in v0.6.5
func (s GetBucketReplicationOutput) String() string
String returns the string representation
type GetBucketRequestPaymentInput ¶
type GetBucketRequestPaymentInput struct { 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) 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) String ¶ added in v0.6.5
func (s GetBucketRequestPaymentOutput) String() string
String returns the string representation
type GetBucketTaggingInput ¶
type GetBucketTaggingInput struct { 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) 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 []*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) String ¶ added in v0.6.5
func (s GetBucketTaggingOutput) String() string
String returns the string representation
type GetBucketVersioningInput ¶
type GetBucketVersioningInput struct { 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) 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) String ¶ added in v0.6.5
func (s GetBucketVersioningOutput) String() string
String returns the string representation
type GetBucketWebsiteInput ¶
type GetBucketWebsiteInput struct { 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) 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) 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 *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` 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) 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) String ¶ added in v0.9.5
func (s GetObjectAclOutput) String() string
String returns the string representation
type GetObjectInput ¶
type GetObjectInput struct { 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" timestampFormat:"rfc822"` // 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" timestampFormat:"rfc822"` Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"` // 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" timestampFormat:"iso8601"` // 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) 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" timestampFormat:"rfc822"` // 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"` 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 (GetObjectOutput) GoString ¶ added in v0.6.5
func (s GetObjectOutput) GoString() string
GoString returns the string representation
func (GetObjectOutput) String ¶ added in v0.6.5
func (s GetObjectOutput) String() string
String returns the string representation
type GetObjectTorrentInput ¶
type GetObjectTorrentInput struct { Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` 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) 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) String ¶ added in v0.6.5
func (s GetObjectTorrentOutput) String() string
String returns the string representation
type Grant ¶
type Grant struct { Grantee *Grantee `type:"structure"` // Specifies the permission given to the grantee. Permission *string `type:"string" enum:"Permission"` // contains filtered or unexported fields }
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 *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 }
type HeadBucketInput ¶
type HeadBucketInput struct { 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) 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 *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" timestampFormat:"rfc822"` // 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" timestampFormat:"rfc822"` Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"` // 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) 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" timestampFormat:"rfc822"` // 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"` 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) 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 *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) 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 }
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.
type LambdaFunctionConfiguration ¶
type LambdaFunctionConfiguration struct { 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 *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) 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 []*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) 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) 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"` // 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. Prefix *string `type:"string" required:"true"` // If 'Enabled', the rule is currently being applied. If 'Disabled', the rule // is not currently being applied. 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) 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 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) String ¶ added in v0.6.5
func (s ListBucketsOutput) String() string
String returns the string representation
type ListMultipartUploadsInput ¶
type ListMultipartUploadsInput struct { 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) 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) String ¶ added in v0.6.5
func (s ListMultipartUploadsOutput) String() string
String returns the string representation
type ListObjectVersionsInput ¶
type ListObjectVersionsInput struct { 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) 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) String ¶ added in v0.6.5
func (s ListObjectVersionsOutput) String() string
String returns the string representation
type ListObjectsInput ¶
type ListObjectsInput struct { 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"` // 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) 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) 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 *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"` // 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) 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) String ¶ added in v1.1.24
func (s ListObjectsV2Output) String() string
String returns the string representation
type ListPartsInput ¶
type ListPartsInput struct { Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` 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 *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) 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" timestampFormat:"rfc822"` // 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) String ¶ added in v0.6.5
func (s ListPartsOutput) String() string
String returns the string representation
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 *string `type:"string"` 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 *string `type:"string"` // contains filtered or unexported fields }
func (LoggingEnabled) GoString ¶ added in v0.6.5
func (s LoggingEnabled) GoString() string
GoString returns the string representation
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 MultipartUpload ¶
type MultipartUpload struct { // Date and time at which the multipart upload was initiated. Initiated *time.Time `type:"timestamp" timestampFormat:"iso8601"` // 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) 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) 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 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 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) 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) 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) 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) 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" timestampFormat:"iso8601"` 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 }
type ObjectIdentifier ¶
type ObjectIdentifier struct { // Key name of the object to delete. 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) 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" timestampFormat:"iso8601"` 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) String ¶ added in v0.6.5
func (s ObjectVersion) 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 }
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" timestampFormat:"iso8601"` // 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 }
type PutBucketAccelerateConfigurationInput ¶ added in v1.1.19
type PutBucketAccelerateConfigurationInput struct { // Specifies the Accelerate Configuration you want to set for the bucket. AccelerateConfiguration *AccelerateConfiguration `locationName:"AccelerateConfiguration" type:"structure" required:"true"` // Name of the bucket for which the accelerate configuration is set. 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) 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"` 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) 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 PutBucketCorsInput ¶ added in v0.9.5
type PutBucketCorsInput struct { Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` CORSConfiguration *CORSConfiguration `locationName:"CORSConfiguration" type:"structure" required:"true"` // 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) 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 PutBucketLifecycleConfigurationInput ¶ added in v0.9.8
type PutBucketLifecycleConfigurationInput struct { Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` LifecycleConfiguration *BucketLifecycleConfiguration `locationName:"LifecycleConfiguration" type:"structure"` // 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) 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 *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` LifecycleConfiguration *LifecycleConfiguration `locationName:"LifecycleConfiguration" type:"structure"` // 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) 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 *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` BucketLoggingStatus *BucketLoggingStatus `locationName:"BucketLoggingStatus" type:"structure" required:"true"` // 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) 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 PutBucketNotificationConfigurationInput ¶
type PutBucketNotificationConfigurationInput struct { 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 *NotificationConfiguration `locationName:"NotificationConfiguration" type:"structure" required:"true"` // 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) 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 *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` NotificationConfiguration *NotificationConfigurationDeprecated `locationName:"NotificationConfiguration" type:"structure" required:"true"` // 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) 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 *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` // The bucket policy as a JSON document. 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) 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 *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 *ReplicationConfiguration `locationName:"ReplicationConfiguration" type:"structure" required:"true"` // 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) 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 *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` RequestPaymentConfiguration *RequestPaymentConfiguration `locationName:"RequestPaymentConfiguration" type:"structure" required:"true"` // 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) 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 *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` Tagging *Tagging `locationName:"Tagging" type:"structure" required:"true"` // 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) 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 *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 *VersioningConfiguration `locationName:"VersioningConfiguration" type:"structure" required:"true"` // 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) 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 *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` WebsiteConfiguration *WebsiteConfiguration `locationName:"WebsiteConfiguration" type:"structure" required:"true"` // 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) 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"` 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 *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) 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) 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 *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"` // 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" timestampFormat:"rfc822"` // 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 *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"` // 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) 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) String ¶ added in v0.6.5
func (s PutObjectOutput) String() string
String returns the string representation
type QueueConfiguration ¶
type QueueConfiguration struct { 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 *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) 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. 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) String ¶ added in v0.6.5
func (s QueueConfigurationDeprecated) String() string
String returns the string representation
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 }
type RedirectAllRequestsTo ¶
type RedirectAllRequestsTo struct { // Name of the host where requests will be redirected. 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) 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 *string `type:"string" required:"true"` // Container for information about a particular replication rule. Replication // configuration must have at least one rule and can contain up to 1,000 rules. 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) 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 { Destination *Destination `type:"structure" required:"true"` // 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. Overlapping prefixes // are not supported. Prefix *string `type:"string" required:"true"` // The rule is ignored if status is not Enabled. Status *string `type:"string" required:"true" enum:"ReplicationRuleStatus"` // contains filtered or unexported fields }
func (ReplicationRule) GoString ¶ added in v0.6.5
func (s ReplicationRule) GoString() string
GoString returns the string representation
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 RequestPaymentConfiguration ¶
type RequestPaymentConfiguration struct { // Specifies who pays for the download and request fees. 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) 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 RestoreObjectInput ¶
type RestoreObjectInput struct { Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"` 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"` RestoreRequest *RestoreRequest `locationName:"RestoreRequest" type:"structure"` 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) 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"` // 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) 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 Days *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
func (RestoreRequest) GoString ¶ added in v0.6.5
func (s RestoreRequest) GoString() string
GoString returns the string representation
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 *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) 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 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 // 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 *string `type:"string" required:"true"` // If 'Enabled', the rule is currently being applied. If 'Disabled', the rule // is not currently being applied. Status *string `type:"string" required:"true" enum:"ExpirationStatus"` Transition *Transition `type:"structure"` // contains filtered or unexported fields }
type S3 ¶
S3 is a client for Amazon S3. The service client's operations are safe to be used concurrently. It is not safe to mutate any of the client'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)
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.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.AbortMultipartUploadInput{ Bucket: aws.String("BucketName"), // Required Key: aws.String("ObjectKey"), // Required UploadId: aws.String("MultipartUploadId"), // Required RequestPayer: aws.String("RequestPayer"), } resp, err := svc.AbortMultipartUpload(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the AbortMultipartUpload method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) CompleteMultipartUpload ¶
func (c *S3) CompleteMultipartUpload(input *CompleteMultipartUploadInput) (*CompleteMultipartUploadOutput, error)
Completes a multipart upload by assembling previously uploaded parts.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.CompleteMultipartUploadInput{ Bucket: aws.String("BucketName"), // Required Key: aws.String("ObjectKey"), // Required UploadId: aws.String("MultipartUploadId"), // Required MultipartUpload: &s3.CompletedMultipartUpload{ Parts: []*s3.CompletedPart{ { // Required ETag: aws.String("ETag"), PartNumber: aws.Int64(1), }, // More values... }, }, RequestPayer: aws.String("RequestPayer"), } resp, err := svc.CompleteMultipartUpload(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CompleteMultipartUpload method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) CopyObject ¶
func (c *S3) CopyObject(input *CopyObjectInput) (*CopyObjectOutput, error)
Creates a copy of an object that is already stored in Amazon S3.
Example ¶
package main import ( "fmt" "time" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.CopyObjectInput{ Bucket: aws.String("BucketName"), // Required CopySource: aws.String("CopySource"), // Required Key: aws.String("ObjectKey"), // Required ACL: aws.String("ObjectCannedACL"), CacheControl: aws.String("CacheControl"), ContentDisposition: aws.String("ContentDisposition"), ContentEncoding: aws.String("ContentEncoding"), ContentLanguage: aws.String("ContentLanguage"), ContentType: aws.String("ContentType"), CopySourceIfMatch: aws.String("CopySourceIfMatch"), CopySourceIfModifiedSince: aws.Time(time.Now()), CopySourceIfNoneMatch: aws.String("CopySourceIfNoneMatch"), CopySourceIfUnmodifiedSince: aws.Time(time.Now()), CopySourceSSECustomerAlgorithm: aws.String("CopySourceSSECustomerAlgorithm"), CopySourceSSECustomerKey: aws.String("CopySourceSSECustomerKey"), CopySourceSSECustomerKeyMD5: aws.String("CopySourceSSECustomerKeyMD5"), Expires: aws.Time(time.Now()), GrantFullControl: aws.String("GrantFullControl"), GrantRead: aws.String("GrantRead"), GrantReadACP: aws.String("GrantReadACP"), GrantWriteACP: aws.String("GrantWriteACP"), Metadata: map[string]*string{ "Key": aws.String("MetadataValue"), // Required // More values... }, MetadataDirective: aws.String("MetadataDirective"), RequestPayer: aws.String("RequestPayer"), SSECustomerAlgorithm: aws.String("SSECustomerAlgorithm"), SSECustomerKey: aws.String("SSECustomerKey"), SSECustomerKeyMD5: aws.String("SSECustomerKeyMD5"), SSEKMSKeyId: aws.String("SSEKMSKeyId"), ServerSideEncryption: aws.String("ServerSideEncryption"), StorageClass: aws.String("StorageClass"), WebsiteRedirectLocation: aws.String("WebsiteRedirectLocation"), } resp, err := svc.CopyObject(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CopyObject method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) CreateBucket ¶
func (c *S3) CreateBucket(input *CreateBucketInput) (*CreateBucketOutput, error)
Creates a new bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.CreateBucketInput{ Bucket: aws.String("BucketName"), // Required ACL: aws.String("BucketCannedACL"), CreateBucketConfiguration: &s3.CreateBucketConfiguration{ LocationConstraint: aws.String("BucketLocationConstraint"), }, GrantFullControl: aws.String("GrantFullControl"), GrantRead: aws.String("GrantRead"), GrantReadACP: aws.String("GrantReadACP"), GrantWrite: aws.String("GrantWrite"), GrantWriteACP: aws.String("GrantWriteACP"), } resp, err := svc.CreateBucket(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateBucket method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) CreateMultipartUpload ¶
func (c *S3) CreateMultipartUpload(input *CreateMultipartUploadInput) (*CreateMultipartUploadOutput, error)
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.
Example ¶
package main import ( "fmt" "time" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.CreateMultipartUploadInput{ Bucket: aws.String("BucketName"), // Required Key: aws.String("ObjectKey"), // Required ACL: aws.String("ObjectCannedACL"), CacheControl: aws.String("CacheControl"), ContentDisposition: aws.String("ContentDisposition"), ContentEncoding: aws.String("ContentEncoding"), ContentLanguage: aws.String("ContentLanguage"), ContentType: aws.String("ContentType"), Expires: aws.Time(time.Now()), GrantFullControl: aws.String("GrantFullControl"), GrantRead: aws.String("GrantRead"), GrantReadACP: aws.String("GrantReadACP"), GrantWriteACP: aws.String("GrantWriteACP"), Metadata: map[string]*string{ "Key": aws.String("MetadataValue"), // Required // More values... }, RequestPayer: aws.String("RequestPayer"), SSECustomerAlgorithm: aws.String("SSECustomerAlgorithm"), SSECustomerKey: aws.String("SSECustomerKey"), SSECustomerKeyMD5: aws.String("SSECustomerKeyMD5"), SSEKMSKeyId: aws.String("SSEKMSKeyId"), ServerSideEncryption: aws.String("ServerSideEncryption"), StorageClass: aws.String("StorageClass"), WebsiteRedirectLocation: aws.String("WebsiteRedirectLocation"), } resp, err := svc.CreateMultipartUpload(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateMultipartUpload method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) DeleteBucket ¶
func (c *S3) DeleteBucket(input *DeleteBucketInput) (*DeleteBucketOutput, error)
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.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.DeleteBucketInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.DeleteBucket(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*S3) DeleteBucketCors ¶ added in v0.9.5
func (c *S3) DeleteBucketCors(input *DeleteBucketCorsInput) (*DeleteBucketCorsOutput, error)
Deletes the cors configuration information set for the bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.DeleteBucketCorsInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.DeleteBucketCors(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteBucketCors method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) DeleteBucketLifecycle ¶
func (c *S3) DeleteBucketLifecycle(input *DeleteBucketLifecycleInput) (*DeleteBucketLifecycleOutput, error)
Deletes the lifecycle configuration from the bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.DeleteBucketLifecycleInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.DeleteBucketLifecycle(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteBucketLifecycle method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) DeleteBucketPolicy ¶
func (c *S3) DeleteBucketPolicy(input *DeleteBucketPolicyInput) (*DeleteBucketPolicyOutput, error)
Deletes the policy from the bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.DeleteBucketPolicyInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.DeleteBucketPolicy(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteBucketPolicy method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) DeleteBucketReplication ¶
func (c *S3) DeleteBucketReplication(input *DeleteBucketReplicationInput) (*DeleteBucketReplicationOutput, error)
Deletes the replication configuration from the bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.DeleteBucketReplicationInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.DeleteBucketReplication(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteBucketReplication method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteBucket method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) DeleteBucketTagging ¶
func (c *S3) DeleteBucketTagging(input *DeleteBucketTaggingInput) (*DeleteBucketTaggingOutput, error)
Deletes the tags from the bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.DeleteBucketTaggingInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.DeleteBucketTagging(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteBucketTagging method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) DeleteBucketWebsite ¶
func (c *S3) DeleteBucketWebsite(input *DeleteBucketWebsiteInput) (*DeleteBucketWebsiteOutput, error)
This operation removes the website configuration from the bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.DeleteBucketWebsiteInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.DeleteBucketWebsite(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteBucketWebsite method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) DeleteObject ¶
func (c *S3) DeleteObject(input *DeleteObjectInput) (*DeleteObjectOutput, error)
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.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.DeleteObjectInput{ Bucket: aws.String("BucketName"), // Required Key: aws.String("ObjectKey"), // Required MFA: aws.String("MFA"), RequestPayer: aws.String("RequestPayer"), VersionId: aws.String("ObjectVersionId"), } resp, err := svc.DeleteObject(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteObject method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) DeleteObjects ¶
func (c *S3) DeleteObjects(input *DeleteObjectsInput) (*DeleteObjectsOutput, error)
This operation enables you to delete multiple objects from a bucket using a single HTTP request. You may specify up to 1000 keys.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.DeleteObjectsInput{ Bucket: aws.String("BucketName"), // Required Delete: &s3.Delete{ // Required Objects: []*s3.ObjectIdentifier{ // Required { // Required Key: aws.String("ObjectKey"), // Required VersionId: aws.String("ObjectVersionId"), }, // More values... }, Quiet: aws.Bool(true), }, MFA: aws.String("MFA"), RequestPayer: aws.String("RequestPayer"), } resp, err := svc.DeleteObjects(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteObjects method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetBucketAccelerateConfiguration ¶ added in v1.1.19
func (c *S3) GetBucketAccelerateConfiguration(input *GetBucketAccelerateConfigurationInput) (*GetBucketAccelerateConfigurationOutput, error)
Returns the accelerate configuration of a bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetBucketAccelerateConfigurationInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.GetBucketAccelerateConfiguration(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetBucketAccelerateConfiguration method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetBucketAcl ¶ added in v0.9.5
func (c *S3) GetBucketAcl(input *GetBucketAclInput) (*GetBucketAclOutput, error)
Gets the access control policy for the bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetBucketAclInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.GetBucketAcl(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetBucketAcl method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetBucketCors ¶ added in v0.9.5
func (c *S3) GetBucketCors(input *GetBucketCorsInput) (*GetBucketCorsOutput, error)
Returns the cors configuration for the bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetBucketCorsInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.GetBucketCors(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetBucketCors method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetBucketLifecycle ¶
func (c *S3) GetBucketLifecycle(input *GetBucketLifecycleInput) (*GetBucketLifecycleOutput, error)
Deprecated, see the GetBucketLifecycleConfiguration operation.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetBucketLifecycleInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.GetBucketLifecycle(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*S3) GetBucketLifecycleConfiguration ¶ added in v0.9.8
func (c *S3) GetBucketLifecycleConfiguration(input *GetBucketLifecycleConfigurationInput) (*GetBucketLifecycleConfigurationOutput, error)
Returns the lifecycle configuration information set on the bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetBucketLifecycleConfigurationInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.GetBucketLifecycleConfiguration(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetBucketLifecycleConfiguration method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetBucketLifecycleRequest ¶
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetBucketLifecycle method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetBucketLocation ¶
func (c *S3) GetBucketLocation(input *GetBucketLocationInput) (*GetBucketLocationOutput, error)
Returns the region the bucket resides in.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetBucketLocationInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.GetBucketLocation(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetBucketLocation method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetBucketLogging ¶
func (c *S3) GetBucketLogging(input *GetBucketLoggingInput) (*GetBucketLoggingOutput, error)
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.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetBucketLoggingInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.GetBucketLogging(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetBucketLogging method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetBucketNotification ¶
func (c *S3) GetBucketNotification(input *GetBucketNotificationConfigurationRequest) (*NotificationConfigurationDeprecated, error)
Deprecated, see the GetBucketNotificationConfiguration operation.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetBucketNotificationConfigurationRequest{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.GetBucketNotification(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*S3) GetBucketNotificationConfiguration ¶
func (c *S3) GetBucketNotificationConfiguration(input *GetBucketNotificationConfigurationRequest) (*NotificationConfiguration, error)
Returns the notification configuration of a bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetBucketNotificationConfigurationRequest{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.GetBucketNotificationConfiguration(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetBucketNotificationConfiguration method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetBucketNotificationRequest ¶
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetBucketNotification method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetBucketPolicy ¶
func (c *S3) GetBucketPolicy(input *GetBucketPolicyInput) (*GetBucketPolicyOutput, error)
Returns the policy of a specified bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetBucketPolicyInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.GetBucketPolicy(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetBucketPolicy method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetBucketReplication ¶
func (c *S3) GetBucketReplication(input *GetBucketReplicationInput) (*GetBucketReplicationOutput, error)
Returns the replication configuration of a bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetBucketReplicationInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.GetBucketReplication(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetBucketReplication method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetBucketRequestPayment ¶
func (c *S3) GetBucketRequestPayment(input *GetBucketRequestPaymentInput) (*GetBucketRequestPaymentOutput, error)
Returns the request payment configuration of a bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetBucketRequestPaymentInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.GetBucketRequestPayment(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetBucketRequestPayment method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetBucketTagging ¶
func (c *S3) GetBucketTagging(input *GetBucketTaggingInput) (*GetBucketTaggingOutput, error)
Returns the tag set associated with the bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetBucketTaggingInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.GetBucketTagging(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetBucketTagging method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetBucketVersioning ¶
func (c *S3) GetBucketVersioning(input *GetBucketVersioningInput) (*GetBucketVersioningOutput, error)
Returns the versioning state of a bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetBucketVersioningInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.GetBucketVersioning(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetBucketVersioning method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetBucketWebsite ¶
func (c *S3) GetBucketWebsite(input *GetBucketWebsiteInput) (*GetBucketWebsiteOutput, error)
Returns the website configuration for a bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetBucketWebsiteInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.GetBucketWebsite(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetBucketWebsite method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetObject ¶
func (c *S3) GetObject(input *GetObjectInput) (*GetObjectOutput, error)
Retrieves objects from Amazon S3.
Example ¶
package main import ( "fmt" "time" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetObjectInput{ Bucket: aws.String("BucketName"), // Required Key: aws.String("ObjectKey"), // Required IfMatch: aws.String("IfMatch"), IfModifiedSince: aws.Time(time.Now()), IfNoneMatch: aws.String("IfNoneMatch"), IfUnmodifiedSince: aws.Time(time.Now()), Range: aws.String("Range"), RequestPayer: aws.String("RequestPayer"), ResponseCacheControl: aws.String("ResponseCacheControl"), ResponseContentDisposition: aws.String("ResponseContentDisposition"), ResponseContentEncoding: aws.String("ResponseContentEncoding"), ResponseContentLanguage: aws.String("ResponseContentLanguage"), ResponseContentType: aws.String("ResponseContentType"), ResponseExpires: aws.Time(time.Now()), SSECustomerAlgorithm: aws.String("SSECustomerAlgorithm"), SSECustomerKey: aws.String("SSECustomerKey"), SSECustomerKeyMD5: aws.String("SSECustomerKeyMD5"), VersionId: aws.String("ObjectVersionId"), } resp, err := svc.GetObject(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*S3) GetObjectAcl ¶ added in v0.9.5
func (c *S3) GetObjectAcl(input *GetObjectAclInput) (*GetObjectAclOutput, error)
Returns the access control list (ACL) of an object.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetObjectAclInput{ Bucket: aws.String("BucketName"), // Required Key: aws.String("ObjectKey"), // Required RequestPayer: aws.String("RequestPayer"), VersionId: aws.String("ObjectVersionId"), } resp, err := svc.GetObjectAcl(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetObjectAcl method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetObject method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) GetObjectTorrent ¶
func (c *S3) GetObjectTorrent(input *GetObjectTorrentInput) (*GetObjectTorrentOutput, error)
Return torrent files from a bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.GetObjectTorrentInput{ Bucket: aws.String("BucketName"), // Required Key: aws.String("ObjectKey"), // Required RequestPayer: aws.String("RequestPayer"), } resp, err := svc.GetObjectTorrent(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetObjectTorrent method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) HeadBucket ¶
func (c *S3) HeadBucket(input *HeadBucketInput) (*HeadBucketOutput, error)
This operation is useful to determine if a bucket exists and you have permission to access it.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.HeadBucketInput{ Bucket: aws.String("BucketName"), // Required } resp, err := svc.HeadBucket(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the HeadBucket method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) HeadObject ¶
func (c *S3) HeadObject(input *HeadObjectInput) (*HeadObjectOutput, error)
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.
Example ¶
package main import ( "fmt" "time" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.HeadObjectInput{ Bucket: aws.String("BucketName"), // Required Key: aws.String("ObjectKey"), // Required IfMatch: aws.String("IfMatch"), IfModifiedSince: aws.Time(time.Now()), IfNoneMatch: aws.String("IfNoneMatch"), IfUnmodifiedSince: aws.Time(time.Now()), Range: aws.String("Range"), RequestPayer: aws.String("RequestPayer"), SSECustomerAlgorithm: aws.String("SSECustomerAlgorithm"), SSECustomerKey: aws.String("SSECustomerKey"), SSECustomerKeyMD5: aws.String("SSECustomerKeyMD5"), VersionId: aws.String("ObjectVersionId"), } resp, err := svc.HeadObject(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the HeadObject method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) ListBuckets ¶
func (c *S3) ListBuckets(input *ListBucketsInput) (*ListBucketsOutput, error)
Returns a list of all buckets owned by the authenticated sender of the request.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) var params *s3.ListBucketsInput resp, err := svc.ListBuckets(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ListBuckets method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) ListMultipartUploads ¶
func (c *S3) ListMultipartUploads(input *ListMultipartUploadsInput) (*ListMultipartUploadsOutput, error)
This operation lists in-progress multipart uploads.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.ListMultipartUploadsInput{ Bucket: aws.String("BucketName"), // Required Delimiter: aws.String("Delimiter"), EncodingType: aws.String("EncodingType"), KeyMarker: aws.String("KeyMarker"), MaxUploads: aws.Int64(1), Prefix: aws.String("Prefix"), UploadIdMarker: aws.String("UploadIdMarker"), } resp, err := svc.ListMultipartUploads(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*S3) ListMultipartUploadsPages ¶
func (c *S3) ListMultipartUploadsPages(input *ListMultipartUploadsInput, fn func(p *ListMultipartUploadsOutput, lastPage bool) (shouldContinue 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) 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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ListMultipartUploads method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) ListObjectVersions ¶
func (c *S3) ListObjectVersions(input *ListObjectVersionsInput) (*ListObjectVersionsOutput, error)
Returns metadata about all of the versions of objects in a bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.ListObjectVersionsInput{ Bucket: aws.String("BucketName"), // Required Delimiter: aws.String("Delimiter"), EncodingType: aws.String("EncodingType"), KeyMarker: aws.String("KeyMarker"), MaxKeys: aws.Int64(1), Prefix: aws.String("Prefix"), VersionIdMarker: aws.String("VersionIdMarker"), } resp, err := svc.ListObjectVersions(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*S3) ListObjectVersionsPages ¶
func (c *S3) ListObjectVersionsPages(input *ListObjectVersionsInput, fn func(p *ListObjectVersionsOutput, lastPage bool) (shouldContinue 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) 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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ListObjectVersions method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) ListObjects ¶
func (c *S3) ListObjects(input *ListObjectsInput) (*ListObjectsOutput, error)
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.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.ListObjectsInput{ Bucket: aws.String("BucketName"), // Required Delimiter: aws.String("Delimiter"), EncodingType: aws.String("EncodingType"), Marker: aws.String("Marker"), MaxKeys: aws.Int64(1), Prefix: aws.String("Prefix"), } resp, err := svc.ListObjects(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*S3) ListObjectsPages ¶
func (c *S3) ListObjectsPages(input *ListObjectsInput, fn func(p *ListObjectsOutput, lastPage bool) (shouldContinue 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) 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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ListObjects method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) ListObjectsV2 ¶ added in v1.1.24
func (c *S3) ListObjectsV2(input *ListObjectsV2Input) (*ListObjectsV2Output, error)
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.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.ListObjectsV2Input{ Bucket: aws.String("BucketName"), // Required ContinuationToken: aws.String("Token"), Delimiter: aws.String("Delimiter"), EncodingType: aws.String("EncodingType"), FetchOwner: aws.Bool(true), MaxKeys: aws.Int64(1), Prefix: aws.String("Prefix"), StartAfter: aws.String("StartAfter"), } resp, err := svc.ListObjectsV2(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*S3) ListObjectsV2Pages ¶ added in v1.1.34
func (c *S3) ListObjectsV2Pages(input *ListObjectsV2Input, fn func(p *ListObjectsV2Output, lastPage bool) (shouldContinue 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) 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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ListObjectsV2 method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) ListParts ¶
func (c *S3) ListParts(input *ListPartsInput) (*ListPartsOutput, error)
Lists the parts that have been uploaded for a specific multipart upload.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.ListPartsInput{ Bucket: aws.String("BucketName"), // Required Key: aws.String("ObjectKey"), // Required UploadId: aws.String("MultipartUploadId"), // Required MaxParts: aws.Int64(1), PartNumberMarker: aws.Int64(1), RequestPayer: aws.String("RequestPayer"), } resp, err := svc.ListParts(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*S3) ListPartsPages ¶
func (c *S3) ListPartsPages(input *ListPartsInput, fn func(p *ListPartsOutput, lastPage bool) (shouldContinue 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) 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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ListParts method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) PutBucketAccelerateConfiguration ¶ added in v1.1.19
func (c *S3) PutBucketAccelerateConfiguration(input *PutBucketAccelerateConfigurationInput) (*PutBucketAccelerateConfigurationOutput, error)
Sets the accelerate configuration of an existing bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutBucketAccelerateConfigurationInput{ AccelerateConfiguration: &s3.AccelerateConfiguration{ // Required Status: aws.String("BucketAccelerateStatus"), }, Bucket: aws.String("BucketName"), // Required } resp, err := svc.PutBucketAccelerateConfiguration(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutBucketAccelerateConfiguration method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) PutBucketAcl ¶ added in v0.9.5
func (c *S3) PutBucketAcl(input *PutBucketAclInput) (*PutBucketAclOutput, error)
Sets the permissions on a bucket using access control lists (ACL).
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutBucketAclInput{ Bucket: aws.String("BucketName"), // Required ACL: aws.String("BucketCannedACL"), AccessControlPolicy: &s3.AccessControlPolicy{ Grants: []*s3.Grant{ { // Required Grantee: &s3.Grantee{ Type: aws.String("Type"), // Required DisplayName: aws.String("DisplayName"), EmailAddress: aws.String("EmailAddress"), ID: aws.String("ID"), URI: aws.String("URI"), }, Permission: aws.String("Permission"), }, // More values... }, Owner: &s3.Owner{ DisplayName: aws.String("DisplayName"), ID: aws.String("ID"), }, }, GrantFullControl: aws.String("GrantFullControl"), GrantRead: aws.String("GrantRead"), GrantReadACP: aws.String("GrantReadACP"), GrantWrite: aws.String("GrantWrite"), GrantWriteACP: aws.String("GrantWriteACP"), } resp, err := svc.PutBucketAcl(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutBucketAcl method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) PutBucketCors ¶ added in v0.9.5
func (c *S3) PutBucketCors(input *PutBucketCorsInput) (*PutBucketCorsOutput, error)
Sets the cors configuration for a bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutBucketCorsInput{ Bucket: aws.String("BucketName"), // Required CORSConfiguration: &s3.CORSConfiguration{ // Required CORSRules: []*s3.CORSRule{ // Required { // Required AllowedMethods: []*string{ // Required aws.String("AllowedMethod"), // Required // More values... }, AllowedOrigins: []*string{ // Required aws.String("AllowedOrigin"), // Required // More values... }, AllowedHeaders: []*string{ aws.String("AllowedHeader"), // Required // More values... }, ExposeHeaders: []*string{ aws.String("ExposeHeader"), // Required // More values... }, MaxAgeSeconds: aws.Int64(1), }, // More values... }, }, } resp, err := svc.PutBucketCors(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutBucketCors method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) PutBucketLifecycle ¶
func (c *S3) PutBucketLifecycle(input *PutBucketLifecycleInput) (*PutBucketLifecycleOutput, error)
Deprecated, see the PutBucketLifecycleConfiguration operation.
Example ¶
package main import ( "fmt" "time" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutBucketLifecycleInput{ Bucket: aws.String("BucketName"), // Required LifecycleConfiguration: &s3.LifecycleConfiguration{ Rules: []*s3.Rule{ // Required { // Required Prefix: aws.String("Prefix"), // Required Status: aws.String("ExpirationStatus"), // Required AbortIncompleteMultipartUpload: &s3.AbortIncompleteMultipartUpload{ DaysAfterInitiation: aws.Int64(1), }, Expiration: &s3.LifecycleExpiration{ Date: aws.Time(time.Now()), Days: aws.Int64(1), ExpiredObjectDeleteMarker: aws.Bool(true), }, ID: aws.String("ID"), NoncurrentVersionExpiration: &s3.NoncurrentVersionExpiration{ NoncurrentDays: aws.Int64(1), }, NoncurrentVersionTransition: &s3.NoncurrentVersionTransition{ NoncurrentDays: aws.Int64(1), StorageClass: aws.String("TransitionStorageClass"), }, Transition: &s3.Transition{ Date: aws.Time(time.Now()), Days: aws.Int64(1), StorageClass: aws.String("TransitionStorageClass"), }, }, // More values... }, }, } resp, err := svc.PutBucketLifecycle(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*S3) PutBucketLifecycleConfiguration ¶ added in v0.9.8
func (c *S3) PutBucketLifecycleConfiguration(input *PutBucketLifecycleConfigurationInput) (*PutBucketLifecycleConfigurationOutput, error)
Sets lifecycle configuration for your bucket. If a lifecycle configuration exists, it replaces it.
Example ¶
package main import ( "fmt" "time" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutBucketLifecycleConfigurationInput{ Bucket: aws.String("BucketName"), // Required LifecycleConfiguration: &s3.BucketLifecycleConfiguration{ Rules: []*s3.LifecycleRule{ // Required { // Required Prefix: aws.String("Prefix"), // Required Status: aws.String("ExpirationStatus"), // Required AbortIncompleteMultipartUpload: &s3.AbortIncompleteMultipartUpload{ DaysAfterInitiation: aws.Int64(1), }, Expiration: &s3.LifecycleExpiration{ Date: aws.Time(time.Now()), Days: aws.Int64(1), ExpiredObjectDeleteMarker: aws.Bool(true), }, ID: aws.String("ID"), NoncurrentVersionExpiration: &s3.NoncurrentVersionExpiration{ NoncurrentDays: aws.Int64(1), }, NoncurrentVersionTransitions: []*s3.NoncurrentVersionTransition{ { // Required NoncurrentDays: aws.Int64(1), StorageClass: aws.String("TransitionStorageClass"), }, // More values... }, Transitions: []*s3.Transition{ { // Required Date: aws.Time(time.Now()), Days: aws.Int64(1), StorageClass: aws.String("TransitionStorageClass"), }, // More values... }, }, // More values... }, }, } resp, err := svc.PutBucketLifecycleConfiguration(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutBucketLifecycleConfiguration method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) PutBucketLifecycleRequest ¶
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutBucketLifecycle method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) PutBucketLogging ¶
func (c *S3) PutBucketLogging(input *PutBucketLoggingInput) (*PutBucketLoggingOutput, error)
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.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutBucketLoggingInput{ Bucket: aws.String("BucketName"), // Required BucketLoggingStatus: &s3.BucketLoggingStatus{ // Required LoggingEnabled: &s3.LoggingEnabled{ TargetBucket: aws.String("TargetBucket"), TargetGrants: []*s3.TargetGrant{ { // Required Grantee: &s3.Grantee{ Type: aws.String("Type"), // Required DisplayName: aws.String("DisplayName"), EmailAddress: aws.String("EmailAddress"), ID: aws.String("ID"), URI: aws.String("URI"), }, Permission: aws.String("BucketLogsPermission"), }, // More values... }, TargetPrefix: aws.String("TargetPrefix"), }, }, } resp, err := svc.PutBucketLogging(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutBucketLogging method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) PutBucketNotification ¶
func (c *S3) PutBucketNotification(input *PutBucketNotificationInput) (*PutBucketNotificationOutput, error)
Deprecated, see the PutBucketNotificationConfiguraiton operation.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutBucketNotificationInput{ Bucket: aws.String("BucketName"), // Required NotificationConfiguration: &s3.NotificationConfigurationDeprecated{ // Required CloudFunctionConfiguration: &s3.CloudFunctionConfiguration{ CloudFunction: aws.String("CloudFunction"), Event: aws.String("Event"), Events: []*string{ aws.String("Event"), // Required // More values... }, Id: aws.String("NotificationId"), InvocationRole: aws.String("CloudFunctionInvocationRole"), }, QueueConfiguration: &s3.QueueConfigurationDeprecated{ Event: aws.String("Event"), Events: []*string{ aws.String("Event"), // Required // More values... }, Id: aws.String("NotificationId"), Queue: aws.String("QueueArn"), }, TopicConfiguration: &s3.TopicConfigurationDeprecated{ Event: aws.String("Event"), Events: []*string{ aws.String("Event"), // Required // More values... }, Id: aws.String("NotificationId"), Topic: aws.String("TopicArn"), }, }, } resp, err := svc.PutBucketNotification(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*S3) PutBucketNotificationConfiguration ¶
func (c *S3) PutBucketNotificationConfiguration(input *PutBucketNotificationConfigurationInput) (*PutBucketNotificationConfigurationOutput, error)
Enables notifications of specified events for a bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutBucketNotificationConfigurationInput{ Bucket: aws.String("BucketName"), // Required NotificationConfiguration: &s3.NotificationConfiguration{ // Required LambdaFunctionConfigurations: []*s3.LambdaFunctionConfiguration{ { // Required Events: []*string{ // Required aws.String("Event"), // Required // More values... }, LambdaFunctionArn: aws.String("LambdaFunctionArn"), // Required Filter: &s3.NotificationConfigurationFilter{ Key: &s3.KeyFilter{ FilterRules: []*s3.FilterRule{ { // Required Name: aws.String("FilterRuleName"), Value: aws.String("FilterRuleValue"), }, // More values... }, }, }, Id: aws.String("NotificationId"), }, // More values... }, QueueConfigurations: []*s3.QueueConfiguration{ { // Required Events: []*string{ // Required aws.String("Event"), // Required // More values... }, QueueArn: aws.String("QueueArn"), // Required Filter: &s3.NotificationConfigurationFilter{ Key: &s3.KeyFilter{ FilterRules: []*s3.FilterRule{ { // Required Name: aws.String("FilterRuleName"), Value: aws.String("FilterRuleValue"), }, // More values... }, }, }, Id: aws.String("NotificationId"), }, // More values... }, TopicConfigurations: []*s3.TopicConfiguration{ { // Required Events: []*string{ // Required aws.String("Event"), // Required // More values... }, TopicArn: aws.String("TopicArn"), // Required Filter: &s3.NotificationConfigurationFilter{ Key: &s3.KeyFilter{ FilterRules: []*s3.FilterRule{ { // Required Name: aws.String("FilterRuleName"), Value: aws.String("FilterRuleValue"), }, // More values... }, }, }, Id: aws.String("NotificationId"), }, // More values... }, }, } resp, err := svc.PutBucketNotificationConfiguration(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutBucketNotificationConfiguration method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) PutBucketNotificationRequest ¶
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutBucketNotification method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) PutBucketPolicy ¶
func (c *S3) PutBucketPolicy(input *PutBucketPolicyInput) (*PutBucketPolicyOutput, error)
Replaces a policy on a bucket. If the bucket already has a policy, the one in this request completely replaces it.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutBucketPolicyInput{ Bucket: aws.String("BucketName"), // Required Policy: aws.String("Policy"), // Required } resp, err := svc.PutBucketPolicy(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutBucketPolicy method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) PutBucketReplication ¶
func (c *S3) PutBucketReplication(input *PutBucketReplicationInput) (*PutBucketReplicationOutput, error)
Creates a new replication configuration (or replaces an existing one, if present).
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutBucketReplicationInput{ Bucket: aws.String("BucketName"), // Required ReplicationConfiguration: &s3.ReplicationConfiguration{ // Required Role: aws.String("Role"), // Required Rules: []*s3.ReplicationRule{ // Required { // Required Destination: &s3.Destination{ // Required Bucket: aws.String("BucketName"), // Required StorageClass: aws.String("StorageClass"), }, Prefix: aws.String("Prefix"), // Required Status: aws.String("ReplicationRuleStatus"), // Required ID: aws.String("ID"), }, // More values... }, }, } resp, err := svc.PutBucketReplication(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutBucketReplication method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) PutBucketRequestPayment ¶
func (c *S3) PutBucketRequestPayment(input *PutBucketRequestPaymentInput) (*PutBucketRequestPaymentOutput, error)
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
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutBucketRequestPaymentInput{ Bucket: aws.String("BucketName"), // Required RequestPaymentConfiguration: &s3.RequestPaymentConfiguration{ // Required Payer: aws.String("Payer"), // Required }, } resp, err := svc.PutBucketRequestPayment(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutBucketRequestPayment method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) PutBucketTagging ¶
func (c *S3) PutBucketTagging(input *PutBucketTaggingInput) (*PutBucketTaggingOutput, error)
Sets the tags for a bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutBucketTaggingInput{ Bucket: aws.String("BucketName"), // Required Tagging: &s3.Tagging{ // Required TagSet: []*s3.Tag{ // Required { // Required Key: aws.String("ObjectKey"), // Required Value: aws.String("Value"), // Required }, // More values... }, }, } resp, err := svc.PutBucketTagging(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutBucketTagging method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) PutBucketVersioning ¶
func (c *S3) PutBucketVersioning(input *PutBucketVersioningInput) (*PutBucketVersioningOutput, error)
Sets the versioning state of an existing bucket. To set the versioning state, you must be the bucket owner.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutBucketVersioningInput{ Bucket: aws.String("BucketName"), // Required VersioningConfiguration: &s3.VersioningConfiguration{ // Required MFADelete: aws.String("MFADelete"), Status: aws.String("BucketVersioningStatus"), }, MFA: aws.String("MFA"), } resp, err := svc.PutBucketVersioning(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutBucketVersioning method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) PutBucketWebsite ¶
func (c *S3) PutBucketWebsite(input *PutBucketWebsiteInput) (*PutBucketWebsiteOutput, error)
Set the website configuration for a bucket.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutBucketWebsiteInput{ Bucket: aws.String("BucketName"), // Required WebsiteConfiguration: &s3.WebsiteConfiguration{ // Required ErrorDocument: &s3.ErrorDocument{ Key: aws.String("ObjectKey"), // Required }, IndexDocument: &s3.IndexDocument{ Suffix: aws.String("Suffix"), // Required }, RedirectAllRequestsTo: &s3.RedirectAllRequestsTo{ HostName: aws.String("HostName"), // Required Protocol: aws.String("Protocol"), }, RoutingRules: []*s3.RoutingRule{ { // Required Redirect: &s3.Redirect{ // Required HostName: aws.String("HostName"), HttpRedirectCode: aws.String("HttpRedirectCode"), Protocol: aws.String("Protocol"), ReplaceKeyPrefixWith: aws.String("ReplaceKeyPrefixWith"), ReplaceKeyWith: aws.String("ReplaceKeyWith"), }, Condition: &s3.Condition{ HttpErrorCodeReturnedEquals: aws.String("HttpErrorCodeReturnedEquals"), KeyPrefixEquals: aws.String("KeyPrefixEquals"), }, }, // More values... }, }, } resp, err := svc.PutBucketWebsite(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutBucketWebsite method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) PutObject ¶
func (c *S3) PutObject(input *PutObjectInput) (*PutObjectOutput, error)
Adds an object to a bucket.
Example ¶
package main import ( "bytes" "fmt" "time" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutObjectInput{ Bucket: aws.String("BucketName"), // Required Key: aws.String("ObjectKey"), // Required ACL: aws.String("ObjectCannedACL"), Body: bytes.NewReader([]byte("PAYLOAD")), CacheControl: aws.String("CacheControl"), ContentDisposition: aws.String("ContentDisposition"), ContentEncoding: aws.String("ContentEncoding"), ContentLanguage: aws.String("ContentLanguage"), ContentLength: aws.Int64(1), ContentType: aws.String("ContentType"), Expires: aws.Time(time.Now()), GrantFullControl: aws.String("GrantFullControl"), GrantRead: aws.String("GrantRead"), GrantReadACP: aws.String("GrantReadACP"), GrantWriteACP: aws.String("GrantWriteACP"), Metadata: map[string]*string{ "Key": aws.String("MetadataValue"), // Required // More values... }, RequestPayer: aws.String("RequestPayer"), SSECustomerAlgorithm: aws.String("SSECustomerAlgorithm"), SSECustomerKey: aws.String("SSECustomerKey"), SSECustomerKeyMD5: aws.String("SSECustomerKeyMD5"), SSEKMSKeyId: aws.String("SSEKMSKeyId"), ServerSideEncryption: aws.String("ServerSideEncryption"), StorageClass: aws.String("StorageClass"), WebsiteRedirectLocation: aws.String("WebsiteRedirectLocation"), } resp, err := svc.PutObject(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*S3) PutObjectAcl ¶ added in v0.9.5
func (c *S3) PutObjectAcl(input *PutObjectAclInput) (*PutObjectAclOutput, error)
uses the acl subresource to set the access control list (ACL) permissions for an object that already exists in a bucket
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.PutObjectAclInput{ Bucket: aws.String("BucketName"), // Required Key: aws.String("ObjectKey"), // Required ACL: aws.String("ObjectCannedACL"), AccessControlPolicy: &s3.AccessControlPolicy{ Grants: []*s3.Grant{ { // Required Grantee: &s3.Grantee{ Type: aws.String("Type"), // Required DisplayName: aws.String("DisplayName"), EmailAddress: aws.String("EmailAddress"), ID: aws.String("ID"), URI: aws.String("URI"), }, Permission: aws.String("Permission"), }, // More values... }, Owner: &s3.Owner{ DisplayName: aws.String("DisplayName"), ID: aws.String("ID"), }, }, GrantFullControl: aws.String("GrantFullControl"), GrantRead: aws.String("GrantRead"), GrantReadACP: aws.String("GrantReadACP"), GrantWrite: aws.String("GrantWrite"), GrantWriteACP: aws.String("GrantWriteACP"), RequestPayer: aws.String("RequestPayer"), VersionId: aws.String("ObjectVersionId"), } resp, err := svc.PutObjectAcl(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutObjectAcl method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutObject method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) RestoreObject ¶
func (c *S3) RestoreObject(input *RestoreObjectInput) (*RestoreObjectOutput, error)
Restores an archived copy of an object back into Amazon S3
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.RestoreObjectInput{ Bucket: aws.String("BucketName"), // Required Key: aws.String("ObjectKey"), // Required RequestPayer: aws.String("RequestPayer"), RestoreRequest: &s3.RestoreRequest{ Days: aws.Int64(1), // Required }, VersionId: aws.String("ObjectVersionId"), } resp, err := svc.RestoreObject(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the RestoreObject method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) UploadPart ¶
func (c *S3) UploadPart(input *UploadPartInput) (*UploadPartOutput, error)
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.
Example ¶
package main import ( "bytes" "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.UploadPartInput{ Bucket: aws.String("BucketName"), // Required Key: aws.String("ObjectKey"), // Required PartNumber: aws.Int64(1), // Required UploadId: aws.String("MultipartUploadId"), // Required Body: bytes.NewReader([]byte("PAYLOAD")), ContentLength: aws.Int64(1), RequestPayer: aws.String("RequestPayer"), SSECustomerAlgorithm: aws.String("SSECustomerAlgorithm"), SSECustomerKey: aws.String("SSECustomerKey"), SSECustomerKeyMD5: aws.String("SSECustomerKeyMD5"), } resp, err := svc.UploadPart(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*S3) UploadPartCopy ¶
func (c *S3) UploadPartCopy(input *UploadPartCopyInput) (*UploadPartCopyOutput, error)
Uploads a part by copying data from an existing object as data source.
Example ¶
package main import ( "fmt" "time" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := s3.New(sess) params := &s3.UploadPartCopyInput{ Bucket: aws.String("BucketName"), // Required CopySource: aws.String("CopySource"), // Required Key: aws.String("ObjectKey"), // Required PartNumber: aws.Int64(1), // Required UploadId: aws.String("MultipartUploadId"), // Required CopySourceIfMatch: aws.String("CopySourceIfMatch"), CopySourceIfModifiedSince: aws.Time(time.Now()), CopySourceIfNoneMatch: aws.String("CopySourceIfNoneMatch"), CopySourceIfUnmodifiedSince: aws.Time(time.Now()), CopySourceRange: aws.String("CopySourceRange"), CopySourceSSECustomerAlgorithm: aws.String("CopySourceSSECustomerAlgorithm"), CopySourceSSECustomerKey: aws.String("CopySourceSSECustomerKey"), CopySourceSSECustomerKeyMD5: aws.String("CopySourceSSECustomerKeyMD5"), RequestPayer: aws.String("RequestPayer"), SSECustomerAlgorithm: aws.String("SSECustomerAlgorithm"), SSECustomerKey: aws.String("SSECustomerKey"), SSECustomerKeyMD5: aws.String("SSECustomerKeyMD5"), } resp, err := svc.UploadPartCopy(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the UploadPartCopy method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
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 can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the UploadPart method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// 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) }
func (*S3) WaitUntilBucketExists ¶ added in v0.10.3
func (c *S3) WaitUntilBucketExists(input *HeadBucketInput) error
func (*S3) WaitUntilBucketNotExists ¶ added in v0.10.3
func (c *S3) WaitUntilBucketNotExists(input *HeadBucketInput) error
func (*S3) WaitUntilObjectExists ¶ added in v0.10.3
func (c *S3) WaitUntilObjectExists(input *HeadObjectInput) error
func (*S3) WaitUntilObjectNotExists ¶ added in v0.10.3
func (c *S3) WaitUntilObjectNotExists(input *HeadObjectInput) error
type Tag ¶
type Tag struct { // Name of the tag. Key *string `min:"1" type:"string" required:"true"` // Value of the tag. Value *string `type:"string" required:"true"` // contains filtered or unexported fields }
type Tagging ¶
type Tagging struct { TagSet []*Tag `locationNameList:"Tag" type:"list" required:"true"` // contains filtered or unexported fields }
type TargetGrant ¶
type TargetGrant struct { Grantee *Grantee `type:"structure"` // 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) 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 []*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 *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) 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. 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) 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) String ¶ added in v0.6.5
func (s Transition) String() string
String returns the string representation
type UploadPartCopyInput ¶
type UploadPartCopyInput struct { 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 *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" timestampFormat:"rfc822"` // 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" timestampFormat:"rfc822"` // 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 *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 *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 *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) 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) 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 *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"` // Object key for which the multipart upload was initiated. 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 *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 *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) 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) 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) 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) 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 ¶
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 for the Amazon Simple Storage Service.
|
Package s3iface provides an interface for the Amazon Simple Storage Service. |
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 |