import { Command as $Command } from "@smithy/smithy-client"; import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { ECRClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../ECRClient"; import type { DescribeImagesRequest, DescribeImagesResponse } from "../models/models_0"; /** * @public */ export type { __MetadataBearer }; export { $Command }; /** * @public * * The input for {@link DescribeImagesCommand}. */ export interface DescribeImagesCommandInput extends DescribeImagesRequest { } /** * @public * * The output of {@link DescribeImagesCommand}. */ export interface DescribeImagesCommandOutput extends DescribeImagesResponse, __MetadataBearer { } declare const DescribeImagesCommand_base: { new (input: DescribeImagesCommandInput): import("@smithy/smithy-client").CommandImpl; new (input: DescribeImagesCommandInput): import("@smithy/smithy-client").CommandImpl; getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions; }; /** *

Returns metadata about the images in a repository.

* *

Starting with Docker version 1.9, the Docker client compresses image layers before * pushing them to a V2 Docker registry. The output of the docker images * command shows the uncompressed image size. Therefore, Docker might return a larger * image than the image shown in the Amazon Web Services Management Console.

*
* *

The new version of Amazon ECR * Basic Scanning doesn't use the ImageDetail$imageScanFindingsSummary and ImageDetail$imageScanStatus attributes from the API response to * return scan results. Use the DescribeImageScanFindings API * instead. For more information about Amazon Web Services native basic scanning, see Scan * images for software vulnerabilities in Amazon ECR.

*
* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { ECRClient, DescribeImagesCommand } from "@aws-sdk/client-ecr"; // ES Modules import * // const { ECRClient, DescribeImagesCommand } = require("@aws-sdk/client-ecr"); // CommonJS import * // import type { ECRClientConfig } from "@aws-sdk/client-ecr"; * const config = {}; // type is ECRClientConfig * const client = new ECRClient(config); * const input = { // DescribeImagesRequest * registryId: "STRING_VALUE", * repositoryName: "STRING_VALUE", // required * imageIds: [ // ImageIdentifierList * { // ImageIdentifier * imageDigest: "STRING_VALUE", * imageTag: "STRING_VALUE", * }, * ], * nextToken: "STRING_VALUE", * maxResults: Number("int"), * filter: { // DescribeImagesFilter * tagStatus: "TAGGED" || "UNTAGGED" || "ANY", * imageStatus: "ACTIVE" || "ARCHIVED" || "ACTIVATING" || "ANY", * }, * }; * const command = new DescribeImagesCommand(input); * const response = await client.send(command); * // { // DescribeImagesResponse * // imageDetails: [ // ImageDetailList * // { // ImageDetail * // registryId: "STRING_VALUE", * // repositoryName: "STRING_VALUE", * // imageDigest: "STRING_VALUE", * // imageTags: [ // ImageTagList * // "STRING_VALUE", * // ], * // imageSizeInBytes: Number("long"), * // imagePushedAt: new Date("TIMESTAMP"), * // imageScanStatus: { // ImageScanStatus * // status: "IN_PROGRESS" || "COMPLETE" || "FAILED" || "UNSUPPORTED_IMAGE" || "ACTIVE" || "PENDING" || "SCAN_ELIGIBILITY_EXPIRED" || "FINDINGS_UNAVAILABLE" || "LIMIT_EXCEEDED" || "IMAGE_ARCHIVED", * // description: "STRING_VALUE", * // }, * // imageScanFindingsSummary: { // ImageScanFindingsSummary * // imageScanCompletedAt: new Date("TIMESTAMP"), * // vulnerabilitySourceUpdatedAt: new Date("TIMESTAMP"), * // findingSeverityCounts: { // FindingSeverityCounts * // "": Number("int"), * // }, * // }, * // imageManifestMediaType: "STRING_VALUE", * // artifactMediaType: "STRING_VALUE", * // lastRecordedPullTime: new Date("TIMESTAMP"), * // subjectManifestDigest: "STRING_VALUE", * // imageStatus: "ACTIVE" || "ARCHIVED" || "ACTIVATING", * // lastArchivedAt: new Date("TIMESTAMP"), * // lastActivatedAt: new Date("TIMESTAMP"), * // }, * // ], * // nextToken: "STRING_VALUE", * // }; * * ``` * * @param DescribeImagesCommandInput - {@link DescribeImagesCommandInput} * @returns {@link DescribeImagesCommandOutput} * @see {@link DescribeImagesCommandInput} for command's `input` shape. * @see {@link DescribeImagesCommandOutput} for command's `response` shape. * @see {@link ECRClientResolvedConfig | config} for ECRClient's `config` shape. * * @throws {@link ImageNotFoundException} (client fault) *

The image requested does not exist in the specified repository.

* * @throws {@link InvalidParameterException} (client fault) *

The specified parameter is invalid. Review the available parameters for the API * request.

* * @throws {@link RepositoryNotFoundException} (client fault) *

The specified repository could not be found. Check the spelling of the specified * repository and ensure that you are performing operations on the correct registry.

* * @throws {@link ServerException} (server fault) *

These errors are usually caused by a server-side issue.

* * @throws {@link ECRServiceException} *

Base exception class for all service exceptions from ECR service.

* * * @public */ export declare class DescribeImagesCommand extends DescribeImagesCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: DescribeImagesRequest; output: DescribeImagesResponse; }; sdk: { input: DescribeImagesCommandInput; output: DescribeImagesCommandOutput; }; }; }