import { Command as $Command } from "@smithy/core/client"; import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { AccessAnalyzerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../AccessAnalyzerClient"; import type { ListFindingsRequest, ListFindingsResponse } from "../models/models_0"; /** * @public */ export type { __MetadataBearer }; export { $Command }; /** * @public * * The input for {@link ListFindingsCommand}. */ export interface ListFindingsCommandInput extends ListFindingsRequest { } /** * @public * * The output of {@link ListFindingsCommand}. */ export interface ListFindingsCommandOutput extends ListFindingsResponse, __MetadataBearer { } declare const ListFindingsCommand_base: { new (input: ListFindingsCommandInput): import("@smithy/core/client").CommandImpl; new (input: ListFindingsCommandInput): import("@smithy/core/client").CommandImpl; getEndpointParameterInstructions(): { [x: string]: unknown; }; }; /** *

Retrieves a list of findings generated by the specified analyzer. ListFindings and ListFindingsV2 both use access-analyzer:ListFindings in the Action element of an IAM policy statement. You must have permission to perform the access-analyzer:ListFindings action.

To learn about filter keys that you can use to retrieve a list of findings, see IAM Access Analyzer filter keys in the IAM User Guide.

ListFindings is supported only for external access analyzers. You must use ListFindingsV2 for internal and unused access analyzers.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { AccessAnalyzerClient, ListFindingsCommand } from "@aws-sdk/client-accessanalyzer"; // ES Modules import * // const { AccessAnalyzerClient, ListFindingsCommand } = require("@aws-sdk/client-accessanalyzer"); // CommonJS import * // import type { AccessAnalyzerClientConfig } from "@aws-sdk/client-accessanalyzer"; * const config = {}; // type is AccessAnalyzerClientConfig * const client = new AccessAnalyzerClient(config); * const input = { // ListFindingsRequest * analyzerArn: "STRING_VALUE", // required * filter: { // FilterCriteriaMap * "": { // Criterion * eq: [ // ValueList * "STRING_VALUE", * ], * neq: [ * "STRING_VALUE", * ], * contains: [ * "STRING_VALUE", * ], * exists: true || false, * }, * }, * sort: { // SortCriteria * attributeName: "STRING_VALUE", * orderBy: "STRING_VALUE", * }, * nextToken: "STRING_VALUE", * maxResults: Number("int"), * }; * const command = new ListFindingsCommand(input); * const response = await client.send(command); * // { // ListFindingsResponse * // findings: [ // FindingsList // required * // { // FindingSummary * // id: "STRING_VALUE", // required * // principal: { // PrincipalMap * // "": "STRING_VALUE", * // }, * // action: [ // ActionList * // "STRING_VALUE", * // ], * // resource: "STRING_VALUE", * // isPublic: true || false, * // resourceType: "STRING_VALUE", // required * // condition: { // ConditionKeyMap // required * // "": "STRING_VALUE", * // }, * // createdAt: new Date("TIMESTAMP"), // required * // analyzedAt: new Date("TIMESTAMP"), // required * // updatedAt: new Date("TIMESTAMP"), // required * // status: "STRING_VALUE", // required * // resourceOwnerAccount: "STRING_VALUE", // required * // error: "STRING_VALUE", * // sources: [ // FindingSourceList * // { // FindingSource * // type: "STRING_VALUE", // required * // detail: { // FindingSourceDetail * // accessPointArn: "STRING_VALUE", * // accessPointAccount: "STRING_VALUE", * // }, * // }, * // ], * // resourceControlPolicyRestriction: "STRING_VALUE", * // }, * // ], * // nextToken: "STRING_VALUE", * // }; * * ``` * * @param ListFindingsCommandInput - {@link ListFindingsCommandInput} * @returns {@link ListFindingsCommandOutput} * @see {@link ListFindingsCommandInput} for command's `input` shape. * @see {@link ListFindingsCommandOutput} for command's `response` shape. * @see {@link AccessAnalyzerClientResolvedConfig | config} for AccessAnalyzerClient's `config` shape. * * @throws {@link AccessDeniedException} (client fault) *

You do not have sufficient access to perform this action.

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

Internal server error.

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

The specified resource could not be found.

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

Throttling limit exceeded error.

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

Validation exception error.

* * @throws {@link AccessAnalyzerServiceException} *

Base exception class for all service exceptions from AccessAnalyzer service.

* * * @public */ export declare class ListFindingsCommand extends ListFindingsCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: ListFindingsRequest; output: ListFindingsResponse; }; sdk: { input: ListFindingsCommandInput; output: ListFindingsCommandOutput; }; }; }