@aws-sdk/client-securityhub 3.936.0 → 3.939.0

package/dist-types/commands/GetResourcesTrendsV2Command.d.ts

@@ -0,0 +1,137 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { GetResourcesTrendsV2Response } from "../models/models_2";
+import { GetResourcesTrendsV2Request } from "../models/models_3";
+import { SecurityHubClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecurityHubClient";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link GetResourcesTrendsV2Command}.
+ */
+export interface GetResourcesTrendsV2CommandInput extends GetResourcesTrendsV2Request {
+}
+/**
+ * @public
+ *
+ * The output of {@link GetResourcesTrendsV2Command}.
+ */
+export interface GetResourcesTrendsV2CommandOutput extends GetResourcesTrendsV2Response, __MetadataBearer {
+}
+declare const GetResourcesTrendsV2Command_base: {
+    new (input: GetResourcesTrendsV2CommandInput): import("@smithy/smithy-client").CommandImpl<GetResourcesTrendsV2CommandInput, GetResourcesTrendsV2CommandOutput, SecurityHubClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (input: GetResourcesTrendsV2CommandInput): import("@smithy/smithy-client").CommandImpl<GetResourcesTrendsV2CommandInput, GetResourcesTrendsV2CommandOutput, SecurityHubClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>Returns resource trend data based on the specified criteria. This operation helps you analyze patterns and changes in resource compliance over time. This API is in public preview and subject to change.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { SecurityHubClient, GetResourcesTrendsV2Command } from "@aws-sdk/client-securityhub"; // ES Modules import
+ * // const { SecurityHubClient, GetResourcesTrendsV2Command } = require("@aws-sdk/client-securityhub"); // CommonJS import
+ * // import type { SecurityHubClientConfig } from "@aws-sdk/client-securityhub";
+ * const config = {}; // type is SecurityHubClientConfig
+ * const client = new SecurityHubClient(config);
+ * const input = { // GetResourcesTrendsV2Request
+ *   Filters: { // ResourcesTrendsFilters
+ *     CompositeFilters: [ // ResourcesTrendsCompositeFilterList
+ *       { // ResourcesTrendsCompositeFilter
+ *         StringFilters: [ // ResourcesTrendsStringFilterList
+ *           { // ResourcesTrendsStringFilter
+ *             FieldName: "account_id" || "region" || "resource_type" || "resource_category",
+ *             Filter: { // StringFilter
+ *               Value: "STRING_VALUE",
+ *               Comparison: "EQUALS" || "PREFIX" || "NOT_EQUALS" || "PREFIX_NOT_EQUALS" || "CONTAINS" || "NOT_CONTAINS" || "CONTAINS_WORD",
+ *             },
+ *           },
+ *         ],
+ *         NestedCompositeFilters: [
+ *           {
+ *             StringFilters: [
+ *               {
+ *                 FieldName: "account_id" || "region" || "resource_type" || "resource_category",
+ *                 Filter: {
+ *                   Value: "STRING_VALUE",
+ *                   Comparison: "EQUALS" || "PREFIX" || "NOT_EQUALS" || "PREFIX_NOT_EQUALS" || "CONTAINS" || "NOT_CONTAINS" || "CONTAINS_WORD",
+ *                 },
+ *               },
+ *             ],
+ *             NestedCompositeFilters: "<ResourcesTrendsCompositeFilterList>",
+ *             Operator: "AND" || "OR",
+ *           },
+ *         ],
+ *         Operator: "AND" || "OR",
+ *       },
+ *     ],
+ *     CompositeOperator: "AND" || "OR",
+ *   },
+ *   StartTime: new Date("TIMESTAMP"), // required
+ *   EndTime: new Date("TIMESTAMP"), // required
+ *   NextToken: "STRING_VALUE",
+ *   MaxResults: Number("int"),
+ * };
+ * const command = new GetResourcesTrendsV2Command(input);
+ * const response = await client.send(command);
+ * // { // GetResourcesTrendsV2Response
+ * //   Granularity: "Daily" || "Weekly" || "Monthly", // required
+ * //   TrendsMetrics: [ // ResourcesTrendsMetrics // required
+ * //     { // ResourcesTrendsMetricsResult
+ * //       Timestamp: new Date("TIMESTAMP"), // required
+ * //       TrendsValues: { // ResourcesTrendsValues
+ * //         ResourcesCount: { // ResourcesCount
+ * //           AllResources: Number("long"), // required
+ * //         },
+ * //       },
+ * //     },
+ * //   ],
+ * //   NextToken: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param GetResourcesTrendsV2CommandInput - {@link GetResourcesTrendsV2CommandInput}
+ * @returns {@link GetResourcesTrendsV2CommandOutput}
+ * @see {@link GetResourcesTrendsV2CommandInput} for command's `input` shape.
+ * @see {@link GetResourcesTrendsV2CommandOutput} for command's `response` shape.
+ * @see {@link SecurityHubClientResolvedConfig | config} for SecurityHubClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You don't have permission to perform the action specified in the request.</p>
+ *
+ * @throws {@link InternalServerException} (server fault)
+ *  <p>
+ *          The request has failed due to an internal failure of the service.
+ *       </p>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>
+ *          The limit on the number of requests per second was exceeded.
+ *       </p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>The request has failed validation because it's missing required fields or has invalid inputs.</p>
+ *
+ * @throws {@link SecurityHubServiceException}
+ * <p>Base exception class for all service exceptions from SecurityHub service.</p>
+ *
+ *
+ * @public
+ */
+export declare class GetResourcesTrendsV2Command extends GetResourcesTrendsV2Command_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: GetResourcesTrendsV2Request;
+            output: GetResourcesTrendsV2Response;
+        };
+        sdk: {
+            input: GetResourcesTrendsV2CommandInput;
+            output: GetResourcesTrendsV2CommandOutput;
+        };
+    };
+}

package/dist-types/commands/ListConnectorsV2Command.d.ts

@@ -27,7 +27,7 @@ declare const ListConnectorsV2Command_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Grants permission to retrieve a list of connectorsV2 and their metadata for the calling account. This API is in preview release and subject to change.</p>
+ * <p>Grants permission to retrieve a list of connectorsV2 and their metadata for the calling account. This API is in public preview and subject to change.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/ListStandardsControlAssociationsCommand.d.ts

@@ -1,6 +1,7 @@
 import { Command as $Command } from "@smithy/smithy-client";
 import { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import { ListStandardsControlAssociationsRequest, ListStandardsControlAssociationsResponse } from "../models/models_2";
+import { ListStandardsControlAssociationsRequest } from "../models/models_2";
+import { ListStandardsControlAssociationsResponse } from "../models/models_3";
 import { SecurityHubClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecurityHubClient";
 /**
  * @public

package/dist-types/commands/ListTagsForResourceCommand.d.ts

@@ -1,6 +1,6 @@
 import { Command as $Command } from "@smithy/smithy-client";
 import { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import { ListTagsForResourceRequest, ListTagsForResourceResponse } from "../models/models_2";
+import { ListTagsForResourceRequest, ListTagsForResourceResponse } from "../models/models_3";
 import { SecurityHubClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecurityHubClient";
 /**
  * @public

package/dist-types/commands/StartConfigurationPolicyAssociationCommand.d.ts

@@ -1,6 +1,6 @@
 import { Command as $Command } from "@smithy/smithy-client";
 import { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import { StartConfigurationPolicyAssociationRequest, StartConfigurationPolicyAssociationResponse } from "../models/models_2";
+import { StartConfigurationPolicyAssociationRequest, StartConfigurationPolicyAssociationResponse } from "../models/models_3";
 import { SecurityHubClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecurityHubClient";
 /**
  * @public

package/dist-types/commands/StartConfigurationPolicyDisassociationCommand.d.ts

@@ -1,6 +1,6 @@
 import { Command as $Command } from "@smithy/smithy-client";
 import { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import { StartConfigurationPolicyDisassociationRequest, StartConfigurationPolicyDisassociationResponse } from "../models/models_2";
+import { StartConfigurationPolicyDisassociationRequest, StartConfigurationPolicyDisassociationResponse } from "../models/models_3";
 import { SecurityHubClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecurityHubClient";
 /**
  * @public

package/dist-types/commands/TagResourceCommand.d.ts

@@ -1,6 +1,6 @@
 import { Command as $Command } from "@smithy/smithy-client";
 import { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import { TagResourceRequest, TagResourceResponse } from "../models/models_2";
+import { TagResourceRequest, TagResourceResponse } from "../models/models_3";
 import { SecurityHubClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecurityHubClient";
 /**
  * @public

package/dist-types/commands/UpdateConnectorV2Command.d.ts

@@ -27,7 +27,7 @@ declare const UpdateConnectorV2Command_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Grants permission to update a connectorV2 based on its id and input parameters. This API is in preview release and subject to change.</p>
+ * <p>Grants permission to update a connectorV2 based on its id and input parameters. This API is in public preview and subject to change.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/index.d.ts

@@ -63,6 +63,7 @@ export * from "./GetFindingAggregatorCommand";
 export * from "./GetFindingHistoryCommand";
 export * from "./GetFindingStatisticsV2Command";
 export * from "./GetFindingsCommand";
+export * from "./GetFindingsTrendsV2Command";
 export * from "./GetFindingsV2Command";
 export * from "./GetInsightResultsCommand";
 export * from "./GetInsightsCommand";
@@ -70,6 +71,7 @@ export * from "./GetInvitationsCountCommand";
 export * from "./GetMasterAccountCommand";
 export * from "./GetMembersCommand";
 export * from "./GetResourcesStatisticsV2Command";
+export * from "./GetResourcesTrendsV2Command";
 export * from "./GetResourcesV2Command";
 export * from "./GetSecurityControlDefinitionCommand";
 export * from "./InviteMembersCommand";

package/dist-types/models/enums.d.ts

@@ -842,6 +842,26 @@ export declare const FindingHistoryUpdateSourceType: {
  * @public
  */
 export type FindingHistoryUpdateSourceType = (typeof FindingHistoryUpdateSourceType)[keyof typeof FindingHistoryUpdateSourceType];
+/**
+ * @public
+ * @enum
+ */
+export declare const FindingsTrendsStringField: {
+    readonly ACCOUNT_ID: "account_id";
+    readonly COMPLIANCE_CONTROL: "finding_control_id";
+    readonly COMPLIANCE_STATUS: "finding_compliance_status";
+    readonly CVE_ID: "finding_cve_ids";
+    readonly FINDING_ACTIVITY_NAME: "finding_activity_name";
+    readonly FINDING_CLASS: "finding_class_name";
+    readonly FINDING_STATUS: "finding_status";
+    readonly FINDING_TYPE: "finding_types";
+    readonly PROVIDER_NAME: "finding_provider";
+    readonly REGION: "region";
+};
+/**
+ * @public
+ */
+export type FindingsTrendsStringField = (typeof FindingsTrendsStringField)[keyof typeof FindingsTrendsStringField];
 /**
  * @public
  * @enum
@@ -885,6 +905,19 @@ export declare const GroupByField: {
  * @public
  */
 export type GroupByField = (typeof GroupByField)[keyof typeof GroupByField];
+/**
+ * @public
+ * @enum
+ */
+export declare const GranularityField: {
+    readonly DAILY: "Daily";
+    readonly MONTHLY: "Monthly";
+    readonly WEEKLY: "Weekly";
+};
+/**
+ * @public
+ */
+export type GranularityField = (typeof GranularityField)[keyof typeof GranularityField];
 /**
  * @public
  * @enum
@@ -962,6 +995,20 @@ export declare const ResourceGroupByField: {
  * @public
  */
 export type ResourceGroupByField = (typeof ResourceGroupByField)[keyof typeof ResourceGroupByField];
+/**
+ * @public
+ * @enum
+ */
+export declare const ResourcesTrendsStringField: {
+    readonly ACCOUNT_ID: "account_id";
+    readonly REGION: "region";
+    readonly RESOURCE_CATEGORY: "resource_category";
+    readonly RESOURCE_TYPE: "resource_type";
+};
+/**
+ * @public
+ */
+export type ResourcesTrendsStringField = (typeof ResourcesTrendsStringField)[keyof typeof ResourcesTrendsStringField];
 /**
  * @public
  * @enum