Amazonka.S3.GetBucketLifecycleConfiguration

Bucket lifecycle configuration now supports specifying a lifecycle rule using an object key name prefix, one or more object tags, or a combination of both. Accordingly, this section describes the latest API. The response describes the new filter element that you can use to specify a filter to select a subset of objects to which the rule applies. If you are using a previous version of the lifecycle configuration, it still works. For the earlier action, see GetBucketLifecycle.

Returns the lifecycle configuration information set on the bucket. For information about lifecycle configuration, see Object Lifecycle Management.

To use this operation, you must have permission to perform the s3:GetLifecycleConfiguration action. The bucket owner has this permission, by default. The bucket owner can grant this permission to others. For more information about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 Resources.

GetBucketLifecycleConfiguration has the following special error:

• Error code: NoSuchLifecycleConfiguration

  • Description: The lifecycle configuration does not exist.
  • HTTP Status Code: 404 Not Found
  • SOAP Fault Code Prefix: Client

The following operations are related to GetBucketLifecycleConfiguration:

• GetBucketLifecycle
• PutBucketLifecycle
• DeleteBucketLifecycle

Creating a Request

data GetBucketLifecycleConfiguration

See: newGetBucketLifecycleConfiguration smart constructor.

Constructors

GetBucketLifecycleConfiguration'

Fields

• expectedBucketOwner :: Maybe Text

  The account ID of the expected bucket owner. If the bucket is owned by a different account, the request fails with the HTTP status code 403 Forbidden (access denied).

• bucket :: BucketName

  The name of the bucket for which to get the lifecycle information.

Instances

ToHeaders GetBucketLifecycleConfiguration

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

Methods

toHeaders :: GetBucketLifecycleConfiguration -> [Header]

ToPath GetBucketLifecycleConfiguration

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

Methods

toPath :: GetBucketLifecycleConfiguration -> ByteString

ToQuery GetBucketLifecycleConfiguration

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

Methods

toQuery :: GetBucketLifecycleConfiguration -> QueryString

AWSRequest GetBucketLifecycleConfiguration

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

Associated Types

type AWSResponse GetBucketLifecycleConfiguration

Methods

request :: (Service -> Service) -> GetBucketLifecycleConfiguration -> Request GetBucketLifecycleConfiguration

response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy GetBucketLifecycleConfiguration -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse GetBucketLifecycleConfiguration)))

Generic GetBucketLifecycleConfiguration

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

Associated Types

type Rep GetBucketLifecycleConfiguration :: Type -> Type

Methods

from :: GetBucketLifecycleConfiguration -> Rep GetBucketLifecycleConfiguration x

to :: Rep GetBucketLifecycleConfiguration x -> GetBucketLifecycleConfiguration

Read GetBucketLifecycleConfiguration

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

Methods

readsPrec :: Int -> ReadS GetBucketLifecycleConfiguration

readList :: ReadS [GetBucketLifecycleConfiguration]

readPrec :: ReadPrec GetBucketLifecycleConfiguration

readListPrec :: ReadPrec [GetBucketLifecycleConfiguration]

Show GetBucketLifecycleConfiguration

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

Methods

showsPrec :: Int -> GetBucketLifecycleConfiguration -> ShowS

show :: GetBucketLifecycleConfiguration -> String

showList :: [GetBucketLifecycleConfiguration] -> ShowS

NFData GetBucketLifecycleConfiguration

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

Methods

rnf :: GetBucketLifecycleConfiguration -> ()

Eq GetBucketLifecycleConfiguration

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

Methods

(==) :: GetBucketLifecycleConfiguration -> GetBucketLifecycleConfiguration -> Bool

(/=) :: GetBucketLifecycleConfiguration -> GetBucketLifecycleConfiguration -> Bool

Hashable GetBucketLifecycleConfiguration

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

Methods

hashWithSalt :: Int -> GetBucketLifecycleConfiguration -> Int

hash :: GetBucketLifecycleConfiguration -> Int

type AWSResponse GetBucketLifecycleConfiguration

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

type AWSResponse GetBucketLifecycleConfiguration = GetBucketLifecycleConfigurationResponse

type Rep GetBucketLifecycleConfiguration

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

type Rep GetBucketLifecycleConfiguration = D1 ('MetaData "GetBucketLifecycleConfiguration" "Amazonka.S3.GetBucketLifecycleConfiguration" "amazonka-s3-2.0-CNZtv1UmVzj28JXsFvwNoj" 'False) (C1 ('MetaCons "GetBucketLifecycleConfiguration'" 'PrefixI 'True) (S1 ('MetaSel ('Just "expectedBucketOwner") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "bucket") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 BucketName)))

newGetBucketLifecycleConfiguration

Arguments

:: BucketName

GetBucketLifecycleConfiguration

-> GetBucketLifecycleConfiguration

Create a value of GetBucketLifecycleConfiguration with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:expectedBucketOwner:GetBucketLifecycleConfiguration', getBucketLifecycleConfiguration_expectedBucketOwner - The account ID of the expected bucket owner. If the bucket is owned by a different account, the request fails with the HTTP status code 403 Forbidden (access denied).

GetBucketLifecycleConfiguration, getBucketLifecycleConfiguration_bucket - The name of the bucket for which to get the lifecycle information.

Request Lenses

getBucketLifecycleConfiguration_expectedBucketOwner :: Lens' GetBucketLifecycleConfiguration (Maybe Text)

The account ID of the expected bucket owner. If the bucket is owned by a different account, the request fails with the HTTP status code 403 Forbidden (access denied).

getBucketLifecycleConfiguration_bucket :: Lens' GetBucketLifecycleConfiguration BucketName

The name of the bucket for which to get the lifecycle information.

Destructuring the Response

data GetBucketLifecycleConfigurationResponse

See: newGetBucketLifecycleConfigurationResponse smart constructor.

Constructors

GetBucketLifecycleConfigurationResponse'

Fields

• rules :: Maybe [LifecycleRule]

  Container for a lifecycle rule.

• httpStatus :: Int

  The response's http status code.

Instances

Generic GetBucketLifecycleConfigurationResponse

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

Associated Types

type Rep GetBucketLifecycleConfigurationResponse :: Type -> Type

Methods

from :: GetBucketLifecycleConfigurationResponse -> Rep GetBucketLifecycleConfigurationResponse x

to :: Rep GetBucketLifecycleConfigurationResponse x -> GetBucketLifecycleConfigurationResponse

Read GetBucketLifecycleConfigurationResponse

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

Methods

readsPrec :: Int -> ReadS GetBucketLifecycleConfigurationResponse

readList :: ReadS [GetBucketLifecycleConfigurationResponse]

readPrec :: ReadPrec GetBucketLifecycleConfigurationResponse

readListPrec :: ReadPrec [GetBucketLifecycleConfigurationResponse]

Show GetBucketLifecycleConfigurationResponse

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

Methods

showsPrec :: Int -> GetBucketLifecycleConfigurationResponse -> ShowS

show :: GetBucketLifecycleConfigurationResponse -> String

showList :: [GetBucketLifecycleConfigurationResponse] -> ShowS

NFData GetBucketLifecycleConfigurationResponse

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

Methods

rnf :: GetBucketLifecycleConfigurationResponse -> ()

Eq GetBucketLifecycleConfigurationResponse

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

Methods

(==) :: GetBucketLifecycleConfigurationResponse -> GetBucketLifecycleConfigurationResponse -> Bool

(/=) :: GetBucketLifecycleConfigurationResponse -> GetBucketLifecycleConfigurationResponse -> Bool

type Rep GetBucketLifecycleConfigurationResponse

Defined in Amazonka.S3.GetBucketLifecycleConfiguration

type Rep GetBucketLifecycleConfigurationResponse = D1 ('MetaData "GetBucketLifecycleConfigurationResponse" "Amazonka.S3.GetBucketLifecycleConfiguration" "amazonka-s3-2.0-CNZtv1UmVzj28JXsFvwNoj" 'False) (C1 ('MetaCons "GetBucketLifecycleConfigurationResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "rules") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [LifecycleRule])) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newGetBucketLifecycleConfigurationResponse

Arguments

:: Int

$sel:httpStatus:GetBucketLifecycleConfigurationResponse'

-> GetBucketLifecycleConfigurationResponse

Create a value of GetBucketLifecycleConfigurationResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

GetBucketLifecycleConfigurationResponse, getBucketLifecycleConfigurationResponse_rules - Container for a lifecycle rule.

$sel:httpStatus:GetBucketLifecycleConfigurationResponse', getBucketLifecycleConfigurationResponse_httpStatus - The response's http status code.

Response Lenses

getBucketLifecycleConfigurationResponse_rules :: Lens' GetBucketLifecycleConfigurationResponse (Maybe [LifecycleRule])

Container for a lifecycle rule.

getBucketLifecycleConfigurationResponse_httpStatus :: Lens' GetBucketLifecycleConfigurationResponse Int

The response's http status code.