amazonka-backup-2.0: Amazon Backup SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.Backup.CreateBackupPlan

Description

Creates a backup plan using a backup plan name and backup rules. A backup plan is a document that contains information that Backup uses to schedule tasks that create recovery points for resources.

If you call CreateBackupPlan with a plan that already exists, you receive an AlreadyExistsException exception.

Synopsis

Creating a Request

data CreateBackupPlan Source #

See: newCreateBackupPlan smart constructor.

Constructors

CreateBackupPlan' 

Fields

  • backupPlanTags :: Maybe (Sensitive (HashMap Text Text))

    To help organize your resources, you can assign your own metadata to the resources that you create. Each tag is a key-value pair. The specified tags are assigned to all backups created with this plan.

  • creatorRequestId :: Maybe Text

    Identifies the request and allows failed requests to be retried without the risk of running the operation twice. If the request includes a CreatorRequestId that matches an existing backup plan, that plan is returned. This parameter is optional.

    If used, this parameter must contain 1 to 50 alphanumeric or '-_.' characters.

  • backupPlan :: BackupPlanInput

    Specifies the body of a backup plan. Includes a BackupPlanName and one or more sets of Rules.

Instances

Instances details
ToJSON CreateBackupPlan Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

ToHeaders CreateBackupPlan Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

ToPath CreateBackupPlan Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

ToQuery CreateBackupPlan Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

AWSRequest CreateBackupPlan Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

Associated Types

type AWSResponse CreateBackupPlan #

Generic CreateBackupPlan Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

Associated Types

type Rep CreateBackupPlan :: Type -> Type #

Show CreateBackupPlan Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

NFData CreateBackupPlan Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

Methods

rnf :: CreateBackupPlan -> () #

Eq CreateBackupPlan Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

Hashable CreateBackupPlan Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

type AWSResponse CreateBackupPlan Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

type Rep CreateBackupPlan Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

type Rep CreateBackupPlan = D1 ('MetaData "CreateBackupPlan" "Amazonka.Backup.CreateBackupPlan" "amazonka-backup-2.0-LovIt41tphM6jvgQJhTyRf" 'False) (C1 ('MetaCons "CreateBackupPlan'" 'PrefixI 'True) (S1 ('MetaSel ('Just "backupPlanTags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (Sensitive (HashMap Text Text)))) :*: (S1 ('MetaSel ('Just "creatorRequestId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "backupPlan") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 BackupPlanInput))))

newCreateBackupPlan Source #

Create a value of CreateBackupPlan 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:backupPlanTags:CreateBackupPlan', createBackupPlan_backupPlanTags - To help organize your resources, you can assign your own metadata to the resources that you create. Each tag is a key-value pair. The specified tags are assigned to all backups created with this plan.

CreateBackupPlan, createBackupPlan_creatorRequestId - Identifies the request and allows failed requests to be retried without the risk of running the operation twice. If the request includes a CreatorRequestId that matches an existing backup plan, that plan is returned. This parameter is optional.

If used, this parameter must contain 1 to 50 alphanumeric or '-_.' characters.

$sel:backupPlan:CreateBackupPlan', createBackupPlan_backupPlan - Specifies the body of a backup plan. Includes a BackupPlanName and one or more sets of Rules.

Request Lenses

createBackupPlan_backupPlanTags :: Lens' CreateBackupPlan (Maybe (HashMap Text Text)) Source #

To help organize your resources, you can assign your own metadata to the resources that you create. Each tag is a key-value pair. The specified tags are assigned to all backups created with this plan.

createBackupPlan_creatorRequestId :: Lens' CreateBackupPlan (Maybe Text) Source #

Identifies the request and allows failed requests to be retried without the risk of running the operation twice. If the request includes a CreatorRequestId that matches an existing backup plan, that plan is returned. This parameter is optional.

If used, this parameter must contain 1 to 50 alphanumeric or '-_.' characters.

createBackupPlan_backupPlan :: Lens' CreateBackupPlan BackupPlanInput Source #

Specifies the body of a backup plan. Includes a BackupPlanName and one or more sets of Rules.

Destructuring the Response

data CreateBackupPlanResponse Source #

See: newCreateBackupPlanResponse smart constructor.

Constructors

CreateBackupPlanResponse' 

Fields

  • advancedBackupSettings :: Maybe [AdvancedBackupSetting]

    A list of BackupOptions settings for a resource type. This option is only available for Windows Volume Shadow Copy Service (VSS) backup jobs.

  • backupPlanArn :: Maybe Text

    An Amazon Resource Name (ARN) that uniquely identifies a backup plan; for example, arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50.

  • backupPlanId :: Maybe Text

    Uniquely identifies a backup plan.

  • creationDate :: Maybe POSIX

    The date and time that a backup plan is created, in Unix format and Coordinated Universal Time (UTC). The value of CreationDate is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.

  • versionId :: Maybe Text

    Unique, randomly generated, Unicode, UTF-8 encoded strings that are at most 1,024 bytes long. They cannot be edited.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Generic CreateBackupPlanResponse Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

Associated Types

type Rep CreateBackupPlanResponse :: Type -> Type #

Read CreateBackupPlanResponse Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

Show CreateBackupPlanResponse Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

NFData CreateBackupPlanResponse Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

Eq CreateBackupPlanResponse Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

type Rep CreateBackupPlanResponse Source # 
Instance details

Defined in Amazonka.Backup.CreateBackupPlan

type Rep CreateBackupPlanResponse = D1 ('MetaData "CreateBackupPlanResponse" "Amazonka.Backup.CreateBackupPlan" "amazonka-backup-2.0-LovIt41tphM6jvgQJhTyRf" 'False) (C1 ('MetaCons "CreateBackupPlanResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "advancedBackupSettings") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [AdvancedBackupSetting])) :*: (S1 ('MetaSel ('Just "backupPlanArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "backupPlanId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: (S1 ('MetaSel ('Just "creationDate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe POSIX)) :*: (S1 ('MetaSel ('Just "versionId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))))

newCreateBackupPlanResponse Source #

Create a value of CreateBackupPlanResponse 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:

CreateBackupPlanResponse, createBackupPlanResponse_advancedBackupSettings - A list of BackupOptions settings for a resource type. This option is only available for Windows Volume Shadow Copy Service (VSS) backup jobs.

CreateBackupPlanResponse, createBackupPlanResponse_backupPlanArn - An Amazon Resource Name (ARN) that uniquely identifies a backup plan; for example, arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50.

CreateBackupPlanResponse, createBackupPlanResponse_backupPlanId - Uniquely identifies a backup plan.

CreateBackupPlanResponse, createBackupPlanResponse_creationDate - The date and time that a backup plan is created, in Unix format and Coordinated Universal Time (UTC). The value of CreationDate is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.

CreateBackupPlanResponse, createBackupPlanResponse_versionId - Unique, randomly generated, Unicode, UTF-8 encoded strings that are at most 1,024 bytes long. They cannot be edited.

$sel:httpStatus:CreateBackupPlanResponse', createBackupPlanResponse_httpStatus - The response's http status code.

Response Lenses

createBackupPlanResponse_advancedBackupSettings :: Lens' CreateBackupPlanResponse (Maybe [AdvancedBackupSetting]) Source #

A list of BackupOptions settings for a resource type. This option is only available for Windows Volume Shadow Copy Service (VSS) backup jobs.

createBackupPlanResponse_backupPlanArn :: Lens' CreateBackupPlanResponse (Maybe Text) Source #

An Amazon Resource Name (ARN) that uniquely identifies a backup plan; for example, arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50.

createBackupPlanResponse_creationDate :: Lens' CreateBackupPlanResponse (Maybe UTCTime) Source #

The date and time that a backup plan is created, in Unix format and Coordinated Universal Time (UTC). The value of CreationDate is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.

createBackupPlanResponse_versionId :: Lens' CreateBackupPlanResponse (Maybe Text) Source #

Unique, randomly generated, Unicode, UTF-8 encoded strings that are at most 1,024 bytes long. They cannot be edited.