@aws-sdk/client-securityhub 3.341.0 → 3.342.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.
Files changed (29) hide show
  1. package/dist-cjs/models/models_1.js +1 -37
  2. package/dist-cjs/models/models_2.js +37 -1
  3. package/dist-cjs/protocols/Aws_restJson1.js +12 -2
  4. package/dist-es/models/models_1.js +0 -35
  5. package/dist-es/models/models_2.js +35 -0
  6. package/dist-es/protocols/Aws_restJson1.js +11 -1
  7. package/dist-types/commands/BatchEnableStandardsCommand.d.ts +3 -3
  8. package/dist-types/commands/BatchGetSecurityControlsCommand.d.ts +39 -1
  9. package/dist-types/commands/BatchGetStandardsControlAssociationsCommand.d.ts +51 -1
  10. package/dist-types/commands/BatchImportFindingsCommand.d.ts +172 -1
  11. package/dist-types/commands/BatchUpdateFindingsCommand.d.ts +1 -1
  12. package/dist-types/commands/BatchUpdateStandardsControlAssociationsCommand.d.ts +41 -1
  13. package/dist-types/commands/CreateActionTargetCommand.d.ts +1 -1
  14. package/dist-types/commands/CreateFindingAggregatorCommand.d.ts +1 -1
  15. package/dist-types/commands/GetFindingsCommand.d.ts +171 -0
  16. package/dist-types/models/models_0.d.ts +551 -367
  17. package/dist-types/models/models_1.d.ts +6083 -6124
  18. package/dist-types/models/models_2.d.ts +841 -3
  19. package/dist-types/ts3.4/commands/BatchGetSecurityControlsCommand.d.ts +1 -1
  20. package/dist-types/ts3.4/commands/BatchGetStandardsControlAssociationsCommand.d.ts +1 -1
  21. package/dist-types/ts3.4/commands/BatchImportFindingsCommand.d.ts +1 -1
  22. package/dist-types/ts3.4/commands/BatchUpdateFindingsCommand.d.ts +1 -1
  23. package/dist-types/ts3.4/commands/BatchUpdateStandardsControlAssociationsCommand.d.ts +1 -1
  24. package/dist-types/ts3.4/commands/CreateActionTargetCommand.d.ts +1 -1
  25. package/dist-types/ts3.4/commands/CreateFindingAggregatorCommand.d.ts +1 -1
  26. package/dist-types/ts3.4/models/models_0.d.ts +98 -84
  27. package/dist-types/ts3.4/models/models_1.d.ts +175 -177
  28. package/dist-types/ts3.4/models/models_2.d.ts +178 -4
  29. package/package.json +28 -28
@@ -1,7 +1,7 @@
1
1
  import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
2
2
  import { Command as $Command } from "@aws-sdk/smithy-client";
3
3
  import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
4
- import { BatchUpdateStandardsControlAssociationsRequest, BatchUpdateStandardsControlAssociationsResponse } from "../models/models_1";
4
+ import { BatchUpdateStandardsControlAssociationsRequest, BatchUpdateStandardsControlAssociationsResponse } from "../models/models_2";
5
5
  import { SecurityHubClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecurityHubClient";
6
6
  /**
7
7
  * @public
@@ -84,6 +84,46 @@ export interface BatchUpdateStandardsControlAssociationsCommandOutput extends Ba
84
84
  * @throws {@link SecurityHubServiceException}
85
85
  * <p>Base exception class for all service exceptions from SecurityHub service.</p>
86
86
  *
87
+ * @example To update enablement status of a batch of controls
88
+ * ```javascript
89
+ * // The following example disables CloudWatch.12 in CIS AWS Foundations Benchmark v1.2.0. The example returns an error for CloudTrail.1 because an invalid standard ARN is provided.
90
+ * const input = {
91
+ * "StandardsControlAssociationUpdates": [
92
+ * {
93
+ * "AssociationStatus": "DISABLED",
94
+ * "SecurityControlId": "CloudTrail.1",
95
+ * "StandardsArn": "arn:aws:securityhub:::ruleset/sample-standard/v/1.1.0",
96
+ * "UpdatedReason": "Not relevant to environment"
97
+ * },
98
+ * {
99
+ * "AssociationStatus": "DISABLED",
100
+ * "SecurityControlId": "CloudWatch.12",
101
+ * "StandardsArn": "arn:aws:securityhub:::ruleset/cis-aws-foundations-benchmark/v/1.2.0",
102
+ * "UpdatedReason": "Not relevant to environment"
103
+ * }
104
+ * ]
105
+ * };
106
+ * const command = new BatchUpdateStandardsControlAssociationsCommand(input);
107
+ * const response = await client.send(command);
108
+ * /* response ==
109
+ * {
110
+ * "UnprocessedAssociationUpdates": [
111
+ * {
112
+ * "ErrorCode": "INVALID_INPUT",
113
+ * "ErrorReason": "Invalid Standards Arn: 'arn:aws:securityhub:::ruleset/sample-standard/v/1.1.0'",
114
+ * "StandardsControlAssociationUpdate": {
115
+ * "AssociationStatus": "DISABLED",
116
+ * "SecurityControlId": "CloudTrail.1",
117
+ * "StandardsArn": "arn:aws:securityhub:::ruleset/sample-standard/v/1.1.0",
118
+ * "UpdatedReason": "Test Reason"
119
+ * }
120
+ * }
121
+ * ]
122
+ * }
123
+ * *\/
124
+ * // example id: to-update-enablement-status-of-a-batch-of-controls-1683300378416
125
+ * ```
126
+ *
87
127
  */
88
128
  export declare class BatchUpdateStandardsControlAssociationsCommand extends $Command<BatchUpdateStandardsControlAssociationsCommandInput, BatchUpdateStandardsControlAssociationsCommandOutput, SecurityHubClientResolvedConfig> {
89
129
  readonly input: BatchUpdateStandardsControlAssociationsCommandInput;
@@ -1,7 +1,7 @@
1
1
  import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
2
2
  import { Command as $Command } from "@aws-sdk/smithy-client";
3
3
  import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
4
- import { CreateActionTargetRequest, CreateActionTargetResponse } from "../models/models_1";
4
+ import { CreateActionTargetRequest, CreateActionTargetResponse } from "../models/models_2";
5
5
  import { SecurityHubClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecurityHubClient";
6
6
  /**
7
7
  * @public
@@ -1,7 +1,7 @@
1
1
  import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
2
2
  import { Command as $Command } from "@aws-sdk/smithy-client";
3
3
  import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
4
- import { CreateFindingAggregatorRequest, CreateFindingAggregatorResponse } from "../models/models_1";
4
+ import { CreateFindingAggregatorRequest, CreateFindingAggregatorResponse } from "../models/models_2";
5
5
  import { SecurityHubClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecurityHubClient";
6
6
  /**
7
7
  * @public
@@ -3828,6 +3828,177 @@ export interface GetFindingsCommandOutput extends GetFindingsResponse, __Metadat
3828
3828
  * // ],
3829
3829
  * // VpcId: "STRING_VALUE",
3830
3830
  * // },
3831
+ * // AwsAmazonMqBroker: { // AwsAmazonMqBrokerDetails
3832
+ * // AuthenticationStrategy: "STRING_VALUE",
3833
+ * // AutoMinorVersionUpgrade: true || false,
3834
+ * // BrokerArn: "STRING_VALUE",
3835
+ * // BrokerName: "STRING_VALUE",
3836
+ * // DeploymentMode: "STRING_VALUE",
3837
+ * // EncryptionOptions: { // AwsAmazonMqBrokerEncryptionOptionsDetails
3838
+ * // KmsKeyId: "STRING_VALUE",
3839
+ * // UseAwsOwnedKey: true || false,
3840
+ * // },
3841
+ * // EngineType: "STRING_VALUE",
3842
+ * // EngineVersion: "STRING_VALUE",
3843
+ * // HostInstanceType: "STRING_VALUE",
3844
+ * // BrokerId: "STRING_VALUE",
3845
+ * // LdapServerMetadata: { // AwsAmazonMqBrokerLdapServerMetadataDetails
3846
+ * // Hosts: "<StringList>",
3847
+ * // RoleBase: "STRING_VALUE",
3848
+ * // RoleName: "STRING_VALUE",
3849
+ * // RoleSearchMatching: "STRING_VALUE",
3850
+ * // RoleSearchSubtree: true || false,
3851
+ * // ServiceAccountUsername: "STRING_VALUE",
3852
+ * // UserBase: "STRING_VALUE",
3853
+ * // UserRoleName: "STRING_VALUE",
3854
+ * // UserSearchMatching: "STRING_VALUE",
3855
+ * // UserSearchSubtree: true || false,
3856
+ * // },
3857
+ * // Logs: { // AwsAmazonMqBrokerLogsDetails
3858
+ * // Audit: true || false,
3859
+ * // General: true || false,
3860
+ * // AuditLogGroup: "STRING_VALUE",
3861
+ * // GeneralLogGroup: "STRING_VALUE",
3862
+ * // Pending: { // AwsAmazonMqBrokerLogsPendingDetails
3863
+ * // Audit: true || false,
3864
+ * // General: true || false,
3865
+ * // },
3866
+ * // },
3867
+ * // MaintenanceWindowStartTime: { // AwsAmazonMqBrokerMaintenanceWindowStartTimeDetails
3868
+ * // DayOfWeek: "STRING_VALUE",
3869
+ * // TimeOfDay: "STRING_VALUE",
3870
+ * // TimeZone: "STRING_VALUE",
3871
+ * // },
3872
+ * // PubliclyAccessible: true || false,
3873
+ * // SecurityGroups: "<StringList>",
3874
+ * // StorageType: "STRING_VALUE",
3875
+ * // SubnetIds: "<StringList>",
3876
+ * // Users: [ // AwsAmazonMqBrokerUsersList
3877
+ * // { // AwsAmazonMqBrokerUsersDetails
3878
+ * // PendingChange: "STRING_VALUE",
3879
+ * // Username: "STRING_VALUE",
3880
+ * // },
3881
+ * // ],
3882
+ * // },
3883
+ * // AwsAppSyncGraphQlApi: { // AwsAppSyncGraphQlApiDetails
3884
+ * // ApiId: "STRING_VALUE",
3885
+ * // Id: "STRING_VALUE",
3886
+ * // OpenIdConnectConfig: { // AwsAppSyncGraphQlApiOpenIdConnectConfigDetails
3887
+ * // AuthTtL: Number("long"),
3888
+ * // ClientId: "STRING_VALUE",
3889
+ * // IatTtL: Number("long"),
3890
+ * // Issuer: "STRING_VALUE",
3891
+ * // },
3892
+ * // Name: "STRING_VALUE",
3893
+ * // LambdaAuthorizerConfig: { // AwsAppSyncGraphQlApiLambdaAuthorizerConfigDetails
3894
+ * // AuthorizerResultTtlInSeconds: Number("int"),
3895
+ * // AuthorizerUri: "STRING_VALUE",
3896
+ * // IdentityValidationExpression: "STRING_VALUE",
3897
+ * // },
3898
+ * // XrayEnabled: true || false,
3899
+ * // Arn: "STRING_VALUE",
3900
+ * // UserPoolConfig: { // AwsAppSyncGraphQlApiUserPoolConfigDetails
3901
+ * // AppIdClientRegex: "STRING_VALUE",
3902
+ * // AwsRegion: "STRING_VALUE",
3903
+ * // DefaultAction: "STRING_VALUE",
3904
+ * // UserPoolId: "STRING_VALUE",
3905
+ * // },
3906
+ * // AuthenticationType: "STRING_VALUE",
3907
+ * // LogConfig: { // AwsAppSyncGraphQlApiLogConfigDetails
3908
+ * // CloudWatchLogsRoleArn: "STRING_VALUE",
3909
+ * // ExcludeVerboseContent: true || false,
3910
+ * // FieldLogLevel: "STRING_VALUE",
3911
+ * // },
3912
+ * // AdditionalAuthenticationProviders: [ // AwsAppSyncGraphQlApiAdditionalAuthenticationProvidersList
3913
+ * // { // AwsAppSyncGraphQlApiAdditionalAuthenticationProvidersDetails
3914
+ * // AuthenticationType: "STRING_VALUE",
3915
+ * // LambdaAuthorizerConfig: {
3916
+ * // AuthorizerResultTtlInSeconds: Number("int"),
3917
+ * // AuthorizerUri: "STRING_VALUE",
3918
+ * // IdentityValidationExpression: "STRING_VALUE",
3919
+ * // },
3920
+ * // OpenIdConnectConfig: {
3921
+ * // AuthTtL: Number("long"),
3922
+ * // ClientId: "STRING_VALUE",
3923
+ * // IatTtL: Number("long"),
3924
+ * // Issuer: "STRING_VALUE",
3925
+ * // },
3926
+ * // UserPoolConfig: {
3927
+ * // AppIdClientRegex: "STRING_VALUE",
3928
+ * // AwsRegion: "STRING_VALUE",
3929
+ * // DefaultAction: "STRING_VALUE",
3930
+ * // UserPoolId: "STRING_VALUE",
3931
+ * // },
3932
+ * // },
3933
+ * // ],
3934
+ * // WafWebAclArn: "STRING_VALUE",
3935
+ * // },
3936
+ * // AwsEventSchemasRegistry: { // AwsEventSchemasRegistryDetails
3937
+ * // Description: "STRING_VALUE",
3938
+ * // RegistryArn: "STRING_VALUE",
3939
+ * // RegistryName: "STRING_VALUE",
3940
+ * // },
3941
+ * // AwsGuardDutyDetector: { // AwsGuardDutyDetectorDetails
3942
+ * // DataSources: { // AwsGuardDutyDetectorDataSourcesDetails
3943
+ * // CloudTrail: { // AwsGuardDutyDetectorDataSourcesCloudTrailDetails
3944
+ * // Status: "STRING_VALUE",
3945
+ * // },
3946
+ * // DnsLogs: { // AwsGuardDutyDetectorDataSourcesDnsLogsDetails
3947
+ * // Status: "STRING_VALUE",
3948
+ * // },
3949
+ * // FlowLogs: { // AwsGuardDutyDetectorDataSourcesFlowLogsDetails
3950
+ * // Status: "STRING_VALUE",
3951
+ * // },
3952
+ * // Kubernetes: { // AwsGuardDutyDetectorDataSourcesKubernetesDetails
3953
+ * // AuditLogs: { // AwsGuardDutyDetectorDataSourcesKubernetesAuditLogsDetails
3954
+ * // Status: "STRING_VALUE",
3955
+ * // },
3956
+ * // },
3957
+ * // MalwareProtection: { // AwsGuardDutyDetectorDataSourcesMalwareProtectionDetails
3958
+ * // ScanEc2InstanceWithFindings: { // AwsGuardDutyDetectorDataSourcesMalwareProtectionScanEc2InstanceWithFindingsDetails
3959
+ * // EbsVolumes: { // AwsGuardDutyDetectorDataSourcesMalwareProtectionScanEc2InstanceWithFindingsEbsVolumesDetails
3960
+ * // Reason: "STRING_VALUE",
3961
+ * // Status: "STRING_VALUE",
3962
+ * // },
3963
+ * // },
3964
+ * // ServiceRole: "STRING_VALUE",
3965
+ * // },
3966
+ * // S3Logs: { // AwsGuardDutyDetectorDataSourcesS3LogsDetails
3967
+ * // Status: "STRING_VALUE",
3968
+ * // },
3969
+ * // },
3970
+ * // Features: [ // AwsGuardDutyDetectorFeaturesList
3971
+ * // { // AwsGuardDutyDetectorFeaturesDetails
3972
+ * // Name: "STRING_VALUE",
3973
+ * // Status: "STRING_VALUE",
3974
+ * // },
3975
+ * // ],
3976
+ * // FindingPublishingFrequency: "STRING_VALUE",
3977
+ * // ServiceRole: "STRING_VALUE",
3978
+ * // Status: "STRING_VALUE",
3979
+ * // },
3980
+ * // AwsStepFunctionStateMachine: { // AwsStepFunctionStateMachineDetails
3981
+ * // Label: "STRING_VALUE",
3982
+ * // LoggingConfiguration: { // AwsStepFunctionStateMachineLoggingConfigurationDetails
3983
+ * // Destinations: [ // AwsStepFunctionStateMachineLoggingConfigurationDestinationsList
3984
+ * // { // AwsStepFunctionStateMachineLoggingConfigurationDestinationsDetails
3985
+ * // CloudWatchLogsLogGroup: { // AwsStepFunctionStateMachineLoggingConfigurationDestinationsCloudWatchLogsLogGroupDetails
3986
+ * // LogGroupArn: "STRING_VALUE",
3987
+ * // },
3988
+ * // },
3989
+ * // ],
3990
+ * // IncludeExecutionData: true || false,
3991
+ * // Level: "STRING_VALUE",
3992
+ * // },
3993
+ * // Name: "STRING_VALUE",
3994
+ * // RoleArn: "STRING_VALUE",
3995
+ * // StateMachineArn: "STRING_VALUE",
3996
+ * // Status: "STRING_VALUE",
3997
+ * // TracingConfiguration: { // AwsStepFunctionStateMachineTracingConfigurationDetails
3998
+ * // Enabled: true || false,
3999
+ * // },
4000
+ * // Type: "STRING_VALUE",
4001
+ * // },
3831
4002
  * // },
3832
4003
  * // },
3833
4004
  * // ],