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.Backup.ListBackupJobs

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Returns a list of existing backup jobs for an authenticated account for the last 30 days. For a longer period of time, consider using these monitoring tools.

Synopsis

data ListBackupJobs = ListBackupJobs' {
- byResourceArn :: Maybe Text
- byCreatedAfter :: Maybe POSIX
- byAccountId :: Maybe Text
- byCreatedBefore :: Maybe POSIX
- byBackupVaultName :: Maybe Text
- byResourceType :: Maybe Text
- nextToken :: Maybe Text
- byState :: Maybe BackupJobState
- maxResults :: Maybe Natural
}
newListBackupJobs :: ListBackupJobs
listBackupJobs_byResourceArn :: Lens' ListBackupJobs (Maybe Text)
listBackupJobs_byCreatedAfter :: Lens' ListBackupJobs (Maybe UTCTime)
listBackupJobs_byAccountId :: Lens' ListBackupJobs (Maybe Text)
listBackupJobs_byCreatedBefore :: Lens' ListBackupJobs (Maybe UTCTime)
listBackupJobs_byBackupVaultName :: Lens' ListBackupJobs (Maybe Text)
listBackupJobs_byResourceType :: Lens' ListBackupJobs (Maybe Text)
listBackupJobs_nextToken :: Lens' ListBackupJobs (Maybe Text)
listBackupJobs_byState :: Lens' ListBackupJobs (Maybe BackupJobState)
listBackupJobs_maxResults :: Lens' ListBackupJobs (Maybe Natural)
data ListBackupJobsResponse = ListBackupJobsResponse' {
- backupJobs :: Maybe [BackupJob]
- nextToken :: Maybe Text
- httpStatus :: Int
}
newListBackupJobsResponse :: Int -> ListBackupJobsResponse
listBackupJobsResponse_backupJobs :: Lens' ListBackupJobsResponse (Maybe [BackupJob])
listBackupJobsResponse_nextToken :: Lens' ListBackupJobsResponse (Maybe Text)
listBackupJobsResponse_httpStatus :: Lens' ListBackupJobsResponse Int

Creating a Request

data ListBackupJobs Source #

See: newListBackupJobs smart constructor.

Constructors

ListBackupJobs'

Fields

byResourceArn :: Maybe Text
Returns only backup jobs that match the specified resource Amazon Resource Name (ARN).
byCreatedAfter :: Maybe POSIX
Returns only backup jobs that were created after the specified date.
byAccountId :: Maybe Text
The account ID to list the jobs from. Returns only backup jobs associated with the specified account ID.
If used from an Organizations management account, passing * returns all jobs across the organization.
byCreatedBefore :: Maybe POSIX
Returns only backup jobs that were created before the specified date.
byBackupVaultName :: Maybe Text
Returns only backup jobs that will be stored in the specified backup vault. Backup vaults are identified by names that are unique to the account used to create them and the Amazon Web Services Region where they are created. They consist of lowercase letters, numbers, and hyphens.
byResourceType :: Maybe Text
Returns only backup jobs for the specified resources:
- DynamoDB for Amazon DynamoDB
- EBS for Amazon Elastic Block Store
- EC2 for Amazon Elastic Compute Cloud
- EFS for Amazon Elastic File System
- RDS for Amazon Relational Database Service
- Aurora for Amazon Aurora
- Storage Gateway for Storage Gateway
nextToken :: Maybe Text
The next item following a partial list of returned items. For example, if a request is made to return maxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.
byState :: Maybe BackupJobState
Returns only backup jobs that are in the specified state.
maxResults :: Maybe Natural
The maximum number of items to be returned.

Instances

Instances details

Eq ListBackupJobs Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs Methods (==) :: ListBackupJobs -> ListBackupJobs -> Bool # (/=) :: ListBackupJobs -> ListBackupJobs -> Bool #
Read ListBackupJobs Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs Methods readsPrec :: Int -> ReadS ListBackupJobs # readList :: ReadS [ListBackupJobs] # readPrec :: ReadPrec ListBackupJobs # readListPrec :: ReadPrec [ListBackupJobs] #
Show ListBackupJobs Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs Methods showsPrec :: Int -> ListBackupJobs -> ShowS # show :: ListBackupJobs -> String # showList :: [ListBackupJobs] -> ShowS #
Generic ListBackupJobs Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs Associated Types type Rep ListBackupJobs :: Type -> Type # Methods from :: ListBackupJobs -> Rep ListBackupJobs x # to :: Rep ListBackupJobs x -> ListBackupJobs #
NFData ListBackupJobs Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs Methods rnf :: ListBackupJobs -> () #
Hashable ListBackupJobs Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs Methods hashWithSalt :: Int -> ListBackupJobs -> Int # hash :: ListBackupJobs -> Int #
AWSRequest ListBackupJobs Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs Associated Types type AWSResponse ListBackupJobs # Methods request :: ListBackupJobs -> Request ListBackupJobs # response :: MonadResource m => Logger -> Service -> Proxy ListBackupJobs -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse ListBackupJobs))) #
ToHeaders ListBackupJobs Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs Methods toHeaders :: ListBackupJobs -> [Header] #
ToPath ListBackupJobs Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs Methods toPath :: ListBackupJobs -> ByteString #
ToQuery ListBackupJobs Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs Methods toQuery :: ListBackupJobs -> QueryString #
type Rep ListBackupJobs Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs type Rep ListBackupJobs = D1 ('MetaData "ListBackupJobs" "Amazonka.Backup.ListBackupJobs" "libZSservicesZSamazonka-backupZSamazonka-backup" 'False) (C1 ('MetaCons "ListBackupJobs'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "byResourceArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "byCreatedAfter") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe POSIX))) :: (S1 ('MetaSel ('Just "byAccountId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "byCreatedBefore") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe POSIX)))) :: ((S1 ('MetaSel ('Just "byBackupVaultName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "byResourceType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "byState") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe BackupJobState)) :: S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)))))))
type AWSResponse ListBackupJobs Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs type AWSResponse ListBackupJobs = ListBackupJobsResponse

newListBackupJobs :: ListBackupJobs Source #

Create a value of ListBackupJobs 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:byResourceArn:ListBackupJobs', listBackupJobs_byResourceArn - Returns only backup jobs that match the specified resource Amazon Resource Name (ARN).

$sel:byCreatedAfter:ListBackupJobs', listBackupJobs_byCreatedAfter - Returns only backup jobs that were created after the specified date.

$sel:byAccountId:ListBackupJobs', listBackupJobs_byAccountId - The account ID to list the jobs from. Returns only backup jobs associated with the specified account ID.

If used from an Organizations management account, passing * returns all jobs across the organization.

$sel:byCreatedBefore:ListBackupJobs', listBackupJobs_byCreatedBefore - Returns only backup jobs that were created before the specified date.

$sel:byBackupVaultName:ListBackupJobs', listBackupJobs_byBackupVaultName - Returns only backup jobs that will be stored in the specified backup vault. Backup vaults are identified by names that are unique to the account used to create them and the Amazon Web Services Region where they are created. They consist of lowercase letters, numbers, and hyphens.

$sel:byResourceType:ListBackupJobs', listBackupJobs_byResourceType - Returns only backup jobs for the specified resources:

DynamoDB for Amazon DynamoDB
EBS for Amazon Elastic Block Store
EC2 for Amazon Elastic Compute Cloud
EFS for Amazon Elastic File System
RDS for Amazon Relational Database Service
Aurora for Amazon Aurora
Storage Gateway for Storage Gateway

$sel:nextToken:ListBackupJobs', listBackupJobs_nextToken - The next item following a partial list of returned items. For example, if a request is made to return maxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.

$sel:byState:ListBackupJobs', listBackupJobs_byState - Returns only backup jobs that are in the specified state.

$sel:maxResults:ListBackupJobs', listBackupJobs_maxResults - The maximum number of items to be returned.

Request Lenses

listBackupJobs_byResourceArn :: Lens' ListBackupJobs (Maybe Text) Source #

Returns only backup jobs that match the specified resource Amazon Resource Name (ARN).

listBackupJobs_byCreatedAfter :: Lens' ListBackupJobs (Maybe UTCTime) Source #

Returns only backup jobs that were created after the specified date.

listBackupJobs_byAccountId :: Lens' ListBackupJobs (Maybe Text) Source #

The account ID to list the jobs from. Returns only backup jobs associated with the specified account ID.

If used from an Organizations management account, passing * returns all jobs across the organization.

listBackupJobs_byCreatedBefore :: Lens' ListBackupJobs (Maybe UTCTime) Source #

Returns only backup jobs that were created before the specified date.

listBackupJobs_byBackupVaultName :: Lens' ListBackupJobs (Maybe Text) Source #

Returns only backup jobs that will be stored in the specified backup vault. Backup vaults are identified by names that are unique to the account used to create them and the Amazon Web Services Region where they are created. They consist of lowercase letters, numbers, and hyphens.

listBackupJobs_byResourceType :: Lens' ListBackupJobs (Maybe Text) Source #

Returns only backup jobs for the specified resources:

DynamoDB for Amazon DynamoDB
EBS for Amazon Elastic Block Store
EC2 for Amazon Elastic Compute Cloud
EFS for Amazon Elastic File System
RDS for Amazon Relational Database Service
Aurora for Amazon Aurora
Storage Gateway for Storage Gateway

listBackupJobs_nextToken :: Lens' ListBackupJobs (Maybe Text) Source #

The next item following a partial list of returned items. For example, if a request is made to return maxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.

listBackupJobs_byState :: Lens' ListBackupJobs (Maybe BackupJobState) Source #

Returns only backup jobs that are in the specified state.

listBackupJobs_maxResults :: Lens' ListBackupJobs (Maybe Natural) Source #

The maximum number of items to be returned.

Destructuring the Response

data ListBackupJobsResponse Source #

See: newListBackupJobsResponse smart constructor.

Constructors

ListBackupJobsResponse'

Fields

backupJobs :: Maybe [BackupJob]
An array of structures containing metadata about your backup jobs returned in JSON format.
nextToken :: Maybe Text
The next item following a partial list of returned items. For example, if a request is made to return maxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.
httpStatus :: Int
The response's http status code.

Instances

Instances details

Eq ListBackupJobsResponse Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs Methods (==) :: ListBackupJobsResponse -> ListBackupJobsResponse -> Bool # (/=) :: ListBackupJobsResponse -> ListBackupJobsResponse -> Bool #
Read ListBackupJobsResponse Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs Methods readsPrec :: Int -> ReadS ListBackupJobsResponse # readList :: ReadS [ListBackupJobsResponse] # readPrec :: ReadPrec ListBackupJobsResponse # readListPrec :: ReadPrec [ListBackupJobsResponse] #
Show ListBackupJobsResponse Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs Methods showsPrec :: Int -> ListBackupJobsResponse -> ShowS # show :: ListBackupJobsResponse -> String # showList :: [ListBackupJobsResponse] -> ShowS #
Generic ListBackupJobsResponse Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs Associated Types type Rep ListBackupJobsResponse :: Type -> Type # Methods from :: ListBackupJobsResponse -> Rep ListBackupJobsResponse x # to :: Rep ListBackupJobsResponse x -> ListBackupJobsResponse #
NFData ListBackupJobsResponse Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs Methods rnf :: ListBackupJobsResponse -> () #
type Rep ListBackupJobsResponse Source #
Instance details Defined in Amazonka.Backup.ListBackupJobs type Rep ListBackupJobsResponse = D1 ('MetaData "ListBackupJobsResponse" "Amazonka.Backup.ListBackupJobs" "libZSservicesZSamazonka-backupZSamazonka-backup" 'False) (C1 ('MetaCons "ListBackupJobsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "backupJobs") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [BackupJob])) :: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newListBackupJobsResponse Source #

Arguments

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

Create a value of ListBackupJobsResponse 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:backupJobs:ListBackupJobsResponse', listBackupJobsResponse_backupJobs - An array of structures containing metadata about your backup jobs returned in JSON format.

$sel:nextToken:ListBackupJobs', listBackupJobsResponse_nextToken - The next item following a partial list of returned items. For example, if a request is made to return maxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.

$sel:httpStatus:ListBackupJobsResponse', listBackupJobsResponse_httpStatus - The response's http status code.

Response Lenses

listBackupJobsResponse_backupJobs :: Lens' ListBackupJobsResponse (Maybe [BackupJob]) Source #

An array of structures containing metadata about your backup jobs returned in JSON format.

listBackupJobsResponse_nextToken :: Lens' ListBackupJobsResponse (Maybe Text) Source #

The next item following a partial list of returned items. For example, if a request is made to return maxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.

listBackupJobsResponse_httpStatus :: Lens' ListBackupJobsResponse Int Source #

The response's http status code.