Options
All
  • Public
  • Public/Protected
  • All
Menu

Class DeregisterImageCommand

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.

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);
see

DeregisterImageCommandInput for command's input shape.

see

DeregisterImageCommandOutput for command's response shape.

see

config for EC2Client's config shape.

Hierarchy

Implements

Index

Constructors

constructor

Properties

Readonly input

input: DeregisterImageCommandInput

Readonly middlewareStack

middlewareStack: IMiddlewareStack<DeregisterImageCommandInput, DeregisterImageCommandOutput>

Methods

Static getEndpointParameterInstructions