Package software.amazon.awssdk.services.detective

Interface DetectiveAsyncClient

All Superinterfaces:
AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient
@Generated("software.amazon.awssdk:codegen") @ThreadSafe public interface DetectiveAsyncClient extends AwsClient
Service client for accessing Amazon Detective asynchronously. This can be created using the static builder() method.The asynchronous client performs non-blocking I/O when configured with any SdkAsyncHttpClient supported in the SDK. However, full non-blocking is not guaranteed as the async client may perform blocking calls in some cases such as credentials retrieval and endpoint discovery as part of the async API call.

Detective uses machine learning and purpose-built visualizations to help you to analyze and investigate security issues across your Amazon Web Services (Amazon Web Services) workloads. Detective automatically extracts time-based events such as login attempts, API calls, and network traffic from CloudTrail and Amazon Virtual Private Cloud (Amazon VPC) flow logs. It also extracts findings detected by Amazon GuardDuty.

The Detective API primarily supports the creation and management of behavior graphs. A behavior graph contains the extracted data from a set of member accounts, and is created and managed by an administrator account.

To add a member account to the behavior graph, the administrator account sends an invitation to the account. When the account accepts the invitation, it becomes a member account in the behavior graph.

Detective is also integrated with Organizations. The organization management account designates the Detective administrator account for the organization. That account becomes the administrator account for the organization behavior graph. The Detective administrator account is also the delegated administrator account for Detective in Organizations.

The Detective administrator account can enable any organization account as a member account in the organization behavior graph. The organization accounts do not receive invitations. The Detective administrator account can also invite other accounts to the organization behavior graph.

Every behavior graph is specific to a Region. You can only use the API to manage behavior graphs that belong to the Region that is associated with the currently selected endpoint.

The administrator account for a behavior graph can use the Detective API to do the following:

  • Enable and disable Detective. Enabling Detective creates a new behavior graph.

  • View the list of member accounts in a behavior graph.

  • Add member accounts to a behavior graph.

  • Remove member accounts from a behavior graph.

  • Apply tags to a behavior graph.

The organization management account can use the Detective API to select the delegated administrator for Detective.

The Detective administrator account for an organization can use the Detective API to do the following:

  • Perform all of the functions of an administrator account.

  • Determine whether to automatically enable new organization accounts as member accounts in the organization behavior graph.

An invited member account can use the Detective API to do the following:

  • View the list of behavior graphs that they are invited to.

  • Accept an invitation to contribute to a behavior graph.

  • Decline an invitation to contribute to a behavior graph.

  • Remove their account from a behavior graph.

All API actions are logged as CloudTrail events. See Logging Detective API Calls with CloudTrail.

We replaced the term "master account" with the term "administrator account". An administrator account is used to centrally manage multiple accounts. In the case of Detective, the administrator account manages the accounts in their behavior graph.

  • Field Details

  • Method Details

    • acceptInvitation

      default CompletableFuture<AcceptInvitationResponse> acceptInvitation(AcceptInvitationRequest acceptInvitationRequest)

      Accepts an invitation for the member account to contribute data to a behavior graph. This operation can only be called by an invited member account.

      The request provides the ARN of behavior graph.

      The member account status in the graph must be INVITED.

      Parameters:
      acceptInvitationRequest -
      Returns:
      A Java Future containing the result of the AcceptInvitation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • ConflictException The request attempted an invalid action.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • acceptInvitation

      default CompletableFuture<AcceptInvitationResponse> acceptInvitation(Consumer<AcceptInvitationRequest.Builder> acceptInvitationRequest)

      Accepts an invitation for the member account to contribute data to a behavior graph. This operation can only be called by an invited member account.

      The request provides the ARN of behavior graph.

      The member account status in the graph must be INVITED.


      This is a convenience which creates an instance of the AcceptInvitationRequest.Builder avoiding the need to create one manually via AcceptInvitationRequest.builder()

      Parameters:
      acceptInvitationRequest - A Consumer that will call methods on AcceptInvitationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the AcceptInvitation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • ConflictException The request attempted an invalid action.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • batchGetGraphMemberDatasources

      default CompletableFuture<BatchGetGraphMemberDatasourcesResponse> batchGetGraphMemberDatasources(BatchGetGraphMemberDatasourcesRequest batchGetGraphMemberDatasourcesRequest)

      Gets data source package information for the behavior graph.

      Parameters:
      batchGetGraphMemberDatasourcesRequest -
      Returns:
      A Java Future containing the result of the BatchGetGraphMemberDatasources operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • batchGetGraphMemberDatasources

      default CompletableFuture<BatchGetGraphMemberDatasourcesResponse> batchGetGraphMemberDatasources(Consumer<BatchGetGraphMemberDatasourcesRequest.Builder> batchGetGraphMemberDatasourcesRequest)

      Gets data source package information for the behavior graph.


      This is a convenience which creates an instance of the BatchGetGraphMemberDatasourcesRequest.Builder avoiding the need to create one manually via BatchGetGraphMemberDatasourcesRequest.builder()

      Parameters:
      batchGetGraphMemberDatasourcesRequest - A Consumer that will call methods on BatchGetGraphMemberDatasourcesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the BatchGetGraphMemberDatasources operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • batchGetMembershipDatasources

      default CompletableFuture<BatchGetMembershipDatasourcesResponse> batchGetMembershipDatasources(BatchGetMembershipDatasourcesRequest batchGetMembershipDatasourcesRequest)

      Gets information on the data source package history for an account.

      Parameters:
      batchGetMembershipDatasourcesRequest -
      Returns:
      A Java Future containing the result of the BatchGetMembershipDatasources operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • batchGetMembershipDatasources

      default CompletableFuture<BatchGetMembershipDatasourcesResponse> batchGetMembershipDatasources(Consumer<BatchGetMembershipDatasourcesRequest.Builder> batchGetMembershipDatasourcesRequest)

      Gets information on the data source package history for an account.


      This is a convenience which creates an instance of the BatchGetMembershipDatasourcesRequest.Builder avoiding the need to create one manually via BatchGetMembershipDatasourcesRequest.builder()

      Parameters:
      batchGetMembershipDatasourcesRequest - A Consumer that will call methods on BatchGetMembershipDatasourcesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the BatchGetMembershipDatasources operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createGraph

      default CompletableFuture<CreateGraphResponse> createGraph(CreateGraphRequest createGraphRequest)

      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.

      The operation also enables Detective for the calling account in the currently selected Region. It returns the ARN of the new behavior graph.

      CreateGraph triggers a process to create the corresponding data tables for the new behavior graph.

      An account can only be the administrator account for one behavior graph within a Region. If the same account calls CreateGraph with the same administrator account, it always returns the same behavior graph ARN. It does not create a new behavior graph.

      Parameters:
      createGraphRequest -
      Returns:
      A Java Future containing the result of the CreateGraph operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • ConflictException The request attempted an invalid action.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ServiceQuotaExceededException This request cannot be completed for one of the following reasons.

        • This request cannot be completed if it would cause the number of member accounts in the behavior graph to exceed the maximum allowed. A behavior graph cannot have more than 1,200 member accounts.

        • This request cannot be completed if the current volume ingested is above the limit of 10 TB per day. Detective will not allow you to add additional member accounts.

        • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
        • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
        • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createGraph

      default CompletableFuture<CreateGraphResponse> createGraph(Consumer<CreateGraphRequest.Builder> createGraphRequest)

      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.

      The operation also enables Detective for the calling account in the currently selected Region. It returns the ARN of the new behavior graph.

      CreateGraph triggers a process to create the corresponding data tables for the new behavior graph.

      An account can only be the administrator account for one behavior graph within a Region. If the same account calls CreateGraph with the same administrator account, it always returns the same behavior graph ARN. It does not create a new behavior graph.


      This is a convenience which creates an instance of the CreateGraphRequest.Builder avoiding the need to create one manually via CreateGraphRequest.builder()

      Parameters:
      createGraphRequest - A Consumer that will call methods on CreateGraphRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateGraph operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • ConflictException The request attempted an invalid action.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ServiceQuotaExceededException This request cannot be completed for one of the following reasons.

        • This request cannot be completed if it would cause the number of member accounts in the behavior graph to exceed the maximum allowed. A behavior graph cannot have more than 1,200 member accounts.

        • This request cannot be completed if the current volume ingested is above the limit of 10 TB per day. Detective will not allow you to add additional member accounts.

        • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
        • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
        • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createMembers

      default CompletableFuture<CreateMembersResponse> createMembers(CreateMembersRequest createMembersRequest)

      CreateMembers is used to send invitations to accounts. For the organization behavior graph, the Detective administrator account uses CreateMembers to enable organization accounts as member accounts.

      For invited accounts, CreateMembers sends a request to invite the specified Amazon Web Services accounts to be member accounts in the behavior graph. This operation can only be called by the administrator account for a behavior graph.

      CreateMembers verifies the accounts and then invites the verified accounts. The administrator can optionally specify to not send invitation emails to the member accounts. This would be used when the administrator manages their member accounts centrally.

      For organization accounts in the organization behavior graph, CreateMembers attempts to enable the accounts. The organization accounts do not receive invitations.

      The request provides the behavior graph ARN and the list of accounts to invite or to enable.

      The response separates the requested accounts into two lists:

      • The accounts that CreateMembers was able to process. For invited accounts, includes member accounts that are being verified, that have passed verification and are to be invited, and that have failed verification. For organization accounts in the organization behavior graph, includes accounts that can be enabled and that cannot be enabled.

      • The accounts that CreateMembers was unable to process. This list includes accounts that were already invited to be member accounts in the behavior graph.

      Parameters:
      createMembersRequest -
      Returns:
      A Java Future containing the result of the CreateMembers operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • ServiceQuotaExceededException This request cannot be completed for one of the following reasons.

        • This request cannot be completed if it would cause the number of member accounts in the behavior graph to exceed the maximum allowed. A behavior graph cannot have more than 1,200 member accounts.

        • This request cannot be completed if the current volume ingested is above the limit of 10 TB per day. Detective will not allow you to add additional member accounts.

        • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
        • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
        • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createMembers

      default CompletableFuture<CreateMembersResponse> createMembers(Consumer<CreateMembersRequest.Builder> createMembersRequest)

      CreateMembers is used to send invitations to accounts. For the organization behavior graph, the Detective administrator account uses CreateMembers to enable organization accounts as member accounts.

      For invited accounts, CreateMembers sends a request to invite the specified Amazon Web Services accounts to be member accounts in the behavior graph. This operation can only be called by the administrator account for a behavior graph.

      CreateMembers verifies the accounts and then invites the verified accounts. The administrator can optionally specify to not send invitation emails to the member accounts. This would be used when the administrator manages their member accounts centrally.

      For organization accounts in the organization behavior graph, CreateMembers attempts to enable the accounts. The organization accounts do not receive invitations.

      The request provides the behavior graph ARN and the list of accounts to invite or to enable.

      The response separates the requested accounts into two lists:

      • The accounts that CreateMembers was able to process. For invited accounts, includes member accounts that are being verified, that have passed verification and are to be invited, and that have failed verification. For organization accounts in the organization behavior graph, includes accounts that can be enabled and that cannot be enabled.

      • The accounts that CreateMembers was unable to process. This list includes accounts that were already invited to be member accounts in the behavior graph.


      This is a convenience which creates an instance of the CreateMembersRequest.Builder avoiding the need to create one manually via CreateMembersRequest.builder()

      Parameters:
      createMembersRequest - A Consumer that will call methods on CreateMembersRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateMembers operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • ServiceQuotaExceededException This request cannot be completed for one of the following reasons.

        • This request cannot be completed if it would cause the number of member accounts in the behavior graph to exceed the maximum allowed. A behavior graph cannot have more than 1,200 member accounts.

        • This request cannot be completed if the current volume ingested is above the limit of 10 TB per day. Detective will not allow you to add additional member accounts.

        • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
        • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
        • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteGraph

      default CompletableFuture<DeleteGraphResponse> deleteGraph(DeleteGraphRequest deleteGraphRequest)

      Disables the specified behavior graph and queues it to be deleted. This operation removes the behavior graph from each member account's list of behavior graphs.

      DeleteGraph can only be called by the administrator account for a behavior graph.

      Parameters:
      deleteGraphRequest -
      Returns:
      A Java Future containing the result of the DeleteGraph operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteGraph

      default CompletableFuture<DeleteGraphResponse> deleteGraph(Consumer<DeleteGraphRequest.Builder> deleteGraphRequest)

      Disables the specified behavior graph and queues it to be deleted. This operation removes the behavior graph from each member account's list of behavior graphs.

      DeleteGraph can only be called by the administrator account for a behavior graph.


      This is a convenience which creates an instance of the DeleteGraphRequest.Builder avoiding the need to create one manually via DeleteGraphRequest.builder()

      Parameters:
      deleteGraphRequest - A Consumer that will call methods on DeleteGraphRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteGraph operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteMembers

      default CompletableFuture<DeleteMembersResponse> deleteMembers(DeleteMembersRequest deleteMembersRequest)

      Removes the specified member accounts from the behavior graph. The removed accounts no longer contribute data to the behavior graph. This operation can only be called by the administrator account for the behavior graph.

      For invited accounts, the removed accounts are deleted from the list of accounts in the behavior graph. To restore the account, the administrator account must send another invitation.

      For organization accounts in the organization behavior graph, the Detective administrator account can always enable the organization account again. Organization accounts that are not enabled as member accounts are not included in the ListMembers results for the organization behavior graph.

      An administrator account cannot use DeleteMembers to remove their own account from the behavior graph. To disable a behavior graph, the administrator account uses the DeleteGraph API method.

      Parameters:
      deleteMembersRequest -
      Returns:
      A Java Future containing the result of the DeleteMembers operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • ConflictException The request attempted an invalid action.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteMembers

      default CompletableFuture<DeleteMembersResponse> deleteMembers(Consumer<DeleteMembersRequest.Builder> deleteMembersRequest)

      Removes the specified member accounts from the behavior graph. The removed accounts no longer contribute data to the behavior graph. This operation can only be called by the administrator account for the behavior graph.

      For invited accounts, the removed accounts are deleted from the list of accounts in the behavior graph. To restore the account, the administrator account must send another invitation.

      For organization accounts in the organization behavior graph, the Detective administrator account can always enable the organization account again. Organization accounts that are not enabled as member accounts are not included in the ListMembers results for the organization behavior graph.

      An administrator account cannot use DeleteMembers to remove their own account from the behavior graph. To disable a behavior graph, the administrator account uses the DeleteGraph API method.


      This is a convenience which creates an instance of the DeleteMembersRequest.Builder avoiding the need to create one manually via DeleteMembersRequest.builder()

      Parameters:
      deleteMembersRequest - A Consumer that will call methods on DeleteMembersRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteMembers operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • ConflictException The request attempted an invalid action.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • describeOrganizationConfiguration

      default CompletableFuture<DescribeOrganizationConfigurationResponse> describeOrganizationConfiguration(DescribeOrganizationConfigurationRequest describeOrganizationConfigurationRequest)

      Returns information about the configuration for the organization behavior graph. Currently indicates whether to automatically enable new organization accounts as member accounts.

      Can only be called by the Detective administrator account for the organization.

      Parameters:
      describeOrganizationConfigurationRequest -
      Returns:
      A Java Future containing the result of the DescribeOrganizationConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • describeOrganizationConfiguration

      default CompletableFuture<DescribeOrganizationConfigurationResponse> describeOrganizationConfiguration(Consumer<DescribeOrganizationConfigurationRequest.Builder> describeOrganizationConfigurationRequest)

      Returns information about the configuration for the organization behavior graph. Currently indicates whether to automatically enable new organization accounts as member accounts.

      Can only be called by the Detective administrator account for the organization.


      This is a convenience which creates an instance of the DescribeOrganizationConfigurationRequest.Builder avoiding the need to create one manually via DescribeOrganizationConfigurationRequest.builder()

      Parameters:
      describeOrganizationConfigurationRequest - A Consumer that will call methods on DescribeOrganizationConfigurationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeOrganizationConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • disableOrganizationAdminAccount

      default CompletableFuture<DisableOrganizationAdminAccountResponse> disableOrganizationAdminAccount(DisableOrganizationAdminAccountRequest disableOrganizationAdminAccountRequest)

      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.

      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.

      Parameters:
      disableOrganizationAdminAccountRequest -
      Returns:
      A Java Future containing the result of the DisableOrganizationAdminAccount operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • disableOrganizationAdminAccount

      default CompletableFuture<DisableOrganizationAdminAccountResponse> disableOrganizationAdminAccount(Consumer<DisableOrganizationAdminAccountRequest.Builder> disableOrganizationAdminAccountRequest)

      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.

      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.


      This is a convenience which creates an instance of the DisableOrganizationAdminAccountRequest.Builder avoiding the need to create one manually via DisableOrganizationAdminAccountRequest.builder()

      Parameters:
      disableOrganizationAdminAccountRequest - A Consumer that will call methods on DisableOrganizationAdminAccountRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DisableOrganizationAdminAccount operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • disassociateMembership

      default CompletableFuture<DisassociateMembershipResponse> disassociateMembership(DisassociateMembershipRequest disassociateMembershipRequest)

      Removes the member account from the specified behavior graph. This operation can only be called by an invited member account that has the ENABLED status.

      DisassociateMembership cannot be called by an organization account in the organization behavior graph. For the organization behavior graph, the Detective administrator account determines which organization accounts to enable or disable as member accounts.

      Parameters:
      disassociateMembershipRequest -
      Returns:
      A Java Future containing the result of the DisassociateMembership operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • ConflictException The request attempted an invalid action.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • disassociateMembership

      default CompletableFuture<DisassociateMembershipResponse> disassociateMembership(Consumer<DisassociateMembershipRequest.Builder> disassociateMembershipRequest)

      Removes the member account from the specified behavior graph. This operation can only be called by an invited member account that has the ENABLED status.

      DisassociateMembership cannot be called by an organization account in the organization behavior graph. For the organization behavior graph, the Detective administrator account determines which organization accounts to enable or disable as member accounts.


      This is a convenience which creates an instance of the DisassociateMembershipRequest.Builder avoiding the need to create one manually via DisassociateMembershipRequest.builder()

      Parameters:
      disassociateMembershipRequest - A Consumer that will call methods on DisassociateMembershipRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DisassociateMembership operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • ConflictException The request attempted an invalid action.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • enableOrganizationAdminAccount

      default CompletableFuture<EnableOrganizationAdminAccountResponse> enableOrganizationAdminAccount(EnableOrganizationAdminAccountRequest enableOrganizationAdminAccountRequest)

      Designates the Detective administrator account for the organization in the current Region.

      If the account does not have Detective enabled, then enables Detective for that account and creates a new behavior graph.

      Can only be called by the organization management 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.

      Parameters:
      enableOrganizationAdminAccountRequest -
      Returns:
      A Java Future containing the result of the EnableOrganizationAdminAccount operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • enableOrganizationAdminAccount

      default CompletableFuture<EnableOrganizationAdminAccountResponse> enableOrganizationAdminAccount(Consumer<EnableOrganizationAdminAccountRequest.Builder> enableOrganizationAdminAccountRequest)

      Designates the Detective administrator account for the organization in the current Region.

      If the account does not have Detective enabled, then enables Detective for that account and creates a new behavior graph.

      Can only be called by the organization management 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.


      This is a convenience which creates an instance of the EnableOrganizationAdminAccountRequest.Builder avoiding the need to create one manually via EnableOrganizationAdminAccountRequest.builder()

      Parameters:
      enableOrganizationAdminAccountRequest - A Consumer that will call methods on EnableOrganizationAdminAccountRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the EnableOrganizationAdminAccount operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getInvestigation

      default CompletableFuture<GetInvestigationResponse> getInvestigation(GetInvestigationRequest getInvestigationRequest)

      Detective investigations lets you investigate IAM users and IAM roles using indicators of compromise. An indicator of compromise (IOC) is an artifact observed in or on a network, system, or environment that can (with a high level of confidence) identify malicious activity or a security incident. GetInvestigation returns the investigation results of an investigation for a behavior graph.

      Parameters:
      getInvestigationRequest -
      Returns:
      A Java Future containing the result of the GetInvestigation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getInvestigation

      default CompletableFuture<GetInvestigationResponse> getInvestigation(Consumer<GetInvestigationRequest.Builder> getInvestigationRequest)

      Detective investigations lets you investigate IAM users and IAM roles using indicators of compromise. An indicator of compromise (IOC) is an artifact observed in or on a network, system, or environment that can (with a high level of confidence) identify malicious activity or a security incident. GetInvestigation returns the investigation results of an investigation for a behavior graph.


      This is a convenience which creates an instance of the GetInvestigationRequest.Builder avoiding the need to create one manually via GetInvestigationRequest.builder()

      Parameters:
      getInvestigationRequest - A Consumer that will call methods on GetInvestigationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetInvestigation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getMembers

      default CompletableFuture<GetMembersResponse> getMembers(GetMembersRequest getMembersRequest)

      Returns the membership details for specified member accounts for a behavior graph.

      Parameters:
      getMembersRequest -
      Returns:
      A Java Future containing the result of the GetMembers operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getMembers

      default CompletableFuture<GetMembersResponse> getMembers(Consumer<GetMembersRequest.Builder> getMembersRequest)

      Returns the membership details for specified member accounts for a behavior graph.


      This is a convenience which creates an instance of the GetMembersRequest.Builder avoiding the need to create one manually via GetMembersRequest.builder()

      Parameters:
      getMembersRequest - A Consumer that will call methods on GetMembersRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetMembers operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listDatasourcePackages

      default CompletableFuture<ListDatasourcePackagesResponse> listDatasourcePackages(ListDatasourcePackagesRequest listDatasourcePackagesRequest)

      Lists data source packages in the behavior graph.

      Parameters:
      listDatasourcePackagesRequest -
      Returns:
      A Java Future containing the result of the ListDatasourcePackages operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listDatasourcePackages

      default CompletableFuture<ListDatasourcePackagesResponse> listDatasourcePackages(Consumer<ListDatasourcePackagesRequest.Builder> listDatasourcePackagesRequest)

      Lists data source packages in the behavior graph.


      This is a convenience which creates an instance of the ListDatasourcePackagesRequest.Builder avoiding the need to create one manually via ListDatasourcePackagesRequest.builder()

      Parameters:
      listDatasourcePackagesRequest - A Consumer that will call methods on ListDatasourcePackagesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListDatasourcePackages operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listDatasourcePackagesPaginator

      default ListDatasourcePackagesPublisher listDatasourcePackagesPaginator(ListDatasourcePackagesRequest listDatasourcePackagesRequest)

      This is a variant of listDatasourcePackages(software.amazon.awssdk.services.detective.model.ListDatasourcePackagesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.detective.paginators.ListDatasourcePackagesPublisher publisher = client.listDatasourcePackagesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.detective.paginators.ListDatasourcePackagesPublisher publisher = client.listDatasourcePackagesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.detective.model.ListDatasourcePackagesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.detective.model.ListDatasourcePackagesResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listDatasourcePackages(software.amazon.awssdk.services.detective.model.ListDatasourcePackagesRequest) operation.

      Parameters:
      listDatasourcePackagesRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listDatasourcePackagesPaginator

      default ListDatasourcePackagesPublisher listDatasourcePackagesPaginator(Consumer<ListDatasourcePackagesRequest.Builder> listDatasourcePackagesRequest)

      This is a variant of listDatasourcePackages(software.amazon.awssdk.services.detective.model.ListDatasourcePackagesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.detective.paginators.ListDatasourcePackagesPublisher publisher = client.listDatasourcePackagesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.detective.paginators.ListDatasourcePackagesPublisher publisher = client.listDatasourcePackagesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.detective.model.ListDatasourcePackagesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.detective.model.ListDatasourcePackagesResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listDatasourcePackages(software.amazon.awssdk.services.detective.model.ListDatasourcePackagesRequest) operation.


      This is a convenience which creates an instance of the ListDatasourcePackagesRequest.Builder avoiding the need to create one manually via ListDatasourcePackagesRequest.builder()

      Parameters:
      listDatasourcePackagesRequest - A Consumer that will call methods on ListDatasourcePackagesRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listGraphs

      default CompletableFuture<ListGraphsResponse> listGraphs(ListGraphsRequest listGraphsRequest)

      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.

      Because an account can currently only be the administrator of one behavior graph within a Region, the results always contain a single behavior graph.

      Parameters:
      listGraphsRequest -
      Returns:
      A Java Future containing the result of the ListGraphs operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listGraphs

      default CompletableFuture<ListGraphsResponse> listGraphs(Consumer<ListGraphsRequest.Builder> listGraphsRequest)

      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.

      Because an account can currently only be the administrator of one behavior graph within a Region, the results always contain a single behavior graph.


      This is a convenience which creates an instance of the ListGraphsRequest.Builder avoiding the need to create one manually via ListGraphsRequest.builder()

      Parameters:
      listGraphsRequest - A Consumer that will call methods on ListGraphsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListGraphs operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listGraphsPaginator

      default ListGraphsPublisher listGraphsPaginator(ListGraphsRequest listGraphsRequest)

      This is a variant of listGraphs(software.amazon.awssdk.services.detective.model.ListGraphsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.detective.paginators.ListGraphsPublisher publisher = client.listGraphsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.detective.paginators.ListGraphsPublisher publisher = client.listGraphsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.detective.model.ListGraphsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.detective.model.ListGraphsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listGraphs(software.amazon.awssdk.services.detective.model.ListGraphsRequest) operation.

      Parameters:
      listGraphsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listGraphsPaginator

      default ListGraphsPublisher listGraphsPaginator(Consumer<ListGraphsRequest.Builder> listGraphsRequest)

      This is a variant of listGraphs(software.amazon.awssdk.services.detective.model.ListGraphsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.detective.paginators.ListGraphsPublisher publisher = client.listGraphsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.detective.paginators.ListGraphsPublisher publisher = client.listGraphsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.detective.model.ListGraphsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.detective.model.ListGraphsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listGraphs(software.amazon.awssdk.services.detective.model.ListGraphsRequest) operation.


      This is a convenience which creates an instance of the ListGraphsRequest.Builder avoiding the need to create one manually via ListGraphsRequest.builder()

      Parameters:
      listGraphsRequest - A Consumer that will call methods on ListGraphsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listIndicators

      default CompletableFuture<ListIndicatorsResponse> listIndicators(ListIndicatorsRequest listIndicatorsRequest)

      Gets the indicators from an investigation. You can use the information from the indicators to determine if an IAM user and/or IAM role is involved in an unusual activity that could indicate malicious behavior and its impact.

      Parameters:
      listIndicatorsRequest -
      Returns:
      A Java Future containing the result of the ListIndicators operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listIndicators

      default CompletableFuture<ListIndicatorsResponse> listIndicators(Consumer<ListIndicatorsRequest.Builder> listIndicatorsRequest)

      Gets the indicators from an investigation. You can use the information from the indicators to determine if an IAM user and/or IAM role is involved in an unusual activity that could indicate malicious behavior and its impact.


      This is a convenience which creates an instance of the ListIndicatorsRequest.Builder avoiding the need to create one manually via ListIndicatorsRequest.builder()

      Parameters:
      listIndicatorsRequest - A Consumer that will call methods on ListIndicatorsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListIndicators operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listInvestigations

      default CompletableFuture<ListInvestigationsResponse> listInvestigations(ListInvestigationsRequest listInvestigationsRequest)

      Detective investigations lets you investigate IAM users and IAM roles using indicators of compromise. An indicator of compromise (IOC) is an artifact observed in or on a network, system, or environment that can (with a high level of confidence) identify malicious activity or a security incident. ListInvestigations lists all active Detective investigations.

      Parameters:
      listInvestigationsRequest -
      Returns:
      A Java Future containing the result of the ListInvestigations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listInvestigations

      default CompletableFuture<ListInvestigationsResponse> listInvestigations(Consumer<ListInvestigationsRequest.Builder> listInvestigationsRequest)

      Detective investigations lets you investigate IAM users and IAM roles using indicators of compromise. An indicator of compromise (IOC) is an artifact observed in or on a network, system, or environment that can (with a high level of confidence) identify malicious activity or a security incident. ListInvestigations lists all active Detective investigations.


      This is a convenience which creates an instance of the ListInvestigationsRequest.Builder avoiding the need to create one manually via ListInvestigationsRequest.builder()

      Parameters:
      listInvestigationsRequest - A Consumer that will call methods on ListInvestigationsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListInvestigations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listInvitations

      default CompletableFuture<ListInvitationsResponse> listInvitations(ListInvitationsRequest listInvitationsRequest)

      Retrieves the list of open and accepted behavior graph invitations for the member account. This operation can only be called by an invited member account.

      Open invitations are invitations that the member account has not responded to.

      The results do not include behavior graphs for which the member account declined the invitation. The results also do not include behavior graphs that the member account resigned from or was removed from.

      Parameters:
      listInvitationsRequest -
      Returns:
      A Java Future containing the result of the ListInvitations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listInvitations

      default CompletableFuture<ListInvitationsResponse> listInvitations(Consumer<ListInvitationsRequest.Builder> listInvitationsRequest)

      Retrieves the list of open and accepted behavior graph invitations for the member account. This operation can only be called by an invited member account.

      Open invitations are invitations that the member account has not responded to.

      The results do not include behavior graphs for which the member account declined the invitation. The results also do not include behavior graphs that the member account resigned from or was removed from.


      This is a convenience which creates an instance of the ListInvitationsRequest.Builder avoiding the need to create one manually via ListInvitationsRequest.builder()

      Parameters:
      listInvitationsRequest - A Consumer that will call methods on ListInvitationsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListInvitations operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listInvitationsPaginator

      default ListInvitationsPublisher listInvitationsPaginator(ListInvitationsRequest listInvitationsRequest)

      This is a variant of listInvitations(software.amazon.awssdk.services.detective.model.ListInvitationsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.detective.paginators.ListInvitationsPublisher publisher = client.listInvitationsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.detective.paginators.ListInvitationsPublisher publisher = client.listInvitationsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.detective.model.ListInvitationsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.detective.model.ListInvitationsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listInvitations(software.amazon.awssdk.services.detective.model.ListInvitationsRequest) operation.

      Parameters:
      listInvitationsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listInvitationsPaginator

      default ListInvitationsPublisher listInvitationsPaginator(Consumer<ListInvitationsRequest.Builder> listInvitationsRequest)

      This is a variant of listInvitations(software.amazon.awssdk.services.detective.model.ListInvitationsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.detective.paginators.ListInvitationsPublisher publisher = client.listInvitationsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.detective.paginators.ListInvitationsPublisher publisher = client.listInvitationsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.detective.model.ListInvitationsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.detective.model.ListInvitationsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listInvitations(software.amazon.awssdk.services.detective.model.ListInvitationsRequest) operation.


      This is a convenience which creates an instance of the ListInvitationsRequest.Builder avoiding the need to create one manually via ListInvitationsRequest.builder()

      Parameters:
      listInvitationsRequest - A Consumer that will call methods on ListInvitationsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listMembers

      default CompletableFuture<ListMembersResponse> listMembers(ListMembersRequest listMembersRequest)

      Retrieves the list of member accounts for a behavior graph.

      For invited accounts, the results do not include member accounts that were removed from the behavior graph.

      For the organization behavior graph, the results do not include organization accounts that the Detective administrator account has not enabled as member accounts.

      Parameters:
      listMembersRequest -
      Returns:
      A Java Future containing the result of the ListMembers operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listMembers

      default CompletableFuture<ListMembersResponse> listMembers(Consumer<ListMembersRequest.Builder> listMembersRequest)

      Retrieves the list of member accounts for a behavior graph.

      For invited accounts, the results do not include member accounts that were removed from the behavior graph.

      For the organization behavior graph, the results do not include organization accounts that the Detective administrator account has not enabled as member accounts.


      This is a convenience which creates an instance of the ListMembersRequest.Builder avoiding the need to create one manually via ListMembersRequest.builder()

      Parameters:
      listMembersRequest - A Consumer that will call methods on ListMembersRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListMembers operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listMembersPaginator

      default ListMembersPublisher listMembersPaginator(ListMembersRequest listMembersRequest)

      This is a variant of listMembers(software.amazon.awssdk.services.detective.model.ListMembersRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.detective.paginators.ListMembersPublisher publisher = client.listMembersPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.detective.paginators.ListMembersPublisher publisher = client.listMembersPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.detective.model.ListMembersResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.detective.model.ListMembersResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listMembers(software.amazon.awssdk.services.detective.model.ListMembersRequest) operation.

      Parameters:
      listMembersRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listMembersPaginator

      default ListMembersPublisher listMembersPaginator(Consumer<ListMembersRequest.Builder> listMembersRequest)

      This is a variant of listMembers(software.amazon.awssdk.services.detective.model.ListMembersRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.detective.paginators.ListMembersPublisher publisher = client.listMembersPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.detective.paginators.ListMembersPublisher publisher = client.listMembersPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.detective.model.ListMembersResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.detective.model.ListMembersResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listMembers(software.amazon.awssdk.services.detective.model.ListMembersRequest) operation.


      This is a convenience which creates an instance of the ListMembersRequest.Builder avoiding the need to create one manually via ListMembersRequest.builder()

      Parameters:
      listMembersRequest - A Consumer that will call methods on ListMembersRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listOrganizationAdminAccounts

      default CompletableFuture<ListOrganizationAdminAccountsResponse> listOrganizationAdminAccounts(ListOrganizationAdminAccountsRequest listOrganizationAdminAccountsRequest)

      Returns information about the Detective administrator account for an organization. Can only be called by the organization management account.

      Parameters:
      listOrganizationAdminAccountsRequest -
      Returns:
      A Java Future containing the result of the ListOrganizationAdminAccounts operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listOrganizationAdminAccounts

      default CompletableFuture<ListOrganizationAdminAccountsResponse> listOrganizationAdminAccounts(Consumer<ListOrganizationAdminAccountsRequest.Builder> listOrganizationAdminAccountsRequest)

      Returns information about the Detective administrator account for an organization. Can only be called by the organization management account.


      This is a convenience which creates an instance of the ListOrganizationAdminAccountsRequest.Builder avoiding the need to create one manually via ListOrganizationAdminAccountsRequest.builder()

      Parameters:
      listOrganizationAdminAccountsRequest - A Consumer that will call methods on ListOrganizationAdminAccountsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListOrganizationAdminAccounts operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listOrganizationAdminAccountsPaginator

      default ListOrganizationAdminAccountsPublisher listOrganizationAdminAccountsPaginator(ListOrganizationAdminAccountsRequest listOrganizationAdminAccountsRequest)

      This is a variant of listOrganizationAdminAccounts(software.amazon.awssdk.services.detective.model.ListOrganizationAdminAccountsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.detective.paginators.ListOrganizationAdminAccountsPublisher publisher = client.listOrganizationAdminAccountsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.detective.paginators.ListOrganizationAdminAccountsPublisher publisher = client.listOrganizationAdminAccountsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.detective.model.ListOrganizationAdminAccountsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.detective.model.ListOrganizationAdminAccountsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listOrganizationAdminAccounts(software.amazon.awssdk.services.detective.model.ListOrganizationAdminAccountsRequest) operation.

      Parameters:
      listOrganizationAdminAccountsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listOrganizationAdminAccountsPaginator

      default ListOrganizationAdminAccountsPublisher listOrganizationAdminAccountsPaginator(Consumer<ListOrganizationAdminAccountsRequest.Builder> listOrganizationAdminAccountsRequest)

      This is a variant of listOrganizationAdminAccounts(software.amazon.awssdk.services.detective.model.ListOrganizationAdminAccountsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.detective.paginators.ListOrganizationAdminAccountsPublisher publisher = client.listOrganizationAdminAccountsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.detective.paginators.ListOrganizationAdminAccountsPublisher publisher = client.listOrganizationAdminAccountsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.detective.model.ListOrganizationAdminAccountsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.detective.model.ListOrganizationAdminAccountsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listOrganizationAdminAccounts(software.amazon.awssdk.services.detective.model.ListOrganizationAdminAccountsRequest) operation.


      This is a convenience which creates an instance of the ListOrganizationAdminAccountsRequest.Builder avoiding the need to create one manually via ListOrganizationAdminAccountsRequest.builder()

      Parameters:
      listOrganizationAdminAccountsRequest - A Consumer that will call methods on ListOrganizationAdminAccountsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTagsForResource

      default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)

      Returns the tag values that are assigned to a behavior graph.

      Parameters:
      listTagsForResourceRequest -
      Returns:
      A Java Future containing the result of the ListTagsForResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTagsForResource

      default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)

      Returns the tag values that are assigned to a behavior graph.


      This is a convenience which creates an instance of the ListTagsForResourceRequest.Builder avoiding the need to create one manually via ListTagsForResourceRequest.builder()

      Parameters:
      listTagsForResourceRequest - A Consumer that will call methods on ListTagsForResourceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListTagsForResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • rejectInvitation

      default CompletableFuture<RejectInvitationResponse> rejectInvitation(RejectInvitationRequest rejectInvitationRequest)

      Rejects an invitation to contribute the account data to a behavior graph. This operation must be called by an invited member account that has the INVITED status.

      RejectInvitation cannot be called by an organization account in the organization behavior graph. In the organization behavior graph, organization accounts do not receive an invitation.

      Parameters:
      rejectInvitationRequest -
      Returns:
      A Java Future containing the result of the RejectInvitation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • ConflictException The request attempted an invalid action.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • rejectInvitation

      default CompletableFuture<RejectInvitationResponse> rejectInvitation(Consumer<RejectInvitationRequest.Builder> rejectInvitationRequest)

      Rejects an invitation to contribute the account data to a behavior graph. This operation must be called by an invited member account that has the INVITED status.

      RejectInvitation cannot be called by an organization account in the organization behavior graph. In the organization behavior graph, organization accounts do not receive an invitation.


      This is a convenience which creates an instance of the RejectInvitationRequest.Builder avoiding the need to create one manually via RejectInvitationRequest.builder()

      Parameters:
      rejectInvitationRequest - A Consumer that will call methods on RejectInvitationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the RejectInvitation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • ConflictException The request attempted an invalid action.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ValidationException The request parameters are invalid.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • startInvestigation

      default CompletableFuture<StartInvestigationResponse> startInvestigation(StartInvestigationRequest startInvestigationRequest)

      Detective investigations lets you investigate IAM users and IAM roles using indicators of compromise. An indicator of compromise (IOC) is an artifact observed in or on a network, system, or environment that can (with a high level of confidence) identify malicious activity or a security incident. StartInvestigation initiates an investigation on an entity in a behavior graph.

      Parameters:
      startInvestigationRequest -
      Returns:
      A Java Future containing the result of the StartInvestigation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • startInvestigation

      default CompletableFuture<StartInvestigationResponse> startInvestigation(Consumer<StartInvestigationRequest.Builder> startInvestigationRequest)

      Detective investigations lets you investigate IAM users and IAM roles using indicators of compromise. An indicator of compromise (IOC) is an artifact observed in or on a network, system, or environment that can (with a high level of confidence) identify malicious activity or a security incident. StartInvestigation initiates an investigation on an entity in a behavior graph.


      This is a convenience which creates an instance of the StartInvestigationRequest.Builder avoiding the need to create one manually via StartInvestigationRequest.builder()

      Parameters:
      startInvestigationRequest - A Consumer that will call methods on StartInvestigationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the StartInvestigation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • startMonitoringMember

      default CompletableFuture<StartMonitoringMemberResponse> startMonitoringMember(StartMonitoringMemberRequest startMonitoringMemberRequest)

      Sends a request to enable data ingest for a member account that has a status of ACCEPTED_BUT_DISABLED.

      For valid member accounts, the status is updated as follows.

      • If Detective enabled the member account, then the new status is ENABLED.

      • If Detective cannot enable the member account, the status remains ACCEPTED_BUT_DISABLED.

      Parameters:
      startMonitoringMemberRequest -
      Returns:
      A Java Future containing the result of the StartMonitoringMember operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • ConflictException The request attempted an invalid action.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ServiceQuotaExceededException This request cannot be completed for one of the following reasons.

        • This request cannot be completed if it would cause the number of member accounts in the behavior graph to exceed the maximum allowed. A behavior graph cannot have more than 1,200 member accounts.

        • This request cannot be completed if the current volume ingested is above the limit of 10 TB per day. Detective will not allow you to add additional member accounts.

        • ValidationException The request parameters are invalid.
        • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
        • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
        • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • startMonitoringMember

      default CompletableFuture<StartMonitoringMemberResponse> startMonitoringMember(Consumer<StartMonitoringMemberRequest.Builder> startMonitoringMemberRequest)

      Sends a request to enable data ingest for a member account that has a status of ACCEPTED_BUT_DISABLED.

      For valid member accounts, the status is updated as follows.

      • If Detective enabled the member account, then the new status is ENABLED.

      • If Detective cannot enable the member account, the status remains ACCEPTED_BUT_DISABLED.


      This is a convenience which creates an instance of the StartMonitoringMemberRequest.Builder avoiding the need to create one manually via StartMonitoringMemberRequest.builder()

      Parameters:
      startMonitoringMemberRequest - A Consumer that will call methods on StartMonitoringMemberRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the StartMonitoringMember operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • ConflictException The request attempted an invalid action.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ServiceQuotaExceededException This request cannot be completed for one of the following reasons.

        • This request cannot be completed if it would cause the number of member accounts in the behavior graph to exceed the maximum allowed. A behavior graph cannot have more than 1,200 member accounts.

        • This request cannot be completed if the current volume ingested is above the limit of 10 TB per day. Detective will not allow you to add additional member accounts.

        • ValidationException The request parameters are invalid.
        • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
        • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
        • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • tagResource

      default CompletableFuture<TagResourceResponse> tagResource(TagResourceRequest tagResourceRequest)

      Applies tag values to a behavior graph.

      Parameters:
      tagResourceRequest -
      Returns:
      A Java Future containing the result of the TagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • tagResource

      default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest)

      Applies tag values to a behavior graph.


      This is a convenience which creates an instance of the TagResourceRequest.Builder avoiding the need to create one manually via TagResourceRequest.builder()

      Parameters:
      tagResourceRequest - A Consumer that will call methods on TagResourceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the TagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • untagResource

      default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest)

      Removes tags from a behavior graph.

      Parameters:
      untagResourceRequest -
      Returns:
      A Java Future containing the result of the UntagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • untagResource

      default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest)

      Removes tags from a behavior graph.


      This is a convenience which creates an instance of the UntagResourceRequest.Builder avoiding the need to create one manually via UntagResourceRequest.builder()

      Parameters:
      untagResourceRequest - A Consumer that will call methods on UntagResourceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UntagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateDatasourcePackages

      default CompletableFuture<UpdateDatasourcePackagesResponse> updateDatasourcePackages(UpdateDatasourcePackagesRequest updateDatasourcePackagesRequest)

      Starts a data source packages for the behavior graph.

      Parameters:
      updateDatasourcePackagesRequest -
      Returns:
      A Java Future containing the result of the UpdateDatasourcePackages operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ServiceQuotaExceededException This request cannot be completed for one of the following reasons.

        • This request cannot be completed if it would cause the number of member accounts in the behavior graph to exceed the maximum allowed. A behavior graph cannot have more than 1,200 member accounts.

        • This request cannot be completed if the current volume ingested is above the limit of 10 TB per day. Detective will not allow you to add additional member accounts.

        • ValidationException The request parameters are invalid.
        • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
        • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
        • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateDatasourcePackages

      default CompletableFuture<UpdateDatasourcePackagesResponse> updateDatasourcePackages(Consumer<UpdateDatasourcePackagesRequest.Builder> updateDatasourcePackagesRequest)

      Starts a data source packages for the behavior graph.


      This is a convenience which creates an instance of the UpdateDatasourcePackagesRequest.Builder avoiding the need to create one manually via UpdateDatasourcePackagesRequest.builder()

      Parameters:
      updateDatasourcePackagesRequest - A Consumer that will call methods on UpdateDatasourcePackagesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateDatasourcePackages operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • ServiceQuotaExceededException This request cannot be completed for one of the following reasons.

        • This request cannot be completed if it would cause the number of member accounts in the behavior graph to exceed the maximum allowed. A behavior graph cannot have more than 1,200 member accounts.

        • This request cannot be completed if the current volume ingested is above the limit of 10 TB per day. Detective will not allow you to add additional member accounts.

        • ValidationException The request parameters are invalid.
        • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
        • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
        • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateInvestigationState

      default CompletableFuture<UpdateInvestigationStateResponse> updateInvestigationState(UpdateInvestigationStateRequest updateInvestigationStateRequest)

      Updates the state of an investigation.

      Parameters:
      updateInvestigationStateRequest -
      Returns:
      A Java Future containing the result of the UpdateInvestigationState operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateInvestigationState

      default CompletableFuture<UpdateInvestigationStateResponse> updateInvestigationState(Consumer<UpdateInvestigationStateRequest.Builder> updateInvestigationStateRequest)

      Updates the state of an investigation.


      This is a convenience which creates an instance of the UpdateInvestigationStateRequest.Builder avoiding the need to create one manually via UpdateInvestigationStateRequest.builder()

      Parameters:
      updateInvestigationStateRequest - A Consumer that will call methods on UpdateInvestigationStateRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateInvestigationState operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • ResourceNotFoundException The request refers to a nonexistent resource.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateOrganizationConfiguration

      default CompletableFuture<UpdateOrganizationConfigurationResponse> updateOrganizationConfiguration(UpdateOrganizationConfigurationRequest updateOrganizationConfigurationRequest)

      Updates the configuration for the Organizations integration in the current Region. Can only be called by the Detective administrator account for the organization.

      Parameters:
      updateOrganizationConfigurationRequest -
      Returns:
      A Java Future containing the result of the UpdateOrganizationConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateOrganizationConfiguration

      default CompletableFuture<UpdateOrganizationConfigurationResponse> updateOrganizationConfiguration(Consumer<UpdateOrganizationConfigurationRequest.Builder> updateOrganizationConfigurationRequest)

      Updates the configuration for the Organizations integration in the current Region. Can only be called by the Detective administrator account for the organization.


      This is a convenience which creates an instance of the UpdateOrganizationConfigurationRequest.Builder avoiding the need to create one manually via UpdateOrganizationConfigurationRequest.builder()

      Parameters:
      updateOrganizationConfigurationRequest - A Consumer that will call methods on UpdateOrganizationConfigurationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateOrganizationConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The request issuer does not have permission to access this resource or perform this operation.
      • InternalServerException The request was valid but failed because of a problem with the service.
      • ValidationException The request parameters are invalid.
      • TooManyRequestsException The request cannot be completed because too many other requests are occurring at the same time.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • DetectiveException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • serviceClientConfiguration

      default DetectiveServiceClientConfiguration serviceClientConfiguration()
      Description copied from interface: SdkClient
      The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration
      Specified by:
      serviceClientConfiguration in interface AwsClient
      Specified by:
      serviceClientConfiguration in interface SdkClient
      Returns:
      SdkServiceClientConfiguration

    • create

      static DetectiveAsyncClient create()
      Create a DetectiveAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

    • builder

      static DetectiveAsyncClientBuilder builder()
      Create a builder that can be used to configure and create a DetectiveAsyncClient.