pub struct Client { /* private fields */ }
Expand description

Client for Amazon Macie 2

Client for invoking operations on Amazon Macie 2. Each operation on Amazon Macie 2 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_macie2::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::RetryConfig;
    let shared_config = aws_config::load_from_env().await;
    let config = aws_sdk_macie2::config::Builder::from(&shared_config)
        .retry_config(RetryConfig::disabled())
        .build();
    let client = aws_sdk_macie2::Client::from_conf(config);

Implementations

Creates a client with the given service configuration.

Returns the client’s configuration.

Constructs a fluent builder for the AcceptInvitation operation.

Constructs a fluent builder for the BatchGetCustomDataIdentifiers operation.

Constructs a fluent builder for the CreateClassificationJob operation.

Constructs a fluent builder for the CreateCustomDataIdentifier operation.

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

      A unique, case-sensitive token that you provide to ensure the idempotency of the request.

    • description(impl Into<String>) / set_description(Option<String>):

      A custom description of the custom data identifier. The description can contain as many as 512 characters.

      We strongly recommend that you avoid including any sensitive data in the description of a custom data identifier. Other users of your account might be able to see this description, depending on the actions that they’re allowed to perform in Amazon Macie.

    • ignore_words(Vec<String>) / set_ignore_words(Option<Vec<String>>):

      An array that lists specific character sequences (ignore words) to exclude from the results. If the text matched by the regular expression contains any string in this array, Amazon Macie ignores it. The array can contain as many as 10 ignore words. Each ignore word can contain 4-90 UTF-8 characters. Ignore words are case sensitive.

    • keywords(Vec<String>) / set_keywords(Option<Vec<String>>):

      An array that lists specific character sequences (keywords), one of which must be within proximity (maximumMatchDistance) of the regular expression to match. The array can contain as many as 50 keywords. Each keyword can contain 3-90 UTF-8 characters. Keywords aren’t case sensitive.

    • maximum_match_distance(i32) / set_maximum_match_distance(i32):

      The maximum number of characters that can exist between text that matches the regular expression and the character sequences specified by the keywords array. Amazon Macie includes or excludes a result based on the proximity of a keyword to text that matches the regular expression. The distance can be 1-300 characters. The default value is 50.

    • name(impl Into<String>) / set_name(Option<String>):

      A custom name for the custom data identifier. The name can contain as many as 128 characters.

      We strongly recommend that you avoid including any sensitive data in the name of a custom data identifier. Other users of your account might be able to see this name, depending on the actions that they’re allowed to perform in Amazon Macie.

    • regex(impl Into<String>) / set_regex(Option<String>):

      The regular expression (regex) that defines the pattern to match. The expression can contain as many as 512 characters.

    • severity_levels(Vec<SeverityLevel>) / set_severity_levels(Option<Vec<SeverityLevel>>):

      The severity to assign to findings that the custom data identifier produces, based on the number of occurrences of text that matches the custom data identifier’s detection criteria. You can specify as many as three SeverityLevel objects in this array, one for each severity: LOW, MEDIUM, or HIGH. If you specify more than one, the occurrences thresholds must be in ascending order by severity, moving from LOW to HIGH. For example, 1 for LOW, 50 for MEDIUM, and 100 for HIGH. If an S3 object contains fewer occurrences than the lowest specified threshold, Amazon Macie doesn’t create a finding.

      If you don’t specify any values for this array, Macie creates findings for S3 objects that contain at least one occurrence of text that matches the detection criteria, and Macie assigns the MEDIUM severity to those findings.

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

      A map of key-value pairs that specifies the tags to associate with the custom data identifier.

      A custom data identifier can have a maximum of 50 tags. Each tag consists of a tag key and an associated tag value. The maximum length of a tag key is 128 characters. The maximum length of a tag value is 256 characters.

  • On success, responds with CreateCustomDataIdentifierOutput with field(s):
  • On failure, responds with SdkError<CreateCustomDataIdentifierError>

Constructs a fluent builder for the CreateFindingsFilter operation.

Constructs a fluent builder for the CreateInvitations operation.

Constructs a fluent builder for the CreateMember operation.

Constructs a fluent builder for the CreateSampleFindings operation.

Constructs a fluent builder for the DeclineInvitations operation.

Constructs a fluent builder for the DeleteCustomDataIdentifier operation.

Constructs a fluent builder for the DeleteFindingsFilter operation.

Constructs a fluent builder for the DeleteInvitations operation.

Constructs a fluent builder for the DeleteMember operation.

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

Constructs a fluent builder for the DescribeClassificationJob operation.

  • The fluent builder is configurable:
  • On success, responds with DescribeClassificationJobOutput with field(s):
    • client_token(Option<String>):

      The token that was provided to ensure the idempotency of the request to create the job.

    • created_at(Option<DateTime>):

      The date and time, in UTC and extended ISO 8601 format, when the job was created.

    • custom_data_identifier_ids(Option<Vec<String>>):

      An array of unique identifiers, one for each custom data identifier that the job uses to analyze data. This value is null if the job uses only managed data identifiers to analyze data.

    • description(Option<String>):

      The custom description of the job.

    • initial_run(bool):

      For a recurring job, specifies whether you configured the job to analyze all existing, eligible objects immediately after the job was created (true). If you configured the job to analyze only those objects that were created or changed after the job was created and before the job’s first scheduled run, this value is false. This value is also false for a one-time job.

    • job_arn(Option<String>):

      The Amazon Resource Name (ARN) of the job.

    • job_id(Option<String>):

      The unique identifier for the job.

    • job_status(Option<JobStatus>):

      The current status of the job. Possible values are:

      • CANCELLED - You cancelled the job or, if it’s a one-time job, you paused the job and didn’t resume it within 30 days.

      • COMPLETE - For a one-time job, Amazon Macie finished processing the data specified for the job. This value doesn’t apply to recurring jobs.

      • IDLE - For a recurring job, the previous scheduled run is complete and the next scheduled run is pending. This value doesn’t apply to one-time jobs.

      • PAUSED - Macie started running the job but additional processing would exceed the monthly sensitive data discovery quota for your account or one or more member accounts that the job analyzes data for.

      • RUNNING - For a one-time job, the job is in progress. For a recurring job, a scheduled run is in progress.

      • USER_PAUSED - You paused the job. If you paused the job while it had a status of RUNNING and you don’t resume it within 30 days of pausing it, the job or job run will expire and be cancelled, depending on the job’s type. To check the expiration date, refer to the UserPausedDetails.jobExpiresAt property.

    • job_type(Option<JobType>):

      The schedule for running the job. Possible values are:

      • ONE_TIME - The job runs only once.

      • SCHEDULED - The job runs on a daily, weekly, or monthly basis. The scheduleFrequency property indicates the recurrence pattern for the job.

    • last_run_error_status(Option<LastRunErrorStatus>):

      Specifies whether any account- or bucket-level access errors occurred when the job ran. For a recurring job, this value indicates the error status of the job’s most recent run.

    • last_run_time(Option<DateTime>):

      The date and time, in UTC and extended ISO 8601 format, when the job started. If the job is a recurring job, this value indicates when the most recent run started.

    • managed_data_identifier_ids(Option<Vec<String>>):

      An array of unique identifiers, one for each managed data identifier that the job is explicitly configured to include (use) or exclude (not use) when it analyzes data. Inclusion or exclusion depends on the managed data identifier selection type specified for the job (managedDataIdentifierSelector). This value is null if the job’s managed data identifier selection type is ALL or the job uses only custom data identifiers (customDataIdentifierIds) to analyze data.

    • managed_data_identifier_selector(Option<ManagedDataIdentifierSelector>):

      The selection type that determines which managed data identifiers the job uses to analyze data. Possible values are:

      • ALL - Use all the managed data identifiers that Amazon Macie provides.

      • EXCLUDE - Use all the managed data identifiers that Macie provides except the managed data identifiers specified by the managedDataIdentifierIds property.

      • INCLUDE - Use only the managed data identifiers specified by the managedDataIdentifierIds property.

      • NONE - Don’t use any managed data identifiers.

      If this value is null, the job uses all managed data identifiers. If this value is null, ALL, or EXCLUDE for a recurring job, the job also uses new managed data identifiers as they are released.

    • name(Option<String>):

      The custom name of the job.

    • s3_job_definition(Option<S3JobDefinition>):

      The S3 buckets that contain the objects to analyze, and the scope of that analysis.

    • sampling_percentage(i32):

      The sampling depth, as a percentage, that determines the percentage of eligible objects that the job analyzes.

    • schedule_frequency(Option<JobScheduleFrequency>):

      The recurrence pattern for running the job. This value is null if the job is configured to run only once.

    • statistics(Option<Statistics>):

      The number of times that the job has run and processing statistics for the job’s current run.

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

      A map of key-value pairs that specifies which tags (keys and values) are associated with the classification job.

    • user_paused_details(Option<UserPausedDetails>):

      If the current status of the job is USER_PAUSED, specifies when the job was paused and when the job or job run will expire and be cancelled if it isn’t resumed. This value is present only if the value for jobStatus is USER_PAUSED.

  • On failure, responds with SdkError<DescribeClassificationJobError>

Constructs a fluent builder for the DescribeOrganizationConfiguration operation.

Constructs a fluent builder for the DisableMacie operation.

Constructs a fluent builder for the DisableOrganizationAdminAccount operation.

Constructs a fluent builder for the DisassociateFromAdministratorAccount operation.

Constructs a fluent builder for the DisassociateFromMasterAccount operation.

Constructs a fluent builder for the DisassociateMember operation.

Constructs a fluent builder for the EnableMacie operation.

Constructs a fluent builder for the EnableOrganizationAdminAccount operation.

Constructs a fluent builder for the GetAdministratorAccount operation.

Constructs a fluent builder for the GetBucketStatistics operation.

Constructs a fluent builder for the GetClassificationExportConfiguration operation.

Constructs a fluent builder for the GetCustomDataIdentifier operation.

  • The fluent builder is configurable:
  • On success, responds with GetCustomDataIdentifierOutput with field(s):
    • arn(Option<String>):

      The Amazon Resource Name (ARN) of the custom data identifier.

    • created_at(Option<DateTime>):

      The date and time, in UTC and extended ISO 8601 format, when the custom data identifier was created.

    • deleted(bool):

      Specifies whether the custom data identifier was deleted. If you delete a custom data identifier, Amazon Macie doesn’t delete it permanently. Instead, it soft deletes the identifier.

    • description(Option<String>):

      The custom description of the custom data identifier.

    • id(Option<String>):

      The unique identifier for the custom data identifier.

    • ignore_words(Option<Vec<String>>):

      An array that lists specific character sequences (ignore words) to exclude from the results. If the text matched by the regular expression contains any string in this array, Amazon Macie ignores it. Ignore words are case sensitive.

    • keywords(Option<Vec<String>>):

      An array that lists specific character sequences (keywords), one of which must be within proximity (maximumMatchDistance) of the regular expression to match. Keywords aren’t case sensitive.

    • maximum_match_distance(i32):

      The maximum number of characters that can exist between text that matches the regular expression and the character sequences specified by the keywords array. Amazon Macie includes or excludes a result based on the proximity of a keyword to text that matches the regular expression.

    • name(Option<String>):

      The custom name of the custom data identifier.

    • regex(Option<String>):

      The regular expression (regex) that defines the pattern to match.

    • severity_levels(Option<Vec<SeverityLevel>>):

      Specifies the severity that’s assigned to findings that the custom data identifier produces, based on the number of occurrences of text that matches the custom data identifier’s detection criteria. By default, Amazon Macie creates findings for S3 objects that contain at least one occurrence of text that matches the detection criteria, and Macie assigns the MEDIUM severity to those findings.

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

      A map of key-value pairs that identifies the tags (keys and values) that are associated with the custom data identifier.

  • On failure, responds with SdkError<GetCustomDataIdentifierError>

Constructs a fluent builder for the GetFindings operation.

Constructs a fluent builder for the GetFindingsFilter operation.

Constructs a fluent builder for the GetFindingsPublicationConfiguration operation.

Constructs a fluent builder for the GetFindingStatistics operation.

Constructs a fluent builder for the GetInvitationsCount operation.

Constructs a fluent builder for the GetMacieSession operation.

  • The fluent builder takes no input, just send it.
  • On success, responds with GetMacieSessionOutput with field(s):
    • created_at(Option<DateTime>):

      The date and time, in UTC and extended ISO 8601 format, when the Amazon Macie account was created.

    • finding_publishing_frequency(Option<FindingPublishingFrequency>):

      The frequency with which Amazon Macie publishes updates to policy findings for the account. This includes publishing updates to Security Hub and Amazon EventBridge (formerly called Amazon CloudWatch Events).

    • service_role(Option<String>):

      The Amazon Resource Name (ARN) of the service-linked role that allows Amazon Macie to monitor and analyze data in Amazon Web Services resources for the account.

    • status(Option<MacieStatus>):

      The current status of the Amazon Macie account. Possible values are: PAUSED, the account is enabled but all Macie activities are suspended (paused) for the account; and, ENABLED, the account is enabled and all Macie activities are enabled for the account.

    • updated_at(Option<DateTime>):

      The date and time, in UTC and extended ISO 8601 format, of the most recent change to the status of the Amazon Macie account.

  • On failure, responds with SdkError<GetMacieSessionError>

Constructs a fluent builder for the GetMasterAccount operation.

  • The fluent builder takes no input, just send it.
  • On success, responds with GetMasterAccountOutput with field(s):
    • master(Option<Invitation>):

      (Deprecated) The Amazon Web Services account ID for the administrator account. If the accounts are associated by a Macie membership invitation, this object also provides details about the invitation that was sent to establish the relationship between the accounts.

  • On failure, responds with SdkError<GetMasterAccountError>

Constructs a fluent builder for the GetMember operation.

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

Constructs a fluent builder for the GetUsageTotals operation.

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

      The inclusive time period to retrieve the data for. Valid values are: MONTH_TO_DATE, for the current calendar month to date; and, PAST_30_DAYS, for the preceding 30 days. If you don’t specify a value for this parameter, Amazon Macie provides aggregated usage data for the preceding 30 days.

  • On success, responds with GetUsageTotalsOutput with field(s):
    • time_range(Option<TimeRange>):

      The inclusive time period that the usage data applies to. Possible values are: MONTH_TO_DATE, for the current calendar month to date; and, PAST_30_DAYS, for the preceding 30 days.

    • usage_totals(Option<Vec<UsageTotal>>):

      An array of objects that contains the results of the query. Each object contains the data for a specific usage metric.

  • On failure, responds with SdkError<GetUsageTotalsError>

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

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

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

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

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

Constructs a fluent builder for the ListManagedDataIdentifiers operation.

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

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

Constructs a fluent builder for the ListTagsForResource operation.

Constructs a fluent builder for the PutClassificationExportConfiguration operation.

Constructs a fluent builder for the PutFindingsPublicationConfiguration operation.

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

Constructs a fluent builder for the TagResource operation.

Constructs a fluent builder for the TestCustomDataIdentifier operation.

Constructs a fluent builder for the UntagResource operation.

Constructs a fluent builder for the UpdateClassificationJob operation.

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

      The unique identifier for the classification job.

    • job_status(JobStatus) / set_job_status(Option<JobStatus>):

      The new status for the job. Valid values are:

      • CANCELLED - Stops the job permanently and cancels it. This value is valid only if the job’s current status is IDLE, PAUSED, RUNNING, or USER_PAUSED.

        If you specify this value and the job’s current status is RUNNING, Amazon Macie immediately begins to stop all processing tasks for the job. You can’t resume or restart a job after you cancel it.

      • RUNNING - Resumes the job. This value is valid only if the job’s current status is USER_PAUSED.

        If you paused the job while it was actively running and you specify this value less than 30 days after you paused the job, Macie immediately resumes processing from the point where you paused the job. Otherwise, Macie resumes the job according to the schedule and other settings for the job.

      • USER_PAUSED - Pauses the job temporarily. This value is valid only if the job’s current status is IDLE, PAUSED, or RUNNING. If you specify this value and the job’s current status is RUNNING, Macie immediately begins to pause all processing tasks for the job.

        If you pause a one-time job and you don’t resume it within 30 days, the job expires and Macie cancels the job. If you pause a recurring job when its status is RUNNING and you don’t resume it within 30 days, the job run expires and Macie cancels the run. To check the expiration date, refer to the UserPausedDetails.jobExpiresAt property.

  • On success, responds with UpdateClassificationJobOutput
  • On failure, responds with SdkError<UpdateClassificationJobError>

Constructs a fluent builder for the UpdateFindingsFilter operation.

Constructs a fluent builder for the UpdateMacieSession operation.

Constructs a fluent builder for the UpdateMemberSession operation.

Constructs a fluent builder for the UpdateOrganizationConfiguration operation.

Creates a client with the given service config and connector override.

Creates a new client from a shared config.

Creates a new client from the service Config.

Trait Implementations

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Performs the conversion.

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more