aws-sdk-securityhub 1.17.0 → 1.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f471a96f3a4b2f4814ab11b6fd42d22d84c20123
-  data.tar.gz: 3b1b942313fdad988f59bb0ab50740ba25028cb9
+  metadata.gz: 110096187fd3608d905720d86cc58269040441fd
+  data.tar.gz: 353ba34dd239e14ba96d0015a96b11b6fbf8c444
 SHA512:
-  metadata.gz: 8c21264f4fc7783b2e30260d7c1b17da63a9468afdf0a0b2f7447f50fdb7a1bee64f0a66accda23eeff6ed9b90bc7902c065ca2275c9d063717ed2e96c56286c
-  data.tar.gz: 02c932f8ae3e4f847c1dd4f4e32790fc41e39d9dd74b5ccfb43b8ef4c4128126e21d561a7c1909437b59827e5597e76fd29c3915dc99ef0b6ef325f29a1e90c6
+  metadata.gz: 7b084094db289d5ee10e4d1228b5ab107b27db856eb920cb6803a5a6ffd9c5322b1df11a0ed53c81be3ed0fbfdac6376f825f8c8d95907334c8ba991a75411ea
+  data.tar.gz: d2df3458de66f800da42c805d7c4e9b6867a894f21b92a3dcfb9912b8bdd588d65ef2cd9576e3f060eb7aab14a4e7060406c5478ae3403f1cc5bfbe2e68cbfbf

data/lib/aws-sdk-securityhub.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-securityhub/customizations'
 # @service
 module Aws::SecurityHub
 
-  GEM_VERSION = '1.17.0'
+  GEM_VERSION = '1.18.0'
 
 end

data/lib/aws-sdk-securityhub/client.rb

@@ -289,8 +289,8 @@ module Aws::SecurityHub
     # Disables the standards specified by the provided
     # `StandardsSubscriptionArns`.
     #
-    # For more information, see [Standards Supported in AWS Security
-    # Hub][1].
+    # For more information, see [Compliance Standards][1] section of the
+    # *AWS Security Hub User Guide*.
     #
     #
     #
@@ -327,12 +327,12 @@ module Aws::SecurityHub
       req.send_request(options)
     end
 
-    # Enables the standards specified by the provided `standardsArn`.
+    # Enables the standards specified by the provided `StandardsArn`. To
+    # obtain the ARN for a standard, use the ` DescribeStandards `
+    # operation.
     #
-    # In this release, only CIS AWS Foundations standards are supported.
-    #
-    # For more information, see [Standards Supported in AWS Security
-    # Hub][1].
+    # For more information, see the [Compliance Standards][1] section of the
+    # *AWS Security Hub User Guide*.
     #
     #
     #
@@ -341,12 +341,6 @@ module Aws::SecurityHub
     # @option params [required, Array<Types::StandardsSubscriptionRequest>] :standards_subscription_requests
     #   The list of standards compliance checks to enable.
     #
-    #   In this release, Security Hub supports only the CIS AWS Foundations
-    #   standard.
-    #
-    #    The ARN for the standard is
-    #   `arn:aws:securityhub:::ruleset/cis-aws-foundations-benchmark/v/1.2.0`.
-    #
     # @return [Types::BatchEnableStandardsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::BatchEnableStandardsResponse#standards_subscriptions #standards_subscriptions} => Array&lt;Types::StandardsSubscription&gt;
@@ -1525,12 +1519,12 @@ module Aws::SecurityHub
     # accounts and the account used to make the request, which is the master
     # account. To successfully create a member, you must use this action
     # from an account that already has Security Hub enabled. To enable
-    # Security Hub, you can use the EnableSecurityHub operation.
+    # Security Hub, you can use the ` EnableSecurityHub ` operation.
     #
     # After you use `CreateMembers` to create member account associations in
-    # Security Hub, you must use the InviteMembers operation to invite the
-    # accounts to enable Security Hub and become member accounts in Security
-    # Hub.
+    # Security Hub, you must use the ` InviteMembers ` operation to invite
+    # the accounts to enable Security Hub and become member accounts in
+    # Security Hub.
     #
     # If the account owner accepts the invitation, the account becomes a
     # member account in Security Hub, and a permission policy is added that
@@ -1539,7 +1533,8 @@ module Aws::SecurityHub
     # findings start to be sent to both the member and master accounts.
     #
     # To remove the association between the master and member accounts, use
-    # the DisassociateFromMasterAccount or DisassociateMembers operation.
+    # the ` DisassociateFromMasterAccount ` or ` DisassociateMembers `
+    # operation.
     #
     # @option params [Array<Types::AccountDetails>] :account_details
     #   The list of accounts to associate with the Security Hub master
@@ -1736,7 +1731,13 @@ module Aws::SecurityHub
     #   retrieve.
     #
     # @option params [String] :next_token
-    #   The token that is required for pagination.
+    #   The token that is required for pagination. On your first call to the
+    #   `DescribeActionTargets` operation, set the value of this parameter to
+    #   `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #
     # @option params [Integer] :max_results
     #   The maximum number of results to return.
@@ -1807,7 +1808,13 @@ module Aws::SecurityHub
     # findings.
     #
     # @option params [String] :next_token
-    #   The token that is required for pagination.
+    #   The token that is required for pagination. On your first call to the
+    #   `DescribeProducts` operation, set the value of this parameter to
+    #   `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #
     # @option params [Integer] :max_results
     #   The maximum number of results to return.
@@ -1847,6 +1854,52 @@ module Aws::SecurityHub
       req.send_request(options)
     end
 
+    # Returns a list of the available standards in Security Hub.
+    #
+    # For each standard, the results include the standard ARN, the name, and
+    # a description.
+    #
+    # @option params [String] :next_token
+    #   The token that is required for pagination. On your first call to the
+    #   `DescribeStandards` operation, set the value of this parameter to
+    #   `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of standards to return.
+    #
+    # @return [Types::DescribeStandardsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeStandardsResponse#standards #standards} => Array&lt;Types::Standard&gt;
+    #   * {Types::DescribeStandardsResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_standards({
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.standards #=> Array
+    #   resp.standards[0].standards_arn #=> String
+    #   resp.standards[0].name #=> String
+    #   resp.standards[0].description #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/DescribeStandards AWS API Documentation
+    #
+    # @overload describe_standards(params = {})
+    # @param [Hash] params ({})
+    def describe_standards(params = {}, options = {})
+      req = build_request(:describe_standards, params)
+      req.send_request(options)
+    end
+
     # Returns a list of compliance standards controls.
     #
     # For each control, the results include information about whether it is
@@ -1858,9 +1911,13 @@ module Aws::SecurityHub
     #   standard.
     #
     # @option params [String] :next_token
-    #   For requests to get the next page of results, the pagination token
-    #   that was returned with the previous set of results. The initial
-    #   request does not include a pagination token.
+    #   The token that is required for pagination. On your first call to the
+    #   `DescribeStandardsControls` operation, set the value of this parameter
+    #   to `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #
     # @option params [Integer] :max_results
     #   The maximum number of compliance standard controls to return.
@@ -1890,6 +1947,8 @@ module Aws::SecurityHub
     #   resp.controls[0].description #=> String
     #   resp.controls[0].remediation_url #=> String
     #   resp.controls[0].severity_rating #=> String, one of "LOW", "MEDIUM", "HIGH", "CRITICAL"
+    #   resp.controls[0].related_requirements #=> Array
+    #   resp.controls[0].related_requirements[0] #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/DescribeStandardsControls AWS API Documentation
@@ -2025,13 +2084,19 @@ module Aws::SecurityHub
     # Enables Security Hub for your account in the current Region or the
     # Region you specify in the request.
     #
-    # Enabling Security Hub also enables the CIS AWS Foundations standard.
-    #
     # When you enable Security Hub, you grant to Security Hub the
     # permissions necessary to gather findings from AWS Config, Amazon
     # GuardDuty, Amazon Inspector, and Amazon Macie.
     #
-    # To learn more, see [Setting Up AWS Security Hub][1].
+    # When you use the `EnableSecurityHub` operation to enable Security Hub,
+    # you also automatically enable the CIS AWS Foundations standard. You do
+    # not enable the Payment Card Industry Data Security Standard (PCI DSS)
+    # standard. To enable a standard, use the ` BatchEnableStandards `
+    # operation. To disable a standard, use the ` BatchDisableStandards `
+    # operation.
+    #
+    # To learn more, see [Setting Up AWS Security Hub][1] in the *AWS
+    # Security Hub User Guide*.
     #
     #
     #
@@ -2066,12 +2131,13 @@ module Aws::SecurityHub
     #   retrieve.
     #
     # @option params [String] :next_token
-    #   Paginates results. On your first call to the `GetEnabledStandards`
-    #   operation, set the value of this parameter to `NULL`.
+    #   The token that is required for pagination. On your first call to the
+    #   `GetEnabledStandards` operation, set the value of this parameter to
+    #   `NULL`.
     #
     #   For subsequent calls to the operation, to continue listing data, set
-    #   `nextToken` in the request to the value of `nextToken` from the
-    #   previous response.
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #
     # @option params [Integer] :max_results
     #   The maximum number of results to return in the response.
@@ -2118,12 +2184,12 @@ module Aws::SecurityHub
     #   The finding attributes used to sort the list of returned findings.
     #
     # @option params [String] :next_token
-    #   Paginates results. On your first call to the `GetFindings` operation,
-    #   set the value of this parameter to `NULL`.
+    #   The token that is required for pagination. On your first call to the
+    #   `GetFindings` operation, set the value of this parameter to `NULL`.
     #
     #   For subsequent calls to the operation, to continue listing data, set
-    #   `nextToken` in the request to the value of `nextToken` from the
-    #   previous response.
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #
     # @option params [Integer] :max_results
     #   The maximum number of findings to return.
@@ -3051,10 +3117,12 @@ module Aws::SecurityHub
     #   The ARNs of the insights to describe.
     #
     # @option params [String] :next_token
-    #   Paginates results. On your first call to the `GetInsights` operation,
-    #   set the value of this parameter to `NULL`. For subsequent calls to the
-    #   operation, to continue listing data, set `nextToken` in the request to
-    #   the value of `nextToken` from the previous response.
+    #   The token that is required for pagination. On your first call to the
+    #   `GetInsights` operation, set the value of this parameter to `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #
     # @option params [Integer] :max_results
     #   The maximum number of items to return in the response.
@@ -3453,7 +3521,8 @@ module Aws::SecurityHub
     # Hub master account that the invitation is sent from.
     #
     # Before you can use this action to invite a member, you must first use
-    # the CreateMembers action to create the member account in Security Hub.
+    # the ` CreateMembers ` action to create the member account in Security
+    # Hub.
     #
     # When the account owner accepts the invitation to become a member
     # account and enables Security Hub, the master account can view the
@@ -3492,11 +3561,13 @@ module Aws::SecurityHub
     # subscribed to receive findings from in Security Hub.
     #
     # @option params [String] :next_token
-    #   Paginates results. On your first call to the
+    #   The token that is required for pagination. On your first call to the
     #   `ListEnabledProductsForImport` operation, set the value of this
-    #   parameter to `NULL`. For subsequent calls to the operation, to
-    #   continue listing data, set `nextToken` in the request to the value of
-    #   `NextToken` from the previous response.
+    #   parameter to `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #
     # @option params [Integer] :max_results
     #   The maximum number of items to return in the response.
@@ -3535,10 +3606,13 @@ module Aws::SecurityHub
     #   The maximum number of items to return in the response.
     #
     # @option params [String] :next_token
-    #   Paginates results. On your first call to the `ListInvitations`
-    #   operation, set the value of this parameter to `NULL`. For subsequent
-    #   calls to the operation, to continue listing data, set `nextToken` in
-    #   the request to the value of `NextToken` from the previous response.
+    #   The token that is required for pagination. On your first call to the
+    #   `ListInvitations` operation, set the value of this parameter to
+    #   `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #
     # @return [Types::ListInvitationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3578,21 +3652,23 @@ module Aws::SecurityHub
     #   their relationship status with the master account. The default value
     #   is `TRUE`.
     #
-    #   If `onlyAssociated` is set to `TRUE`, the response includes member
+    #   If `OnlyAssociated` is set to `TRUE`, the response includes member
     #   accounts whose relationship status with the master is set to `ENABLED`
     #   or `DISABLED`.
     #
-    #   If `onlyAssociated` is set to `FALSE`, the response includes all
+    #   If `OnlyAssociated` is set to `FALSE`, the response includes all
     #   existing member accounts.
     #
     # @option params [Integer] :max_results
     #   The maximum number of items to return in the response.
     #
     # @option params [String] :next_token
-    #   Paginates results. On your first call to the `ListMembers` operation,
-    #   set the value of this parameter to `NULL`. For subsequent calls to the
-    #   operation, to continue listing data, set `nextToken` in the request to
-    #   the value of `nextToken` from the previous response.
+    #   The token that is required for pagination. On your first call to the
+    #   `ListMembers` operation, set the value of this parameter to `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #
     # @return [Types::ListMembersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4953,7 +5029,7 @@ module Aws::SecurityHub
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-securityhub'
-      context[:gem_version] = '1.17.0'
+      context[:gem_version] = '1.18.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-securityhub/client_api.rb

@@ -128,6 +128,8 @@ module Aws::SecurityHub
     DescribeProductsResponse = Shapes::StructureShape.new(name: 'DescribeProductsResponse')
     DescribeStandardsControlsRequest = Shapes::StructureShape.new(name: 'DescribeStandardsControlsRequest')
     DescribeStandardsControlsResponse = Shapes::StructureShape.new(name: 'DescribeStandardsControlsResponse')
+    DescribeStandardsRequest = Shapes::StructureShape.new(name: 'DescribeStandardsRequest')
+    DescribeStandardsResponse = Shapes::StructureShape.new(name: 'DescribeStandardsResponse')
     DisableImportFindingsForProductRequest = Shapes::StructureShape.new(name: 'DisableImportFindingsForProductRequest')
     DisableImportFindingsForProductResponse = Shapes::StructureShape.new(name: 'DisableImportFindingsForProductResponse')
     DisableSecurityHubRequest = Shapes::StructureShape.new(name: 'DisableSecurityHubRequest')
@@ -229,6 +231,8 @@ module Aws::SecurityHub
     SortCriteria = Shapes::ListShape.new(name: 'SortCriteria')
     SortCriterion = Shapes::StructureShape.new(name: 'SortCriterion')
     SortOrder = Shapes::StringShape.new(name: 'SortOrder')
+    Standard = Shapes::StructureShape.new(name: 'Standard')
+    Standards = Shapes::ListShape.new(name: 'Standards')
     StandardsControl = Shapes::StructureShape.new(name: 'StandardsControl')
     StandardsControls = Shapes::ListShape.new(name: 'StandardsControls')
     StandardsInputParameterMap = Shapes::MapShape.new(name: 'StandardsInputParameterMap')
@@ -879,6 +883,14 @@ module Aws::SecurityHub
     DescribeStandardsControlsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
     DescribeStandardsControlsResponse.struct_class = Types::DescribeStandardsControlsResponse
 
+    DescribeStandardsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location: "querystring", location_name: "NextToken"))
+    DescribeStandardsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location: "querystring", location_name: "MaxResults"))
+    DescribeStandardsRequest.struct_class = Types::DescribeStandardsRequest
+
+    DescribeStandardsResponse.add_member(:standards, Shapes::ShapeRef.new(shape: Standards, location_name: "Standards"))
+    DescribeStandardsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    DescribeStandardsResponse.struct_class = Types::DescribeStandardsResponse
+
     DisableImportFindingsForProductRequest.add_member(:product_subscription_arn, Shapes::ShapeRef.new(shape: NonEmptyString, required: true, location: "uri", location_name: "ProductSubscriptionArn"))
     DisableImportFindingsForProductRequest.struct_class = Types::DisableImportFindingsForProductRequest
 
@@ -1213,6 +1225,13 @@ module Aws::SecurityHub
     SortCriterion.add_member(:sort_order, Shapes::ShapeRef.new(shape: SortOrder, location_name: "SortOrder"))
     SortCriterion.struct_class = Types::SortCriterion
 
+    Standard.add_member(:standards_arn, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "StandardsArn"))
+    Standard.add_member(:name, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "Name"))
+    Standard.add_member(:description, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "Description"))
+    Standard.struct_class = Types::Standard
+
+    Standards.member = Shapes::ShapeRef.new(shape: Standard)
+
     StandardsControl.add_member(:standards_control_arn, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "StandardsControlArn"))
     StandardsControl.add_member(:control_status, Shapes::ShapeRef.new(shape: ControlStatus, location_name: "ControlStatus"))
     StandardsControl.add_member(:disabled_reason, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "DisabledReason"))
@@ -1222,6 +1241,7 @@ module Aws::SecurityHub
     StandardsControl.add_member(:description, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "Description"))
     StandardsControl.add_member(:remediation_url, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "RemediationUrl"))
     StandardsControl.add_member(:severity_rating, Shapes::ShapeRef.new(shape: SeverityRating, location_name: "SeverityRating"))
+    StandardsControl.add_member(:related_requirements, Shapes::ShapeRef.new(shape: RelatedRequirementsList, location_name: "RelatedRequirements"))
     StandardsControl.struct_class = Types::StandardsControl
 
     StandardsControls.member = Shapes::ShapeRef.new(shape: StandardsControl)
@@ -1540,6 +1560,23 @@ module Aws::SecurityHub
         )
       end)
 
+      api.add_operation(:describe_standards, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeStandards"
+        o.http_method = "GET"
+        o.http_request_uri = "/standards"
+        o.input = Shapes::ShapeRef.new(shape: DescribeStandardsRequest)
+        o.output = Shapes::ShapeRef.new(shape: DescribeStandardsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InternalException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidAccessException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:describe_standards_controls, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeStandardsControls"
         o.http_method = "GET"
@@ -1550,6 +1587,12 @@ module Aws::SecurityHub
         o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidAccessException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
 
       api.add_operation(:disable_import_findings_for_product, Seahorse::Model::Operation.new.tap do |o|
@@ -1639,6 +1682,12 @@ module Aws::SecurityHub
         o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidAccessException)
         o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
 
       api.add_operation(:get_findings, Seahorse::Model::Operation.new.tap do |o|
@@ -1769,6 +1818,12 @@ module Aws::SecurityHub
         o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidAccessException)
         o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
 
       api.add_operation(:list_members, Seahorse::Model::Operation.new.tap do |o|
@@ -1781,6 +1836,12 @@ module Aws::SecurityHub
         o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidAccessException)
         o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
 
       api.add_operation(:list_tags_for_resource, Seahorse::Model::Operation.new.tap do |o|

data/lib/aws-sdk-securityhub/types.rb

@@ -2945,8 +2945,8 @@ module Aws::SecurityHub
     # @!attribute [rw] compliance
     #   This data type is exclusive to findings that are generated as the
     #   result of a check run against a specific rule in a supported
-    #   standard (for example, CIS AWS Foundations). Contains
-    #   compliance-related finding details.
+    #   standard, such as CIS AWS Foundations. Contains compliance-related
+    #   finding details.
     #   @return [Types::Compliance]
     #
     # @!attribute [rw] verification_state
@@ -3898,8 +3898,8 @@ module Aws::SecurityHub
     #
     # @!attribute [rw] compliance_status
     #   Exclusive to findings that are generated as the result of a check
-    #   run against a specific rule in a supported standard (for example,
-    #   CIS AWS Foundations). Contains compliance-related finding details.
+    #   run against a specific rule in a supported standard, such as CIS AWS
+    #   Foundations. Contains compliance-related finding details.
     #   @return [Array<Types::StringFilter>]
     #
     # @!attribute [rw] verification_state
@@ -4327,12 +4327,6 @@ module Aws::SecurityHub
     #
     # @!attribute [rw] standards_subscription_requests
     #   The list of standards compliance checks to enable.
-    #
-    #   In this release, Security Hub supports only the CIS AWS Foundations
-    #   standard.
-    #
-    #    The ARN for the standard is
-    #   `arn:aws:securityhub:::ruleset/cis-aws-foundations-benchmark/v/1.2.0`.
     #   @return [Array<Types::StandardsSubscriptionRequest>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/BatchEnableStandardsRequest AWS API Documentation
@@ -4861,8 +4855,8 @@ module Aws::SecurityHub
     end
 
     # Exclusive to findings that are generated as the result of a check run
-    # against a specific rule in a supported standard (for example, CIS AWS
-    # Foundations). Contains compliance-related finding details.
+    # against a specific rule in a supported standard, such as CIS AWS
+    # Foundations. Contains compliance-related finding details.
     #
     # Values include the following:
     #
@@ -5840,7 +5834,13 @@ module Aws::SecurityHub
     #   @return [Array<String>]
     #
     # @!attribute [rw] next_token
-    #   The token that is required for pagination.
+    #   The token that is required for pagination. On your first call to the
+    #   `DescribeActionTargets` operation, set the value of this parameter
+    #   to `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -5863,7 +5863,7 @@ module Aws::SecurityHub
     #   @return [Array<Types::ActionTarget>]
     #
     # @!attribute [rw] next_token
-    #   The token that is required for pagination.
+    #   The pagination token to use to request the next page of results.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/DescribeActionTargetsResponse AWS API Documentation
@@ -5917,7 +5917,13 @@ module Aws::SecurityHub
     #       }
     #
     # @!attribute [rw] next_token
-    #   The token that is required for pagination.
+    #   The token that is required for pagination. On your first call to the
+    #   `DescribeProducts` operation, set the value of this parameter to
+    #   `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -5937,7 +5943,7 @@ module Aws::SecurityHub
     #   @return [Array<Types::Product>]
     #
     # @!attribute [rw] next_token
-    #   The token that is required for pagination.
+    #   The pagination token to use to request the next page of results.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/DescribeProductsResponse AWS API Documentation
@@ -5963,9 +5969,13 @@ module Aws::SecurityHub
     #   @return [String]
     #
     # @!attribute [rw] next_token
-    #   For requests to get the next page of results, the pagination token
-    #   that was returned with the previous set of results. The initial
-    #   request does not include a pagination token.
+    #   The token that is required for pagination. On your first call to the
+    #   `DescribeStandardsControls` operation, set the value of this
+    #   parameter to `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -5986,9 +5996,7 @@ module Aws::SecurityHub
     #   @return [Array<Types::StandardsControl>]
     #
     # @!attribute [rw] next_token
-    #   If there are more compliance standards control remaining in the
-    #   results, then this is the pagination token to use to request the
-    #   next page of compliance standard controls.
+    #   The pagination token to use to request the next page of results.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/DescribeStandardsControlsResponse AWS API Documentation
@@ -5999,6 +6007,52 @@ module Aws::SecurityHub
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DescribeStandardsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         next_token: "NextToken",
+    #         max_results: 1,
+    #       }
+    #
+    # @!attribute [rw] next_token
+    #   The token that is required for pagination. On your first call to the
+    #   `DescribeStandards` operation, set the value of this parameter to
+    #   `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of standards to return.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/DescribeStandardsRequest AWS API Documentation
+    #
+    class DescribeStandardsRequest < Struct.new(
+      :next_token,
+      :max_results)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] standards
+    #   A list of available standards.
+    #   @return [Array<Types::Standard>]
+    #
+    # @!attribute [rw] next_token
+    #   The pagination token to use to request the next page of results.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/DescribeStandardsResponse AWS API Documentation
+    #
+    class DescribeStandardsResponse < Struct.new(
+      :standards,
+      :next_token)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DisableImportFindingsForProductRequest
     #   data as a hash:
     #
@@ -6133,12 +6187,13 @@ module Aws::SecurityHub
     #   @return [Array<String>]
     #
     # @!attribute [rw] next_token
-    #   Paginates results. On your first call to the `GetEnabledStandards`
-    #   operation, set the value of this parameter to `NULL`.
+    #   The token that is required for pagination. On your first call to the
+    #   `GetEnabledStandards` operation, set the value of this parameter to
+    #   `NULL`.
     #
     #   For subsequent calls to the operation, to continue listing data, set
-    #   `nextToken` in the request to the value of `nextToken` from the
-    #   previous response.
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -6160,7 +6215,7 @@ module Aws::SecurityHub
     #   @return [Array<Types::StandardsSubscription>]
     #
     # @!attribute [rw] next_token
-    #   The token that is required for pagination.
+    #   The pagination token to use to request the next page of results.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/GetEnabledStandardsResponse AWS API Documentation
@@ -6744,12 +6799,12 @@ module Aws::SecurityHub
     #   @return [Array<Types::SortCriterion>]
     #
     # @!attribute [rw] next_token
-    #   Paginates results. On your first call to the `GetFindings`
-    #   operation, set the value of this parameter to `NULL`.
+    #   The token that is required for pagination. On your first call to the
+    #   `GetFindings` operation, set the value of this parameter to `NULL`.
     #
     #   For subsequent calls to the operation, to continue listing data, set
-    #   `nextToken` in the request to the value of `nextToken` from the
-    #   previous response.
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -6771,7 +6826,7 @@ module Aws::SecurityHub
     #   @return [Array<Types::AwsSecurityFinding>]
     #
     # @!attribute [rw] next_token
-    #   The token that is required for pagination.
+    #   The pagination token to use to request the next page of results.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/GetFindingsResponse AWS API Documentation
@@ -6825,10 +6880,12 @@ module Aws::SecurityHub
     #   @return [Array<String>]
     #
     # @!attribute [rw] next_token
-    #   Paginates results. On your first call to the `GetInsights`
-    #   operation, set the value of this parameter to `NULL`. For subsequent
-    #   calls to the operation, to continue listing data, set `nextToken` in
-    #   the request to the value of `nextToken` from the previous response.
+    #   The token that is required for pagination. On your first call to the
+    #   `GetInsights` operation, set the value of this parameter to `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -6849,7 +6906,7 @@ module Aws::SecurityHub
     #   @return [Array<Types::Insight>]
     #
     # @!attribute [rw] next_token
-    #   The token that is required for pagination.
+    #   The pagination token to use to request the next page of results.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/GetInsightsResponse AWS API Documentation
@@ -7215,11 +7272,13 @@ module Aws::SecurityHub
     #       }
     #
     # @!attribute [rw] next_token
-    #   Paginates results. On your first call to the
+    #   The token that is required for pagination. On your first call to the
     #   `ListEnabledProductsForImport` operation, set the value of this
-    #   parameter to `NULL`. For subsequent calls to the operation, to
-    #   continue listing data, set `nextToken` in the request to the value
-    #   of `NextToken` from the previous response.
+    #   parameter to `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -7240,7 +7299,7 @@ module Aws::SecurityHub
     #   @return [Array<String>]
     #
     # @!attribute [rw] next_token
-    #   The token that is required for pagination.
+    #   The pagination token to use to request the next page of results.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/ListEnabledProductsForImportResponse AWS API Documentation
@@ -7264,10 +7323,13 @@ module Aws::SecurityHub
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
-    #   Paginates results. On your first call to the `ListInvitations`
-    #   operation, set the value of this parameter to `NULL`. For subsequent
-    #   calls to the operation, to continue listing data, set `nextToken` in
-    #   the request to the value of `NextToken` from the previous response.
+    #   The token that is required for pagination. On your first call to the
+    #   `ListInvitations` operation, set the value of this parameter to
+    #   `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/ListInvitationsRequest AWS API Documentation
@@ -7283,7 +7345,7 @@ module Aws::SecurityHub
     #   @return [Array<Types::Invitation>]
     #
     # @!attribute [rw] next_token
-    #   The token that is required for pagination.
+    #   The pagination token to use to request the next page of results.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/ListInvitationsResponse AWS API Documentation
@@ -7308,11 +7370,11 @@ module Aws::SecurityHub
     #   their relationship status with the master account. The default value
     #   is `TRUE`.
     #
-    #   If `onlyAssociated` is set to `TRUE`, the response includes member
+    #   If `OnlyAssociated` is set to `TRUE`, the response includes member
     #   accounts whose relationship status with the master is set to
     #   `ENABLED` or `DISABLED`.
     #
-    #   If `onlyAssociated` is set to `FALSE`, the response includes all
+    #   If `OnlyAssociated` is set to `FALSE`, the response includes all
     #   existing member accounts.
     #   @return [Boolean]
     #
@@ -7321,10 +7383,12 @@ module Aws::SecurityHub
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
-    #   Paginates results. On your first call to the `ListMembers`
-    #   operation, set the value of this parameter to `NULL`. For subsequent
-    #   calls to the operation, to continue listing data, set `nextToken` in
-    #   the request to the value of `nextToken` from the previous response.
+    #   The token that is required for pagination. On your first call to the
+    #   `ListMembers` operation, set the value of this parameter to `NULL`.
+    #
+    #   For subsequent calls to the operation, to continue listing data, set
+    #   the value of this parameter to the value returned from the previous
+    #   response.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/ListMembersRequest AWS API Documentation
@@ -7341,7 +7405,7 @@ module Aws::SecurityHub
     #   @return [Array<Types::Member>]
     #
     # @!attribute [rw] next_token
-    #   The token that is required for pagination.
+    #   The pagination token to use to request the next page of results.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/ListMembersResponse AWS API Documentation
@@ -8895,6 +8959,29 @@ module Aws::SecurityHub
       include Aws::Structure
     end
 
+    # Provides information about a specific standard.
+    #
+    # @!attribute [rw] standards_arn
+    #   The ARN of a standard.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of the standard.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   A description of the standard.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/Standard AWS API Documentation
+    #
+    class Standard < Struct.new(
+      :standards_arn,
+      :name,
+      :description)
+      include Aws::Structure
+    end
+
     # Details for an individual compliance standard control.
     #
     # @!attribute [rw] standards_control_arn
@@ -8932,7 +9019,7 @@ module Aws::SecurityHub
     #
     # @!attribute [rw] remediation_url
     #   A link to remediation information for the control in the Security
-    #   Hub user documentation
+    #   Hub user documentation.
     #   @return [String]
     #
     # @!attribute [rw] severity_rating
@@ -8943,6 +9030,10 @@ module Aws::SecurityHub
     #   be to compromise AWS resources if the compliance issue is detected.
     #   @return [String]
     #
+    # @!attribute [rw] related_requirements
+    #   The list of requirements that are related to this control.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/StandardsControl AWS API Documentation
     #
     class StandardsControl < Struct.new(
@@ -8954,7 +9045,8 @@ module Aws::SecurityHub
       :title,
       :description,
       :remediation_url,
-      :severity_rating)
+      :severity_rating,
+      :related_requirements)
       include Aws::Structure
     end
 
@@ -8967,10 +9059,6 @@ module Aws::SecurityHub
     #
     # @!attribute [rw] standards_arn
     #   The ARN of a standard.
-    #
-    #   In this release, Security Hub supports only the CIS AWS Foundations
-    #   standard, which uses the following ARN:
-    #   `arn:aws:securityhub:::ruleset/cis-aws-foundations-benchmark/v/1.2.0.`
     #   @return [String]
     #
     # @!attribute [rw] standards_input
@@ -9004,13 +9092,9 @@ module Aws::SecurityHub
     #       }
     #
     # @!attribute [rw] standards_arn
-    #   The ARN of the standard that you want to enable.
-    #
-    #   In this release, Security Hub only supports the CIS AWS Foundations
-    #   standard.
-    #
-    #    Its ARN is
-    #   `arn:aws:securityhub:::ruleset/cis-aws-foundations-benchmark/v/1.2.0`.
+    #   The ARN of the standard that you want to enable. To view the list of
+    #   available standards and their ARNs, use the ` DescribeStandards `
+    #   operation.
     #   @return [String]
     #
     # @!attribute [rw] standards_input

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-securityhub
 version: !ruby/object:Gem::Version
-  version: 1.17.0
+  version: 1.18.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-02-05 00:00:00.000000000 Z
+date: 2020-02-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core