import { Command as $Command } from "@smithy/smithy-client"; import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { EC2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EC2Client"; import type { DeregisterImageRequest, DeregisterImageResult } from "../models/models_3"; /** * @public */ export type { __MetadataBearer }; export { $Command }; /** * @public * * The input for {@link DeregisterImageCommand}. */ export interface DeregisterImageCommandInput extends DeregisterImageRequest { } /** * @public * * The output of {@link DeregisterImageCommand}. */ export interface DeregisterImageCommandOutput extends DeregisterImageResult, __MetadataBearer { } declare const DeregisterImageCommand_base: { new (input: DeregisterImageCommandInput): import("@smithy/smithy-client").CommandImpl; new (input: DeregisterImageCommandInput): import("@smithy/smithy-client").CommandImpl; getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions; }; /** *

Deregisters the specified AMI. A deregistered AMI can't be used to launch new * instances.

*

If a deregistered EBS-backed AMI matches a Recycle Bin retention rule, it moves to the * Recycle Bin for the specified retention period. It can be restored before its retention period * expires, after which it is permanently deleted. If the deregistered AMI doesn't match a * retention rule, it is permanently deleted immediately. For more information, see Recover deleted Amazon EBS * snapshots and EBS-backed AMIs with Recycle Bin in the Amazon EBS User * Guide.

*

When deregistering an EBS-backed AMI, you can optionally delete its associated snapshots * at the same time. However, if a snapshot is associated with multiple AMIs, it won't be deleted * even if specified for deletion, although the AMI will still be deregistered.

*

Deregistering an AMI does not delete the following:

* *

For more information, see Deregister an Amazon EC2 AMI in the * Amazon EC2 User Guide.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { EC2Client, DeregisterImageCommand } from "@aws-sdk/client-ec2"; // ES Modules import * // const { EC2Client, DeregisterImageCommand } = require("@aws-sdk/client-ec2"); // CommonJS import * // import type { EC2ClientConfig } from "@aws-sdk/client-ec2"; * const config = {}; // type is EC2ClientConfig * const client = new EC2Client(config); * const input = { // DeregisterImageRequest * ImageId: "STRING_VALUE", // required * DeleteAssociatedSnapshots: true || false, * DryRun: true || false, * }; * const command = new DeregisterImageCommand(input); * const response = await client.send(command); * // { // DeregisterImageResult * // Return: true || false, * // DeleteSnapshotResults: [ // DeleteSnapshotResultSet * // { // DeleteSnapshotReturnCode * // SnapshotId: "STRING_VALUE", * // ReturnCode: "success" || "skipped" || "missing-permissions" || "internal-error" || "client-error", * // }, * // ], * // }; * * ``` * * @param DeregisterImageCommandInput - {@link DeregisterImageCommandInput} * @returns {@link DeregisterImageCommandOutput} * @see {@link DeregisterImageCommandInput} for command's `input` shape. * @see {@link DeregisterImageCommandOutput} for command's `response` shape. * @see {@link EC2ClientResolvedConfig | config} for EC2Client's `config` shape. * * @throws {@link EC2ServiceException} *

Base exception class for all service exceptions from EC2 service.

* * * @public */ export declare class DeregisterImageCommand extends DeregisterImageCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: DeregisterImageRequest; output: DeregisterImageResult; }; sdk: { input: DeregisterImageCommandInput; output: DeregisterImageCommandOutput; }; }; }