Struct aws_sdk_detective::Client

pub struct Client { /* private fields */ }

Client for Amazon Detective

Client for invoking operations on Amazon Detective. Each operation on Amazon Detective is a method on this this struct. .send() MUST be invoked on the generated operations to dispatch the request to the service.

Examples

Constructing a client and invoking an operation

    // create a shared configuration. This can be used & shared between multiple service clients.
    let shared_config = aws_config::load_from_env().await;
    let client = aws_sdk_detective::Client::new(&shared_config);
    // invoke an operation
    /* let rsp = client
        .<operation_name>().
        .<param>("some value")
        .send().await; */

Constructing a client with custom configuration

use aws_config::retry::RetryConfig;
let shared_config = aws_config::load_from_env().await;
let config = aws_sdk_detective::config::Builder::from(&shared_config)
  .retry_config(RetryConfig::disabled())
  .build();
let client = aws_sdk_detective::Client::from_conf(config);

Implementations

impl Client

pub fn with_config(
    client: Client<DynConnector, DynMiddleware<DynConnector>>,
    conf: Config
) -> Self

Creates a client with the given service configuration.

Examples found in repository

src/client.rs (line 70)

    fn from(
        client: aws_smithy_client::Client<
            aws_smithy_client::erase::DynConnector,
            aws_smithy_client::erase::DynMiddleware<aws_smithy_client::erase::DynConnector>,
        >,
    ) -> Self {
        Self::with_config(client, crate::Config::builder().build())
    }

pub fn conf(&self) -> &Config

Returns the client’s configuration.

impl Client

pub fn accept_invitation(&self) -> AcceptInvitation

Constructs a fluent builder for the AcceptInvitation operation.

• The fluent builder is configurable:
  • graph_arn(impl Into<String>) / set_graph_arn(Option<String>):

    The ARN of the behavior graph that the member account is accepting the invitation for.

    The member account status in the behavior graph must be INVITED.

• On success, responds with AcceptInvitationOutput
• On failure, responds with SdkError<AcceptInvitationError>

pub fn batch_get_graph_member_datasources(
    &self
) -> BatchGetGraphMemberDatasources

Constructs a fluent builder for the BatchGetGraphMemberDatasources operation.

• The fluent builder is configurable:
  • graph_arn(impl Into<String>) / set_graph_arn(Option<String>):

    The ARN of the behavior graph.

  • account_ids(Vec<String>) / set_account_ids(Option<Vec<String>>):

    The list of Amazon Web Services accounts to get data source package information on.

• On success, responds with BatchGetGraphMemberDatasourcesOutput with field(s):
  • member_datasources(Option<Vec<MembershipDatasources>>):

    Details on the status of data source packages for members of the behavior graph.

  • unprocessed_accounts(Option<Vec<UnprocessedAccount>>):

    Accounts that data source package information could not be retrieved for.

• On failure, responds with SdkError<BatchGetGraphMemberDatasourcesError>

pub fn batch_get_membership_datasources(&self) -> BatchGetMembershipDatasources

Constructs a fluent builder for the BatchGetMembershipDatasources operation.

• The fluent builder is configurable:
  • graph_arns(Vec<String>) / set_graph_arns(Option<Vec<String>>):

    The ARN of the behavior graph.

• On success, responds with BatchGetMembershipDatasourcesOutput with field(s):
  • membership_datasources(Option<Vec<MembershipDatasources>>):

    Details on the data source package history for an member of the behavior graph.

  • unprocessed_graphs(Option<Vec<UnprocessedGraph>>):

    Graphs that data source package information could not be retrieved for.

• On failure, responds with SdkError<BatchGetMembershipDatasourcesError>

pub fn create_graph(&self) -> CreateGraph

Constructs a fluent builder for the CreateGraph operation.

• The fluent builder is configurable:
  • tags(HashMap<String, String>) / set_tags(Option<HashMap<String, String>>):

    The tags to assign to the new behavior graph. You can add up to 50 tags. For each tag, you provide the tag key and the tag value. Each tag key can contain up to 128 characters. Each tag value can contain up to 256 characters.

• On success, responds with CreateGraphOutput with field(s):
  • graph_arn(Option<String>):

    The ARN of the new behavior graph.

• On failure, responds with SdkError<CreateGraphError>

pub fn create_members(&self) -> CreateMembers

Constructs a fluent builder for the CreateMembers operation.

• The fluent builder is configurable:
  • graph_arn(impl Into<String>) / set_graph_arn(Option<String>):

    The ARN of the behavior graph.

  • message(impl Into<String>) / set_message(Option<String>):

    Customized message text to include in the invitation email message to the invited member accounts.

  • disable_email_notification(bool) / set_disable_email_notification(bool):

    if set to true, then the invited accounts do not receive email notifications. By default, this is set to false, and the invited accounts receive email notifications.

    Organization accounts in the organization behavior graph do not receive email notifications.

  • accounts(Vec<Account>) / set_accounts(Option<Vec<Account>>):

    The list of Amazon Web Services accounts to invite or to enable. You can invite or enable up to 50 accounts at a time. For each invited account, the account list contains the account identifier and the Amazon Web Services account root user email address. For organization accounts in the organization behavior graph, the email address is not required.

• On success, responds with CreateMembersOutput with field(s):
  • members(Option<Vec<MemberDetail>>):

    The set of member account invitation or enablement requests that Detective was able to process. This includes accounts that are being verified, that failed verification, and that passed verification and are being sent an invitation or are being enabled.

  • unprocessed_accounts(Option<Vec<UnprocessedAccount>>):

    The list of accounts for which Detective was unable to process the invitation or enablement request. For each account, the list provides the reason why the request could not be processed. The list includes accounts that are already member accounts in the behavior graph.

• On failure, responds with SdkError<CreateMembersError>

pub fn delete_graph(&self) -> DeleteGraph

Constructs a fluent builder for the DeleteGraph operation.

• The fluent builder is configurable:
  • graph_arn(impl Into<String>) / set_graph_arn(Option<String>):

    The ARN of the behavior graph to disable.

• On success, responds with DeleteGraphOutput
• On failure, responds with SdkError<DeleteGraphError>

pub fn delete_members(&self) -> DeleteMembers

Constructs a fluent builder for the DeleteMembers operation.

• The fluent builder is configurable:
  • graph_arn(impl Into<String>) / set_graph_arn(Option<String>):

    The ARN of the behavior graph to remove members from.

  • account_ids(Vec<String>) / set_account_ids(Option<Vec<String>>):

    The list of Amazon Web Services account identifiers for the member accounts to remove from the behavior graph. You can remove up to 50 member accounts at a time.

• On success, responds with DeleteMembersOutput with field(s):
  • account_ids(Option<Vec<String>>):

    The list of Amazon Web Services account identifiers for the member accounts that Detective successfully removed from the behavior graph.

  • unprocessed_accounts(Option<Vec<UnprocessedAccount>>):

    The list of member accounts that Detective was not able to remove from the behavior graph. For each member account, provides the reason that the deletion could not be processed.

• On failure, responds with SdkError<DeleteMembersError>

pub fn describe_organization_configuration(
    &self
) -> DescribeOrganizationConfiguration

Constructs a fluent builder for the DescribeOrganizationConfiguration operation.

• The fluent builder is configurable:
  • graph_arn(impl Into<String>) / set_graph_arn(Option<String>):

    The ARN of the organization behavior graph.

• On success, responds with DescribeOrganizationConfigurationOutput with field(s):
  • auto_enable(bool):

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

• On failure, responds with SdkError<DescribeOrganizationConfigurationError>

pub fn disable_organization_admin_account(
    &self
) -> DisableOrganizationAdminAccount

Constructs a fluent builder for the DisableOrganizationAdminAccount operation.

• The fluent builder takes no input, just send it.
• On success, responds with DisableOrganizationAdminAccountOutput
• On failure, responds with SdkError<DisableOrganizationAdminAccountError>

pub fn disassociate_membership(&self) -> DisassociateMembership

Constructs a fluent builder for the DisassociateMembership operation.

• The fluent builder is configurable:
  • graph_arn(impl Into<String>) / set_graph_arn(Option<String>):

    The ARN of the behavior graph to remove the member account from.

    The member account’s member status in the behavior graph must be ENABLED.

• On success, responds with DisassociateMembershipOutput
• On failure, responds with SdkError<DisassociateMembershipError>

pub fn enable_organization_admin_account(
    &self
) -> EnableOrganizationAdminAccount

Constructs a fluent builder for the EnableOrganizationAdminAccount operation.

• The fluent builder is configurable:
  • account_id(impl Into<String>) / set_account_id(Option<String>):

    The Amazon Web Services account identifier of the account to designate as the Detective administrator account for the organization.

• On success, responds with EnableOrganizationAdminAccountOutput
• On failure, responds with SdkError<EnableOrganizationAdminAccountError>

pub fn get_members(&self) -> GetMembers

Constructs a fluent builder for the GetMembers operation.

• The fluent builder is configurable:
  • graph_arn(impl Into<String>) / set_graph_arn(Option<String>):

    The ARN of the behavior graph for which to request the member details.

  • account_ids(Vec<String>) / set_account_ids(Option<Vec<String>>):

    The list of Amazon Web Services account identifiers for the member account for which to return member details. You can request details for up to 50 member accounts at a time.

    You cannot use GetMembers to retrieve information about member accounts that were removed from the behavior graph.

• On success, responds with GetMembersOutput with field(s):
  • member_details(Option<Vec<MemberDetail>>):

    The member account details that Detective is returning in response to the request.

  • unprocessed_accounts(Option<Vec<UnprocessedAccount>>):

    The requested member accounts for which Detective was unable to return member details.

    For each account, provides the reason why the request could not be processed.

• On failure, responds with SdkError<GetMembersError>

pub fn list_datasource_packages(&self) -> ListDatasourcePackages

Constructs a fluent builder for the ListDatasourcePackages operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • graph_arn(impl Into<String>) / set_graph_arn(Option<String>):

    The ARN of the behavior graph.

  • next_token(impl Into<String>) / set_next_token(Option<String>):

    For requests to get the next page of results, the pagination token that was returned with the previous set of results. The initial request does not include a pagination token.

  • max_results(i32) / set_max_results(Option<i32>):

    The maximum number of results to return.

• On success, responds with ListDatasourcePackagesOutput with field(s):
  • datasource_packages(Option<HashMap<DatasourcePackage, DatasourcePackageIngestDetail>>):

    Details on the data source packages active in the behavior graph.

  • next_token(Option<String>):

    For requests to get the next page of results, the pagination token that was returned with the previous set of results. The initial request does not include a pagination token.

• On failure, responds with SdkError<ListDatasourcePackagesError>

pub fn list_graphs(&self) -> ListGraphs

Constructs a fluent builder for the ListGraphs operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • next_token(impl Into<String>) / set_next_token(Option<String>):

    For requests to get the next page of results, the pagination token that was returned with the previous set of results. The initial request does not include a pagination token.

  • max_results(i32) / set_max_results(Option<i32>):

    The maximum number of graphs to return at a time. The total must be less than the overall limit on the number of results to return, which is currently 200.

• On success, responds with ListGraphsOutput with field(s):
  • graph_list(Option<Vec<Graph>>):

    A list of behavior graphs that the account is an administrator account for.

  • next_token(Option<String>):

    If there are more behavior graphs remaining in the results, then this is the pagination token to use to request the next page of behavior graphs.

• On failure, responds with SdkError<ListGraphsError>

pub fn list_invitations(&self) -> ListInvitations

Constructs a fluent builder for the ListInvitations operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • next_token(impl Into<String>) / set_next_token(Option<String>):

    For requests to retrieve the next page of results, the pagination token that was returned with the previous page of results. The initial request does not include a pagination token.

  • max_results(i32) / set_max_results(Option<i32>):

    The maximum number of behavior graph invitations to return in the response. The total must be less than the overall limit on the number of results to return, which is currently 200.

• On success, responds with ListInvitationsOutput with field(s):
  • invitations(Option<Vec<MemberDetail>>):

    The list of behavior graphs for which the member account has open or accepted invitations.

  • next_token(Option<String>):

    If there are more behavior graphs remaining in the results, then this is the pagination token to use to request the next page of behavior graphs.

• On failure, responds with SdkError<ListInvitationsError>

pub fn list_members(&self) -> ListMembers

Constructs a fluent builder for the ListMembers operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • graph_arn(impl Into<String>) / set_graph_arn(Option<String>):

    The ARN of the behavior graph for which to retrieve the list of member accounts.

  • next_token(impl Into<String>) / set_next_token(Option<String>):

    For requests to retrieve the next page of member account results, the pagination token that was returned with the previous page of results. The initial request does not include a pagination token.

  • max_results(i32) / set_max_results(Option<i32>):

    The maximum number of member accounts to include in the response. The total must be less than the overall limit on the number of results to return, which is currently 200.

• On success, responds with ListMembersOutput with field(s):
  • member_details(Option<Vec<MemberDetail>>):

    The list of member accounts in the behavior graph.

    For invited accounts, the results include member accounts that did not pass verification and member accounts that have not yet accepted the invitation to the behavior graph. 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.

  • next_token(Option<String>):

    If there are more member accounts remaining in the results, then use this pagination token to request the next page of member accounts.

• On failure, responds with SdkError<ListMembersError>

pub fn list_organization_admin_accounts(&self) -> ListOrganizationAdminAccounts

Constructs a fluent builder for the ListOrganizationAdminAccounts operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • next_token(impl Into<String>) / set_next_token(Option<String>):

    For requests to get the next page of results, the pagination token that was returned with the previous set of results. The initial request does not include a pagination token.

  • max_results(i32) / set_max_results(Option<i32>):

    The maximum number of results to return.

• On success, responds with ListOrganizationAdminAccountsOutput with field(s):
  • administrators(Option<Vec<Administrator>>):

    The list of Detective administrator accounts.

  • next_token(Option<String>):

    If there are more accounts remaining in the results, then this is the pagination token to use to request the next page of accounts.

• On failure, responds with SdkError<ListOrganizationAdminAccountsError>

pub fn list_tags_for_resource(&self) -> ListTagsForResource

Constructs a fluent builder for the ListTagsForResource operation.

• The fluent builder is configurable:
  • resource_arn(impl Into<String>) / set_resource_arn(Option<String>):

    The ARN of the behavior graph for which to retrieve the tag values.

• On success, responds with ListTagsForResourceOutput with field(s):
  • tags(Option<HashMap<String, String>>):

    The tag values that are assigned to the behavior graph. The request returns up to 50 tag values.

• On failure, responds with SdkError<ListTagsForResourceError>

pub fn reject_invitation(&self) -> RejectInvitation

Constructs a fluent builder for the RejectInvitation operation.

• The fluent builder is configurable:
  • graph_arn(impl Into<String>) / set_graph_arn(Option<String>):

    The ARN of the behavior graph to reject the invitation to.

    The member account’s current member status in the behavior graph must be INVITED.

• On success, responds with RejectInvitationOutput
• On failure, responds with SdkError<RejectInvitationError>

pub fn start_monitoring_member(&self) -> StartMonitoringMember

Constructs a fluent builder for the StartMonitoringMember operation.

• The fluent builder is configurable:
  • graph_arn(impl Into<String>) / set_graph_arn(Option<String>):

    The ARN of the behavior graph.

  • account_id(impl Into<String>) / set_account_id(Option<String>):

    The account ID of the member account to try to enable.

    The account must be an invited member account with a status of ACCEPTED_BUT_DISABLED.

• On success, responds with StartMonitoringMemberOutput
• On failure, responds with SdkError<StartMonitoringMemberError>

pub fn tag_resource(&self) -> TagResource

Constructs a fluent builder for the TagResource operation.

• The fluent builder is configurable:
  • resource_arn(impl Into<String>) / set_resource_arn(Option<String>):

    The ARN of the behavior graph to assign the tags to.

  • tags(HashMap<String, String>) / set_tags(Option<HashMap<String, String>>):

    The tags to assign to the behavior graph. You can add up to 50 tags. For each tag, you provide the tag key and the tag value. Each tag key can contain up to 128 characters. Each tag value can contain up to 256 characters.

• On success, responds with TagResourceOutput
• On failure, responds with SdkError<TagResourceError>

pub fn untag_resource(&self) -> UntagResource

Constructs a fluent builder for the UntagResource operation.

• The fluent builder is configurable:
  • resource_arn(impl Into<String>) / set_resource_arn(Option<String>):

    The ARN of the behavior graph to remove the tags from.

  • tag_keys(Vec<String>) / set_tag_keys(Option<Vec<String>>):

    The tag keys of the tags to remove from the behavior graph. You can remove up to 50 tags at a time.

• On success, responds with UntagResourceOutput
• On failure, responds with SdkError<UntagResourceError>

pub fn update_datasource_packages(&self) -> UpdateDatasourcePackages

Constructs a fluent builder for the UpdateDatasourcePackages operation.

• The fluent builder is configurable:
  • graph_arn(impl Into<String>) / set_graph_arn(Option<String>):

    The ARN of the behavior graph.

  • datasource_packages(Vec<DatasourcePackage>) / set_datasource_packages(Option<Vec<DatasourcePackage>>):

    The data source package start for the behavior graph.

• On success, responds with UpdateDatasourcePackagesOutput
• On failure, responds with SdkError<UpdateDatasourcePackagesError>

pub fn update_organization_configuration(
    &self
) -> UpdateOrganizationConfiguration

Constructs a fluent builder for the UpdateOrganizationConfiguration operation.

• The fluent builder is configurable:
  • graph_arn(impl Into<String>) / set_graph_arn(Option<String>):

    The ARN of the organization behavior graph.

  • auto_enable(bool) / set_auto_enable(bool):

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

• On success, responds with UpdateOrganizationConfigurationOutput
• On failure, responds with SdkError<UpdateOrganizationConfigurationError>

impl Client

pub fn new(sdk_config: &SdkConfig) -> Self

Creates a new client from an SDK Config.

Panics

• This method will panic if the sdk_config is missing an async sleep implementation. If you experience this panic, set the sleep_impl on the Config passed into this function to fix it.
• This method will panic if the sdk_config is missing an HTTP connector. If you experience this panic, set the http_connector on the Config passed into this function to fix it.

pub fn from_conf(conf: Config) -> Self

Creates a new client from the service Config.

Panics

• This method will panic if the conf is missing an async sleep implementation. If you experience this panic, set the sleep_impl on the Config passed into this function to fix it.
• This method will panic if the conf is missing an HTTP connector. If you experience this panic, set the http_connector on the Config passed into this function to fix it.

Examples found in repository

src/client.rs (line 2479)

    pub fn new(sdk_config: &aws_types::sdk_config::SdkConfig) -> Self {
        Self::from_conf(sdk_config.into())
    }

Trait Implementations

impl Clone for Client

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Client

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<Client<DynConnector, DynMiddleware<DynConnector>, Standard>> for Client

fn from(client: Client<DynConnector, DynMiddleware<DynConnector>>) -> Self

Converts to this type from the input type.