Network.AWS.S3.ListObjectVersions

Returns metadata about all of the versions of objects in a bucket.

This operation returns paginated results.

Creating a Request

listObjectVersions

Arguments

:: BucketName

lovBucket

-> ListObjectVersions

Creates a value of ListObjectVersions with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• lovKeyMarker - Specifies the key to start with when listing objects in a bucket.
• lovPrefix - Limits the response to keys that begin with the specified prefix.
• lovEncodingType - Undocumented member.
• lovVersionIdMarker - Specifies the object version you want to start listing from.
• lovMaxKeys - Sets the maximum number of keys returned in the response. The response might contain fewer keys but will never contain more.
• lovDelimiter - A delimiter is a character you use to group keys.
• lovBucket - Undocumented member.

data ListObjectVersions

See: listObjectVersions smart constructor.

Instances

Eq ListObjectVersions

Methods

(==) :: ListObjectVersions -> ListObjectVersions -> Bool

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

Data ListObjectVersions

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> ListObjectVersions -> c ListObjectVersions

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c ListObjectVersions

toConstr :: ListObjectVersions -> Constr

dataTypeOf :: ListObjectVersions -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c ListObjectVersions)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c ListObjectVersions)

gmapT :: (forall b. Data b => b -> b) -> ListObjectVersions -> ListObjectVersions

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> ListObjectVersions -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> ListObjectVersions -> r

gmapQ :: (forall d. Data d => d -> u) -> ListObjectVersions -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> ListObjectVersions -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> ListObjectVersions -> m ListObjectVersions

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> ListObjectVersions -> m ListObjectVersions

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> ListObjectVersions -> m ListObjectVersions

Read ListObjectVersions

Methods

readsPrec :: Int -> ReadS ListObjectVersions

readList :: ReadS [ListObjectVersions]

readPrec :: ReadPrec ListObjectVersions

readListPrec :: ReadPrec [ListObjectVersions]

Show ListObjectVersions

Methods

showsPrec :: Int -> ListObjectVersions -> ShowS

show :: ListObjectVersions -> String

showList :: [ListObjectVersions] -> ShowS

Generic ListObjectVersions

Associated Types

type Rep ListObjectVersions :: * -> *

Methods

from :: ListObjectVersions -> Rep ListObjectVersions x

to :: Rep ListObjectVersions x -> ListObjectVersions

Hashable ListObjectVersions

Methods

hashWithSalt :: Int -> ListObjectVersions -> Int

hash :: ListObjectVersions -> Int

NFData ListObjectVersions

Methods

rnf :: ListObjectVersions -> ()

AWSPager ListObjectVersions

Methods

page :: ListObjectVersions -> Rs ListObjectVersions -> Maybe ListObjectVersions

AWSRequest ListObjectVersions

Associated Types

type Rs ListObjectVersions :: *

Methods

request :: ListObjectVersions -> Request ListObjectVersions

response :: MonadResource m => Logger -> Service -> Proxy * ListObjectVersions -> ClientResponse -> m (Response ListObjectVersions)

ToQuery ListObjectVersions

Methods

toQuery :: ListObjectVersions -> QueryString

ToPath ListObjectVersions

Methods

toPath :: ListObjectVersions -> ByteString

ToHeaders ListObjectVersions

Methods

toHeaders :: ListObjectVersions -> [Header]

type Rep ListObjectVersions

type Rep ListObjectVersions = D1 (MetaData "ListObjectVersions" "Network.AWS.S3.ListObjectVersions" "amazonka-s3-1.5.0-4i2REsRgyXL98WvgynC9is" False) (C1 (MetaCons "ListObjectVersions'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_lovKeyMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_lovPrefix") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_lovEncodingType") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe EncodingType))))) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_lovVersionIdMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_lovMaxKeys") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int)))) ((:*:) (S1 (MetaSel (Just Symbol "_lovDelimiter") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Delimiter))) (S1 (MetaSel (Just Symbol "_lovBucket") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 BucketName))))))

type Rs ListObjectVersions

type Rs ListObjectVersions = ListObjectVersionsResponse

Request Lenses

lovKeyMarker :: Lens' ListObjectVersions (Maybe Text)

Specifies the key to start with when listing objects in a bucket.

lovPrefix :: Lens' ListObjectVersions (Maybe Text)

Limits the response to keys that begin with the specified prefix.

lovEncodingType :: Lens' ListObjectVersions (Maybe EncodingType)

Undocumented member.

lovVersionIdMarker :: Lens' ListObjectVersions (Maybe Text)

Specifies the object version you want to start listing from.

lovMaxKeys :: Lens' ListObjectVersions (Maybe Int)

Sets the maximum number of keys returned in the response. The response might contain fewer keys but will never contain more.

lovDelimiter :: Lens' ListObjectVersions (Maybe Delimiter)

A delimiter is a character you use to group keys.

lovBucket :: Lens' ListObjectVersions BucketName

Undocumented member.

Destructuring the Response

listObjectVersionsResponse

Arguments

:: Int

lovrsResponseStatus

-> ListObjectVersionsResponse

Creates a value of ListObjectVersionsResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• lovrsNextVersionIdMarker - Use this value for the next version id marker parameter in a subsequent request.
• lovrsKeyMarker - Marks the last Key returned in a truncated response.
• lovrsDeleteMarkers - Undocumented member.
• lovrsPrefix - Undocumented member.
• lovrsCommonPrefixes - Undocumented member.
• lovrsEncodingType - Encoding type used by Amazon S3 to encode object keys in the response.
• lovrsVersions - Undocumented member.
• lovrsName - Undocumented member.
• lovrsNextKeyMarker - Use this value for the key marker request parameter in a subsequent request.
• lovrsVersionIdMarker - Undocumented member.
• lovrsMaxKeys - Undocumented member.
• lovrsIsTruncated - 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.
• lovrsDelimiter - Undocumented member.
• lovrsResponseStatus - -- | The response status code.

data ListObjectVersionsResponse

See: listObjectVersionsResponse smart constructor.

Instances

Eq ListObjectVersionsResponse

Methods

(==) :: ListObjectVersionsResponse -> ListObjectVersionsResponse -> Bool

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

Data ListObjectVersionsResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> ListObjectVersionsResponse -> c ListObjectVersionsResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c ListObjectVersionsResponse

toConstr :: ListObjectVersionsResponse -> Constr

dataTypeOf :: ListObjectVersionsResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c ListObjectVersionsResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c ListObjectVersionsResponse)

gmapT :: (forall b. Data b => b -> b) -> ListObjectVersionsResponse -> ListObjectVersionsResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> ListObjectVersionsResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> ListObjectVersionsResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> ListObjectVersionsResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> ListObjectVersionsResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> ListObjectVersionsResponse -> m ListObjectVersionsResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> ListObjectVersionsResponse -> m ListObjectVersionsResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> ListObjectVersionsResponse -> m ListObjectVersionsResponse

Read ListObjectVersionsResponse

Methods

readsPrec :: Int -> ReadS ListObjectVersionsResponse

readList :: ReadS [ListObjectVersionsResponse]

readPrec :: ReadPrec ListObjectVersionsResponse

readListPrec :: ReadPrec [ListObjectVersionsResponse]

Show ListObjectVersionsResponse

Methods

showsPrec :: Int -> ListObjectVersionsResponse -> ShowS

show :: ListObjectVersionsResponse -> String

showList :: [ListObjectVersionsResponse] -> ShowS

Generic ListObjectVersionsResponse

Associated Types

type Rep ListObjectVersionsResponse :: * -> *

Methods

from :: ListObjectVersionsResponse -> Rep ListObjectVersionsResponse x

to :: Rep ListObjectVersionsResponse x -> ListObjectVersionsResponse

NFData ListObjectVersionsResponse

Methods

rnf :: ListObjectVersionsResponse -> ()

type Rep ListObjectVersionsResponse

type Rep ListObjectVersionsResponse = D1 (MetaData "ListObjectVersionsResponse" "Network.AWS.S3.ListObjectVersions" "amazonka-s3-1.5.0-4i2REsRgyXL98WvgynC9is" False) (C1 (MetaCons "ListObjectVersionsResponse'" PrefixI True) ((:*:) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_lovrsNextVersionIdMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_lovrsKeyMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_lovrsDeleteMarkers") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [DeleteMarkerEntry]))))) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_lovrsPrefix") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_lovrsCommonPrefixes") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [CommonPrefix])))) ((:*:) (S1 (MetaSel (Just Symbol "_lovrsEncodingType") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe EncodingType))) (S1 (MetaSel (Just Symbol "_lovrsVersions") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [ObjectVersion])))))) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_lovrsName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe BucketName))) ((:*:) (S1 (MetaSel (Just Symbol "_lovrsNextKeyMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_lovrsVersionIdMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))))) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_lovrsMaxKeys") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int))) (S1 (MetaSel (Just Symbol "_lovrsIsTruncated") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool)))) ((:*:) (S1 (MetaSel (Just Symbol "_lovrsDelimiter") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Delimiter))) (S1 (MetaSel (Just Symbol "_lovrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))))))

Response Lenses

lovrsNextVersionIdMarker :: Lens' ListObjectVersionsResponse (Maybe Text)

Use this value for the next version id marker parameter in a subsequent request.

lovrsKeyMarker :: Lens' ListObjectVersionsResponse (Maybe Text)

Marks the last Key returned in a truncated response.

lovrsDeleteMarkers :: Lens' ListObjectVersionsResponse [DeleteMarkerEntry]

Undocumented member.

lovrsPrefix :: Lens' ListObjectVersionsResponse (Maybe Text)

Undocumented member.

lovrsCommonPrefixes :: Lens' ListObjectVersionsResponse [CommonPrefix]

Undocumented member.

lovrsEncodingType :: Lens' ListObjectVersionsResponse (Maybe EncodingType)

Encoding type used by Amazon S3 to encode object keys in the response.

lovrsVersions :: Lens' ListObjectVersionsResponse [ObjectVersion]

Undocumented member.

lovrsName :: Lens' ListObjectVersionsResponse (Maybe BucketName)

Undocumented member.

lovrsNextKeyMarker :: Lens' ListObjectVersionsResponse (Maybe Text)

Use this value for the key marker request parameter in a subsequent request.

lovrsVersionIdMarker :: Lens' ListObjectVersionsResponse (Maybe Text)

Undocumented member.

lovrsMaxKeys :: Lens' ListObjectVersionsResponse (Maybe Int)

Undocumented member.

lovrsIsTruncated :: Lens' ListObjectVersionsResponse (Maybe Bool)

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.

lovrsDelimiter :: Lens' ListObjectVersionsResponse (Maybe Delimiter)

Undocumented member.

lovrsResponseStatus :: Lens' ListObjectVersionsResponse Int

• - | The response status code.