{-# LANGUAGE DeriveDataTypeable #-} {-# LANGUAGE DeriveGeneric #-} {-# LANGUAGE OverloadedStrings #-} {-# LANGUAGE RecordWildCards #-} {-# LANGUAGE TypeFamilies #-} {-# OPTIONS_GHC -fno-warn-unused-imports #-} {-# OPTIONS_GHC -fno-warn-unused-binds #-} {-# OPTIONS_GHC -fno-warn-unused-matches #-} -- Derived from AWS service descriptions, licensed under Apache 2.0. -- | -- Module : Network.AWS.CloudHSMv2.DescribeBackups -- Copyright : (c) 2013-2018 Brendan Hay -- License : Mozilla Public License, v. 2.0. -- Maintainer : Brendan Hay -- Stability : auto-generated -- Portability : non-portable (GHC extensions) -- -- Gets information about backups of AWS CloudHSM clusters. -- -- -- This is a paginated operation, which means that each response might contain only a subset of all the backups. When the response contains only a subset of backups, it includes a @NextToken@ value. Use this value in a subsequent @DescribeBackups@ request to get more backups. When you receive a response with no @NextToken@ (or an empty or null value), that means there are no more backups to get. -- -- -- This operation returns paginated results. module Network.AWS.CloudHSMv2.DescribeBackups ( -- * Creating a Request describeBackups , DescribeBackups -- * Request Lenses , dbFilters , dbNextToken , dbMaxResults -- * Destructuring the Response , describeBackupsResponse , DescribeBackupsResponse -- * Response Lenses , dbrsBackups , dbrsNextToken , dbrsResponseStatus ) where import Network.AWS.CloudHSMv2.Types import Network.AWS.CloudHSMv2.Types.Product import Network.AWS.Lens import Network.AWS.Pager import Network.AWS.Prelude import Network.AWS.Request import Network.AWS.Response -- | /See:/ 'describeBackups' smart constructor. data DescribeBackups = DescribeBackups' { _dbFilters :: !(Maybe (Map Text [Text])) , _dbNextToken :: !(Maybe Text) , _dbMaxResults :: !(Maybe Nat) } deriving (Eq, Read, Show, Data, Typeable, Generic) -- | Creates a value of 'DescribeBackups' with the minimum fields required to make a request. -- -- Use one of the following lenses to modify other fields as desired: -- -- * 'dbFilters' - One or more filters to limit the items returned in the response. Use the @backupIds@ filter to return only the specified backups. Specify backups by their backup identifier (ID). Use the @clusterIds@ filter to return only the backups for the specified clusters. Specify clusters by their cluster identifier (ID). Use the @states@ filter to return only backups that match the specified state. -- -- * 'dbNextToken' - The @NextToken@ value that you received in the previous response. Use this value to get more backups. -- -- * 'dbMaxResults' - The maximum number of backups to return in the response. When there are more backups than the number you specify, the response contains a @NextToken@ value. describeBackups :: DescribeBackups describeBackups = DescribeBackups' {_dbFilters = Nothing, _dbNextToken = Nothing, _dbMaxResults = Nothing} -- | One or more filters to limit the items returned in the response. Use the @backupIds@ filter to return only the specified backups. Specify backups by their backup identifier (ID). Use the @clusterIds@ filter to return only the backups for the specified clusters. Specify clusters by their cluster identifier (ID). Use the @states@ filter to return only backups that match the specified state. dbFilters :: Lens' DescribeBackups (HashMap Text [Text]) dbFilters = lens _dbFilters (\ s a -> s{_dbFilters = a}) . _Default . _Map -- | The @NextToken@ value that you received in the previous response. Use this value to get more backups. dbNextToken :: Lens' DescribeBackups (Maybe Text) dbNextToken = lens _dbNextToken (\ s a -> s{_dbNextToken = a}) -- | The maximum number of backups to return in the response. When there are more backups than the number you specify, the response contains a @NextToken@ value. dbMaxResults :: Lens' DescribeBackups (Maybe Natural) dbMaxResults = lens _dbMaxResults (\ s a -> s{_dbMaxResults = a}) . mapping _Nat instance AWSPager DescribeBackups where page rq rs | stop (rs ^. dbrsNextToken) = Nothing | stop (rs ^. dbrsBackups) = Nothing | otherwise = Just $ rq & dbNextToken .~ rs ^. dbrsNextToken instance AWSRequest DescribeBackups where type Rs DescribeBackups = DescribeBackupsResponse request = postJSON cloudHSMv2 response = receiveJSON (\ s h x -> DescribeBackupsResponse' <$> (x .?> "Backups" .!@ mempty) <*> (x .?> "NextToken") <*> (pure (fromEnum s))) instance Hashable DescribeBackups where instance NFData DescribeBackups where instance ToHeaders DescribeBackups where toHeaders = const (mconcat ["X-Amz-Target" =# ("BaldrApiService.DescribeBackups" :: ByteString), "Content-Type" =# ("application/x-amz-json-1.1" :: ByteString)]) instance ToJSON DescribeBackups where toJSON DescribeBackups'{..} = object (catMaybes [("Filters" .=) <$> _dbFilters, ("NextToken" .=) <$> _dbNextToken, ("MaxResults" .=) <$> _dbMaxResults]) instance ToPath DescribeBackups where toPath = const "/" instance ToQuery DescribeBackups where toQuery = const mempty -- | /See:/ 'describeBackupsResponse' smart constructor. data DescribeBackupsResponse = DescribeBackupsResponse' { _dbrsBackups :: !(Maybe [Backup]) , _dbrsNextToken :: !(Maybe Text) , _dbrsResponseStatus :: !Int } deriving (Eq, Read, Show, Data, Typeable, Generic) -- | Creates a value of 'DescribeBackupsResponse' with the minimum fields required to make a request. -- -- Use one of the following lenses to modify other fields as desired: -- -- * 'dbrsBackups' - A list of backups. -- -- * 'dbrsNextToken' - An opaque string that indicates that the response contains only a subset of backups. Use this value in a subsequent @DescribeBackups@ request to get more backups. -- -- * 'dbrsResponseStatus' - -- | The response status code. describeBackupsResponse :: Int -- ^ 'dbrsResponseStatus' -> DescribeBackupsResponse describeBackupsResponse pResponseStatus_ = DescribeBackupsResponse' { _dbrsBackups = Nothing , _dbrsNextToken = Nothing , _dbrsResponseStatus = pResponseStatus_ } -- | A list of backups. dbrsBackups :: Lens' DescribeBackupsResponse [Backup] dbrsBackups = lens _dbrsBackups (\ s a -> s{_dbrsBackups = a}) . _Default . _Coerce -- | An opaque string that indicates that the response contains only a subset of backups. Use this value in a subsequent @DescribeBackups@ request to get more backups. dbrsNextToken :: Lens' DescribeBackupsResponse (Maybe Text) dbrsNextToken = lens _dbrsNextToken (\ s a -> s{_dbrsNextToken = a}) -- | -- | The response status code. dbrsResponseStatus :: Lens' DescribeBackupsResponse Int dbrsResponseStatus = lens _dbrsResponseStatus (\ s a -> s{_dbrsResponseStatus = a}) instance NFData DescribeBackupsResponse where