Page Comparison

You can use the Amazon EBS Snapshot task to create, delete or backup snapshots of Amazon Elastic Block Store (EBS) volumes; in particular, the task provides backup management with retention handling and backup set correlation.

Image RemovedImage Added

Panel

borderColor	#bbb
bgColor	#eeeeee

On this page:

Table of Contents

exclude	Popular.*

Panel

borderColor	#bbb
bgColor	#eeeeee

Related Pages:

Using the Amazon EC2 Image task in Bamboo

Configuration

Info

title	Changes to action names in release 2.10.3

As of release 2.10.3, there are two new API compatible EBS Snapshot actions and the former backup oriented actions have been renamed as follows to better reflect their scope (refer to

Jira Legacy

server	JIRA (utoolity.atlassian.net)
columns	key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId	fac61c2e-db0a-39da-bb3c-e0dc0ef556f0
key	UAA-93

for details/background):

Old action name	New action name	Notes
N/A	Create Snapshot(s)	New in 2.10.3
N/A	Delete Snapshot(s)	New in 2.10.3
Create Snapshot(s)	Grow Snapshot Backup Set
Delete Snapshot(s)	Prune Snapshot Backup Set
Backup Snapshot(s)	Grow & Prune Snapshot Backup Set

This is a name change only and no action needs to be taken: existing tasks simply use the new names now and their configuration remains unchanged.

To configure an Amazon EBS Snapshot task:

Navigate to the Tasks configuration tab for the job (this will be the default job if creating a new plan).
Click the name of an existing Amazon EBS Snapshot task, or click Add Task and then AmazonEBS Snapshot Task to create a new task.

Complete the following settings:

Common to all tasks
Include Page
_CommonTaskParametersTable
_CommonTaskParametersTable

Actions supported by this task:

Create Snapshot(s)

Tip

title	Custom Variables

In addition to the the regular Bamboo Variable Substitution/Definition, the Create Snapshot(s) action's Description and Tags fields also support Injecting contextual entity variables into task configurations to ease composing unique names when targeting multiple EC2 instances at once. For example, you can refer to the source volume and add a timestamp to create the unique name ${utoolity.aws.volumeId}.${utoolity.iso8601.basicDateTime}.

These custom variables have task scope only(rather than the regular local scope aka job scope), i.e. they cease to exist when this task finishes.

Volume ID

(Optional) Specify one or more volume IDs (semicolon separated).

Volume Filters

(Optional) Specify resource filters in JSON format. Insert fragments from the inline Examples dialog to get started.

Refer to the --filters specification for describe-volumes for details on available filters.
Refer to Listing and Filtering Using the CLI and API for details on filter value syntax.

Description

Describe the snapshot.

Create unique names via custom variables.

Don't fail for empty filter result Check to prevent the task failing if no matching resources are found.

Tags

Specify tags in JSON format.

Create unique names via custom variables.

Delete Snapshot(s)

Snapshot ID

(Optional) Specify one or more snapshot IDs (semicolon separated).

Snapshot Filters

Optional) Specify resource filters in JSON format. Insert fragments from the inline Examples dialog to get started.

Refer to the --filters specification for describe-snapshots for details on available filters.
Refer to Listing and Filtering Using the CLI and API for details on filter value syntax.

Don't fail for empty filter result see Create above

Grow Snapshot Backup Set

Most use cases can be covered with the combined Grow & Prune Snapshot Backup Set instead, see below.

Volume ID

(Optional) Specify one or more volume IDs (semicolon separated).

Filters

(Optional) Specify resource filters in JSON format. Insert fragments from the inline Examples dialog to get started.

Refer to the --filters specification for describe-volumes for details on available filters.
Refer to Listing and Filtering Using the CLI and API for details on filter value syntax.

Don't fail for empty filter result Check to prevent the task failing if no matching resources are found.

Backup Set Specify the name of the backup set, which determines retention correlation.

Prune Snapshot Backup Set

Most use cases can be covered with the combined Grow & Prune Snapshot Backup Set instead, see below.

Generated Variables

Volume ID

see Create above

Filters

see Create above

Don't fail for empty filter result

see Create above

Backup Set

see Grow Snapshot Backup Set above

Backup Retention

Specify the number of backups that should be retained.

Grow & Prune Snapshot Backup Set

Insert excerpt

	_BackupSetVolumesNote
	_BackupSetVolumesNote
nopanel	true

Volume ID

see Create above

Filters

see Create above

Don't fail for empty filter result

see Create above

Backup Set

see Grow Snapshot Backup Set above

Backup Retention

see Prune Snapshot Backup Set above

Variables

Include Page

	_VariablesNote
	_VariablesNote

Create Snapshot(s)

Info
The logged `bamboo.custom.aws.ec2.snapshot.first.tags` outputs are example tags composed via custom variables and regular Bamboo variables, i.e. you need to specify any desired tags yourself as JSON input for the Tags field.

Code Block

language	text
linenumbers	true

Creating common variables for

1

5 resources affected by task:
... bamboo.custom.aws.ec2.snapshot.resources: snap-8e464ffc;snap-

e1aa2e71

df7ec7dc;snap-02e68305;snap-6af48d6d;snap-fa05c2e8
Creating resource variables for snapshot 'snap-

e1aa2e71':

8e464ffc':
... bamboo.custom.aws.ec2.snapshot.resources.snap-8e464ffc.Description: Snapshot created by TAWS-IT2103-EBS1-14 from vol-577ba418 at 20160412T231901Z
... bamboo.custom.aws.ec2.snapshot.resources.snap-8e464ffc.Encrypted: false
... bamboo.custom.aws.ec2.snapshot.resources.snap-8e464ffc.OwnerAlias: null
... bamboo.custom.aws.ec2.snapshot.resources.snap-8e464ffc.OwnerId: 309600995652
... bamboo.custom.aws.ec2.snapshot.resources.snap-

e1aa2e71

8e464ffc.Progress: 100%
... bamboo.custom.aws.ec2.snapshot.resources.snap-8e464ffc.SnapshotId: snap-

e1aa2e71

8e464ffc
... bamboo.custom.aws.ec2.snapshot.resources.snap-

e1aa2e71

8e464ffc.State: completed
... bamboo.custom.aws.ec2.snapshot.resources.snap-

e1aa2e71

8e464ffc.StartTime: 20160412T231901Z
... bamboo.custom.aws.ec2.snapshot.resources.snap-8e464ffc.StateMessage: null
... bamboo.custom.aws.ec2.snapshot.resources.snap-8e464ffc.VolumeId: vol

-45a6c234

-577ba418
... bamboo.custom.aws.ec2.snapshot.resources.snap-8e464ffc.VolumeSize: 8
... bamboo.custom.aws.ec2.snapshot.resources.snap-8e464ffc.tags: basicTimeMilliseconds;basicDate;basicTime;basicDateTimeMilliseconds;volumeId;buildResultKey;basicDateTime
... bamboo.custom.aws.ec2.snapshot.resources.snap-8e464ffc.tags.basicTimeMilliseconds: 231901.788Z
... bamboo.custom.aws.ec2.snapshot.resources.snap-8e464ffc.tags.basicDate: 20160412
... bamboo.custom.aws.ec2.snapshot.resources.snap-8e464ffc.tags.basicTime: 231901Z
... bamboo.custom.aws.ec2.snapshot.resources.snap-8e464ffc.tags.basicDateTimeMilliseconds: 20160412T231901.788Z
... bamboo.custom.aws.ec2.snapshot.resources.snap-8e464ffc.tags.volumeId: vol-577ba418
... bamboo.custom.aws.ec2.snapshot.resources.snap-8e464ffc.tags.buildResultKey: TAWS-IT2103-EBS1-14
... bamboo.custom.aws.ec2.snapshot.resources.snap-

e1aa2e71.VolumeSize: 1 ...

8e464ffc.tags.basicDateTime: 20160412T231901Z
...
Creating common variables for first resource affected by task:
Creating resource variables for snapshot 'snap-8e464ffc':
... bamboo.custom.aws.ec2.snapshot.first.Description: Snapshot created by TAWS-IT2103-EBS1-14 from vol-577ba418 at 20160412T231901Z
... bamboo.custom.aws.ec2.snapshot.first.Encrypted: false
... bamboo.custom.aws.ec2.snapshot.first.OwnerAlias: null
... bamboo.custom.aws.ec2.snapshot.first.OwnerId: 309600995652
... bamboo.custom.aws.ec2.snapshot.first.Progress: 100%
... bamboo.custom.aws.ec2.snapshot.first.SnapshotId: snap-8e464ffc
... bamboo.custom.aws.ec2.snapshot.first.State: completed
... bamboo.custom.aws.ec2.snapshot.first.StartTime: 20160412T231901Z
... bamboo.custom.aws.ec2.snapshot.first.StateMessage: null
... bamboo.custom.aws.ec2.snapshot.first.VolumeId: vol-577ba418
... bamboo.custom.aws.ec2.snapshot.first.VolumeSize: 8
... bamboo.custom.aws.ec2.snapshot.first.tags: basicTimeMilliseconds;basicDate;basicTime;basicDateTimeMilliseconds;volumeId;buildResultKey;basicDateTime
... bamboo.custom.aws.ec2.snapshot.first.tags.basicTimeMilliseconds: 231901.788Z
... bamboo.custom.aws.ec2.snapshot.first.tags.basicDate: 20160412
... bamboo.custom.aws.ec2.snapshot.first.tags.basicTime: 231901Z
... bamboo.custom.aws.ec2.snapshot.first.tags.basicDateTimeMilliseconds: 20160412T231901.788Z
... bamboo.custom.aws.ec2.snapshot.first.tags.volumeId: vol-577ba418
... bamboo.custom.aws.ec2.snapshot.first.tags.buildResultKey: TAWS-IT2103-EBS1-14
... bamboo.custom.aws.ec2.snapshot.first.tags.basicDateTime: 20160412T231901Z

Delete Snapshot(s)

N/A

Grow Snapshot Backup Set

Code Block

language	text
linenumbers	true

12-Apr-2016 23:38:06	Creating common variables for 5 resources affected by task:
... bamboo.custom.aws.ec2.snapshot.resources: snap-77e5910a;snap-faf1958d;snap-71b69f69;snap-46860f5a;snap-2a8e5e3c
Creating resource variables for snapshot 'snap-77e5910a':
... bamboo.custom.aws.ec2.snapshot.resources.snap-77e5910a.Description: Created by Bamboo EBS Snapshot Task from vol-b87ca3f7
... bamboo.custom.aws.ec2.snapshot.resources.snap-77e5910a.Encrypted: false
... bamboo.custom.aws.ec2.snapshot.resources.snap-77e5910a.OwnerAlias: null
... bamboo.custom.aws.ec2.snapshot.resources.snap-77e5910a.OwnerId: 309600995652
... bamboo.custom.aws.ec2.snapshot.resources.snap-77e5910a.Progress: 100%
... bamboo.custom.aws.ec2.snapshot.resources.snap-77e5910a.SnapshotId: snap-77e5910a
... bamboo.custom.aws.ec2.snapshot.resources.snap-77e5910a.State: completed
... bamboo.custom.aws.ec2.snapshot.resources.snap-

e1aa2e71.StartTime: 20150716T080402Z

77e5910a.StartTime: 20160412T233519Z
... bamboo.custom.aws.ec2.snapshot.resources.snap-77e5910a.StateMessage: null
... bamboo.custom.aws.ec2.snapshot.resources.snap-77e5910a.VolumeId: vol-b87ca3f7
... bamboo.custom.aws.ec2.snapshot.resources.snap-77e5910a.VolumeSize: 8
... bamboo.custom.aws.ec2.snapshot.resources.snap-

e1aa2e71

77e5910a.tags: Name;Backup Policy
... bamboo.custom.aws.ec2.snapshot.resources.snap-

e1aa2e71

77e5910a.tags.Name:

taws

vol-

it-200

b87ca3f7.

20150716T080402Z

20160412T233519Z
... bamboo.custom.aws.ec2.snapshot.resources.snap-

e1aa2e71

77e5910a.tags.Backup Policy: taws-it-

200

245
...
Creating common variables for first resource affected by task:
Creating resource variables for snapshot 'snap-

e1aa2e71':

77e5910a':
... bamboo.custom.aws.ec2.snapshot.first.Description: Created by Bamboo EBS Snapshot Task from vol-b87ca3f7
... bamboo.custom.aws.ec2.snapshot.first.Encrypted: false
... bamboo.custom.aws.ec2.snapshot.first.OwnerAlias: null
... bamboo.custom.aws.ec2.snapshot.first.OwnerId: 309600995652
... bamboo.custom.aws.ec2.snapshot.first.Progress: 100%
... bamboo.custom.aws.ec2.snapshot.first.SnapshotId: snap-

e1aa2e71

77e5910a
... bamboo.custom.aws.ec2.snapshot.first.State: completed
... bamboo.custom.aws.ec2.snapshot.first.

VolumeId: vol-45a6c234

StartTime: 20160412T233519Z
... bamboo.custom.aws.ec2.snapshot.first.StateMessage: null
... bamboo.custom.aws.ec2.snapshot.first.

VolumeSize

VolumeId:

1

vol-b87ca3f7
... bamboo.custom.aws.ec2.snapshot.first.

StartTime

VolumeSize:

20150716T080402Z

8
... bamboo.custom.aws.ec2.snapshot.first.tags: Name;Backup Policy
... bamboo.custom.aws.ec2.snapshot.first.tags.Name:

taws

vol-

it-200

b87ca3f7.

20150716T080402Z

20160412T233519Z
... bamboo.custom.aws.ec2.snapshot.first.tags.Backup Policy: taws-it-

200

Delete

Instance ID

see Create above

Filters
see Create aboveDon't fail for empty filter resultsee Create aboveBackup Setsee Create aboveBackup RetentionSpecify the number of backups that should be retained.Generated Variables

Prune Snapshot Backup Set

N/A

Grow & Prune Snapshot Backup

custom action to combine Create and Delete, effectively capping the number of retained backupsInstance ID

see Create above

Filters
see Create aboveDon't fail for empty filter resultsee Create aboveBackup Setsee Create aboveBackup Retentionsee Delete aboveGenerated Variablessee Create above

Variables

Include Page_VariablesNote_VariablesNote

Set

See Grow above.

How-to Articles

Filter by label (Content by label)

max	8
showSpace	false
sort	title
excerptType	simple
cql	label in ("aws-cli","amazon-ebs") and label in ("kb-how-to-article","kb-troubleshooting-article")

Frequently Asked Questions (FAQ)

Questionslist macro

filter	popular
ask	true
limit	8
topic	amazon-ebs

Versions Compared

Old Version 9

New Version Current

Key

Configuration

Create Snapshot(s)

Delete Snapshot(s)

Grow Snapshot Backup Set

Prune Snapshot Backup Set

Grow & Prune Snapshot Backup Set

Variables

Create Snapshot(s)

Delete Snapshot(s)

Grow Snapshot Backup Set

Delete

Prune Snapshot Backup Set

Grow & Prune Snapshot Backup

Variables

Set

How-to Articles

Frequently Asked Questions (FAQ)