aws-sdk-detective 1.28.0 → 1.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 79a5f4f00d149cc1f953ac28dfbb0a13caa38913c53127a1da71fe5f3bf7cd55
-  data.tar.gz: 1f48682045c8fdef99a46506cf04304d78aa601233512944f2fc502c0c4ac1e2
+  metadata.gz: e2af17315223f389a14e0f955b018adb62b1657519eaa04ed68f1e3ca06a7588
+  data.tar.gz: 31dfbf5787efcc537e1c43a358c304baf615a6489646482179da03bfa93ef31b
 SHA512:
-  metadata.gz: f02d549f098fc19cde60852974a85f2fbc33c78f6629fde57ed65fb6a1a53fd55119f1d84667dfdc9f394d7f069831e8574fcba1432ce3253356ebe3d57048fb
-  data.tar.gz: 9c0cb970aa82cf370cd727d15a9105e251370bcc7aab2c2c767eb609dcdeb802b5e836c54c4c06c07f1f2bc32617658617ff1f5f4051beb43f4df3db6d65f605
+  metadata.gz: '029701d37f238caa2cf1abad61a71b9730a531a0d1624a2add2e50ecf5aab1a13211a4e5f63aa036e2e361e4457f774e5d692a073e93c17fcf2c18434b56ae08'
+  data.tar.gz: 288850301ed8295d9a1e32d55251e2cd98cf87b454dfc67716f3cc5d467d130fbb92d7dd6508aab010956a4820d673a1fcfef606662e96defb7b629d5c2df472

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.30.0 (2022-10-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.29.0 (2022-07-26)
+------------------
+
+* Feature - Added the ability to get data source package information for the behavior graph. Graph administrators can now start (or stop) optional datasources on the behavior graph.
+
 1.28.0 (2022-02-24)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.28.0
+1.30.0

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

@@ -30,7 +30,7 @@ require 'aws-sdk-core/plugins/http_checksum.rb'
 require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
-require 'aws-sdk-core/plugins/signature_v4.rb'
+require 'aws-sdk-core/plugins/sign.rb'
 require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 
 Aws::Plugins::GlobalConfiguration.add_identifier(:detective)
@@ -79,8 +79,9 @@ module Aws::Detective
     add_plugin(Aws::Plugins::ChecksumAlgorithm)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
-    add_plugin(Aws::Plugins::SignatureV4)
+    add_plugin(Aws::Plugins::Sign)
     add_plugin(Aws::Plugins::Protocols::RestJson)
+    add_plugin(Aws::Detective::Plugins::Endpoints)
 
     # @overload initialize(options)
     #   @param [Hash] options
@@ -287,6 +288,19 @@ module Aws::Detective
     #     ** Please note ** When response stubbing is enabled, no HTTP
     #     requests are made, and retries are disabled.
     #
+    #   @option options [Aws::TokenProvider] :token_provider
+    #     A Bearer Token Provider. This can be an instance of any one of the
+    #     following classes:
+    #
+    #     * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
+    #       tokens.
+    #
+    #     * `Aws::SSOTokenProvider` - Used for loading tokens from AWS SSO using an
+    #       access token generated from `aws login`.
+    #
+    #     When `:token_provider` is not configured directly, the `Aws::TokenProviderChain`
+    #     will be used to search for tokens configured for your profile in shared configuration files.
+    #
     #   @option options [Boolean] :use_dualstack_endpoint
     #     When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
     #     will be used if available.
@@ -300,6 +314,9 @@ module Aws::Detective
     #     When `true`, request parameters are validated before
     #     sending the request.
     #
+    #   @option options [Aws::Detective::EndpointProvider] :endpoint_provider
+    #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::Detective::EndpointParameters`
+    #
     #   @option options [URI::HTTP,String] :http_proxy A proxy to send
     #     requests through.  Formatted like 'http://proxy.com:123'.
     #
@@ -382,6 +399,85 @@ module Aws::Detective
       req.send_request(options)
     end
 
+    # Gets data source package information for the behavior graph.
+    #
+    # @option params [required, String] :graph_arn
+    #   The ARN of the behavior graph.
+    #
+    # @option params [required, Array<String>] :account_ids
+    #   The list of Amazon Web Services accounts to get data source package
+    #   information on.
+    #
+    # @return [Types::BatchGetGraphMemberDatasourcesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::BatchGetGraphMemberDatasourcesResponse#member_datasources #member_datasources} => Array&lt;Types::MembershipDatasources&gt;
+    #   * {Types::BatchGetGraphMemberDatasourcesResponse#unprocessed_accounts #unprocessed_accounts} => Array&lt;Types::UnprocessedAccount&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.batch_get_graph_member_datasources({
+    #     graph_arn: "GraphArn", # required
+    #     account_ids: ["AccountId"], # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.member_datasources #=> Array
+    #   resp.member_datasources[0].account_id #=> String
+    #   resp.member_datasources[0].graph_arn #=> String
+    #   resp.member_datasources[0].datasource_package_ingest_history #=> Hash
+    #   resp.member_datasources[0].datasource_package_ingest_history["DatasourcePackage"] #=> Hash
+    #   resp.member_datasources[0].datasource_package_ingest_history["DatasourcePackage"]["DatasourcePackageIngestState"].timestamp #=> Time
+    #   resp.unprocessed_accounts #=> Array
+    #   resp.unprocessed_accounts[0].account_id #=> String
+    #   resp.unprocessed_accounts[0].reason #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/BatchGetGraphMemberDatasources AWS API Documentation
+    #
+    # @overload batch_get_graph_member_datasources(params = {})
+    # @param [Hash] params ({})
+    def batch_get_graph_member_datasources(params = {}, options = {})
+      req = build_request(:batch_get_graph_member_datasources, params)
+      req.send_request(options)
+    end
+
+    # Gets information on the data source package history for an account.
+    #
+    # @option params [required, Array<String>] :graph_arns
+    #   The ARN of the behavior graph.
+    #
+    # @return [Types::BatchGetMembershipDatasourcesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::BatchGetMembershipDatasourcesResponse#membership_datasources #membership_datasources} => Array&lt;Types::MembershipDatasources&gt;
+    #   * {Types::BatchGetMembershipDatasourcesResponse#unprocessed_graphs #unprocessed_graphs} => Array&lt;Types::UnprocessedGraph&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.batch_get_membership_datasources({
+    #     graph_arns: ["GraphArn"], # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.membership_datasources #=> Array
+    #   resp.membership_datasources[0].account_id #=> String
+    #   resp.membership_datasources[0].graph_arn #=> String
+    #   resp.membership_datasources[0].datasource_package_ingest_history #=> Hash
+    #   resp.membership_datasources[0].datasource_package_ingest_history["DatasourcePackage"] #=> Hash
+    #   resp.membership_datasources[0].datasource_package_ingest_history["DatasourcePackage"]["DatasourcePackageIngestState"].timestamp #=> Time
+    #   resp.unprocessed_graphs #=> Array
+    #   resp.unprocessed_graphs[0].graph_arn #=> String
+    #   resp.unprocessed_graphs[0].reason #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/BatchGetMembershipDatasources AWS API Documentation
+    #
+    # @overload batch_get_membership_datasources(params = {})
+    # @param [Hash] params ({})
+    def batch_get_membership_datasources(params = {}, options = {})
+      req = build_request(:batch_get_membership_datasources, params)
+      req.send_request(options)
+    end
+
     # Creates a new behavior graph for the calling account, and sets that
     # account as the administrator account. This operation is called by the
     # account that is enabling Detective.
@@ -529,6 +625,11 @@ module Aws::Detective
     #   resp.members[0].percent_of_graph_utilization #=> Float
     #   resp.members[0].percent_of_graph_utilization_updated_time #=> Time
     #   resp.members[0].invitation_type #=> String, one of "INVITATION", "ORGANIZATION"
+    #   resp.members[0].volume_usage_by_datasource_package #=> Hash
+    #   resp.members[0].volume_usage_by_datasource_package["DatasourcePackage"].volume_usage_in_bytes #=> Integer
+    #   resp.members[0].volume_usage_by_datasource_package["DatasourcePackage"].volume_usage_update_time #=> Time
+    #   resp.members[0].datasource_package_ingest_states #=> Hash
+    #   resp.members[0].datasource_package_ingest_states["DatasourcePackage"] #=> String, one of "STARTED", "STOPPED", "DISABLED"
     #   resp.unprocessed_accounts #=> Array
     #   resp.unprocessed_accounts[0].account_id #=> String
     #   resp.unprocessed_accounts[0].reason #=> String
@@ -658,12 +759,19 @@ module Aws::Detective
       req.send_request(options)
     end
 
-    # Removes the Detective administrator account for the organization in
-    # the current Region. Deletes the behavior graph for that account.
+    # Removes the Detective administrator account in the current Region.
+    # Deletes the organization behavior graph.
+    #
+    # Can only be called by the organization management account.
+    #
+    # Removing the Detective administrator account does not affect the
+    # delegated administrator account for Detective in Organizations.
     #
-    # Can only be called by the organization management account. Before you
-    # can select a different Detective administrator account, you must
-    # remove the Detective administrator account in all Regions.
+    # To remove the delegated administrator account in Organizations, use
+    # the Organizations API. Removing the delegated administrator account
+    # also removes the Detective administrator account in all Regions,
+    # except for Regions where the Detective administrator account is the
+    # organization management account.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -716,10 +824,17 @@ module Aws::Detective
     #
     # Can only be called by the organization management account.
     #
-    # The Detective administrator account for an organization must be the
-    # same in all Regions. If you already designated a Detective
-    # administrator account in another Region, then you must designate the
-    # same account.
+    # If the organization has a delegated administrator account in
+    # Organizations, then the Detective administrator account must be either
+    # the delegated administrator account or the organization management
+    # account.
+    #
+    # If the organization does not have a delegated administrator account in
+    # Organizations, then you can choose any account in the organization. If
+    # you choose an account other than the organization management account,
+    # Detective calls Organizations to make that account the delegated
+    # administrator account for Detective. The organization management
+    # account cannot be the delegated administrator account.
     #
     # @option params [required, String] :account_id
     #   The Amazon Web Services account identifier of the account to designate
@@ -785,6 +900,11 @@ module Aws::Detective
     #   resp.member_details[0].percent_of_graph_utilization #=> Float
     #   resp.member_details[0].percent_of_graph_utilization_updated_time #=> Time
     #   resp.member_details[0].invitation_type #=> String, one of "INVITATION", "ORGANIZATION"
+    #   resp.member_details[0].volume_usage_by_datasource_package #=> Hash
+    #   resp.member_details[0].volume_usage_by_datasource_package["DatasourcePackage"].volume_usage_in_bytes #=> Integer
+    #   resp.member_details[0].volume_usage_by_datasource_package["DatasourcePackage"].volume_usage_update_time #=> Time
+    #   resp.member_details[0].datasource_package_ingest_states #=> Hash
+    #   resp.member_details[0].datasource_package_ingest_states["DatasourcePackage"] #=> String, one of "STARTED", "STOPPED", "DISABLED"
     #   resp.unprocessed_accounts #=> Array
     #   resp.unprocessed_accounts[0].account_id #=> String
     #   resp.unprocessed_accounts[0].reason #=> String
@@ -798,6 +918,51 @@ module Aws::Detective
       req.send_request(options)
     end
 
+    # Lists data source packages in the behavior graph.
+    #
+    # @option params [required, String] :graph_arn
+    #   The ARN of the behavior graph.
+    #
+    # @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.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return.
+    #
+    # @return [Types::ListDatasourcePackagesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListDatasourcePackagesResponse#datasource_packages #datasource_packages} => Hash&lt;String,Types::DatasourcePackageIngestDetail&gt;
+    #   * {Types::ListDatasourcePackagesResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_datasource_packages({
+    #     graph_arn: "GraphArn", # required
+    #     next_token: "PaginationToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.datasource_packages #=> Hash
+    #   resp.datasource_packages["DatasourcePackage"].datasource_package_ingest_state #=> String, one of "STARTED", "STOPPED", "DISABLED"
+    #   resp.datasource_packages["DatasourcePackage"].last_ingest_state_change #=> Hash
+    #   resp.datasource_packages["DatasourcePackage"].last_ingest_state_change["DatasourcePackageIngestState"].timestamp #=> Time
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/ListDatasourcePackages AWS API Documentation
+    #
+    # @overload list_datasource_packages(params = {})
+    # @param [Hash] params ({})
+    def list_datasource_packages(params = {}, options = {})
+      req = build_request(:list_datasource_packages, params)
+      req.send_request(options)
+    end
+
     # Returns the list of behavior graphs that the calling account is an
     # administrator account of. This operation can only be called by an
     # administrator account.
@@ -899,6 +1064,11 @@ module Aws::Detective
     #   resp.invitations[0].percent_of_graph_utilization #=> Float
     #   resp.invitations[0].percent_of_graph_utilization_updated_time #=> Time
     #   resp.invitations[0].invitation_type #=> String, one of "INVITATION", "ORGANIZATION"
+    #   resp.invitations[0].volume_usage_by_datasource_package #=> Hash
+    #   resp.invitations[0].volume_usage_by_datasource_package["DatasourcePackage"].volume_usage_in_bytes #=> Integer
+    #   resp.invitations[0].volume_usage_by_datasource_package["DatasourcePackage"].volume_usage_update_time #=> Time
+    #   resp.invitations[0].datasource_package_ingest_states #=> Hash
+    #   resp.invitations[0].datasource_package_ingest_states["DatasourcePackage"] #=> String, one of "STARTED", "STOPPED", "DISABLED"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/ListInvitations AWS API Documentation
@@ -965,6 +1135,11 @@ module Aws::Detective
     #   resp.member_details[0].percent_of_graph_utilization #=> Float
     #   resp.member_details[0].percent_of_graph_utilization_updated_time #=> Time
     #   resp.member_details[0].invitation_type #=> String, one of "INVITATION", "ORGANIZATION"
+    #   resp.member_details[0].volume_usage_by_datasource_package #=> Hash
+    #   resp.member_details[0].volume_usage_by_datasource_package["DatasourcePackage"].volume_usage_in_bytes #=> Integer
+    #   resp.member_details[0].volume_usage_by_datasource_package["DatasourcePackage"].volume_usage_update_time #=> Time
+    #   resp.member_details[0].datasource_package_ingest_states #=> Hash
+    #   resp.member_details[0].datasource_package_ingest_states["DatasourcePackage"] #=> String, one of "STARTED", "STOPPED", "DISABLED"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/ListMembers AWS API Documentation
@@ -1175,6 +1350,32 @@ module Aws::Detective
       req.send_request(options)
     end
 
+    # Starts a data source packages for the behavior graph.
+    #
+    # @option params [required, String] :graph_arn
+    #   The ARN of the behavior graph.
+    #
+    # @option params [required, Array<String>] :datasource_packages
+    #   The data source package start for the behavior graph.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_datasource_packages({
+    #     graph_arn: "GraphArn", # required
+    #     datasource_packages: ["DETECTIVE_CORE"], # required, accepts DETECTIVE_CORE, EKS_AUDIT
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/UpdateDatasourcePackages AWS API Documentation
+    #
+    # @overload update_datasource_packages(params = {})
+    # @param [Hash] params ({})
+    def update_datasource_packages(params = {}, options = {})
+      req = build_request(:update_datasource_packages, params)
+      req.send_request(options)
+    end
+
     # Updates the configuration for the Organizations integration in the
     # current Region. Can only be called by the Detective administrator
     # account for the organization.
@@ -1217,7 +1418,7 @@ module Aws::Detective
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-detective'
-      context[:gem_version] = '1.28.0'
+      context[:gem_version] = '1.30.0'
       Seahorse::Client::Request.new(handlers, context)
     end