Skip to content

rsrc attributes 3.3 spec

chris grzegorczyk edited this page Dec 11, 2012 · 2 revisions

Table of Contents

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:

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

References

Notes

  1. a b c d e f g h i j Eucalyptus does not support VPC
  2. a b Exists but missing description attribute
  3. ^ Non functional, no updatable attributes supported
  4. a b c d The instance must be stopped to modify this attribute

tag:rls-3.3

Clone this wiki locally