@aws-sdk/client-guardduty 3.830.0 → 3.835.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,8 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
2
  import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
3
  import { GuardDutyClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../GuardDutyClient";
4
- import { GetFindingsRequest, GetFindingsResponse } from "../models/models_0";
4
+ import { GetFindingsRequest } from "../models/models_0";
5
+ import { GetFindingsResponse } from "../models/models_1";
5
6
  /**
6
7
  * @public
7
8
  */
@@ -834,6 +835,11 @@ declare const GetFindingsCommand_base: {
834
835
  * // CreatedTime: new Date("TIMESTAMP"),
835
836
  * // Issuer: "STRING_VALUE",
836
837
  * // },
838
+ * // Process: { // ActorProcess
839
+ * // Name: "STRING_VALUE", // required
840
+ * // Path: "STRING_VALUE", // required
841
+ * // Sha256: "STRING_VALUE",
842
+ * // },
837
843
  * // },
838
844
  * // ],
839
845
  * // Resources: [ // Resources
@@ -841,7 +847,7 @@ declare const GetFindingsCommand_base: {
841
847
  * // Uid: "STRING_VALUE", // required
842
848
  * // Name: "STRING_VALUE",
843
849
  * // AccountId: "STRING_VALUE",
844
- * // ResourceType: "EC2_INSTANCE" || "EC2_NETWORK_INTERFACE" || "S3_BUCKET" || "S3_OBJECT" || "ACCESS_KEY", // required
850
+ * // ResourceType: "EC2_INSTANCE" || "EC2_NETWORK_INTERFACE" || "S3_BUCKET" || "S3_OBJECT" || "ACCESS_KEY" || "EKS_CLUSTER" || "KUBERNETES_WORKLOAD" || "CONTAINER", // required
845
851
  * // Region: "STRING_VALUE",
846
852
  * // Service: "STRING_VALUE",
847
853
  * // CloudPartition: "STRING_VALUE",
@@ -917,6 +923,26 @@ declare const GetFindingsCommand_base: {
917
923
  * // Key: "STRING_VALUE",
918
924
  * // VersionId: "STRING_VALUE",
919
925
  * // },
926
+ * // EksCluster: { // EksCluster
927
+ * // Arn: "STRING_VALUE",
928
+ * // CreatedAt: new Date("TIMESTAMP"),
929
+ * // Status: "CREATING" || "ACTIVE" || "DELETING" || "FAILED" || "UPDATING" || "PENDING",
930
+ * // VpcId: "STRING_VALUE",
931
+ * // Ec2InstanceUids: [ // Ec2InstanceUids
932
+ * // "STRING_VALUE",
933
+ * // ],
934
+ * // },
935
+ * // KubernetesWorkload: { // KubernetesWorkload
936
+ * // ContainerUids: [ // ContainerUids
937
+ * // "STRING_VALUE",
938
+ * // ],
939
+ * // Namespace: "STRING_VALUE",
940
+ * // KubernetesResourcesTypes: "PODS" || "JOBS" || "CRONJOBS" || "DEPLOYMENTS" || "DAEMONSETS" || "STATEFULSETS" || "REPLICASETS" || "REPLICATIONCONTROLLERS",
941
+ * // },
942
+ * // Container: { // ContainerFindingResource
943
+ * // Image: "STRING_VALUE", // required
944
+ * // ImageUid: "STRING_VALUE",
945
+ * // },
920
946
  * // },
921
947
  * // },
922
948
  * // ],
@@ -944,7 +970,7 @@ declare const GetFindingsCommand_base: {
944
970
  * // Signals: [ // Signals // required
945
971
  * // { // Signal
946
972
  * // Uid: "STRING_VALUE", // required
947
- * // Type: "FINDING" || "CLOUD_TRAIL" || "S3_DATA_EVENTS", // required
973
+ * // Type: "FINDING" || "CLOUD_TRAIL" || "S3_DATA_EVENTS" || "EKS_AUDIT_LOGS" || "FLOW_LOGS" || "DNS_LOGS" || "RUNTIME_MONITORING", // required
948
974
  * // Description: "STRING_VALUE",
949
975
  * // Name: "STRING_VALUE", // required
950
976
  * // CreatedAt: new Date("TIMESTAMP"), // required
@@ -964,7 +990,7 @@ declare const GetFindingsCommand_base: {
964
990
  * // ],
965
991
  * // SignalIndicators: [ // Indicators
966
992
  * // { // Indicator
967
- * // Key: "SUSPICIOUS_USER_AGENT" || "SUSPICIOUS_NETWORK" || "MALICIOUS_IP" || "TOR_IP" || "ATTACK_TACTIC" || "HIGH_RISK_API" || "ATTACK_TECHNIQUE" || "UNUSUAL_API_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_USER", // required
993
+ * // Key: "SUSPICIOUS_USER_AGENT" || "SUSPICIOUS_NETWORK" || "MALICIOUS_IP" || "TOR_IP" || "ATTACK_TACTIC" || "HIGH_RISK_API" || "ATTACK_TECHNIQUE" || "UNUSUAL_API_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_USER" || "SUSPICIOUS_PROCESS" || "MALICIOUS_DOMAIN" || "MALICIOUS_PROCESS" || "CRYPTOMINING_IP" || "CRYPTOMINING_DOMAIN" || "CRYPTOMINING_PROCESS", // required
968
994
  * // Values: [ // IndicatorValues
969
995
  * // "STRING_VALUE",
970
996
  * // ],
@@ -975,13 +1001,16 @@ declare const GetFindingsCommand_base: {
975
1001
  * // ],
976
1002
  * // SequenceIndicators: [
977
1003
  * // {
978
- * // Key: "SUSPICIOUS_USER_AGENT" || "SUSPICIOUS_NETWORK" || "MALICIOUS_IP" || "TOR_IP" || "ATTACK_TACTIC" || "HIGH_RISK_API" || "ATTACK_TECHNIQUE" || "UNUSUAL_API_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_USER", // required
1004
+ * // Key: "SUSPICIOUS_USER_AGENT" || "SUSPICIOUS_NETWORK" || "MALICIOUS_IP" || "TOR_IP" || "ATTACK_TACTIC" || "HIGH_RISK_API" || "ATTACK_TECHNIQUE" || "UNUSUAL_API_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_USER" || "SUSPICIOUS_PROCESS" || "MALICIOUS_DOMAIN" || "MALICIOUS_PROCESS" || "CRYPTOMINING_IP" || "CRYPTOMINING_DOMAIN" || "CRYPTOMINING_PROCESS", // required
979
1005
  * // Values: [
980
1006
  * // "STRING_VALUE",
981
1007
  * // ],
982
1008
  * // Title: "STRING_VALUE",
983
1009
  * // },
984
1010
  * // ],
1011
+ * // AdditionalSequenceTypes: [ // AdditionalSequenceTypes
1012
+ * // "STRING_VALUE",
1013
+ * // ],
985
1014
  * // },
986
1015
  * // },
987
1016
  * // MalwareScanDetails: { // MalwareScanDetails
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
2
  import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
3
  import { GuardDutyClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../GuardDutyClient";
4
- import { GetFindingsStatisticsRequest, GetFindingsStatisticsResponse } from "../models/models_0";
4
+ import { GetFindingsStatisticsRequest, GetFindingsStatisticsResponse } from "../models/models_1";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
2
  import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
3
  import { GuardDutyClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../GuardDutyClient";
4
- import { GetInvitationsCountRequest, GetInvitationsCountResponse } from "../models/models_0";
4
+ import { GetInvitationsCountRequest, GetInvitationsCountResponse } from "../models/models_1";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -8,7 +8,7 @@ export interface ClientInputEndpointParameters {
8
8
  useFipsEndpoint?: boolean | undefined | Provider<boolean | undefined>;
9
9
  endpoint?: string | Provider<string> | Endpoint | Provider<Endpoint> | EndpointV2 | Provider<EndpointV2>;
10
10
  }
11
- export type ClientResolvedEndpointParameters = ClientInputEndpointParameters & {
11
+ export type ClientResolvedEndpointParameters = Omit<ClientInputEndpointParameters, "endpoint"> & {
12
12
  defaultSigningName: string;
13
13
  };
14
14
  export declare const resolveClientEndpointParameters: <T>(options: T & ClientInputEndpointParameters) => T & ClientResolvedEndpointParameters;
@@ -215,6 +215,34 @@ export interface AccountDetail {
215
215
  AccountId: string | undefined;
216
216
  /**
217
217
  * <p>The email address of the member account.</p>
218
+ * <p>The rules for a valid email address:</p>
219
+ * <ul>
220
+ * <li>
221
+ * <p>The email address must be a minimum of 6 and a maximum of 64 characters long.</p>
222
+ * </li>
223
+ * <li>
224
+ * <p>All characters must be 7-bit ASCII characters.</p>
225
+ * </li>
226
+ * <li>
227
+ * <p>There must be one and only one @ symbol, which separates the local name from the domain name.</p>
228
+ * </li>
229
+ * <li>
230
+ * <p>The local name can't contain any of the following characters:</p>
231
+ * <p>whitespace, " ' ( ) < > [ ] : ' , \ | % &</p>
232
+ * </li>
233
+ * <li>
234
+ * <p>The local name can't begin with a dot (.).</p>
235
+ * </li>
236
+ * <li>
237
+ * <p>The domain name can consist of only the characters [a-z], [A-Z], [0-9], hyphen (-), or dot (.).</p>
238
+ * </li>
239
+ * <li>
240
+ * <p>The domain name can't begin or end with a dot (.) or hyphen (-).</p>
241
+ * </li>
242
+ * <li>
243
+ * <p>The domain name must contain at least one dot. </p>
244
+ * </li>
245
+ * </ul>
218
246
  * @public
219
247
  */
220
248
  Email: string | undefined;
@@ -1006,6 +1034,29 @@ export interface Action {
1006
1034
  */
1007
1035
  KubernetesRoleDetails?: KubernetesRoleDetails | undefined;
1008
1036
  }
1037
+ /**
1038
+ * <p>Contains information about a process involved in a GuardDuty finding, including process identification,
1039
+ * execution details, and file information.</p>
1040
+ * @public
1041
+ */
1042
+ export interface ActorProcess {
1043
+ /**
1044
+ * <p>The name of the process as it appears in the system.</p>
1045
+ * @public
1046
+ */
1047
+ Name: string | undefined;
1048
+ /**
1049
+ * <p>The full file path to the process executable on the system.</p>
1050
+ * @public
1051
+ */
1052
+ Path: string | undefined;
1053
+ /**
1054
+ * <p>The SHA256 hash of the process executable file, which can be used for identification
1055
+ * and verification purposes.</p>
1056
+ * @public
1057
+ */
1058
+ Sha256?: string | undefined;
1059
+ }
1009
1060
  /**
1010
1061
  * @public
1011
1062
  * @enum
@@ -1098,6 +1149,13 @@ export interface Actor {
1098
1149
  * @public
1099
1150
  */
1100
1151
  Session?: Session | undefined;
1152
+ /**
1153
+ * <p>Contains information about the process associated with the threat actor.
1154
+ * This includes details such as process name, path, execution time, and
1155
+ * unique identifiers that help track the actor's activities within the system.</p>
1156
+ * @public
1157
+ */
1158
+ Process?: ActorProcess | undefined;
1101
1159
  }
1102
1160
  /**
1103
1161
  * <p>Information about the installed EKS add-on (GuardDuty security agent).</p>
@@ -1383,6 +1441,22 @@ export interface CloudTrailConfigurationResult {
1383
1441
  */
1384
1442
  Status: DataSourceStatus | undefined;
1385
1443
  }
1444
+ /**
1445
+ * @public
1446
+ * @enum
1447
+ */
1448
+ export declare const ClusterStatus: {
1449
+ readonly ACTIVE: "ACTIVE";
1450
+ readonly CREATING: "CREATING";
1451
+ readonly DELETING: "DELETING";
1452
+ readonly FAILED: "FAILED";
1453
+ readonly PENDING: "PENDING";
1454
+ readonly UPDATING: "UPDATING";
1455
+ };
1456
+ /**
1457
+ * @public
1458
+ */
1459
+ export type ClusterStatus = (typeof ClusterStatus)[keyof typeof ClusterStatus];
1386
1460
  /**
1387
1461
  * <p>Contains information about the condition.</p>
1388
1462
  * @public
@@ -1572,6 +1646,25 @@ export interface Container {
1572
1646
  */
1573
1647
  SecurityContext?: SecurityContext | undefined;
1574
1648
  }
1649
+ /**
1650
+ * <p>Contains information about container resources involved in a GuardDuty finding.
1651
+ * This structure provides details about containers that were identified as part of
1652
+ * suspicious or malicious activity.</p>
1653
+ * @public
1654
+ */
1655
+ export interface ContainerFindingResource {
1656
+ /**
1657
+ * <p>The container image information, including the image name and tag used to run the container
1658
+ * that was involved in the finding.</p>
1659
+ * @public
1660
+ */
1661
+ Image: string | undefined;
1662
+ /**
1663
+ * <p>The unique ID associated with the container image.</p>
1664
+ * @public
1665
+ */
1666
+ ImageUid?: string | undefined;
1667
+ }
1575
1668
  /**
1576
1669
  * <p>Contains information about the Amazon EC2 instance that is running
1577
1670
  * the Amazon ECS container.</p>
@@ -3486,10 +3579,6 @@ export interface FilterCriterion {
3486
3579
  /**
3487
3580
  * <p>An enum value representing possible scan properties to match with given scan
3488
3581
  * entries.</p>
3489
- * <note>
3490
- * <p>Replace the enum value <code>CLUSTER_NAME</code> with <code>EKS_CLUSTER_NAME</code>.
3491
- * <code>CLUSTER_NAME</code> has been deprecated.</p>
3492
- * </note>
3493
3582
  * @public
3494
3583
  */
3495
3584
  CriterionKey?: CriterionKey | undefined;
@@ -4444,6 +4533,78 @@ export interface Ec2NetworkInterface {
4444
4533
  */
4445
4534
  VpcId?: string | undefined;
4446
4535
  }
4536
+ /**
4537
+ * <p>Contains information about the Amazon EKS cluster involved in a GuardDuty finding,
4538
+ * including cluster identification, status, and network configuration.</p>
4539
+ * @public
4540
+ */
4541
+ export interface EksCluster {
4542
+ /**
4543
+ * <p>The Amazon Resource Name (ARN) that uniquely identifies the Amazon EKS cluster involved in the finding.</p>
4544
+ * @public
4545
+ */
4546
+ Arn?: string | undefined;
4547
+ /**
4548
+ * <p>The timestamp indicating when the Amazon EKS cluster was created, in UTC format.</p>
4549
+ * @public
4550
+ */
4551
+ CreatedAt?: Date | undefined;
4552
+ /**
4553
+ * <p>The current status of the Amazon EKS cluster.</p>
4554
+ * @public
4555
+ */
4556
+ Status?: ClusterStatus | undefined;
4557
+ /**
4558
+ * <p>The ID of the Amazon Virtual Private Cloud (Amazon VPC) associated with the Amazon EKS cluster.</p>
4559
+ * @public
4560
+ */
4561
+ VpcId?: string | undefined;
4562
+ /**
4563
+ * <p>A list of unique identifiers for the Amazon EC2 instances that serve as worker nodes in the Amazon EKS cluster.</p>
4564
+ * @public
4565
+ */
4566
+ Ec2InstanceUids?: string[] | undefined;
4567
+ }
4568
+ /**
4569
+ * @public
4570
+ * @enum
4571
+ */
4572
+ export declare const KubernetesResourcesTypes: {
4573
+ readonly CRONJOBS: "CRONJOBS";
4574
+ readonly DAEMONSETS: "DAEMONSETS";
4575
+ readonly DEPLOYMENTS: "DEPLOYMENTS";
4576
+ readonly JOBS: "JOBS";
4577
+ readonly PODS: "PODS";
4578
+ readonly REPLICASETS: "REPLICASETS";
4579
+ readonly REPLICATIONCONTROLLERS: "REPLICATIONCONTROLLERS";
4580
+ readonly STATEFULSETS: "STATEFULSETS";
4581
+ };
4582
+ /**
4583
+ * @public
4584
+ */
4585
+ export type KubernetesResourcesTypes = (typeof KubernetesResourcesTypes)[keyof typeof KubernetesResourcesTypes];
4586
+ /**
4587
+ * <p>Contains information about Kubernetes workloads involved in a GuardDuty finding,
4588
+ * including pods, deployments, and other Kubernetes resources.</p>
4589
+ * @public
4590
+ */
4591
+ export interface KubernetesWorkload {
4592
+ /**
4593
+ * <p>A list of unique identifiers for the containers that are part of the Kubernetes workload.</p>
4594
+ * @public
4595
+ */
4596
+ ContainerUids?: string[] | undefined;
4597
+ /**
4598
+ * <p>The Kubernetes namespace in which the workload is running, providing logical isolation within the cluster.</p>
4599
+ * @public
4600
+ */
4601
+ Namespace?: string | undefined;
4602
+ /**
4603
+ * <p>The types of Kubernetes resources involved in the workload.</p>
4604
+ * @public
4605
+ */
4606
+ KubernetesResourcesTypes?: KubernetesResourcesTypes | undefined;
4607
+ }
4447
4608
  /**
4448
4609
  * @public
4449
4610
  * @enum
@@ -4621,6 +4782,24 @@ export interface ResourceData {
4621
4782
  * @public
4622
4783
  */
4623
4784
  S3Object?: S3Object | undefined;
4785
+ /**
4786
+ * <p>Contains detailed information about the Amazon EKS cluster associated with the activity that
4787
+ * prompted GuardDuty to generate a finding.</p>
4788
+ * @public
4789
+ */
4790
+ EksCluster?: EksCluster | undefined;
4791
+ /**
4792
+ * <p>Contains detailed information about the Kubernetes workload associated with the activity that
4793
+ * prompted GuardDuty to generate a finding.</p>
4794
+ * @public
4795
+ */
4796
+ KubernetesWorkload?: KubernetesWorkload | undefined;
4797
+ /**
4798
+ * <p>Contains detailed information about the container associated with the activity that
4799
+ * prompted GuardDuty to generate a finding.</p>
4800
+ * @public
4801
+ */
4802
+ Container?: ContainerFindingResource | undefined;
4624
4803
  }
4625
4804
  /**
4626
4805
  * @public
@@ -4628,8 +4807,11 @@ export interface ResourceData {
4628
4807
  */
4629
4808
  export declare const FindingResourceType: {
4630
4809
  readonly ACCESS_KEY: "ACCESS_KEY";
4810
+ readonly CONTAINER: "CONTAINER";
4631
4811
  readonly EC2_INSTANCE: "EC2_INSTANCE";
4632
4812
  readonly EC2_NETWORK_INTERFACE: "EC2_NETWORK_INTERFACE";
4813
+ readonly EKS_CLUSTER: "EKS_CLUSTER";
4814
+ readonly KUBERNETES_WORKLOAD: "KUBERNETES_WORKLOAD";
4633
4815
  readonly S3_BUCKET: "S3_BUCKET";
4634
4816
  readonly S3_OBJECT: "S3_OBJECT";
4635
4817
  };
@@ -4712,9 +4894,15 @@ export interface ResourceV2 {
4712
4894
  export declare const IndicatorType: {
4713
4895
  readonly ATTACK_TACTIC: "ATTACK_TACTIC";
4714
4896
  readonly ATTACK_TECHNIQUE: "ATTACK_TECHNIQUE";
4897
+ readonly CRYPTOMINING_DOMAIN: "CRYPTOMINING_DOMAIN";
4898
+ readonly CRYPTOMINING_IP: "CRYPTOMINING_IP";
4899
+ readonly CRYPTOMINING_PROCESS: "CRYPTOMINING_PROCESS";
4715
4900
  readonly HIGH_RISK_API: "HIGH_RISK_API";
4901
+ readonly MALICIOUS_DOMAIN: "MALICIOUS_DOMAIN";
4716
4902
  readonly MALICIOUS_IP: "MALICIOUS_IP";
4903
+ readonly MALICIOUS_PROCESS: "MALICIOUS_PROCESS";
4717
4904
  readonly SUSPICIOUS_NETWORK: "SUSPICIOUS_NETWORK";
4905
+ readonly SUSPICIOUS_PROCESS: "SUSPICIOUS_PROCESS";
4718
4906
  readonly SUSPICIOUS_USER_AGENT: "SUSPICIOUS_USER_AGENT";
4719
4907
  readonly TOR_IP: "TOR_IP";
4720
4908
  readonly UNUSUAL_API_FOR_ACCOUNT: "UNUSUAL_API_FOR_ACCOUNT";
@@ -4756,7 +4944,11 @@ export interface Indicator {
4756
4944
  */
4757
4945
  export declare const SignalType: {
4758
4946
  readonly CLOUD_TRAIL: "CLOUD_TRAIL";
4947
+ readonly DNS_LOGS: "DNS_LOGS";
4948
+ readonly EKS_AUDIT_LOGS: "EKS_AUDIT_LOGS";
4759
4949
  readonly FINDING: "FINDING";
4950
+ readonly FLOW_LOGS: "FLOW_LOGS";
4951
+ readonly RUNTIME_MONITORING: "RUNTIME_MONITORING";
4760
4952
  readonly S3_DATA_EVENTS: "S3_DATA_EVENTS";
4761
4953
  };
4762
4954
  /**
@@ -4905,6 +5097,12 @@ export interface Sequence {
4905
5097
  * @public
4906
5098
  */
4907
5099
  SequenceIndicators?: Indicator[] | undefined;
5100
+ /**
5101
+ * <p>Additional types of sequences that may be associated with the attack sequence finding,
5102
+ * providing further context about the nature of the detected threat.</p>
5103
+ * @public
5104
+ */
5105
+ AdditionalSequenceTypes?: string[] | undefined;
4908
5106
  }
4909
5107
  /**
4910
5108
  * <p>Contains information about the detected behavior.</p>
@@ -6667,7 +6865,11 @@ export interface Finding {
6667
6865
  */
6668
6866
  Partition?: string | undefined;
6669
6867
  /**
6670
- * <p>The Region where the finding was generated.</p>
6868
+ * <p>The Region where the finding was generated. For findings generated
6869
+ * from <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html#cloudtrail-concepts-global-service-events">Global Service Events</a>, the Region value in the finding might differ from the Region where
6870
+ * GuardDuty identifies the potential threat. For more information,
6871
+ * see <a href="https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_data-sources.html#cloudtrail_global">How GuardDuty
6872
+ * handles Amazon Web Services CloudTrail global events</a> in the <i>Amazon GuardDuty User Guide</i>.</p>
6671
6873
  * @public
6672
6874
  */
6673
6875
  Region: string | undefined;
@@ -7076,105 +7278,6 @@ export interface GetFindingsRequest {
7076
7278
  */
7077
7279
  SortCriteria?: SortCriteria | undefined;
7078
7280
  }
7079
- /**
7080
- * @public
7081
- */
7082
- export interface GetFindingsResponse {
7083
- /**
7084
- * <p>A list of findings.</p>
7085
- * @public
7086
- */
7087
- Findings: Finding[] | undefined;
7088
- }
7089
- /**
7090
- * @public
7091
- * @enum
7092
- */
7093
- export declare const GroupByType: {
7094
- readonly ACCOUNT: "ACCOUNT";
7095
- readonly DATE: "DATE";
7096
- readonly FINDING_TYPE: "FINDING_TYPE";
7097
- readonly RESOURCE: "RESOURCE";
7098
- readonly SEVERITY: "SEVERITY";
7099
- };
7100
- /**
7101
- * @public
7102
- */
7103
- export type GroupByType = (typeof GroupByType)[keyof typeof GroupByType];
7104
- /**
7105
- * @public
7106
- */
7107
- export interface GetFindingsStatisticsRequest {
7108
- /**
7109
- * <p>The ID of the detector whose findings statistics you
7110
- * want to retrieve.</p>
7111
- * <p>To find the <code>detectorId</code> in the current Region, see the
7112
- * Settings page in the GuardDuty console, or run the <a href="https://docs.aws.amazon.com/guardduty/latest/APIReference/API_ListDetectors.html">ListDetectors</a> API.</p>
7113
- * @public
7114
- */
7115
- DetectorId: string | undefined;
7116
- /**
7117
- * <p>The types of finding statistics to retrieve.</p>
7118
- *
7119
- * @deprecated
7120
- * @public
7121
- */
7122
- FindingStatisticTypes?: FindingStatisticType[] | undefined;
7123
- /**
7124
- * <p>Represents the criteria that is used for querying findings.</p>
7125
- * @public
7126
- */
7127
- FindingCriteria?: FindingCriteria | undefined;
7128
- /**
7129
- * <p>Displays the findings statistics grouped by one of the listed valid values.</p>
7130
- * @public
7131
- */
7132
- GroupBy?: GroupByType | undefined;
7133
- /**
7134
- * <p>Displays the sorted findings in the requested order. The default
7135
- * value of <code>orderBy</code> is <code>DESC</code>.</p>
7136
- * <p>You can use this parameter only with the <code>groupBy</code> parameter.</p>
7137
- * @public
7138
- */
7139
- OrderBy?: OrderBy | undefined;
7140
- /**
7141
- * <p>The maximum number of results to be returned in the response. The default value is 25.</p>
7142
- * <p>You can use this parameter only with the <code>groupBy</code> parameter.</p>
7143
- * @public
7144
- */
7145
- MaxResults?: number | undefined;
7146
- }
7147
- /**
7148
- * @public
7149
- */
7150
- export interface GetFindingsStatisticsResponse {
7151
- /**
7152
- * <p>The finding statistics object.</p>
7153
- * @public
7154
- */
7155
- FindingStatistics: FindingStatistics | undefined;
7156
- /**
7157
- * <p>The pagination parameter to be used on the next list operation to retrieve more items.</p>
7158
- * <p>This parameter is currently not supported.</p>
7159
- * @public
7160
- */
7161
- NextToken?: string | undefined;
7162
- }
7163
- /**
7164
- * @public
7165
- */
7166
- export interface GetInvitationsCountRequest {
7167
- }
7168
- /**
7169
- * @public
7170
- */
7171
- export interface GetInvitationsCountResponse {
7172
- /**
7173
- * <p>The number of received invitations.</p>
7174
- * @public
7175
- */
7176
- InvitationsCount?: number | undefined;
7177
- }
7178
7281
  /**
7179
7282
  * @internal
7180
7283
  */
@@ -7263,7 +7366,3 @@ export declare const ServiceFilterSensitiveLog: (obj: Service) => any;
7263
7366
  * @internal
7264
7367
  */
7265
7368
  export declare const FindingFilterSensitiveLog: (obj: Finding) => any;
7266
- /**
7267
- * @internal
7268
- */
7269
- export declare const GetFindingsResponseFilterSensitiveLog: (obj: GetFindingsResponse) => any;
@@ -1,4 +1,103 @@
1
- import { AccountFreeTrialInfo, AdminAccount, AutoEnableMembers, CoverageFilterCriteria, CoverageResource, CoverageSortCriteria, CreateProtectedResource, DataSource, DataSourceConfigurations, DataSourceConfigurationsResult, Destination, DestinationProperties, DetectorFeatureConfiguration, EbsSnapshotPreservation, FeatureStatus, Feedback, FilterAction, FindingCriteria, FindingPublishingFrequency, IpSetFormat, MalwareProtectionPlanActions, OrgFeature, OrgFeatureAdditionalConfiguration, OrgFeatureStatus, SortCriteria, ThreatIntelSetFormat, UnprocessedAccount } from "./models_0";
1
+ import { AccountFreeTrialInfo, AdminAccount, AutoEnableMembers, CoverageFilterCriteria, CoverageResource, CoverageSortCriteria, CreateProtectedResource, DataSource, DataSourceConfigurations, DataSourceConfigurationsResult, Destination, DestinationProperties, DetectorFeatureConfiguration, EbsSnapshotPreservation, FeatureStatus, Feedback, FilterAction, Finding, FindingCriteria, FindingPublishingFrequency, FindingStatistics, FindingStatisticType, IpSetFormat, MalwareProtectionPlanActions, OrderBy, OrgFeature, OrgFeatureAdditionalConfiguration, OrgFeatureStatus, SortCriteria, ThreatIntelSetFormat, UnprocessedAccount } from "./models_0";
2
+ /**
3
+ * @public
4
+ */
5
+ export interface GetFindingsResponse {
6
+ /**
7
+ * <p>A list of findings.</p>
8
+ * @public
9
+ */
10
+ Findings: Finding[] | undefined;
11
+ }
12
+ /**
13
+ * @public
14
+ * @enum
15
+ */
16
+ export declare const GroupByType: {
17
+ readonly ACCOUNT: "ACCOUNT";
18
+ readonly DATE: "DATE";
19
+ readonly FINDING_TYPE: "FINDING_TYPE";
20
+ readonly RESOURCE: "RESOURCE";
21
+ readonly SEVERITY: "SEVERITY";
22
+ };
23
+ /**
24
+ * @public
25
+ */
26
+ export type GroupByType = (typeof GroupByType)[keyof typeof GroupByType];
27
+ /**
28
+ * @public
29
+ */
30
+ export interface GetFindingsStatisticsRequest {
31
+ /**
32
+ * <p>The ID of the detector whose findings statistics you
33
+ * want to retrieve.</p>
34
+ * <p>To find the <code>detectorId</code> in the current Region, see the
35
+ * Settings page in the GuardDuty console, or run the <a href="https://docs.aws.amazon.com/guardduty/latest/APIReference/API_ListDetectors.html">ListDetectors</a> API.</p>
36
+ * @public
37
+ */
38
+ DetectorId: string | undefined;
39
+ /**
40
+ * <p>The types of finding statistics to retrieve.</p>
41
+ *
42
+ * @deprecated
43
+ * @public
44
+ */
45
+ FindingStatisticTypes?: FindingStatisticType[] | undefined;
46
+ /**
47
+ * <p>Represents the criteria that is used for querying findings.</p>
48
+ * @public
49
+ */
50
+ FindingCriteria?: FindingCriteria | undefined;
51
+ /**
52
+ * <p>Displays the findings statistics grouped by one of the listed valid values.</p>
53
+ * @public
54
+ */
55
+ GroupBy?: GroupByType | undefined;
56
+ /**
57
+ * <p>Displays the sorted findings in the requested order. The default
58
+ * value of <code>orderBy</code> is <code>DESC</code>.</p>
59
+ * <p>You can use this parameter only with the <code>groupBy</code> parameter.</p>
60
+ * @public
61
+ */
62
+ OrderBy?: OrderBy | undefined;
63
+ /**
64
+ * <p>The maximum number of results to be returned in the response. The default value is 25.</p>
65
+ * <p>You can use this parameter only with the <code>groupBy</code> parameter.</p>
66
+ * @public
67
+ */
68
+ MaxResults?: number | undefined;
69
+ }
70
+ /**
71
+ * @public
72
+ */
73
+ export interface GetFindingsStatisticsResponse {
74
+ /**
75
+ * <p>The finding statistics object.</p>
76
+ * @public
77
+ */
78
+ FindingStatistics: FindingStatistics | undefined;
79
+ /**
80
+ * <p>The pagination parameter to be used on the next list operation to retrieve more items.</p>
81
+ * <p>This parameter is currently not supported.</p>
82
+ * @public
83
+ */
84
+ NextToken?: string | undefined;
85
+ }
86
+ /**
87
+ * @public
88
+ */
89
+ export interface GetInvitationsCountRequest {
90
+ }
91
+ /**
92
+ * @public
93
+ */
94
+ export interface GetInvitationsCountResponse {
95
+ /**
96
+ * <p>The number of received invitations.</p>
97
+ * @public
98
+ */
99
+ InvitationsCount?: number | undefined;
100
+ }
2
101
  /**
3
102
  * @public
4
103
  */
@@ -2484,6 +2583,10 @@ export interface UpdateThreatIntelSetRequest {
2484
2583
  */
2485
2584
  export interface UpdateThreatIntelSetResponse {
2486
2585
  }
2586
+ /**
2587
+ * @internal
2588
+ */
2589
+ export declare const GetFindingsResponseFilterSensitiveLog: (obj: GetFindingsResponse) => any;
2487
2590
  /**
2488
2591
  * @internal
2489
2592
  */
@@ -5,7 +5,8 @@ import {
5
5
  ServiceInputTypes,
6
6
  ServiceOutputTypes,
7
7
  } from "../GuardDutyClient";
8
- import { GetFindingsRequest, GetFindingsResponse } from "../models/models_0";
8
+ import { GetFindingsRequest } from "../models/models_0";
9
+ import { GetFindingsResponse } from "../models/models_1";
9
10
  export { __MetadataBearer };
10
11
  export { $Command };
11
12
  export interface GetFindingsCommandInput extends GetFindingsRequest {}
@@ -8,7 +8,7 @@ import {
8
8
  import {
9
9
  GetFindingsStatisticsRequest,
10
10
  GetFindingsStatisticsResponse,
11
- } from "../models/models_0";
11
+ } from "../models/models_1";
12
12
  export { __MetadataBearer };
13
13
  export { $Command };
14
14
  export interface GetFindingsStatisticsCommandInput