Struct: s3.ExtendObjectRetentionInput

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

Implemented Interfaces

s3crypto.Cipher, s3manager.ReadSeekerWriteTo, request.Validator, s3manager.WriterReadFrom

Structure Field Summary collapse

AdditionalRetentionPeriod *int64

Additional time, in seconds, to add to the existing retention period for the object.
Bucket *string

Bucket is a required field.
ExtendRetentionFromCurrentTime *int64

Retention Period in seconds for the object.
Key *string

Key is a required field.
NewRetentionExpirationDate *time.Time
NewRetentionPeriod *int64
_ struct{}

Service Operations collapse

GoString() string operation

GoString returns the string representation.
SetAdditionalRetentionPeriod(int64) *ExtendObjectRetentionInput operation

SetAdditionalRetentionPeriod sets the AdditionalRetentionPeriod field’s value.
SetBucket(string) *ExtendObjectRetentionInput operation

SetBucket sets the Bucket field’s value.
SetExtendRetentionFromCurrentTime(int64) *ExtendObjectRetentionInput operation

SetExtendRetentionFromCurrentTime sets the ExtendRetentionFromCurrentTime field’s value.
SetKey(string) *ExtendObjectRetentionInput operation

SetKey sets the Key field’s value.
SetNewRetentionExpirationDate(time.Time) *ExtendObjectRetentionInput operation

SetNewRetentionExpirationDate sets the NewRetentionExpirationDate field’s value.
SetNewRetentionPeriod(int64) *ExtendObjectRetentionInput operation

SetNewRetentionPeriod sets the NewRetentionPeriod field’s value.
String() string operation

String returns the string representation.
Validate() error operation

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

Structure Field Details

AdditionalRetentionPeriod *int64 `location:"header" locationName:"Additional-Retention-Period" type:"integer"`

Additional time, in seconds, to add to the existing retention period for the object. If this field and New-Retention-Time and/or New-Retention-Expiration-Date are specified, a 400 error will be returned. If none of the Request Headers are specified, a 400 error will be returned to the user. The retention period of an object may be extended up to bucket maximum retention period from the time of the request.

Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`

Bucket is a required field

ExtendRetentionFromCurrentTime *int64 `location:"header" locationName:"Extend-Retention-From-Current-Time" type:"integer"`

Retention Period in seconds for the object. The Retention will be enforced from the current time until current time + the value in this header. This value has to be within the ranges defined for the bucket.

Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`

Key is a required field

NewRetentionExpirationDate *time.Time `location:"header" locationName:"New-Retention-Expiration-Date" type:"timestamp" timestampFormat:"iso8601"`

NewRetentionPeriod *int64 `location:"header" locationName:"New-Retention-Period" type:"integer"`

_ struct{} `locationName:"ExtendObjectRetentionRequest" type:"structure"`

Method Details

func (s ExtendObjectRetentionInput) GoString() string

GoString returns the string representation.

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



11990
11991
11992

// File 'service/s3/api.go', line 11990

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

func (s ExtendObjectRetentionInput) SetAdditionalRetentionPeriod(v int64) ExtendObjectRetentionInput

SetAdditionalRetentionPeriod sets the AdditionalRetentionPeriod field’s value.

// File 'service/s3/api.go', line 12017

func (s *ExtendObjectRetentionInput) SetAdditionalRetentionPeriod(v int64) *ExtendObjectRetentionInput {
	s.AdditionalRetentionPeriod = &v
	return s
}

func (s ExtendObjectRetentionInput) SetBucket(v string) ExtendObjectRetentionInput

SetBucket sets the Bucket field’s value.

// File 'service/s3/api.go', line 12023

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

func (s ExtendObjectRetentionInput) SetExtendRetentionFromCurrentTime(v int64) ExtendObjectRetentionInput

SetExtendRetentionFromCurrentTime sets the ExtendRetentionFromCurrentTime field’s value.

// File 'service/s3/api.go', line 12036

func (s *ExtendObjectRetentionInput) SetExtendRetentionFromCurrentTime(v int64) *ExtendObjectRetentionInput {
	s.ExtendRetentionFromCurrentTime = &v
	return s
}

func (s ExtendObjectRetentionInput) SetKey(v string) ExtendObjectRetentionInput

SetKey sets the Key field’s value.

// File 'service/s3/api.go', line 12042

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

func (s ExtendObjectRetentionInput) SetNewRetentionExpirationDate(v time.Time) ExtendObjectRetentionInput

SetNewRetentionExpirationDate sets the NewRetentionExpirationDate field’s value.

// File 'service/s3/api.go', line 12048

func (s *ExtendObjectRetentionInput) SetNewRetentionExpirationDate(v time.Time) *ExtendObjectRetentionInput {
	s.NewRetentionExpirationDate = &v
	return s
}

func (s ExtendObjectRetentionInput) SetNewRetentionPeriod(v int64) ExtendObjectRetentionInput

SetNewRetentionPeriod sets the NewRetentionPeriod field’s value.

// File 'service/s3/api.go', line 12054

func (s *ExtendObjectRetentionInput) SetNewRetentionPeriod(v int64) *ExtendObjectRetentionInput {
	s.NewRetentionPeriod = &v
	return s
}

func (s ExtendObjectRetentionInput) String() string

String returns the string representation.

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



11981
11982
11983

// File 'service/s3/api.go', line 11981

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

func (s *ExtendObjectRetentionInput) Validate() error

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

// File 'service/s3/api.go', line 11995

func (s *ExtendObjectRetentionInput) Validate() error {
	invalidParams := request.ErrInvalidParams{Context: "ExtendObjectRetentionInput"}
	if s.Bucket == nil {
		invalidParams.Add(request.NewErrParamRequired("Bucket"))
	}
	if s.Bucket != nil && len(*s.Bucket) < 1 {
		invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
	}
	if s.Key == nil {
		invalidParams.Add(request.NewErrParamRequired("Key"))
	}
	if s.Key != nil && len(*s.Key) < 1 {
		invalidParams.Add(request.NewErrParamMinLen("Key", 1))
	}

	if invalidParams.Len() > 0 {
		return invalidParams
	}
	return nil
}