Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.S3.GetObjectRetention

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Retrieves an object's retention settings. For more information, see Locking Objects.

This action is not supported by Amazon S3 on Outposts.

Synopsis

data GetObjectRetention = GetObjectRetention' {
- versionId :: Maybe ObjectVersionId
- requestPayer :: Maybe RequestPayer
- expectedBucketOwner :: Maybe Text
- bucket :: BucketName
- key :: ObjectKey
}
newGetObjectRetention :: BucketName -> ObjectKey -> GetObjectRetention
getObjectRetention_versionId :: Lens' GetObjectRetention (Maybe ObjectVersionId)
getObjectRetention_requestPayer :: Lens' GetObjectRetention (Maybe RequestPayer)
getObjectRetention_expectedBucketOwner :: Lens' GetObjectRetention (Maybe Text)
getObjectRetention_bucket :: Lens' GetObjectRetention BucketName
getObjectRetention_key :: Lens' GetObjectRetention ObjectKey
data GetObjectRetentionResponse = GetObjectRetentionResponse' {
- retention :: Maybe ObjectLockRetention
- httpStatus :: Int
}
newGetObjectRetentionResponse :: Int -> GetObjectRetentionResponse
getObjectRetentionResponse_retention :: Lens' GetObjectRetentionResponse (Maybe ObjectLockRetention)
getObjectRetentionResponse_httpStatus :: Lens' GetObjectRetentionResponse Int

Creating a Request

data GetObjectRetention Source #

See: newGetObjectRetention smart constructor.

Constructors

GetObjectRetention'

Fields

versionId :: Maybe ObjectVersionId
The version ID for the object whose retention settings you want to retrieve.
requestPayer :: Maybe RequestPayer
expectedBucketOwner :: Maybe Text
The account ID of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.
bucket :: BucketName
The bucket name containing the object whose retention settings you want to retrieve.
When using this action with an access point, you must direct requests to the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see Using access points in the Amazon S3 User Guide.
key :: ObjectKey
The key name for the object whose retention settings you want to retrieve.

Instances

Instances details

Eq GetObjectRetention Source #
Instance details Defined in Amazonka.S3.GetObjectRetention Methods (==) :: GetObjectRetention -> GetObjectRetention -> Bool # (/=) :: GetObjectRetention -> GetObjectRetention -> Bool #
Read GetObjectRetention Source #
Instance details Defined in Amazonka.S3.GetObjectRetention Methods readsPrec :: Int -> ReadS GetObjectRetention # readList :: ReadS [GetObjectRetention] # readPrec :: ReadPrec GetObjectRetention # readListPrec :: ReadPrec [GetObjectRetention] #
Show GetObjectRetention Source #
Instance details Defined in Amazonka.S3.GetObjectRetention Methods showsPrec :: Int -> GetObjectRetention -> ShowS # show :: GetObjectRetention -> String # showList :: [GetObjectRetention] -> ShowS #
Generic GetObjectRetention Source #
Instance details Defined in Amazonka.S3.GetObjectRetention Associated Types type Rep GetObjectRetention :: Type -> Type # Methods from :: GetObjectRetention -> Rep GetObjectRetention x # to :: Rep GetObjectRetention x -> GetObjectRetention #
NFData GetObjectRetention Source #
Instance details Defined in Amazonka.S3.GetObjectRetention Methods rnf :: GetObjectRetention -> () #
Hashable GetObjectRetention Source #
Instance details Defined in Amazonka.S3.GetObjectRetention Methods hashWithSalt :: Int -> GetObjectRetention -> Int # hash :: GetObjectRetention -> Int #
AWSRequest GetObjectRetention Source #
Instance details Defined in Amazonka.S3.GetObjectRetention Associated Types type AWSResponse GetObjectRetention # Methods request :: GetObjectRetention -> Request GetObjectRetention # response :: MonadResource m => Logger -> Service -> Proxy GetObjectRetention -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse GetObjectRetention))) #
ToHeaders GetObjectRetention Source #
Instance details Defined in Amazonka.S3.GetObjectRetention Methods toHeaders :: GetObjectRetention -> [Header] #
ToPath GetObjectRetention Source #
Instance details Defined in Amazonka.S3.GetObjectRetention Methods toPath :: GetObjectRetention -> ByteString #
ToQuery GetObjectRetention Source #
Instance details Defined in Amazonka.S3.GetObjectRetention Methods toQuery :: GetObjectRetention -> QueryString #
type Rep GetObjectRetention Source #
Instance details Defined in Amazonka.S3.GetObjectRetention type Rep GetObjectRetention = D1 ('MetaData "GetObjectRetention" "Amazonka.S3.GetObjectRetention" "libZSservicesZSamazonka-s3ZSamazonka-s3" 'False) (C1 ('MetaCons "GetObjectRetention'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "versionId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ObjectVersionId)) :: S1 ('MetaSel ('Just "requestPayer") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe RequestPayer))) :: (S1 ('MetaSel ('Just "expectedBucketOwner") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "bucket") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 BucketName) :: S1 ('MetaSel ('Just "key") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 ObjectKey)))))
type AWSResponse GetObjectRetention Source #
Instance details Defined in Amazonka.S3.GetObjectRetention type AWSResponse GetObjectRetention = GetObjectRetentionResponse

newGetObjectRetention Source #

Arguments

:: BucketName	`$sel:bucket:GetObjectRetention'`
-> ObjectKey	`$sel:key:GetObjectRetention'`
-> GetObjectRetention

Create a value of GetObjectRetention 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:versionId:GetObjectRetention', getObjectRetention_versionId - The version ID for the object whose retention settings you want to retrieve.

$sel:requestPayer:GetObjectRetention', getObjectRetention_requestPayer - Undocumented member.

$sel:expectedBucketOwner:GetObjectRetention', getObjectRetention_expectedBucketOwner - The account ID of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.

$sel:bucket:GetObjectRetention', getObjectRetention_bucket - The bucket name containing the object whose retention settings you want to retrieve.

When using this action with an access point, you must direct requests to the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see Using access points in the Amazon S3 User Guide.

$sel:key:GetObjectRetention', getObjectRetention_key - The key name for the object whose retention settings you want to retrieve.

Request Lenses

getObjectRetention_versionId :: Lens' GetObjectRetention (Maybe ObjectVersionId) Source #

The version ID for the object whose retention settings you want to retrieve.

getObjectRetention_requestPayer :: Lens' GetObjectRetention (Maybe RequestPayer) Source #

Undocumented member.

getObjectRetention_expectedBucketOwner :: Lens' GetObjectRetention (Maybe Text) Source #

The account ID of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.

getObjectRetention_bucket :: Lens' GetObjectRetention BucketName Source #

The bucket name containing the object whose retention settings you want to retrieve.

When using this action with an access point, you must direct requests to the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see Using access points in the Amazon S3 User Guide.

getObjectRetention_key :: Lens' GetObjectRetention ObjectKey Source #

The key name for the object whose retention settings you want to retrieve.

Destructuring the Response

data GetObjectRetentionResponse Source #

See: newGetObjectRetentionResponse smart constructor.

Constructors

GetObjectRetentionResponse'
Fields retention :: Maybe ObjectLockRetention The container element for an object's retention settings. httpStatus :: Int The response's http status code.

Instances

Instances details

Eq GetObjectRetentionResponse Source #
Instance details Defined in Amazonka.S3.GetObjectRetention Methods (==) :: GetObjectRetentionResponse -> GetObjectRetentionResponse -> Bool # (/=) :: GetObjectRetentionResponse -> GetObjectRetentionResponse -> Bool #
Read GetObjectRetentionResponse Source #
Instance details Defined in Amazonka.S3.GetObjectRetention Methods readsPrec :: Int -> ReadS GetObjectRetentionResponse # readList :: ReadS [GetObjectRetentionResponse] # readPrec :: ReadPrec GetObjectRetentionResponse # readListPrec :: ReadPrec [GetObjectRetentionResponse] #
Show GetObjectRetentionResponse Source #
Instance details Defined in Amazonka.S3.GetObjectRetention Methods showsPrec :: Int -> GetObjectRetentionResponse -> ShowS # show :: GetObjectRetentionResponse -> String # showList :: [GetObjectRetentionResponse] -> ShowS #
Generic GetObjectRetentionResponse Source #
Instance details Defined in Amazonka.S3.GetObjectRetention Associated Types type Rep GetObjectRetentionResponse :: Type -> Type # Methods from :: GetObjectRetentionResponse -> Rep GetObjectRetentionResponse x # to :: Rep GetObjectRetentionResponse x -> GetObjectRetentionResponse #
NFData GetObjectRetentionResponse Source #
Instance details Defined in Amazonka.S3.GetObjectRetention Methods rnf :: GetObjectRetentionResponse -> () #
type Rep GetObjectRetentionResponse Source #
Instance details Defined in Amazonka.S3.GetObjectRetention type Rep GetObjectRetentionResponse = D1 ('MetaData "GetObjectRetentionResponse" "Amazonka.S3.GetObjectRetention" "libZSservicesZSamazonka-s3ZSamazonka-s3" 'False) (C1 ('MetaCons "GetObjectRetentionResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "retention") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ObjectLockRetention)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newGetObjectRetentionResponse Source #

Arguments

:: Int	`$sel:httpStatus:GetObjectRetentionResponse'`
-> GetObjectRetentionResponse

Create a value of GetObjectRetentionResponse 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:retention:GetObjectRetentionResponse', getObjectRetentionResponse_retention - The container element for an object's retention settings.

$sel:httpStatus:GetObjectRetentionResponse', getObjectRetentionResponse_httpStatus - The response's http status code.

Response Lenses

getObjectRetentionResponse_retention :: Lens' GetObjectRetentionResponse (Maybe ObjectLockRetention) Source #

The container element for an object's retention settings.

getObjectRetentionResponse_httpStatus :: Lens' GetObjectRetentionResponse Int Source #

The response's http status code.