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 NameDefinitionRequired?Type
imageId Unique ID of a machine image, returned by a call to RegisterImage or DescribeImages. Yesxsd:string
launchPermission Specifies launch permissions of the AMI. Choicexsd:EmptyElementType
productCodes Specifies product codes of the AMI. Choicexsd:EmptyElementType

The following table describes the default response tags included in DeregisterImage responses.

Element NameDefinitionType
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-03-01">
    <imageId>ami-61a54008</imageId>
</DeregisterImage>
<DeregisterImageResponse xmlns="http://ec2.amazonaws.com/doc/2007-03-01">
  <return>true</return>
</DeregisterImageResponse>