DeregisterImage
The DeregisterImage operation deregisters an
AMI. Once deregistered, instances of the AMI may no longer be
launched.
The following table describes the request parameters for
DeregisterImage. Parameter names are case
sensitive.
| Element Name | Definition | Required? | Type |
|---|---|---|---|
imageId
|
Unique ID of a machine image, returned by a call to RegisterImage or DescribeImages. | Yes |
xsd:string
|
launchPermission
|
Specifies launch permissions of the AMI. | Choice |
xsd:EmptyElementType
|
productCodes
|
Specifies product codes of the AMI. | Choice |
xsd:EmptyElementType
|
The following table describes the default response tags included
in DeregisterImage responses.
| Element Name | Definition | Type |
|---|---|---|
return
|
true if deregistration succeeded,
otherwise false.
|
xsd:boolean
|
launchPermission
|
Returns launch permissions of the AMI if launchPermission is specified.. |
ec2:LaunchPermissionItemType[]
|
productCodes
|
Returns product codes of the AMI if launchPermission is specified. |
ec2:ProductCodeItemType[]
|
<DeregisterImage xmlns="http://ec2.amazonaws.com/doc/2007-01-03">
<imageId>ami-61a54008</imageId>
</DeregisterImage>
<DeregisterImageResponse xmlns="http://ec2.amazonaws.com/doc/2007-01-03"> <return>true</return> </DeregisterImageResponse>