Deregisters the specified AMI. After you deregister an AMI, it can't be used to
launch new instances.
If you deregister an AMI that matches a Recycle Bin retention rule, the AMI is retained
in the Recycle Bin for the specified retention period. For more information, see Recycle Bin in
the Amazon EC2 User Guide.
When you deregister an AMI, it doesn't affect any instances that you've already
launched from the AMI. You'll continue to incur usage costs for those instances until
you terminate them.
When you deregister an Amazon EBS-backed AMI, it doesn't affect the snapshot that was
created for the root volume of the instance during the AMI creation process. When you
deregister an instance store-backed AMI, it doesn't affect the files that you uploaded
to Amazon S3 when you created the AMI.
example
Use a bare-bones client and the command you need to make an API call.
Deregisters the specified AMI. After you deregister an AMI, it can't be used to launch new instances.
If you deregister an AMI that matches a Recycle Bin retention rule, the AMI is retained in the Recycle Bin for the specified retention period. For more information, see Recycle Bin in the Amazon EC2 User Guide.
When you deregister an AMI, it doesn't affect any instances that you've already launched from the AMI. You'll continue to incur usage costs for those instances until you terminate them.
When you deregister an Amazon EBS-backed AMI, it doesn't affect the snapshot that was created for the root volume of the instance during the AMI creation process. When you deregister an instance store-backed AMI, it doesn't affect the files that you uploaded to Amazon S3 when you created the AMI.
Use a bare-bones client and the command you need to make an API call.
import { EC2Client, DeregisterImageCommand } from "@aws-sdk/client-ec2"; // ES Modules import // const { EC2Client, DeregisterImageCommand } = require("@aws-sdk/client-ec2"); // CommonJS import const client = new EC2Client(config); const command = new DeregisterImageCommand(input); const response = await client.send(command);
DeregisterImageCommandInput for command's
input
shape.DeregisterImageCommandOutput for command's
response
shape.config for EC2Client's
config
shape.