Amazon ElasticCompute Cloud
API Reference
API Version 2009-07-15
Amazon Elastic Compute Cloud API Reference
Amazon Elastic Compute Cloud: API ReferenceCopyright © 2009 Amazon Web Services LLC or its affiliates. All rights reserved.
Amazon Elastic Compute Cloud API Reference
Table of ContentsWelcome ............................................................................................................................................................ 1What's New ....................................................................................................................................................... 4API Overview .................................................................................................................................................... 5
API Actions ............................................................................................................................................ 5Data Types and the Amazon EC2 WSDL ............................................................................................ 5API Versioning ....................................................................................................................................... 6
Amazon EC2 Query API ................................................................................................................................... 7Common Query Parameters ................................................................................................................. 8List of Query Operations by Function ................................................................................................... 9AllocateAddress ................................................................................................................................... 12AssociateAddress ................................................................................................................................ 14AttachVolume ...................................................................................................................................... 16AuthorizeSecurityGroupIngress ........................................................................................................... 19BundleInstance .................................................................................................................................... 22CancelBundleTask ............................................................................................................................... 27ConfirmProductInstance ...................................................................................................................... 31CreateKeyPair ...................................................................................................................................... 33CreateSecurityGroup ........................................................................................................................... 35CreateSnapshot ................................................................................................................................... 37CreateVolume ...................................................................................................................................... 39DeleteKeyPair ...................................................................................................................................... 42DeleteSecurityGroup ............................................................................................................................ 44DeleteSnapshot ................................................................................................................................... 46DeleteVolume ...................................................................................................................................... 48DeregisterImage .................................................................................................................................. 50DescribeAddresses .............................................................................................................................. 52DescribeAvailabilityZones .................................................................................................................... 54DescribeBundleTasks .......................................................................................................................... 57DescribeImageAttribute ....................................................................................................................... 61DescribeImages ................................................................................................................................... 65DescribeInstances ............................................................................................................................... 69DescribeKeyPairs ................................................................................................................................ 75DescribeRegions .................................................................................................................................. 77DescribeReservedInstances ................................................................................................................ 79DescribeReservedInstancesOfferings .................................................................................................. 82DescribeSecurityGroups ...................................................................................................................... 85DescribeSnapshots .............................................................................................................................. 89DescribeVolumes ................................................................................................................................. 91DetachVolume ..................................................................................................................................... 94DisassociateAddress ........................................................................................................................... 97GetConsoleOutput ............................................................................................................................... 99GetPasswordData .............................................................................................................................. 101ModifyImageAttribute ......................................................................................................................... 103MonitorInstances ................................................................................................................................ 105PurchaseReservedInstancesOffering ................................................................................................ 107RebootInstances ................................................................................................................................ 109RegisterImage .................................................................................................................................... 111ReleaseAddress ................................................................................................................................. 113ResetImageAttribute .......................................................................................................................... 115RevokeSecurityGroupIngress ............................................................................................................ 117RunInstances ..................................................................................................................................... 120TerminateInstances ........................................................................................................................... 129UnmonitorInstances ........................................................................................................................... 132
Amazon EC2 SOAP API ............................................................................................................................... 134List of SOAP Operations by Function ............................................................................................... 135
Amazon Elastic Compute Cloud API Reference
AllocateAddress ................................................................................................................................. 138AssociateAddress .............................................................................................................................. 140AttachVolume ..................................................................................................................................... 142AuthorizeSecurityGroupIngress ......................................................................................................... 145BundleInstance .................................................................................................................................. 149CancelBundleTask ............................................................................................................................. 155ConfirmProductInstance .................................................................................................................... 159CreateKeyPair .................................................................................................................................... 161CreateSecurityGroup ......................................................................................................................... 164CreateSnapshot ................................................................................................................................. 166CreateVolume .................................................................................................................................... 168DeleteKeyPair .................................................................................................................................... 171DeleteSecurityGroup .......................................................................................................................... 173DeleteSnapshot ................................................................................................................................. 175DeleteVolume .................................................................................................................................... 177DeregisterImage ................................................................................................................................ 179DescribeAddresses ............................................................................................................................ 181DescribeAvailabilityZones .................................................................................................................. 184DescribeBundleTasks ........................................................................................................................ 187DescribeImageAttribute ..................................................................................................................... 191DescribeImages ................................................................................................................................. 196DescribeInstances ............................................................................................................................. 202DescribeKeyPairs .............................................................................................................................. 209DescribeRegions ................................................................................................................................ 211DescribeReservedInstances .............................................................................................................. 213DescribeReservedInstancesOfferings ................................................................................................ 216DescribeSecurityGroups .................................................................................................................... 220DescribeSnapshots ............................................................................................................................ 224DescribeVolumes ............................................................................................................................... 227DetachVolume ................................................................................................................................... 231DisassociateAddress ......................................................................................................................... 234GetConsoleOutput ............................................................................................................................. 236GetPasswordData .............................................................................................................................. 238ModifyImageAttribute ......................................................................................................................... 240MonitorInstances ................................................................................................................................ 244PurchaseReservedInstancesOffering ................................................................................................ 247RebootInstances ................................................................................................................................ 249RegisterImage .................................................................................................................................... 251ReleaseAddress ................................................................................................................................. 253ResetImageAttribute .......................................................................................................................... 255RevokeSecurityGroupIngress ............................................................................................................ 257RunInstances ..................................................................................................................................... 261TerminateInstances ........................................................................................................................... 272UnmonitorInstances ........................................................................................................................... 275
Data Types .................................................................................................................................................... 278AllocateAddressResponseType ......................................................................................................... 282AssociateAddressResponseType ...................................................................................................... 283AssociateAddressType ...................................................................................................................... 283AttachmentSetItemResponseType .................................................................................................... 284AttachmentSetResponseType ........................................................................................................... 284AttachVolumeResponseType ............................................................................................................ 285AttachVolumeType ............................................................................................................................. 286AttributeValueType ............................................................................................................................ 286AuthorizeSecurityGroupIngressResponseType ................................................................................. 287AuthorizeSecurityGroupIngressType ................................................................................................. 287AvailabilityZoneItemType ................................................................................................................... 288AvailabilityZoneMessageSetType ...................................................................................................... 288AvailabilityZoneMessageType ........................................................................................................... 289
Amazon Elastic Compute Cloud API Reference
AvailabilityZoneSetType .................................................................................................................... 289BlockDeviceMappingItemType .......................................................................................................... 290BlockDeviceMappingType ................................................................................................................. 290BundleInstanceResponseType .......................................................................................................... 291BundleInstanceS3StorageType ......................................................................................................... 291BundleInstanceTaskErrorType .......................................................................................................... 292BundleInstanceTasksSetType ........................................................................................................... 293BundleInstanceTaskStorageType ...................................................................................................... 293BundleInstanceTaskType .................................................................................................................. 294BundleInstanceType .......................................................................................................................... 295CancelBundleTaskResponseType ..................................................................................................... 295CancelBundleTaskType ..................................................................................................................... 296ConfirmProductInstanceResponseType ............................................................................................ 296ConfirmProductInstanceType ............................................................................................................ 297CreateKeyPairResponseType ........................................................................................................... 297CreateKeyPairType ............................................................................................................................ 298CreateSecurityGroupResponseType ................................................................................................. 298CreateSecurityGroupType ................................................................................................................. 299CreateSnapshotResponseType ......................................................................................................... 299CreateSnapshotType ......................................................................................................................... 300CreateVolumeResponseType ............................................................................................................ 300CreateVolumeType ............................................................................................................................ 301DeleteKeyPairResponseType ............................................................................................................ 302DeleteKeyPairType ............................................................................................................................ 302DeleteSecurityGroupResponseType .................................................................................................. 303DeleteSecurityGroupType .................................................................................................................. 303DeleteSnapshotResponseType ......................................................................................................... 304DeleteSnapshotType ......................................................................................................................... 304DeleteVolumeResponseType ............................................................................................................ 304DeleteVolumeType ............................................................................................................................ 305DeregisterImageResponseType ........................................................................................................ 305DeregisterImageType ........................................................................................................................ 306DescribeAddressesInfoType .............................................................................................................. 306DescribeAddressesItemType ............................................................................................................. 307DescribeAddressesResponseInfoType .............................................................................................. 307DescribeAddressesResponseItemType ............................................................................................. 308DescribeAddressesResponseType .................................................................................................... 308DescribeAddressesType .................................................................................................................... 309DescribeAvailabilityZonesResponseType .......................................................................................... 309DescribeAvailabilityZonesSetItemType .............................................................................................. 310DescribeAvailabilityZonesSetType ..................................................................................................... 310DescribeAvailabilityZonesType .......................................................................................................... 311DescribeBundleTasksInfoType .......................................................................................................... 311DescribeBundleTasksItemType ......................................................................................................... 311DescribeBundleTasksResponseType ................................................................................................ 312DescribeBundleTasksType ................................................................................................................ 312DescribeImageAttributeResponseType ............................................................................................. 313DescribeImageAttributesGroup .......................................................................................................... 314DescribeImageAttributeType ............................................................................................................. 314DescribeImagesExecutableBySetType .............................................................................................. 315DescribeImagesExecutableByType ................................................................................................... 315DescribeImagesInfoType ................................................................................................................... 316DescribeImagesItemType .................................................................................................................. 316DescribeImagesOwnersType ............................................................................................................. 317DescribeImagesOwnerType .............................................................................................................. 317DescribeImagesResponseInfoType ................................................................................................... 318DescribeImagesResponseItemType .................................................................................................. 318DescribeImagesResponseType ......................................................................................................... 319
Amazon Elastic Compute Cloud API Reference
DescribeImagesType ......................................................................................................................... 320DescribeInstancesInfoType ............................................................................................................... 320DescribeInstancesItemType .............................................................................................................. 321DescribeInstancesResponseType ..................................................................................................... 321DescribeInstancesType ..................................................................................................................... 322DescribeKeyPairsInfoType ................................................................................................................ 322DescribeKeyPairsItemType ............................................................................................................... 323DescribeKeyPairsResponseInfoType ................................................................................................ 323DescribeKeyPairsResponseItemType ............................................................................................... 324DescribeKeyPairsResponseType ...................................................................................................... 324DescribeKeyPairsType ...................................................................................................................... 325DescribeRegionsResponseType ........................................................................................................ 325DescribeRegionsSetItemType ........................................................................................................... 325DescribeRegionsSetType .................................................................................................................. 326DescribeRegionsType ........................................................................................................................ 326DescribeReservedInstancesOfferingsResponseSetItemType ........................................................... 327DescribeReservedInstancesOfferingsResponseSetType .................................................................. 328DescribeReservedInstancesOfferingsResponseType ........................................................................ 328DescribeReservedInstancesOfferingsSetItemType ........................................................................... 329DescribeReservedInstancesOfferingsSetType .................................................................................. 329DescribeReservedInstancesOfferingsType ........................................................................................ 330DescribeReservedInstancesResponseSetItemType .......................................................................... 330DescribeReservedInstancesResponseSetType ................................................................................. 331DescribeReservedInstancesResponseType ...................................................................................... 332DescribeReservedInstancesSetItemType .......................................................................................... 332DescribeReservedInstancesSetType ................................................................................................. 333DescribeReservedInstancesType ...................................................................................................... 333DescribeSecurityGroupsResponseType ............................................................................................ 334DescribeSecurityGroupsSetItemType ................................................................................................ 334DescribeSecurityGroupsSetType ....................................................................................................... 335DescribeSecurityGroupsType ............................................................................................................ 335DescribeSnapshotsResponseType .................................................................................................... 336DescribeSnapshotsSetItemResponseType ....................................................................................... 336DescribeSnapshotsSetItemType ........................................................................................................ 337DescribeSnapshotsSetResponseType .............................................................................................. 337DescribeSnapshotsSetType .............................................................................................................. 338DescribeSnapshotsType .................................................................................................................... 338DescribeVolumesResponseType ....................................................................................................... 339DescribeVolumesSetItemResponseType .......................................................................................... 339DescribeVolumesSetItemType .......................................................................................................... 340DescribeVolumesSetResponseType ................................................................................................. 340DescribeVolumesSetType ................................................................................................................. 341DescribeVolumesType ....................................................................................................................... 341DetachVolumeResponseType ........................................................................................................... 342DetachVolumeType ........................................................................................................................... 342DisassociateAddressResponseType ................................................................................................. 343DisassociateAddressType ................................................................................................................. 344EmptyElementType ............................................................................................................................ 344GetConsoleOutputResponseType ..................................................................................................... 345GetConsoleOutputType ..................................................................................................................... 345GetPasswordDataResponseType ...................................................................................................... 346GetPasswordDataType ...................................................................................................................... 346GroupItemType .................................................................................................................................. 347GroupSetType .................................................................................................................................... 347InstanceMonitoringStateType ............................................................................................................ 348InstanceStateType ............................................................................................................................. 348IpPermissionSetType ......................................................................................................................... 349IpPermissionType .............................................................................................................................. 350
Amazon Elastic Compute Cloud API Reference
IpRangeItemType .............................................................................................................................. 351IpRangeSetType ................................................................................................................................ 351LaunchPermissionItemType .............................................................................................................. 352LaunchPermissionListType ................................................................................................................ 352LaunchPermissionOperationType ...................................................................................................... 353ModifyImageAttributeResponseType ................................................................................................. 353ModifyImageAttributeType ................................................................................................................. 354MonitoringInstanceType ..................................................................................................................... 354MonitorInstancesResponseSetItemType ........................................................................................... 355MonitorInstancesResponseSetType .................................................................................................. 355MonitorInstancesResponseType ........................................................................................................ 356MonitorInstancesSetItemType ........................................................................................................... 356MonitorInstancesSetType .................................................................................................................. 357MonitorInstancesType ........................................................................................................................ 357NullableAttributeValueType ............................................................................................................... 358PlacementRequestType ..................................................................................................................... 358PlacementResponseType .................................................................................................................. 359ProductCodeItemType ....................................................................................................................... 359ProductCodeListType ........................................................................................................................ 360ProductCodesSetItemType ................................................................................................................ 360ProductCodesSetType ....................................................................................................................... 361PurchaseReservedInstancesOfferingResponseType ........................................................................ 361PurchaseReservedInstancesOfferingType ........................................................................................ 362RebootInstancesInfoType .................................................................................................................. 362RebootInstancesItemType ................................................................................................................. 363RebootInstancesResponseType ........................................................................................................ 363RebootInstancesType ........................................................................................................................ 364RegionItemType ................................................................................................................................. 364RegionSetType .................................................................................................................................. 365RegisterImageResponseType ........................................................................................................... 365RegisterImageType ............................................................................................................................ 366ReleaseAddressResponseType ........................................................................................................ 366ReleaseAddressType ......................................................................................................................... 367ReservationInfoType .......................................................................................................................... 367ReservationSetType .......................................................................................................................... 368ResetImageAttributeResponseType .................................................................................................. 368ResetImageAttributesGroup .............................................................................................................. 369ResetImageAttributeType .................................................................................................................. 369RevokeSecurityGroupIngressResponseType .................................................................................... 370RevokeSecurityGroupIngressType .................................................................................................... 370RunInstancesResponseType ............................................................................................................. 371RunInstancesType ............................................................................................................................. 371RunningInstancesItemType ............................................................................................................... 373RunningInstancesSetType ................................................................................................................. 375SecurityGroupItemType ..................................................................................................................... 375SecurityGroupSetType ....................................................................................................................... 376TerminateInstancesInfoType ............................................................................................................. 376TerminateInstancesItemType ............................................................................................................ 377TerminateInstancesResponseInfoType ............................................................................................. 377TerminateInstancesResponseItemType ............................................................................................ 378TerminateInstancesResponseType ................................................................................................... 378TerminateInstancesType ................................................................................................................... 379UserDataType .................................................................................................................................... 379UserIdGroupPairSetType ................................................................................................................... 380UserIdGroupPairType ........................................................................................................................ 380
API Error Codes ............................................................................................................................................ 382Glossary ........................................................................................................................................................ 387Document Conventions ................................................................................................................................. 390
Amazon Elastic Compute Cloud API Reference
Index .............................................................................................................................................................. 393
Amazon Elastic Compute Cloud API ReferenceWho Should Read This Guide
API Version 2009-07-151
Welcome
Topics
• Who Should Read This Guide (p. 1)
• Reader Feedback (p. 2)
• How This Guide Is Organized (p. 2)
• Amazon EC2 Resources (p. 2)
This is the Amazon Elastic Compute Cloud API Reference Guide. This section describes who shouldread this guide, how the guide is organized, and other resources related to Amazon Elastic ComputeCloud.
The Amazon Elastic Compute Cloud is occasionally referred to within this guide as simply "AmazonEC2"; all copyrights and legal protections still apply.
Who Should Read This GuideThis guide is for programmers that need detailed information about the Amazon EC2 SOAP and QueryAPIs.
Required Knowledge and SkillsUse of this guide assumes you are familiar with the following:
• XML (For an overview, go to the W3 Schools XML Tutorial)
• Basic understanding of web services (go to W3 Schools Web Services Tutorial)
• Query or SOAP
• One or more programming languages
You should also have worked through the Amazon Elastic Compute Cloud Getting Started Guide, setup your development environment, and have a general understanding of the service. Additionally,you should refer to the Amazon Elastic Compute Cloud Developer Guide for high level concepts andexamples of how to use major Amazon EC2 features.
Amazon Elastic Compute Cloud API ReferenceReader Feedback
API Version 2009-07-152
Reader FeedbackThe online version of this guide provides a link at the top of each page that enables you to enterfeedback about this guide. We strive to make our guides as complete, error free, and easy to read aspossible. You can help by giving us feedback. Thank you in advance!
How This Guide Is OrganizedThis guide is organized into several major sections described in the following table.
Information Relevant Sections
Overview of the APIs and conventions. API Overview (p. 5)
Comprehensive reference to theSOAP APIs.
Amazon EC2 SOAP API (p. 134)
Comprehensive reference to the QueryAPIs.
Amazon EC2 Query API (p. 7)
Comprehensive reference to theSOAP data types.
Data Types (p. 278)
Error code information. API Error Codes (p. 382)
Amazon EC2 terms. Glossary (p. 387)
Typographic and symbol conventions. Document Conventions (p. 390)
Amazon EC2 ResourcesThe following table lists related resources that you'll find useful as you work with this service.
Resource Description
Amazon Elastic Compute CloudGetting Started Guide
The Getting Started Guide provides a quick tutorial ofthe service based on a simple use case. Examples andinstructions are included.
Amazon Elastic Compute Cloud UserGuide
The Console and Command Line User Guide providesconceptual information about Amazon EC2 and describeshow to use Amazon EC2 features using the AWSManagement Console and command line tools.
Amazon Elastic Compute CloudDeveloper Guide
The Developer Guide provides conceptual informationabout Amazon EC2 and describes how to use Amazon EC2features using the SOAP and Query APIs.
Amazon Elastic Compute CloudCommand Line Reference
The Command Line Tools Reference contains acomprehensive description of all the command line toolsand their options.
Amazon Elastic Compute Cloud API ReferenceAmazon EC2 Resources
API Version 2009-07-153
Resource Description
Amazon EC2 Technical FAQ The FAQ covers the top questions developers have askedabout this product.
Amazon EC2 Release Notes The Release Notes give a high-level overview of thecurrent release. They specifically note any new features,corrections, and known issues.
AWS Developer Resource Center A central starting point to find documentation, codesamples, release notes, and other information to help youbuild innovative applications with AWS.
AWS Management Console The console allows you to perform most of the functionsof Amazon EC2 and other AWS products withoutprogramming.
Discussion Forums A community-based forum for developers to discusstechnical questions related to Amazon Web Services.
AWS Support Center The home page for AWS Technical Support, includingaccess to our Developer Forums, Technical FAQs, ServiceStatus page, and AWS Premium Support (if you aresubscribed to this program).
AWS Premium Support Information The primary web page for information about AWS PremiumSupport, a one-on-one, fast-response support channel tohelp you build and run applications on AWS InfrastructureServices.
Amazon EC2 Product Information The primary web page for information about Amazon EC2.
Form for questions related to yourAWS account: Contact Us
This form is only for account questions. For technicalquestions, use the Discussion Forums.
Conditions of Use Detailed information about the copyright and trademarkusage at Amazon.com and other topics.
Amazon Elastic Compute Cloud API Reference
API Version 2009-07-154
What's New
This What's New is associated with the 2009-07-15 release of Amazon EC2. This guide was lastupdated on September 03, 2009.
The following table describes the important changes since the last release of the Amazon EC2documentation set.
Change Description ReleaseDate
Amazon VirtualPrivate Cloud
Amazon EC2 now supports Amazon Virtual Private Cloud,a service that lets you create isolated resources within theAWS cloud, and then connect those resources directly toyour own data center using industry-standard encryptedIPsec VPN connections.
For more information about the service, go to Amazon VirtualPrivate Cloud Product Page.
26 August2009
Amazon Elastic Compute Cloud API ReferenceAPI Actions
API Version 2009-07-155
API Overview
Topics
• API Actions (p. 5)
• Data Types and the Amazon EC2 WSDL (p. 5)
• API Versioning (p. 6)
Amazon EC2 provides two APIs: SOAP and Query.
This section discusses the operations available in the Amazon EC2 APIs, their semantics, and theirrequired parameters. Examples of requests and responses are also provided.
Note
The same XML body is returned in both the Query API and SOAP API.
For detailed information about Amazon EC2 features and their associated APIs, refer to theAmazon Elastic Compute Cloud Developer Guide.
API ActionsActions encapsulate the possible interactions with Amazon EC2. These can be viewed as remoteprocedure calls and consist of a request and response message pair. Requests must be signed,allowing Amazon EC2 to authenticate them. For clarity, the sample requests and responses illustratingeach of the operations described in this reference are not signed.
Data Types and the Amazon EC2 WSDLThe current version of the Amazon EC2 WSDL is available at: http://ec2.amazonaws.com/doc/2009-07-15/AmazonEC2.wsdl. Some libraries can generate code directly from the WSDL. Otherlibraries require a little more work on your part.
Values provided as parameters to the various operations must be of the indicated type. Standard XSDtypes (like string, boolean, int) are prefixed with xsd:. Complex types defined by the AmazonEC2 WSDL are prefixed with ec2:.
Parameters that consist of lists of information are defined within our WSDL to require <info> tagsaround each member. Throughout the API, type references for parameters that accept such a list of
Amazon Elastic Compute Cloud API ReferenceAPI Versioning
API Version 2009-07-156
values are specified using the notation type[] The type referred to in these instances is the typenested within the <info> tag (for Amazon EC2 types this is defined in the WSDL).
For example, the <imagesSet> element in the following XML snippet is of type xsd:string[].
<imagesSet> <item> <imageId>ami-61a54008</imageId> </item> <item> <imageId>ami-61b54608</imageId> </item></imagesSet>
The <instancesSet> element in the following XML snippet is of type xsd:string[].
<instancesSet> <item> <imageId>ami-60a54009</imageId> <minCount>10</minCount> <maxCount>30</maxCount> </item> <item> <imageId>ami-60b54209</imageId> <minCount>5</minCount> <maxCount>20</maxCount> </item></instancesSet>
API VersioningBecause features and changes can introduce incompatible API changes, all Amazon EC2 API updatesare versioned. By including a version in the request, clients receive responses they can process.
Each API revision is assigned a version in date form (the current API version is 2009-07-15). Thisversion is included in the request as part of the document namespace when using our SOAP API andas a Version parameter when using our Query API. The response that Amazon EC2 returns honorsthe version included in the request.
SOAP clients that retrieve the Amazon EC2 WSDL at runtime and generate their requests dynamicallyusing that WSDL should reference the WSDL for the version of the API that the client was developedagainst. This ensures that the client software continues to work even if backward incompatible APIchanges are introduced. The WSDL for each supported API version is available from the following URI:
http://ec2.amazonaws.com/doc/<api-version>/AmazonEC2.wsdl
The WSDL for latest version of our API is available from the following URI:
http://ec2.amazonaws.com/doc/2009-07-15/AmazonEC2.wsdl
Note
The WSDL should be treated as a moving target as it will always map to the latest releaseof the Amazon EC2 SOAP API. If your software depends on retrieving the WSDL at runtime,we strongly recommend you reference the specific version of the WSDL you are developingagainst.
Amazon Elastic Compute Cloud API Reference
API Version 2009-07-157
Amazon EC2 Query API
Topics
• Common Query Parameters (p. 8)
• List of Query Operations by Function (p. 9)
• AllocateAddress (p. 12)
• AssociateAddress (p. 14)
• AttachVolume (p. 16)
• AuthorizeSecurityGroupIngress (p. 19)
• BundleInstance (p. 22)
• CancelBundleTask (p. 27)
• ConfirmProductInstance (p. 31)
• CreateKeyPair (p. 33)
• CreateSecurityGroup (p. 35)
• CreateSnapshot (p. 37)
• CreateVolume (p. 39)
• DeleteKeyPair (p. 42)
• DeleteSecurityGroup (p. 44)
• DeleteSnapshot (p. 46)
• DeleteVolume (p. 48)
• DeregisterImage (p. 50)
• DescribeAddresses (p. 52)
• DescribeAvailabilityZones (p. 54)
• DescribeBundleTasks (p. 57)
• DescribeImageAttribute (p. 61)
• DescribeImages (p. 65)
• DescribeInstances (p. 69)
• DescribeKeyPairs (p. 75)
• DescribeRegions (p. 77)
• DescribeReservedInstances (p. 79)
• DescribeReservedInstancesOfferings (p. 82)
Amazon Elastic Compute Cloud API ReferenceCommon Query Parameters
API Version 2009-07-158
• DescribeSecurityGroups (p. 85)
• DescribeSnapshots (p. 89)
• DescribeVolumes (p. 91)
• DetachVolume (p. 94)
• DisassociateAddress (p. 97)
• GetConsoleOutput (p. 99)
• GetPasswordData (p. 101)
• ModifyImageAttribute (p. 103)
• MonitorInstances (p. 105)
• PurchaseReservedInstancesOffering (p. 107)
• RebootInstances (p. 109)
• RegisterImage (p. 111)
• ReleaseAddress (p. 113)
• ResetImageAttribute (p. 115)
• RevokeSecurityGroupIngress (p. 117)
• RunInstances (p. 120)
• TerminateInstances (p. 129)
• UnmonitorInstances (p. 132)
Common Query ParametersAll Query operations share a set of common parameters that must be present in each call.
Name Description Required
Action Indicates the action to perform.
Example: RunInstances
Yes
Version The API version to use, as specified in the WSDL.
Example: 2009-07-15
Yes
AWSAccessKeyId The Access Key ID for the request sender. Thisidentifies the account which will be charged for usageof the service. The account with which the Access KeyID is associated must be signed up for Amazon EC2, orrequests will not be accepted.
AKIADQKE4SARGYLE
Yes
Timestamp The date and time at which the request is signed,in the format YYYY-MM-DDThh:mm:ssZ. For moreinformation, go to ISO 8601.
Example: 2006-07-07T15:04:56Z
Yes
Expires The date and time at which the signature includedin the request expires, in the format YYYY-MM-DDThh:mm:ssZ.
Example: 2006-07-07T15:04:56Z
Yes
Signature The request signature. For more information, go to theAmazon Elastic Compute Cloud Developer Guide.
Example: Qnpl4Qk/7tINHzfXCiT7VbBatDA=
Yes
Amazon Elastic Compute Cloud API ReferenceList of Query Operations by Function
API Version 2009-07-159
Name Description Required
SignatureMethod The hash algorithm you use to create the requestsignature. Valid values: HmacSHA256 | HmacSHA1. Formore information, go to the Amazon Elastic ComputeCloud Developer Guide.
Example: HmacSHA256
Yes
SignatureVersion The signature version you use to sign the request. Setthis value to 2. For more information, go to the AmazonElastic Compute Cloud Developer Guide.
Example: 2
Yes
Note
The Timestamp parameter can be used instead of Expires. Requests must include eitherTimestamp or Expires, but cannot contain both.
Parameter values must be URL-encoded. This is true for any Query parameter passed to Amazon EC2and is typically necessary in the Signature parameter. Some clients do this automatically, but this isnot the norm.
List of Query Operations by FunctionAmazon DevPay
• ConfirmProductInstance (p. 31)
AMIs
• DeregisterImage (p. 50)
• DescribeImageAttribute (p. 61)
• DescribeImages (p. 65)
• ModifyImageAttribute (p. 103)
Availability Zones and Regions
• DescribeAvailabilityZones (p. 54)
• DescribeRegions (p. 77)
Elastic Block Store
• AttachVolume (p. 16)
• CreateSnapshot (p. 37)
• CreateVolume (p. 39)
• DeleteSnapshot (p. 46)
• DeleteVolume (p. 48)
• DescribeSnapshots (p. 89)
• DescribeVolumes (p. 91)
Amazon Elastic Compute Cloud API ReferenceList of Query Operations by Function
API Version 2009-07-1510
• DetachVolume (p. 94)
Elastic IP Addresses
• AllocateAddress (p. 12)
• AssociateAddress (p. 14)
• DescribeAddresses (p. 52)
• DisassociateAddress (p. 97)
• ReleaseAddress (p. 113)
General
• GetConsoleOutput (p. 99)
Images
• RegisterImage (p. 111)
• ResetImageAttribute (p. 115)
Instances
• DescribeInstances (p. 69)
• RebootInstances (p. 109)
• RunInstances (p. 120)
• TerminateInstances (p. 129)
Key Pairs
• CreateKeyPair (p. 33)
• DeleteKeyPair (p. 42)
• DescribeKeyPairs (p. 75)
Monitoring
• MonitorInstances (p. 105)
• UnmonitorInstances (p. 132)
Reserved Instances
• DescribeReservedInstances (p. 79)
• DescribeReservedInstancesOfferings (p. 82)
• PurchaseReservedInstancesOffering (p. 107)
Security Groups
• AuthorizeSecurityGroupIngress (p. 19)
• CreateSecurityGroup (p. 35)
• DeleteSecurityGroup (p. 44)
• DescribeSecurityGroups (p. 85)
Amazon Elastic Compute Cloud API ReferenceList of Query Operations by Function
API Version 2009-07-1511
• RevokeSecurityGroupIngress (p. 117)
Windows
• BundleInstance (p. 22)
• CancelBundleTask (p. 27)
• DescribeBundleTasks (p. 57)
• GetPasswordData (p. 101)
Amazon Elastic Compute Cloud API ReferenceAllocateAddress
API Version 2009-07-1512
AllocateAddress
DescriptionAcquires an elastic IP address for use with your account.
Request ParametersThe AllocateAddress operation does not have any request parameters.
Response Elements
Name Description
AllocateAddressResponseTypeAllocateAddressResponseType element.
Type: AllocateAddressResponseType (p. 282)
Ancestor: None
Children: requestId, publicIp
requestId The ID of the request.
Type: xsd:string
Ancestor: AllocateAddressResponseType
Children: None
publicIp IP address for use with your account.
Type: xsd:string
Ancestor: AllocateAddressResponseType
Children: None
Examples
Example Request
This example returns an elastic IP address for use with the account.
https://ec2.amazonaws.com/?Action=AllocateAddress&AuthParams
Example Response<AllocateAddressResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <publicIp>67.202.55.255</publicIp></AllocateAddressResponse>
Related Operations• DescribeAddresses (p. 52)
• ReleaseAddress (p. 113)
• AssociateAddress (p. 14)
• DisassociateAddress (p. 97)
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1513
Amazon Elastic Compute Cloud API ReferenceAssociateAddress
API Version 2009-07-1514
AssociateAddress
DescriptionAssociates an elastic IP address with an instance. If the IP address is currently assigned to anotherinstance, the IP address is assigned to the new instance. This is an idempotent operation. If you enterit more than once, Amazon EC2 does not return an error.
Request Parameters
Name Description Required
PublicIp IP address that you are assigning to the instance.
Type: String
Default: None
Yes
InstanceId The instance to associate with the IP address.
Type: String
Default: None
Yes
Response Elements
Name Description
AssociateAddressResponseTypeAssociateAddressResponseType element.
Type: AssociateAddressResponseType (p. 283)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: AssociateAddressResponseType
Children: None
return Returns "true" if instance and IP address successfully associated;otherwise "false".
Type: xsd:boolean
Ancestor: AssociateAddressResponseType
Children: None
Examples
Example Request
This example associates an IP address with an instance.
https://ec2.amazonaws.com/?Action=AssociateAddress &InstanceId=i-2ea64347 &PublicIp=67.202.55.255
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1515
&AuthParams
Example Response<AssociateAddressResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></AssociateAddressResponse>
Related Operations• AllocateAddress (p. 12)
• DescribeAddresses (p. 52)
• ReleaseAddress (p. 113)
• DisassociateAddress (p. 97)
Amazon Elastic Compute Cloud API ReferenceAttachVolume
API Version 2009-07-1516
AttachVolume
DescriptionAttaches an Amazon EBS volume to a running instance and exposes it as the specified device.
Note
Windows instances currently support devices xvda through xvdp. Devices xvda and xvdbare reserved by the operating system, xvdc is assigned to drive C:\, and, depending on theinstance type, devices xvdd through xvde might be reserved by the instance stores. Anydevice that is not reserved can be attached to an Amazon EBS volume. For a list of devicesthat are reserved by the instance stores, go to the Amazon Elastic Compute Cloud DeveloperGuide.
Request Parameters
Name Description Required
VolumeId The ID of the Amazon EBS volume. The volume andinstance must be within the same Availability Zone andthe instance must be running.
Type: String
Default: None
Yes
InstanceId The ID of the instance to which the volume attaches.The volume and instance must be within the sameAvailability Zone and the instance must be running.
Type: String
Default: None
Yes
Device Specifies how the device is exposed to the instance(e.g., /dev/sdh).
Type: String
Default: None
Yes
Response Elements
Name Description
AttachVolumeResponseType AttachVolumeResponseType element.
Type: AttachVolumeResponseType (p. 285)
Ancestor: None
Children: requestId, volumeId, instanceId, device,status, and attachTime
requestId The ID of the request.
Type: xsd:string
Ancestor: AttachVolumeResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1517
Name Description
volumeId The ID of the volume.
Type: xsd:string
Ancestor: AttachVolumeResponseType
Children: None
instanceId The ID of the instance.
Type: xsd:string
Ancestor: AttachVolumeResponseType
Children: None
device The device as it is exposed to the instance.
Type: xsd:string
Ancestor: AttachVolumeResponseType
Children: None
status Attachment state (e.g., "attaching", "attached", "detaching","detached").
Type: xsd:string
Ancestor: AttachVolumeResponseType
Children: None
attachTime Time stamp when the attachment was initiated.
Type: xsd:dateTime
Ancestor: AttachVolumeResponseType
Children: None
Examples
Example RequestThis example attaches volume vol-4d826724 to instance i-6058a509 and exposes it as /dev/sdh.For information on standard storage locations, go to the Amazon Elastic Compute Cloud DeveloperGuide.
https://ec2.amazonaws.com/?Action=AttachVolume&VolumeId=vol-4d826724&InstanceId=i-6058a509&Device=/dev/sdh&AuthParams
Example Response<AttachVolumeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <volumeId>vol-4d826724</volumeId> <instanceId>i-6058a509</instanceId> <device>/dev/sdh</device> <status>attaching</status> <attachTime>2008-05-07T11:51:50.000Z</attachTime></AttachVolumeResponse>
Related Operations• CreateVolume (p. 39)
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1518
• DeleteVolume (p. 48)
• DescribeVolumes (p. 91)
• DetachVolume (p. 94)
Amazon Elastic Compute Cloud API ReferenceAuthorizeSecurityGroupIngress
API Version 2009-07-1519
AuthorizeSecurityGroupIngress
DescriptionAdds permissions to a security group.
Permissions are specified by the IP protocol (TCP, UDP or ICMP), the source of the request (by IPrange or an Amazon EC2 user-group pair), the source and destination port ranges (for TCP and UDP),and the ICMP codes and types (for ICMP). When authorizing ICMP, -1 can be used as a wildcard inthe type and code fields.
Permission changes are propagated to instances within the security group as quickly as possible.However, depending on the number of instances, a small delay might occur.
When authorizing a user/group pair permission, GroupName, SourceSecurityGroupName andSourceSecurityGroupOwnerId must be specified. When authorizing a CIDR IP permission,GroupName, IpProtocol, FromPort, ToPort and CidrIp must be specified. Mixing these two typesof parameters is not allowed.
Request Parameters
Name Description Required
UserId AWS Access Key ID.
Type: String
Default: None
Yes
GroupName Name of the group to modify. The name must be validand belong to the account
Type: String
Default: None
Yes
IpProtocol IP protocol.
Type: String
Default: None
Valid Values: tcp | udp | icmp
Yes
FromPort Start of port range for the TCP and UDP protocols,or an ICMP type number. An ICMP type number of -1indicates a wildcard (i.e., any ICMP type number).
Type: Integer
Default: None
Yes
ToPort End of port range for the TCP and UDP protocols, oran ICMP code. An ICMP code of -1 indicates a wildcard(i.e., any ICMP code).
Type: Integer
Default: None
Yes
UserId AWS User ID of an account.
Type: String
Default: None
Yes
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-1520
Name Description Required
GroupName Name of the security group.
Type: String
Default: None
Yes
CidrIp CIDR range.
Type: String
Default: None
Constraints: Valid CIDR IP address range.
Yes
Response Elements
Name Description
AuthorizeSecurityGroupIngressResponseTypeAuthorizeSecurityGroupIngressResponseType element.
Type: AuthorizeSecurityGroupIngressResponseType (p. 287)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: AuthorizeSecurityGroupIngressResponseType
Children: None
return Returns "true" if request is successful; otherwise "false".
Type: xsd:boolean
Ancestor: AuthorizeSecurityGroupIngressResponseType
Children: None
Examples
Example Request
This example grants TCP port 80 access from the 205.192.0.0/16 address range to the websrvsecurity group.
https://ec2.amazonaws.com/?Action=AuthorizeSecurityGroupIngress&GroupName=websrv&IpProtocol=tcp&FromPort=80&ToPort=80&CidrIp=205.192.0.0/16&AuthParams
Example Response
<AuthorizeSecurityGroupIngressResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></AuthorizeSecurityGroupIngressResponse>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1521
Related Operations• CreateSecurityGroup (p. 35)
• DescribeSecurityGroups (p. 85)
• RevokeSecurityGroupIngress (p. 117)
• DeleteSecurityGroup (p. 44)
Amazon Elastic Compute Cloud API ReferenceBundleInstance
API Version 2009-07-1522
BundleInstance
DescriptionBundles the Windows instance. This procedure is not applicable for Linux and UNIX instances. Formore information, go to the Amazon Elastic Compute Cloud Developer Guide or Amazon ElasticCompute Cloud Getting Started Guide.
Note
During bundling, only the root store (C:\) is bundled. Data on other instance stores is notpreserved.
Request Parameters
Name Description Required
InstanceId The ID of the instance to bundle.
Type: String
Default: None
Yes
Storage.S3.Bucket The bucket in which to store the AMI. You can specifya bucket that you already own or a new bucket thatAmazon EC2 creates on your behalf. If you specify abucket that belongs to someone else, Amazon EC2returns an error.
Type: String
Default: None
Yes
Storage.S3.Prefix Specifies the beginning of the file name of the AMI.
Type: String
Default: None
Yes
Storage.S3.AWSAccessKeyIdThe Access Key ID of the owner of the Amazon S3bucket.
Type: String
Default: None
Yes
Storage.S3.UploadPolicyAn Amazon S3 upload policy that gives Amazon EC2permission to upload items into Amazon S3 on theuser's behalf. For more information on bundling inWindows, go to the
Type: String
Default: None
Yes
Storage.S3.UploadPolicySignatureThe signature of the Base64 encoded JSON document.
Type: String
Default: None
Yes
Amazon Elastic Compute Cloud API ReferenceJSON Parameters
API Version 2009-07-1523
JSON ParametersThe upload policy gives Amazon EC2 limited permission to upload items into your Amazon S3bucket. The following table describes the required parameters for the upload policy JSON document.Parameter names are case sensitive. For more information about upload policies and how to signthem, go to the Amazon Elastic Compute Cloud Developer Guide.
Name Description Required
expiration The expiration of the policy. We recommend 12hours or longer.
Yes
conditions A list of restrictions on what can be uploaded toAmazon S3. Must contain the bucket and ACLconditions in this table.
Yes
bucket The bucket to store the AMI. Yes
acl This must be set to ec2-bundle-read. Yes
Response Elements
Name Description
BundleInstanceResponseTypeBundleInstanceResponseType element.
Type: BundleInstanceResponseType (p. 291)
Ancestor: None
Children: requestId, bundleInstanceTask
requestId The ID of the request.
Type: xsd:string
Ancestor: BundleInstanceResponseType
Children: None
bundleInstanceTask Bundle task.
Type: BundleInstanceTaskType (p. 294)
Ancestor: BundleInstanceResponseType
Children: instanceId, bundleId, state, startTime,updateTime, storage, progress, and error
instanceId Instance associated with this bundle task.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
bundleId Identifier for this task.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-1524
Name Description
state The state of the task.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
startTime The time this task started.
Type: xsd:dateTime
Ancestor: bundleInstanceTask
Children: None
updateTime The time of the most recent update for the task.
Type: xsd:dateTime
Ancestor: bundleInstanceTask
Children: None
storage Amazon S3 storage locations.
Type: BundleInstanceTaskStorageType (p. 293)
Ancestor: bundleInstanceTask
Children: S3
S3 Amazon S3 storage location.
Type: BundleInstanceS3StorageType (p. 291)
Ancestor: storage
Children: bucket, prefix, awsAccessKeyId, uploadPolicy,and uploadPolicySignature
bucket The bucket in which to store the AMI. You can specify a bucketthat you already own or a new bucket that Amazon EC2 createson your behalf. If you specify a bucket that belongs to someoneelse, Amazon EC2 returns an error.
Type: xsd:string
Ancestor: S3
Children: None
prefix Specifies the beginning of the file name of the AMI.
Type: xsd:string
Ancestor: S3
Children: None
awsAccessKeyId The Access Key ID of the owner of the Amazon S3 bucket.
Type: xsd:string
Ancestor: S3
Children: None
uploadPolicy An Amazon S3 upload policy that gives Amazon EC2 permissionto upload items into Amazon S3 on the user's behalf. For moreinformation on bundling in Windows, go to the
Type: xsd:string
Ancestor: S3
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1525
Name Description
uploadPolicySignature The signature of the Base64 encoded JSON document.
Type: xsd:string
Ancestor: S3
Children: None
progress A percentage description of the progress of the task, such as 20%.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
error If the task fails, a description of the error.
Type: BundleInstanceTaskErrorType (p. 292)
Ancestor: bundleInstanceTask
Children: code, message
code Error code.
Type: xsd:string
Ancestor: error
Children: None
message Error message.
Type: xsd:string
Ancestor: error
Children: None
Examples
Example RequestThis example bundles the i-e468cd8d instance.
https://ec2.amazonaws.com/?Action=BundleInstance&InstanceId=-i-e468cd8d&Storage.S3.AWSAccessKeyId=10QMXFEV71ZS32XQFTR2&Storage.S3.Bucket=my-bucket&Storage.S3.Prefix=winami&Storage.S3.UploadPolicy=eyJleHBpcmF0aW9uIjogIjIwMDgtMDgtMzBUMDg6NDk6MDlaIiwiY29uZGl0aW9ucyI6IFt7ImJ1Y2tldCI6ICJteS1idWNrZXQifSxbInN0YXJ0cy13aXRoIiwgIiRrZXkiLCAibXktbmV3LWltYWdlIl1dfQ%3D%3D&Storage.S3.UploadPolicySignature=w6BZu2oxGsiiLZnoBmQSErotuMA%3D&AuthParams
Example Response<BundleInstanceResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <requestId>bun-c1a540a8</requestId> <bundleInstanceTask> <instanceId>i-12345678</instanceId> <bundleId>bun-c1a540a8</bundleId> <state>bundling</state> <startTime>2008-10-07T11:41:50.000Z</startTime> <updateTime>2008-10-07T11:51:50.000Z</updateTime> <progress>70%</progress> <storage>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1526
<S3> <bucket>my-bucket</bucket> <prefix>winami</prefix> </S3> </storage> </bundleInstanceTask></BundleInstanceResponse>
Related Operations• CancelBundleTask (p. 27)
• DescribeBundleTasks (p. 57)
Amazon Elastic Compute Cloud API ReferenceCancelBundleTask
API Version 2009-07-1527
CancelBundleTask
DescriptionCancels an Amazon EC2 bundling operation. For more information on bundling instances, go to theAmazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud Getting StartedGuide.
Request Parameters
Name Description Required
BundleId The ID of the bundle task to cancel.
Type: String
Default: None
Yes
Response Elements
Name Description
CancelBundleTaskResponseTypeCancelBundleTaskResponseType element.
Type: CancelBundleTaskResponseType (p. 295)
Ancestor: None
Children: requestId, bundleInstanceTask
requestId The ID of the request.
Type: xsd:string
Ancestor: CancelBundleTaskResponseType
Children: None
bundleInstanceTask Bundle task to cancel.
Type: BundleInstanceTaskType (p. 294)
Ancestor: CancelBundleTaskResponseType
Children: instanceId, bundleId, state, startTime,updateTime, storage, progress, and error
instanceId Instance associated with this bundle task.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
bundleId Identifier for this task.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
state The state of the task.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-1528
Name Description
startTime The time this task started.
Type: xsd:dateTime
Ancestor: bundleInstanceTask
Children: None
updateTime The time of the most recent update for the task.
Type: xsd:dateTime
Ancestor: bundleInstanceTask
Children: None
storage Amazon S3 storage locations.
Type: BundleInstanceTaskStorageType (p. 293)
Ancestor: bundleInstanceTask
Children: S3
S3 Amazon S3 storage location.
Type: BundleInstanceS3StorageType (p. 291)
Ancestor: storage
Children: bucket, prefix, awsAccessKeyId, uploadPolicy,and uploadPolicySignature
bucket The bucket in which to store the AMI. You can specify a bucketthat you already own or a new bucket that Amazon EC2 createson your behalf. If you specify a bucket that belongs to someoneelse, Amazon EC2 returns an error.
Type: xsd:string
Ancestor: S3
Children: None
prefix Specifies the beginning of the file name of the AMI.
Type: xsd:string
Ancestor: S3
Children: None
awsAccessKeyId The Access Key ID of the owner of the Amazon S3 bucket.
Type: xsd:string
Ancestor: S3
Children: None
uploadPolicy An Amazon S3 upload policy that gives Amazon EC2 permissionto upload items into Amazon S3 on the user's behalf. For moreinformation on bundling in Windows, go to the
Type: xsd:string
Ancestor: S3
Children: None
uploadPolicySignature The signature of the Base64 encoded JSON document.
Type: xsd:string
Ancestor: S3
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1529
Name Description
progress A percentage description of the progress of the task, such as 20%.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
error If the task fails, a description of the error.
Type: BundleInstanceTaskErrorType (p. 292)
Ancestor: bundleInstanceTask
Children: code, message
code Error code.
Type: xsd:string
Ancestor: error
Children: None
message Error message.
Type: xsd:string
Ancestor: error
Children: None
Examples
Example Request
This example cancels the bun-cla322b9 bundle task.
https://ec2.amazonaws.com/?Action=CancelBundleTask&BundleId=bun-cla322b9&AuthParams
Example Response
<CancelBundleTaskResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <bundleInstanceTask> <instanceId>i-12345678</instanceId> <bundleId>bun-cla322b9</bundleId> <state>canceling</state> <startTime>2008-10-07T11:41:50.000Z</startTime> <updateTime>2008-10-07T11:51:50.000Z</updateTime> <progress>20%</progress> <storage> <S3> <bucket>my-bucket</bucket> <prefix>my-new-image</prefix> </S3> </storage> </bundleInstanceTask></CancelBundleTaskResponse>
Related Operations• BundleInstance (p. 22)
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1530
• DescribeBundleTasks (p. 57)
Amazon Elastic Compute Cloud API ReferenceConfirmProductInstance
API Version 2009-07-1531
ConfirmProductInstance
DescriptionVerifies whether a Amazon DevPay product code is associated with an instance. This can only beexecuted by the owner of the AMI and is useful when an AMI owner wants to verify whether a user'sinstance is eligible for support.
Request Parameters
Name Description Required
ProductCode The product code to confirm.
Type: String
Default: None
Yes
InstanceId The instance to confirm.
Type: String
Default: None
Yes
Response Elements
Name Description
ConfirmProductInstanceResponseTypeConfirmProductInstanceResponseType element.
Type: ConfirmProductInstanceResponseType (p. 296)
Ancestor: None
Children: requestId, return, and ownerId
requestId The ID of the request.
Type: xsd:string
Ancestor: ConfirmProductInstanceResponseType
Children: None
return Returns "true" if the product code is attached to the instance;otherwise "false".
Type: xsd:boolean
Ancestor: ConfirmProductInstanceResponseType
Children: None
ownerId The instance owner's account ID. Only present if the product codeis attached to the instance.
Type: xsd:string
Ancestor: ConfirmProductInstanceResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1532
Examples
Example RequestThis example describes the confirms the product code is associated with the instance.
https://ec2.amazonaws.com/?Action=ConfirmProductInstance&ProductCode=774F4FF8&InstanceId=i-10a64379&AuthParams
Example Response<ConfirmProductInstanceResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return> <ownerId>254933287430</ownerId></ConfirmProductInstanceResponse>
Related Operations• DescribeInstances (p. 69)
• RunInstances (p. 120)
Amazon Elastic Compute Cloud API ReferenceCreateKeyPair
API Version 2009-07-1533
CreateKeyPair
DescriptionCreates a new 2048-bit RSA key pair with the specified name. The public key is stored by AmazonEC2 and the private key is displayed on the console. The private key is returned as an unencryptedPEM encoded PKCS#8 private key. If a key with the specified name already exists, Amazon EC2returns an error.
Request Parameters
Name Description Required
KeyName A unique name for the key pair.
Type: String
Default: None
Constraints: Accepts alphanumeric characters, spaces,dashes, and underscores.
Yes
Response Elements
Name Description
CreateKeyPairResponseType CreateKeyPairResponseType element.
Type: CreateKeyPairResponseType (p. 297)
Ancestor: None
Children: requestId, keyName, keyFingerprint, andkeyMaterial
requestId The ID of the request.
Type: xsd:string
Ancestor: CreateKeyPairResponseType
Children: None
keyName The key pair name provided in the original request.
Type: xsd:string
Ancestor: CreateKeyPairResponseType
Children: None
keyFingerprint A SHA-1 digest of the DER encoded private key.
Type: xsd:string
Ancestor: CreateKeyPairResponseType
Children: None
keyMaterial An unencrypted PEM encoded RSA private key.
Type: xsd:string
Ancestor: CreateKeyPairResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1534
Examples
Example RequestThis example creates a key pair named gsg-keypair.
https://ec2.amazonaws.com/?Action=CreateKeyPair&KeyName=gsg-keypair.&AuthParams
Example Response<CreateKeyPairResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <keyName>gsg-keypair</keyName> <keyFingerprint>1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca:9f:f5:f1:6f</keyFingerprint> <keyMaterial>-----BEGIN RSA PRIVATE KEY-----MIIEoQIBAAKCAQBuLFg5ujHrtm1jnutSuoO8Xe56LlT+HM8v/xkaa39EstM3/aFxTHgElQiJLChpHungXQ29VTc8rc1bW0lkdi23OH5eqkMHGhvEwqa0HWASUMll4o3o/IX+0f2UcPoKCOVUR+jx71Sg5AU52EQfanIn3ZQ8lFW7Edp5a3q4DhjGlUKToHVbicL5E+g45zfB95wIyywWZfeW/UUF3LpGZyq/ebIUlq1qTbHkLbCC2r7RTn8vpQWp47BGVYGtGSBMpTRP5hnbzzuqj3itkiLHjU39S2sJCJ0TrJx5i8BygR4s3mHKBj8l+ePQxG1kGbF6R4yg6sECmXn17MRQVXODNHZbAgMBAAECggEAY1tsiUsIwDl591CXirkYGuVfLyLflXenxfI50mDFms/mumTqloHO7tr0oriHDR5K7wMcY/YY5YkcXNo7mvUVD1pMZNUJs7rw9gZRTrf7LylaJ58kOcyajw8TsC4e4LPbFaHwS1d6K8rXh64o6WgW4SrsB6ICmr1kGQI73wcfgt5ecIu4TZf0OE9IHjn+2eRlsrjBdeORi7KiUNC/pAG23I6MdDOFEQRcCSigCj+4/mciFUSASWS4dMbrpb9FNSIcf9dcLxVM7/6KxgJNfZc9XWzUw77Jg8x92Zd0fVhHOux5IZC+UvSKWB4dyfcItE8C3p9bbU9VGyY5vLCAiIb4qQKBgQDLiO24GXrIkswF32YtBBMuVgLGCwU9h9HlO9mKAc2m8Cm1jUE5IpzRjTedc9I2qiIMUTwtgnw42auSCzbUeYMURPtDqyQ7p6AjMujp9EPemcSVOK9vXYL0PtcoxW9MC0dtV6iPkCN7gOqiZXPRKaFbWADp16p8UAIvS/a5XXk5jwKBgQCKkpHi2EISh1uRkhxljyWCiDCiK6JBRsMvpLbc0v5dKwP5alo1fmdR5PJaV2qvZSj5CYNpMAy1/EDNTY5OSIJU+0KFmQbyhsbmrdLNLDL4+TcnT7c62/aH01ohYaf/VCbRhtLlBfqGoQc7+sAc8vmKkesnF7CqCEKDyF/dhrxYdQKBgC0iZzzNAapayz1+JcVTwwEid6j9JqNXbBc+Z2YwMi+T0Fv/P/hwkX/ypeOXnIUcw0Ih/YtGBVACDQbsz7LcY1HqXiHKYNWNvXgwwO+oiChjxvEkSdsTTIfnK4VSCvU9BxDbQHjdiNDJbL6oar92UN7VrBYvChJZF7LvUH4YmVpHAoGAbZ2X7XvoeEO+uZ58/BGKOIGHByHBDiXtzMhdJr15HTYjxK7OgTZmgK+8zp4L9IbvLGDMJO8vft32XPEWuvI8twCzFH+CsWLQADZMZKSsBasOZ/h1FwhdMgCMcY+Qlzd4JZKjTSu3i7vhvx6RzdSedXEMNTZWN4qlIx3kR5aHcukCgYA9T+Zrvm1F0seQPbLknn7EqhXIjBaTP8TTvW/6bdPi23ExzxZn7KOdrfclYRph1LHMpAONv/x2xALIf91UB+v5ohy1oDoasL0gij1houRe2ERKKdwz0ZL9SWq6VTdhr/5G994CK72fy5WhyERbDjUIdHaK3M849JJuf8cSrvSb4g==-----END RSA PRIVATE KEY-----</keyMaterial></CreateKeyPairResponse>
Related Operations• RunInstances (p. 120)
• DescribeKeyPairs (p. 75)
• DeleteKeyPair (p. 42)
Amazon Elastic Compute Cloud API ReferenceCreateSecurityGroup
API Version 2009-07-1535
CreateSecurityGroup
DescriptionCreates a new security group. Group names must be unique per account.
Every instance is launched in a security group. If no security group is specified during launch, theinstances are launched in the default security group. Instances within the same security group haveunrestricted network access to each other. Instances will reject network access attempts from otherinstances in a different security group. As the owner of instances you can grant or revoke specificpermissions using the AuthorizeSecurityGroupIngress and RevokeSecurityGroupIngressoperations.
Request Parameters
Name Description Required
GroupName Name of the security group.
Type: String
Default: None
Constraints: Accepts alphanumeric characters, spaces,dashes, and underscores.
Yes
GroupDescription Description of the group. This is informational only. Ifthe description contains spaces, you must enclose it insingle quotes (') or URL-encode it.
Type: String
Default: None
Constraints: Accepts alphanumeric characters, spaces,dashes, and underscores.
Yes
Response Elements
Name Description
CreateSecurityGroupResponseTypeCreateSecurityGroupResponseType element.
Type: CreateSecurityGroupResponseType (p. 298)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: CreateSecurityGroupResponseType
Children: None
return Returns "true" if creation succeeded; otherwise "false".
Type: xsd:boolean
Ancestor: CreateSecurityGroupResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1536
Examples
Example RequestThis example creates the websrv security group.
https://ec2.amazonaws.com/?Action=CreateSecurityGroup&GroupName=websrv&GroupDescription='Web Servers'&AuthParams
Example Response<CreateSecurityGroupResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></CreateSecurityGroupResponse>
Related Operations• RunInstances (p. 120)
• DescribeSecurityGroups (p. 85)
• AuthorizeSecurityGroupIngress (p. 19)
• RevokeSecurityGroupIngress (p. 117)
• DeleteSecurityGroup (p. 44)
Amazon Elastic Compute Cloud API ReferenceCreateSnapshot
API Version 2009-07-1537
CreateSnapshot
DescriptionCreates a snapshot of an Amazon EBS volume and stores it in Amazon S3. You can use snapshotsfor backups, to make identical copies of instance devices, and to save data before shutting downan instance. For more information about Amazon EBS, go to the Amazon Elastic Compute CloudDeveloper Guide.
When taking a snapshot of a file system, we recommend unmounting it first. This ensures thefile system metadata is in a consistent state, that the 'mounted indicator' is cleared, and that allapplications using that file system are stopped and in a consistent state. Some file systems, such asxfs, can freeze and unfreeze activity so a snapshot can be made without unmounting.
For Linux/UNIX, enter the following command from the command line.
# umount -d /dev/sdh
For Windows, open Disk Management, right-click the volume to unmount, and select Change DriveLetter and Path. Then, select the mount point to remove and click Remove.
Request Parameters
Name Description Required
VolumeId The ID of the Amazon EBS volume to take a snapshotof.
Type: String
Default: None
Yes
Response Elements
Name Description
CreateSnapshotResponseTypeCreateSnapshotResponseType element.
Type: CreateSnapshotResponseType (p. 299)
Ancestor: None
Children: requestId, snapshotId, volumeId, status,startTime, and progress
requestId The ID of the request.
Type: xsd:string
Ancestor: CreateSnapshotResponseType
Children: None
snapshotId The ID of the snapshot.
Type: xsd:string
Ancestor: CreateSnapshotResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1538
Name Description
volumeId The ID of the volume.
Type: xsd:string
Ancestor: CreateSnapshotResponseType
Children: None
status Snapshot state (e.g., "pending", "completed", "error")
Type: xsd:string
Ancestor: CreateSnapshotResponseType
Children: None
startTime Time stamp when the snapshot was initiated.
Type: xsd:dateTime
Ancestor: CreateSnapshotResponseType
Children: None
progress The progress of the snapshot, in percentage.
Type: xsd:string
Ancestor: CreateSnapshotResponseType
Children: None
Examples
Example RequestThis example creates a snapshot of volume vol-4d826724.
https://ec2.amazonaws.com/?Action=CreateSnapshot&VolumeId=vol-4d826724&AuthParams
Example Response<CreateSnapshotResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <snapshotId>snap-78a54011</snapshotId> <volumeId>vol-4d826724</volumeId> <status>pending</status> <startTime>2008-05-07T12:51:50.000Z</startTime> <progress>60%</progress></CreateSnapshotResponse>
Related Operations• DeleteSnapshot (p. 46)
• DescribeSnapshots (p. 89)
Amazon Elastic Compute Cloud API ReferenceCreateVolume
API Version 2009-07-1539
CreateVolume
DescriptionCreates a new Amazon EBS volume to which any Amazon EC2 instance can attach within the sameAvailability Zone. For more information about Amazon EBS, go to the Amazon Elastic Compute CloudDeveloper Guide.
Note
You must specify an Availability Zone when creating a volume. The volume and the instance towhich it attaches must be in the same Availability Zone.
Request Parameters
Name Description Required
Size The size of the volume, in GiBs. Required if you are notcreating a volume from a snapshot.
Type: String
Default: None
Valid Values: 1 -1024
Yes
SnapshotId The snapshot from which to create the new volume.
Type: String
Default: None
No
AvailabilityZone The Availability Zone in which to create the new volume.
Type: String
Default: None
Yes
Response Elements
Name Description
CreateVolumeResponseType CreateVolumeResponseType element.
Type: CreateVolumeResponseType (p. 300)
Ancestor: None
Children: requestId, volumeId, size, snapshotId,availabilityZone, status, and createTime
requestId The ID of the request.
Type: xsd:string
Ancestor: CreateVolumeResponseType
Children: None
volumeId The ID of the volume.
Type: xsd:string
Ancestor: CreateVolumeResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1540
Name Description
size The size of the volume, in GiBs.
Type: xsd:string
Ancestor: CreateVolumeResponseType
Children: None
snapshotId Snapshot from which the volume was created, if applicable.
Type: xsd:string
Ancestor: CreateVolumeResponseType
Children: None
availabilityZone Availability Zone in which the volume was created.
Type: xsd:string
Ancestor: CreateVolumeResponseType
Children: None
status Volume state (e.g., "creating", "available", "in-use", "deleting","error")
Type: xsd:string
Ancestor: CreateVolumeResponseType
Children: None
createTime Time stamp when volume creation was initiated.
Type: xsd:dateTime
Ancestor: CreateVolumeResponseType
Children: None
Examples
Example Request
This example creates a new 800 GiB volume in Availability Zone us-east-1a.
https://ec2.amazonaws.com/?Action=CreateVolume&Size=800&AvailabilityZone=us-east-1a&AuthParams
Example Response
<CreateVolumeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <volumeId>vol-4d826724</volumeId> <size>800</size> <status>creating</status> <createTime>2008-05-07T11:51:50.000Z</createTime> <availabilityZone>us-east-1a</availabilityZone> <snapshotId></snapshotId></CreateVolumeResponse>
Related Operations• DeleteVolume (p. 48)
• DescribeVolumes (p. 91)
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1541
• AttachVolume (p. 16)
• DetachVolume (p. 94)
• DescribeAvailabilityZones (p. 54)
Amazon Elastic Compute Cloud API ReferenceDeleteKeyPair
API Version 2009-07-1542
DeleteKeyPair
DescriptionDeletes the specified key pair, by removing the public key from Amazon EC2. You must own the keypair.
Request Parameters
Name Description Required
KeyName Name of the key pair to delete.
Type: String
Default: None
Yes
Response Elements
Name Description
DeleteKeyPairResponseType DeleteKeyPairResponseType element.
Type: DeleteKeyPairResponseType (p. 302)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: DeleteKeyPairResponseType
Children: None
return Returns "true" if deletion succeeded; otherwise "false".
Type: xsd:boolean
Ancestor: DeleteKeyPairResponseType
Children: None
Examples
Example Request
This example deletes the gsg-keypair key pair.
https://ec2.amazonaws.com/?Action=DeleteKeyPair&KeyName=gsg-keypair&AuthParams
Example Response
<DeleteKeyPairResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></DeleteKeyPairResponse>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1543
Related Operations• CreateKeyPair (p. 33)
• DescribeKeyPairs (p. 75)
Amazon Elastic Compute Cloud API ReferenceDeleteSecurityGroup
API Version 2009-07-1544
DeleteSecurityGroup
DescriptionDeletes a security group that you own.
Note
If you attempt to delete a security group that contains instances, a fault is returned.
If you attempt to delete a security group that is referenced by another security group, a fault isreturned. For example, if security group B has a rule that allows access from security group A,security group A cannot be deleted until the allow rule is removed.
Request Parameters
Name Description Required
GroupName Name of the security group to delete.
Type: String
Default: None
Yes
Response Elements
Name Description
DeleteSecurityGroupResponseTypeDeleteSecurityGroupResponseType element.
Type: DeleteSecurityGroupResponseType (p. 303)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: DeleteSecurityGroupResponseType
Children: None
return Returns "true" if deletion succeeded; otherwise "false".
Type: xsd:boolean
Ancestor: DeleteSecurityGroupResponseType
Children: None
Examples
Example Request
This example deletes the websrv security group.
https://ec2.amazonaws.com/?Action=DeleteSecurityGroup&GroupName=websrv&AuthParams
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1545
Example Response<DeleteSecurityGroupResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></DeleteSecurityGroupResponse>
Related Operations• CreateSecurityGroup (p. 35)
• DescribeSecurityGroups (p. 85)
• AuthorizeSecurityGroupIngress (p. 19)
• RevokeSecurityGroupIngress (p. 117)
Amazon Elastic Compute Cloud API ReferenceDeleteSnapshot
API Version 2009-07-1546
DeleteSnapshot
DescriptionDeletes a snapshot of an Amazon EBS volume that you own. For more information, go to the AmazonElastic Compute Cloud Developer Guide.
Request Parameters
Name Description Required
SnapshotId The ID of the Amazon EBS snapshot to delete.
Type: String
Default: None
Yes
Response Elements
Name Description
DeleteSnapshotResponseTypeDeleteSnapshotResponseType element.
Type: DeleteSnapshotResponseType (p. 304)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: DeleteSnapshotResponseType
Children: None
return Returns "true" if deletion succeeded; otherwise "false".
Type: xsd:boolean
Ancestor: DeleteSnapshotResponseType
Children: None
Examples
Example Request
This example deletes snapshot snap-78a54011.
https://ec2.amazonaws.com/?Action=DeleteSnapshot&SnapshotId.1=snap-78a54011&AuthParams
Example Response
<DeleteSnapshotResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></DeleteSnapshotResponse>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1547
Related Operations• CreateSnapshot (p. 37)
• DescribeSnapshots (p. 89)
Amazon Elastic Compute Cloud API ReferenceDeleteVolume
API Version 2009-07-1548
DeleteVolume
DescriptionDeletes an Amazon EBS volume that you own. For more information about Amazon EBS, go to theAmazon Elastic Compute Cloud Developer Guide.
Note
The volume remains in the deleting state for several minutes after you enter this command.
Request Parameters
Name Description Required
VolumeId The ID of the volume to delete. The volume remains inthe "deleting" state for several minutes after entering thiscommand.
Type: String
Default: None
Yes
Response Elements
Name Description
DeleteVolumeResponseType DeleteVolumeResponseType element.
Type: DeleteVolumeResponseType (p. 304)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: DeleteVolumeResponseType
Children: None
return Returns "true" if deletion succeeded; otherwise "false".
Type: xsd:boolean
Ancestor: DeleteVolumeResponseType
Children: None
Examples
Example Request
This example deletes volume vol-4282672b.
https://ec2.amazonaws.com/?Action=DeleteVolume&VolumeId=vol-4282672b&AuthParams
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1549
Example Response<DeleteVolumeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></DeleteVolumeResponse>
Related Operations• CreateVolume (p. 39)
• DescribeVolumes (p. 91)
• AttachVolume (p. 16)
• DetachVolume (p. 94)
Amazon Elastic Compute Cloud API ReferenceDeregisterImage
API Version 2009-07-1550
DeregisterImage
DescriptionDeregisters the specified AMI. Once deregistered, the AMI cannot be used to launch new instances.
Note
This command does not delete the AMI from Amazon S3.
Request Parameters
Name Description Required
ImageId Unique ID of the AMI which was assigned duringregistration. To register an AMI, use "RegisterImage". Toview the AMI IDs of AMIs that belong to your account.use "DescribeImages".
Type: String
Default: None
Yes
Response Elements
Name Description
DeregisterImageResponseTypeDeregisterImageResponseType element.
Type: DeregisterImageResponseType (p. 305)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: DeregisterImageResponseType
Children: None
return Returns "true" if deregistration succeeded; otherwise "false".
Type: xsd:boolean
Ancestor: DeregisterImageResponseType
Children: None
Examples
Example Request
This example deregisters the ami-4fa54026 AMI.
https://ec2.amazonaws.com/?Action=DeregisterImage&ImageId=ami-4fa54026&AuthParams
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1551
Example Response<DeregisterImageResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></DeregisterImageResponse>
Related Operations• RegisterImage (p. 111)
• DescribeImages (p. 65)
Amazon Elastic Compute Cloud API ReferenceDescribeAddresses
API Version 2009-07-1552
DescribeAddresses
DescriptionLists elastic IP addresses assigned to your account or provides information about a specific address.
Request Parameters
Name Description Required
PublicIp.n Elastic IP address to describe.
Type: String
Default: None
No
Response Elements
Name Description
DescribeAddressesResponseTypeDescribeAddressesResponseType element.
Type: DescribeAddressesResponseType (p. 308)
Ancestor: None
Children: requestId, addressesSet
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeAddressesResponseType
Children: None
addressesSet The set of IP addresses.
Type: DescribeAddressesResponseInfoType (p. 307)
Ancestor: DescribeAddressesResponseType
Children: item
item Information about an instance.
Type: DescribeAddressesResponseItemType (p. 308)
Ancestor: addressesSet
Children: publicIp, instanceId
publicIp The public IP address.
Type: xsd:string
Ancestor: item
Children: None
instanceId The ID of the instance.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1553
Examples
Example RequestThis example describes elastic IP addresses assigned to the account. Amazon EC2 returns67.202.55.255 which is assigned to instance i-f15ebb98 and 67.202.55.233 which is not assigned to aninstance.
https://ec2.amazonaws.com/?Action=DescribeAddresses&PublicIp.1=67.202.55.255&PublicIp.1=67.202.55.233&AuthParams
Example Response<DescribeAddressesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <addressesSet> <item> <instanceId>i-f15ebb98</instanceId> <publicIp>67.202.55.255</publicIp> </item> <item> <publicIp>67.202.55.233</publicIp> </item> </addressesSet> </DescribeAddressesResponse>
Related Operations• AllocateAddress (p. 12)
• ReleaseAddress (p. 113)
Amazon Elastic Compute Cloud API ReferenceDescribeAvailabilityZones
API Version 2009-07-1554
DescribeAvailabilityZones
DescriptionDisplays Availability Zones that are currently available to the account and their states.
Note
Availability Zones are not the same across accounts. The Availability Zone us-east-1a foraccount A is not necessarily the same as us-east-1a for account B. Zone assignments aremapped independently for each account.
Request Parameters
Name Description Required
ZoneName Availability Zone name.
Type: String
Default: None
No
Response Elements
Name Description
DescribeAvailabilityZonesResponseTypeDescribeAvailabilityZonesResponseType element.
Type: DescribeAvailabilityZonesResponseType (p. 309)
Ancestor: None
Children: requestId, availabilityZoneInfo
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeAvailabilityZonesResponseType
Children: None
availabilityZoneInfo Availability Zone information.
Type: AvailabilityZoneSetType (p. 289)
Ancestor: DescribeAvailabilityZonesResponseType
Children: item
item Information for one Availability Zone.
Type: AvailabilityZoneItemType (p. 288)
Ancestor: availabilityZoneInfo
Children: zoneName, zoneState, regionName, andmessageSet
zoneName Name of the Availability Zone.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1555
Name Description
zoneState State of the Availability Zone.
Type: xsd:string
Ancestor: item
Children: None
regionName Name of the region.
Type: xsd:string
Ancestor: item
Children: None
messageSet Message set.
Type: AvailabilityZoneMessageSetType (p. 288)
Ancestor: item
Children: item
item Availability Zone message set.
Type: AvailabilityZoneMessageType (p. 289)
Ancestor: messageSet
Children: message
message The Availability Zone message.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example RequestThis example displays information about Availability Zones that are available to the account.
https://ec2.amazonaws.com/?Action=DescribeAvailabilityZones&ZoneName.0=us-east-1a&ZoneName.1=us-east-1b&ZoneName.2=us-east-1c&ZoneName.3=us-east-1d&AuthParams
Example Response<DescribeAvailabilityZonesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <availabilityZoneInfo> <item> <zoneName>us-east-1a</zoneName> <zoneState>available</zoneState> </item> <item> <zoneName>us-east-1b</zoneName> <zoneState>available</zoneState> </item> <item> <zoneName>us-east-1c</zoneName> <zoneState>available</zoneState> </item>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1556
<item> <zoneName>us-east-1d</zoneName> <zoneState>available</zoneState> </item> </availabilityZoneInfo></DescribeAvailabilityZonesResponse>
Related Operations• RunInstances (p. 120)
• DescribeRegions (p. 77)
Amazon Elastic Compute Cloud API ReferenceDescribeBundleTasks
API Version 2009-07-1557
DescribeBundleTasks
DescriptionDescribes current bundling tasks. For more information on bundling instances, go to the AmazonElastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud Getting Started Guide.
Request Parameters
Name Description Required
BundleId The ID of the bundle task to describe.
Type: String
Default: If no ID is specified, all bundle tasks aredescribed.
No
Response Elements
Name Description
DescribeBundleTasksResponseTypeDescribeBundleTasksResponseType element.
Type: DescribeBundleTasksResponseType (p. 312)
Ancestor: None
Children: requestId, bundleInstanceTasksSet
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeBundleTasksResponseType
Children: None
bundleInstanceTasksSet Bundle task set.
Type: BundleInstanceTasksSetType (p. 293)
Ancestor: DescribeBundleTasksResponseType
Children: item
item Bundle task.
Type: BundleInstanceTaskType (p. 294)
Ancestor: bundleInstanceTasksSet
Children: instanceId, bundleId, state, startTime,updateTime, storage, progress, and error
instanceId Instance associated with this bundle task.
Type: xsd:string
Ancestor: item
Children: None
bundleId Identifier for this task.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-1558
Name Description
state The state of the task.
Type: xsd:string
Ancestor: item
Children: None
startTime The time this task started.
Type: xsd:dateTime
Ancestor: item
Children: None
updateTime The time of the most recent update for the task.
Type: xsd:dateTime
Ancestor: item
Children: None
storage Amazon S3 storage locations.
Type: BundleInstanceTaskStorageType (p. 293)
Ancestor: item
Children: S3
S3 Amazon S3 storage location.
Type: BundleInstanceS3StorageType (p. 291)
Ancestor: storage
Children: bucket, prefix, awsAccessKeyId, uploadPolicy,and uploadPolicySignature
bucket The bucket in which to store the AMI. You can specify a bucketthat you already own or a new bucket that Amazon EC2 createson your behalf. If you specify a bucket that belongs to someoneelse, Amazon EC2 returns an error.
Type: xsd:string
Ancestor: S3
Children: None
prefix Specifies the beginning of the file name of the AMI.
Type: xsd:string
Ancestor: S3
Children: None
awsAccessKeyId The Access Key ID of the owner of the Amazon S3 bucket.
Type: xsd:string
Ancestor: S3
Children: None
uploadPolicy An Amazon S3 upload policy that gives Amazon EC2 permissionto upload items into Amazon S3 on the user's behalf. For moreinformation on bundling in Windows, go to the
Type: xsd:string
Ancestor: S3
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1559
Name Description
uploadPolicySignature The signature of the Base64 encoded JSON document.
Type: xsd:string
Ancestor: S3
Children: None
progress A percentage description of the progress of the task, such as 20%.
Type: xsd:string
Ancestor: item
Children: None
error If the task fails, a description of the error.
Type: BundleInstanceTaskErrorType (p. 292)
Ancestor: item
Children: code, message
code Error code.
Type: xsd:string
Ancestor: error
Children: None
message Error message.
Type: xsd:string
Ancestor: error
Children: None
Examples
Example RequestThis example describes the status of the bun-57a5403e bundle task.
https://ec2.amazonaws.com/?Action=DescribeBundleTasks&bundleId.0=bun-c1a540a8&AuthParams
Example Response<DescribeBundleTasksResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <bundleInstanceTasksSet> <item> <instanceId>i-12345678</instanceId> <bundleId>bun-c1a540a8</bundleId> <state>canceling</state> <startTime>2008-10-07T11:41:50.000Z</startTime> <updateTime>2008-10-07T11:51:50.000Z</updateTime> <progress>20%</progress> <storage> <S3> <bucket>my-bucket</bucket> <prefix>winami</prefix> </S3> </storage>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1560
</item> <bundleInstanceTasksSet></DescribeBundleTasksResponse>
Related Operations• BundleInstance (p. 22)
• CancelBundleTask (p. 27)
Amazon Elastic Compute Cloud API ReferenceDescribeImageAttribute
API Version 2009-07-1561
DescribeImageAttribute
DescriptionReturns information about an attribute of an AMI. Only one attribute can be specified per call.
Request Parameters
Name Description Required
ImageId The ID of the AMI for which an attribute will bedescribed.
Type: String
Default: None
Yes
Attribute=launchPermissionDescribes the launch permissions of the AMI.
Type: String
Default: None
No
Attribute=productCodesDescribes the product code associated with the AMI.
Type: String
Default: None
No
Attribute=kernel Describes the ID of the kernel associated with the AMI.
Type: String
Default: None
No
Attribute=ramdisk Describes the ID of the RAM disk associated with theAMI.
Type: String
Default: None
No
Attribute=blockDeviceMappingDescribes the mapping that defines native device namesto use when exposing virtual devices.
Type: String
Default: None
No
Attribute=platform Describes the operating system platform.
Type: String
Default: None
No
Response Elements
Name Description
DescribeImageAttributeResponseTypeDescribeImageAttributeResponseType element.
Type: DescribeImageAttributeResponseType (p. 313)
Ancestor: None
Children: requestId, imageId, launchPermission,productCodes, kernel, ramdisk, and blockDeviceMapping
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-1562
Name Description
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeImageAttributeResponseType
Children: None
imageId The ID of the AMI.
Type: xsd:string
Ancestor: DescribeImageAttributeResponseType
Children: None
launchPermission Launch permissions set.
Type: LaunchPermissionListType (p. 352)
Ancestor: DescribeImageAttributeResponseType
Children: item
item Information for launch permissions.
Type: LaunchPermissionItemType (p. 352)
Ancestor: launchPermission
Children: userId, group
userId User IDs associated with the launchPermission attribute.
Type: xsd:string
Ancestor: item
Children: None
group Security groups associated with the launchPermission attribute.You can specify the "all" group, which will make it a public AMI.
Type: xsd:string
Ancestor: item
Children: None
productCodes Product codes set.
Type: ProductCodeListType (p. 360)
Ancestor: DescribeImageAttributeResponseType
Children: item
item Information for one product code.
Type: ProductCodeItemType (p. 359)
Ancestor: productCodes
Children: productCode
productCode Amazon DevPay product code. Currently only one product codecan be associated with an AMI. Once set, the product code cannotbe changed or reset.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1563
Name Description
kernel Kernel set.
Type: NullableAttributeValueType (p. 358)
Ancestor: DescribeImageAttributeResponseType
Children: value
value ID of the kernel or RAM disk.
Type: xsd:string
Ancestor: kernel
Children: None
ramdisk RAM disk set.
Type: NullableAttributeValueType (p. 358)
Ancestor: DescribeImageAttributeResponseType
Children: value
value ID of the kernel or RAM disk.
Type: xsd:string
Ancestor: ramdisk
Children: None
blockDeviceMapping Block device mapping set.
Type: BlockDeviceMappingType (p. 290)
Ancestor: DescribeImageAttributeResponseType
Children: item
item Information for one block device mapping.
Type: BlockDeviceMappingItemType (p. 290)
Ancestor: blockDeviceMapping
Children: virtualName, deviceName
virtualName The virtual name.
Type: xsd:string
Ancestor: item
Children: None
deviceName The device name (e.g., /dev/sdh).
Type: xsd:string
Ancestor: item
Children: None
Examples
Example Request
This example lists the launch permissions for the ami-61a54008 AMI
https://ec2.amazonaws.com/?Action=DescribeImageAttribute&ImageId=ami-2bb65342&Attribute=launchPermission&AuthParams
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1564
Example Response<DescribeImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imageId>ami-61a54008</imageId> <launchPermission> <item> <group>all</group> </item> <item> <userId>495219933132</userId> </item> </launchPermission></DescribeImageAttributeResponse>
Example RequestThis example lists the product code for the ami-2bb65342AMI.
https://ec2.amazonaws.com/?Action=DescribeImageAttribute&ImageId=ami-2bb65342&Attribute=productCodes&AuthParams
Example Response<DescribeImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imageId>ami-61a54008</imageId> <productCodes> <item> <productCode>774F4FF8</productCode> </item> </productCodes> </DescribeImageAttributeResponse>
Related Operations• DescribeImages (p. 65)
• ModifyImageAttribute (p. 103)
• ResetImageAttribute (p. 115)
Amazon Elastic Compute Cloud API ReferenceDescribeImages
API Version 2009-07-1565
DescribeImages
DescriptionReturns information about AMIs, AKIs, and ARIs. This includes image type, product codes,architecture, and kernel and RAM disk IDs. Images available to you include public images, privateimages that you own, and private images owned by other users for which you have explicit launchpermissions.
Launch permissions fall into three categories:
LaunchPermission
Description
public The owner of the AMI granted launch permissions for the AMI to the all group.All users have launch permissions for these AMIs.
explicit The owner of the AMI granted launch permissions to a specific user.
implicit A user has implicit launch permissions for all AMIs he or she owns.
The list of AMIs returned can be modified by specifying AMI IDs, AMI owners, or users with launchpermissions. If no options are specified, Amazon EC2 returns all AMIs for which the user has launchpermissions.
If you specify one or more AMI IDs, only AMIs that have the specified IDs are returned. If you specifyan invalid AMI ID, a fault is returned. If you specify an AMI ID for which you do not have access, it willnot be included in the returned results.
If you specify one or more AMI owners, only AMIs from the specified owners and for which you haveaccess are returned. The results can include the account IDs of the specified owners, amazon for AMIsowned by Amazon or self for AMIs that you own.
If you specify a list of executable users, only users that have launch permissions for the AMIs arereturned. You can specify account IDs (if you own the AMI(s)), self for AMIs for which you own orhave explicit permissions, or all for public AMIs.
Note
Deregistered images are included in the returned results for an unspecified interval afterderegistration.
Request Parameters
Name Description Required
ExecutableBy Returns AMIs for which the specified user has explicitlaunch permissions. The user ID can be a user's accountID, "self" to return AMIs for which the sender of therequest has explicit launch permissions, or "all" to returnAMIs with public launch permissions.
Type: String
Default: None
No
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-1566
Name Description Required
ImageId AMI IDs to describe.
Type: String
Default: Returns all AMIs.
No
Owner Returns AMIs owned by the specified owner. Multipleowners can be specified. The IDs "amazon", "self",and "explicit" can be used to include AMIs owned byAmazon, AMIs owned by the user, and AMIs for whichthe user has explicit launch permissions, respectively.
Type: String
Default: None
No
Response Elements
Name Description
DescribeImagesResponseTypeDescribeImagesResponseType element.
Type: DescribeImagesResponseType (p. 319)
Ancestor: None
Children: requestId, imagesSet
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeImagesResponseType
Children: None
imagesSet Image set.
Type: DescribeImagesResponseInfoType (p. 318)
Ancestor: DescribeImagesResponseType
Children: item
item Information for one image.
Type: DescribeImagesResponseItemType (p. 318)
Ancestor: imagesSet
Children: imageId, imageLocation, imageState,imageOwnerId, isPublic, productCodes, architecture,imageType, kernelId, ramdiskId, and platform
imageId The ID of the AMI.
Type: xsd:string
Ancestor: item
Children: None
imageLocation The location of the AMI.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-1567
Name Description
imageState Current state of the AMI. If the operation returns "available", theimage is successfully registered and available for launching. If theoperation returns "deregistered", the image is deregistered and nolonger available for launching.
Type: xsd:string
Ancestor: item
Children: None
imageOwnerId AWS Access Key ID of the image owner.
Type: xsd:string
Ancestor: item
Children: None
isPublic Returns "true" if this image has public launch permissions. Returns"false" if it only has implicit and explicit launch permissions.
Type: xsd:boolean
Ancestor: item
Children: None
productCodes Product codes of the AMI.
Type: ProductCodesSetType (p. 361)
Ancestor: item
Children: item
item Information for one product code.
Type: ProductCodesSetItemType (p. 360)
Ancestor: productCodes
Children: productCode
productCode Product code.
Type: xsd:string
Ancestor: item
Children: None
architecture The architecture of the image ("i386" or "x86_64").
Type: xsd:string
Ancestor: item
Children: None
imageType The type of image ("machine", "kernel", or "ramdisk").
Type: xsd:string
Ancestor: item
Children: None
kernelId The kernel associated with the image, if any. Only applicable formachine images.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1568
Name Description
ramdiskId The RAM disk associated with the image, if any. Only applicablefor machine images.
Type: xsd:string
Ancestor: item
Children: None
platform The operating platform of the instance.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example RequestThis example describes the ami-be3adfd7 AMI.
https://ec2.amazonaws.com/?Action=DescribeImages&ImageId.1=ami-be3adfd7&AuthParams
Example Response<DescribeImagesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imagesSet> <item> <imageId>ami-be3adfd7</imageId> <imageLocation>ec2-public-images/fedora-8-i386-base-v1.04.manifest.xml </imageLocation> <imageState>available</imageState> <imageOwnerId>206029621532</imageOwnerId> <isPublic>false</isPublic> <architecture>i386</architecture> <imageType>machine</imageType> <kernelId>aki-4438dd2d</kernelId> <ramdiskId>ari-4538dd2c</ramdiskId> </item> </imagesSet></DescribeImagesResponse>
Related Operations• DescribeInstances (p. 69)
• DescribeImageAttribute (p. 61)
Amazon Elastic Compute Cloud API ReferenceDescribeInstances
API Version 2009-07-1569
DescribeInstances
DescriptionReturns information about instances that you own.
If you specify one or more instance IDs, Amazon EC2 returns information for those instances. If youdo not specify instance IDs, Amazon EC2 returns information for all relevant instances. If you specifyan invalid instance ID, a fault is returned. If you specify an instance that you do not own, it will not beincluded in the returned results.
Recently terminated instances might appear in the returned results.This interval is usually less thanone hour.
Request ParametersName Description Required
InstanceId.n Instance IDs to describe.
Type: String
Default: Returns all instances.
No
Response ElementsName Description
DescribeInstancesResponseTypeDescribeInstancesResponseType element.
Type: DescribeInstancesResponseType (p. 321)
Ancestor: None
Children: requestId, reservationSet
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeInstancesResponseType
Children: None
reservationSet Reservation set.
Type: ReservationSetType (p. 368)
Ancestor: DescribeInstancesResponseType
Children: item
item Information for a reservation.
Type: ReservationInfoType (p. 367)
Ancestor: reservationSet
Children: reservationId, ownerId, groupSet,instancesSet, and requesterId
reservationId Unique ID of the reservation.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-1570
Name Description
ownerId AWS Access Key ID of the user who owns the reservation.
Type: xsd:string
Ancestor: item
Children: None
groupSet Group set.
Type: GroupSetType (p. 347)
Ancestor: item
Children: item
item Group set item.
Type: GroupItemType (p. 347)
Ancestor: groupSet
Children: groupId
groupId Name of the security group.
Type: xsd:string
Ancestor: item
Children: None
instancesSet Instance set.
Type: RunningInstancesSetType (p. 375)
Ancestor: item
Children: item
item Running instance set item.
Type: RunningInstancesItemType (p. 373)
Ancestor: instancesSet
Children: instanceId, imageId, instanceState,privateDnsName, dnsName, reason, keyName,amiLaunchIndex, productCodes, instanceType,launchTime, placement, kernelId, ramdiskId, platform,monitoring, subnetId, vpcId, privateIpAddress, andipAddress
instanceId Unique ID of the instance launched.
Type: xsd:string
Ancestor: item
Children: None
imageId Image ID of the AMI used to launch the instance.
Type: xsd:string
Ancestor: item
Children: None
instanceState The current state of the instance.
Type: InstanceStateType (p. 348)
Ancestor: item
Children: code, name
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-1571
Name Description
code A 16-bit unsigned integer. The high byte is an opaque internalvalue and should be ignored. The low byte is set based on thestate represented:
Type: xsd:int
Ancestor: instanceState
Children: None
name The current state of the instance.
Type: xsd:string
Ancestor: instanceState
Children: None
privateDnsName The private DNS name assigned to the instance. This DNS namecan only be used inside the Amazon EC2 network. This elementremains empty until the instance enters a running state.
Type: xsd:string
Ancestor: item
Children: None
dnsName The public DNS name assigned to the instance. This DNS name iscontactable from outside the Amazon EC2 network. This elementremains empty until the instance enters a running state.
Type: xsd:string
Ancestor: item
Children: None
reason Reason for the most recent state transition. This might be anempty string.
Type: xsd:string
Ancestor: item
Children: None
keyName If this instance was launched with an associated key pair, thisdisplays the key pair name.
Type: xsd:string
Ancestor: item
Children: None
amiLaunchIndex The AMI launch index, which can be used to find this instancewithin the launch group. For more information, go to the Metadatasection of the
Type: xsd:string
Ancestor: item
Children: None
productCodes Product codes attached to this instance.
Type: ProductCodesSetType (p. 361)
Ancestor: item
Children: item
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-1572
Name Description
item Information for one product code.
Type: ProductCodesSetItemType (p. 360)
Ancestor: productCodes
Children: productCode
productCode Product code.
Type: xsd:string
Ancestor: item
Children: None
instanceType The instance type. For more information on instance types, go tothe
Type: xsd:string
Ancestor: item
Children: None
launchTime The time the instance launched.
Type: xsd:dateTime
Ancestor: item
Children: None
placement The location where the instance launched.
Type: PlacementResponseType (p. 359)
Ancestor: item
Children: availabilityZone
availabilityZone Returns the Availability Zones of the instances.
Type: xsd:string
Ancestor: placement
Children: None
kernelId Optional. Kernel associated with this instance.
Type: xsd:string
Ancestor: item
Children: None
ramdiskId Optional. RAM disk associated with this instance.
Type: xsd:string
Ancestor: item
Children: None
platform Platform of the instance (e.g., Windows).
Type: xsd:string
Ancestor: item
Children: None
monitoring Specifies whether monitoring is enabled for the instance.
Type: InstanceMonitoringStateType (p. 348)
Ancestor: item
Children: state
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1573
Name Description
state State of monitoring for the instance.
Type: xsd:string
Ancestor: monitoring
Children: None
subnetId Specifies the subnet ID in which the instance is running (AmazonVirtual Private Cloud).
Type: xsd:string
Ancestor: item
Children: None
vpcId Specifies the VPC in which the instance is running (Amazon VPC).
Type: xsd:string
Ancestor: item
Children: None
privateIpAddress Specifies the private IP address that is assigned to the instance(Amazon VPC).
Type: xsd:string
Ancestor: item
Children: None
ipAddress Specifies the IP address of the instance.
Type: xsd:string
Ancestor: item
Children: None
requesterId ID of the requester.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example Request
This example describes the current state of the instances owned by this user.
https://ec2.amazonaws.com/?Action=DescribeInstances&AuthParams
Example Response<DescribeInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <reservationSet> <item> <reservationId>r-44a5402d</reservationId> <ownerId>UYY3TLBUXIEON5NQVUUX6OMPWBZIQNFM</ownerId> <groupSet> <item> <groupId>default</groupId> </item>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1574
</groupSet> <instancesSet> <item> <instanceId>i-28a64341</instanceId> <imageId>ami-6ea54007</imageId> <instanceState> <code>0</code> <name>running</name> </instanceState> <privateDnsName>10-251-50-132.ec2.internal</privateDnsName> <dnsName>ec2-72-44-33-4.compute-1.amazonaws.com</dnsName> <keyName>example-key-name</keyName> <amiLaunchIndex>23</amiLaunchIndex> <productCodesSet> <item><productCode>774F4FF8</productCode></item> </productCodesSet> <instanceType>m1.large</instanceType> <launchTime>2007-08-07T11:54:42.000Z</launchTime> <placement> <availabilityZone>us-east-1b</availabilityZone> </placement> <kernelId>aki-ba3adfd3</kernelId> <ramdiskId>ari-badbad00</ramdiskId> </item> <item> <instanceId>i-28a64435</instanceId> <imageId>ami-6ea54007</imageId> <instanceState> <code>0</code> <name>running</name> </instanceState> <privateDnsName>10-251-50-134.ec2.internal</privateDnsName> <dnsName>ec2-72-44-33-6.compute-1.amazonaws.com</dnsName> <keyName>example-key-name</keyName> <amiLaunchIndex>23</amiLaunchIndex> <productCodesSet> <item><productCode>774F4FF8</productCode></item> </productCodesSet> <instanceType>m1.large</instanceType> <launchTime>2007-08-07T11:54:42.000Z</launchTime> <placement> <availabilityZone>us-east-1b</availabilityZone> </placement> <kernelId>aki-ba3adfd3</kernelId> <ramdiskId>ari-badbad00</ramdiskId> </item> </instancesSet> </item> </reservationSet></DescribeInstancesResponse>
Related Operations• RunInstances (p. 120)
• TerminateInstances (p. 129)
Amazon Elastic Compute Cloud API ReferenceDescribeKeyPairs
API Version 2009-07-1575
DescribeKeyPairs
DescriptionReturns information about key pairs available to you. If you specify key pairs, information about thosekey pairs is returned. Otherwise, information for all registered key pairs is returned.
Request Parameters
Name Description Required
KeyName.n Key pair to describe.
Type: String
Default: Describes all key pairs available to the account.
No
Response Elements
Name Description
DescribeKeyPairsResponseTypeDescribeKeyPairsResponseType element.
Type: DescribeKeyPairsResponseType (p. 324)
Ancestor: None
Children: requestId, keySet
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeKeyPairsResponseType
Children: None
keySet Information for a key pair.
Type: DescribeKeyPairsResponseInfoType (p. 323)
Ancestor: DescribeKeyPairsResponseType
Children: item
item Information for a key pair.
Type: DescribeKeyPairsResponseItemType (p. 324)
Ancestor: keySet
Children: keyName, keyFingerprint
keyName The key pair name provided in the original request.
Type: xsd:string
Ancestor: item
Children: None
keyFingerprint A SHA-1 digest of the DER encoded private key.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1576
Examples
Example RequestThis example describes the state of the gsg-keypair key.
https://ec2.amazonaws.com/?Action=DescribeKeyPairs&KeyName.1=gsg-keypair&AuthParams
Example Response<DescribeKeyPairsResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <keySet> <item> <keyName>gsg-keypair</keyName> <keyFingerprint>1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca:9f:f5:f1:6f</keyFingerprint> </item> </keySet></DescribeKeyPairsResponse>
Related Operations• DescribeAvailabilityZones (p. 54)
• RunInstances (p. 120)
Amazon Elastic Compute Cloud API ReferenceDescribeRegions
API Version 2009-07-1577
DescribeRegions
DescriptionDescribes regions that are currently available to the account.
Request Parameters
Name Description Required
RegionName.n Name of a region.
Type: String
Default: Describes all regions available to the account.
No
Response Elements
Name Description
DescribeRegionsResponseTypeDescribeRegionsResponseType element.
Type: DescribeRegionsResponseType (p. 325)
Ancestor: None
Children: requestId, regionInfo
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeRegionsResponseType
Children: None
regionInfo Region set.
Type: RegionSetType (p. 365)
Ancestor: DescribeRegionsResponseType
Children: item
item Information for a region.
Type: RegionItemType (p. 364)
Ancestor: regionInfo
Children: regionName, regionEndpoint
regionName Name of the region.
Type: xsd:string
Ancestor: item
Children: None
regionEndpoint Region service endpoint.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1578
Examples
Example RequestThis example displays regions that are available to the account.
https://ec2.amazonaws.com/?Action=DescribeRegions&RegionName.0=us-east-1&RegionName.1=eu-west-1&AuthParams
Example Response<DescribeRegionsResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <regionInfo> <item> <regionName>us-east-1</regionName> <regionEndpoint>us-east-1.ec2.amazonaws.com</regionEndpoint> </item> <item> <regionName>eu-west-1</regionName> <regionUrl>eu-west-1.ec2.amazonaws.com</regionUrl> </item> </regionInfo></DescribeRegionsResponse>
Related Operations• DescribeAvailabilityZones (p. 54)
• RunInstances (p. 120)
Amazon Elastic Compute Cloud API ReferenceDescribeReservedInstances
API Version 2009-07-1579
DescribeReservedInstances
DescriptionDescribes Reserved Instances that you purchased. For more information about Reserved Instances,go to the Amazon Elastic Compute Cloud Developer Guide.
Request Parameters
Name Description Required
ReservedInstancesId.n IDs of the Reserved Instance to describe.
Type: String
Default: None
No
Response Elements
Name Description
DescribeReservedInstancesResponseTypeDescribeReservedInstancesResponseType element.
Type: DescribeReservedInstancesResponseType (p. 332)
Ancestor: None
Children: requestId, reservedInstancesSet
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeReservedInstancesResponseType
Children: None
reservedInstancesSet Reserved Instances set.
Type: DescribeReservedInstancesResponseSetType (p. 331)
Ancestor: DescribeReservedInstancesResponseType
Children: item
item Reserved Instance set.
Type: DescribeReservedInstancesResponseSetItemType (p.330)
Ancestor: reservedInstancesSet
Children: reservedInstancesId, instanceType,availabilityZone, start, duration, fixedPrice,usagePrice, instanceCount, productDescription, andstate
reservedInstancesId The ID of the Reserved Instance.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1580
Name Description
instanceType The instance type on which the Reserved Instance can be used.
Type: xsd:string
Ancestor: item
Children: None
availabilityZone The Availability Zone in which the Reserved Instance can be used.
Type: xsd:string
Ancestor: item
Children: None
start The date and time the Reserved Instance started.
Type: xsd:dateTime
Ancestor: item
Children: None
duration The duration of the Reserved Instance, in seconds.
Type: xs:long
Ancestor: item
Children: None
fixedPrice The purchase price of the Reserved Instance.
Type: xs:double
Ancestor: item
Children: None
usagePrice The usage price of the Reserved Instance, per hour.
Type: xs:double
Ancestor: item
Children: None
instanceCount The number of Reserved Instances purchased.
Type: xs:integer
Ancestor: item
Children: None
productDescription The Reserved Instance description.
Type: xsd:string
Ancestor: item
Children: None
state The state of the Reserved Instance purchase.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example RequestThis example describes Reserved Instances owned by the account.
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1581
https://ec2.amazonaws.com/?Action=DescribeReservedInstances&AuthParams
Example Response<DescribeReservedInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <reservedInstancesSet> <item> <reservedInstancesId>4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8</reservedInstancesId> <instanceType>m1.small</instanceType> <availabilityZone>us-east-1a</availabilityZone> <duration>12</duration> <usagePrice>0.00</usagePrice> <fixedPrice>0.00</fixedPrice> <instanceCount>19</instanceCount> <productDescription>m1.small offering in us-east-1a</productDescription> <state>Active</state> </item> </reservedInstancesSet> </DescribeReservedInstancesResponse>
Related Operations• PurchaseReservedInstancesOffering (p. 107)
• DescribeReservedInstancesOfferings (p. 82)
Amazon Elastic Compute Cloud API ReferenceDescribeReservedInstancesOfferings
API Version 2009-07-1582
DescribeReservedInstancesOfferings
DescriptionDescribes Reserved Instance offerings that are available for purchase. With Amazon EC2 ReservedInstances, you purchase the right to launch Amazon EC2 instances for a period of time (without gettinginsufficient capacity errors) and pay a lower usage rate for the actual time used. For more informationabout Reserved Instances, go to the Amazon Elastic Compute Cloud Developer Guide.
Request Parameters
Name Description Required
ReservedInstancesOfferingIdID of the Reserved Instances to describe.
Type: String
Default: None
No
InstanceType The instance type on which the Reserved Instance canbe used.
Type: String
Default: None
No
AvailabilityZone The Availability Zone in which the Reserved Instancecan be used.
Type: String
Default: None
No
ProductDescription The Reserved Instance description.
Type: String
Default: None
No
Response Elements
Name Description
DescribeReservedInstancesOfferingsResponseTypeDescribeReservedInstancesOfferingsResponseTypeelement.
Type: DescribeReservedInstancesOfferingsResponseType (p.328)
Ancestor: None
Children: requestId, reservedInstancesOfferingsSet
requestId The ID of the request.
Type: xsd:string
Ancestor:DescribeReservedInstancesOfferingsResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-1583
Name Description
reservedInstancesOfferingsSetReserved Instances offerings set.
Type: DescribeReservedInstancesOfferingsResponseSetType (p.328)
Ancestor:DescribeReservedInstancesOfferingsResponseType
Children: item
item Reserved Instance offerings set.
Type:DescribeReservedInstancesOfferingsResponseSetItemType (p.327)
Ancestor: reservedInstancesOfferingsSet
Children: reservedInstancesOfferingId, instanceType,availabilityZone, duration, fixedPrice, usagePrice,and productDescription
reservedInstancesOfferingIdThe ID of the Reserved Instance offering.
Type: xsd:string
Ancestor: item
Children: None
instanceType The instance type on which the Reserved Instance can be used.
Type: xsd:string
Ancestor: item
Children: None
availabilityZone The Availability Zone in which the Reserved Instance can be used.
Type: xsd:string
Ancestor: item
Children: None
duration The duration of the Reserved Instance, in seconds.
Type: xs:long
Ancestor: item
Children: None
fixedPrice The purchase price of the Reserved Instance.
Type: xs:double
Ancestor: item
Children: None
usagePrice The usage price of the Reserved Instance, per hour.
Type: xs:double
Ancestor: item
Children: None
productDescription The Reserved Instance description.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1584
Examples
Example RequestThis example describes available Reserved Instance offerings.
https://ec2.amazonaws.com/?Action=DescribeReservedInstancesOfferings&AuthParams
Example Response<DescribeReservedInstancesOfferingsResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <reservedInstancesOfferingsSet> <item> <reservedInstancesOfferingId>4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8</reservedInstancesOfferingId> <instanceType>m1.small</instanceType> <availabilityZone>us-east-1a</availabilityZone> <duration>12</duration> <fixedPrice>0.00</fixedPrice> <usagePrice>0.00</usagePrice> <productDescription>m1.small offering in us-east-1a</productDescription> </item> </reservedInstancesOfferingsSet> </DescribeReservedInstancesOfferingsResponse>
Related Operations• PurchaseReservedInstancesOffering (p. 107)
• DescribeReservedInstances (p. 79)
Amazon Elastic Compute Cloud API ReferenceDescribeSecurityGroups
API Version 2009-07-1585
DescribeSecurityGroups
DescriptionReturns information about security groups that you own.
Request Parameters
Name Description Required
GroupName.n Name of the security group.
Type: String
Default: Describes all groups within the account.
No
Response Elements
Name Description
DescribeSecurityGroupsResponseTypeDescribeSecurityGroupsResponseType element.
Type: DescribeSecurityGroupsResponseType (p. 334)
Ancestor: None
Children: requestId, securityGroupInfo
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeSecurityGroupsResponseType
Children: None
securityGroupInfo Security group set.
Type: SecurityGroupSetType (p. 376)
Ancestor: DescribeSecurityGroupsResponseType
Children: item
item Information for a security group.
Type: SecurityGroupItemType (p. 375)
Ancestor: securityGroupInfo
Children: ownerId, groupName, groupDescription, andipPermissions
ownerId AWS Access Key ID of the owner of the security group.
Type: xsd:string
Ancestor: item
Children: None
groupName Name of the security group.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-1586
Name Description
groupDescription Description of the security group.
Type: xsd:string
Ancestor: item
Children: None
ipPermissions Set of IP permissions associated with the security group.
Type: IpPermissionSetType (p. 349)
Ancestor: item
Children: item
item Set of IP permissions.
Type: IpPermissionType (p. 350)
Ancestor: ipPermissions
Children: ipProtocol, fromPort, toPort, groups, andipRanges
ipProtocol IP protocol.
Type: xsd:string
Ancestor: item
Children: None
fromPort Start of port range for the TCP and UDP protocols, or an ICMPtype number. An ICMP type number of -1 indicates a wildcard (i.e.,any ICMP type number).
Type: xsd:int
Ancestor: item
Children: None
toPort End of port range for the TCP and UDP protocols, or an ICMPcode. An ICMP code of -1 indicates a wildcard (i.e., any ICMPcode).
Type: xsd:int
Ancestor: item
Children: None
groups List of security group and user ID pairs.
Type: UserIdGroupPairSetType (p. 380)
Ancestor: item
Children: item
item Information for one security group.
Type: UserIdGroupPairType (p. 380)
Ancestor: groups
Children: userId, groupName
userId AWS User ID of an account.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1587
Name Description
groupName Name of the security group.
Type: xsd:string
Ancestor: item
Children: None
ipRanges IP ranges.
Type: IpRangeSetType (p. 351)
Ancestor: item
Children: item
item Information for one IP range.
Type: IpRangeItemType (p. 351)
Ancestor: ipRanges
Children: cidrIp
cidrIp CIDR range.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example Request
This example returns information about two security groups that are configured for the account.
https://ec2.amazonaws.com/?Action=DescribeSecurityGroups&GroupName.1=WebServers&GroupName.2=RangedPortsBySource&AuthParams
Example Response<DescribeSecurityGroupsResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <securityGroupInfo> <item> <ownerId>UYY3TLBUXIEON5NQVUUX6OMPWBZIQNFM</ownerId> <groupName>WebServers</groupName> <groupDescription>Web Servers</groupDescription> <ipPermissions> <item> <ipProtocol>tcp</ipProtocol> <fromPort>80</fromPort> <toPort>80</toPort> <groups/> <ipRanges> <item> <cidrIp>0.0.0.0/0</cidrIp> </item> </ipRanges> </item> </ipPermissions> </item>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1588
<item> <ownerId>UYY3TLBUXIEON5NQVUUX6OMPWBZIQNFM</ownerId> <groupName>RangedPortsBySource</groupName> <groupDescription>Group A</groupDescription> <ipPermissions> <item> <ipProtocol>tcp</ipProtocol> <fromPort>6000</fromPort> <toPort>7000</toPort> <groups/> <ipRanges/> </item> </ipPermissions> </item> </securityGroupInfo></DescribeSecurityGroupsResponse>
Related Operations• CreateSecurityGroup (p. 35)
• AuthorizeSecurityGroupIngress (p. 19)
• RevokeSecurityGroupIngress (p. 117)
• DeleteSecurityGroup (p. 44)
Amazon Elastic Compute Cloud API ReferenceDescribeSnapshots
API Version 2009-07-1589
DescribeSnapshots
DescriptionDescribes the status of Amazon EBS snapshots. If no snapshots are specified, Amazon EBS returnsinformation about all snapshots owned by the account. For more information about Amazon EBS, go tothe Amazon Elastic Compute Cloud Developer Guide.
Request Parameters
Name Description Required
SnapshotId.n The ID of the Amazon EBS snapshot.
Type: String
Default: Describes all snapshots that you own.
No
Response Elements
Name Description
DescribeSnapshotsResponseTypeDescribeSnapshotsResponseType element.
Type: DescribeSnapshotsResponseType (p. 336)
Ancestor: None
Children: requestId, snapshotSet
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeSnapshotsResponseType
Children: None
snapshotSet Snapshot set.
Type: DescribeSnapshotsSetResponseType (p. 337)
Ancestor: DescribeSnapshotsResponseType
Children: item
item Information for a snapshot.
Type: DescribeSnapshotsSetItemResponseType (p. 336)
Ancestor: snapshotSet
Children: snapshotId, volumeId, status, startTime, andprogress
snapshotId The ID of the snapshot.
Type: xsd:string
Ancestor: item
Children: None
volumeId The ID of the volume.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1590
Name Description
status Snapshot state (e.g., pending, completed, error).
Type: xsd:string
Ancestor: item
Children: None
startTime Time stamp when the snapshot was initiated.
Type: xsd:dateTime
Ancestor: item
Children: None
progress The progress of the snapshot, in percentage.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example RequestThis example describes snapshot snap-78a54011.
https://ec2.amazonaws.com/?Action=DescribeSnapshots&SnapshotId=snap-78a54011&AuthParams
Example Response<DescribeSnapshotsResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <snapshotSet> <item> <snapshotId>snap-78a54011</snapshotId> <volumeId>vol-4d826724</volumeId> <status>pending</status> <startTime>2008-05-07T12:51:50.000Z</startTime> <progress>80%</progress> </item> </snapshotSet></DescribeSnapshotsResponse>
Related Operations• CreateSnapshot (p. 37)
• DeleteSnapshot (p. 46)
Amazon Elastic Compute Cloud API ReferenceDescribeVolumes
API Version 2009-07-1591
DescribeVolumes
DescriptionDescribes the specified Amazon EBS volumes that you own. If you do not specify one or more volumeIDs, Amazon EBS describes all volumes that you own. For more information about Amazon EBS, go tothe Amazon Elastic Compute Cloud Developer Guide.
Request Parameters
Name Description Required
VolumeId.n The ID of the volume to list.
Type: String
Default: Describes all volumes that you own.
No
Response Elements
Name Description
DescribeVolumesResponseTypeDescribeVolumesResponseType element.
Type: DescribeVolumesResponseType (p. 339)
Ancestor: None
Children: requestId, volumeSet
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeVolumesResponseType
Children: None
volumeSet Volume set.
Type: DescribeVolumesSetResponseType (p. 340)
Ancestor: DescribeVolumesResponseType
Children: item
item Information for a volume.
Type: DescribeVolumesSetItemResponseType (p. 339)
Ancestor: volumeSet
Children: volumeId, size, snapshotId, availabilityZone,status, createTime, and attachmentSet
volumeId The ID of the volume.
Type: xsd:string
Ancestor: item
Children: None
size The size of the volume, in GiBs.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-1592
Name Description
snapshotId Snapshot from which the volume was created (optional).
Type: xsd:string
Ancestor: item
Children: None
availabilityZone Availability Zone in which the volume was created.
Type: xsd:string
Ancestor: item
Children: None
status Volume state (e.g., "creating", "available", "in-use", "deleting","error")
Type: xsd:string
Ancestor: item
Children: None
createTime Time stamp when volume creation was initiated.
Type: xsd:dateTime
Ancestor: item
Children: None
attachmentSet Attachment set.
Type: AttachmentSetResponseType (p. 284)
Ancestor: item
Children: item
item Information for a attachment set.
Type: AttachmentSetItemResponseType (p. 284)
Ancestor: attachmentSet
Children: volumeId, instanceId, device, status, andattachTime
volumeId The ID of the volume.
Type: xsd:string
Ancestor: item
Children: None
instanceId The ID of the instance.
Type: xsd:string
Ancestor: item
Children: None
device Specifies how the device is exposed to the instance (e.g., /dev/sdh).
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1593
Name Description
status Attachment state.
Type: xsd:string
Ancestor: item
Children: None
attachTime Time stamp when the association was created.
Type: xsd:dateTime
Ancestor: item
Children: None
Examples
Example RequestThis example describes all volumes associated with your account.
https://ec2.amazonaws.com/?Action=DescribeVolumes&AuthParams
Example Response<DescribeVolumesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"><volumeSet> <item> <volumeId>vol-4282672b</volumeId> <size>800</size> <snapshotId/> <availabilityZone>us-east-1a</availabilityZone> <status>in-use</status> <createTime>2008-05-07T11:51:50.000Z</createTime> <attachmentSet> <item> <volumeId>vol-4282672b</volumeId> <instanceId>i-6058a509</instanceId> <device>/dev/sdh</device> <status>attached</status> <attachTime>2008-05-07T12:51:50.000Z</attachTime> </item> </attachmentSet> </item></DescribeVolumesResponse>
Related Operations• CreateSnapshot (p. 37)
• DeleteSnapshot (p. 46)
Amazon Elastic Compute Cloud API ReferenceDetachVolume
API Version 2009-07-1594
DetachVolume
DescriptionDetaches an Amazon EBS volume from an instance. For more information about Amazon EBS, go tothe Amazon Elastic Compute Cloud Developer Guide.
Important
Make sure to unmount any file systems on the device within your operating system beforedetaching the volume. Failure to unmount file systems, or otherwise properly release thedevice from use, can result in lost data and will corrupt the file system.
Request Parameters
Name Description Required
VolumeId The ID of the volume.
Type: String
Default: None
Yes
InstanceId The ID of the instance.
Type: String
Default: None
No
Device The device name.
Type: String
Default: None
No
Force Forces detachment if the previous detachmentattempt did not occur cleanly (logging into an instance,unmounting the volume, and detaching normally). Thisoption can lead to data loss or a corrupted file system.Use this option only as a last resort to detach a volumefrom a failed instance. The instance will not have anopportunity to flush file system caches nor file systemmeta data. If you use this option, you must perform filesystem check and repair procedures.
Type: Boolean
Default: None
No
Response Elements
Name Description
DetachVolumeResponseType DetachVolumeResponseType element.
Type: DetachVolumeResponseType (p. 342)
Ancestor: None
Children: requestId, volumeId, instanceId, device,status, and attachTime
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-1595
Name Description
requestId The ID of the request.
Type: xsd:string
Ancestor: DetachVolumeResponseType
Children: None
volumeId The ID of the volume.
Type: xsd:string
Ancestor: DetachVolumeResponseType
Children: None
instanceId The ID of the instance.
Type: xsd:string
Ancestor: DetachVolumeResponseType
Children: None
device The device as it is exposed to the instance.
Type: xsd:string
Ancestor: DetachVolumeResponseType
Children: None
status Attachment state (e.g., "attaching", "attached", "detaching", or"detached").
Type: xsd:string
Ancestor: DetachVolumeResponseType
Children: None
attachTime Time stamp when the association was created.
Type: xsd:dateTime
Ancestor: DetachVolumeResponseType
Children: None
Examples
Example Request
This example detaches volume vol-4d826724.
https://ec2.amazonaws.com/?Action=DetachVolume&VolumeId=vol-4d826724&InstanceId=i-6058a509&AuthParams
Example Response
<DetachVolumeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <volumeId>vol-4d826724</volumeId> <instanceId>i-6058a509</instanceId> <device>/dev/sdh</device> <status>detaching</status> <attachTime>2008-05-08T11:51:50.000Z</attachTime></DetachVolumeResponse>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1596
Related Operations• CreateVolume (p. 39)
• DeleteVolume (p. 48)
• DescribeVolumes (p. 91)
• AttachVolume (p. 16)
Amazon Elastic Compute Cloud API ReferenceDisassociateAddress
API Version 2009-07-1597
DisassociateAddress
DescriptionDisassociates the specified elastic IP address from the instance to which it is assigned. This is anidempotent operation. If you enter it more than once, Amazon EC2 does not return an error.
Request Parameters
Name Description Required
PublicIp IP address that you are disassociating from the instance.
Type: String
Default: None
Yes
Response Elements
Name Description
DisassociateAddressResponseTypeDisassociateAddressResponseType element.
Type: DisassociateAddressResponseType (p. 343)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: DisassociateAddressResponseType
Children: None
return Returns "true" if the IP address is disassociated from the instance.Otherwise, "false".
Type: xsd:boolean
Ancestor: DisassociateAddressResponseType
Children: None
Examples
Example Request
This example disassociates the 67.202.55.255 IP address from the instance to which it is assigned.
https://ec2.amazonaws.com/?Action=DisassociateAddress&PublicIp=67.202.55.255&AuthParams
Example Response<DisassociateAddressResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-1598
</DisassociateAddressResponse>
Related Operations• AllocateAddress (p. 12)
• DescribeAddresses (p. 52)
• ReleaseAddress (p. 113)
• AssociateAddress (p. 14)
Amazon Elastic Compute Cloud API ReferenceGetConsoleOutput
API Version 2009-07-1599
GetConsoleOutput
DescriptionRetrieves console output for the specified instance.
Instance console output is buffered and posted shortly after instance boot, reboot, and termination.Amazon EC2 preserves the most recent 64 KB output which will be available for at least one hour afterthe most recent post.
Request Parameters
Name Description Required
InstanceId ID of the instance for which you want console output.
Type: String
Default: None
Yes
Response Elements
Name Description
GetConsoleOutputResponseTypeGetConsoleOutputResponseType element.
Type: GetConsoleOutputResponseType (p. 345)
Ancestor: None
Children: requestId, instanceId, timestamp, and output
requestId The ID of the request.
Type: xsd:string
Ancestor: GetConsoleOutputResponseType
Children: None
instanceId The instance ID.
Type: xsd:string
Ancestor: GetConsoleOutputResponseType
Children: None
timestamp The time the output was last updated.
Type: xsd:dateTime
Ancestor: GetConsoleOutputResponseType
Children: None
output The console output, Base64 encoded.
Type: xsd:string
Ancestor: GetConsoleOutputResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15100
Examples
Example RequestThis example retrieves the console output for the i-10a64379 Linux and UNIX instance.
https://ec2.amazonaws.com/?Action=GetConsoleOutput&InstanceId=i-10a64379&AuthParams
Example Response<GetConsoleOutputResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instanceId>i-28a64341</instanceId> <timestamp>2007-01-03 15:00:00</timestamp> <output>TGludXggdmVyc2lvbiAyLjYuMTYteGVuVSAoYnVpbGRlckBwYXRjaGJhdC5hbWF6b25zYSkgKGdjYyB2ZXJzaW9uIDQuMC4xIDIwMDUwNzI3IChSZWQgSGF0IDQuMC4xLTUpKSAjMSBTTVAgVGh1IE9jdCAyNiAwODo0MToyNiBTQVNUIDIwMDYKQklPUy1wcm92aWRlZCBwaHlzaWNhbCBSQU0gbWFwOgpYZW46IDAwMDAwMDAwMDAwMDAwMDAgLSAwMDAwMDAwMDZhNDAwMDAwICh1c2FibGUpCjk4ME1CIEhJR0hNRU0gYXZhaWxhYmxlLgo3MjdNQiBMT1dNRU0gYXZhaWxhYmxlLgpOWCAoRXhlY3V0ZSBEaXNhYmxlKSBwcm90ZWN0aW9uOiBhY3RpdmUKSVJRIGxvY2t1cCBkZXRlY3Rpb24gZGlzYWJsZWQKQnVpbHQgMSB6b25lbGlzdHMKS2VybmVsIGNvbW1hbmQgbGluZTogcm9vdD0vZGV2L3NkYTEgcm8gNApFbmFibGluZyBmYXN0IEZQVSBzYXZlIGFuZCByZXN0b3JlLi4uIGRvbmUuCg==</output></GetConsoleOutputResponse>
Related Operations• RunInstances (p. 120)
Amazon Elastic Compute Cloud API ReferenceGetPasswordData
API Version 2009-07-15101
GetPasswordData
DescriptionRetrieves the encrypted administrator password for the instances running Windows.
Note
The Windows password is only generated the first time an AMI is launched. It is not generatedfor rebundled AMIs or after the password is changed on an instance.
The password is encrypted using the key pair that you provided.
Request Parameters
Name Description Required
instanceId The ID of the instance for which to get the password.
Type: String
Default: None
Yes
Response Elements
Name Description
GetPasswordDataResponseTypeGetPasswordDataResponseType element.
Type: GetPasswordDataResponseType (p. 346)
Ancestor: None
Children: requestId, instanceId, timestamp, andpasswordData
requestId The ID of the request.
Type: xsd:string
Ancestor: GetPasswordDataResponseType
Children: None
instanceId The ID of the instance.
Type: xsd:string
Ancestor: GetPasswordDataResponseType
Children: None
timestamp The time the data was last updated.
Type: xsd:dateTime
Ancestor: GetPasswordDataResponseType
Children: None
passwordData The password of the instance.
Type: xsd:string
Ancestor: GetPasswordDataResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15102
Examples
Example RequestThis example returns the encrypted version of the administrator password for the i-2574e22ainstance.
https://ec2.amazonaws.com/?Action=GetPasswordData&InstanceId=i-10a64379&AuthParams
Example Response<GetPasswordDataResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instanceId>i-2574e22a</instanceId> <timestamp>2009-10-24 15:00:00</timestamp> <passwordData>TGludXggdmVyc2lvbiAyLjYuMTYteGVuVSAoYnVpbGRlckBwYXRjaGJhdC5hbWF6b25zYSkgKGdj</passwordData></GetPasswordDataResponse>
Related Operations• RunInstances (p. 120)
Amazon Elastic Compute Cloud API ReferenceModifyImageAttribute
API Version 2009-07-15103
ModifyImageAttribute
DescriptionModifies an attribute of an AMI.
Request Parameters
Name Description Required
ImageId The AMI ID.
Type: String
Default: None
Yes
UserId.n User IDs associated with the launchPermission attribute.
Type: String
Default: None
Group.n Security groups associated with the launchPermissionattribute. You can specify the "all" group, which willmake it a public AMI.
Type: String
Default: None
ProductCode.n Amazon DevPay product code. Currently only oneproduct code can be associated with an AMI. Once set,the product code cannot be changed or reset.
Type: String
Default: None
Attribute Specifies the attribute to modify.
Type: String
Default: None
Valid Values: launchPermission | productCodes
OperationType Specifies the operation to perform on the attribute.
Type: String
Default: None
Valid Values: add | remove
Response Elements
Name Description
ModifyImageAttributeResponseTypeModifyImageAttributeResponseType element.
Type: ModifyImageAttributeResponseType (p. 353)
Ancestor: None
Children: requestId, return
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15104
Name Description
requestId The ID of the request.
Type: xsd:string
Ancestor: ModifyImageAttributeResponseType
Children: None
return Returns "true" if successful; otherwise "false".
Type: xsd:boolean
Ancestor: ModifyImageAttributeResponseType
Children: None
Examples
Example RequestThis example makes this a public AMI and grants specific permissions to a user.
https://ec2.amazonaws.com/?Action=ModifyImageAttribute&ImageId=ami-61a54008&Attribute=launchPermission&OperationType=add&Group.1=all &UserId.1=495219933132&AuthParams
Example Response<ModifyImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></ModifyImageAttributeResponse>
Example RequestThe following example adds the 774F4FF8 product code to the ami-2bb65342 AMI:
https://ec2.amazonaws.com/?Action=ModifyImageAttribute?Action=ModifyImageAttribute&ImageId=ami-61a54008&Attribute=productCodes&ProductCode.1=774F4FF8&AuthParams
Example Response<ModifyImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></ModifyImageAttributeResponse>
Related Operations• ResetImageAttribute (p. 115)
• DescribeImageAttribute (p. 61)
Amazon Elastic Compute Cloud API ReferenceMonitorInstances
API Version 2009-07-15105
MonitorInstances
DescriptionEnables monitoring for a running instance. For more information, refer to the Amazon CloudWatchDeveloper Guide.
Request Parameters
Name Description Required
InstanceId.n Instance ID.
Type: String
Default: None
Yes
Response Elements
Name Description
MonitorInstancesResponseTypeMonitorInstancesResponseType element.
Type: MonitorInstancesResponseType (p. 356)
Ancestor: None
Children: requestId, instancesSet
requestId The ID of the request.
Type: xsd:string
Ancestor: MonitorInstancesResponseType
Children: None
instancesSet Monitor instance response set.
Type: MonitorInstancesResponseSetType (p. 355)
Ancestor: MonitorInstancesResponseType
Children: item
item Instance Item.
Type: MonitorInstancesResponseSetItemType (p. 355)
Ancestor: instancesSet
Children: instanceId, monitoring
instanceId Instance ID.
Type: xsd:string
Ancestor: item
Children: None
monitoring Monitoring information.
Type: InstanceMonitoringStateType (p. 348)
Ancestor: item
Children: state
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15106
Name Description
state State of monitoring for the instance.
Type: xsd:string
Ancestor: monitoring
Children: None
Examples
Example RequestThis example enables monitoring for i-43a4412a and i-23a3397d.
https://ec2.amazonaws.com/?Action=MonitorInstances&InstanceId.1=i-43a4412a&InstanceId.2=i-23a3397d&AuthParams
Example Response<MonitorInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instancesSet> <item> <instanceId>i-43a4412a</instanceId> <monitoring> <state>pending</state> </monitoring> </item> <item> <instanceId>i-23a3397d</instanceId> <monitoring> <state>pending</state> </monitoring> </item> </instancesSet></MonitorInstancesResponse>
Related Operations• UnmonitorInstances (p. 132)
• RunInstances (p. 120)
Amazon Elastic Compute Cloud API ReferencePurchaseReservedInstancesOffering
API Version 2009-07-15107
PurchaseReservedInstancesOffering
DescriptionPurchases a Reserved Instance for use with your account. With Amazon EC2 Reserved Instances, youpurchase the right to launch Amazon EC2 instances for a period of time (without getting insufficientcapacity errors) and pay a lower usage rate for the actual time used. For more information aboutReserved Instances, go to the Amazon Elastic Compute Cloud Developer Guide.
Request Parameters
Name Description Required
ReservedInstancesOfferingId.nThe offering ID of the Reserved Instance to purchase.
Type: String
Default: None
Yes
InstanceCount.n The number of Reserved Instances to purchase.
Type: Integer
Default: 1
No
Response Elements
Name Description
PurchaseReservedInstancesOfferingResponseTypePurchaseReservedInstancesOfferingResponseTypeelement.
Type: PurchaseReservedInstancesOfferingResponseType (p.361)
Ancestor: None
Children: requestId, reservedInstancesId
requestId The ID of the request.
Type: xsd:string
Ancestor:PurchaseReservedInstancesOfferingResponseType
Children: None
reservedInstancesId The IDs of the purchased Reserved Instances.
Type: xsd:string
Ancestor:PurchaseReservedInstancesOfferingResponseType
Children: None
Examples
Example Request
This example purchases Reserved Instances.
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15108
https://ec2.amazonaws.com/?Action=PurchaseReservedInstancesOffering&OfferingId.1=offering-12345678&instanceCount.1=2&AuthParams
Example Response<PurchaseReservedInstancesOfferingResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <reservedInstancesId>reservation-1001001</reservedInstancesId> </PurchaseReservedInstancesOfferingResponse>
Related Operations• DescribeReservedInstancesOfferings (p. 82)
• DescribeReservedInstances (p. 79)
Amazon Elastic Compute Cloud API ReferenceRebootInstances
API Version 2009-07-15109
RebootInstances
DescriptionRequests a reboot of one or more instances. This operation is asynchronous; it only queues a requestto reboot the specified instance(s). The operation will succeed if the instances are valid and belong toyou. Requests to reboot terminated instances are ignored.
Note
If a Linux/UNIX instance does not cleanly shut down within four minutes, Amazon EC2 willperform a hard reboot.
Request Parameters
Name Description Required
InstanceId.n One or more instance IDs.
Type: String
Default: None
Yes
Response Elements
Name Description
RebootInstancesResponseTypeRebootInstancesResponseType element.
Type: RebootInstancesResponseType (p. 363)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: RebootInstancesResponseType
Children: None
return Returns "true" if successful; otherwise "false".
Type: xsd:boolean
Ancestor: RebootInstancesResponseType
Children: None
Examples
Example Request
This example reboots an instance.
https://ec2.amazonaws.com/?Action=RebootInstances&AuthParams
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15110
Example Response<RebootInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></RebootInstancesResponse>
Related Operations• RunInstances (p. 120)
Amazon Elastic Compute Cloud API ReferenceRegisterImage
API Version 2009-07-15111
RegisterImageDescriptionRegisters an AMI with Amazon EC2. Images must be registered before they can be launched. Tolaunch instances, use the RunInstances operation.
Each AMI is associated with an unique ID which is provided by the Amazon EC2 service through theRegisterImage operation. During registration, Amazon EC2 retrieves the specified image manifestfrom Amazon S3 and verifies that the image is owned by the user registering the image.
The image manifest is retrieved once and stored within the Amazon EC2. Any modifications to animage in Amazon S3 invalidates this registration. If you make changes to an image, deregister theprevious image and register the new image. To deregister an image, use the DeregisterImageoperation.
Request ParametersName Description Required
ImageLocation Full path to your AMI manifest in Amazon S3 storage.
Type: String
Default: None
Yes
Response ElementsName Description
RegisterImageResponseType RegisterImageResponseType element.
Type: RegisterImageResponseType (p. 365)
Ancestor: None
Children: requestId, imageId
requestId The ID of the request.
Type: xsd:string
Ancestor: RegisterImageResponseType
Children: None
imageId Unique ID of the newly registered machine image.
Type: xsd:string
Ancestor: RegisterImageResponseType
Children: None
Examples
Example RequestThis example registers the AMI specified in the image.manifest.xml manifest file.
https://ec2.amazonaws.com/?Action=RegisterImage&ImageLocation=mybucket-myimage.manifest.xml&AuthParams
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15112
Example Response<RegisterImageResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imageId>ami-61a54008</imageId></RegisterImageResponse>
Related Operations• DescribeImages (p. 65)
• DeregisterImage (p. 50)
Amazon Elastic Compute Cloud API ReferenceReleaseAddress
API Version 2009-07-15113
ReleaseAddress
DescriptionReleases an elastic IP address associated with your account.
If you run this operation on an elastic IP address that is already released, the address might beassigned to another account which will cause Amazon EC2 to return an error.
Note
Releasing an IP address automatically disassociates it from any instance withwhich it is associated. To disassociate an IP address without releasing it, use theDisassociateAddress operation.
Important
After releasing an elastic IP address, it is released to the IP address pool and might no longerbe available to your account. Make sure to update your DNS records and any servers ordevices that communicate with the address.
Request Parameters
Name Description Required
PublicIp The IP address that you are releasing from youraccount.
Type: String
Default: None
Yes
Response Elements
Name Description
ReleaseAddressResponseTypeReleaseAddressResponseType element.
Type: ReleaseAddressResponseType (p. 366)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: ReleaseAddressResponseType
Children: None
return Returns "true" if successful; otherwise "false".
Type: xsd:boolean
Ancestor: ReleaseAddressResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15114
Examples
Example RequestThis example releases an elastic IP address associated with the account.
https://ec2.amazonaws.com/?Action=ReleaseAddress&PublicIp=67.202.55.255&AuthParams
Example Response<ReleaseAddressResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></ReleaseAddressResponse>
Related Operations• AllocateAddress (p. 12)
• DescribeAddresses (p. 52)
• AssociateAddress (p. 14)
• DisassociateAddress (p. 97)
Amazon Elastic Compute Cloud API ReferenceResetImageAttribute
API Version 2009-07-15115
ResetImageAttributeDescriptionResets an attribute of an AMI to its default value.
Note
The productCodes attribute cannot be reset.
Request ParametersName Description Required
ImageId ID of the AMI on which the attribute will be reset.
Type: String
Default: None
Yes
Attribute Specifies the attribute to reset.
Type: String
Default: None
Valid Values: launchPermission | productCodes
Response ElementsName Description
ResetImageAttributeResponseTypeResetImageAttributeResponseType element.
Type: ResetImageAttributeResponseType (p. 368)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: ResetImageAttributeResponseType
Children: None
return Indicates whether the attribute successfully reset.
Type: xsd:boolean
Ancestor: ResetImageAttributeResponseType
Children: None
ExamplesExample RequestThis example resets the launchPermission attribute.
https://ec2.amazonaws.com/?Action=ResetImageAttribute&ImageId=ami-61a54008&Attribute=launchPermission&AuthParams
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15116
Example Response<ResetImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></ResetImageAttributeResponse>
Related Operations• ModifyImageAttribute (p. 103)
• DescribeImageAttribute (p. 61)
Amazon Elastic Compute Cloud API ReferenceRevokeSecurityGroupIngress
API Version 2009-07-15117
RevokeSecurityGroupIngress
DescriptionRevokes permissions from a security group. The permissions used to revoke must be specified usingthe same values used to grant the permissions.
Permissions are specified by IP protocol (TCP, UDP, or ICMP), the source of the request (by IP rangeor an Amazon EC2 user-group pair), the source and destination port ranges (for TCP and UDP), andthe ICMP codes and types (for ICMP).
Permission changes are quickly propagated to instances within the security group. However,depending on the number of instances in the group, a small delay is might occur.
Request Parameters
Name Description Required
UserId AWS Access Key ID.
Type: String
Default: None
Yes
GroupName Name of the group to modify.
Type: String
Default: None
Yes
IpProtocol IP protocol.
Type: String
Default: None
Valid Values: tcp | udp | icmp
Yes
FromPort Start of port range for the TCP and UDP protocols,or an ICMP type number. An ICMP type number of -1indicates a wildcard (i.e., any ICMP type number).
Type: Integer
Default: None
Yes
ToPort End of port range for the TCP and UDP protocols, oran ICMP code. An ICMP code of -1 indicates a wildcard(i.e., any ICMP code).
Type: Integer
Default: None
Yes
UserId AWS User ID of an account.
Type: String
Default: None
Yes
GroupName Name of the security group.
Type: String
Default: None
Yes
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15118
Name Description Required
CidrIp CIDR range.
Type: String
Default: None
Constraints: Valid CIDR IP address range.
Yes
Response Elements
Name Description
RevokeSecurityGroupIngressResponseTypeRevokeSecurityGroupIngressResponseType element.
Type: RevokeSecurityGroupIngressResponseType (p. 370)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: RevokeSecurityGroupIngressResponseType
Children: None
return Returns "true" if the request is successful; otherwise "false".
Type: xsd:boolean
Ancestor: RevokeSecurityGroupIngressResponseType
Children: None
Examples
Example Request
This example revokes TCP port 80 access from the 205.192.0.0/16 address range for the websrvsecurity group.
https://ec2.amazonaws.com/?Action=RevokeSecurityGroupIngress&IpProtocol=tcp&FromPort=80&ToPort=80&CidrIp=205.192.0.0/16&AuthParams
Example Response<RevokeSecurityGroupIngressResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></RevokeSecurityGroupIngressResponse>
Related Operations• CreateSecurityGroup (p. 35)
• DescribeSecurityGroups (p. 85)
• AuthorizeSecurityGroupIngress (p. 19)
• DeleteSecurityGroup (p. 44)
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15119
Amazon Elastic Compute Cloud API ReferenceRunInstances
API Version 2009-07-15120
RunInstances
DescriptionLaunches a specified number of instances of an AMI for which you have permissions.
If Amazon EC2 cannot launch the minimum number AMIs you request, no instances will be launched.If there is insufficient capacity to launch the maximum number of AMIs you request, Amazon EC2launches the minimum number specified for each AMI and allocate the remaining available instancesusing round robin.
In the following example, Libby generates a request to launch two images (database and web_server):
1. Libby runs the RunInstances operation to launch database instances (min. 10, max. 15) andweb_server instances (min. 30, max. 40).
Because there are currently 30 instances available and Libby needs a minimum of 40, no instancesare launched.
2. Libby adjusts the number of instances she needs and runs the RunInstances operation to launchdatabase instances (min. 5, max. 10) and web_server instances (min. 20, max. 40).
Amazon EC2 launches the minimum number of instances for each AMI (5 database, 20web_server).
The remaining 5 instances are allocated using round robin.
3. Libby adjusts the number of instances she needs and runs the RunInstances operation again tolaunch database instances (min. 5, max. 10) and web_server instances (min. 20, max. 40).
Note
Every instance is launched in a security group (created using the CreateSecurityGroupoperation.
You can provide an optional key pair ID for each image in the launch request (created using theCreateKeyPair operation). All instances that are created from images that use this key pair willhave access to the associated public key at boot. You can use this key to provide secure access to aninstance of an image on a per-instance basis. Amazon EC2 public images use this feature to providesecure access without passwords.
Important
Launching public images without a key pair ID will leave them inaccessible.
The public key material is made available to the instance at boot time by placing it in theopenssh_id.pub file on a logical device that is exposed to the instance as /dev/sda2 (the instancestore). The format of this file is suitable for use as an entry within ~/.ssh/authorized_keys (theOpenSSH format). This can be done at boot (e.g., as part of rc.local) allowing for secure accesswithout passwords.
Optional user data can be provided in the launch request. All instances that collectively comprise thelaunch request have access to this data. For more information, go the Amazon Elastic Compute CloudDeveloper Guide.
Amazon Elastic Compute Cloud API ReferenceRequest Parameters
API Version 2009-07-15121
Note
If any of the AMIs have a product code attached for which the user has not subscribed, theRunInstances call will fail.
Important
We strongly recommend using the 2.6.18 Xen stock kernel with the c1.medium and c1.xlargeinstances. Although the default Amazon EC2 kernels will work, the new kernels providegreater stability and performance for these instance types. For more information about kernels,go the Amazon Elastic Compute Cloud Developer Guide.
Request Parameters
Name Description Required
ImageId Unique ID of a machine image, returned by a call to
Type: String
Default: None
Yes
MinCount Minimum number of instances to launch. If the value ismore than Amazon EC2 can launch, no instances arelaunched at all.
Type: Integer
Default: None
Constraints: Between 1 and the maximum numberallowed for your account (default: 20).
Yes
MaxCount Maximum number of instances to launch. If the value ismore than Amazon EC2 can launch, the largest possiblenumber above minCount will be launched instead.
Type: Integer
Default: None
Constraints: Between 1 and the maximum numberallowed for your account (default: 20).
Yes
KeyName The name of the key pair.
Type: String
Default: None
No
SecurityGroup.n Name of the security group.
Type: String
Default: None
No
AdditionalInfo Specifies additional information to make available to theinstance(s).
Type: String
Default: None
No
UserData The user data.
Type: String
Default: None
No
Amazon Elastic Compute Cloud API ReferenceRequest Parameters
API Version 2009-07-15122
Name Description Required
AddressingType Deprecated.
Type: String
Default: None
No
InstanceType Specifies the instance type.
Type: String
Default: m1.small
Valid Values: m1.small | m1.large | m1.xlarge |c1.medium | c1.xlarge
No
Placment.AvailabilityZoneSpecifies the placement constraints (Availability Zones)for launching the instances.
Type: String
Default: Amazon EC2 selects an Availability Zone.
No
KernelId The ID of the kernel with which to launch the instance.
Type: String
Default: None
No
RamdiskId The ID of the RAM disk with which to launch theinstance. Some kernels require additional drivers atlaunch. Check the kernel requirements for informationon whether you need to specify a RAM disk. To findkernel requirements, go to the Resource Center andsearch for the kernel ID.
Type: String
Default: None
No
VirtualName The virtual name.
Type: String
Default: None
No
DeviceName The device name (e.g., /dev/sdh).
Type: String
Default: None
No
Monitoring.Enabled Enables monitoring for the instance.
Type: Boolean
Default: Disabled
No
subnetId Specifies the subnet ID within which to launch theinstance(s) for Amazon Virtual Private Cloud.
Type: String
Default: None
No
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15123
Response Elements
Name Description
RunInstancesResponseType RunInstancesResponseType element.
Type: RunInstancesResponseType (p. 371)
Ancestor: None
Children: requestId, reservationId, ownerId, groupSet,instancesSet, and requesterId
requestId The ID of the request.
Type: xsd:string
Ancestor: RunInstancesResponseType
Children: None
reservationId Unique ID of the reservation.
Type: xsd:string
Ancestor: RunInstancesResponseType
Children: None
ownerId AWS Access Key ID of the user who owns the reservation.
Type: xsd:string
Ancestor: RunInstancesResponseType
Children: None
groupSet Group set.
Type: GroupSetType (p. 347)
Ancestor: RunInstancesResponseType
Children: item
item Group set item.
Type: GroupItemType (p. 347)
Ancestor: groupSet
Children: groupId
groupId Name of the security group.
Type: xsd:string
Ancestor: item
Children: None
instancesSet Instance set.
Type: RunningInstancesSetType (p. 375)
Ancestor: RunInstancesResponseType
Children: item
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15124
Name Description
item Running instance set item.
Type: RunningInstancesItemType (p. 373)
Ancestor: instancesSet
Children: instanceId, imageId, instanceState,privateDnsName, dnsName, reason, keyName,amiLaunchIndex, productCodes, instanceType,launchTime, placement, kernelId, ramdiskId, platform,monitoring, subnetId, vpcId, privateIpAddress, andipAddress
instanceId Unique ID of the instance launched.
Type: xsd:string
Ancestor: item
Children: None
imageId Image ID of the AMI used to launch the instance.
Type: xsd:string
Ancestor: item
Children: None
instanceState The current state of the instance.
Type: InstanceStateType (p. 348)
Ancestor: item
Children: code, name
code A 16-bit unsigned integer. The high byte is an opaque internalvalue and should be ignored. The low byte is set based on thestate represented:
Type: xsd:int
Ancestor: instanceState
Children: None
name The current state of the instance.
Type: xsd:string
Ancestor: instanceState
Children: None
privateDnsName The private DNS name assigned to the instance. This DNS namecan only be used inside the Amazon EC2 network. This elementremains empty until the instance enters a running state.
Type: xsd:string
Ancestor: item
Children: None
dnsName The public DNS name assigned to the instance. This DNS name iscontactable from outside the Amazon EC2 network. This elementremains empty until the instance enters a running state.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15125
Name Description
reason Reason for the most recent state transition. This might be anempty string.
Type: xsd:string
Ancestor: item
Children: None
keyName If this instance was launched with an associated key pair, thisdisplays the key pair name.
Type: xsd:string
Ancestor: item
Children: None
amiLaunchIndex The AMI launch index, which can be used to find this instancewithin the launch group. For more information, go to the Metadatasection of the
Type: xsd:string
Ancestor: item
Children: None
productCodes Product codes attached to this instance.
Type: ProductCodesSetType (p. 361)
Ancestor: item
Children: item
item Information for one product code.
Type: ProductCodesSetItemType (p. 360)
Ancestor: productCodes
Children: productCode
productCode Product code.
Type: xsd:string
Ancestor: item
Children: None
instanceType The instance type. For more information on instance types, go tothe
Type: xsd:string
Ancestor: item
Children: None
launchTime The time the instance launched.
Type: xsd:dateTime
Ancestor: item
Children: None
placement The location where the instance launched.
Type: PlacementResponseType (p. 359)
Ancestor: item
Children: availabilityZone
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15126
Name Description
availabilityZone Returns the Availability Zones of the instances.
Type: xsd:string
Ancestor: placement
Children: None
kernelId Optional. Kernel associated with this instance.
Type: xsd:string
Ancestor: item
Children: None
ramdiskId Optional. RAM disk associated with this instance.
Type: xsd:string
Ancestor: item
Children: None
platform Platform of the instance (e.g., Windows).
Type: xsd:string
Ancestor: item
Children: None
monitoring Specifies whether monitoring is enabled for the instance.
Type: InstanceMonitoringStateType (p. 348)
Ancestor: item
Children: state
state State of monitoring for the instance.
Type: xsd:string
Ancestor: monitoring
Children: None
subnetId Specifies the subnet ID in which the instance is running (AmazonVirtual Private Cloud).
Type: xsd:string
Ancestor: item
Children: None
vpcId Specifies the VPC in which the instance is running (Amazon VPC).
Type: xsd:string
Ancestor: item
Children: None
privateIpAddress Specifies the private IP address that is assigned to the instance(Amazon VPC).
Type: xsd:string
Ancestor: item
Children: None
ipAddress Specifies the IP address of the instance.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15127
Name Description
requesterId ID of the requester.
Type: xsd:string
Ancestor: RunInstancesResponseType
Children: None
Examples
Example RequestThis example launches three instances of the ami-60a54009 AMI.
https://ec2.amazonaws.com/?Action=RunInstances&ImageId=ami-60a54009&MaxCount=3&MinCount=1&Placement.AvailabilityZone=us-east-1a&Monitoring.Enabled=true&AuthParams
Example Response<RunInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <reservationId>r-47a5402e</reservationId> <ownerId>AIDADH4IGTRXXKCD</ownerId> <groupSet> <item> <groupId>default</groupId> </item> </groupSet> <instancesSet> <item> <instanceId>i-2ba64342</instanceId> <imageId>ami-60a54009</imageId> <instanceState> <code>0</code> <name>pending</name> </instanceState> <privateDnsName></privateDnsName> <dnsName></dnsName> <keyName>example-key-name</keyName> <amiLaunchIndex>0</amiLaunchIndex> <instanceType>m1.small</instanceType> <launchTime>2007-08-07T11:51:50.000Z</launchTime> <placement> <availabilityZone>us-east-1b</availabilityZone> </placement> <monitoring> <enabled>true</enabled> </monitoring>
</item> <item> <instanceId>i-2bc64242</instanceId> <imageId>ami-60a54009</imageId> <instanceState> <code>0</code> <name>pending</name> </instanceState>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15128
<privateDnsName></privateDnsName> <dnsName></dnsName> <keyName>example-key-name</keyName> <amiLaunchIndex>1</amiLaunchIndex> <instanceType>m1.small</instanceType> <launchTime>2007-08-07T11:51:50.000Z</launchTime> <placement> <availabilityZone>us-east-1b</availabilityZone> </placement> <monitoring> <enabled>true</enabled> </monitoring> </item> <item> <instanceId>i-2be64332</instanceId> <imageId>ami-60a54009</imageId> <instanceState> <code>0</code> <name>pending</name> </instanceState> <privateDnsName></privateDnsName> <dnsName></dnsName> <keyName>example-key-name</keyName> <amiLaunchIndex>2</amiLaunchIndex> <instanceType>m1.small</instanceType> <launchTime>2007-08-07T11:51:50.000Z</launchTime> <placement> <availabilityZone>us-east-1b</availabilityZone> </placement> <monitoring> <enabled>true</enabled> </monitoring> </item> </instancesSet></RunInstancesResponse>
Related Operations• DescribeInstances (p. 69)
• TerminateInstances (p. 129)
• AuthorizeSecurityGroupIngress (p. 19)
• RevokeSecurityGroupIngress (p. 117)
• DescribeSecurityGroups (p. 85)
• CreateSecurityGroup (p. 35)
• CreateKeyPair (p. 33)
Amazon Elastic Compute Cloud API ReferenceTerminateInstances
API Version 2009-07-15129
TerminateInstances
DescriptionShuts down one or more instances. This operation is idempotent; if you terminate an instance morethan once, each call will succeed.
Terminated instances will remain visible after termination (approximately one hour).
Request Parameters
Name Description Required
InstanceId.n Instance ID to terminate.
Type: String
Default: None
Yes
Response Elements
Name Description
TerminateInstancesResponseTypeTerminateInstancesResponseType element.
Type: TerminateInstancesResponseType (p. 378)
Ancestor: None
Children: requestId, instancesSet
requestId The ID of the request.
Type: xsd:string
Ancestor: TerminateInstancesResponseType
Children: None
instancesSet Instances set.
Type: TerminateInstancesResponseInfoType (p. 377)
Ancestor: TerminateInstancesResponseType
Children: item
item Response item.
Type: TerminateInstancesResponseItemType (p. 378)
Ancestor: instancesSet
Children: instanceId, shutdownState, and previousState
instanceId Instance ID.
Type: xsd:string
Ancestor: item
Children: None
shutdownState Shutdown state.
Type: InstanceStateType (p. 348)
Ancestor: item
Children: code, name
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15130
Name Description
code A 16-bit unsigned integer. The high byte is an opaque internalvalue and should be ignored. The low byte is set based on thestate represented:
Type: xsd:int
Ancestor: shutdownState
Children: None
name The current state of the instance.
Type: xsd:string
Ancestor: shutdownState
Children: None
previousState Previous state.
Type: InstanceStateType (p. 348)
Ancestor: item
Children: code, name
code A 16-bit unsigned integer. The high byte is an opaque internalvalue and should be ignored. The low byte is set based on thestate represented:
Type: xsd:int
Ancestor: previousState
Children: None
name The current state of the instance.
Type: xsd:string
Ancestor: previousState
Children: None
Examples
Example RequestThis example terminates the i-3ea74257 instance.
https://ec2.amazonaws.com/?Action=TerminateInstances&InstanceId.1=i-3ea74257&AuthParams
Example Response<TerminateInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instancesSet> <item> <instanceId>i-3ea74257</instanceId> <shutdownState> <code>32</code> <name>shutting-down</name> </shutdownState> <previousState> <code>16</code> <name>running</name> </previousState>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15131
</item> </instancesSet></TerminateInstancesResponse>
Related Operations• DescribeInstances (p. 69)
Amazon Elastic Compute Cloud API ReferenceUnmonitorInstances
API Version 2009-07-15132
UnmonitorInstances
DescriptionDisables monitoring for a running instance. For more information, refer to the Amazon CloudWatchDeveloper Guide.
Request Parameters
Name Description Required
InstanceId.n Instance ID.
Type: String
Default: None
Yes
Response Elements
Name Description
MonitorInstancesResponseTypeMonitorInstancesResponseType element.
Type: MonitorInstancesResponseType (p. 356)
Ancestor: None
Children: requestId, instancesSet
requestId The ID of the request.
Type: xsd:string
Ancestor: MonitorInstancesResponseType
Children: None
instancesSet Monitor instance response set.
Type: MonitorInstancesResponseSetType (p. 355)
Ancestor: MonitorInstancesResponseType
Children: item
item Instance Item.
Type: MonitorInstancesResponseSetItemType (p. 355)
Ancestor: instancesSet
Children: instanceId, monitoring
instanceId Instance ID.
Type: xsd:string
Ancestor: item
Children: None
monitoring Monitoring information.
Type: InstanceMonitoringStateType (p. 348)
Ancestor: item
Children: state
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15133
Name Description
state State of monitoring for the instance.
Type: xsd:string
Ancestor: monitoring
Children: None
Examples
Example RequestThis example disables monitoring for i-43a4412a and i-23a3397d.
https://ec2.amazonaws.com/?Action=UnmonitorInstances&InstanceId.1=i-43a4412a&InstanceId.2=i-23a3397d&AuthParams
Example Response<UnmonitorInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instancesSet> <item> <instanceId> i-43a4412a</instanceId> <monitoring> <state>pending</state> </monitoring> </item> <item> <instanceId>i-23a3397d</instanceId> <monitoring> <state>pending</state> </monitoring> </item> </instancesSet></UnmonitorInstancesResponse>
Related Operations• MonitorInstances (p. 105)
• RunInstances (p. 120)
Amazon Elastic Compute Cloud API Reference
API Version 2009-07-15134
Amazon EC2 SOAP API
Topics
• List of SOAP Operations by Function (p. 135)
• AllocateAddress (p. 138)
• AssociateAddress (p. 140)
• AttachVolume (p. 142)
• AuthorizeSecurityGroupIngress (p. 145)
• BundleInstance (p. 149)
• CancelBundleTask (p. 155)
• ConfirmProductInstance (p. 159)
• CreateKeyPair (p. 161)
• CreateSecurityGroup (p. 164)
• CreateSnapshot (p. 166)
• CreateVolume (p. 168)
• DeleteKeyPair (p. 171)
• DeleteSecurityGroup (p. 173)
• DeleteSnapshot (p. 175)
• DeleteVolume (p. 177)
• DeregisterImage (p. 179)
• DescribeAddresses (p. 181)
• DescribeAvailabilityZones (p. 184)
• DescribeBundleTasks (p. 187)
• DescribeImageAttribute (p. 191)
• DescribeImages (p. 196)
• DescribeInstances (p. 202)
• DescribeKeyPairs (p. 209)
• DescribeRegions (p. 211)
• DescribeReservedInstances (p. 213)
• DescribeReservedInstancesOfferings (p. 216)
• DescribeSecurityGroups (p. 220)
• DescribeSnapshots (p. 224)
• DescribeVolumes (p. 227)
• DetachVolume (p. 231)
Amazon Elastic Compute Cloud API ReferenceList of SOAP Operations by Function
API Version 2009-07-15135
• DisassociateAddress (p. 234)
• GetConsoleOutput (p. 236)
• GetPasswordData (p. 238)
• ModifyImageAttribute (p. 240)
• MonitorInstances (p. 244)
• PurchaseReservedInstancesOffering (p. 247)
• RebootInstances (p. 249)
• RegisterImage (p. 251)
• ReleaseAddress (p. 253)
• ResetImageAttribute (p. 255)
• RevokeSecurityGroupIngress (p. 257)
• RunInstances (p. 261)
• TerminateInstances (p. 272)
• UnmonitorInstances (p. 275)
List of SOAP Operations by FunctionAmazon DevPay
• ConfirmProductInstance (p. 159)
AMIs
• DeregisterImage (p. 179)
• DescribeImageAttribute (p. 191)
• DescribeImages (p. 196)
• ModifyImageAttribute (p. 240)
Availability Zones and Regions
• DescribeAvailabilityZones (p. 184)
• DescribeRegions (p. 211)
Elastic Block Store
• AttachVolume (p. 142)
• CreateSnapshot (p. 166)
• CreateVolume (p. 168)
• DeleteSnapshot (p. 175)
• DeleteVolume (p. 177)
• DescribeSnapshots (p. 224)
• DescribeVolumes (p. 227)
• DetachVolume (p. 231)
Elastic IP Addresses
• AllocateAddress (p. 138)
Amazon Elastic Compute Cloud API ReferenceList of SOAP Operations by Function
API Version 2009-07-15136
• AssociateAddress (p. 140)
• DescribeAddresses (p. 181)
• DisassociateAddress (p. 234)
• ReleaseAddress (p. 253)
General
• GetConsoleOutput (p. 236)
Images
• RegisterImage (p. 251)
• ResetImageAttribute (p. 255)
Instances
• DescribeInstances (p. 202)
• RebootInstances (p. 249)
• RunInstances (p. 261)
• TerminateInstances (p. 272)
Key Pairs
• CreateKeyPair (p. 161)
• DeleteKeyPair (p. 171)
• DescribeKeyPairs (p. 209)
Monitoring
• MonitorInstances (p. 244)
• UnmonitorInstances (p. 275)
Reserved Instances
• DescribeReservedInstances (p. 213)
• DescribeReservedInstancesOfferings (p. 216)
• PurchaseReservedInstancesOffering (p. 247)
Security Groups
• AuthorizeSecurityGroupIngress (p. 145)
• CreateSecurityGroup (p. 164)
• DeleteSecurityGroup (p. 173)
• DescribeSecurityGroups (p. 220)
• RevokeSecurityGroupIngress (p. 257)
Windows
• BundleInstance (p. 149)
Amazon Elastic Compute Cloud API ReferenceList of SOAP Operations by Function
API Version 2009-07-15137
• CancelBundleTask (p. 155)
• DescribeBundleTasks (p. 187)
• GetPasswordData (p. 238)
Amazon Elastic Compute Cloud API ReferenceAllocateAddress
API Version 2009-07-15138
AllocateAddress
DescriptionAcquires an elastic IP address for use with your account.
Request ParametersThe AllocateAddress operation does not have any request parameters.
Response Elements
Name Description
AllocateAddressResponseTypeAllocateAddressResponseType element.
Type: AllocateAddressResponseType (p. 282)
Ancestor: None
Children: requestId, publicIp
requestId The ID of the request.
Type: xsd:string
Ancestor: AllocateAddressResponseType
Children: None
publicIp IP address for use with your account.
Type: xsd:string
Ancestor: AllocateAddressResponseType
Children: None
Examples
Example RequestThis example returns an elastic IP address for use with the account.
<AllocateAddress xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"></AllocateAddress>
Example Response<AllocateAddressResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <publicIp>67.202.55.255</publicIp></AllocateAddressResponse>
Related Operations• DescribeAddresses (p. 181)
• ReleaseAddress (p. 253)
• AssociateAddress (p. 140)
• DisassociateAddress (p. 234)
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15139
Amazon Elastic Compute Cloud API ReferenceAssociateAddress
API Version 2009-07-15140
AssociateAddress
DescriptionAssociates an elastic IP address with an instance. If the IP address is currently assigned to anotherinstance, the IP address is assigned to the new instance. This is an idempotent operation. If you enterit more than once, Amazon EC2 does not return an error.
Request Parameters
Name Description Required
AssociateAddressType AssociateAddressType element.
Type: AssociateAddressType (p. 283)
Ancestor: None
Children: publicIp, instanceId
publicIp IP address that you are assigning to the instance.
Type: xsd:string
Default: None
Ancestor: AssociateAddressType
Children: None
Yes
instanceId The instance to associate with the IP address.
Type: xsd:string
Default: None
Ancestor: AssociateAddressType
Children: None
Yes
Response Elements
Name Description
AssociateAddressResponseTypeAssociateAddressResponseType element.
Type: AssociateAddressResponseType (p. 283)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: AssociateAddressResponseType
Children: None
return Returns "true" if instance and IP address successfully associated;otherwise "false".
Type: xsd:boolean
Ancestor: AssociateAddressResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15141
Examples
Example RequestThis example associates an IP address with an instance.
<AssociateAddress xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instanceId>i-28a64341</instanceId> <publicIp>67.202.55.255</publicIp></AssociateAddress>
Example Response<AssociateAddressResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></AssociateAddressResponse>
Related Operations• AllocateAddress (p. 138)
• DescribeAddresses (p. 181)
• ReleaseAddress (p. 253)
• DisassociateAddress (p. 234)
Amazon Elastic Compute Cloud API ReferenceAttachVolume
API Version 2009-07-15142
AttachVolume
DescriptionAttaches an Amazon EBS volume to a running instance and exposes it as the specified device.
Note
Windows instances currently support devices xvda through xvdp. Devices xvda and xvdbare reserved by the operating system, xvdc is assigned to drive C:\, and, depending on theinstance type, devices xvdd through xvde might be reserved by the instance stores. Anydevice that is not reserved can be attached to an Amazon EBS volume. For a list of devicesthat are reserved by the instance stores, go to the Amazon Elastic Compute Cloud DeveloperGuide.
Request Parameters
Name Description Required
AttachVolumeType AttachVolumeType element.
Type: AttachVolumeType (p. 286)
Ancestor: None
Children: volumeId, instanceId, and device
volumeId The ID of the Amazon EBS volume. The volume andinstance must be within the same Availability Zone andthe instance must be running.
Type: xsd:string
Default: None
Ancestor: AttachVolumeType
Children: None
Yes
instanceId The ID of the instance to which the volume attaches.The volume and instance must be within the sameAvailability Zone and the instance must be running.
Type: xsd:string
Default: None
Ancestor: AttachVolumeType
Children: None
Yes
device Specifies how the device is exposed to the instance(e.g., /dev/sdh).
Type: xsd:string
Default: None
Ancestor: AttachVolumeType
Children: None
Yes
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15143
Response Elements
Name Description
AttachVolumeResponseType AttachVolumeResponseType element.
Type: AttachVolumeResponseType (p. 285)
Ancestor: None
Children: requestId, volumeId, instanceId, device,status, and attachTime
requestId The ID of the request.
Type: xsd:string
Ancestor: AttachVolumeResponseType
Children: None
volumeId The ID of the volume.
Type: xsd:string
Ancestor: AttachVolumeResponseType
Children: None
instanceId The ID of the instance.
Type: xsd:string
Ancestor: AttachVolumeResponseType
Children: None
device The device as it is exposed to the instance.
Type: xsd:string
Ancestor: AttachVolumeResponseType
Children: None
status Attachment state (e.g., "attaching", "attached", "detaching","detached").
Type: xsd:string
Ancestor: AttachVolumeResponseType
Children: None
attachTime Time stamp when the attachment was initiated.
Type: xsd:dateTime
Ancestor: AttachVolumeResponseType
Children: None
Examples
Example Request
This example attaches volume vol-4d826724 to instance i-6058a509 and exposes it as /dev/sdh.For information on standard storage locations, go to the Amazon Elastic Compute Cloud DeveloperGuide.
<AttachVolume xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <volumeId>vol-4d826724</volumeId> <instanceId>i-6058a509</instanceId>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15144
<device>/dev/sdh</device></AttachVolume>
Example Response<AttachVolumeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <volumeId>vol-4d826724</volumeId> <instanceId>i-6058a509</instanceId> <device>/dev/sdh</device> <status>attaching</status> <attachTime>2008-05-07T11:51:50.000Z</attachTime></AttachVolumeResponse>
Related Operations• CreateVolume (p. 168)
• DeleteVolume (p. 177)
• DescribeVolumes (p. 227)
• DetachVolume (p. 231)
Amazon Elastic Compute Cloud API ReferenceAuthorizeSecurityGroupIngress
API Version 2009-07-15145
AuthorizeSecurityGroupIngress
DescriptionAdds permissions to a security group.
Permissions are specified by the IP protocol (TCP, UDP or ICMP), the source of the request (by IPrange or an Amazon EC2 user-group pair), the source and destination port ranges (for TCP and UDP),and the ICMP codes and types (for ICMP). When authorizing ICMP, -1 can be used as a wildcard inthe type and code fields.
Permission changes are propagated to instances within the security group as quickly as possible.However, depending on the number of instances, a small delay might occur.
When authorizing a user/group pair permission, GroupName, SourceSecurityGroupName andSourceSecurityGroupOwnerId must be specified. When authorizing a CIDR IP permission,GroupName, IpProtocol, FromPort, ToPort and CidrIp must be specified. Mixing these two typesof parameters is not allowed.
Request Parameters
Name Description Required
AuthorizeSecurityGroupIngressTypeAuthorizeSecurityGroupIngressType element.
Type: AuthorizeSecurityGroupIngressType (p. 287)
Ancestor: None
Children: userId, groupName, and ipPermissions
userId AWS Access Key ID.
Type: xsd:string
Default: None
Ancestor: AuthorizeSecurityGroupIngressType
Children: None
Yes
groupName Name of the group to modify. The name must be validand belong to the account
Type: xsd:string
Default: None
Ancestor: AuthorizeSecurityGroupIngressType
Children: None
Yes
ipPermissions Set of permissions.
Type: IpPermissionSetType (p. 349)
Ancestor: AuthorizeSecurityGroupIngressType
Children: item
Yes
item Set of IP permissions.
Type: IpPermissionType (p. 350)
Ancestor: ipPermissions
Children: ipProtocol, fromPort, toPort, groups,and ipRanges
Yes
Amazon Elastic Compute Cloud API ReferenceRequest Parameters
API Version 2009-07-15146
Name Description Required
ipProtocol IP protocol.
Type: xsd:string
Default: None
Valid Values: tcp | udp | icmp
Ancestor: item
Children: None
Yes
fromPort Start of port range for the TCP and UDP protocols,or an ICMP type number. An ICMP type number of -1indicates a wildcard (i.e., any ICMP type number).
Type: xsd:int
Default: None
Ancestor: item
Children: None
Yes
toPort End of port range for the TCP and UDP protocols, oran ICMP code. An ICMP code of -1 indicates a wildcard(i.e., any ICMP code).
Type: xsd:int
Default: None
Ancestor: item
Children: None
Yes
groups List of security group and user ID pairs.
Type: UserIdGroupPairSetType (p. 380)
Ancestor: item
Children: item
Yes
item Information for one security group.
Type: UserIdGroupPairType (p. 380)
Ancestor: groups
Children: userId, groupName
Yes
userId AWS User ID of an account.
Type: xsd:string
Default: None
Ancestor: item
Children: None
Yes
groupName Name of the security group.
Type: xsd:string
Default: None
Ancestor: item
Children: None
Yes
ipRanges IP ranges.
Type: IpRangeSetType (p. 351)
Ancestor: item
Children: item
Yes
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15147
Name Description Required
item Information for one IP range.
Type: IpRangeItemType (p. 351)
Ancestor: ipRanges
Children: cidrIp
Yes
cidrIp CIDR range.
Type: xsd:string
Default: None
Constraints: Valid CIDR IP address range.
Ancestor: item
Children: None
Yes
Response Elements
Name Description
AuthorizeSecurityGroupIngressResponseTypeAuthorizeSecurityGroupIngressResponseType element.
Type: AuthorizeSecurityGroupIngressResponseType (p. 287)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: AuthorizeSecurityGroupIngressResponseType
Children: None
return Returns "true" if request is successful; otherwise "false".
Type: xsd:boolean
Ancestor: AuthorizeSecurityGroupIngressResponseType
Children: None
Examples
Example Request
This example grants TCP port 80 access from the 205.192.0.0/16 address range to the websrvsecurity group.
<AuthorizeSecurityGroupIngress xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <userId/> <groupName>websrv</groupName> <ipPermissions> <item> <ipProtocol>tcp</ipProtocol> <fromPort>80</fromPort> <toPort>80</toPort> <groups/> <ipRanges>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15148
<item> <cidrIp>205.192.0.0/16</cidrIp> </item> </ipRanges> </item> </ipPermissions></AuthorizeSecurityGroupIngress>
Example Response<AuthorizeSecurityGroupIngressResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></AuthorizeSecurityGroupIngressResponse>
Related Operations• CreateSecurityGroup (p. 164)
• DescribeSecurityGroups (p. 220)
• RevokeSecurityGroupIngress (p. 257)
• DeleteSecurityGroup (p. 173)
Amazon Elastic Compute Cloud API ReferenceBundleInstance
API Version 2009-07-15149
BundleInstance
DescriptionBundles the Windows instance. This procedure is not applicable for Linux and UNIX instances. Formore information, go to the Amazon Elastic Compute Cloud Developer Guide or Amazon ElasticCompute Cloud Getting Started Guide.
Note
During bundling, only the root store (C:\) is bundled. Data on other instance stores is notpreserved.
Request Parameters
Name Description Required
BundleInstanceType BundleInstanceType element.
Type: BundleInstanceType (p. 295)
Ancestor: None
Children: instanceId, storage
instanceId The ID of the instance to bundle.
Type: xsd:string
Default: None
Ancestor: BundleInstanceType
Children: None
Yes
storage Amazon S3 storage locations.
Type: BundleInstanceTaskStorageType (p. 293)
Ancestor: BundleInstanceType
Children: S3
Yes
S3 Amazon S3 storage location.
Type: BundleInstanceS3StorageType (p. 291)
Ancestor: storage
Children: bucket, prefix, awsAccessKeyId,uploadPolicy, and uploadPolicySignature
Yes
bucket The bucket in which to store the AMI. You can specifya bucket that you already own or a new bucket thatAmazon EC2 creates on your behalf. If you specify abucket that belongs to someone else, Amazon EC2returns an error.
Type: xsd:string
Default: None
Ancestor: S3
Children: None
Yes
Amazon Elastic Compute Cloud API ReferenceJSON Parameters
API Version 2009-07-15150
Name Description Required
prefix Specifies the beginning of the file name of the AMI.
Type: xsd:string
Default: None
Ancestor: S3
Children: None
Yes
awsAccessKeyId The Access Key ID of the owner of the Amazon S3bucket.
Type: xsd:string
Default: None
Ancestor: S3
Children: None
Yes
uploadPolicy An Amazon S3 upload policy that gives Amazon EC2permission to upload items into Amazon S3 on theuser's behalf. For more information on bundling inWindows, go to the
Type: xsd:string
Default: None
Ancestor: S3
Children: None
Yes
uploadPolicySignature The signature of the Base64 encoded JSON document.
Type: xsd:string
Default: None
Ancestor: S3
Children: None
Yes
JSON ParametersThe upload policy gives Amazon EC2 limited permission to upload items into your Amazon S3bucket. The following table describes the required parameters for the upload policy JSON document.Parameter names are case sensitive. For more information about upload policies and how to signthem, go to the Amazon Elastic Compute Cloud Developer Guide.
Name Description Required
expiration The expiration of the policy. We recommend 12hours or longer.
Yes
conditions A list of restrictions on what can be uploaded toAmazon S3. Must contain the bucket and ACLconditions in this table.
Yes
bucket The bucket to store the AMI. Yes
acl This must be set to ec2-bundle-read. Yes
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15151
Response Elements
Name Description
BundleInstanceResponseTypeBundleInstanceResponseType element.
Type: BundleInstanceResponseType (p. 291)
Ancestor: None
Children: requestId, bundleInstanceTask
requestId The ID of the request.
Type: xsd:string
Ancestor: BundleInstanceResponseType
Children: None
bundleInstanceTask Bundle task.
Type: BundleInstanceTaskType (p. 294)
Ancestor: BundleInstanceResponseType
Children: instanceId, bundleId, state, startTime,updateTime, storage, progress, and error
instanceId Instance associated with this bundle task.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
bundleId Identifier for this task.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
state The state of the task.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
startTime The time this task started.
Type: xsd:dateTime
Ancestor: bundleInstanceTask
Children: None
updateTime The time of the most recent update for the task.
Type: xsd:dateTime
Ancestor: bundleInstanceTask
Children: None
storage Amazon S3 storage locations.
Type: BundleInstanceTaskStorageType (p. 293)
Ancestor: bundleInstanceTask
Children: S3
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15152
Name Description
S3 Amazon S3 storage location.
Type: BundleInstanceS3StorageType (p. 291)
Ancestor: storage
Children: bucket, prefix, awsAccessKeyId, uploadPolicy,and uploadPolicySignature
bucket The bucket in which to store the AMI. You can specify a bucketthat you already own or a new bucket that Amazon EC2 createson your behalf. If you specify a bucket that belongs to someoneelse, Amazon EC2 returns an error.
Type: xsd:string
Ancestor: S3
Children: None
prefix Specifies the beginning of the file name of the AMI.
Type: xsd:string
Ancestor: S3
Children: None
awsAccessKeyId The Access Key ID of the owner of the Amazon S3 bucket.
Type: xsd:string
Ancestor: S3
Children: None
uploadPolicy An Amazon S3 upload policy that gives Amazon EC2 permissionto upload items into Amazon S3 on the user's behalf. For moreinformation on bundling in Windows, go to the
Type: xsd:string
Ancestor: S3
Children: None
uploadPolicySignature The signature of the Base64 encoded JSON document.
Type: xsd:string
Ancestor: S3
Children: None
progress A percentage description of the progress of the task, such as 20%.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
error If the task fails, a description of the error.
Type: BundleInstanceTaskErrorType (p. 292)
Ancestor: bundleInstanceTask
Children: code, message
code Error code.
Type: xsd:string
Ancestor: error
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15153
Name Description
message Error message.
Type: xsd:string
Ancestor: error
Children: None
Examples
Example RequestThis example bundles the i-e468cd8d instance.
<BundleInstance xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instanceId>i-e468cd8d</instanceId> <storage> <S3> <bucket>my-bucket</bucket> <prefix>winami</prefix> <awsAccessKeyId>10QMXFEV71ZS32XQFTR2</awsAccessKeyId> <uploadPolicy>eyJleHBpcmF0aW9uIjogIjIwMDgtMDgtMzBUMDg6NDk6MDlaIiwiY29uZGl0aW9ucyI6IFt7Im J1Y2tldCI6ICJteS1idWNrZXQifSxbInN0YXJ0cy13aXRoIiwgIiRrZXkiLCAibXktbmV3LWltYWdlIl1dfQ==</uploadPolicy> <uploadPolicySignature>w6BZu2oxGsiiLZnoBmQSErotuMA=</uploadPolicySignature> </S3> </storage></BundleInstance>
Example Response<BundleInstanceResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <requestId>bun-c1a540a8</requestId> <bundleInstanceTask> <instanceId>i-12345678</instanceId> <bundleId>bun-c1a540a8</bundleId> <state>bundling</state> <startTime>2008-10-07T11:41:50.000Z</startTime> <updateTime>2008-10-07T11:51:50.000Z</updateTime> <progress>70%</progress> <storage> <S3> <bucket>my-bucket</bucket> <prefix>winami</prefix> </S3> </storage> </bundleInstanceTask></BundleInstanceResponse>
Related Operations• CancelBundleTask (p. 155)
• DescribeBundleTasks (p. 187)
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15154
Amazon Elastic Compute Cloud API ReferenceCancelBundleTask
API Version 2009-07-15155
CancelBundleTask
DescriptionCancels an Amazon EC2 bundling operation. For more information on bundling instances, go to theAmazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud Getting StartedGuide.
Request Parameters
Name Description Required
CancelBundleTaskType CancelBundleTaskType element.
Type: CancelBundleTaskType (p. 296)
Ancestor: None
Children: bundleId
bundleId The ID of the bundle task to cancel.
Type: xsd:string
Default: None
Ancestor: CancelBundleTaskType
Children: None
Yes
Response Elements
Name Description
CancelBundleTaskResponseTypeCancelBundleTaskResponseType element.
Type: CancelBundleTaskResponseType (p. 295)
Ancestor: None
Children: requestId, bundleInstanceTask
requestId The ID of the request.
Type: xsd:string
Ancestor: CancelBundleTaskResponseType
Children: None
bundleInstanceTask Bundle task to cancel.
Type: BundleInstanceTaskType (p. 294)
Ancestor: CancelBundleTaskResponseType
Children: instanceId, bundleId, state, startTime,updateTime, storage, progress, and error
instanceId Instance associated with this bundle task.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15156
Name Description
bundleId Identifier for this task.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
state The state of the task.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
startTime The time this task started.
Type: xsd:dateTime
Ancestor: bundleInstanceTask
Children: None
updateTime The time of the most recent update for the task.
Type: xsd:dateTime
Ancestor: bundleInstanceTask
Children: None
storage Amazon S3 storage locations.
Type: BundleInstanceTaskStorageType (p. 293)
Ancestor: bundleInstanceTask
Children: S3
S3 Amazon S3 storage location.
Type: BundleInstanceS3StorageType (p. 291)
Ancestor: storage
Children: bucket, prefix, awsAccessKeyId, uploadPolicy,and uploadPolicySignature
bucket The bucket in which to store the AMI. You can specify a bucketthat you already own or a new bucket that Amazon EC2 createson your behalf. If you specify a bucket that belongs to someoneelse, Amazon EC2 returns an error.
Type: xsd:string
Ancestor: S3
Children: None
prefix Specifies the beginning of the file name of the AMI.
Type: xsd:string
Ancestor: S3
Children: None
awsAccessKeyId The Access Key ID of the owner of the Amazon S3 bucket.
Type: xsd:string
Ancestor: S3
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15157
Name Description
uploadPolicy An Amazon S3 upload policy that gives Amazon EC2 permissionto upload items into Amazon S3 on the user's behalf. For moreinformation on bundling in Windows, go to the
Type: xsd:string
Ancestor: S3
Children: None
uploadPolicySignature The signature of the Base64 encoded JSON document.
Type: xsd:string
Ancestor: S3
Children: None
progress A percentage description of the progress of the task, such as 20%.
Type: xsd:string
Ancestor: bundleInstanceTask
Children: None
error If the task fails, a description of the error.
Type: BundleInstanceTaskErrorType (p. 292)
Ancestor: bundleInstanceTask
Children: code, message
code Error code.
Type: xsd:string
Ancestor: error
Children: None
message Error message.
Type: xsd:string
Ancestor: error
Children: None
Examples
Example Request
This example cancels the bun-cla322b9 bundle task.
<CancelBundleTask xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <bundleId>bun-cla322b9</bundleId></CancelBundleTask>
Example Response<CancelBundleTaskResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <bundleInstanceTask> <instanceId>i-12345678</instanceId> <bundleId>bun-cla322b9</bundleId> <state>canceling</state> <startTime>2008-10-07T11:41:50.000Z</startTime> <updateTime>2008-10-07T11:51:50.000Z</updateTime>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15158
<progress>20%</progress> <storage> <S3> <bucket>my-bucket</bucket> <prefix>my-new-image</prefix> </S3> </storage> </bundleInstanceTask></CancelBundleTaskResponse>
Related Operations• BundleInstance (p. 149)
• DescribeBundleTasks (p. 187)
Amazon Elastic Compute Cloud API ReferenceConfirmProductInstance
API Version 2009-07-15159
ConfirmProductInstance
DescriptionVerifies whether a Amazon DevPay product code is associated with an instance. This can only beexecuted by the owner of the AMI and is useful when an AMI owner wants to verify whether a user'sinstance is eligible for support.
Request Parameters
Name Description Required
ConfirmProductInstanceTypeConfirmProductInstanceType element.
Type: ConfirmProductInstanceType (p. 297)
Ancestor: None
Children: productCode, instanceId
productCode The product code to confirm.
Type: xsd:string
Default: None
Ancestor: ConfirmProductInstanceType
Children: None
Yes
instanceId The instance to confirm.
Type: xsd:string
Default: None
Ancestor: ConfirmProductInstanceType
Children: None
Yes
Response Elements
Name Description
ConfirmProductInstanceResponseTypeConfirmProductInstanceResponseType element.
Type: ConfirmProductInstanceResponseType (p. 296)
Ancestor: None
Children: requestId, return, and ownerId
requestId The ID of the request.
Type: xsd:string
Ancestor: ConfirmProductInstanceResponseType
Children: None
return Returns "true" if the product code is attached to the instance;otherwise "false".
Type: xsd:boolean
Ancestor: ConfirmProductInstanceResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15160
Name Description
ownerId The instance owner's account ID. Only present if the product codeis attached to the instance.
Type: xsd:string
Ancestor: ConfirmProductInstanceResponseType
Children: None
Examples
Example RequestThis example describes the confirms the product code is associated with the instance.
<ConfirmProductInstance xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <productCode>774F4FF8</productCode> <instanceId>i-10a64379</instanceId></ConfirmProductInstance>
Example Response<ConfirmProductInstanceResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return> <ownerId>254933287430</ownerId></ConfirmProductInstanceResponse>
Related Operations• DescribeInstances (p. 202)
• RunInstances (p. 261)
Amazon Elastic Compute Cloud API ReferenceCreateKeyPair
API Version 2009-07-15161
CreateKeyPair
DescriptionCreates a new 2048-bit RSA key pair with the specified name. The public key is stored by AmazonEC2 and the private key is displayed on the console. The private key is returned as an unencryptedPEM encoded PKCS#8 private key. If a key with the specified name already exists, Amazon EC2returns an error.
Request ParametersName Description Required
CreateKeyPairType CreateKeyPairType element.
Type: CreateKeyPairType (p. 298)
Ancestor: None
Children: keyName
keyName A unique name for the key pair.
Type: xsd:string
Default: None
Constraints: Accepts alphanumeric characters, spaces,dashes, and underscores.
Ancestor: CreateKeyPairType
Children: None
Yes
Response ElementsName Description
CreateKeyPairResponseType CreateKeyPairResponseType element.
Type: CreateKeyPairResponseType (p. 297)
Ancestor: None
Children: requestId, keyName, keyFingerprint, andkeyMaterial
requestId The ID of the request.
Type: xsd:string
Ancestor: CreateKeyPairResponseType
Children: None
keyName The key pair name provided in the original request.
Type: xsd:string
Ancestor: CreateKeyPairResponseType
Children: None
keyFingerprint A SHA-1 digest of the DER encoded private key.
Type: xsd:string
Ancestor: CreateKeyPairResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15162
Name Description
keyMaterial An unencrypted PEM encoded RSA private key.
Type: xsd:string
Ancestor: CreateKeyPairResponseType
Children: None
Examples
Example Request
This example creates a key pair named gsg-keypair.
<CreateKeyPair xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <keyName>gsg-keypair</keyName></CreateKeyPair>
Example Response<CreateKeyPairResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <keyName>gsg-keypair</keyName> <keyFingerprint>1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca:9f:f5:f1:6f</keyFingerprint> <keyMaterial>-----BEGIN RSA PRIVATE KEY-----MIIEoQIBAAKCAQBuLFg5ujHrtm1jnutSuoO8Xe56LlT+HM8v/xkaa39EstM3/aFxTHgElQiJLChpHungXQ29VTc8rc1bW0lkdi23OH5eqkMHGhvEwqa0HWASUMll4o3o/IX+0f2UcPoKCOVUR+jx71Sg5AU52EQfanIn3ZQ8lFW7Edp5a3q4DhjGlUKToHVbicL5E+g45zfB95wIyywWZfeW/UUF3LpGZyq/ebIUlq1qTbHkLbCC2r7RTn8vpQWp47BGVYGtGSBMpTRP5hnbzzuqj3itkiLHjU39S2sJCJ0TrJx5i8BygR4s3mHKBj8l+ePQxG1kGbF6R4yg6sECmXn17MRQVXODNHZbAgMBAAECggEAY1tsiUsIwDl591CXirkYGuVfLyLflXenxfI50mDFms/mumTqloHO7tr0oriHDR5K7wMcY/YY5YkcXNo7mvUVD1pMZNUJs7rw9gZRTrf7LylaJ58kOcyajw8TsC4e4LPbFaHwS1d6K8rXh64o6WgW4SrsB6ICmr1kGQI73wcfgt5ecIu4TZf0OE9IHjn+2eRlsrjBdeORi7KiUNC/pAG23I6MdDOFEQRcCSigCj+4/mciFUSASWS4dMbrpb9FNSIcf9dcLxVM7/6KxgJNfZc9XWzUw77Jg8x92Zd0fVhHOux5IZC+UvSKWB4dyfcItE8C3p9bbU9VGyY5vLCAiIb4qQKBgQDLiO24GXrIkswF32YtBBMuVgLGCwU9h9HlO9mKAc2m8Cm1jUE5IpzRjTedc9I2qiIMUTwtgnw42auSCzbUeYMURPtDqyQ7p6AjMujp9EPemcSVOK9vXYL0PtcoxW9MC0dtV6iPkCN7gOqiZXPRKaFbWADp16p8UAIvS/a5XXk5jwKBgQCKkpHi2EISh1uRkhxljyWCiDCiK6JBRsMvpLbc0v5dKwP5alo1fmdR5PJaV2qvZSj5CYNpMAy1/EDNTY5OSIJU+0KFmQbyhsbmrdLNLDL4+TcnT7c62/aH01ohYaf/VCbRhtLlBfqGoQc7+sAc8vmKkesnF7CqCEKDyF/dhrxYdQKBgC0iZzzNAapayz1+JcVTwwEid6j9JqNXbBc+Z2YwMi+T0Fv/P/hwkX/ypeOXnIUcw0Ih/YtGBVACDQbsz7LcY1HqXiHKYNWNvXgwwO+oiChjxvEkSdsTTIfnK4VSCvU9BxDbQHjdiNDJbL6oar92UN7VrBYvChJZF7LvUH4YmVpHAoGAbZ2X7XvoeEO+uZ58/BGKOIGHByHBDiXtzMhdJr15HTYjxK7OgTZmgK+8zp4L9IbvLGDMJO8vft32XPEWuvI8twCzFH+CsWLQADZMZKSsBasOZ/h1FwhdMgCMcY+Qlzd4JZKjTSu3i7vhvx6RzdSedXEMNTZWN4qlIx3kR5aHcukCgYA9T+Zrvm1F0seQPbLknn7EqhXIjBaTP8TTvW/6bdPi23ExzxZn7KOdrfclYRph1LHMpAONv/x2xALIf91UB+v5ohy1oDoasL0gij1houRe2ERKKdwz0ZL9SWq6VTdhr/5G994CK72fy5WhyERbDjUIdHaK3M849JJuf8cSrvSb4g==-----END RSA PRIVATE KEY-----</keyMaterial></CreateKeyPairResponse>
Related Operations• RunInstances (p. 261)
• DescribeKeyPairs (p. 209)
• DeleteKeyPair (p. 171)
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15163
Amazon Elastic Compute Cloud API ReferenceCreateSecurityGroup
API Version 2009-07-15164
CreateSecurityGroup
DescriptionCreates a new security group. Group names must be unique per account.
Every instance is launched in a security group. If no security group is specified during launch, theinstances are launched in the default security group. Instances within the same security group haveunrestricted network access to each other. Instances will reject network access attempts from otherinstances in a different security group. As the owner of instances you can grant or revoke specificpermissions using the AuthorizeSecurityGroupIngress and RevokeSecurityGroupIngressoperations.
Request Parameters
Name Description Required
CreateSecurityGroupTypeCreateSecurityGroupType element.
Type: CreateSecurityGroupType (p. 299)
Ancestor: None
Children: groupName, groupDescription
groupName Name of the security group.
Type: xsd:string
Default: None
Constraints: Accepts alphanumeric characters, spaces,dashes, and underscores.
Ancestor: CreateSecurityGroupType
Children: None
Yes
groupDescription Description of the group. This is informational only. Ifthe description contains spaces, you must enclose it insingle quotes (') or URL-encode it.
Type: xsd:string
Default: None
Constraints: Accepts alphanumeric characters, spaces,dashes, and underscores.
Ancestor: CreateSecurityGroupType
Children: None
Yes
Response Elements
Name Description
CreateSecurityGroupResponseTypeCreateSecurityGroupResponseType element.
Type: CreateSecurityGroupResponseType (p. 298)
Ancestor: None
Children: requestId, return
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15165
Name Description
requestId The ID of the request.
Type: xsd:string
Ancestor: CreateSecurityGroupResponseType
Children: None
return Returns "true" if creation succeeded; otherwise "false".
Type: xsd:boolean
Ancestor: CreateSecurityGroupResponseType
Children: None
Examples
Example RequestThis example creates the websrv security group.
<CreateSecurityGroup xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <groupName>websrv</groupName> <groupDescription>Web Servers</groupDescription></CreateSecurityGroup>
Example Response<CreateSecurityGroupResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></CreateSecurityGroupResponse>
Related Operations• RunInstances (p. 261)
• DescribeSecurityGroups (p. 220)
• AuthorizeSecurityGroupIngress (p. 145)
• RevokeSecurityGroupIngress (p. 257)
• DeleteSecurityGroup (p. 173)
Amazon Elastic Compute Cloud API ReferenceCreateSnapshot
API Version 2009-07-15166
CreateSnapshot
DescriptionCreates a snapshot of an Amazon EBS volume and stores it in Amazon S3. You can use snapshotsfor backups, to make identical copies of instance devices, and to save data before shutting downan instance. For more information about Amazon EBS, go to the Amazon Elastic Compute CloudDeveloper Guide.
When taking a snapshot of a file system, we recommend unmounting it first. This ensures thefile system metadata is in a consistent state, that the 'mounted indicator' is cleared, and that allapplications using that file system are stopped and in a consistent state. Some file systems, such asxfs, can freeze and unfreeze activity so a snapshot can be made without unmounting.
For Linux/UNIX, enter the following command from the command line.
# umount -d /dev/sdh
For Windows, open Disk Management, right-click the volume to unmount, and select Change DriveLetter and Path. Then, select the mount point to remove and click Remove.
Request Parameters
Name Description Required
CreateSnapshotType CreateSnapshotType element.
Type: CreateSnapshotType (p. 300)
Ancestor: None
Children: volumeId
volumeId The ID of the Amazon EBS volume to take a snapshotof.
Type: xsd:string
Default: None
Ancestor: CreateSnapshotType
Children: None
Yes
Response Elements
Name Description
CreateSnapshotResponseTypeCreateSnapshotResponseType element.
Type: CreateSnapshotResponseType (p. 299)
Ancestor: None
Children: requestId, snapshotId, volumeId, status,startTime, and progress
requestId The ID of the request.
Type: xsd:string
Ancestor: CreateSnapshotResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15167
Name Description
snapshotId The ID of the snapshot.
Type: xsd:string
Ancestor: CreateSnapshotResponseType
Children: None
volumeId The ID of the volume.
Type: xsd:string
Ancestor: CreateSnapshotResponseType
Children: None
status Snapshot state (e.g., "pending", "completed", "error")
Type: xsd:string
Ancestor: CreateSnapshotResponseType
Children: None
startTime Time stamp when the snapshot was initiated.
Type: xsd:dateTime
Ancestor: CreateSnapshotResponseType
Children: None
progress The progress of the snapshot, in percentage.
Type: xsd:string
Ancestor: CreateSnapshotResponseType
Children: None
Examples
Example RequestThis example creates a snapshot of volume vol-4d826724.
<CreateSnapshot xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <volumeId>vol-4d826724</volumeId></CreateSnapshot>
Example Response<CreateSnapshotResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <snapshotId>snap-78a54011</snapshotId> <volumeId>vol-4d826724</volumeId> <status>pending</status> <startTime>2008-05-07T12:51:50.000Z</startTime> <progress>60%</progress></CreateSnapshotResponse>
Related Operations• DeleteSnapshot (p. 175)
• DescribeSnapshots (p. 224)
Amazon Elastic Compute Cloud API ReferenceCreateVolume
API Version 2009-07-15168
CreateVolume
DescriptionCreates a new Amazon EBS volume to which any Amazon EC2 instance can attach within the sameAvailability Zone. For more information about Amazon EBS, go to the Amazon Elastic Compute CloudDeveloper Guide.
Note
You must specify an Availability Zone when creating a volume. The volume and the instance towhich it attaches must be in the same Availability Zone.
Request Parameters
Name Description Required
CreateVolumeType CreateVolumeType element.
Type: CreateVolumeType (p. 301)
Ancestor: None
Children: size, snapshotId, and availabilityZone
size The size of the volume, in GiBs. Required if you are notcreating a volume from a snapshot.
Type: xsd:string
Default: None
Valid Values: 1 -1024
Ancestor: CreateVolumeType
Children: None
Yes
snapshotId The snapshot from which to create the new volume.
Type: xsd:string
Default: None
Ancestor: CreateVolumeType
Children: None
No
availabilityZone The Availability Zone in which to create the new volume.
Type: xsd:string
Default: None
Ancestor: CreateVolumeType
Children: None
Yes
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15169
Response Elements
Name Description
CreateVolumeResponseType CreateVolumeResponseType element.
Type: CreateVolumeResponseType (p. 300)
Ancestor: None
Children: requestId, volumeId, size, snapshotId,availabilityZone, status, and createTime
requestId The ID of the request.
Type: xsd:string
Ancestor: CreateVolumeResponseType
Children: None
volumeId The ID of the volume.
Type: xsd:string
Ancestor: CreateVolumeResponseType
Children: None
size The size of the volume, in GiBs.
Type: xsd:string
Ancestor: CreateVolumeResponseType
Children: None
snapshotId Snapshot from which the volume was created, if applicable.
Type: xsd:string
Ancestor: CreateVolumeResponseType
Children: None
availabilityZone Availability Zone in which the volume was created.
Type: xsd:string
Ancestor: CreateVolumeResponseType
Children: None
status Volume state (e.g., "creating", "available", "in-use", "deleting","error")
Type: xsd:string
Ancestor: CreateVolumeResponseType
Children: None
createTime Time stamp when volume creation was initiated.
Type: xsd:dateTime
Ancestor: CreateVolumeResponseType
Children: None
Examples
Example Request
This example creates a new 800 GiB volume in Availability Zone us-east-1a.
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15170
<CreateVolume xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <size>800</size> <availabilityZone>us-east-1a</availabilityZone></CreateVolume>
Example Response<CreateVolumeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <volumeId>vol-4d826724</volumeId> <size>800</size> <status>creating</status> <createTime>2008-05-07T11:51:50.000Z</createTime> <availabilityZone>us-east-1a</availabilityZone> <snapshotId></snapshotId></CreateVolumeResponse>
Related Operations• DeleteVolume (p. 177)
• DescribeVolumes (p. 227)
• AttachVolume (p. 142)
• DetachVolume (p. 231)
• DescribeAvailabilityZones (p. 184)
Amazon Elastic Compute Cloud API ReferenceDeleteKeyPair
API Version 2009-07-15171
DeleteKeyPair
DescriptionDeletes the specified key pair, by removing the public key from Amazon EC2. You must own the keypair.
Request ParametersName Description Required
DeleteKeyPairType DeleteKeyPairType element.
Type: DeleteKeyPairType (p. 302)
Ancestor: None
Children: keyName
keyName Name of the key pair to delete.
Type: xsd:string
Default: None
Ancestor: DeleteKeyPairType
Children: None
Yes
Response ElementsName Description
DeleteKeyPairResponseType DeleteKeyPairResponseType element.
Type: DeleteKeyPairResponseType (p. 302)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: DeleteKeyPairResponseType
Children: None
return Returns "true" if deletion succeeded; otherwise "false".
Type: xsd:boolean
Ancestor: DeleteKeyPairResponseType
Children: None
Examples
Example RequestThis example deletes the gsg-keypair key pair.
<DeleteKeyPair xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <keyName>gsg-keypair</keyName>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15172
</DeleteKeyPair>
Example Response<DeleteKeyPairResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></DeleteKeyPairResponse>
Related Operations• CreateKeyPair (p. 161)
• DescribeKeyPairs (p. 209)
Amazon Elastic Compute Cloud API ReferenceDeleteSecurityGroup
API Version 2009-07-15173
DeleteSecurityGroup
DescriptionDeletes a security group that you own.
Note
If you attempt to delete a security group that contains instances, a fault is returned.
If you attempt to delete a security group that is referenced by another security group, a fault isreturned. For example, if security group B has a rule that allows access from security group A,security group A cannot be deleted until the allow rule is removed.
Request Parameters
Name Description Required
DeleteSecurityGroupTypeDeleteSecurityGroupType element.
Type: DeleteSecurityGroupType (p. 303)
Ancestor: None
Children: groupName
groupName Name of the security group to delete.
Type: xsd:string
Default: None
Ancestor: DeleteSecurityGroupType
Children: None
Yes
Response Elements
Name Description
DeleteSecurityGroupResponseTypeDeleteSecurityGroupResponseType element.
Type: DeleteSecurityGroupResponseType (p. 303)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: DeleteSecurityGroupResponseType
Children: None
return Returns "true" if deletion succeeded; otherwise "false".
Type: xsd:boolean
Ancestor: DeleteSecurityGroupResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15174
Examples
Example RequestThis example deletes the websrv security group.
<DeleteSecurityGroup xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <groupName>websrv</groupName></DeleteSecurityGroup>
Example Response<DeleteSecurityGroupResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></DeleteSecurityGroupResponse>
Related Operations• CreateSecurityGroup (p. 164)
• DescribeSecurityGroups (p. 220)
• AuthorizeSecurityGroupIngress (p. 145)
• RevokeSecurityGroupIngress (p. 257)
Amazon Elastic Compute Cloud API ReferenceDeleteSnapshot
API Version 2009-07-15175
DeleteSnapshot
DescriptionDeletes a snapshot of an Amazon EBS volume that you own. For more information, go to the AmazonElastic Compute Cloud Developer Guide.
Request ParametersName Description Required
DeleteSnapshotType DeleteSnapshotType element.
Type: DeleteSnapshotType (p. 304)
Ancestor: None
Children: snapshotId
snapshotId The ID of the Amazon EBS snapshot to delete.
Type: xsd:string
Default: None
Ancestor: DeleteSnapshotType
Children: None
Yes
Response ElementsName Description
DeleteSnapshotResponseTypeDeleteSnapshotResponseType element.
Type: DeleteSnapshotResponseType (p. 304)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: DeleteSnapshotResponseType
Children: None
return Returns "true" if deletion succeeded; otherwise "false".
Type: xsd:boolean
Ancestor: DeleteSnapshotResponseType
Children: None
Examples
Example RequestThis example deletes snapshot snap-78a54011.
<DeleteSnapshot xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <snapshotId>snap-78a54011</snapshotId>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15176
</DeleteSnapshot>
Example Response<DeleteSnapshotResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></DeleteSnapshotResponse>
Related Operations• CreateSnapshot (p. 166)
• DescribeSnapshots (p. 224)
Amazon Elastic Compute Cloud API ReferenceDeleteVolume
API Version 2009-07-15177
DeleteVolume
DescriptionDeletes an Amazon EBS volume that you own. For more information about Amazon EBS, go to theAmazon Elastic Compute Cloud Developer Guide.
Note
The volume remains in the deleting state for several minutes after you enter this command.
Request Parameters
Name Description Required
DeleteVolumeType DeleteVolumeType element.
Type: DeleteVolumeType (p. 305)
Ancestor: None
Children: volumeId
volumeId The ID of the volume to delete. The volume remains inthe "deleting" state for several minutes after entering thiscommand.
Type: xsd:string
Default: None
Ancestor: DeleteVolumeType
Children: None
Yes
Response Elements
Name Description
DeleteVolumeResponseType DeleteVolumeResponseType element.
Type: DeleteVolumeResponseType (p. 304)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: DeleteVolumeResponseType
Children: None
return Returns "true" if deletion succeeded; otherwise "false".
Type: xsd:boolean
Ancestor: DeleteVolumeResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15178
Examples
Example RequestThis example deletes volume vol-4282672b.
<DeleteVolume xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <volumeId>vol-4282672b</volumeId></DeleteVolume>
Example Response<DeleteVolumeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></DeleteVolumeResponse>
Related Operations• CreateVolume (p. 168)
• DescribeVolumes (p. 227)
• AttachVolume (p. 142)
• DetachVolume (p. 231)
Amazon Elastic Compute Cloud API ReferenceDeregisterImage
API Version 2009-07-15179
DeregisterImage
DescriptionDeregisters the specified AMI. Once deregistered, the AMI cannot be used to launch new instances.
Note
This command does not delete the AMI from Amazon S3.
Request Parameters
Name Description Required
DeregisterImageType DeregisterImageType element.
Type: DeregisterImageType (p. 306)
Ancestor: None
Children: imageId
imageId Unique ID of the AMI which was assigned duringregistration. To register an AMI, use "RegisterImage". Toview the AMI IDs of AMIs that belong to your account.use "DescribeImages".
Type: xsd:string
Default: None
Ancestor: DeregisterImageType
Children: None
Yes
Response Elements
Name Description
DeregisterImageResponseTypeDeregisterImageResponseType element.
Type: DeregisterImageResponseType (p. 305)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: DeregisterImageResponseType
Children: None
return Returns "true" if deregistration succeeded; otherwise "false".
Type: xsd:boolean
Ancestor: DeregisterImageResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15180
Examples
Example RequestThis example deregisters the ami-4fa54026 AMI.
<DeregisterImage xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imageId>ami-4fa54026</imageId></DeregisterImage>
Example Response<DeregisterImageResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></DeregisterImageResponse>
Related Operations• RegisterImage (p. 251)
• DescribeImages (p. 196)
Amazon Elastic Compute Cloud API ReferenceDescribeAddresses
API Version 2009-07-15181
DescribeAddresses
DescriptionLists elastic IP addresses assigned to your account or provides information about a specific address.
Request Parameters
Name Description Required
DescribeAddressesType DescribeAddressesType element.
Type: DescribeAddressesType (p. 309)
Ancestor: None
Children: publicIpsSet
publicIpsSet Set of elastic IP addresses.
Type: DescribeAddressesInfoType (p. 306)
Ancestor: DescribeAddressesType
Children: item
Yes, but canbe empty
item Information for one elastic IP address.
Type: DescribeAddressesItemType (p. 307)
Ancestor: publicIpsSet
Children: publicIp
publicIp Elastic IP address to describe.
Type: xsd:string
Default: None
Ancestor: item
Children: None
Yes, but canbe empty
Response Elements
Name Description
DescribeAddressesResponseTypeDescribeAddressesResponseType element.
Type: DescribeAddressesResponseType (p. 308)
Ancestor: None
Children: requestId, addressesSet
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeAddressesResponseType
Children: None
addressesSet The set of IP addresses.
Type: DescribeAddressesResponseInfoType (p. 307)
Ancestor: DescribeAddressesResponseType
Children: item
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15182
Name Description
item Information about an instance.
Type: DescribeAddressesResponseItemType (p. 308)
Ancestor: addressesSet
Children: publicIp, instanceId
publicIp The public IP address.
Type: xsd:string
Ancestor: item
Children: None
instanceId The ID of the instance.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example RequestThis example describes elastic IP addresses assigned to the account. Amazon EC2 returns67.202.55.255 which is assigned to instance i-f15ebb98 and 67.202.55.233 which is not assigned to aninstance.
<DescribeAddresses xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <publicIpsSet> <item> <publicIp>67.202.55.255</publicIp> </item> <item> <publicIp>67.202.55.233</publicIp> </item> </publicIpsSet></DescribeAddresses>
Example Response<DescribeAddressesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <addressesSet> <item> <instanceId>i-f15ebb98</instanceId> <publicIp>67.202.55.255</publicIp> </item> <item> <publicIp>67.202.55.233</publicIp> </item> </addressesSet> </DescribeAddressesResponse>
Related Operations• AllocateAddress (p. 138)
• ReleaseAddress (p. 253)
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15183
Amazon Elastic Compute Cloud API ReferenceDescribeAvailabilityZones
API Version 2009-07-15184
DescribeAvailabilityZonesDescriptionDisplays Availability Zones that are currently available to the account and their states.
Note
Availability Zones are not the same across accounts. The Availability Zone us-east-1a foraccount A is not necessarily the same as us-east-1a for account B. Zone assignments aremapped independently for each account.
Request ParametersName Description Required
DescribeAvailabilityZonesTypeDescribeAvailabilityZonesType element.
Type: DescribeAvailabilityZonesType (p. 311)
Ancestor: None
Children: availabilityZoneSet
availabilityZoneSet Set of Availability Zones.
Type: DescribeAvailabilityZonesSetType (p. 310)
Ancestor: DescribeAvailabilityZonesType
Children: item
No
item Information for one Availability Zone.
Type: DescribeAvailabilityZonesSetItemType (p. 310)
Ancestor: availabilityZoneSet
Children: zoneName
zoneName Availability Zone name.
Type: xsd:string
Default: None
Ancestor: item
Children: None
No
Response ElementsName Description
DescribeAvailabilityZonesResponseTypeDescribeAvailabilityZonesResponseType element.
Type: DescribeAvailabilityZonesResponseType (p. 309)
Ancestor: None
Children: requestId, availabilityZoneInfo
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeAvailabilityZonesResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15185
Name Description
availabilityZoneInfo Availability Zone information.
Type: AvailabilityZoneSetType (p. 289)
Ancestor: DescribeAvailabilityZonesResponseType
Children: item
item Information for one Availability Zone.
Type: AvailabilityZoneItemType (p. 288)
Ancestor: availabilityZoneInfo
Children: zoneName, zoneState, regionName, andmessageSet
zoneName Name of the Availability Zone.
Type: xsd:string
Ancestor: item
Children: None
zoneState State of the Availability Zone.
Type: xsd:string
Ancestor: item
Children: None
regionName Name of the region.
Type: xsd:string
Ancestor: item
Children: None
messageSet Message set.
Type: AvailabilityZoneMessageSetType (p. 288)
Ancestor: item
Children: item
item Availability Zone message set.
Type: AvailabilityZoneMessageType (p. 289)
Ancestor: messageSet
Children: message
message The Availability Zone message.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example Request
This example displays information about Availability Zones that are available to the account.
<DescribeAvailabilityZones xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <availabilityZoneSet/></DescribeAvailabilityZones>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15186
Example Response<DescribeAvailabilityZonesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <availabilityZoneInfo> <item> <zoneName>us-east-1a</zoneName> <zoneState>available</zoneState> </item> <item> <zoneName>us-east-1b</zoneName> <zoneState>available</zoneState> </item> <item> <zoneName>us-east-1c</zoneName> <zoneState>available</zoneState> </item> <item> <zoneName>us-east-1d</zoneName> <zoneState>available</zoneState> </item> </availabilityZoneInfo></DescribeAvailabilityZonesResponse>
Related Operations• RunInstances (p. 261)
• DescribeRegions (p. 211)
Amazon Elastic Compute Cloud API ReferenceDescribeBundleTasks
API Version 2009-07-15187
DescribeBundleTasks
DescriptionDescribes current bundling tasks. For more information on bundling instances, go to the AmazonElastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud Getting Started Guide.
Request Parameters
Name Description Required
DescribeBundleTasksTypeDescribeBundleTasksType element.
Type: DescribeBundleTasksType (p. 312)
Ancestor: None
Children: bundlesSet
bundlesSet Set of bundle tasks.
Type: DescribeBundleTasksInfoType (p. 311)
Ancestor: DescribeBundleTasksType
Children: item
item Information for one bundle task.
Type: DescribeBundleTasksItemType (p. 311)
Ancestor: bundlesSet
Children: bundleId
bundleId The ID of the bundle task to describe.
Type: xsd:string
Default: If no ID is specified, all bundle tasks aredescribed.
Ancestor: item
Children: None
No
Response Elements
Name Description
DescribeBundleTasksResponseTypeDescribeBundleTasksResponseType element.
Type: DescribeBundleTasksResponseType (p. 312)
Ancestor: None
Children: requestId, bundleInstanceTasksSet
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeBundleTasksResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15188
Name Description
bundleInstanceTasksSet Bundle task set.
Type: BundleInstanceTasksSetType (p. 293)
Ancestor: DescribeBundleTasksResponseType
Children: item
item Bundle task.
Type: BundleInstanceTaskType (p. 294)
Ancestor: bundleInstanceTasksSet
Children: instanceId, bundleId, state, startTime,updateTime, storage, progress, and error
instanceId Instance associated with this bundle task.
Type: xsd:string
Ancestor: item
Children: None
bundleId Identifier for this task.
Type: xsd:string
Ancestor: item
Children: None
state The state of the task.
Type: xsd:string
Ancestor: item
Children: None
startTime The time this task started.
Type: xsd:dateTime
Ancestor: item
Children: None
updateTime The time of the most recent update for the task.
Type: xsd:dateTime
Ancestor: item
Children: None
storage Amazon S3 storage locations.
Type: BundleInstanceTaskStorageType (p. 293)
Ancestor: item
Children: S3
S3 Amazon S3 storage location.
Type: BundleInstanceS3StorageType (p. 291)
Ancestor: storage
Children: bucket, prefix, awsAccessKeyId, uploadPolicy,and uploadPolicySignature
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15189
Name Description
bucket The bucket in which to store the AMI. You can specify a bucketthat you already own or a new bucket that Amazon EC2 createson your behalf. If you specify a bucket that belongs to someoneelse, Amazon EC2 returns an error.
Type: xsd:string
Ancestor: S3
Children: None
prefix Specifies the beginning of the file name of the AMI.
Type: xsd:string
Ancestor: S3
Children: None
awsAccessKeyId The Access Key ID of the owner of the Amazon S3 bucket.
Type: xsd:string
Ancestor: S3
Children: None
uploadPolicy An Amazon S3 upload policy that gives Amazon EC2 permissionto upload items into Amazon S3 on the user's behalf. For moreinformation on bundling in Windows, go to the
Type: xsd:string
Ancestor: S3
Children: None
uploadPolicySignature The signature of the Base64 encoded JSON document.
Type: xsd:string
Ancestor: S3
Children: None
progress A percentage description of the progress of the task, such as 20%.
Type: xsd:string
Ancestor: item
Children: None
error If the task fails, a description of the error.
Type: BundleInstanceTaskErrorType (p. 292)
Ancestor: item
Children: code, message
code Error code.
Type: xsd:string
Ancestor: error
Children: None
message Error message.
Type: xsd:string
Ancestor: error
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15190
Examples
Example RequestThis example describes the status of the bun-57a5403e bundle task.
<DescribeBundleTasks xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <bundlesSet> <item> <bundleId>bun-57a5403e</bundleId> </item> </bundlesSet></DescribeBundleTasks>
Example Response<DescribeBundleTasksResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <bundleInstanceTasksSet> <item> <instanceId>i-12345678</instanceId> <bundleId>bun-c1a540a8</bundleId> <state>canceling</state> <startTime>2008-10-07T11:41:50.000Z</startTime> <updateTime>2008-10-07T11:51:50.000Z</updateTime> <progress>20%</progress> <storage> <S3> <bucket>my-bucket</bucket> <prefix>winami</prefix> </S3> </storage> </item> <bundleInstanceTasksSet></DescribeBundleTasksResponse>
Related Operations• BundleInstance (p. 149)
• CancelBundleTask (p. 155)
Amazon Elastic Compute Cloud API ReferenceDescribeImageAttribute
API Version 2009-07-15191
DescribeImageAttribute
DescriptionReturns information about an attribute of an AMI. Only one attribute can be specified per call.
Request Parameters
Name Description Required
DescribeImageAttributeTypeDescribeImageAttributeType element.
Type: DescribeImageAttributeType (p. 314)
Ancestor: None
Children: imageId,DescribeImageAttributesGroup
imageId The ID of the AMI for which an attribute will bedescribed.
Type: xsd:string
Default: None
Ancestor: DescribeImageAttributeType
Children: None
Yes
DescribeImageAttributesGroupThe image attributes group.
Type: DescribeImageAttributesGroup (p. 314)
Ancestor: DescribeImageAttributeType
Children: launchPermission, productCodes,kernel, ramdisk, and blockDeviceMapping
launchPermission Describes the launch permissions associated with theAMI.
Type: EmptyElementType (p. 344)
Ancestor: DescribeImageAttributesGroup
Children: none
No
none These element contains no options.
Type: xsd:string
Default: None
Ancestor: launchPermission
Children: None
No
productCodes Describes the product code associated with the AMI.
Type: EmptyElementType (p. 344)
Ancestor: DescribeImageAttributesGroup
Children: none
No
none These element contains no options.
Type: xsd:string
Default: None
Ancestor: productCodes
Children: None
No
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15192
Name Description Required
kernel Describes the ID of the kernel associated with the AMI.
Type: EmptyElementType (p. 344)
Ancestor: DescribeImageAttributesGroup
Children: none
No
none These element contains no options.
Type: xsd:string
Default: None
Ancestor: kernel
Children: None
No
ramdisk Describes the ID of the RAM disk associated with theAMI.
Type: EmptyElementType (p. 344)
Ancestor: DescribeImageAttributesGroup
Children: none
No
none These element contains no options.
Type: xsd:string
Default: None
Ancestor: ramdisk
Children: None
No
blockDeviceMapping Describes the mapping that defines native device namesto use when exposing virtual devices.
Type: EmptyElementType (p. 344)
Ancestor: DescribeImageAttributesGroup
Children: none
No
none These element contains no options.
Type: xsd:string
Default: None
Ancestor: blockDeviceMapping
Children: None
No
Response Elements
Name Description
DescribeImageAttributeResponseTypeDescribeImageAttributeResponseType element.
Type: DescribeImageAttributeResponseType (p. 313)
Ancestor: None
Children: requestId, imageId, launchPermission,productCodes, kernel, ramdisk, and blockDeviceMapping
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeImageAttributeResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15193
Name Description
imageId The ID of the AMI.
Type: xsd:string
Ancestor: DescribeImageAttributeResponseType
Children: None
launchPermission Launch permissions set.
Type: LaunchPermissionListType (p. 352)
Ancestor: DescribeImageAttributeResponseType
Children: item
item Information for launch permissions.
Type: LaunchPermissionItemType (p. 352)
Ancestor: launchPermission
Children: userId, group
userId User IDs associated with the launchPermission attribute.
Type: xsd:string
Ancestor: item
Children: None
group Security groups associated with the launchPermission attribute.You can specify the "all" group, which will make it a public AMI.
Type: xsd:string
Ancestor: item
Children: None
productCodes Product codes set.
Type: ProductCodeListType (p. 360)
Ancestor: DescribeImageAttributeResponseType
Children: item
item Information for one product code.
Type: ProductCodeItemType (p. 359)
Ancestor: productCodes
Children: productCode
productCode Amazon DevPay product code. Currently only one product codecan be associated with an AMI. Once set, the product code cannotbe changed or reset.
Type: xsd:string
Ancestor: item
Children: None
kernel Kernel set.
Type: NullableAttributeValueType (p. 358)
Ancestor: DescribeImageAttributeResponseType
Children: value
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15194
Name Description
value ID of the kernel or RAM disk.
Type: xsd:string
Ancestor: kernel
Children: None
ramdisk RAM disk set.
Type: NullableAttributeValueType (p. 358)
Ancestor: DescribeImageAttributeResponseType
Children: value
value ID of the kernel or RAM disk.
Type: xsd:string
Ancestor: ramdisk
Children: None
blockDeviceMapping Block device mapping set.
Type: BlockDeviceMappingType (p. 290)
Ancestor: DescribeImageAttributeResponseType
Children: item
item Information for one block device mapping.
Type: BlockDeviceMappingItemType (p. 290)
Ancestor: blockDeviceMapping
Children: virtualName, deviceName
virtualName The virtual name.
Type: xsd:string
Ancestor: item
Children: None
deviceName The device name (e.g., /dev/sdh).
Type: xsd:string
Ancestor: item
Children: None
Examples
Example RequestThis example lists the launch permissions for the ami-61a54008 AMI
<DescribeImageAttribute xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imageId>&exampleamiid;</imageId> <launchPermission/></DescribeImageAttribute>
Example Response<DescribeImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imageId>ami-61a54008</imageId>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15195
<launchPermission> <item> <group>all</group> </item> <item> <userId>495219933132</userId> </item> </launchPermission></DescribeImageAttributeResponse>
Example RequestThis example lists the product code for the ami-2bb65342AMI.
<DescribeImageAttribute xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imageId>&exampleamiid;</imageId> <productCodes/></DescribeImageAttribute>
Example Response<DescribeImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imageId>ami-61a54008</imageId> <productCodes> <item> <productCode>774F4FF8</productCode> </item> </productCodes> </DescribeImageAttributeResponse>
Related Operations• DescribeImages (p. 196)
• ModifyImageAttribute (p. 240)
• ResetImageAttribute (p. 255)
Amazon Elastic Compute Cloud API ReferenceDescribeImages
API Version 2009-07-15196
DescribeImages
DescriptionReturns information about AMIs, AKIs, and ARIs. This includes image type, product codes,architecture, and kernel and RAM disk IDs. Images available to you include public images, privateimages that you own, and private images owned by other users for which you have explicit launchpermissions.
Launch permissions fall into three categories:
LaunchPermission
Description
public The owner of the AMI granted launch permissions for the AMI to the all group.All users have launch permissions for these AMIs.
explicit The owner of the AMI granted launch permissions to a specific user.
implicit A user has implicit launch permissions for all AMIs he or she owns.
The list of AMIs returned can be modified by specifying AMI IDs, AMI owners, or users with launchpermissions. If no options are specified, Amazon EC2 returns all AMIs for which the user has launchpermissions.
If you specify one or more AMI IDs, only AMIs that have the specified IDs are returned. If you specifyan invalid AMI ID, a fault is returned. If you specify an AMI ID for which you do not have access, it willnot be included in the returned results.
If you specify one or more AMI owners, only AMIs from the specified owners and for which you haveaccess are returned. The results can include the account IDs of the specified owners, amazon for AMIsowned by Amazon or self for AMIs that you own.
If you specify a list of executable users, only users that have launch permissions for the AMIs arereturned. You can specify account IDs (if you own the AMI(s)), self for AMIs for which you own orhave explicit permissions, or all for public AMIs.
Note
Deregistered images are included in the returned results for an unspecified interval afterderegistration.
Request Parameters
Name Description Required
DescribeImagesType DescribeImagesType element.
Type: DescribeImagesType (p. 320)
Ancestor: None
Children: executableBySet, imagesSet, andownersSet
Amazon Elastic Compute Cloud API ReferenceRequest Parameters
API Version 2009-07-15197
Name Description Required
executableBySet Executable set.
Type: DescribeImagesExecutableBySetType (p. 315)
Ancestor: DescribeImagesType
Children: item
Yes, but canbe empty
item Information for one user.
Type: DescribeImagesExecutableByType (p. 315)
Ancestor: executableBySet
Children: user
No
user Returns AMIs for which the specified user has explicitlaunch permissions. The user ID can be a user's accountID, "self" to return AMIs for which the sender of therequest has explicit launch permissions, or "all" to returnAMIs with public launch permissions.
Type: xsd:string
Default: None
Ancestor: item
Children: None
No
imagesSet Image set.
Type: DescribeImagesInfoType (p. 316)
Ancestor: DescribeImagesType
Children: item
Yes, but canbe empty
item Information for one image.
Type: DescribeImagesItemType (p. 316)
Ancestor: imagesSet
Children: imageId
No
imageId AMI IDs to describe.
Type: xsd:string
Default: Returns all AMIs.
Ancestor: item
Children: None
No
ownersSet Information about an owner.
Type: DescribeImagesOwnersType (p. 317)
Ancestor: DescribeImagesType
Children: item
Yes, but canbe empty
item Information for one owner.
Type: DescribeImagesOwnerType (p. 317)
Ancestor: ownersSet
Children: owner
No
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15198
Name Description Required
owner Returns AMIs owned by the specified owner. Multipleowners can be specified. The IDs "amazon", "self",and "explicit" can be used to include AMIs owned byAmazon, AMIs owned by the user, and AMIs for whichthe user has explicit launch permissions, respectively.
Type: xsd:string
Default: None
Ancestor: item
Children: None
No
Response Elements
Name Description
DescribeImagesResponseTypeDescribeImagesResponseType element.
Type: DescribeImagesResponseType (p. 319)
Ancestor: None
Children: requestId, imagesSet
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeImagesResponseType
Children: None
imagesSet Image set.
Type: DescribeImagesResponseInfoType (p. 318)
Ancestor: DescribeImagesResponseType
Children: item
item Information for one image.
Type: DescribeImagesResponseItemType (p. 318)
Ancestor: imagesSet
Children: imageId, imageLocation, imageState,imageOwnerId, isPublic, productCodes, architecture,imageType, kernelId, ramdiskId, and platform
imageId The ID of the AMI.
Type: xsd:string
Ancestor: item
Children: None
imageLocation The location of the AMI.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15199
Name Description
imageState Current state of the AMI. If the operation returns "available", theimage is successfully registered and available for launching. If theoperation returns "deregistered", the image is deregistered and nolonger available for launching.
Type: xsd:string
Ancestor: item
Children: None
imageOwnerId AWS Access Key ID of the image owner.
Type: xsd:string
Ancestor: item
Children: None
isPublic Returns "true" if this image has public launch permissions. Returns"false" if it only has implicit and explicit launch permissions.
Type: xsd:boolean
Ancestor: item
Children: None
productCodes Product codes of the AMI.
Type: ProductCodesSetType (p. 361)
Ancestor: item
Children: item
item Information for one product code.
Type: ProductCodesSetItemType (p. 360)
Ancestor: productCodes
Children: productCode
productCode Product code.
Type: xsd:string
Ancestor: item
Children: None
architecture The architecture of the image ("i386" or "x86_64").
Type: xsd:string
Ancestor: item
Children: None
imageType The type of image ("machine", "kernel", or "ramdisk").
Type: xsd:string
Ancestor: item
Children: None
kernelId The kernel associated with the image, if any. Only applicable formachine images.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15200
Name Description
ramdiskId The RAM disk associated with the image, if any. Only applicablefor machine images.
Type: xsd:string
Ancestor: item
Children: None
platform The operating platform of the instance.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example RequestThis example describes the ami-be3adfd7 AMI.
<DescribeImages xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <executableBySet> <item> <user>all</user> </item> </executableBySet> <ownersSet/> <imagesSet> <item> <imageId>ami-be3adfd7</imageId> </item> </imagesSet></DescribeImages>
Example Response<DescribeImagesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imagesSet> <item> <imageId>ami-be3adfd7</imageId> <imageLocation>ec2-public-images/fedora-8-i386-base-v1.04.manifest.xml </imageLocation> <imageState>available</imageState> <imageOwnerId>206029621532</imageOwnerId> <isPublic>false</isPublic> <architecture>i386</architecture> <imageType>machine</imageType> <kernelId>aki-4438dd2d</kernelId> <ramdiskId>ari-4538dd2c</ramdiskId> </item> </imagesSet></DescribeImagesResponse>
Related Operations• DescribeInstances (p. 202)
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15201
• DescribeImageAttribute (p. 191)
Amazon Elastic Compute Cloud API ReferenceDescribeInstances
API Version 2009-07-15202
DescribeInstances
DescriptionReturns information about instances that you own.
If you specify one or more instance IDs, Amazon EC2 returns information for those instances. If youdo not specify instance IDs, Amazon EC2 returns information for all relevant instances. If you specifyan invalid instance ID, a fault is returned. If you specify an instance that you do not own, it will not beincluded in the returned results.
Recently terminated instances might appear in the returned results.This interval is usually less thanone hour.
Request Parameters
Name Description Required
DescribeInstancesType DescribeInstancesType element.
Type: DescribeInstancesType (p. 322)
Ancestor: None
Children: instancesSet
instancesSet Instances set.
Type: DescribeInstancesInfoType (p. 320)
Ancestor: DescribeInstancesType
Children: item
Yes, but canbe empty
item Information for one instance set.
Type: DescribeInstancesItemType (p. 321)
Ancestor: instancesSet
Children: instanceId
No
instanceId Instance IDs to describe.
Type: xsd:string
Default: Returns all instances.
Ancestor: item
Children: None
No
Response Elements
Name Description
DescribeInstancesResponseTypeDescribeInstancesResponseType element.
Type: DescribeInstancesResponseType (p. 321)
Ancestor: None
Children: requestId, reservationSet
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15203
Name Description
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeInstancesResponseType
Children: None
reservationSet Reservation set.
Type: ReservationSetType (p. 368)
Ancestor: DescribeInstancesResponseType
Children: item
item Information for a reservation.
Type: ReservationInfoType (p. 367)
Ancestor: reservationSet
Children: reservationId, ownerId, groupSet,instancesSet, and requesterId
reservationId Unique ID of the reservation.
Type: xsd:string
Ancestor: item
Children: None
ownerId AWS Access Key ID of the user who owns the reservation.
Type: xsd:string
Ancestor: item
Children: None
groupSet Group set.
Type: GroupSetType (p. 347)
Ancestor: item
Children: item
item Group set item.
Type: GroupItemType (p. 347)
Ancestor: groupSet
Children: groupId
groupId Name of the security group.
Type: xsd:string
Ancestor: item
Children: None
instancesSet Instance set.
Type: RunningInstancesSetType (p. 375)
Ancestor: item
Children: item
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15204
Name Description
item Running instance set item.
Type: RunningInstancesItemType (p. 373)
Ancestor: instancesSet
Children: instanceId, imageId, instanceState,privateDnsName, dnsName, reason, keyName,amiLaunchIndex, productCodes, instanceType,launchTime, placement, kernelId, ramdiskId, platform,monitoring, subnetId, vpcId, privateIpAddress, andipAddress
instanceId Unique ID of the instance launched.
Type: xsd:string
Ancestor: item
Children: None
imageId Image ID of the AMI used to launch the instance.
Type: xsd:string
Ancestor: item
Children: None
instanceState The current state of the instance.
Type: InstanceStateType (p. 348)
Ancestor: item
Children: code, name
code A 16-bit unsigned integer. The high byte is an opaque internalvalue and should be ignored. The low byte is set based on thestate represented:
Type: xsd:int
Ancestor: instanceState
Children: None
name The current state of the instance.
Type: xsd:string
Ancestor: instanceState
Children: None
privateDnsName The private DNS name assigned to the instance. This DNS namecan only be used inside the Amazon EC2 network. This elementremains empty until the instance enters a running state.
Type: xsd:string
Ancestor: item
Children: None
dnsName The public DNS name assigned to the instance. This DNS name iscontactable from outside the Amazon EC2 network. This elementremains empty until the instance enters a running state.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15205
Name Description
reason Reason for the most recent state transition. This might be anempty string.
Type: xsd:string
Ancestor: item
Children: None
keyName If this instance was launched with an associated key pair, thisdisplays the key pair name.
Type: xsd:string
Ancestor: item
Children: None
amiLaunchIndex The AMI launch index, which can be used to find this instancewithin the launch group. For more information, go to the Metadatasection of the
Type: xsd:string
Ancestor: item
Children: None
productCodes Product codes attached to this instance.
Type: ProductCodesSetType (p. 361)
Ancestor: item
Children: item
item Information for one product code.
Type: ProductCodesSetItemType (p. 360)
Ancestor: productCodes
Children: productCode
productCode Product code.
Type: xsd:string
Ancestor: item
Children: None
instanceType The instance type. For more information on instance types, go tothe
Type: xsd:string
Ancestor: item
Children: None
launchTime The time the instance launched.
Type: xsd:dateTime
Ancestor: item
Children: None
placement The location where the instance launched.
Type: PlacementResponseType (p. 359)
Ancestor: item
Children: availabilityZone
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15206
Name Description
availabilityZone Returns the Availability Zones of the instances.
Type: xsd:string
Ancestor: placement
Children: None
kernelId Optional. Kernel associated with this instance.
Type: xsd:string
Ancestor: item
Children: None
ramdiskId Optional. RAM disk associated with this instance.
Type: xsd:string
Ancestor: item
Children: None
platform Platform of the instance (e.g., Windows).
Type: xsd:string
Ancestor: item
Children: None
monitoring Specifies whether monitoring is enabled for the instance.
Type: InstanceMonitoringStateType (p. 348)
Ancestor: item
Children: state
state State of monitoring for the instance.
Type: xsd:string
Ancestor: monitoring
Children: None
subnetId Specifies the subnet ID in which the instance is running (AmazonVirtual Private Cloud).
Type: xsd:string
Ancestor: item
Children: None
vpcId Specifies the VPC in which the instance is running (Amazon VPC).
Type: xsd:string
Ancestor: item
Children: None
privateIpAddress Specifies the private IP address that is assigned to the instance(Amazon VPC).
Type: xsd:string
Ancestor: item
Children: None
ipAddress Specifies the IP address of the instance.
Type: xsd:string
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15207
Name Description
requesterId ID of the requester.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example RequestThis example describes the current state of the instances owned by this user.
<DescribeInstances xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instancesSet/></DescribeInstances>
Example Response<DescribeInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <reservationSet> <item> <reservationId>r-44a5402d</reservationId> <ownerId>UYY3TLBUXIEON5NQVUUX6OMPWBZIQNFM</ownerId> <groupSet> <item> <groupId>default</groupId> </item> </groupSet> <instancesSet> <item> <instanceId>i-28a64341</instanceId> <imageId>ami-6ea54007</imageId> <instanceState> <code>0</code> <name>running</name> </instanceState> <privateDnsName>10-251-50-132.ec2.internal</privateDnsName> <dnsName>ec2-72-44-33-4.compute-1.amazonaws.com</dnsName> <keyName>example-key-name</keyName> <amiLaunchIndex>23</amiLaunchIndex> <productCodesSet> <item><productCode>774F4FF8</productCode></item> </productCodesSet> <instanceType>m1.large</instanceType> <launchTime>2007-08-07T11:54:42.000Z</launchTime> <placement> <availabilityZone>us-east-1b</availabilityZone> </placement> <kernelId>aki-ba3adfd3</kernelId> <ramdiskId>ari-badbad00</ramdiskId> </item> <item> <instanceId>i-28a64435</instanceId> <imageId>ami-6ea54007</imageId> <instanceState>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15208
<code>0</code> <name>running</name> </instanceState> <privateDnsName>10-251-50-134.ec2.internal</privateDnsName> <dnsName>ec2-72-44-33-6.compute-1.amazonaws.com</dnsName> <keyName>example-key-name</keyName> <amiLaunchIndex>23</amiLaunchIndex> <productCodesSet> <item><productCode>774F4FF8</productCode></item> </productCodesSet> <instanceType>m1.large</instanceType> <launchTime>2007-08-07T11:54:42.000Z</launchTime> <placement> <availabilityZone>us-east-1b</availabilityZone> </placement> <kernelId>aki-ba3adfd3</kernelId> <ramdiskId>ari-badbad00</ramdiskId> </item> </instancesSet> </item> </reservationSet></DescribeInstancesResponse>
Related Operations• RunInstances (p. 261)
• TerminateInstances (p. 272)
Amazon Elastic Compute Cloud API ReferenceDescribeKeyPairs
API Version 2009-07-15209
DescribeKeyPairsDescriptionReturns information about key pairs available to you. If you specify key pairs, information about thosekey pairs is returned. Otherwise, information for all registered key pairs is returned.
Request ParametersName Description Required
DescribeKeyPairsType DescribeKeyPairsType element.
Type: DescribeKeyPairsType (p. 325)
Ancestor: None
Children: keySet
keySet Set of key pairs.
Type: DescribeKeyPairsInfoType (p. 322)
Ancestor: DescribeKeyPairsType
Children: item
Yes, but canbe empty
item Information for a key pair.
Type: DescribeKeyPairsItemType (p. 323)
Ancestor: keySet
Children: keyName
No
keyName Key pair to describe.
Type: xsd:string
Default: Describes all key pairs available to the account.
Ancestor: item
Children: None
No
Response ElementsName Description
DescribeKeyPairsResponseTypeDescribeKeyPairsResponseType element.
Type: DescribeKeyPairsResponseType (p. 324)
Ancestor: None
Children: requestId, keySet
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeKeyPairsResponseType
Children: None
keySet Information for a key pair.
Type: DescribeKeyPairsResponseInfoType (p. 323)
Ancestor: DescribeKeyPairsResponseType
Children: item
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15210
Name Description
item Information for a key pair.
Type: DescribeKeyPairsResponseItemType (p. 324)
Ancestor: keySet
Children: keyName, keyFingerprint
keyName The key pair name provided in the original request.
Type: xsd:string
Ancestor: item
Children: None
keyFingerprint A SHA-1 digest of the DER encoded private key.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example RequestThis example describes the state of the gsg-keypair key.
<DescribeKeyPairs xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <keySet> <item> <keyName>gsg-keypair</keyName> </item> </keySet></DescribeKeyPairs>
Example Response<DescribeKeyPairsResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <keySet> <item> <keyName>gsg-keypair</keyName> <keyFingerprint>1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca:9f:f5:f1:6f</keyFingerprint> </item> </keySet></DescribeKeyPairsResponse>
Related Operations• DescribeAvailabilityZones (p. 184)
• RunInstances (p. 261)
Amazon Elastic Compute Cloud API ReferenceDescribeRegions
API Version 2009-07-15211
DescribeRegions
DescriptionDescribes regions that are currently available to the account.
Request Parameters
Name Description Required
DescribeRegionsType DescribeRegionsType element.
Type: DescribeRegionsType (p. 326)
Ancestor: None
Children: regionSet
regionSet Set of regions.
Type: DescribeRegionsSetType (p. 326)
Ancestor: DescribeRegionsType
Children: item
item Information for a region.
Type: DescribeRegionsSetItemType (p. 325)
Ancestor: regionSet
Children: regionName
regionName Name of a region.
Type: xsd:string
Default: Describes all regions available to the account.
Ancestor: item
Children: None
No
Response Elements
Name Description
DescribeRegionsResponseTypeDescribeRegionsResponseType element.
Type: DescribeRegionsResponseType (p. 325)
Ancestor: None
Children: requestId, regionInfo
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeRegionsResponseType
Children: None
regionInfo Region set.
Type: RegionSetType (p. 365)
Ancestor: DescribeRegionsResponseType
Children: item
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15212
Name Description
item Information for a region.
Type: RegionItemType (p. 364)
Ancestor: regionInfo
Children: regionName, regionEndpoint
regionName Name of the region.
Type: xsd:string
Ancestor: item
Children: None
regionEndpoint Region service endpoint.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example RequestThis example displays regions that are available to the account.
<DescribeRegions xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <regionSet/></DescribeRegions>
Example Response<DescribeRegionsResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <regionInfo> <item> <regionName>us-east-1</regionName> <regionEndpoint>us-east-1.ec2.amazonaws.com</regionEndpoint> </item> <item> <regionName>eu-west-1</regionName> <regionUrl>eu-west-1.ec2.amazonaws.com</regionUrl> </item> </regionInfo></DescribeRegionsResponse>
Related Operations• DescribeAvailabilityZones (p. 184)
• RunInstances (p. 261)
Amazon Elastic Compute Cloud API ReferenceDescribeReservedInstances
API Version 2009-07-15213
DescribeReservedInstances
DescriptionDescribes Reserved Instances that you purchased. For more information about Reserved Instances,go to the Amazon Elastic Compute Cloud Developer Guide.
Request Parameters
Name Description Required
DescribeReservedInstancesTypeDescribeReservedInstancesType element.
Type: DescribeReservedInstancesType (p. 333)
Ancestor: None
Children: reservedInstancesSet
reservedInstancesSet Set of Reserved Instances.
Type: DescribeReservedInstancesSetType (p. 333)
Ancestor: DescribeReservedInstancesType
Children: item
No
item Reserved Instances item.
Type: DescribeReservedInstancesSetItemType (p.332)
Ancestor: reservedInstancesSet
Children: reservedInstancesId
No
reservedInstancesId IDs of the Reserved Instance to describe.
Type: xsd:string
Default: None
Ancestor: item
Children: None
No
Response Elements
Name Description
DescribeReservedInstancesResponseTypeDescribeReservedInstancesResponseType element.
Type: DescribeReservedInstancesResponseType (p. 332)
Ancestor: None
Children: requestId, reservedInstancesSet
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeReservedInstancesResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15214
Name Description
reservedInstancesSet Reserved Instances set.
Type: DescribeReservedInstancesResponseSetType (p. 331)
Ancestor: DescribeReservedInstancesResponseType
Children: item
item Reserved Instance set.
Type: DescribeReservedInstancesResponseSetItemType (p.330)
Ancestor: reservedInstancesSet
Children: reservedInstancesId, instanceType,availabilityZone, start, duration, fixedPrice,usagePrice, instanceCount, productDescription, andstate
reservedInstancesId The ID of the Reserved Instance.
Type: xsd:string
Ancestor: item
Children: None
instanceType The instance type on which the Reserved Instance can be used.
Type: xsd:string
Ancestor: item
Children: None
availabilityZone The Availability Zone in which the Reserved Instance can be used.
Type: xsd:string
Ancestor: item
Children: None
start The date and time the Reserved Instance started.
Type: xsd:dateTime
Ancestor: item
Children: None
duration The duration of the Reserved Instance, in seconds.
Type: xs:long
Ancestor: item
Children: None
fixedPrice The purchase price of the Reserved Instance.
Type: xs:double
Ancestor: item
Children: None
usagePrice The usage price of the Reserved Instance, per hour.
Type: xs:double
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15215
Name Description
instanceCount The number of Reserved Instances purchased.
Type: xs:integer
Ancestor: item
Children: None
productDescription The Reserved Instance description.
Type: xsd:string
Ancestor: item
Children: None
state The state of the Reserved Instance purchase.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example RequestThis example describes Reserved Instances owned by the account.
<DescribeReservedInstances xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"></DescribeReservedInstances>
Example Response<DescribeReservedInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <reservedInstancesSet> <item> <reservedInstancesId>4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8</reservedInstancesId> <instanceType>m1.small</instanceType> <availabilityZone>us-east-1a</availabilityZone> <duration>12</duration> <usagePrice>0.00</usagePrice> <fixedPrice>0.00</fixedPrice> <instanceCount>19</instanceCount> <productDescription>m1.small offering in us-east-1a</productDescription> <state>Active</state> </item> </reservedInstancesSet> </DescribeReservedInstancesResponse>
Related Operations• PurchaseReservedInstancesOffering (p. 247)
• DescribeReservedInstancesOfferings (p. 216)
Amazon Elastic Compute Cloud API ReferenceDescribeReservedInstancesOfferings
API Version 2009-07-15216
DescribeReservedInstancesOfferings
DescriptionDescribes Reserved Instance offerings that are available for purchase. With Amazon EC2 ReservedInstances, you purchase the right to launch Amazon EC2 instances for a period of time (without gettinginsufficient capacity errors) and pay a lower usage rate for the actual time used. For more informationabout Reserved Instances, go to the Amazon Elastic Compute Cloud Developer Guide.
Request Parameters
Name Description Required
DescribeReservedInstancesOfferingsTypeDescribeReservedInstancesOfferingsTypeelement.
Type: DescribeReservedInstancesOfferingsType (p.330)
Ancestor: None
Children: reservedInstancesOfferingsSet,instanceType, availabilityZone, andproductDescription
reservedInstancesOfferingsSetSet of Reserved Instances.
Type: DescribeReservedInstancesOfferingsSetType (p.329)
Ancestor:DescribeReservedInstancesOfferingsType
Children: item
No
item Reserved Instances item.
Type:DescribeReservedInstancesOfferingsSetItemType (p.329)
Ancestor: reservedInstancesOfferingsSet
Children: reservedInstancesOfferingId
No
reservedInstancesOfferingIdID of the Reserved Instances to describe.
Type: xsd:string
Default: None
Ancestor: item
Children: None
No
instanceType The instance type on which the Reserved Instance canbe used.
Type: xsd:string
Default: None
Ancestor:DescribeReservedInstancesOfferingsType
Children: None
No
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15217
Name Description Required
availabilityZone The Availability Zone in which the Reserved Instancecan be used.
Type: xsd:string
Default: None
Ancestor:DescribeReservedInstancesOfferingsType
Children: None
No
productDescription The Reserved Instance description.
Type: xsd:string
Default: None
Ancestor:DescribeReservedInstancesOfferingsType
Children: None
No
Response Elements
Name Description
DescribeReservedInstancesOfferingsResponseTypeDescribeReservedInstancesOfferingsResponseTypeelement.
Type: DescribeReservedInstancesOfferingsResponseType (p.328)
Ancestor: None
Children: requestId, reservedInstancesOfferingsSet
requestId The ID of the request.
Type: xsd:string
Ancestor:DescribeReservedInstancesOfferingsResponseType
Children: None
reservedInstancesOfferingsSetReserved Instances offerings set.
Type: DescribeReservedInstancesOfferingsResponseSetType (p.328)
Ancestor:DescribeReservedInstancesOfferingsResponseType
Children: item
item Reserved Instance offerings set.
Type:DescribeReservedInstancesOfferingsResponseSetItemType (p.327)
Ancestor: reservedInstancesOfferingsSet
Children: reservedInstancesOfferingId, instanceType,availabilityZone, duration, fixedPrice, usagePrice,and productDescription
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15218
Name Description
reservedInstancesOfferingIdThe ID of the Reserved Instance offering.
Type: xsd:string
Ancestor: item
Children: None
instanceType The instance type on which the Reserved Instance can be used.
Type: xsd:string
Ancestor: item
Children: None
availabilityZone The Availability Zone in which the Reserved Instance can be used.
Type: xsd:string
Ancestor: item
Children: None
duration The duration of the Reserved Instance, in seconds.
Type: xs:long
Ancestor: item
Children: None
fixedPrice The purchase price of the Reserved Instance.
Type: xs:double
Ancestor: item
Children: None
usagePrice The usage price of the Reserved Instance, per hour.
Type: xs:double
Ancestor: item
Children: None
productDescription The Reserved Instance description.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example Request
This example describes available Reserved Instance offerings.
<DescribeReservedInstancesOfferings xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"></DescribeReservedInstancesOfferings>
Example Response
<DescribeReservedInstancesOfferingsResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <reservedInstancesOfferingsSet> <item>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15219
<reservedInstancesOfferingId>4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8</reservedInstancesOfferingId> <instanceType>m1.small</instanceType> <availabilityZone>us-east-1a</availabilityZone> <duration>12</duration> <fixedPrice>0.00</fixedPrice> <usagePrice>0.00</usagePrice> <productDescription>m1.small offering in us-east-1a</productDescription> </item> </reservedInstancesOfferingsSet> </DescribeReservedInstancesOfferingsResponse>
Related Operations• PurchaseReservedInstancesOffering (p. 247)
• DescribeReservedInstances (p. 213)
Amazon Elastic Compute Cloud API ReferenceDescribeSecurityGroups
API Version 2009-07-15220
DescribeSecurityGroups
DescriptionReturns information about security groups that you own.
Request Parameters
Name Description Required
DescribeSecurityGroupsTypeDescribeSecurityGroupsType element.
Type: DescribeSecurityGroupsType (p. 335)
Ancestor: None
Children: securityGroupSet
securityGroupSet Set of security groups.
Type: DescribeSecurityGroupsSetType (p. 335)
Ancestor: DescribeSecurityGroupsType
Children: item
item Information for a security group.
Type: DescribeSecurityGroupsSetItemType (p. 334)
Ancestor: securityGroupSet
Children: groupName
groupName Name of the security group.
Type: xsd:string
Default: Describes all groups within the account.
Ancestor: item
Children: None
No
Response Elements
Name Description
DescribeSecurityGroupsResponseTypeDescribeSecurityGroupsResponseType element.
Type: DescribeSecurityGroupsResponseType (p. 334)
Ancestor: None
Children: requestId, securityGroupInfo
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeSecurityGroupsResponseType
Children: None
securityGroupInfo Security group set.
Type: SecurityGroupSetType (p. 376)
Ancestor: DescribeSecurityGroupsResponseType
Children: item
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15221
Name Description
item Information for a security group.
Type: SecurityGroupItemType (p. 375)
Ancestor: securityGroupInfo
Children: ownerId, groupName, groupDescription, andipPermissions
ownerId AWS Access Key ID of the owner of the security group.
Type: xsd:string
Ancestor: item
Children: None
groupName Name of the security group.
Type: xsd:string
Ancestor: item
Children: None
groupDescription Description of the security group.
Type: xsd:string
Ancestor: item
Children: None
ipPermissions Set of IP permissions associated with the security group.
Type: IpPermissionSetType (p. 349)
Ancestor: item
Children: item
item Set of IP permissions.
Type: IpPermissionType (p. 350)
Ancestor: ipPermissions
Children: ipProtocol, fromPort, toPort, groups, andipRanges
ipProtocol IP protocol.
Type: xsd:string
Ancestor: item
Children: None
fromPort Start of port range for the TCP and UDP protocols, or an ICMPtype number. An ICMP type number of -1 indicates a wildcard (i.e.,any ICMP type number).
Type: xsd:int
Ancestor: item
Children: None
toPort End of port range for the TCP and UDP protocols, or an ICMPcode. An ICMP code of -1 indicates a wildcard (i.e., any ICMPcode).
Type: xsd:int
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15222
Name Description
groups List of security group and user ID pairs.
Type: UserIdGroupPairSetType (p. 380)
Ancestor: item
Children: item
item Information for one security group.
Type: UserIdGroupPairType (p. 380)
Ancestor: groups
Children: userId, groupName
userId AWS User ID of an account.
Type: xsd:string
Ancestor: item
Children: None
groupName Name of the security group.
Type: xsd:string
Ancestor: item
Children: None
ipRanges IP ranges.
Type: IpRangeSetType (p. 351)
Ancestor: item
Children: item
item Information for one IP range.
Type: IpRangeItemType (p. 351)
Ancestor: ipRanges
Children: cidrIp
cidrIp CIDR range.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example RequestThis example returns information about two security groups that are configured for the account.
<DescribeSecurityGroups xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <securityGroupSet> <item> <groupName>WebServers</groupName> </item> <item> <groupName>RangedPortsBySource</groupName> </item> </securityGroupSet></DescribeSecurityGroups>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15223
Example Response<DescribeSecurityGroupsResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <securityGroupInfo> <item> <ownerId>UYY3TLBUXIEON5NQVUUX6OMPWBZIQNFM</ownerId> <groupName>WebServers</groupName> <groupDescription>Web Servers</groupDescription> <ipPermissions> <item> <ipProtocol>tcp</ipProtocol> <fromPort>80</fromPort> <toPort>80</toPort> <groups/> <ipRanges> <item> <cidrIp>0.0.0.0/0</cidrIp> </item> </ipRanges> </item> </ipPermissions> </item> <item> <ownerId>UYY3TLBUXIEON5NQVUUX6OMPWBZIQNFM</ownerId> <groupName>RangedPortsBySource</groupName> <groupDescription>Group A</groupDescription> <ipPermissions> <item> <ipProtocol>tcp</ipProtocol> <fromPort>6000</fromPort> <toPort>7000</toPort> <groups/> <ipRanges/> </item> </ipPermissions> </item> </securityGroupInfo></DescribeSecurityGroupsResponse>
Related Operations• CreateSecurityGroup (p. 164)
• AuthorizeSecurityGroupIngress (p. 145)
• RevokeSecurityGroupIngress (p. 257)
• DeleteSecurityGroup (p. 173)
Amazon Elastic Compute Cloud API ReferenceDescribeSnapshots
API Version 2009-07-15224
DescribeSnapshots
DescriptionDescribes the status of Amazon EBS snapshots. If no snapshots are specified, Amazon EBS returnsinformation about all snapshots owned by the account. For more information about Amazon EBS, go tothe Amazon Elastic Compute Cloud Developer Guide.
Request Parameters
Name Description Required
DescribeSnapshotsType DescribeSnapshotsType element.
Type: DescribeSnapshotsType (p. 338)
Ancestor: None
Children: snapshotSet
snapshotSet Set of snapshots.
Type: DescribeSnapshotsSetType (p. 338)
Ancestor: DescribeSnapshotsType
Children: item
item Information for a snapshot.
Type: DescribeSnapshotsSetItemType (p. 337)
Ancestor: snapshotSet
Children: snapshotId
snapshotId The ID of the Amazon EBS snapshot.
Type: xsd:string
Default: Describes all snapshots that you own.
Ancestor: item
Children: None
No
Response Elements
Name Description
DescribeSnapshotsResponseTypeDescribeSnapshotsResponseType element.
Type: DescribeSnapshotsResponseType (p. 336)
Ancestor: None
Children: requestId, snapshotSet
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeSnapshotsResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15225
Name Description
snapshotSet Snapshot set.
Type: DescribeSnapshotsSetResponseType (p. 337)
Ancestor: DescribeSnapshotsResponseType
Children: item
item Information for a snapshot.
Type: DescribeSnapshotsSetItemResponseType (p. 336)
Ancestor: snapshotSet
Children: snapshotId, volumeId, status, startTime, andprogress
snapshotId The ID of the snapshot.
Type: xsd:string
Ancestor: item
Children: None
volumeId The ID of the volume.
Type: xsd:string
Ancestor: item
Children: None
status Snapshot state (e.g., pending, completed, error).
Type: xsd:string
Ancestor: item
Children: None
startTime Time stamp when the snapshot was initiated.
Type: xsd:dateTime
Ancestor: item
Children: None
progress The progress of the snapshot, in percentage.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example Request
This example describes snapshot snap-78a54011.
<DescribeSnapshots xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <snapshotSet> <item> <snapshotId>snap-78a54011</snapshotId> </item> </snapshotSet></DescribeSnapshots>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15226
Example Response<DescribeSnapshotsResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <snapshotSet> <item> <snapshotId>snap-78a54011</snapshotId> <volumeId>vol-4d826724</volumeId> <status>pending</status> <startTime>2008-05-07T12:51:50.000Z</startTime> <progress>80%</progress> </item> </snapshotSet></DescribeSnapshotsResponse>
Related Operations• CreateSnapshot (p. 166)
• DeleteSnapshot (p. 175)
Amazon Elastic Compute Cloud API ReferenceDescribeVolumes
API Version 2009-07-15227
DescribeVolumes
DescriptionDescribes the specified Amazon EBS volumes that you own. If you do not specify one or more volumeIDs, Amazon EBS describes all volumes that you own. For more information about Amazon EBS, go tothe Amazon Elastic Compute Cloud Developer Guide.
Request Parameters
Name Description Required
DescribeVolumesType DescribeVolumesType element.
Type: DescribeVolumesType (p. 341)
Ancestor: None
Children: volumeSet
volumeSet Set of volumes.
Type: DescribeVolumesSetType (p. 341)
Ancestor: DescribeVolumesType
Children: item
item Information for a volume.
Type: DescribeVolumesSetItemType (p. 340)
Ancestor: volumeSet
Children: volumeId
volumeId The ID of the volume to list.
Type: xsd:string
Default: Describes all volumes that you own.
Ancestor: item
Children: None
No
Response Elements
Name Description
DescribeVolumesResponseTypeDescribeVolumesResponseType element.
Type: DescribeVolumesResponseType (p. 339)
Ancestor: None
Children: requestId, volumeSet
requestId The ID of the request.
Type: xsd:string
Ancestor: DescribeVolumesResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15228
Name Description
volumeSet Volume set.
Type: DescribeVolumesSetResponseType (p. 340)
Ancestor: DescribeVolumesResponseType
Children: item
item Information for a volume.
Type: DescribeVolumesSetItemResponseType (p. 339)
Ancestor: volumeSet
Children: volumeId, size, snapshotId, availabilityZone,status, createTime, and attachmentSet
volumeId The ID of the volume.
Type: xsd:string
Ancestor: item
Children: None
size The size of the volume, in GiBs.
Type: xsd:string
Ancestor: item
Children: None
snapshotId Snapshot from which the volume was created (optional).
Type: xsd:string
Ancestor: item
Children: None
availabilityZone Availability Zone in which the volume was created.
Type: xsd:string
Ancestor: item
Children: None
status Volume state (e.g., "creating", "available", "in-use", "deleting","error")
Type: xsd:string
Ancestor: item
Children: None
createTime Time stamp when volume creation was initiated.
Type: xsd:dateTime
Ancestor: item
Children: None
attachmentSet Attachment set.
Type: AttachmentSetResponseType (p. 284)
Ancestor: item
Children: item
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15229
Name Description
item Information for a attachment set.
Type: AttachmentSetItemResponseType (p. 284)
Ancestor: attachmentSet
Children: volumeId, instanceId, device, status, andattachTime
volumeId The ID of the volume.
Type: xsd:string
Ancestor: item
Children: None
instanceId The ID of the instance.
Type: xsd:string
Ancestor: item
Children: None
device Specifies how the device is exposed to the instance (e.g., /dev/sdh).
Type: xsd:string
Ancestor: item
Children: None
status Attachment state.
Type: xsd:string
Ancestor: item
Children: None
attachTime Time stamp when the association was created.
Type: xsd:dateTime
Ancestor: item
Children: None
Examples
Example Request
This example describes all volumes associated with your account.
<DescribeVolumes xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"></DescribeVolumes>
Example Response<DescribeVolumesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"><volumeSet> <item> <volumeId>vol-4282672b</volumeId> <size>800</size> <snapshotId/> <availabilityZone>us-east-1a</availabilityZone> <status>in-use</status>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15230
<createTime>2008-05-07T11:51:50.000Z</createTime> <attachmentSet> <item> <volumeId>vol-4282672b</volumeId> <instanceId>i-6058a509</instanceId> <device>/dev/sdh</device> <status>attached</status> <attachTime>2008-05-07T12:51:50.000Z</attachTime> </item> </attachmentSet> </item></DescribeVolumesResponse>
Related Operations• CreateSnapshot (p. 166)
• DeleteSnapshot (p. 175)
Amazon Elastic Compute Cloud API ReferenceDetachVolume
API Version 2009-07-15231
DetachVolume
DescriptionDetaches an Amazon EBS volume from an instance. For more information about Amazon EBS, go tothe Amazon Elastic Compute Cloud Developer Guide.
Important
Make sure to unmount any file systems on the device within your operating system beforedetaching the volume. Failure to unmount file systems, or otherwise properly release thedevice from use, can result in lost data and will corrupt the file system.
Request Parameters
Name Description Required
DetachVolumeType DetachVolumeType element.
Type: DetachVolumeType (p. 342)
Ancestor: None
Children: volumeId, instanceId, device, and force
volumeId The ID of the volume.
Type: xsd:string
Default: None
Ancestor: DetachVolumeType
Children: None
Yes
instanceId The ID of the instance.
Type: xsd:string
Default: None
Ancestor: DetachVolumeType
Children: None
No
device The device name.
Type: xsd:string
Default: None
Ancestor: DetachVolumeType
Children: None
No
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15232
Name Description Required
force Forces detachment if the previous detachmentattempt did not occur cleanly (logging into an instance,unmounting the volume, and detaching normally). Thisoption can lead to data loss or a corrupted file system.Use this option only as a last resort to detach a volumefrom a failed instance. The instance will not have anopportunity to flush file system caches nor file systemmeta data. If you use this option, you must perform filesystem check and repair procedures.
Type: xsd:boolean
Default: None
Ancestor: DetachVolumeType
Children: None
No
Response Elements
Name Description
DetachVolumeResponseType DetachVolumeResponseType element.
Type: DetachVolumeResponseType (p. 342)
Ancestor: None
Children: requestId, volumeId, instanceId, device,status, and attachTime
requestId The ID of the request.
Type: xsd:string
Ancestor: DetachVolumeResponseType
Children: None
volumeId The ID of the volume.
Type: xsd:string
Ancestor: DetachVolumeResponseType
Children: None
instanceId The ID of the instance.
Type: xsd:string
Ancestor: DetachVolumeResponseType
Children: None
device The device as it is exposed to the instance.
Type: xsd:string
Ancestor: DetachVolumeResponseType
Children: None
status Attachment state (e.g., "attaching", "attached", "detaching", or"detached").
Type: xsd:string
Ancestor: DetachVolumeResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15233
Name Description
attachTime Time stamp when the association was created.
Type: xsd:dateTime
Ancestor: DetachVolumeResponseType
Children: None
Examples
Example RequestThis example detaches volume vol-4d826724.
<DetachVolume xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <volumeId>vol-4d826724</volumeId> <instanceId>i-6058a509</instanceId></DetachVolume>
Example Response<DetachVolumeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <volumeId>vol-4d826724</volumeId> <instanceId>i-6058a509</instanceId> <device>/dev/sdh</device> <status>detaching</status> <attachTime>2008-05-08T11:51:50.000Z</attachTime></DetachVolumeResponse>
Related Operations• CreateVolume (p. 168)
• DeleteVolume (p. 177)
• DescribeVolumes (p. 227)
• AttachVolume (p. 142)
Amazon Elastic Compute Cloud API ReferenceDisassociateAddress
API Version 2009-07-15234
DisassociateAddress
DescriptionDisassociates the specified elastic IP address from the instance to which it is assigned. This is anidempotent operation. If you enter it more than once, Amazon EC2 does not return an error.
Request ParametersName Description Required
DisassociateAddressTypeDisassociateAddressType element.
Type: DisassociateAddressType (p. 344)
Ancestor: None
Children: publicIp
publicIp IP address that you are disassociating from the instance.
Type: xsd:string
Default: None
Ancestor: DisassociateAddressType
Children: None
Yes
Response ElementsName Description
DisassociateAddressResponseTypeDisassociateAddressResponseType element.
Type: DisassociateAddressResponseType (p. 343)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: DisassociateAddressResponseType
Children: None
return Returns "true" if the IP address is disassociated from the instance.Otherwise, "false".
Type: xsd:boolean
Ancestor: DisassociateAddressResponseType
Children: None
Examples
Example RequestThis example disassociates the 67.202.55.255 IP address from the instance to which it is assigned.
<DisassociateAddress xmlns="http://ec2.amazonaws.com/doc/2009-07-15/">
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15235
<publicIp>67.202.55.255</publicIp></DisassociateAddress>
Example Response<DisassociateAddressResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></DisassociateAddressResponse>
Related Operations• AllocateAddress (p. 138)
• DescribeAddresses (p. 181)
• ReleaseAddress (p. 253)
• AssociateAddress (p. 140)
Amazon Elastic Compute Cloud API ReferenceGetConsoleOutput
API Version 2009-07-15236
GetConsoleOutput
DescriptionRetrieves console output for the specified instance.
Instance console output is buffered and posted shortly after instance boot, reboot, and termination.Amazon EC2 preserves the most recent 64 KB output which will be available for at least one hour afterthe most recent post.
Request Parameters
Name Description Required
GetConsoleOutputType GetConsoleOutputType element.
Type: GetConsoleOutputType (p. 345)
Ancestor: None
Children: instanceId
instanceId ID of the instance for which you want console output.
Type: xsd:string
Default: None
Ancestor: GetConsoleOutputType
Children: None
Yes
Response Elements
Name Description
GetConsoleOutputResponseTypeGetConsoleOutputResponseType element.
Type: GetConsoleOutputResponseType (p. 345)
Ancestor: None
Children: requestId, instanceId, timestamp, and output
requestId The ID of the request.
Type: xsd:string
Ancestor: GetConsoleOutputResponseType
Children: None
instanceId The instance ID.
Type: xsd:string
Ancestor: GetConsoleOutputResponseType
Children: None
timestamp The time the output was last updated.
Type: xsd:dateTime
Ancestor: GetConsoleOutputResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15237
Name Description
output The console output, Base64 encoded.
Type: xsd:string
Ancestor: GetConsoleOutputResponseType
Children: None
Examples
Example RequestThis example retrieves the console output for the i-10a64379 Linux and UNIX instance.
<GetConsoleOutput xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instanceId>i-28a64341</instanceId></GetConsoleOutput>
Example Response<GetConsoleOutputResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instanceId>i-28a64341</instanceId> <timestamp>2007-01-03 15:00:00</timestamp> <output>TGludXggdmVyc2lvbiAyLjYuMTYteGVuVSAoYnVpbGRlckBwYXRjaGJhdC5hbWF6b25zYSkgKGdjYyB2ZXJzaW9uIDQuMC4xIDIwMDUwNzI3IChSZWQgSGF0IDQuMC4xLTUpKSAjMSBTTVAgVGh1IE9jdCAyNiAwODo0MToyNiBTQVNUIDIwMDYKQklPUy1wcm92aWRlZCBwaHlzaWNhbCBSQU0gbWFwOgpYZW46IDAwMDAwMDAwMDAwMDAwMDAgLSAwMDAwMDAwMDZhNDAwMDAwICh1c2FibGUpCjk4ME1CIEhJR0hNRU0gYXZhaWxhYmxlLgo3MjdNQiBMT1dNRU0gYXZhaWxhYmxlLgpOWCAoRXhlY3V0ZSBEaXNhYmxlKSBwcm90ZWN0aW9uOiBhY3RpdmUKSVJRIGxvY2t1cCBkZXRlY3Rpb24gZGlzYWJsZWQKQnVpbHQgMSB6b25lbGlzdHMKS2VybmVsIGNvbW1hbmQgbGluZTogcm9vdD0vZGV2L3NkYTEgcm8gNApFbmFibGluZyBmYXN0IEZQVSBzYXZlIGFuZCByZXN0b3JlLi4uIGRvbmUuCg==</output></GetConsoleOutputResponse>
Related Operations• RunInstances (p. 261)
Amazon Elastic Compute Cloud API ReferenceGetPasswordData
API Version 2009-07-15238
GetPasswordData
DescriptionRetrieves the encrypted administrator password for the instances running Windows.
Note
The Windows password is only generated the first time an AMI is launched. It is not generatedfor rebundled AMIs or after the password is changed on an instance.
The password is encrypted using the key pair that you provided.
Request Parameters
Name Description Required
GetPasswordDataType GetPasswordDataType element.
Type: GetPasswordDataType (p. 346)
Ancestor: None
Children: instanceId
instanceId The ID of the instance for which to get the password.
Type: xsd:string
Default: None
Ancestor: GetPasswordDataType
Children: None
Yes
Response Elements
Name Description
GetPasswordDataResponseTypeGetPasswordDataResponseType element.
Type: GetPasswordDataResponseType (p. 346)
Ancestor: None
Children: requestId, instanceId, timestamp, andpasswordData
requestId The ID of the request.
Type: xsd:string
Ancestor: GetPasswordDataResponseType
Children: None
instanceId The ID of the instance.
Type: xsd:string
Ancestor: GetPasswordDataResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15239
Name Description
timestamp The time the data was last updated.
Type: xsd:dateTime
Ancestor: GetPasswordDataResponseType
Children: None
passwordData The password of the instance.
Type: xsd:string
Ancestor: GetPasswordDataResponseType
Children: None
Examples
Example RequestThis example returns the encrypted version of the administrator password for the i-2574e22ainstance.
<GetPasswordData xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instanceId>i-2574e22a</instanceId></GetPasswordData>
Example Response<GetPasswordDataResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instanceId>i-2574e22a</instanceId> <timestamp>2009-10-24 15:00:00</timestamp> <passwordData>TGludXggdmVyc2lvbiAyLjYuMTYteGVuVSAoYnVpbGRlckBwYXRjaGJhdC5hbWF6b25zYSkgKGdj</passwordData></GetPasswordDataResponse>
Related Operations• RunInstances (p. 261)
Amazon Elastic Compute Cloud API ReferenceModifyImageAttribute
API Version 2009-07-15240
ModifyImageAttribute
DescriptionModifies an attribute of an AMI.
Request Parameters
Name Description Required
ModifyImageAttributeTypeModifyImageAttributeType element.
Type: ModifyImageAttributeType (p. 354)
Ancestor: None
Children: imageId, launchPermission, andproductCodes
imageId The AMI ID.
Type: xsd:string
Default: None
Ancestor: ModifyImageAttributeType
Children: None
Yes
launchPermission Launch permission set.
Type: LaunchPermissionOperationType (p. 353)
Ancestor: ModifyImageAttributeType
Children: add, remove
add Items to add.
Type: LaunchPermissionListType (p. 352)
Ancestor: launchPermission
Children: item
item Information for launch permissions.
Type: LaunchPermissionItemType (p. 352)
Ancestor: add
Children: userId, group
userId User IDs associated with the launchPermission attribute.
Type: xsd:string
Default: None
Ancestor: item
Children: None
group Security groups associated with the launchPermissionattribute. You can specify the "all" group, which willmake it a public AMI.
Type: xsd:string
Default: None
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceRequest Parameters
API Version 2009-07-15241
Name Description Required
remove Items to remove.
Type: LaunchPermissionListType (p. 352)
Ancestor: launchPermission
Children: item
item Information for launch permissions.
Type: LaunchPermissionItemType (p. 352)
Ancestor: remove
Children: userId, group
userId User IDs associated with the launchPermission attribute.
Type: xsd:string
Default: None
Ancestor: item
Children: None
group Security groups associated with the launchPermissionattribute. You can specify the "all" group, which willmake it a public AMI.
Type: xsd:string
Default: None
Ancestor: item
Children: None
productCodes Product code set.
Type: ProductCodeListType (p. 360)
Ancestor: ModifyImageAttributeType
Children: item
item Information for one product code.
Type: ProductCodeItemType (p. 359)
Ancestor: productCodes
Children: productCode
productCode Amazon DevPay product code. Currently only oneproduct code can be associated with an AMI. Once set,the product code cannot be changed or reset.
Type: xsd:string
Default: None
Ancestor: item
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15242
Response ElementsName Description
ModifyImageAttributeResponseTypeModifyImageAttributeResponseType element.
Type: ModifyImageAttributeResponseType (p. 353)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: ModifyImageAttributeResponseType
Children: None
return Returns "true" if successful; otherwise "false".
Type: xsd:boolean
Ancestor: ModifyImageAttributeResponseType
Children: None
Examples
Example RequestThis example makes this a public AMI and grants specific permissions to a user.
<ModifyImageAttribute xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imageId>ami-61a54008</imageId> <launchPermission> <add> <item> <group>all</group> </item> <item> <userId>495219933132</userId> </item> </add> <launchPermission></ModifyImageAttribute>
Example Response<ModifyImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></ModifyImageAttributeResponse>
Example RequestThe following example adds the 774F4FF8 product code to the ami-2bb65342 AMI:
<ModifyImageAttribute xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imageId>ami-61a54008</imageId> <productCodes> <item>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15243
<productCode>774F4FF8</productCode> </item> <productCodes></ModifyImageAttribute>
Example Response<ModifyImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></ModifyImageAttributeResponse>
Related Operations• ResetImageAttribute (p. 255)
• DescribeImageAttribute (p. 191)
Amazon Elastic Compute Cloud API ReferenceMonitorInstances
API Version 2009-07-15244
MonitorInstancesDescriptionEnables monitoring for a running instance. For more information, refer to the Amazon CloudWatchDeveloper Guide.
Request ParametersName Description Required
MonitorInstancesType MonitorInstancesType element.
Type: MonitorInstancesType (p. 357)
Ancestor: None
Children: instancesSet
instancesSet Set of instances.
Type: MonitorInstancesSetType (p. 357)
Ancestor: MonitorInstancesType
Children: item
item Instance set.
Type: MonitorInstancesSetItemType (p. 356)
Ancestor: instancesSet
Children: instanceId
instanceId Instance ID.
Type: xsd:string
Default: None
Ancestor: item
Children: None
Yes
Response ElementsName Description
MonitorInstancesResponseTypeMonitorInstancesResponseType element.
Type: MonitorInstancesResponseType (p. 356)
Ancestor: None
Children: requestId, instancesSet
requestId The ID of the request.
Type: xsd:string
Ancestor: MonitorInstancesResponseType
Children: None
instancesSet Monitor instance response set.
Type: MonitorInstancesResponseSetType (p. 355)
Ancestor: MonitorInstancesResponseType
Children: item
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15245
Name Description
item Instance Item.
Type: MonitorInstancesResponseSetItemType (p. 355)
Ancestor: instancesSet
Children: instanceId, monitoring
instanceId Instance ID.
Type: xsd:string
Ancestor: item
Children: None
monitoring Monitoring information.
Type: InstanceMonitoringStateType (p. 348)
Ancestor: item
Children: state
state State of monitoring for the instance.
Type: xsd:string
Ancestor: monitoring
Children: None
Examples
Example Request
This example enables monitoring for i-43a4412a and i-23a3397d.
<MonitorInstances xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instancesSet> <instanceId>i-43a4412a</instanceId> <instanceId>i-23a3397d</instanceId> </instancesSet></MonitorInstances>
Example Response
<MonitorInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instancesSet> <item> <instanceId>i-43a4412a</instanceId> <monitoring> <state>pending</state> </monitoring> </item> <item> <instanceId>i-23a3397d</instanceId> <monitoring> <state>pending</state> </monitoring> </item> </instancesSet></MonitorInstancesResponse>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15246
Related Operations• UnmonitorInstances (p. 275)
• RunInstances (p. 261)
Amazon Elastic Compute Cloud API ReferencePurchaseReservedInstancesOffering
API Version 2009-07-15247
PurchaseReservedInstancesOfferingDescriptionPurchases a Reserved Instance for use with your account. With Amazon EC2 Reserved Instances, youpurchase the right to launch Amazon EC2 instances for a period of time (without getting insufficientcapacity errors) and pay a lower usage rate for the actual time used. For more information aboutReserved Instances, go to the Amazon Elastic Compute Cloud Developer Guide.
Request ParametersName Description Required
PurchaseReservedInstancesOfferingTypePurchaseReservedInstancesOfferingTypeelement.
Type: PurchaseReservedInstancesOfferingType (p.362)
Ancestor: None
Children: reservedInstancesOfferingId,instanceCount
reservedInstancesOfferingIdThe offering ID of the Reserved Instance to purchase.
Type: xsd:string
Default: None
Ancestor:PurchaseReservedInstancesOfferingType
Children: None
Yes
instanceCount The number of Reserved Instances to purchase.
Type: xsd:int
Default: 1
Ancestor:PurchaseReservedInstancesOfferingType
Children: None
No
Response ElementsName Description
PurchaseReservedInstancesOfferingResponseTypePurchaseReservedInstancesOfferingResponseTypeelement.
Type: PurchaseReservedInstancesOfferingResponseType (p.361)
Ancestor: None
Children: requestId, reservedInstancesId
requestId The ID of the request.
Type: xsd:string
Ancestor:PurchaseReservedInstancesOfferingResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15248
Name Description
reservedInstancesId The IDs of the purchased Reserved Instances.
Type: xsd:string
Ancestor:PurchaseReservedInstancesOfferingResponseType
Children: None
Examples
Example RequestThis example purchases Reserved Instances.
<PurchaseReservedInstancesOffering xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <reservedInstancesOfferingId>4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8</reservedInstancesOfferingId> <instanceCount>19</instanceCount> </PurchaseReservedInstancesOffering>
Example Response<PurchaseReservedInstancesOfferingResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <reservedInstancesId>reservation-1001001</reservedInstancesId> </PurchaseReservedInstancesOfferingResponse>
Related Operations• DescribeReservedInstancesOfferings (p. 216)
• DescribeReservedInstances (p. 213)
Amazon Elastic Compute Cloud API ReferenceRebootInstances
API Version 2009-07-15249
RebootInstances
DescriptionRequests a reboot of one or more instances. This operation is asynchronous; it only queues a requestto reboot the specified instance(s). The operation will succeed if the instances are valid and belong toyou. Requests to reboot terminated instances are ignored.
Note
If a Linux/UNIX instance does not cleanly shut down within four minutes, Amazon EC2 willperform a hard reboot.
Request Parameters
Name Description Required
RebootInstancesType RebootInstancesType element.
Type: RebootInstancesType (p. 364)
Ancestor: None
Children: instancesSet
instancesSet Launch permission set.
Type: RebootInstancesInfoType (p. 362)
Ancestor: RebootInstancesType
Children: item
item Information for an instance.
Type: RebootInstancesItemType (p. 363)
Ancestor: instancesSet
Children: instanceId
instanceId One or more instance IDs.
Type: xsd:string
Default: None
Ancestor: item
Children: None
Yes
Response Elements
Name Description
RebootInstancesResponseTypeRebootInstancesResponseType element.
Type: RebootInstancesResponseType (p. 363)
Ancestor: None
Children: requestId, return
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15250
Name Description
requestId The ID of the request.
Type: xsd:string
Ancestor: RebootInstancesResponseType
Children: None
return Returns "true" if successful; otherwise "false".
Type: xsd:boolean
Ancestor: RebootInstancesResponseType
Children: None
Examples
Example RequestThis example reboots an instance.
<RebootInstances xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instancesSet> <item> <instanceId>i-28a64341</instanceId> </item> </instancesSet></RebootInstances>
Example Response<RebootInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></RebootInstancesResponse>
Related Operations• RunInstances (p. 261)
Amazon Elastic Compute Cloud API ReferenceRegisterImage
API Version 2009-07-15251
RegisterImage
DescriptionRegisters an AMI with Amazon EC2. Images must be registered before they can be launched. Tolaunch instances, use the RunInstances operation.
Each AMI is associated with an unique ID which is provided by the Amazon EC2 service through theRegisterImage operation. During registration, Amazon EC2 retrieves the specified image manifestfrom Amazon S3 and verifies that the image is owned by the user registering the image.
The image manifest is retrieved once and stored within the Amazon EC2. Any modifications to animage in Amazon S3 invalidates this registration. If you make changes to an image, deregister theprevious image and register the new image. To deregister an image, use the DeregisterImageoperation.
Request Parameters
Name Description Required
RegisterImageType RegisterImageType element.
Type: RegisterImageType (p. 366)
Ancestor: None
Children: imageLocation
imageLocation Full path to your AMI manifest in Amazon S3 storage.
Type: xsd:string
Default: None
Ancestor: RegisterImageType
Children: None
Yes
Response Elements
Name Description
RegisterImageResponseType RegisterImageResponseType element.
Type: RegisterImageResponseType (p. 365)
Ancestor: None
Children: requestId, imageId
requestId The ID of the request.
Type: xsd:string
Ancestor: RegisterImageResponseType
Children: None
imageId Unique ID of the newly registered machine image.
Type: xsd:string
Ancestor: RegisterImageResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15252
Examples
Example RequestThis example registers the AMI specified in the image.manifest.xml manifest file.
<RegisterImage xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imageLocation>/mybucket/myimage.manifest.xml</imageLocation></RegisterImage>
Example Response<RegisterImageResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imageId>ami-61a54008</imageId></RegisterImageResponse>
Related Operations• DescribeImages (p. 196)
• DeregisterImage (p. 179)
Amazon Elastic Compute Cloud API ReferenceReleaseAddress
API Version 2009-07-15253
ReleaseAddress
DescriptionReleases an elastic IP address associated with your account.
If you run this operation on an elastic IP address that is already released, the address might beassigned to another account which will cause Amazon EC2 to return an error.
Note
Releasing an IP address automatically disassociates it from any instance withwhich it is associated. To disassociate an IP address without releasing it, use theDisassociateAddress operation.
Important
After releasing an elastic IP address, it is released to the IP address pool and might no longerbe available to your account. Make sure to update your DNS records and any servers ordevices that communicate with the address.
Request ParametersName Description Required
ReleaseAddressType ReleaseAddressType element.
Type: ReleaseAddressType (p. 367)
Ancestor: None
Children: publicIp
publicIp The IP address that you are releasing from youraccount.
Type: xsd:string
Default: None
Ancestor: ReleaseAddressType
Children: None
Yes
Response ElementsName Description
ReleaseAddressResponseTypeReleaseAddressResponseType element.
Type: ReleaseAddressResponseType (p. 366)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: ReleaseAddressResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15254
Name Description
return Returns "true" if successful; otherwise "false".
Type: xsd:boolean
Ancestor: ReleaseAddressResponseType
Children: None
Examples
Example RequestThis example releases an elastic IP address associated with the account.
<ReleaseAddress xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <publicIp>67.202.55.255</publicIp></ReleaseAddress>
Example Response<ReleaseAddressResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></ReleaseAddressResponse>
Related Operations• AllocateAddress (p. 138)
• DescribeAddresses (p. 181)
• AssociateAddress (p. 140)
• DisassociateAddress (p. 234)
Amazon Elastic Compute Cloud API ReferenceResetImageAttribute
API Version 2009-07-15255
ResetImageAttribute
DescriptionResets an attribute of an AMI to its default value.
Note
The productCodes attribute cannot be reset.
Request Parameters
Name Description Required
ResetImageAttributeTypeResetImageAttributeType element.
Type: ResetImageAttributeType (p. 369)
Ancestor: None
Children: imageId, ResetImageAttributesGroup
imageId ID of the AMI on which the attribute will be reset.
Type: xsd:string
Default: None
Ancestor: ResetImageAttributeType
Children: None
Yes
ResetImageAttributesGroupThe reset image attribute group.
Type: ResetImageAttributesGroup (p. 369)
Ancestor: ResetImageAttributeType
Children: launchPermission
launchPermission Resets the launch permission attribute.
Type: EmptyElementType (p. 344)
Ancestor: ResetImageAttributesGroup
Children: none
none These element contains no options.
Type: xsd:string
Default: None
Ancestor: launchPermission
Children: None
No
Response Elements
Name Description
ResetImageAttributeResponseTypeResetImageAttributeResponseType element.
Type: ResetImageAttributeResponseType (p. 368)
Ancestor: None
Children: requestId, return
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15256
Name Description
requestId The ID of the request.
Type: xsd:string
Ancestor: ResetImageAttributeResponseType
Children: None
return Indicates whether the attribute successfully reset.
Type: xsd:boolean
Ancestor: ResetImageAttributeResponseType
Children: None
Examples
Example RequestThis example resets the launchPermission attribute.
<ResetImageAttribute xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imageId>ami-6ba54002</imageId> <launchPermission/></ResetImageAttribute>
Example Response<ResetImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></ResetImageAttributeResponse>
Related Operations• ModifyImageAttribute (p. 240)
• DescribeImageAttribute (p. 191)
Amazon Elastic Compute Cloud API ReferenceRevokeSecurityGroupIngress
API Version 2009-07-15257
RevokeSecurityGroupIngress
DescriptionRevokes permissions from a security group. The permissions used to revoke must be specified usingthe same values used to grant the permissions.
Permissions are specified by IP protocol (TCP, UDP, or ICMP), the source of the request (by IP rangeor an Amazon EC2 user-group pair), the source and destination port ranges (for TCP and UDP), andthe ICMP codes and types (for ICMP).
Permission changes are quickly propagated to instances within the security group. However,depending on the number of instances in the group, a small delay is might occur.
Request Parameters
Name Description Required
RevokeSecurityGroupIngressTypeRevokeSecurityGroupIngressType element.
Type: RevokeSecurityGroupIngressType (p. 370)
Ancestor: None
Children: userId, groupName, and ipPermissions
userId AWS Access Key ID.
Type: xsd:string
Default: None
Ancestor: RevokeSecurityGroupIngressType
Children: None
Yes
groupName Name of the group to modify.
Type: xsd:string
Default: None
Ancestor: RevokeSecurityGroupIngressType
Children: None
Yes
ipPermissions Set of permissions to add to the group.
Type: IpPermissionSetType (p. 349)
Ancestor: RevokeSecurityGroupIngressType
Children: item
Yes
item Set of IP permissions.
Type: IpPermissionType (p. 350)
Ancestor: ipPermissions
Children: ipProtocol, fromPort, toPort, groups,and ipRanges
Yes
ipProtocol IP protocol.
Type: xsd:string
Default: None
Valid Values: tcp | udp | icmp
Ancestor: item
Children: None
Yes
Amazon Elastic Compute Cloud API ReferenceRequest Parameters
API Version 2009-07-15258
Name Description Required
fromPort Start of port range for the TCP and UDP protocols,or an ICMP type number. An ICMP type number of -1indicates a wildcard (i.e., any ICMP type number).
Type: xsd:int
Default: None
Ancestor: item
Children: None
Yes
toPort End of port range for the TCP and UDP protocols, oran ICMP code. An ICMP code of -1 indicates a wildcard(i.e., any ICMP code).
Type: xsd:int
Default: None
Ancestor: item
Children: None
Yes
groups List of security group and user ID pairs.
Type: UserIdGroupPairSetType (p. 380)
Ancestor: item
Children: item
Yes
item Information for one security group.
Type: UserIdGroupPairType (p. 380)
Ancestor: groups
Children: userId, groupName
Yes
userId AWS User ID of an account.
Type: xsd:string
Default: None
Ancestor: item
Children: None
Yes
groupName Name of the security group.
Type: xsd:string
Default: None
Ancestor: item
Children: None
Yes
ipRanges IP ranges.
Type: IpRangeSetType (p. 351)
Ancestor: item
Children: item
Yes
item Information for one IP range.
Type: IpRangeItemType (p. 351)
Ancestor: ipRanges
Children: cidrIp
Yes
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15259
Name Description Required
cidrIp CIDR range.
Type: xsd:string
Default: None
Constraints: Valid CIDR IP address range.
Ancestor: item
Children: None
Yes
Response ElementsName Description
RevokeSecurityGroupIngressResponseTypeRevokeSecurityGroupIngressResponseType element.
Type: RevokeSecurityGroupIngressResponseType (p. 370)
Ancestor: None
Children: requestId, return
requestId The ID of the request.
Type: xsd:string
Ancestor: RevokeSecurityGroupIngressResponseType
Children: None
return Returns "true" if the request is successful; otherwise "false".
Type: xsd:boolean
Ancestor: RevokeSecurityGroupIngressResponseType
Children: None
Examples
Example RequestThis example revokes TCP port 80 access from the 205.192.0.0/16 address range for the websrvsecurity group.
<RevokeSecurityGroupIngress xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <userId/> <groupName>websrv</groupName> <ipPermissions> <item> <ipProtocol>tcp</ipProtocol> <fromPort>80</fromPort> <toPort>80</toPort> <groups/> <ipRanges> <item> <cidrIp>205.192.0.0/16</cidrIp> </item> <ipRanges> </item> </ipPermissions></RevokeSecurityGroupIngress>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15260
Example Response<RevokeSecurityGroupIngressResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return></RevokeSecurityGroupIngressResponse>
Related Operations• CreateSecurityGroup (p. 164)
• DescribeSecurityGroups (p. 220)
• AuthorizeSecurityGroupIngress (p. 145)
• DeleteSecurityGroup (p. 173)
Amazon Elastic Compute Cloud API ReferenceRunInstances
API Version 2009-07-15261
RunInstances
DescriptionLaunches a specified number of instances of an AMI for which you have permissions.
If Amazon EC2 cannot launch the minimum number AMIs you request, no instances will be launched.If there is insufficient capacity to launch the maximum number of AMIs you request, Amazon EC2launches the minimum number specified for each AMI and allocate the remaining available instancesusing round robin.
In the following example, Libby generates a request to launch two images (database and web_server):
1. Libby runs the RunInstances operation to launch database instances (min. 10, max. 15) andweb_server instances (min. 30, max. 40).
Because there are currently 30 instances available and Libby needs a minimum of 40, no instancesare launched.
2. Libby adjusts the number of instances she needs and runs the RunInstances operation to launchdatabase instances (min. 5, max. 10) and web_server instances (min. 20, max. 40).
Amazon EC2 launches the minimum number of instances for each AMI (5 database, 20web_server).
The remaining 5 instances are allocated using round robin.
3. Libby adjusts the number of instances she needs and runs the RunInstances operation again tolaunch database instances (min. 5, max. 10) and web_server instances (min. 20, max. 40).
Note
Every instance is launched in a security group (created using the CreateSecurityGroupoperation.
You can provide an optional key pair ID for each image in the launch request (created using theCreateKeyPair operation). All instances that are created from images that use this key pair willhave access to the associated public key at boot. You can use this key to provide secure access to aninstance of an image on a per-instance basis. Amazon EC2 public images use this feature to providesecure access without passwords.
Important
Launching public images without a key pair ID will leave them inaccessible.
The public key material is made available to the instance at boot time by placing it in theopenssh_id.pub file on a logical device that is exposed to the instance as /dev/sda2 (the instancestore). The format of this file is suitable for use as an entry within ~/.ssh/authorized_keys (theOpenSSH format). This can be done at boot (e.g., as part of rc.local) allowing for secure accesswithout passwords.
Optional user data can be provided in the launch request. All instances that collectively comprise thelaunch request have access to this data. For more information, go the Amazon Elastic Compute CloudDeveloper Guide.
Amazon Elastic Compute Cloud API ReferenceRequest Parameters
API Version 2009-07-15262
Note
If any of the AMIs have a product code attached for which the user has not subscribed, theRunInstances call will fail.
Important
We strongly recommend using the 2.6.18 Xen stock kernel with the c1.medium and c1.xlargeinstances. Although the default Amazon EC2 kernels will work, the new kernels providegreater stability and performance for these instance types. For more information about kernels,go the Amazon Elastic Compute Cloud Developer Guide.
Request Parameters
Name Description Required
RunInstancesType RunInstancesType element.
Type: RunInstancesType (p. 371)
Ancestor: None
Children: imageId, minCount, maxCount,keyName, groupSet, additionalInfo, userData,addressingType, instanceType, placement,kernelId, ramdiskId, blockDeviceMapping,monitoring, and subnetId
imageId Unique ID of a machine image, returned by a call to
Type: xsd:string
Default: None
Ancestor: RunInstancesType
Children: None
Yes
minCount Minimum number of instances to launch. If the value ismore than Amazon EC2 can launch, no instances arelaunched at all.
Type: xsd:int
Default: None
Constraints: Between 1 and the maximum numberallowed for your account (default: 20).
Ancestor: RunInstancesType
Children: None
Yes
maxCount Maximum number of instances to launch. If the value ismore than Amazon EC2 can launch, the largest possiblenumber above minCount will be launched instead.
Type: xsd:int
Default: None
Constraints: Between 1 and the maximum numberallowed for your account (default: 20).
Ancestor: RunInstancesType
Children: None
Yes
Amazon Elastic Compute Cloud API ReferenceRequest Parameters
API Version 2009-07-15263
Name Description Required
keyName The name of the key pair.
Type: xsd:string
Default: None
Ancestor: RunInstancesType
Children: None
No
groupSet Group set.
Type: GroupSetType (p. 347)
Ancestor: RunInstancesType
Children: item
item Group set item.
Type: GroupItemType (p. 347)
Ancestor: groupSet
Children: groupId
groupId Name of the security group.
Type: xsd:string
Default: None
Ancestor: item
Children: None
No
additionalInfo Specifies additional information to make available to theinstance(s).
Type: xsd:string
Default: None
Ancestor: RunInstancesType
Children: None
No
userData User data.
Type: UserDataType (p. 379)
Ancestor: RunInstancesType
Children: data
data The user data.
Type: xsd:string
Default: None
Ancestor: userData
Children: None
No
addressingType Deprecated.
Type: xsd:string
Default: None
Ancestor: RunInstancesType
Children: None
No
Amazon Elastic Compute Cloud API ReferenceRequest Parameters
API Version 2009-07-15264
Name Description Required
instanceType Specifies the instance type.
Type: xsd:string
Default: m1.small
Valid Values: m1.small | m1.large | m1.xlarge |c1.medium | c1.xlarge
Ancestor: RunInstancesType
Children: None
No
placement Placement item.
Type: PlacementRequestType (p. 358)
Ancestor: RunInstancesType
Children: availabilityZone
No
availabilityZone Specifies the placement constraints (Availability Zones)for launching the instances.
Type: xsd:string
Default: Amazon EC2 selects an Availability Zone.
Ancestor: placement
Children: None
No
kernelId The ID of the kernel with which to launch the instance.
Type: xsd:string
Default: None
Ancestor: RunInstancesType
Children: None
No
ramdiskId The ID of the RAM disk with which to launch theinstance. Some kernels require additional drivers atlaunch. Check the kernel requirements for informationon whether you need to specify a RAM disk. To findkernel requirements, go to the Resource Center andsearch for the kernel ID.
Type: xsd:string
Default: None
Ancestor: RunInstancesType
Children: None
No
blockDeviceMapping Specifies how block devices are exposed to theinstance. Each mapping is made up of a virtualNameand a deviceName.
Type: BlockDeviceMappingType (p. 290)
Ancestor: RunInstancesType
Children: item
No
item Information for one block device mapping.
Type: BlockDeviceMappingItemType (p. 290)
Ancestor: blockDeviceMapping
Children: virtualName, deviceName
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15265
Name Description Required
virtualName The virtual name.
Type: xsd:string
Default: None
Ancestor: item
Children: None
No
deviceName The device name (e.g., /dev/sdh).
Type: xsd:string
Default: None
Ancestor: item
Children: None
No
monitoring Specifies whether to enable monitoring for the instance.
Type: MonitoringInstanceType (p. 354)
Ancestor: RunInstancesType
Children: enabled
No
enabled Enables monitoring for the instance.
Type: xsd:boolean
Default: Disabled
Ancestor: monitoring
Children: None
No
subnetId Specifies the subnet ID within which to launch theinstance(s) for Amazon Virtual Private Cloud.
Type: xsd:string
Default: None
Ancestor: RunInstancesType
Children: None
No
Response Elements
Name Description
RunInstancesResponseType RunInstancesResponseType element.
Type: RunInstancesResponseType (p. 371)
Ancestor: None
Children: requestId, reservationId, ownerId, groupSet,instancesSet, and requesterId
requestId The ID of the request.
Type: xsd:string
Ancestor: RunInstancesResponseType
Children: None
reservationId Unique ID of the reservation.
Type: xsd:string
Ancestor: RunInstancesResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15266
Name Description
ownerId AWS Access Key ID of the user who owns the reservation.
Type: xsd:string
Ancestor: RunInstancesResponseType
Children: None
groupSet Group set.
Type: GroupSetType (p. 347)
Ancestor: RunInstancesResponseType
Children: item
item Group set item.
Type: GroupItemType (p. 347)
Ancestor: groupSet
Children: groupId
groupId Name of the security group.
Type: xsd:string
Ancestor: item
Children: None
instancesSet Instance set.
Type: RunningInstancesSetType (p. 375)
Ancestor: RunInstancesResponseType
Children: item
item Running instance set item.
Type: RunningInstancesItemType (p. 373)
Ancestor: instancesSet
Children: instanceId, imageId, instanceState,privateDnsName, dnsName, reason, keyName,amiLaunchIndex, productCodes, instanceType,launchTime, placement, kernelId, ramdiskId, platform,monitoring, subnetId, vpcId, privateIpAddress, andipAddress
instanceId Unique ID of the instance launched.
Type: xsd:string
Ancestor: item
Children: None
imageId Image ID of the AMI used to launch the instance.
Type: xsd:string
Ancestor: item
Children: None
instanceState The current state of the instance.
Type: InstanceStateType (p. 348)
Ancestor: item
Children: code, name
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15267
Name Description
code A 16-bit unsigned integer. The high byte is an opaque internalvalue and should be ignored. The low byte is set based on thestate represented:
Type: xsd:int
Ancestor: instanceState
Children: None
name The current state of the instance.
Type: xsd:string
Ancestor: instanceState
Children: None
privateDnsName The private DNS name assigned to the instance. This DNS namecan only be used inside the Amazon EC2 network. This elementremains empty until the instance enters a running state.
Type: xsd:string
Ancestor: item
Children: None
dnsName The public DNS name assigned to the instance. This DNS name iscontactable from outside the Amazon EC2 network. This elementremains empty until the instance enters a running state.
Type: xsd:string
Ancestor: item
Children: None
reason Reason for the most recent state transition. This might be anempty string.
Type: xsd:string
Ancestor: item
Children: None
keyName If this instance was launched with an associated key pair, thisdisplays the key pair name.
Type: xsd:string
Ancestor: item
Children: None
amiLaunchIndex The AMI launch index, which can be used to find this instancewithin the launch group. For more information, go to the Metadatasection of the
Type: xsd:string
Ancestor: item
Children: None
productCodes Product codes attached to this instance.
Type: ProductCodesSetType (p. 361)
Ancestor: item
Children: item
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15268
Name Description
item Information for one product code.
Type: ProductCodesSetItemType (p. 360)
Ancestor: productCodes
Children: productCode
productCode Product code.
Type: xsd:string
Ancestor: item
Children: None
instanceType The instance type. For more information on instance types, go tothe
Type: xsd:string
Ancestor: item
Children: None
launchTime The time the instance launched.
Type: xsd:dateTime
Ancestor: item
Children: None
placement The location where the instance launched.
Type: PlacementResponseType (p. 359)
Ancestor: item
Children: availabilityZone
availabilityZone Returns the Availability Zones of the instances.
Type: xsd:string
Ancestor: placement
Children: None
kernelId Optional. Kernel associated with this instance.
Type: xsd:string
Ancestor: item
Children: None
ramdiskId Optional. RAM disk associated with this instance.
Type: xsd:string
Ancestor: item
Children: None
platform Platform of the instance (e.g., Windows).
Type: xsd:string
Ancestor: item
Children: None
monitoring Specifies whether monitoring is enabled for the instance.
Type: InstanceMonitoringStateType (p. 348)
Ancestor: item
Children: state
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15269
Name Description
state State of monitoring for the instance.
Type: xsd:string
Ancestor: monitoring
Children: None
subnetId Specifies the subnet ID in which the instance is running (AmazonVirtual Private Cloud).
Type: xsd:string
Ancestor: item
Children: None
vpcId Specifies the VPC in which the instance is running (Amazon VPC).
Type: xsd:string
Ancestor: item
Children: None
privateIpAddress Specifies the private IP address that is assigned to the instance(Amazon VPC).
Type: xsd:string
Ancestor: item
Children: None
ipAddress Specifies the IP address of the instance.
Type: xsd:string
Ancestor: item
Children: None
requesterId ID of the requester.
Type: xsd:string
Ancestor: RunInstancesResponseType
Children: None
Examples
Example Request
This example launches three instances of the ami-60a54009 AMI.
<RunInstances xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <imageId>ami-60a54009</imageId> <minCount>1</minCount> <maxCount>3</maxCount> <keyName>example-key-name</keyName> <groupSet/> <placement> <availabilityZone>us-east-1b</availabilityZone> </placement> <kernelId>aki-ba3adfd3</kernelId> <ramdiskId>ari-badbad00</ramdiskId> <blockDeviceMapping> <item>
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15270
<virtualName>ami</virtualName> <deviceName>sda1<deviceName> </item> <item> <virtualName>root</virtualName> <deviceName>/dev/sda1</deviceName> </item> <item> <virtualName>instancestore0</virtualName> <deviceName>sdb</deviceName> </item> <item> <virtualName>instance1</virtualName> <deviceName>sdc</deviceName> </item> </blockDeviceMapping> <userData version="1.0" encoding="base64"><data>"VGhpcyBpcyBiYXNlIDY0IQ==</data></userData> <addressingType>public</addressingType> <monitoring>enabled</monitoring></RunInstances>
Example Response<RunInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <reservationId>r-47a5402e</reservationId> <ownerId>AIDADH4IGTRXXKCD</ownerId> <groupSet> <item> <groupId>default</groupId> </item> </groupSet> <instancesSet> <item> <instanceId>i-2ba64342</instanceId> <imageId>ami-60a54009</imageId> <instanceState> <code>0</code> <name>pending</name> </instanceState> <privateDnsName></privateDnsName> <dnsName></dnsName> <keyName>example-key-name</keyName> <amiLaunchIndex>0</amiLaunchIndex> <instanceType>m1.small</instanceType> <launchTime>2007-08-07T11:51:50.000Z</launchTime> <placement> <availabilityZone>us-east-1b</availabilityZone> </placement> <monitoring> <enabled>true</enabled> </monitoring>
</item> <item> <instanceId>i-2bc64242</instanceId> <imageId>ami-60a54009</imageId> <instanceState> <code>0</code> <name>pending</name>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15271
</instanceState> <privateDnsName></privateDnsName> <dnsName></dnsName> <keyName>example-key-name</keyName> <amiLaunchIndex>1</amiLaunchIndex> <instanceType>m1.small</instanceType> <launchTime>2007-08-07T11:51:50.000Z</launchTime> <placement> <availabilityZone>us-east-1b</availabilityZone> </placement> <monitoring> <enabled>true</enabled> </monitoring> </item> <item> <instanceId>i-2be64332</instanceId> <imageId>ami-60a54009</imageId> <instanceState> <code>0</code> <name>pending</name> </instanceState> <privateDnsName></privateDnsName> <dnsName></dnsName> <keyName>example-key-name</keyName> <amiLaunchIndex>2</amiLaunchIndex> <instanceType>m1.small</instanceType> <launchTime>2007-08-07T11:51:50.000Z</launchTime> <placement> <availabilityZone>us-east-1b</availabilityZone> </placement> <monitoring> <enabled>true</enabled> </monitoring> </item> </instancesSet></RunInstancesResponse>
Related Operations• DescribeInstances (p. 202)
• TerminateInstances (p. 272)
• AuthorizeSecurityGroupIngress (p. 145)
• RevokeSecurityGroupIngress (p. 257)
• DescribeSecurityGroups (p. 220)
• CreateSecurityGroup (p. 164)
• CreateKeyPair (p. 161)
Amazon Elastic Compute Cloud API ReferenceTerminateInstances
API Version 2009-07-15272
TerminateInstances
DescriptionShuts down one or more instances. This operation is idempotent; if you terminate an instance morethan once, each call will succeed.
Terminated instances will remain visible after termination (approximately one hour).
Request Parameters
Name Description Required
TerminateInstancesTypeTerminateInstancesType element.
Type: TerminateInstancesType (p. 379)
Ancestor: None
Children: instancesSet
instancesSet Set of instances.
Type: TerminateInstancesInfoType (p. 376)
Ancestor: TerminateInstancesType
Children: item
Yes
item Information for a instance.
Type: TerminateInstancesItemType (p. 377)
Ancestor: instancesSet
Children: instanceId
Yes
instanceId Instance ID to terminate.
Type: xsd:string
Default: None
Ancestor: item
Children: None
Yes
Response Elements
Name Description
TerminateInstancesResponseTypeTerminateInstancesResponseType element.
Type: TerminateInstancesResponseType (p. 378)
Ancestor: None
Children: requestId, instancesSet
requestId The ID of the request.
Type: xsd:string
Ancestor: TerminateInstancesResponseType
Children: None
Amazon Elastic Compute Cloud API ReferenceResponse Elements
API Version 2009-07-15273
Name Description
instancesSet Instances set.
Type: TerminateInstancesResponseInfoType (p. 377)
Ancestor: TerminateInstancesResponseType
Children: item
item Response item.
Type: TerminateInstancesResponseItemType (p. 378)
Ancestor: instancesSet
Children: instanceId, shutdownState, and previousState
instanceId Instance ID.
Type: xsd:string
Ancestor: item
Children: None
shutdownState Shutdown state.
Type: InstanceStateType (p. 348)
Ancestor: item
Children: code, name
code A 16-bit unsigned integer. The high byte is an opaque internalvalue and should be ignored. The low byte is set based on thestate represented:
Type: xsd:int
Ancestor: shutdownState
Children: None
name The current state of the instance.
Type: xsd:string
Ancestor: shutdownState
Children: None
previousState Previous state.
Type: InstanceStateType (p. 348)
Ancestor: item
Children: code, name
code A 16-bit unsigned integer. The high byte is an opaque internalvalue and should be ignored. The low byte is set based on thestate represented:
Type: xsd:int
Ancestor: previousState
Children: None
name The current state of the instance.
Type: xsd:string
Ancestor: previousState
Children: None
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15274
Examples
Example RequestThis example terminates the i-3ea74257 instance.
<TerminateInstances xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instancesSet> <item> <instanceId>i-3ea74257</instanceId> </item> </instancesSet></TerminateInstances>
Example Response<TerminateInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instancesSet> <item> <instanceId>i-3ea74257</instanceId> <shutdownState> <code>32</code> <name>shutting-down</name> </shutdownState> <previousState> <code>16</code> <name>running</name> </previousState> </item> </instancesSet></TerminateInstancesResponse>
Related Operations• DescribeInstances (p. 202)
Amazon Elastic Compute Cloud API ReferenceUnmonitorInstances
API Version 2009-07-15275
UnmonitorInstancesDescriptionDisables monitoring for a running instance. For more information, refer to the Amazon CloudWatchDeveloper Guide.
Request ParametersName Description Required
MonitorInstancesType MonitorInstancesType element.
Type: MonitorInstancesType (p. 357)
Ancestor: None
Children: instancesSet
instancesSet Set of instances.
Type: MonitorInstancesSetType (p. 357)
Ancestor: MonitorInstancesType
Children: item
item Instance set.
Type: MonitorInstancesSetItemType (p. 356)
Ancestor: instancesSet
Children: instanceId
instanceId Instance ID.
Type: xsd:string
Default: None
Ancestor: item
Children: None
Yes
Response ElementsName Description
MonitorInstancesResponseTypeMonitorInstancesResponseType element.
Type: MonitorInstancesResponseType (p. 356)
Ancestor: None
Children: requestId, instancesSet
requestId The ID of the request.
Type: xsd:string
Ancestor: MonitorInstancesResponseType
Children: None
instancesSet Monitor instance response set.
Type: MonitorInstancesResponseSetType (p. 355)
Ancestor: MonitorInstancesResponseType
Children: item
Amazon Elastic Compute Cloud API ReferenceExamples
API Version 2009-07-15276
Name Description
item Instance Item.
Type: MonitorInstancesResponseSetItemType (p. 355)
Ancestor: instancesSet
Children: instanceId, monitoring
instanceId Instance ID.
Type: xsd:string
Ancestor: item
Children: None
monitoring Monitoring information.
Type: InstanceMonitoringStateType (p. 348)
Ancestor: item
Children: state
state State of monitoring for the instance.
Type: xsd:string
Ancestor: monitoring
Children: None
Examples
Example Request
This example disables monitoring for i-43a4412a and i-23a3397d.
<UnmonitorInstances xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instancesSet> <instanceId> i-43a4412a</instanceId> <instanceId>i-23a3397d</instanceId> </instancesSet></UnmonitorInstances>
Example Response
<UnmonitorInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <instancesSet> <item> <instanceId> i-43a4412a</instanceId> <monitoring> <state>pending</state> </monitoring> </item> <item> <instanceId>i-23a3397d</instanceId> <monitoring> <state>pending</state> </monitoring> </item> </instancesSet></UnmonitorInstancesResponse>
Amazon Elastic Compute Cloud API ReferenceRelated Operations
API Version 2009-07-15277
Related Operations• MonitorInstances (p. 244)
• RunInstances (p. 261)
Amazon Elastic Compute Cloud API Reference
API Version 2009-07-15278
Data Types
Topics
• AllocateAddressResponseType (p. 282)
• AssociateAddressResponseType (p. 283)
• AssociateAddressType (p. 283)
• AttachmentSetItemResponseType (p. 284)
• AttachmentSetResponseType (p. 284)
• AttachVolumeResponseType (p. 285)
• AttachVolumeType (p. 286)
• AttributeValueType (p. 286)
• AuthorizeSecurityGroupIngressResponseType (p. 287)
• AuthorizeSecurityGroupIngressType (p. 287)
• AvailabilityZoneItemType (p. 288)
• AvailabilityZoneMessageSetType (p. 288)
• AvailabilityZoneMessageType (p. 289)
• AvailabilityZoneSetType (p. 289)
• BlockDeviceMappingItemType (p. 290)
• BlockDeviceMappingType (p. 290)
• BundleInstanceResponseType (p. 291)
• BundleInstanceS3StorageType (p. 291)
• BundleInstanceTaskErrorType (p. 292)
• BundleInstanceTasksSetType (p. 293)
• BundleInstanceTaskStorageType (p. 293)
• BundleInstanceTaskType (p. 294)
• BundleInstanceType (p. 295)
• CancelBundleTaskResponseType (p. 295)
• CancelBundleTaskType (p. 296)
Amazon Elastic Compute Cloud API Reference
API Version 2009-07-15279
• ConfirmProductInstanceResponseType (p. 296)
• ConfirmProductInstanceType (p. 297)
• CreateKeyPairResponseType (p. 297)
• CreateKeyPairType (p. 298)
• CreateSecurityGroupResponseType (p. 298)
• CreateSecurityGroupType (p. 299)
• CreateSnapshotResponseType (p. 299)
• CreateSnapshotType (p. 300)
• CreateVolumeResponseType (p. 300)
• CreateVolumeType (p. 301)
• DeleteKeyPairResponseType (p. 302)
• DeleteKeyPairType (p. 302)
• DeleteSecurityGroupResponseType (p. 303)
• DeleteSecurityGroupType (p. 303)
• DeleteSnapshotResponseType (p. 304)
• DeleteSnapshotType (p. 304)
• DeleteVolumeResponseType (p. 304)
• DeleteVolumeType (p. 305)
• DeregisterImageResponseType (p. 305)
• DeregisterImageType (p. 306)
• DescribeAddressesInfoType (p. 306)
• DescribeAddressesItemType (p. 307)
• DescribeAddressesResponseInfoType (p. 307)
• DescribeAddressesResponseItemType (p. 308)
• DescribeAddressesResponseType (p. 308)
• DescribeAddressesType (p. 309)
• DescribeAvailabilityZonesResponseType (p. 309)
• DescribeAvailabilityZonesSetItemType (p. 310)
• DescribeAvailabilityZonesSetType (p. 310)
• DescribeAvailabilityZonesType (p. 311)
• DescribeBundleTasksInfoType (p. 311)
• DescribeBundleTasksItemType (p. 311)
• DescribeBundleTasksResponseType (p. 312)
• DescribeBundleTasksType (p. 312)
• DescribeImageAttributeResponseType (p. 313)
• DescribeImageAttributesGroup (p. 314)
• DescribeImageAttributeType (p. 314)
• DescribeImagesExecutableBySetType (p. 315)
• DescribeImagesExecutableByType (p. 315)
• DescribeImagesInfoType (p. 316)
• DescribeImagesItemType (p. 316)
• DescribeImagesOwnersType (p. 317)
Amazon Elastic Compute Cloud API Reference
API Version 2009-07-15280
• DescribeImagesOwnerType (p. 317)
• DescribeImagesResponseInfoType (p. 318)
• DescribeImagesResponseItemType (p. 318)
• DescribeImagesResponseType (p. 319)
• DescribeImagesType (p. 320)
• DescribeInstancesInfoType (p. 320)
• DescribeInstancesItemType (p. 321)
• DescribeInstancesResponseType (p. 321)
• DescribeInstancesType (p. 322)
• DescribeKeyPairsInfoType (p. 322)
• DescribeKeyPairsItemType (p. 323)
• DescribeKeyPairsResponseInfoType (p. 323)
• DescribeKeyPairsResponseItemType (p. 324)
• DescribeKeyPairsResponseType (p. 324)
• DescribeKeyPairsType (p. 325)
• DescribeRegionsResponseType (p. 325)
• DescribeRegionsSetItemType (p. 325)
• DescribeRegionsSetType (p. 326)
• DescribeRegionsType (p. 326)
• DescribeReservedInstancesOfferingsResponseSetItemType (p. 327)
• DescribeReservedInstancesOfferingsResponseSetType (p. 328)
• DescribeReservedInstancesOfferingsResponseType (p. 328)
• DescribeReservedInstancesOfferingsSetItemType (p. 329)
• DescribeReservedInstancesOfferingsSetType (p. 329)
• DescribeReservedInstancesOfferingsType (p. 330)
• DescribeReservedInstancesResponseSetItemType (p. 330)
• DescribeReservedInstancesResponseSetType (p. 331)
• DescribeReservedInstancesResponseType (p. 332)
• DescribeReservedInstancesSetItemType (p. 332)
• DescribeReservedInstancesSetType (p. 333)
• DescribeReservedInstancesType (p. 333)
• DescribeSecurityGroupsResponseType (p. 334)
• DescribeSecurityGroupsSetItemType (p. 334)
• DescribeSecurityGroupsSetType (p. 335)
• DescribeSecurityGroupsType (p. 335)
• DescribeSnapshotsResponseType (p. 336)
• DescribeSnapshotsSetItemResponseType (p. 336)
• DescribeSnapshotsSetItemType (p. 337)
• DescribeSnapshotsSetResponseType (p. 337)
• DescribeSnapshotsSetType (p. 338)
• DescribeSnapshotsType (p. 338)
• DescribeVolumesResponseType (p. 339)
• DescribeVolumesSetItemResponseType (p. 339)
Amazon Elastic Compute Cloud API Reference
API Version 2009-07-15281
• DescribeVolumesSetItemType (p. 340)
• DescribeVolumesSetResponseType (p. 340)
• DescribeVolumesSetType (p. 341)
• DescribeVolumesType (p. 341)
• DetachVolumeResponseType (p. 342)
• DetachVolumeType (p. 342)
• DisassociateAddressResponseType (p. 343)
• DisassociateAddressType (p. 344)
• EmptyElementType (p. 344)
• GetConsoleOutputResponseType (p. 345)
• GetConsoleOutputType (p. 345)
• GetPasswordDataResponseType (p. 346)
• GetPasswordDataType (p. 346)
• GroupItemType (p. 347)
• GroupSetType (p. 347)
• InstanceMonitoringStateType (p. 348)
• InstanceStateType (p. 348)
• IpPermissionSetType (p. 349)
• IpPermissionType (p. 350)
• IpRangeItemType (p. 351)
• IpRangeSetType (p. 351)
• LaunchPermissionItemType (p. 352)
• LaunchPermissionListType (p. 352)
• LaunchPermissionOperationType (p. 353)
• ModifyImageAttributeResponseType (p. 353)
• ModifyImageAttributeType (p. 354)
• MonitoringInstanceType (p. 354)
• MonitorInstancesResponseSetItemType (p. 355)
• MonitorInstancesResponseSetType (p. 355)
• MonitorInstancesResponseType (p. 356)
• MonitorInstancesSetItemType (p. 356)
• MonitorInstancesSetType (p. 357)
• MonitorInstancesType (p. 357)
• NullableAttributeValueType (p. 358)
• PlacementRequestType (p. 358)
• PlacementResponseType (p. 359)
• ProductCodeItemType (p. 359)
• ProductCodeListType (p. 360)
• ProductCodesSetItemType (p. 360)
• ProductCodesSetType (p. 361)
• PurchaseReservedInstancesOfferingResponseType (p. 361)
• PurchaseReservedInstancesOfferingType (p. 362)
• RebootInstancesInfoType (p. 362)
Amazon Elastic Compute Cloud API ReferenceAllocateAddressResponseType
API Version 2009-07-15282
• RebootInstancesItemType (p. 363)
• RebootInstancesResponseType (p. 363)
• RebootInstancesType (p. 364)
• RegionItemType (p. 364)
• RegionSetType (p. 365)
• RegisterImageResponseType (p. 365)
• RegisterImageType (p. 366)
• ReleaseAddressResponseType (p. 366)
• ReleaseAddressType (p. 367)
• ReservationInfoType (p. 367)
• ReservationSetType (p. 368)
• ResetImageAttributeResponseType (p. 368)
• ResetImageAttributesGroup (p. 369)
• ResetImageAttributeType (p. 369)
• RevokeSecurityGroupIngressResponseType (p. 370)
• RevokeSecurityGroupIngressType (p. 370)
• RunInstancesResponseType (p. 371)
• RunInstancesType (p. 371)
• RunningInstancesItemType (p. 373)
• RunningInstancesSetType (p. 375)
• SecurityGroupItemType (p. 375)
• SecurityGroupSetType (p. 376)
• TerminateInstancesInfoType (p. 376)
• TerminateInstancesItemType (p. 377)
• TerminateInstancesResponseInfoType (p. 377)
• TerminateInstancesResponseItemType (p. 378)
• TerminateInstancesResponseType (p. 378)
• TerminateInstancesType (p. 379)
• UserDataType (p. 379)
• UserIdGroupPairSetType (p. 380)
• UserIdGroupPairType (p. 380)
AllocateAddressResponseTypeThe AllocateAddressResponseType data type.
AncestorsNone
Relevant Operations• AllocateAddress
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15283
ContentsThe following table describes the elements contained in AllocateAddressResponseType.
Name Description
publicIp IP address for use with your account.
Type: xsd:string
requestId The ID of the request.
Type: xsd:string
AssociateAddressResponseTypeThe AssociateAddressResponseType data type.
AncestorsNone
Relevant Operations• AssociateAddress
ContentsThe following table describes the elements contained in AssociateAddressResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
return Returns "true" if instance and IP address successfully associated;otherwise "false".
Type: xsd:boolean
AssociateAddressTypeThe AssociateAddressType data type.
AncestorsNone
Relevant Operations• AssociateAddress
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15284
ContentsThe following table describes the elements contained in AssociateAddressType.
Name Description
instanceId The instance to associate with the IP address.
Type: xsd:string
publicIp IP address that you are assigning to the instance.
Type: xsd:string
AttachmentSetItemResponseTypeThe AttachmentSetItemResponseType data type.
Ancestors• AttachmentSetResponseType (p. 284)
Relevant Operations• DescribeVolumes
ContentsThe following table describes the elements contained in AttachmentSetItemResponseType.
Name Description
attachTime Time stamp when the association was created.
Type: dateTime
device Specifies how the device is exposed to the instance (e.g., /dev/sdh).
Type: xsd:string
instanceId The ID of the instance.
Type: xsd:string
status Attachment state.
Type: xsd:string
volumeId The ID of the volume.
Type: xsd:string
AttachmentSetResponseTypeThe AttachmentSetResponseType data type.
Amazon Elastic Compute Cloud API ReferenceAncestors
API Version 2009-07-15285
Ancestors• DescribeVolumesSetItemResponseType (p. 339)
Relevant Operations• DescribeVolumes
ContentsThe following table describes the elements contained in AttachmentSetResponseType.
Name Description
item Information for a attachment set.
Type: AttachmentSetItemResponseType (p. 284)
AttachVolumeResponseTypeThe AttachVolumeResponseType data type.
AncestorsNone
Relevant Operations• AttachVolume
ContentsThe following table describes the elements contained in AttachVolumeResponseType.
Name Description
attachTime Time stamp when the attachment was initiated.
Type: dateTime
device The device as it is exposed to the instance.
Type: xsd:string
instanceId The ID of the instance.
Type: xsd:string
requestId The ID of the request.
Type: xsd:string
status Attachment state (e.g., "attaching", "attached", "detaching","detached").
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceAttachVolumeType
API Version 2009-07-15286
Name Description
volumeId The ID of the volume.
Type: xsd:string
AttachVolumeTypeThe AttachVolumeType data type.
AncestorsNone
Relevant Operations• AttachVolume
ContentsThe following table describes the elements contained in AttachVolumeType.
Name Description
device Specifies how the device is exposed to the instance (e.g., /dev/sdh).
Type: xsd:string
instanceId The ID of the instance to which the volume attaches. The volumeand instance must be within the same Availability Zone and theinstance must be running.
Type: xsd:string
volumeId The ID of the Amazon EBS volume. The volume and instancemust be within the same Availability Zone and the instance mustbe running.
Type: xsd:string
AttributeValueTypeThe AttributeValueType data type.
AncestorsNone
Relevant Operations•
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15287
ContentsThe following table describes the elements contained in AttributeValueType.
Name Description
value ID of the item.
Type: xsd:string
AuthorizeSecurityGroupIngressResponseTypeThe AuthorizeSecurityGroupIngressResponseType data type.
AncestorsNone
Relevant Operations• AuthorizeSecurityGroupIngress
ContentsThe following table describes the elements contained inAuthorizeSecurityGroupIngressResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
return Returns "true" if request is successful; otherwise "false".
Type: xsd:boolean
AuthorizeSecurityGroupIngressTypeThe AuthorizeSecurityGroupIngressType data type.
AncestorsNone
Relevant Operations• AuthorizeSecurityGroupIngress
ContentsThe following table describes the elements contained in AuthorizeSecurityGroupIngressType.
Amazon Elastic Compute Cloud API ReferenceAvailabilityZoneItemType
API Version 2009-07-15288
Name Description
groupName Name of the group to modify. The name must be valid and belongto the account
Type: xsd:string
ipPermissions Set of permissions.
Type: IpPermissionSetType (p. 349)
userId AWS Access Key ID.
Type: xsd:string
AvailabilityZoneItemTypeThe AvailabilityZoneItemType data type.
Ancestors• AvailabilityZoneSetType (p. 289)
Relevant Operations• DescribeAvailabilityZones
ContentsThe following table describes the elements contained in AvailabilityZoneItemType.
Name Description
messageSet Message set.
Type: AvailabilityZoneMessageSetType (p. 288)
regionName Name of the region.
Type: xsd:string
zoneName Name of the Availability Zone.
Type: xsd:string
zoneState State of the Availability Zone.
Type: xsd:string
AvailabilityZoneMessageSetTypeThe AvailabilityZoneMessageSetType data type.
Ancestors• AvailabilityZoneItemType (p. 288)
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15289
Relevant Operations• DescribeAvailabilityZones
ContentsThe following table describes the elements contained in AvailabilityZoneMessageSetType.
Name Description
item Availability Zone message set.
Type: AvailabilityZoneMessageType (p. 289)
AvailabilityZoneMessageTypeThe AvailabilityZoneMessageType data type.
Ancestors• AvailabilityZoneMessageSetType (p. 288)
Relevant Operations• DescribeAvailabilityZones
ContentsThe following table describes the elements contained in AvailabilityZoneMessageType.
Name Description
message The Availability Zone message.
Type: xsd:string
AvailabilityZoneSetTypeThe AvailabilityZoneSetType data type.
Ancestors• DescribeAvailabilityZonesResponseType (p. 309)
Relevant Operations• DescribeAvailabilityZones
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15290
ContentsThe following table describes the elements contained in AvailabilityZoneSetType.
Name Description
item Information for one Availability Zone.
Type: AvailabilityZoneItemType (p. 288)
BlockDeviceMappingItemTypeThe BlockDeviceMappingItemType data type.
Ancestors• BlockDeviceMappingType (p. 290)
Relevant Operations• DescribeImageAttribute
• RunInstances
ContentsThe following table describes the elements contained in BlockDeviceMappingItemType.
Name Description
deviceName The device name (e.g., /dev/sdh).
Type: xsd:string
virtualName The virtual name.
Type: xsd:string
BlockDeviceMappingTypeThe BlockDeviceMappingType data type.
Ancestors• DescribeImageAttributeResponseType (p. 313)
• RunInstancesType (p. 371)
Relevant Operations• DescribeImageAttribute
• RunInstances
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15291
ContentsThe following table describes the elements contained in BlockDeviceMappingType.
Name Description
item Information for one block device mapping.
Type: BlockDeviceMappingItemType (p. 290)
BundleInstanceResponseTypeThe BundleInstanceResponseType data type.
AncestorsNone
Relevant Operations• BundleInstance
ContentsThe following table describes the elements contained in BundleInstanceResponseType.
Name Description
bundleInstanceTask Bundle task.
Type: BundleInstanceTaskType (p. 294)
requestId The ID of the request.
Type: xsd:string
BundleInstanceS3StorageTypeThe BundleInstanceS3StorageType data type.
Ancestors• BundleInstanceTaskStorageType (p. 293)
Relevant Operations• BundleInstance
• DescribeBundleTasks
• CancelBundleTask
• BundleInstance
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15292
ContentsThe following table describes the elements contained in BundleInstanceS3StorageType.
Name Description
awsAccessKeyId The Access Key ID of the owner of the Amazon S3 bucket.
Type: xsd:string
bucket The bucket in which to store the AMI. You can specify a bucketthat you already own or a new bucket that Amazon EC2 createson your behalf. If you specify a bucket that belongs to someoneelse, Amazon EC2 returns an error.
Type: xsd:string
prefix Specifies the beginning of the file name of the AMI.
Type: xsd:string
uploadPolicy An Amazon S3 upload policy that gives Amazon EC2 permissionto upload items into Amazon S3 on the user's behalf. For moreinformation on bundling in Windows, go to the Amazon ElasticCompute Cloud Developer Guide and Amazon Elastic ComputeCloud Getting Started Guide.
Type: xsd:string
uploadPolicySignature The signature of the Base64 encoded JSON document.
Type: xsd:string
BundleInstanceTaskErrorTypeThe BundleInstanceTaskErrorType data type.
Ancestors• BundleInstanceTaskType (p. 294)
Relevant Operations• BundleInstance
• DescribeBundleTasks
• CancelBundleTask
ContentsThe following table describes the elements contained in BundleInstanceTaskErrorType.
Name Description
code Error code.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceBundleInstanceTasksSetType
API Version 2009-07-15293
Name Description
message Error message.
Type: xsd:string
BundleInstanceTasksSetTypeThe BundleInstanceTasksSetType data type.
Ancestors• DescribeBundleTasksResponseType (p. 312)
Relevant Operations• DescribeBundleTasks
ContentsThe following table describes the elements contained in BundleInstanceTasksSetType.
Name Description
item Bundle task.
Type: BundleInstanceTaskType (p. 294)
BundleInstanceTaskStorageTypeThe BundleInstanceTaskStorageType data type.
Ancestors• BundleInstanceTaskType (p. 294)
• BundleInstanceType (p. 295)
Relevant Operations• BundleInstance
• DescribeBundleTasks
• CancelBundleTask
• BundleInstance
ContentsThe following table describes the elements contained in BundleInstanceTaskStorageType.
Amazon Elastic Compute Cloud API ReferenceBundleInstanceTaskType
API Version 2009-07-15294
Name Description
S3 Amazon S3 storage location.
Type: BundleInstanceS3StorageType (p. 291)
BundleInstanceTaskTypeThe BundleInstanceTaskType data type.
Ancestors• BundleInstanceResponseType (p. 291)
• BundleInstanceTasksSetType (p. 293)
• CancelBundleTaskResponseType (p. 295)
Relevant Operations• BundleInstance
• DescribeBundleTasks
• CancelBundleTask
ContentsThe following table describes the elements contained in BundleInstanceTaskType.
Name Description
bundleId Identifier for this task.
Type: xsd:string
error If the task fails, a description of the error.
Type: BundleInstanceTaskErrorType (p. 292)
instanceId Instance associated with this bundle task.
Type: xsd:string
progress A percentage description of the progress of the task, such as 20%.
Type: xsd:string
startTime The time this task started.
Type: dateTime
state The state of the task.
Type: xsd:string
storage Amazon S3 storage locations.
Type: BundleInstanceTaskStorageType (p. 293)
updateTime The time of the most recent update for the task.
Type: dateTime
Amazon Elastic Compute Cloud API ReferenceBundleInstanceType
API Version 2009-07-15295
BundleInstanceTypeThe BundleInstanceType data type.
AncestorsNone
Relevant Operations• BundleInstance
ContentsThe following table describes the elements contained in BundleInstanceType.
Name Description
instanceId The ID of the instance to bundle.
Type: xsd:string
storage Amazon S3 storage locations.
Type: BundleInstanceTaskStorageType (p. 293)
CancelBundleTaskResponseTypeThe CancelBundleTaskResponseType data type.
AncestorsNone
Relevant Operations• CancelBundleTask
ContentsThe following table describes the elements contained in CancelBundleTaskResponseType.
Name Description
bundleInstanceTask Bundle task to cancel.
Type: BundleInstanceTaskType (p. 294)
requestId The ID of the request.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceCancelBundleTaskType
API Version 2009-07-15296
CancelBundleTaskTypeThe CancelBundleTaskType data type.
AncestorsNone
Relevant Operations• CancelBundleTask
ContentsThe following table describes the elements contained in CancelBundleTaskType.
Name Description
bundleId The ID of the bundle task to cancel.
Type: xsd:string
ConfirmProductInstanceResponseTypeThe ConfirmProductInstanceResponseType data type.
AncestorsNone
Relevant Operations• ConfirmProductInstance
ContentsThe following table describes the elements contained in ConfirmProductInstanceResponseType.
Name Description
ownerId The instance owner's account ID. Only present if the product codeis attached to the instance.
Type: xsd:string
requestId The ID of the request.
Type: xsd:string
return Returns "true" if the product code is attached to the instance;otherwise "false".
Type: xsd:boolean
Amazon Elastic Compute Cloud API ReferenceConfirmProductInstanceType
API Version 2009-07-15297
ConfirmProductInstanceTypeThe ConfirmProductInstanceType data type.
AncestorsNone
Relevant Operations• ConfirmProductInstance
ContentsThe following table describes the elements contained in ConfirmProductInstanceType.
Name Description
instanceId The instance to confirm.
Type: xsd:string
productCode The product code to confirm.
Type: xsd:string
CreateKeyPairResponseTypeThe CreateKeyPairResponseType data type.
AncestorsNone
Relevant Operations• CreateKeyPair
ContentsThe following table describes the elements contained in CreateKeyPairResponseType.
Name Description
keyFingerprint A SHA-1 digest of the DER encoded private key.
Type: xsd:string
keyMaterial An unencrypted PEM encoded RSA private key.
Type: xsd:string
keyName The key pair name provided in the original request.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceCreateKeyPairType
API Version 2009-07-15298
Name Description
requestId The ID of the request.
Type: xsd:string
CreateKeyPairTypeThe CreateKeyPairType data type.
AncestorsNone
Relevant Operations• CreateKeyPair
ContentsThe following table describes the elements contained in CreateKeyPairType.
Name Description
keyName A unique name for the key pair.
Type: xsd:string
CreateSecurityGroupResponseTypeThe CreateSecurityGroupResponseType data type.
AncestorsNone
Relevant Operations• CreateSecurityGroup
ContentsThe following table describes the elements contained in CreateSecurityGroupResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceCreateSecurityGroupType
API Version 2009-07-15299
Name Description
return Returns "true" if creation succeeded; otherwise "false".
Type: xsd:boolean
CreateSecurityGroupTypeThe CreateSecurityGroupType data type.
AncestorsNone
Relevant Operations• CreateSecurityGroup
ContentsThe following table describes the elements contained in CreateSecurityGroupType.
Name Description
groupDescription Description of the group. This is informational only. If thedescription contains spaces, you must enclose it in single quotes(') or URL-encode it.
Type: xsd:string
groupName Name of the security group.
Type: xsd:string
CreateSnapshotResponseTypeThe CreateSnapshotResponseType data type.
AncestorsNone
Relevant Operations• CreateSnapshot
ContentsThe following table describes the elements contained in CreateSnapshotResponseType.
Amazon Elastic Compute Cloud API ReferenceCreateSnapshotType
API Version 2009-07-15300
Name Description
progress The progress of the snapshot, in percentage.
Type: xsd:string
requestId The ID of the request.
Type: xsd:string
snapshotId The ID of the snapshot.
Type: xsd:string
startTime Time stamp when the snapshot was initiated.
Type: dateTime
status Snapshot state (e.g., "pending", "completed", "error")
Type: xsd:string
volumeId The ID of the volume.
Type: xsd:string
CreateSnapshotTypeThe CreateSnapshotType data type.
AncestorsNone
Relevant Operations• CreateSnapshot
ContentsThe following table describes the elements contained in CreateSnapshotType.
Name Description
volumeId The ID of the Amazon EBS volume to take a snapshot of.
Type: xsd:string
CreateVolumeResponseTypeThe CreateVolumeResponseType data type.
AncestorsNone
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15301
Relevant Operations• CreateVolume
ContentsThe following table describes the elements contained in CreateVolumeResponseType.
Name Description
availabilityZone Availability Zone in which the volume was created.
Type: xsd:string
createTime Time stamp when volume creation was initiated.
Type: dateTime
requestId The ID of the request.
Type: xsd:string
size The size of the volume, in GiBs.
Type: xsd:string
snapshotId Snapshot from which the volume was created, if applicable.
Type: xsd:string
status Volume state (e.g., "creating", "available", "in-use", "deleting","error")
Type: xsd:string
volumeId The ID of the volume.
Type: xsd:string
CreateVolumeTypeThe CreateVolumeType data type.
AncestorsNone
Relevant Operations• CreateVolume
ContentsThe following table describes the elements contained in CreateVolumeType.
Name Description
availabilityZone The Availability Zone in which to create the new volume.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceDeleteKeyPairResponseType
API Version 2009-07-15302
Name Description
size The size of the volume, in GiBs. Required if you are not creating avolume from a snapshot.
Type: xsd:string
snapshotId The snapshot from which to create the new volume.
Type: xsd:string
DeleteKeyPairResponseTypeThe DeleteKeyPairResponseType data type.
AncestorsNone
Relevant Operations• DeleteKeyPair
ContentsThe following table describes the elements contained in DeleteKeyPairResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
return Returns "true" if deletion succeeded; otherwise "false".
Type: xsd:boolean
DeleteKeyPairTypeThe DeleteKeyPairType data type.
AncestorsNone
Relevant Operations• DeleteKeyPair
ContentsThe following table describes the elements contained in DeleteKeyPairType.
Amazon Elastic Compute Cloud API ReferenceDeleteSecurityGroupResponseType
API Version 2009-07-15303
Name Description
keyName Name of the key pair to delete.
Type: xsd:string
DeleteSecurityGroupResponseTypeThe DeleteSecurityGroupResponseType data type.
AncestorsNone
Relevant Operations• DeleteSecurityGroup
ContentsThe following table describes the elements contained in DeleteSecurityGroupResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
return Returns "true" if deletion succeeded; otherwise "false".
Type: xsd:boolean
DeleteSecurityGroupTypeThe DeleteSecurityGroupType data type.
AncestorsNone
Relevant Operations• DeleteSecurityGroup
ContentsThe following table describes the elements contained in DeleteSecurityGroupType.
Name Description
groupName Name of the security group to delete.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceDeleteSnapshotResponseType
API Version 2009-07-15304
DeleteSnapshotResponseTypeThe DeleteSnapshotResponseType data type.
AncestorsNone
Relevant Operations• DeleteSnapshot
ContentsThe following table describes the elements contained in DeleteSnapshotResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
return Returns "true" if deletion succeeded; otherwise "false".
Type: xsd:boolean
DeleteSnapshotTypeThe DeleteSnapshotType data type.
AncestorsNone
Relevant Operations• DeleteSnapshot
ContentsThe following table describes the elements contained in DeleteSnapshotType.
Name Description
snapshotId The ID of the Amazon EBS snapshot to delete.
Type: xsd:string
DeleteVolumeResponseTypeThe DeleteVolumeResponseType data type.
Amazon Elastic Compute Cloud API ReferenceAncestors
API Version 2009-07-15305
AncestorsNone
Relevant Operations• DeleteVolume
ContentsThe following table describes the elements contained in DeleteVolumeResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
return Returns "true" if deletion succeeded; otherwise "false".
Type: xsd:boolean
DeleteVolumeTypeThe DeleteVolumeType data type.
AncestorsNone
Relevant Operations• DeleteVolume
ContentsThe following table describes the elements contained in DeleteVolumeType.
Name Description
volumeId The ID of the volume to delete. The volume remains in the"deleting" state for several minutes after entering this command.
Type: xsd:string
DeregisterImageResponseTypeThe DeregisterImageResponseType data type.
AncestorsNone
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15306
Relevant Operations• DeregisterImage
ContentsThe following table describes the elements contained in DeregisterImageResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
return Returns "true" if deregistration succeeded; otherwise "false".
Type: xsd:boolean
DeregisterImageTypeThe DeregisterImageType data type.
AncestorsNone
Relevant Operations• DeregisterImage
ContentsThe following table describes the elements contained in DeregisterImageType.
Name Description
imageId Unique ID of the AMI which was assigned during registration. Toregister an AMI, use "RegisterImage". To view the AMI IDs ofAMIs that belong to your account. use "DescribeImages".
Type: xsd:string
DescribeAddressesInfoTypeThe DescribeAddressesInfoType data type.
Ancestors• DescribeAddressesType (p. 309)
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15307
Relevant Operations• DescribeAddresses
ContentsThe following table describes the elements contained in DescribeAddressesInfoType.
Name Description
item Information for one elastic IP address.
Type: DescribeAddressesItemType (p. 307)
DescribeAddressesItemTypeThe DescribeAddressesItemType data type.
Ancestors• DescribeAddressesInfoType (p. 306)
Relevant Operations• DescribeAddresses
ContentsThe following table describes the elements contained in DescribeAddressesItemType.
Name Description
publicIp Elastic IP address to describe.
Type: xsd:string
DescribeAddressesResponseInfoTypeThe DescribeAddressesResponseInfoType data type.
Ancestors• DescribeAddressesResponseType (p. 308)
Relevant Operations• DescribeAddresses
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15308
ContentsThe following table describes the elements contained in DescribeAddressesResponseInfoType.
Name Description
item Information about an instance.
Type: DescribeAddressesResponseItemType (p. 308)
DescribeAddressesResponseItemTypeThe DescribeAddressesResponseItemType data type.
Ancestors• DescribeAddressesResponseInfoType (p. 307)
Relevant Operations• DescribeAddresses
ContentsThe following table describes the elements contained in DescribeAddressesResponseItemType.
Name Description
instanceId The ID of the instance.
Type: xsd:string
publicIp The public IP address.
Type: xsd:string
DescribeAddressesResponseTypeThe DescribeAddressesResponseType data type.
AncestorsNone
Relevant Operations• DescribeAddresses
ContentsThe following table describes the elements contained in DescribeAddressesResponseType.
Amazon Elastic Compute Cloud API ReferenceDescribeAddressesType
API Version 2009-07-15309
Name Description
addressesSet The set of IP addresses.
Type: DescribeAddressesResponseInfoType (p. 307)
requestId The ID of the request.
Type: xsd:string
DescribeAddressesTypeThe DescribeAddressesType data type.
AncestorsNone
Relevant Operations• DescribeAddresses
ContentsThe following table describes the elements contained in DescribeAddressesType.
Name Description
publicIpsSet Set of elastic IP addresses.
Type: DescribeAddressesInfoType (p. 306)
DescribeAvailabilityZonesResponseTypeThe DescribeAvailabilityZonesResponseType data type.
AncestorsNone
Relevant Operations• DescribeAvailabilityZones
ContentsThe following table describes the elements contained in DescribeAvailabilityZonesResponseType.
Name Description
availabilityZoneInfo Availability Zone information.
Type: AvailabilityZoneSetType (p. 289)
Amazon Elastic Compute Cloud API ReferenceDescribeAvailabilityZonesSetItemType
API Version 2009-07-15310
Name Description
requestId The ID of the request.
Type: xsd:string
DescribeAvailabilityZonesSetItemTypeThe DescribeAvailabilityZonesSetItemType data type.
Ancestors• DescribeAvailabilityZonesSetType (p. 310)
Relevant Operations• DescribeAvailabilityZones
ContentsThe following table describes the elements contained in DescribeAvailabilityZonesSetItemType.
Name Description
zoneName Availability Zone name.
Type: xsd:string
DescribeAvailabilityZonesSetTypeThe DescribeAvailabilityZonesSetType data type.
Ancestors• DescribeAvailabilityZonesType (p. 311)
Relevant Operations• DescribeAvailabilityZones
ContentsThe following table describes the elements contained in DescribeAvailabilityZonesSetType.
Name Description
item Information for one Availability Zone.
Type: DescribeAvailabilityZonesSetItemType (p. 310)
Amazon Elastic Compute Cloud API ReferenceDescribeAvailabilityZonesType
API Version 2009-07-15311
DescribeAvailabilityZonesTypeThe DescribeAvailabilityZonesType data type.
AncestorsNone
Relevant Operations• DescribeAvailabilityZones
ContentsThe following table describes the elements contained in DescribeAvailabilityZonesType.
Name Description
availabilityZoneSet Set of Availability Zones.
Type: DescribeAvailabilityZonesSetType (p. 310)
DescribeBundleTasksInfoTypeThe DescribeBundleTasksInfoType data type.
Ancestors• DescribeBundleTasksType (p. 312)
Relevant Operations• DescribeBundleTasks
ContentsThe following table describes the elements contained in DescribeBundleTasksInfoType.
Name Description
item Information for one bundle task.
Type: DescribeBundleTasksItemType (p. 311)
DescribeBundleTasksItemTypeThe DescribeBundleTasksItemType data type.
Amazon Elastic Compute Cloud API ReferenceAncestors
API Version 2009-07-15312
Ancestors• DescribeBundleTasksInfoType (p. 311)
Relevant Operations• DescribeBundleTasks
ContentsThe following table describes the elements contained in DescribeBundleTasksItemType.
Name Description
bundleId The ID of the bundle task to describe.
Type: xsd:string
DescribeBundleTasksResponseTypeThe DescribeBundleTasksResponseType data type.
AncestorsNone
Relevant Operations• DescribeBundleTasks
ContentsThe following table describes the elements contained in DescribeBundleTasksResponseType.
Name Description
bundleInstanceTasksSet Bundle task set.
Type: BundleInstanceTasksSetType (p. 293)
requestId The ID of the request.
Type: xsd:string
DescribeBundleTasksTypeThe DescribeBundleTasksType data type.
AncestorsNone
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15313
Relevant Operations• DescribeBundleTasks
ContentsThe following table describes the elements contained in DescribeBundleTasksType.
Name Description
bundlesSet Set of bundle tasks.
Type: DescribeBundleTasksInfoType (p. 311)
DescribeImageAttributeResponseTypeThe DescribeImageAttributeResponseType data type.
AncestorsNone
Relevant Operations• DescribeImageAttribute
ContentsThe following table describes the elements contained in DescribeImageAttributeResponseType.
Name Description
blockDeviceMapping Block device mapping set.
Type: BlockDeviceMappingType (p. 290)
imageId The ID of the AMI.
Type: xsd:string
kernel Kernel set.
Type: NullableAttributeValueType (p. 358)
launchPermission Launch permissions set.
Type: LaunchPermissionListType (p. 352)
productCodes Product codes set.
Type: ProductCodeListType (p. 360)
ramdisk RAM disk set.
Type: NullableAttributeValueType (p. 358)
requestId The ID of the request.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceDescribeImageAttributesGroup
API Version 2009-07-15314
DescribeImageAttributesGroupThe DescribeImageAttributesGroup data type.
Ancestors• DescribeImageAttributeType (p. 314)
Relevant Operations• DescribeImageAttribute
ContentsThe following table describes the elements contained in DescribeImageAttributesGroup.
Name Description
blockDeviceMapping Describes the mapping that defines native device names to usewhen exposing virtual devices.
Type: EmptyElementType (p. 344)
kernel Describes the ID of the kernel associated with the AMI.
Type: EmptyElementType (p. 344)
launchPermission Describes the launch permissions associated with the AMI.
Type: EmptyElementType (p. 344)
productCodes Describes the product code associated with the AMI.
Type: EmptyElementType (p. 344)
ramdisk Describes the ID of the RAM disk associated with the AMI.
Type: EmptyElementType (p. 344)
DescribeImageAttributeTypeThe DescribeImageAttributeType data type.
AncestorsNone
Relevant Operations• DescribeImageAttribute
ContentsThe following table describes the elements contained in DescribeImageAttributeType.
Amazon Elastic Compute Cloud API ReferenceDescribeImagesExecutableBySetType
API Version 2009-07-15315
Name Description
DescribeImageAttributesGroupThe image attributes group.
Type: DescribeImageAttributesGroup (p. 314)
imageId The ID of the AMI for which an attribute will be described.
Type: xsd:string
DescribeImagesExecutableBySetTypeThe DescribeImagesExecutableBySetType data type.
Ancestors• DescribeImagesType (p. 320)
Relevant Operations• DescribeImages
ContentsThe following table describes the elements contained in DescribeImagesExecutableBySetType.
Name Description
item Information for one user.
Type: DescribeImagesExecutableByType (p. 315)
DescribeImagesExecutableByTypeThe DescribeImagesExecutableByType data type.
Ancestors• DescribeImagesExecutableBySetType (p. 315)
Relevant Operations• DescribeImages
ContentsThe following table describes the elements contained in DescribeImagesExecutableByType.
Amazon Elastic Compute Cloud API ReferenceDescribeImagesInfoType
API Version 2009-07-15316
Name Description
user Returns AMIs for which the specified user has explicit launchpermissions. The user ID can be a user's account ID, "self" toreturn AMIs for which the sender of the request has explicit launchpermissions, or "all" to return AMIs with public launch permissions.
Type: xsd:string
DescribeImagesInfoTypeThe DescribeImagesInfoType data type.
Ancestors• DescribeImagesType (p. 320)
Relevant Operations• DescribeImages
ContentsThe following table describes the elements contained in DescribeImagesInfoType.
Name Description
item Information for one image.
Type: DescribeImagesItemType (p. 316)
DescribeImagesItemTypeThe DescribeImagesItemType data type.
Ancestors• DescribeImagesInfoType (p. 316)
Relevant Operations• DescribeImages
ContentsThe following table describes the elements contained in DescribeImagesItemType.
Amazon Elastic Compute Cloud API ReferenceDescribeImagesOwnersType
API Version 2009-07-15317
Name Description
imageId AMI IDs to describe.
Type: xsd:string
DescribeImagesOwnersTypeThe DescribeImagesOwnersType data type.
Ancestors• DescribeImagesType (p. 320)
Relevant Operations• DescribeImages
ContentsThe following table describes the elements contained in DescribeImagesOwnersType.
Name Description
item Information for one owner.
Type: DescribeImagesOwnerType (p. 317)
DescribeImagesOwnerTypeThe DescribeImagesOwnerType data type.
Ancestors• DescribeImagesOwnersType (p. 317)
Relevant Operations• DescribeImages
ContentsThe following table describes the elements contained in DescribeImagesOwnerType.
Amazon Elastic Compute Cloud API ReferenceDescribeImagesResponseInfoType
API Version 2009-07-15318
Name Description
owner Returns AMIs owned by the specified owner. Multiple ownerscan be specified. The IDs "amazon", "self", and "explicit" can beused to include AMIs owned by Amazon, AMIs owned by theuser, and AMIs for which the user has explicit launch permissions,respectively.
Type: xsd:string
DescribeImagesResponseInfoTypeThe DescribeImagesResponseInfoType data type.
Ancestors• DescribeImagesResponseType (p. 319)
Relevant Operations• DescribeImages
ContentsThe following table describes the elements contained in DescribeImagesResponseInfoType.
Name Description
item Information for one image.
Type: DescribeImagesResponseItemType (p. 318)
DescribeImagesResponseItemTypeThe DescribeImagesResponseItemType data type.
Ancestors• DescribeImagesResponseInfoType (p. 318)
Relevant Operations• DescribeImages
ContentsThe following table describes the elements contained in DescribeImagesResponseItemType.
Amazon Elastic Compute Cloud API ReferenceDescribeImagesResponseType
API Version 2009-07-15319
Name Description
architecture The architecture of the image ("i386" or "x86_64").
Type: xsd:string
imageId The ID of the AMI.
Type: xsd:string
imageLocation The location of the AMI.
Type: xsd:string
imageOwnerId AWS Access Key ID of the image owner.
Type: xsd:string
imageState Current state of the AMI. If the operation returns "available", theimage is successfully registered and available for launching. If theoperation returns "deregistered", the image is deregistered and nolonger available for launching.
Type: xsd:string
imageType The type of image ("machine", "kernel", or "ramdisk").
Type: xsd:string
isPublic Returns "true" if this image has public launch permissions. Returns"false" if it only has implicit and explicit launch permissions.
Type: xsd:boolean
kernelId The kernel associated with the image, if any. Only applicable formachine images.
Type: xsd:string
platform The operating platform of the instance.
Type: xsd:string
productCodes Product codes of the AMI.
Type: ProductCodesSetType (p. 361)
ramdiskId The RAM disk associated with the image, if any. Only applicablefor machine images.
Type: xsd:string
DescribeImagesResponseTypeThe DescribeImagesResponseType data type.
AncestorsNone
Relevant Operations• DescribeImages
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15320
ContentsThe following table describes the elements contained in DescribeImagesResponseType.
Name Description
imagesSet Image set.
Type: DescribeImagesResponseInfoType (p. 318)
requestId The ID of the request.
Type: xsd:string
DescribeImagesTypeThe DescribeImagesType data type.
AncestorsNone
Relevant Operations• DescribeImages
ContentsThe following table describes the elements contained in DescribeImagesType.
Name Description
executableBySet Executable set.
Type: DescribeImagesExecutableBySetType (p. 315)
imagesSet Image set.
Type: DescribeImagesInfoType (p. 316)
ownersSet Information about an owner.
Type: DescribeImagesOwnersType (p. 317)
DescribeInstancesInfoTypeThe DescribeInstancesInfoType data type.
Ancestors• DescribeInstancesType (p. 322)
Relevant Operations• DescribeInstances
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15321
ContentsThe following table describes the elements contained in DescribeInstancesInfoType.
Name Description
item Information for one instance set.
Type: DescribeInstancesItemType (p. 321)
DescribeInstancesItemTypeThe DescribeInstancesItemType data type.
Ancestors• DescribeInstancesInfoType (p. 320)
Relevant Operations• DescribeInstances
ContentsThe following table describes the elements contained in DescribeInstancesItemType.
Name Description
instanceId Instance IDs to describe.
Type: xsd:string
DescribeInstancesResponseTypeThe DescribeInstancesResponseType data type.
AncestorsNone
Relevant Operations• DescribeInstances
ContentsThe following table describes the elements contained in DescribeInstancesResponseType.
Amazon Elastic Compute Cloud API ReferenceDescribeInstancesType
API Version 2009-07-15322
Name Description
requestId The ID of the request.
Type: xsd:string
reservationSet Reservation set.
Type: ReservationSetType (p. 368)
DescribeInstancesTypeThe DescribeInstancesType data type.
AncestorsNone
Relevant Operations• DescribeInstances
ContentsThe following table describes the elements contained in DescribeInstancesType.
Name Description
instancesSet Instances set.
Type: DescribeInstancesInfoType (p. 320)
DescribeKeyPairsInfoTypeThe DescribeKeyPairsInfoType data type.
Ancestors• DescribeKeyPairsType (p. 325)
Relevant Operations• DescribeKeyPairs
ContentsThe following table describes the elements contained in DescribeKeyPairsInfoType.
Amazon Elastic Compute Cloud API ReferenceDescribeKeyPairsItemType
API Version 2009-07-15323
Name Description
item Information for a key pair.
Type: DescribeKeyPairsItemType (p. 323)
DescribeKeyPairsItemTypeThe DescribeKeyPairsItemType data type.
Ancestors• DescribeKeyPairsInfoType (p. 322)
Relevant Operations• DescribeKeyPairs
ContentsThe following table describes the elements contained in DescribeKeyPairsItemType.
Name Description
keyName Key pair to describe.
Type: xsd:string
DescribeKeyPairsResponseInfoTypeThe DescribeKeyPairsResponseInfoType data type.
Ancestors• DescribeKeyPairsResponseType (p. 324)
Relevant Operations• DescribeKeyPairs
ContentsThe following table describes the elements contained in DescribeKeyPairsResponseInfoType.
Name Description
item Information for a key pair.
Type: DescribeKeyPairsResponseItemType (p. 324)
Amazon Elastic Compute Cloud API ReferenceDescribeKeyPairsResponseItemType
API Version 2009-07-15324
DescribeKeyPairsResponseItemTypeThe DescribeKeyPairsResponseItemType data type.
Ancestors• DescribeKeyPairsResponseInfoType (p. 323)
Relevant Operations• DescribeKeyPairs
ContentsThe following table describes the elements contained in DescribeKeyPairsResponseItemType.
Name Description
keyFingerprint A SHA-1 digest of the DER encoded private key.
Type: xsd:string
keyName The key pair name provided in the original request.
Type: xsd:string
DescribeKeyPairsResponseTypeThe DescribeKeyPairsResponseType data type.
AncestorsNone
Relevant Operations• DescribeKeyPairs
ContentsThe following table describes the elements contained in DescribeKeyPairsResponseType.
Name Description
keySet Information for a key pair.
Type: DescribeKeyPairsResponseInfoType (p. 323)
requestId The ID of the request.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceDescribeKeyPairsType
API Version 2009-07-15325
DescribeKeyPairsTypeThe DescribeKeyPairsType data type.
AncestorsNone
Relevant Operations• DescribeKeyPairs
ContentsThe following table describes the elements contained in DescribeKeyPairsType.
Name Description
keySet Set of key pairs.
Type: DescribeKeyPairsInfoType (p. 322)
DescribeRegionsResponseTypeThe DescribeRegionsResponseType data type.
AncestorsNone
Relevant Operations• DescribeRegions
ContentsThe following table describes the elements contained in DescribeRegionsResponseType.
Name Description
regionInfo Region set.
Type: RegionSetType (p. 365)
requestId The ID of the request.
Type: xsd:string
DescribeRegionsSetItemTypeThe DescribeRegionsSetItemType data type.
Amazon Elastic Compute Cloud API ReferenceAncestors
API Version 2009-07-15326
Ancestors• DescribeRegionsSetType (p. 326)
Relevant Operations• DescribeRegions
ContentsThe following table describes the elements contained in DescribeRegionsSetItemType.
Name Description
regionName Name of a region.
Type: xsd:string
DescribeRegionsSetTypeThe DescribeRegionsSetType data type.
Ancestors• DescribeRegionsType (p. 326)
Relevant Operations• DescribeRegions
ContentsThe following table describes the elements contained in DescribeRegionsSetType.
Name Description
item Information for a region.
Type: DescribeRegionsSetItemType (p. 325)
DescribeRegionsTypeThe DescribeRegionsType data type.
AncestorsNone
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15327
Relevant Operations• DescribeRegions
ContentsThe following table describes the elements contained in DescribeRegionsType.
Name Description
regionSet Set of regions.
Type: DescribeRegionsSetType (p. 326)
DescribeReservedInstancesOfferingsResponseSetItemTypeThe DescribeReservedInstancesOfferingsResponseSetItemType data type.
Ancestors• DescribeReservedInstancesOfferingsResponseSetType (p. 328)
Relevant Operations• DescribeReservedInstancesOfferings
ContentsThe following table describes the elements contained inDescribeReservedInstancesOfferingsResponseSetItemType.
Name Description
availabilityZone The Availability Zone in which the Reserved Instance can be used.
Type: xsd:string
duration The duration of the Reserved Instance, in seconds.
Type: xs:long
fixedPrice The purchase price of the Reserved Instance.
Type: xs:double
instanceType The instance type on which the Reserved Instance can be used.
Type: xsd:string
productDescription The Reserved Instance description.
Type: xsd:string
reservedInstancesOfferingIdThe ID of the Reserved Instance offering.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceDescribeReservedInstancesOfferingsResponseSetType
API Version 2009-07-15328
Name Description
usagePrice The usage price of the Reserved Instance, per hour.
Type: xs:double
DescribeReservedInstancesOfferingsResponseSetTypeThe DescribeReservedInstancesOfferingsResponseSetType data type.
Ancestors• DescribeReservedInstancesOfferingsResponseType (p. 328)
Relevant Operations• DescribeReservedInstancesOfferings
ContentsThe following table describes the elements contained inDescribeReservedInstancesOfferingsResponseSetType.
Name Description
item Reserved Instance offerings set.
Type:DescribeReservedInstancesOfferingsResponseSetItemType (p.327)
DescribeReservedInstancesOfferingsResponseTypeThe DescribeReservedInstancesOfferingsResponseType data type.
AncestorsNone
Relevant Operations• DescribeReservedInstancesOfferings
ContentsThe following table describes the elements contained inDescribeReservedInstancesOfferingsResponseType.
Amazon Elastic Compute Cloud API ReferenceDescribeReservedInstancesOfferingsSetItemType
API Version 2009-07-15329
Name Description
requestId The ID of the request.
Type: xsd:string
reservedInstancesOfferingsSetReserved Instances offerings set.
Type: DescribeReservedInstancesOfferingsResponseSetType (p.328)
DescribeReservedInstancesOfferingsSetItemTypeThe DescribeReservedInstancesOfferingsSetItemType data type.
Ancestors• DescribeReservedInstancesOfferingsSetType (p. 329)
Relevant Operations• DescribeReservedInstancesOfferings
ContentsThe following table describes the elements contained inDescribeReservedInstancesOfferingsSetItemType.
Name Description
reservedInstancesOfferingIdID of the Reserved Instances to describe.
Type: xsd:string
DescribeReservedInstancesOfferingsSetTypeThe DescribeReservedInstancesOfferingsSetType data type.
Ancestors• DescribeReservedInstancesOfferingsType (p. 330)
Relevant Operations• DescribeReservedInstancesOfferings
ContentsThe following table describes the elements contained in DescribeReservedInstancesOfferingsSetType.
Amazon Elastic Compute Cloud API ReferenceDescribeReservedInstancesOfferingsType
API Version 2009-07-15330
Name Description
item Reserved Instances item.
Type: DescribeReservedInstancesOfferingsSetItemType (p.329)
DescribeReservedInstancesOfferingsTypeThe DescribeReservedInstancesOfferingsType data type.
AncestorsNone
Relevant Operations• DescribeReservedInstancesOfferings
ContentsThe following table describes the elements contained in DescribeReservedInstancesOfferingsType.
Name Description
availabilityZone The Availability Zone in which the Reserved Instance can be used.
Type: xsd:string
instanceType The instance type on which the Reserved Instance can be used.
Type: xsd:string
productDescription The Reserved Instance description.
Type: xsd:string
reservedInstancesOfferingsSetSet of Reserved Instances.
Type: DescribeReservedInstancesOfferingsSetType (p. 329)
DescribeReservedInstancesResponseSetItemTypeThe DescribeReservedInstancesResponseSetItemType data type.
Ancestors• DescribeReservedInstancesResponseSetType (p. 331)
Relevant Operations• DescribeReservedInstances
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15331
ContentsThe following table describes the elements contained inDescribeReservedInstancesResponseSetItemType.
Name Description
availabilityZone The Availability Zone in which the Reserved Instance can be used.
Type: xsd:string
duration The duration of the Reserved Instance, in seconds.
Type: xs:long
fixedPrice The purchase price of the Reserved Instance.
Type: xs:double
instanceCount The number of Reserved Instances purchased.
Type: xs:integer
instanceType The instance type on which the Reserved Instance can be used.
Type: xsd:string
productDescription The Reserved Instance description.
Type: xsd:string
reservedInstancesId The ID of the Reserved Instance.
Type: xsd:string
start The date and time the Reserved Instance started.
Type: dateTime
state The state of the Reserved Instance purchase.
Type: xsd:string
usagePrice The usage price of the Reserved Instance, per hour.
Type: xs:double
DescribeReservedInstancesResponseSetTypeThe DescribeReservedInstancesResponseSetType data type.
Ancestors• DescribeReservedInstancesResponseType (p. 332)
Relevant Operations• DescribeReservedInstances
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15332
ContentsThe following table describes the elements contained inDescribeReservedInstancesResponseSetType.
Name Description
item Reserved Instance set.
Type: DescribeReservedInstancesResponseSetItemType (p.330)
DescribeReservedInstancesResponseTypeThe DescribeReservedInstancesResponseType data type.
AncestorsNone
Relevant Operations• DescribeReservedInstances
ContentsThe following table describes the elements contained in DescribeReservedInstancesResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
reservedInstancesSet Reserved Instances set.
Type: DescribeReservedInstancesResponseSetType (p. 331)
DescribeReservedInstancesSetItemTypeThe DescribeReservedInstancesSetItemType data type.
Ancestors• DescribeReservedInstancesSetType (p. 333)
Relevant Operations• DescribeReservedInstances
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15333
ContentsThe following table describes the elements contained in DescribeReservedInstancesSetItemType.
Name Description
reservedInstancesId IDs of the Reserved Instance to describe.
Type: xsd:string
DescribeReservedInstancesSetTypeThe DescribeReservedInstancesSetType data type.
Ancestors• DescribeReservedInstancesType (p. 333)
Relevant Operations• DescribeReservedInstances
ContentsThe following table describes the elements contained in DescribeReservedInstancesSetType.
Name Description
item Reserved Instances item.
Type: DescribeReservedInstancesSetItemType (p. 332)
DescribeReservedInstancesTypeThe DescribeReservedInstancesType data type.
AncestorsNone
Relevant Operations• DescribeReservedInstances
ContentsThe following table describes the elements contained in DescribeReservedInstancesType.
Amazon Elastic Compute Cloud API ReferenceDescribeSecurityGroupsResponseType
API Version 2009-07-15334
Name Description
reservedInstancesSet Set of Reserved Instances.
Type: DescribeReservedInstancesSetType (p. 333)
DescribeSecurityGroupsResponseTypeThe DescribeSecurityGroupsResponseType data type.
AncestorsNone
Relevant Operations• DescribeSecurityGroups
ContentsThe following table describes the elements contained in DescribeSecurityGroupsResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
securityGroupInfo Security group set.
Type: SecurityGroupSetType (p. 376)
DescribeSecurityGroupsSetItemTypeThe DescribeSecurityGroupsSetItemType data type.
Ancestors• DescribeSecurityGroupsSetType (p. 335)
Relevant Operations• DescribeSecurityGroups
ContentsThe following table describes the elements contained in DescribeSecurityGroupsSetItemType.
Amazon Elastic Compute Cloud API ReferenceDescribeSecurityGroupsSetType
API Version 2009-07-15335
Name Description
groupName Name of the security group.
Type: xsd:string
DescribeSecurityGroupsSetTypeThe DescribeSecurityGroupsSetType data type.
Ancestors• DescribeSecurityGroupsType (p. 335)
Relevant Operations• DescribeSecurityGroups
ContentsThe following table describes the elements contained in DescribeSecurityGroupsSetType.
Name Description
item Information for a security group.
Type: DescribeSecurityGroupsSetItemType (p. 334)
DescribeSecurityGroupsTypeThe DescribeSecurityGroupsType data type.
AncestorsNone
Relevant Operations• DescribeSecurityGroups
ContentsThe following table describes the elements contained in DescribeSecurityGroupsType.
Name Description
securityGroupSet Set of security groups.
Type: DescribeSecurityGroupsSetType (p. 335)
Amazon Elastic Compute Cloud API ReferenceDescribeSnapshotsResponseType
API Version 2009-07-15336
DescribeSnapshotsResponseTypeThe DescribeSnapshotsResponseType data type.
AncestorsNone
Relevant Operations• DescribeSnapshots
ContentsThe following table describes the elements contained in DescribeSnapshotsResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
snapshotSet Snapshot set.
Type: DescribeSnapshotsSetResponseType (p. 337)
DescribeSnapshotsSetItemResponseTypeThe DescribeSnapshotsSetItemResponseType data type.
Ancestors• DescribeSnapshotsSetResponseType (p. 337)
Relevant Operations• DescribeSnapshots
ContentsThe following table describes the elements contained in DescribeSnapshotsSetItemResponseType.
Name Description
progress The progress of the snapshot, in percentage.
Type: xsd:string
snapshotId The ID of the snapshot.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceDescribeSnapshotsSetItemType
API Version 2009-07-15337
Name Description
startTime Time stamp when the snapshot was initiated.
Type: dateTime
status Snapshot state (e.g., pending, completed, error).
Type: xsd:string
volumeId The ID of the volume.
Type: xsd:string
DescribeSnapshotsSetItemTypeThe DescribeSnapshotsSetItemType data type.
Ancestors• DescribeSnapshotsSetType (p. 338)
Relevant Operations• DescribeSnapshots
ContentsThe following table describes the elements contained in DescribeSnapshotsSetItemType.
Name Description
snapshotId The ID of the Amazon EBS snapshot.
Type: xsd:string
DescribeSnapshotsSetResponseTypeThe DescribeSnapshotsSetResponseType data type.
Ancestors• DescribeSnapshotsResponseType (p. 336)
Relevant Operations• DescribeSnapshots
ContentsThe following table describes the elements contained in DescribeSnapshotsSetResponseType.
Amazon Elastic Compute Cloud API ReferenceDescribeSnapshotsSetType
API Version 2009-07-15338
Name Description
item Information for a snapshot.
Type: DescribeSnapshotsSetItemResponseType (p. 336)
DescribeSnapshotsSetTypeThe DescribeSnapshotsSetType data type.
Ancestors• DescribeSnapshotsType (p. 338)
Relevant Operations• DescribeSnapshots
ContentsThe following table describes the elements contained in DescribeSnapshotsSetType.
Name Description
item Information for a snapshot.
Type: DescribeSnapshotsSetItemType (p. 337)
DescribeSnapshotsTypeThe DescribeSnapshotsType data type.
AncestorsNone
Relevant Operations• DescribeSnapshots
ContentsThe following table describes the elements contained in DescribeSnapshotsType.
Name Description
snapshotSet Set of snapshots.
Type: DescribeSnapshotsSetType (p. 338)
Amazon Elastic Compute Cloud API ReferenceDescribeVolumesResponseType
API Version 2009-07-15339
DescribeVolumesResponseTypeThe DescribeVolumesResponseType data type.
AncestorsNone
Relevant Operations• DescribeVolumes
ContentsThe following table describes the elements contained in DescribeVolumesResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
volumeSet Volume set.
Type: DescribeVolumesSetResponseType (p. 340)
DescribeVolumesSetItemResponseTypeThe DescribeVolumesSetItemResponseType data type.
Ancestors• DescribeVolumesSetResponseType (p. 340)
Relevant Operations• DescribeVolumes
ContentsThe following table describes the elements contained in DescribeVolumesSetItemResponseType.
Name Description
attachmentSet Attachment set.
Type: AttachmentSetResponseType (p. 284)
availabilityZone Availability Zone in which the volume was created.
Type: xsd:string
createTime Time stamp when volume creation was initiated.
Type: dateTime
Amazon Elastic Compute Cloud API ReferenceDescribeVolumesSetItemType
API Version 2009-07-15340
Name Description
size The size of the volume, in GiBs.
Type: xsd:string
snapshotId Snapshot from which the volume was created (optional).
Type: xsd:string
status Volume state (e.g., "creating", "available", "in-use", "deleting","error")
Type: xsd:string
volumeId The ID of the volume.
Type: xsd:string
DescribeVolumesSetItemTypeThe DescribeVolumesSetItemType data type.
Ancestors• DescribeVolumesSetType (p. 341)
Relevant Operations• DescribeVolumes
ContentsThe following table describes the elements contained in DescribeVolumesSetItemType.
Name Description
volumeId The ID of the volume to list.
Type: xsd:string
DescribeVolumesSetResponseTypeThe DescribeVolumesSetResponseType data type.
Ancestors• DescribeVolumesResponseType (p. 339)
Relevant Operations• DescribeVolumes
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15341
ContentsThe following table describes the elements contained in DescribeVolumesSetResponseType.
Name Description
item Information for a volume.
Type: DescribeVolumesSetItemResponseType (p. 339)
DescribeVolumesSetTypeThe DescribeVolumesSetType data type.
Ancestors• DescribeVolumesType (p. 341)
Relevant Operations• DescribeVolumes
ContentsThe following table describes the elements contained in DescribeVolumesSetType.
Name Description
item Information for a volume.
Type: DescribeVolumesSetItemType (p. 340)
DescribeVolumesTypeThe DescribeVolumesType data type.
AncestorsNone
Relevant Operations• DescribeVolumes
ContentsThe following table describes the elements contained in DescribeVolumesType.
Amazon Elastic Compute Cloud API ReferenceDetachVolumeResponseType
API Version 2009-07-15342
Name Description
volumeSet Set of volumes.
Type: DescribeVolumesSetType (p. 341)
DetachVolumeResponseTypeThe DetachVolumeResponseType data type.
AncestorsNone
Relevant Operations• DetachVolume
ContentsThe following table describes the elements contained in DetachVolumeResponseType.
Name Description
attachTime Time stamp when the association was created.
Type: dateTime
device The device as it is exposed to the instance.
Type: xsd:string
instanceId The ID of the instance.
Type: xsd:string
requestId The ID of the request.
Type: xsd:string
status Attachment state (e.g., "attaching", "attached", "detaching", or"detached").
Type: xsd:string
volumeId The ID of the volume.
Type: xsd:string
DetachVolumeTypeThe DetachVolumeType data type.
AncestorsNone
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15343
Relevant Operations• DetachVolume
ContentsThe following table describes the elements contained in DetachVolumeType.
Name Description
device The device name.
Type: xsd:string
force Forces detachment if the previous detachment attempt did notoccur cleanly (logging into an instance, unmounting the volume,and detaching normally). This option can lead to data loss ora corrupted file system. Use this option only as a last resort todetach a volume from a failed instance. The instance will not havean opportunity to flush file system caches nor file system metadata. If you use this option, you must perform file system checkand repair procedures.
Type: xsd:boolean
instanceId The ID of the instance.
Type: xsd:string
volumeId The ID of the volume.
Type: xsd:string
DisassociateAddressResponseTypeThe DisassociateAddressResponseType data type.
AncestorsNone
Relevant Operations• DisassociateAddress
ContentsThe following table describes the elements contained in DisassociateAddressResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceDisassociateAddressType
API Version 2009-07-15344
Name Description
return Returns "true" if the IP address is disassociated from the instance.Otherwise, "false".
Type: xsd:boolean
DisassociateAddressTypeThe DisassociateAddressType data type.
AncestorsNone
Relevant Operations• DisassociateAddress
ContentsThe following table describes the elements contained in DisassociateAddressType.
Name Description
publicIp IP address that you are disassociating from the instance.
Type: xsd:string
EmptyElementTypeThe EmptyElementType data type.
Ancestors• DescribeImageAttributesGroup (p. 314)
• DescribeImageAttributesGroup (p. 314)
• DescribeImageAttributesGroup (p. 314)
• DescribeImageAttributesGroup (p. 314)
• DescribeImageAttributesGroup (p. 314)
• ResetImageAttributesGroup (p. 369)
• ResetImageAttributesGroup (p. 369)
Relevant Operations• DescribeImageAttribute
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15345
• ResetImageAttribute
ContentsThe following table describes the elements contained in EmptyElementType.
Name Description
none These element contains no options.
Type: xsd:string
GetConsoleOutputResponseTypeThe GetConsoleOutputResponseType data type.
AncestorsNone
Relevant Operations• GetConsoleOutput
ContentsThe following table describes the elements contained in GetConsoleOutputResponseType.
Name Description
instanceId The instance ID.
Type: xsd:string
output The console output, Base64 encoded.
Type: xsd:string
requestId The ID of the request.
Type: xsd:string
timestamp The time the output was last updated.
Type: dateTime
GetConsoleOutputTypeThe GetConsoleOutputType data type.
AncestorsNone
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15346
Relevant Operations• GetConsoleOutput
ContentsThe following table describes the elements contained in GetConsoleOutputType.
Name Description
instanceId ID of the instance for which you want console output.
Type: xsd:string
GetPasswordDataResponseTypeThe GetPasswordDataResponseType data type.
AncestorsNone
Relevant Operations• GetPasswordData
ContentsThe following table describes the elements contained in GetPasswordDataResponseType.
Name Description
instanceId The ID of the instance.
Type: xsd:string
passwordData The password of the instance.
Type: xsd:string
requestId The ID of the request.
Type: xsd:string
timestamp The time the data was last updated.
Type: dateTime
GetPasswordDataTypeThe GetPasswordDataType data type.
AncestorsNone
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15347
Relevant Operations• GetPasswordData
ContentsThe following table describes the elements contained in GetPasswordDataType.
Name Description
instanceId The ID of the instance for which to get the password.
Type: xsd:string
GroupItemTypeThe GroupItemType data type.
Ancestors• GroupSetType (p. 347)
Relevant Operations• DescribeInstances
• RunInstances
• RunInstances
ContentsThe following table describes the elements contained in GroupItemType.
Name Description
groupId Name of the security group.
Type: xsd:string
GroupSetTypeThe GroupSetType data type.
Ancestors• ReservationInfoType (p. 367)
• RunInstancesResponseType (p. 371)
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15348
• RunInstancesType (p. 371)
Relevant Operations• DescribeInstances
• RunInstances
• RunInstances
ContentsThe following table describes the elements contained in GroupSetType.
Name Description
item Group set item.
Type: GroupItemType (p. 347)
InstanceMonitoringStateTypeThe InstanceMonitoringStateType data type.
Ancestors• MonitorInstancesResponseSetItemType (p. 355)
• RunningInstancesItemType (p. 373)
Relevant Operations• MonitorInstances
• UnmonitorInstances
• DescribeInstances
• RunInstances
ContentsThe following table describes the elements contained in InstanceMonitoringStateType.
Name Description
state State of monitoring for the instance.
Type: xsd:string
InstanceStateTypeThe InstanceStateType data type.
Amazon Elastic Compute Cloud API ReferenceAncestors
API Version 2009-07-15349
Ancestors• RunningInstancesItemType (p. 373)
• TerminateInstancesResponseItemType (p. 378)
• TerminateInstancesResponseItemType (p. 378)
Relevant Operations• DescribeInstances
• RunInstances
• TerminateInstances
ContentsThe following table describes the elements contained in InstanceStateType.
Name Description
code A 16-bit unsigned integer. The high byte is an opaque internalvalue and should be ignored. The low byte is set based on thestate represented:
• "0": pending
• "16": running
• "32": shutting-down
• "48": terminated
Type: integer
name The current state of the instance.
• "pending": the instance is in the process of being launched
• "running": the instance launched (although the boot processmight not be completed)
• "shutting-down": the instance started shutting down
• "terminated": the instance terminated
Type: xsd:string
IpPermissionSetTypeThe IpPermissionSetType data type.
Ancestors• AuthorizeSecurityGroupIngressType (p. 287)
• RevokeSecurityGroupIngressType (p. 370)
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15350
• SecurityGroupItemType (p. 375)
Relevant Operations• AuthorizeSecurityGroupIngress
• RevokeSecurityGroupIngress
• DescribeSecurityGroups
ContentsThe following table describes the elements contained in IpPermissionSetType.
Name Description
item Set of IP permissions.
Type: IpPermissionType (p. 350)
IpPermissionTypeThe IpPermissionType data type.
Ancestors• IpPermissionSetType (p. 349)
Relevant Operations• AuthorizeSecurityGroupIngress
• RevokeSecurityGroupIngress
• DescribeSecurityGroups
ContentsThe following table describes the elements contained in IpPermissionType.
Name Description
fromPort Start of port range for the TCP and UDP protocols, or an ICMPtype number. An ICMP type number of -1 indicates a wildcard (i.e.,any ICMP type number).
Type: integer
groups List of security group and user ID pairs.
Type: UserIdGroupPairSetType (p. 380)
ipProtocol IP protocol.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceIpRangeItemType
API Version 2009-07-15351
Name Description
ipRanges IP ranges.
Type: IpRangeSetType (p. 351)
toPort End of port range for the TCP and UDP protocols, or an ICMPcode. An ICMP code of -1 indicates a wildcard (i.e., any ICMPcode).
Type: integer
IpRangeItemTypeThe IpRangeItemType data type.
Ancestors• IpRangeSetType (p. 351)
Relevant Operations• AuthorizeSecurityGroupIngress
• RevokeSecurityGroupIngress
• DescribeSecurityGroups
ContentsThe following table describes the elements contained in IpRangeItemType.
Name Description
cidrIp CIDR range.
Type: xsd:string
IpRangeSetTypeThe IpRangeSetType data type.
Ancestors• IpPermissionType (p. 350)
Relevant Operations• AuthorizeSecurityGroupIngress
• RevokeSecurityGroupIngress
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15352
• DescribeSecurityGroups
ContentsThe following table describes the elements contained in IpRangeSetType.
Name Description
item Information for one IP range.
Type: IpRangeItemType (p. 351)
LaunchPermissionItemTypeThe LaunchPermissionItemType data type.
Ancestors• LaunchPermissionListType (p. 352)
Relevant Operations• DescribeImageAttribute
• ModifyImageAttribute
ContentsThe following table describes the elements contained in LaunchPermissionItemType.
Name Description
group Security groups associated with the launchPermission attribute.You can specify the "all" group, which will make it a public AMI.
Type: xsd:string
userId User IDs associated with the launchPermission attribute.
Type: xsd:string
LaunchPermissionListTypeThe LaunchPermissionListType data type.
Ancestors• DescribeImageAttributeResponseType (p. 313)
• LaunchPermissionOperationType (p. 353)
• LaunchPermissionOperationType (p. 353)
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15353
• LaunchPermissionOperationType (p. 353)
Relevant Operations• DescribeImageAttribute
• ModifyImageAttribute
ContentsThe following table describes the elements contained in LaunchPermissionListType.
Name Description
item Information for launch permissions.
Type: LaunchPermissionItemType (p. 352)
LaunchPermissionOperationTypeThe LaunchPermissionOperationType data type.
Ancestors• ModifyImageAttributeType (p. 354)
Relevant Operations• ModifyImageAttribute
ContentsThe following table describes the elements contained in LaunchPermissionOperationType.
Name Description
add Items to add.
Type: LaunchPermissionListType (p. 352)
remove Items to remove.
Type: LaunchPermissionListType (p. 352)
ModifyImageAttributeResponseTypeThe ModifyImageAttributeResponseType data type.
AncestorsNone
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15354
Relevant Operations• ModifyImageAttribute
ContentsThe following table describes the elements contained in ModifyImageAttributeResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
return Returns "true" if successful; otherwise "false".
Type: xsd:boolean
ModifyImageAttributeTypeThe ModifyImageAttributeType data type.
AncestorsNone
Relevant Operations• ModifyImageAttribute
ContentsThe following table describes the elements contained in ModifyImageAttributeType.
Name Description
imageId The AMI ID.
Type: xsd:string
launchPermission Launch permission set.
Type: LaunchPermissionOperationType (p. 353)
productCodes Product code set.
Type: ProductCodeListType (p. 360)
MonitoringInstanceTypeThe MonitoringInstanceType data type.
Ancestors• RunInstancesType (p. 371)
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15355
Relevant Operations• RunInstances
ContentsThe following table describes the elements contained in MonitoringInstanceType.
Name Description
enabled Enables monitoring for the instance.
Type: xsd:boolean
MonitorInstancesResponseSetItemTypeThe MonitorInstancesResponseSetItemType data type.
Ancestors• MonitorInstancesResponseSetType (p. 355)
Relevant Operations• MonitorInstances
• UnmonitorInstances
ContentsThe following table describes the elements contained in MonitorInstancesResponseSetItemType.
Name Description
instanceId Instance ID.
Type: xsd:string
monitoring Monitoring information.
Type: InstanceMonitoringStateType (p. 348)
MonitorInstancesResponseSetTypeThe MonitorInstancesResponseSetType data type.
Ancestors• MonitorInstancesResponseType (p. 356)
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15356
Relevant Operations• MonitorInstances
• UnmonitorInstances
ContentsThe following table describes the elements contained in MonitorInstancesResponseSetType.
Name Description
item Instance Item.
Type: MonitorInstancesResponseSetItemType (p. 355)
MonitorInstancesResponseTypeThe MonitorInstancesResponseType data type.
AncestorsNone
Relevant Operations• MonitorInstances
• UnmonitorInstances
ContentsThe following table describes the elements contained in MonitorInstancesResponseType.
Name Description
instancesSet Monitor instance response set.
Type: MonitorInstancesResponseSetType (p. 355)
requestId The ID of the request.
Type: xsd:string
MonitorInstancesSetItemTypeThe MonitorInstancesSetItemType data type.
Ancestors• MonitorInstancesSetType (p. 357)
Amazon Elastic Compute Cloud API ReferenceRelevant Operations
API Version 2009-07-15357
Relevant Operations• MonitorInstances
• UnmonitorInstances
ContentsThe following table describes the elements contained in MonitorInstancesSetItemType.
Name Description
instanceId Instance ID.
Type: xsd:string
MonitorInstancesSetTypeThe MonitorInstancesSetType data type.
Ancestors• MonitorInstancesType (p. 357)
Relevant Operations• MonitorInstances
• UnmonitorInstances
ContentsThe following table describes the elements contained in MonitorInstancesSetType.
Name Description
item Instance set.
Type: MonitorInstancesSetItemType (p. 356)
MonitorInstancesTypeThe MonitorInstancesType data type.
AncestorsNone
Relevant Operations• MonitorInstances
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15358
• UnmonitorInstances
ContentsThe following table describes the elements contained in MonitorInstancesType.
Name Description
instancesSet Set of instances.
Type: MonitorInstancesSetType (p. 357)
NullableAttributeValueTypeThe NullableAttributeValueType data type.
Ancestors• DescribeImageAttributeResponseType (p. 313)
• DescribeImageAttributeResponseType (p. 313)
Relevant Operations• DescribeImageAttribute
ContentsThe following table describes the elements contained in NullableAttributeValueType.
Name Description
value ID of the kernel or RAM disk.
Type: xsd:string
PlacementRequestTypeThe PlacementRequestType data type.
Ancestors• RunInstancesType (p. 371)
Relevant Operations• RunInstances
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15359
ContentsThe following table describes the elements contained in PlacementRequestType.
Name Description
availabilityZone Specifies the placement constraints (Availability Zones) forlaunching the instances.
Type: xsd:string
PlacementResponseTypeThe PlacementResponseType data type.
Ancestors• RunningInstancesItemType (p. 373)
Relevant Operations• DescribeInstances
• RunInstances
ContentsThe following table describes the elements contained in PlacementResponseType.
Name Description
availabilityZone Returns the Availability Zones of the instances.
Type: xsd:string
ProductCodeItemTypeThe ProductCodeItemType data type.
Ancestors• ProductCodeListType (p. 360)
Relevant Operations• DescribeImageAttribute
• ModifyImageAttribute
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15360
ContentsThe following table describes the elements contained in ProductCodeItemType.
Name Description
productCode Amazon DevPay product code. Currently only one product codecan be associated with an AMI. Once set, the product code cannotbe changed or reset.
Type: xsd:string
ProductCodeListTypeThe ProductCodeListType data type.
Ancestors• DescribeImageAttributeResponseType (p. 313)
• ModifyImageAttributeType (p. 354)
Relevant Operations• DescribeImageAttribute
• ModifyImageAttribute
ContentsThe following table describes the elements contained in ProductCodeListType.
Name Description
item Information for one product code.
Type: ProductCodeItemType (p. 359)
ProductCodesSetItemTypeThe ProductCodesSetItemType data type.
Ancestors• ProductCodesSetType (p. 361)
Relevant Operations• DescribeImages
• DescribeInstances
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15361
• RunInstances
ContentsThe following table describes the elements contained in ProductCodesSetItemType.
Name Description
productCode Product code.
Type: xsd:string
ProductCodesSetTypeThe ProductCodesSetType data type.
Ancestors• DescribeImagesResponseItemType (p. 318)
• RunningInstancesItemType (p. 373)
Relevant Operations• DescribeImages
• DescribeInstances
• RunInstances
ContentsThe following table describes the elements contained in ProductCodesSetType.
Name Description
item Information for one product code.
Type: ProductCodesSetItemType (p. 360)
PurchaseReservedInstancesOfferingResponseTypeThe PurchaseReservedInstancesOfferingResponseType data type.
AncestorsNone
Relevant Operations• PurchaseReservedInstancesOffering
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15362
ContentsThe following table describes the elements contained inPurchaseReservedInstancesOfferingResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
reservedInstancesId The IDs of the purchased Reserved Instances.
Type: xsd:string
PurchaseReservedInstancesOfferingTypeThe PurchaseReservedInstancesOfferingType data type.
AncestorsNone
Relevant Operations• PurchaseReservedInstancesOffering
ContentsThe following table describes the elements contained in PurchaseReservedInstancesOfferingType.
Name Description
instanceCount The number of Reserved Instances to purchase.
Type: integer
reservedInstancesOfferingIdThe offering ID of the Reserved Instance to purchase.
Type: xsd:string
RebootInstancesInfoTypeThe RebootInstancesInfoType data type.
Ancestors• RebootInstancesType (p. 364)
Relevant Operations• RebootInstances
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15363
ContentsThe following table describes the elements contained in RebootInstancesInfoType.
Name Description
item Information for an instance.
Type: RebootInstancesItemType (p. 363)
RebootInstancesItemTypeThe RebootInstancesItemType data type.
Ancestors• RebootInstancesInfoType (p. 362)
Relevant Operations• RebootInstances
ContentsThe following table describes the elements contained in RebootInstancesItemType.
Name Description
instanceId One or more instance IDs.
Type: xsd:string
RebootInstancesResponseTypeThe RebootInstancesResponseType data type.
AncestorsNone
Relevant Operations• RebootInstances
ContentsThe following table describes the elements contained in RebootInstancesResponseType.
Amazon Elastic Compute Cloud API ReferenceRebootInstancesType
API Version 2009-07-15364
Name Description
requestId The ID of the request.
Type: xsd:string
return Returns "true" if successful; otherwise "false".
Type: xsd:boolean
RebootInstancesTypeThe RebootInstancesType data type.
AncestorsNone
Relevant Operations• RebootInstances
ContentsThe following table describes the elements contained in RebootInstancesType.
Name Description
instancesSet Launch permission set.
Type: RebootInstancesInfoType (p. 362)
RegionItemTypeThe RegionItemType data type.
Ancestors• RegionSetType (p. 365)
Relevant Operations• DescribeRegions
ContentsThe following table describes the elements contained in RegionItemType.
Amazon Elastic Compute Cloud API ReferenceRegionSetType
API Version 2009-07-15365
Name Description
regionEndpoint Region service endpoint.
Type: xsd:string
regionName Name of the region.
Type: xsd:string
RegionSetTypeThe RegionSetType data type.
Ancestors• DescribeRegionsResponseType (p. 325)
Relevant Operations• DescribeRegions
ContentsThe following table describes the elements contained in RegionSetType.
Name Description
item Information for a region.
Type: RegionItemType (p. 364)
RegisterImageResponseTypeThe RegisterImageResponseType data type.
AncestorsNone
Relevant Operations• RegisterImage
ContentsThe following table describes the elements contained in RegisterImageResponseType.
Amazon Elastic Compute Cloud API ReferenceRegisterImageType
API Version 2009-07-15366
Name Description
imageId Unique ID of the newly registered machine image.
Type: xsd:string
requestId The ID of the request.
Type: xsd:string
RegisterImageTypeThe RegisterImageType data type.
AncestorsNone
Relevant Operations• RegisterImage
ContentsThe following table describes the elements contained in RegisterImageType.
Name Description
imageLocation Full path to your AMI manifest in Amazon S3 storage.
Type: xsd:string
ReleaseAddressResponseTypeThe ReleaseAddressResponseType data type.
AncestorsNone
Relevant Operations• ReleaseAddress
ContentsThe following table describes the elements contained in ReleaseAddressResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceReleaseAddressType
API Version 2009-07-15367
Name Description
return Returns "true" if successful; otherwise "false".
Type: xsd:boolean
ReleaseAddressTypeThe ReleaseAddressType data type.
AncestorsNone
Relevant Operations• ReleaseAddress
ContentsThe following table describes the elements contained in ReleaseAddressType.
Name Description
publicIp The IP address that you are releasing from your account.
Type: xsd:string
ReservationInfoTypeThe ReservationInfoType data type.
Ancestors• ReservationSetType (p. 368)
Relevant Operations• DescribeInstances
ContentsThe following table describes the elements contained in ReservationInfoType.
Name Description
groupSet Group set.
Type: GroupSetType (p. 347)
Amazon Elastic Compute Cloud API ReferenceReservationSetType
API Version 2009-07-15368
Name Description
instancesSet Instance set.
Type: RunningInstancesSetType (p. 375)
ownerId AWS Access Key ID of the user who owns the reservation.
Type: xsd:string
requesterId ID of the requester.
Type: xsd:string
reservationId Unique ID of the reservation.
Type: xsd:string
ReservationSetTypeThe ReservationSetType data type.
Ancestors• DescribeInstancesResponseType (p. 321)
Relevant Operations• DescribeInstances
ContentsThe following table describes the elements contained in ReservationSetType.
Name Description
item Information for a reservation.
Type: ReservationInfoType (p. 367)
ResetImageAttributeResponseTypeThe ResetImageAttributeResponseType data type.
AncestorsNone
Relevant Operations• ResetImageAttribute
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15369
ContentsThe following table describes the elements contained in ResetImageAttributeResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
return Indicates whether the attribute successfully reset.
Type: xsd:boolean
ResetImageAttributesGroupThe ResetImageAttributesGroup data type.
Ancestors• ResetImageAttributeType (p. 369)
Relevant Operations• ResetImageAttribute
ContentsThe following table describes the elements contained in ResetImageAttributesGroup.
Name Description
launchPermission Resets the launch permission attribute.
Type: EmptyElementType (p. 344)
ResetImageAttributeTypeThe ResetImageAttributeType data type.
AncestorsNone
Relevant Operations• ResetImageAttribute
ContentsThe following table describes the elements contained in ResetImageAttributeType.
Amazon Elastic Compute Cloud API ReferenceRevokeSecurityGroupIngressResponseType
API Version 2009-07-15370
Name Description
imageId ID of the AMI on which the attribute will be reset.
Type: xsd:string
ResetImageAttributesGroup The reset image attribute group.
Type: ResetImageAttributesGroup (p. 369)
RevokeSecurityGroupIngressResponseTypeThe RevokeSecurityGroupIngressResponseType data type.
AncestorsNone
Relevant Operations• RevokeSecurityGroupIngress
ContentsThe following table describes the elements contained in RevokeSecurityGroupIngressResponseType.
Name Description
requestId The ID of the request.
Type: xsd:string
return Returns "true" if the request is successful; otherwise "false".
Type: xsd:boolean
RevokeSecurityGroupIngressTypeThe RevokeSecurityGroupIngressType data type.
AncestorsNone
Relevant Operations• RevokeSecurityGroupIngress
ContentsThe following table describes the elements contained in RevokeSecurityGroupIngressType.
Amazon Elastic Compute Cloud API ReferenceRunInstancesResponseType
API Version 2009-07-15371
Name Description
groupName Name of the group to modify.
Type: xsd:string
ipPermissions Set of permissions to add to the group.
Type: IpPermissionSetType (p. 349)
userId AWS Access Key ID.
Type: xsd:string
RunInstancesResponseTypeThe RunInstancesResponseType data type.
AncestorsNone
Relevant Operations• RunInstances
ContentsThe following table describes the elements contained in RunInstancesResponseType.
Name Description
groupSet Group set.
Type: GroupSetType (p. 347)
instancesSet Instance set.
Type: RunningInstancesSetType (p. 375)
ownerId AWS Access Key ID of the user who owns the reservation.
Type: xsd:string
requesterId ID of the requester.
Type: xsd:string
requestId The ID of the request.
Type: xsd:string
reservationId Unique ID of the reservation.
Type: xsd:string
RunInstancesTypeThe RunInstancesType data type.
Amazon Elastic Compute Cloud API ReferenceAncestors
API Version 2009-07-15372
AncestorsNone
Relevant Operations• RunInstances
ContentsThe following table describes the elements contained in RunInstancesType.
Name Description
additionalInfo Specifies additional information to make available to theinstance(s).
Type: xsd:string
addressingType Deprecated.
Type: xsd:string
blockDeviceMapping Specifies how block devices are exposed to the instance. Eachmapping is made up of a virtualName and a deviceName.
Type: BlockDeviceMappingType (p. 290)
groupSet Group set.
Type: GroupSetType (p. 347)
imageId Unique ID of a machine image, returned by a call toRegisterImage.
Type: xsd:string
instanceType Specifies the instance type.
Type: xsd:string
kernelId The ID of the kernel with which to launch the instance.
Type: xsd:string
keyName The name of the key pair.
Type: xsd:string
maxCount Maximum number of instances to launch. If the value is morethan Amazon EC2 can launch, the largest possible number aboveminCount will be launched instead.
Type: integer
minCount Minimum number of instances to launch. If the value is more thanAmazon EC2 can launch, no instances are launched at all.
Type: integer
monitoring Specifies whether to enable monitoring for the instance.
Type: MonitoringInstanceType (p. 354)
placement Placement item.
Type: PlacementRequestType (p. 358)
Amazon Elastic Compute Cloud API ReferenceRunningInstancesItemType
API Version 2009-07-15373
Name Description
ramdiskId The ID of the RAM disk with which to launch the instance. Somekernels require additional drivers at launch. Check the kernelrequirements for information on whether you need to specify aRAM disk. To find kernel requirements, go to the Resource Centerand search for the kernel ID.
Type: xsd:string
subnetId Specifies the subnet ID within which to launch the instance(s) forAmazon Virtual Private Cloud.
Type: xsd:string
userData User data.
Type: UserDataType (p. 379)
RunningInstancesItemTypeThe RunningInstancesItemType data type.
Ancestors• RunningInstancesSetType (p. 375)
Relevant Operations• DescribeInstances
• RunInstances
ContentsThe following table describes the elements contained in RunningInstancesItemType.
Name Description
amiLaunchIndex The AMI launch index, which can be used to find this instancewithin the launch group. For more information, go to the Metadatasection of the Amazon Elastic Compute Cloud Developer Guide.
Type: xsd:string
dnsName The public DNS name assigned to the instance. This DNS name iscontactable from outside the Amazon EC2 network. This elementremains empty until the instance enters a running state.
Type: xsd:string
imageId Image ID of the AMI used to launch the instance.
Type: xsd:string
instanceId Unique ID of the instance launched.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15374
Name Description
instanceState The current state of the instance.
Type: InstanceStateType (p. 348)
instanceType The instance type. For more information on instance types, go tothe Amazon Elastic Compute Cloud Developer Guide.
Type: xsd:string
ipAddress Specifies the IP address of the instance.
Type: xsd:string
kernelId Optional. Kernel associated with this instance.
Type: xsd:string
keyName If this instance was launched with an associated key pair, thisdisplays the key pair name.
Type: xsd:string
launchTime The time the instance launched.
Type: dateTime
monitoring Specifies whether monitoring is enabled for the instance.
Type: InstanceMonitoringStateType (p. 348)
placement The location where the instance launched.
Type: PlacementResponseType (p. 359)
platform Platform of the instance (e.g., Windows).
Type: xsd:string
privateDnsName The private DNS name assigned to the instance. This DNS namecan only be used inside the Amazon EC2 network. This elementremains empty until the instance enters a running state.
Type: xsd:string
privateIpAddress Specifies the private IP address that is assigned to the instance(Amazon VPC).
Type: xsd:string
productCodes Product codes attached to this instance.
Type: ProductCodesSetType (p. 361)
ramdiskId Optional. RAM disk associated with this instance.
Type: xsd:string
reason Reason for the most recent state transition. This might be anempty string.
Type: xsd:string
subnetId Specifies the subnet ID in which the instance is running (AmazonVirtual Private Cloud).
Type: xsd:string
vpcId Specifies the VPC in which the instance is running (Amazon VPC).
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceRunningInstancesSetType
API Version 2009-07-15375
RunningInstancesSetTypeThe RunningInstancesSetType data type.
Ancestors• ReservationInfoType (p. 367)
• RunInstancesResponseType (p. 371)
Relevant Operations• DescribeInstances
• RunInstances
ContentsThe following table describes the elements contained in RunningInstancesSetType.
Name Description
item Running instance set item.
Type: RunningInstancesItemType (p. 373)
SecurityGroupItemTypeThe SecurityGroupItemType data type.
Ancestors• SecurityGroupSetType (p. 376)
Relevant Operations• DescribeSecurityGroups
ContentsThe following table describes the elements contained in SecurityGroupItemType.
Name Description
groupDescription Description of the security group.
Type: xsd:string
groupName Name of the security group.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceSecurityGroupSetType
API Version 2009-07-15376
Name Description
ipPermissions Set of IP permissions associated with the security group.
Type: IpPermissionSetType (p. 349)
ownerId AWS Access Key ID of the owner of the security group.
Type: xsd:string
SecurityGroupSetTypeThe SecurityGroupSetType data type.
Ancestors• DescribeSecurityGroupsResponseType (p. 334)
Relevant Operations• DescribeSecurityGroups
ContentsThe following table describes the elements contained in SecurityGroupSetType.
Name Description
item Information for a security group.
Type: SecurityGroupItemType (p. 375)
TerminateInstancesInfoTypeThe TerminateInstancesInfoType data type.
Ancestors• TerminateInstancesType (p. 379)
Relevant Operations• TerminateInstances
ContentsThe following table describes the elements contained in TerminateInstancesInfoType.
Amazon Elastic Compute Cloud API ReferenceTerminateInstancesItemType
API Version 2009-07-15377
Name Description
item Information for a instance.
Type: TerminateInstancesItemType (p. 377)
TerminateInstancesItemTypeThe TerminateInstancesItemType data type.
Ancestors• TerminateInstancesInfoType (p. 376)
Relevant Operations• TerminateInstances
ContentsThe following table describes the elements contained in TerminateInstancesItemType.
Name Description
instanceId Instance ID to terminate.
Type: xsd:string
TerminateInstancesResponseInfoTypeThe TerminateInstancesResponseInfoType data type.
Ancestors• TerminateInstancesResponseType (p. 378)
Relevant Operations• TerminateInstances
ContentsThe following table describes the elements contained in TerminateInstancesResponseInfoType.
Name Description
item Response item.
Type: TerminateInstancesResponseItemType (p. 378)
Amazon Elastic Compute Cloud API ReferenceTerminateInstancesResponseItemType
API Version 2009-07-15378
TerminateInstancesResponseItemTypeThe TerminateInstancesResponseItemType data type.
Ancestors• TerminateInstancesResponseInfoType (p. 377)
Relevant Operations• TerminateInstances
ContentsThe following table describes the elements contained in TerminateInstancesResponseItemType.
Name Description
instanceId Instance ID.
Type: xsd:string
previousState Previous state.
Type: InstanceStateType (p. 348)
shutdownState Shutdown state.
Type: InstanceStateType (p. 348)
TerminateInstancesResponseTypeThe TerminateInstancesResponseType data type.
AncestorsNone
Relevant Operations• TerminateInstances
ContentsThe following table describes the elements contained in TerminateInstancesResponseType.
Name Description
instancesSet Instances set.
Type: TerminateInstancesResponseInfoType (p. 377)
Amazon Elastic Compute Cloud API ReferenceTerminateInstancesType
API Version 2009-07-15379
Name Description
requestId The ID of the request.
Type: xsd:string
TerminateInstancesTypeThe TerminateInstancesType data type.
AncestorsNone
Relevant Operations• TerminateInstances
ContentsThe following table describes the elements contained in TerminateInstancesType.
Name Description
instancesSet Set of instances.
Type: TerminateInstancesInfoType (p. 376)
UserDataTypeThe UserDataType data type.
Ancestors• RunInstancesType (p. 371)
Relevant Operations• RunInstances
ContentsThe following table describes the elements contained in UserDataType.
Name Description
data The user data.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceUserIdGroupPairSetType
API Version 2009-07-15380
UserIdGroupPairSetTypeThe UserIdGroupPairSetType data type.
Ancestors• IpPermissionType (p. 350)
Relevant Operations• AuthorizeSecurityGroupIngress
• RevokeSecurityGroupIngress
• DescribeSecurityGroups
ContentsThe following table describes the elements contained in UserIdGroupPairSetType.
Name Description
item Information for one security group.
Type: UserIdGroupPairType (p. 380)
UserIdGroupPairTypeThe UserIdGroupPairType data type.
Ancestors• UserIdGroupPairSetType (p. 380)
Relevant Operations• AuthorizeSecurityGroupIngress
• RevokeSecurityGroupIngress
• DescribeSecurityGroups
ContentsThe following table describes the elements contained in UserIdGroupPairType.
Name Description
groupName Name of the security group.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceContents
API Version 2009-07-15381
Name Description
userId AWS User ID of an account.
Type: xsd:string
Amazon Elastic Compute Cloud API ReferenceOverview
API Version 2009-07-15382
API Error Codes
OverviewThere are two types of error codes: client and server.
Client error codes suggest that the error was caused by something the client did, such as anauthentication failure or an invalid AMI identifier. In the SOAP API, These error codes are prefixed withClient. For example: Client.AuthFailure. In the Query API, these errors are accompanied by a400-series HTTP response code.
Server error codes suggest a server-side issue caused the error and should be reported. In the SOAPAPI, these error codes are prefixed with Server. For example: Server.Unavailable. In the QueryAPI, these errors are accompanied by a 500-series HTTP response code.
Summary of Client Error CodesError Code Description Notes
AddressLimitExceeded User has the maximumnumber of allowed IPaddresses.
Each user has an IPaddress limit. For newusers, this limit is 5. If youneed more than 5 ElasticIP addresses, pleasecomplete the AmazonEC2 Elastic IP AddressRequest Form. We willask you to think throughyour use case and help usunderstand your need foradditional addresses.
AttachmentLimitExceeded The limit on the numberof Amazon EBS volumesattached to one instancehas been exceeded.
AuthFailure User not authorized. You might be trying to runan AMI for which you donot have permission.
Amazon Elastic Compute Cloud API ReferenceSummary of Client Error Codes
API Version 2009-07-15383
Error Code Description Notes
IncorrectState Volume is in incorrect state To attach to an instance,it must be in the 'available'state.
InstanceLimitExceeded User has max allowedconcurrent runninginstances.
Each user has aconcurrent runninginstance limit. For newusers, this limit is 20. Ifyou need more than 20instances, please completethe Amazon EC2 InstanceRequest Form and yourrequest will be considered.
InvalidAMIAttributeItemValue The value of an item addedto, or removed from, animage attribute is invalid.
If you are specifying auserId, check that it isin the form of an AWSaccount ID.
InvalidAMIID.Malformed Specified AMI ID is notvalid.
InvalidAMIID.NotFound Specified AMI ID does notexist.
InvalidAMIID.Unavailable Specified AMI ID has beenderegistered and is nolonger available.
InvalidAttachment.NotFound The instance cannotdetach from a volume towhich it is not attached.
InvalidDevice.InUse The device to which youare trying to attach (i.e. /dev/sdh) is already in useon the instance.
InvalidInstanceID.Malformed Specified instance ID is notvalid.
InvalidInstanceID.NotFound Specified instance ID doesnot exist.
InvalidKeyPair.NotFound Specified key pair namedoes not exist.
InvalidKeyPair.Duplicate Attempt to create aduplicate key pair.
InvalidGroup.NotFound Specified group namedoes not exist.
InvalidGroup.Duplicate Attempt to create aduplicate group.
Amazon Elastic Compute Cloud API ReferenceSummary of Client Error Codes
API Version 2009-07-15384
Error Code Description Notes
InvalidGroup.InUse Specified group cannotbe deleted because it is inuse.
InvalidGroup.Reserved Specified group name is areserved name.
InvalidManifest Specified AMI has anunparsable Manifest.
InvalidParameterCombination RunInstances was calledwith minCount andmaxCount set to 0 orminCount > maxCount.
InvalidParameterValue The value supplied for aparameter was invalid.
Requests that couldcause this errorinclude (for example)supplying an invalidimage attribute to theDescribeImageAttributerequest or an invalidversion or encodingvalue for the userData ina RunInstances request.
InvalidPermission.Duplicate Attempt to authorizea permission that hasalready been authorized.
InvalidPermission.Malformed Specified permission isinvalid.
InvalidReservationID.Malformed Specified reservation ID isinvalid.
InvalidReservationID.NotFound Specified reservation IDdoes not exist.
InvalidSnapshotID.Malformed The snapshot ID that waspassed as an argumentwas malformed.
InvalidSnapshotID.NotFound The specified snapshotdoes not exist.
InvalidUserID.Malformed The user ID is neitherin the form of an AWSaccount ID or one ofthe special valuesaccepted by the owner orexecutableBy flags inthe DescribeImages call.
InvalidReservedInstancesId Reserved Instances ID notfound.
Amazon Elastic Compute Cloud API ReferenceSummary of Client Error Codes
API Version 2009-07-15385
Error Code Description Notes
InvalidReservedInstancesOfferingIdReserved InstancesOffering ID not found.
InvalidVolumeID.Malformed The volume ID that waspassed as an argumentwas malformed.
InvalidVolumeID.NotFound The volume specified doesnot exist.
InvalidVolumeID.Duplicate The volume already existsin the system.
InvalidVolumeID.ZoneMismatch The specified volume IDand instance ID are indifferent Availability Zones.
InvalidZone.NotFound The specified zone doesnot exist.
InsufficientReservedInstancesCapacityInsufficient ReservedInstances capacity.
NonEBSInstance The instance specifieddoes not support EBS.
Please restart the instanceand try again. This willensure that the code isrun on an instance withupdated code.
PendingSnapshotLimitExceeded The limit on the number ofAmazon EBS snapshots inthe pending state has beenexceeded.
ReservedInstancesLimitExceeded Your current quota doesnot allow you to purchasethe required number ofreserved instances.
SnapshotLimitExceeded The limit on the number ofAmazon EBS snapshotshas been exceeded.
UnknownParameter An unknown orunrecognized parameterwas supplied.
Requests that could causethis error include supplyinga misspelled parameteror a parameter that is notsupported for the specifiedAPI version.
VolumeLimitExceeded The limit on the number ofAmazon EBS volumes hasbeen exceeded.
Amazon Elastic Compute Cloud API ReferenceSummary of Server Error Codes
API Version 2009-07-15386
Summary of Server Error CodesError Code Description Notes
InternalError Internal Error. This error should notoccur. If this persists,please contact us withdetails by posting amessage on the AWSforums.
InsufficientAddressCapacity Not enough available addresses tosatisfy your minimum request.
Reduce the numberof addresses you arerequesting or wait foradditional capacity tobecome available.
InsufficientInstanceCapacity Not enough available instances tosatisfy your minimum request.
Reduce the numberof instances in yourrequest or wait foradditional capacity tobecome available.
InsufficientReservedInstanceCapacityNot enough available ReservedInstances to satisfy your minimumrequest.
Reduce the number ofReserved Instances inyour request or wait foradditional capacity tobecome available.
Unavailable The server is overloaded andcannot handle the request.
Amazon Elastic Compute Cloud API Reference
API Version 2009-07-15387
Glossary
Amazon machine image (AMI) An Amazon Machine Image (AMI) is an encrypted machine imagestored in Amazon S3. It contains all the information necessary toboot instances of your software.
Amazon EBS A type of storage that enables you to create volumes that can bemounted as devices by Amazon EC2 instances. Amazon EBSvolumes behave like raw unformatted external block devices. Theyhave user supplied device names and provide a block deviceinterface. You can load a file system on top of Amazon EBSvolumes, or use them just as you would use a block device.
Availability Zone A distinct location within a region that is engineered to be insulatedfrom failures in other Availability Zones and provides inexpensive,low latency network connectivity to other Availability Zones in thesame region.
compute unit An Amazon-generated measure that enables you to evaluate theCPU capacity of different Amazon EC2 instance types.
EBS See Amazon EBS.
Elastic Block Store See Amazon EBS.
elastic IP address A static public IP address designed for dynamic cloud computing.Elastic IP addresses are associated with your account, not specificinstances. Any elastic IP addresses that you associate with youraccount remain associated with your account until you explicitlyrelease them. Unlike traditional static IP addresses, however,elastic IP addresses allow you to mask instance or AvailabilityZone failures by rapidly remapping your public IP addresses to anyinstance in your account.
ephemeral store See instance store.
explicit launch permission Launch permission granted to a specific user.
group See security group.
Amazon Elastic Compute Cloud API Reference
API Version 2009-07-15388
instance store Every instance includes a fixed amount of storage space on whichyou can store data. This is not designed to be a permanent storagesolution. If you need a permanent storage system, use AmazonEBS.
instance type A specification that defines the memory, CPU, storage capacity,and hourly cost for an instance. Some instance types are designedfor standard applications while others are designed for CPU-intensive applications.
gibibyte (GiB) a contraction of giga binary byte, a gibibyte is 2^30 bytes or1,073,741,824 bytes. A gigabyte is 10^9 or 1,000,000,000 bytes.So yes, Amazon has bigger bytes.
image See Amazon machine image.
instance Once an AMI has been launched, the resulting running system isreferred to as an instance. All instances based on the same AMIstart out identical and any information on them is lost when theinstances are terminated or fail.
instance store The disk storage associated with an instance. In the event aninstance fails or is terminated (not simply rebooted), all content onthe instance store is deleted.
group Also known as a security group, groups define firewall rules thatcan be shared among a group of instances that have similarsecurity requirements. The group is specified at instance launch.
launch permission AMI attribute allowing users to launch an AMI
Linux Amazon EC2 instances are available for many operating platforms,including Linux, Solaris, Windows, and others.
paid AMI An AMI that you sell to other Amazon EC2 users. For moreinformation, refer to the Amazon DevPay Developer Guide.
private IP address All Amazon EC2 instances are assigned two IP addresses atlaunch: a private address (RFC 1918) and a public address that aredirectly mapped to each other through Network Address Translation(NAT).
public AMI An AMI that all users have launch permissions for.
public data sets Sets of large public data sets that can be seamlessly integrated intoAWS cloud-based applications. Amazon stores the data sets at nocharge to the community and, like all AWS services, users pay onlyfor the compute and storage they use for their own applications.These data sets currently include data from the Human GenomeProject, the U.S. Census, Wikipedia, and other sources.
public IP address All Amazon EC2 instances are assigned two IP addresses atlaunch: a private address (RFC 1918) and a public address that aredirectly mapped to each other through Network Address Translation(NAT).
region A geographical area in which you can launch instances (e.g., US,EU).
reservation A collection of instances started as part of the same launchrequest.
Amazon Elastic Compute Cloud API Reference
API Version 2009-07-15389
Reserved Instance An additional Amazon EC2 pricing option. With ReservedInstances, you can make a low one-time payment for each instanceto reserve and receive a significant discount on the hourly usagecharge for that instance.
security group A security group is a named collection of access rules. Theseaccess rules specify which ingress (i.e., incoming) network trafficshould be delivered to your instance. All other ingress traffic will bediscarded.
shared AMI AMIs that developers build and make available for other AWSdevelopers to use.
Solaris Amazon EC2 instances are available for many operating platforms,including Linux, Solaris, Windows, and others.
snapshot Amazon EBS provides the ability to create snapshots or backupsof your Amazon EBS volumes and store them in Amazon S3. Youcan use these snapshots as the starting point for new Amazon EBSvolumes and to protect your data for long term durability.
supported AMIs These AMIs are similar to paid AMIs, except that you charge forsoftware or a service that customers use with their own AMIs.
tebibyte (TiB) a contraction of tera binary byte, a tebibyte is 2^40 bytes or1,099,511,627,776 bytes. A terabyte is 10^12 or 1,000,000,000,000bytes. So yes, Amazon has bigger bytes.
UNIX Amazon EC2 instances are available for many operating platforms,including Linux, Solaris, Windows, and others.
Windows Amazon EC2 instances are available for many operating platforms,including Linux, Solaris, Windows, and others.
Amazon Elastic Compute Cloud API ReferenceTypographical Conventions
API Version 2009-07-15390
Document Conventions
This section lists the common typographical and symbol use conventions for AWS technicalpublications.
Typographical ConventionsThis section describes common typographical use conventions.
Convention Description/Example
Call-outs A call-out is a number in the body text to give you a visual reference. Thereference point is for further discussion elsewhere.
You can use this resource regularly.
Code in text Inline code samples (including XML) and commands are identified with aspecial font.
You can use the command java -version.
Code blocks Blocks of sample code are set apart from the body and markedaccordingly.
# ls -l /var/www/html/index.html-rw-rw-r-- 1 root root 1872 Jun 21 09:33 /var/www/html/index.html# dateWed Jun 21 09:33:42 EDT 2006
Emphasis Unusual or important words and phrases are marked with a special font.
You must sign up for an account before you can use the service.
Internal crossreferences
References to a section in the same document are marked.
See Document Conventions (p. 390).
Logical values,constants, and regularexpressions, abstracta
A special font is used for expressions that are important to identify, but arenot code.
If the value is null, the returned response will be false.
Amazon Elastic Compute Cloud API ReferenceTypographical Conventions
API Version 2009-07-15391
Convention Description/Example
Product and featurenames
Named AWS products and features are identified on first use.
Create an Amazon Machine Image (AMI).
Operations In-text references to operations.
Use the GetHITResponse operation.
Parameters In-text references to parameters.
The operation accepts the parameter AccountID.
Response elements In-text references to responses.
A container for one CollectionParent and one or moreCollectionItems.
Technical publicationreferences
References to other AWS publications. If the reference is hyperlinked, it isalso underscored.
For detailed conceptual information, see the Amazon Mechanical TurkDeveloper Guide.
User entered values A special font marks text that the user types.
At the password prompt, type MyPassword.
User interface controlsand labels
Denotes named items on the UI for easy identification.
On the File menu, click Properties.
Variables When you see this style, you must change the value of the content whenyou copy the text of a sample to a command line.
% ec2-register <your-s3-bucket>/image.manifest
See also Symbol Conventions (p. 392).
Amazon Elastic Compute Cloud API ReferenceSymbol Conventions
API Version 2009-07-15392
Symbol ConventionsThis section describes the common use of symbols.
Convention Symbol Description/Example
Mutuallyexclusiveparameters
(Parentheses | and| vertical | bars)
Within a code description, bar separators denote options fromwhich one must be chosen.
% data = hdfread (start | stride | edge)
Optionalparameters
XML variabletext
[square brackets] Within a code description, square brackets denote completelyoptional commands or parameters.
% sed [-n, -quiet]
Use square brackets in XML examples to differentiate themfrom tags.
<CustomerId>[ID]</CustomerId>
Variables <arrow brackets> Within a code sample, arrow brackets denote a variable thatmust be replaced with a valid value.
% ec2-register <your-s3-bucket>/image.manifest
Amazon Elastic Compute Cloud API Reference
API Version 2009-07-15393
IndexAactions, 5adding key pairs, 33, 161adding security groups, 35, 164AllocateAddress
Query, 12SOAP, 138
AMIsderegistering, 50, 179describing attributes, 61, 191describing images, 65, 196registering, 111, 251resetting attributes, 115, 255
APIactions, 5data types, 5
API listQuery, 9SOAP, 135
AssociateAddressQuery, 14SOAP, 140
attaching volumes, 16, 142AttachVolume
Query, 16SOAP, 142
audience, 1AuthorizeSecurityGroupIngress
Query, 19SOAP, 145
authorizing security group ingress, 19, 145Availability Zones
describing, 54, 184
Bblock storage
create snapshot, 37, 46, 166, 175bundle task
canceling, 27, 155describing, 57, 187
BundleInstanceQuery, 22SOAP, 149
bundling Windows password, 22, 149
CCalls
Query, 9SOAP, 135
CancelBundleTaskQuery, 27SOAP, 155
canceling Windows bundling, 27, 155
changes to Amazon EC2, 4client error codes, 382confirming instances, 31, 159ConfirmProductInstance
Query, 31SOAP, 159
console outputgetting, 99, 236
CreateKeyPairQuery, 33SOAP, 161
CreateSecurityGroupQuery, 35SOAP, 164
CreateSnapshotQuery, 37SOAP, 166
CreateVolumeQuery, 39SOAP, 168
creating EBS snapshots, 37, 46, 166, 175creating key pairs, 33, 161creating security groups, 35, 164creating volumes, 39, 168
Ddata types, 5DeleteKeyPair
Query, 42SOAP, 171
DeleteSecurityGroupQuery, 44SOAP, 173
DeleteSnapshotQuery, 46SOAP, 175
DeleteVolumeQuery, 48SOAP, 177
deletingkey pairs, 42, 171security groups, 44, 173
deleting volumes, 48, 177DeregisterImage
Query, 50SOAP, 179
deregistering AMIs, 50, 179DescribeAddresses
Query, 52SOAP, 181
DescribeAvailabilityZonesQuery, 54SOAP, 184
DescribeBundleTasksQuery, 57SOAP, 187
DescribeImageAttribute
Amazon Elastic Compute Cloud API Reference
API Version 2009-07-15394
Query, 61SOAP, 191
DescribeImagesQuery, 65SOAP, 196
DescribeInstancesQuery, 69SOAP, 202
DescribeKeyPairsQuery, 75SOAP, 209
DescribeRegionsQuery, 77SOAP, 211
DescribeReservedInstancesQuery, 79SOAP, 213
DescribeReservedInstancesOfferingsQuery, 82SOAP, 216
DescribeSecurityGroupsQuery, 85SOAP, 220
DescribeSnapshotsQuery, 89SOAP, 224
DescribeVolumesQuery, 91SOAP, 227
describing AMI attributes, 61, 191describing Availability Zones, 54, 184describing elastic IP addresses, 52, 181describing images, 65, 196describing instances, 69, 202describing key pairs, 75, 209describing regions, 77, 211describing Reserved Instance offerings, 82, 216describing Reserved Instances, 79, 213describing security groups, 85, 220describing snapshots, 89, 224describing volumes, 91, 227describing Windows bundling tasks, 57, 187detaching volumes, 94, 231DetachVolume
Query, 94SOAP, 231
DisassociateAddressQuery, 97SOAP, 234
disassociating elastic IP addresses, 97, 234
Eelastic block storage
create snapshot, 37, 46, 166, 175elastic IP addresses
associating, 14, 140describing, 52, 181
disassociating, 97, 234releasing, 109, 113, 249, 253
error codes, 382
Ffirewall, 35, 164function list
Query, 9SOAP, 135
GGetConsoleOutput
Query, 99SOAP, 236
GetPasswordDataQuery, 101SOAP, 238
getting console output, 99, 236getting password, 101, 238glossary, 387groups
creating, 35, 164describing, 85, 220revoking access, 117, 120, 257, 261
Iimage attributes
describing, 61, 191images
deregistering, 50, 179describing, 65, 196modifying attributes, 103, 240registering, 111, 251resetting attributes, 115, 255
instancebundling Windows, 22, 149
instancesaccessing, 12, 138confirming, 31, 159describing, 69, 202monitoring, 105, 244
disabling, 132, 275rebooting, 109, 249terminating, 129, 272
IP addressesassociating, 14, 140describing, 52, 181disassociating, 97, 234releasing, 113, 253
Kkey pairs
creating, 33, 161deleting, 42, 171describing, 75, 209
killing instances, 129, 272
Amazon Elastic Compute Cloud API Reference
API Version 2009-07-15395
MModifyImageAttribute
Query, 103SOAP, 240
modifying image attributes, 103, 240monitoring instances, 105, 244
disabling, 132, 275MonitorInstances
Query, 105SOAP, 244
Nnew features, 4
Ooperation list
Query, 9SOAP, 135
Ppassword
getting Windows, 101, 238PurchaseReservedInstancesOffering
Query, 107SOAP, 247
purchasing Reserved Instances, 107, 247
QQuery
AllocateAddress, 12AssociateAddress, 14AttachVolume, 16AuthorizeSecurityGroupIngress, 19BundleInstance, 22CancelBundleTask, 27ConfirmProductInstance, 31CreateKeyPair, 33CreateSecurityGroup, 35CreateSnapshot, 37CreateVolume, 39DeleteKeyPair, 42DeleteSecurityGroup, 44DeleteSnapshot, 46DeleteVolume, 48DeregisterImage, 50DescribeAddresses, 52DescribeAvailabilityZones, 54DescribeBundleTasks, 57DescribeImageAttribute, 61DescribeImages, 65DescribeInstances, 69DescribeKeyPairs, 75DescribeRegions, 77DescribeReservedInstances, 79DescribeReservedInstancesOfferings, 82DescribeSecurityGroups, 85
DescribeSnapshots, 89DescribeVolumes, 91DetachVolume, 94DisassociateAddress, 97GetConsoleOutput, 99GetPasswordData, 101list of operations, 9ModifyImageAttribute, 103MonitorInstances, 105PurchaseReservedInstancesOffering, 107RebootInstances, 109RegisterImage, 111ReleaseAddress, 113ResetImageAttribute, 115RevokeSecurityGroupIngress, 117RunInstances, 120TerminateInstances, 129UnmonitorInstances, 132
Rrebooting instances, 109, 249RebootInstances
Query, 109SOAP, 249
regionsdescribing, 77, 211
RegisterImageQuery, 111SOAP, 251
registering AMIs, 111, 251ReleaseAddress
Query, 113SOAP, 253
releasing elastic IP addresses, 113, 253Remote Desktop, 12, 138required knowledge, 1Reserved Instances
describing, 79, 213describing offerings, 82, 216purchasing, 107, 247
ResetImageAttributeQuery, 115SOAP, 255
resetting image attributes, 115, 255resources, 2RevokeSecurityGroupIngress
Query, 117SOAP, 257
revoking access, 117, 120, 257, 261RunInstances
Query, 120SOAP, 261
Ssecurity groups
authorizing ingress, 19, 145creating, 35, 164
Amazon Elastic Compute Cloud API Reference
API Version 2009-07-15396
deleting, 44, 173describing, 85, 220revoking access, 117, 120, 257, 261
server error codes, 382shutting down instances, 129, 272snapshots
describing, 89, 224SOAP
AllocateAddress, 138AssociateAddress, 140AttachVolume, 142AuthorizeSecurityGroupIngress, 145BundleInstance, 149CancelBundleTask, 155ConfirmProductInstance, 159CreateKeyPair, 161CreateSecurityGroup, 164CreateSnapshot, 166CreateVolume, 168DeleteKeyPair, 171DeleteSecurityGroup, 173DeleteSnapshot, 175DeleteVolume, 177DeregisterImage, 179DescribeAddresses, 181DescribeAvailabilityZones, 184DescribeBundleTasks, 187DescribeImageAttribute, 191DescribeImages, 196DescribeInstances, 202DescribeKeyPairs, 209DescribeRegions, 211DescribeReservedInstances, 213DescribeReservedInstancesOfferings, 216DescribeSecurityGroups, 220DescribeSnapshots, 224DescribeVolumes, 227DetachVolume, 231DisassociateAddress, 234GetConsoleOutput, 236GetPasswordData, 238list of operations, 135ModifyImageAttribute, 240MonitorInstances, 244PurchaseReservedInstancesOffering, 247RebootInstances, 249RegisterImage, 251ReleaseAddress, 253ResetImageAttribute, 255RevokeSecurityGroupIngress, 257RunInstances, 261TerminateInstances, 272UnmonitorInstances, 275
TTerminateInstances
Query, 129
SOAP, 272terminating instances, 129, 272
UUnmonitorInstances
Query, 132SOAP, 275
Vverifying instances, 31, 159volumes
attaching, 16, 142creating, 39, 168deleting, 48, 177describing, 91, 227detaching, 94, 231
WWindows
bundling instance, 22, 149canceling bundle task, 27, 155describing bundle tasks, 57, 187getting password, 101, 238
Zzones
describing, 54, 184