rsrc attributes 3.3 spec

Table of Contents Resource Attributes Overview Out of Scope Feature Dependencies Other Dependencies Required Functionality User Console Commands Operations by API Attributes by type References Notes

Resource Attributes Overview

EC2 resource attributes allow reading and (some) updates of the following resources:

Image
Instance
NetworkInterface ^[1]
Snapshot
Volume

Out of Scope

Any attributes related to the following features are out of scope:

VPC

Feature Dependencies

Attributes related to the following features may be included if these features are part of the release:

Product codes: should propagate via snapshots and volumes TODO:JIRA
Instance termination settings EUCA-2056 (atlassian.net)
- DisableApiTermination
- InstanceInitiatedShutdownBehavior
Snapshot create volume permissions (similar to launch permissions) EUCA-23 (atlassian.net)

Other Dependencies

Functionality in this feature requires that the following issues be addressed:

Launch permissions: API update EUCA-4270 (atlassian.net)

Required Functionality

User Console

The user console should support display and update of supported attributes.

Commands

Command to update:

euca-describe-image-attribute ^[2]
euca-modify-image-attribute ^[2]

Commands to implement:

euca-describe-instance-attribute
euca-describe-snapshot-attribute
euca-describe-volume-attribute
euca-modify-instance-attribute
euca-modify-snapshot-attribute
euca-reset-instance-attribute
euca-reset-snapshot-attribute

Operations by API

EC2 (2012-10-01)
- DescribeImageAttribute
- DescribeInstanceAttribute
- DescribeNetworkInterfaceAttribute ^[1]
- DescribeSnapshotAttribute
- DescribeVolumeAttribute
- ModifyImageAttribute
- ModifyInstanceAttribute
- ModifyNetworkInterfaceAttribute ^[1]
- ModifySnapshotAttribute
- ModifyVolumeAttribute ^[3]
- ResetImageAttribute
- ResetInstanceAttribute
- ResetNetworkInterfaceAttribute ^[1]
- ResetSnapshotAttribute

For modification of an instance attribute an IncorrectInstanceState error can be returned if the instance is running (see table below for these attributes)

Attributes by type

From the 2012-10-01 EC2 API documentation.

Type	Name	Read Supported	Update Supported	Reset Supported	Notes
Image	description	Y	Y
	kernel	Y
	ramdisk	Y
	launchPermission	Y	Y	Y
	productCodes	Y	Y
	blockDeviceMapping	Y
Instance	instanceType	Y	Y		When stopped ^[4]
	kernel	Y	Y	Y	When stopped ^[4]
	ramdisk	Y	Y	Y	When stopped ^[4]
	userData	Y	Y		When stopped ^[4]
	disableApiTermination	Y	Y
	instanceInitiatedShutdownBehavior	Y	Y
	rootDeviceName	Y
	blockDeviceMapping	Y	Y		Modifies delete on terminate only
	sourceDestCheck	-	-	-	VPC^[1]
	groupSet	Y	-		Update is for VPC only^[1]
	productCodes	Y
	ebsOptimized	-	-		N/A
Network Interface	description	-	-		VPC^[1]
	groupSet	-	-		VPC^[1]
	sourceDestCheck	-	-	-	VPC^[1]
	attachment	-	-		VPC^[1]
Snapshot	createVolumePermission	Y	Y	Y	Similar to launch permissions for images
	productCodes	Y			Propagate from image
Volume	autoEnableIO	-	-		N/A
	productCodes	Y			Propagate from image