Macie2
This page documents function available when using the Macie2
module, created with @service Macie2
.
Index
Main.Macie2.accept_invitation
Main.Macie2.batch_get_custom_data_identifiers
Main.Macie2.batch_update_automated_discovery_accounts
Main.Macie2.create_allow_list
Main.Macie2.create_classification_job
Main.Macie2.create_custom_data_identifier
Main.Macie2.create_findings_filter
Main.Macie2.create_invitations
Main.Macie2.create_member
Main.Macie2.create_sample_findings
Main.Macie2.decline_invitations
Main.Macie2.delete_allow_list
Main.Macie2.delete_custom_data_identifier
Main.Macie2.delete_findings_filter
Main.Macie2.delete_invitations
Main.Macie2.delete_member
Main.Macie2.describe_buckets
Main.Macie2.describe_classification_job
Main.Macie2.describe_organization_configuration
Main.Macie2.disable_macie
Main.Macie2.disable_organization_admin_account
Main.Macie2.disassociate_from_administrator_account
Main.Macie2.disassociate_from_master_account
Main.Macie2.disassociate_member
Main.Macie2.enable_macie
Main.Macie2.enable_organization_admin_account
Main.Macie2.get_administrator_account
Main.Macie2.get_allow_list
Main.Macie2.get_automated_discovery_configuration
Main.Macie2.get_bucket_statistics
Main.Macie2.get_classification_export_configuration
Main.Macie2.get_classification_scope
Main.Macie2.get_custom_data_identifier
Main.Macie2.get_finding_statistics
Main.Macie2.get_findings
Main.Macie2.get_findings_filter
Main.Macie2.get_findings_publication_configuration
Main.Macie2.get_invitations_count
Main.Macie2.get_macie_session
Main.Macie2.get_master_account
Main.Macie2.get_member
Main.Macie2.get_resource_profile
Main.Macie2.get_reveal_configuration
Main.Macie2.get_sensitive_data_occurrences
Main.Macie2.get_sensitive_data_occurrences_availability
Main.Macie2.get_sensitivity_inspection_template
Main.Macie2.get_usage_statistics
Main.Macie2.get_usage_totals
Main.Macie2.list_allow_lists
Main.Macie2.list_automated_discovery_accounts
Main.Macie2.list_classification_jobs
Main.Macie2.list_classification_scopes
Main.Macie2.list_custom_data_identifiers
Main.Macie2.list_findings
Main.Macie2.list_findings_filters
Main.Macie2.list_invitations
Main.Macie2.list_managed_data_identifiers
Main.Macie2.list_members
Main.Macie2.list_organization_admin_accounts
Main.Macie2.list_resource_profile_artifacts
Main.Macie2.list_resource_profile_detections
Main.Macie2.list_sensitivity_inspection_templates
Main.Macie2.list_tags_for_resource
Main.Macie2.put_classification_export_configuration
Main.Macie2.put_findings_publication_configuration
Main.Macie2.search_resources
Main.Macie2.tag_resource
Main.Macie2.test_custom_data_identifier
Main.Macie2.untag_resource
Main.Macie2.update_allow_list
Main.Macie2.update_automated_discovery_configuration
Main.Macie2.update_classification_job
Main.Macie2.update_classification_scope
Main.Macie2.update_findings_filter
Main.Macie2.update_macie_session
Main.Macie2.update_member_session
Main.Macie2.update_organization_configuration
Main.Macie2.update_resource_profile
Main.Macie2.update_resource_profile_detections
Main.Macie2.update_reveal_configuration
Main.Macie2.update_sensitivity_inspection_template
Documentation
Main.Macie2.accept_invitation
— Methodaccept_invitation(invitation_id)
accept_invitation(invitation_id, params::Dict{String,<:Any})
Accepts an Amazon Macie membership invitation that was received from a specific account.
Arguments
invitation_id
: The unique identifier for the invitation to accept.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"administratorAccountId"
: The Amazon Web Services account ID for the account that sent the invitation."masterAccount"
: (Deprecated) The Amazon Web Services account ID for the account that sent the invitation. This property has been replaced by the administratorAccountId property and is retained only for backward compatibility.
Main.Macie2.batch_get_custom_data_identifiers
— Methodbatch_get_custom_data_identifiers()
batch_get_custom_data_identifiers(params::Dict{String,<:Any})
Retrieves information about one or more custom data identifiers.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"ids"
: An array of custom data identifier IDs, one for each custom data identifier to retrieve information about.
Main.Macie2.batch_update_automated_discovery_accounts
— Methodbatch_update_automated_discovery_accounts()
batch_update_automated_discovery_accounts(params::Dict{String,<:Any})
Changes the status of automated sensitive data discovery for one or more accounts.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"accounts"
: An array of objects, one for each account to change the status of automated sensitive data discovery for. Each object specifies the Amazon Web Services account ID for an account and a new status for that account.
Main.Macie2.create_allow_list
— Methodcreate_allow_list(client_token, criteria, name)
create_allow_list(client_token, criteria, name, params::Dict{String,<:Any})
Creates and defines the settings for an allow list.
Arguments
client_token
: A unique, case-sensitive token that you provide to ensure the idempotency of the request.criteria
: The criteria that specify the text or text pattern to ignore. The criteria can be the location and name of an S3 object that lists specific text to ignore (s3WordsList), or a regular expression (regex) that defines a text pattern to ignore.name
: A custom name for the allow list. The name can contain as many as 128 characters.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"description"
: A custom description of the allow list. The description can contain as many as 512 characters."tags"
: A map of key-value pairs that specifies the tags to associate with the allow list. An allow list 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.
Main.Macie2.create_classification_job
— Methodcreate_classification_job(client_token, job_type, name, s3_job_definition)
create_classification_job(client_token, job_type, name, s3_job_definition, params::Dict{String,<:Any})
Creates and defines the settings for a classification job.
Arguments
client_token
: A unique, case-sensitive token that you provide to ensure the idempotency of the request.job_type
: The schedule for running the job. Valid values are: ONE_TIME - Run the job only once. If you specify this value, don't specify a value for the scheduleFrequency property. SCHEDULED - Run the job on a daily, weekly, or monthly basis. If you specify this value, use the scheduleFrequency property to specify the recurrence pattern for the job.name
: A custom name for the job. The name can contain as many as 500 characters.s3_job_definition
: The S3 buckets that contain the objects to analyze, and the scope of that analysis.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"allowListIds"
: An array of unique identifiers, one for each allow list for the job to use when it analyzes data."customDataIdentifierIds"
: An array of unique identifiers, one for each custom data identifier for the job to use when it analyzes data. To use only managed data identifiers, don't specify a value for this property and specify a value other than NONE for the managedDataIdentifierSelector property."description"
: A custom description of the job. The description can contain as many as 200 characters."initialRun"
: For a recurring job, specifies whether to analyze all existing, eligible objects immediately after the job is created (true). To analyze only those objects that are created or changed after you create the job and before the job's first scheduled run, set this value to false. If you configure the job to run only once, don't specify a value for this property."managedDataIdentifierIds"
: An array of unique identifiers, one for each managed data identifier for the job to include (use) or exclude (not use) when it analyzes data. Inclusion or exclusion depends on the managed data identifier selection type that you specify for the job (managedDataIdentifierSelector). To retrieve a list of valid values for this property, use the ListManagedDataIdentifiers operation."managedDataIdentifierSelector"
: The selection type to apply when determining which managed data identifiers the job uses to analyze data. Valid values are: ALL - Use all managed data identifiers. If you specify this value, don't specify any values for the managedDataIdentifierIds property. EXCLUDE - Use all managed data identifiers except the ones 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 you specify this value, specify at least one value for the customDataIdentifierIds property and don't specify any values for the managedDataIdentifierIds property. RECOMMENDED (default) - Use the recommended set of managed data identifiers. If you specify this value, don't specify any values for the managedDataIdentifierIds property. If you don't specify a value for this property, the job uses the recommended set of managed data identifiers. If the job is a recurring job and you specify ALL or EXCLUDE, each job run automatically uses new managed data identifiers that are released. If you don't specify a value for this property or you specify RECOMMENDED for a recurring job, each job run automatically uses all the managed data identifiers that are in the recommended set when the run starts. To learn about individual managed data identifiers or determine which ones are in the recommended set, see Using managed data identifiers or Recommended managed data identifiers in the Amazon Macie User Guide."samplingPercentage"
: The sampling depth, as a percentage, for the job to apply when processing objects. This value determines the percentage of eligible objects that the job analyzes. If this value is less than 100, Amazon Macie selects the objects to analyze at random, up to the specified percentage, and analyzes all the data in those objects."scheduleFrequency"
: The recurrence pattern for running the job. To run the job only once, don't specify a value for this property and set the value for the jobType property to ONE_TIME."tags"
: A map of key-value pairs that specifies the tags to associate with the job. A job 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.
Main.Macie2.create_custom_data_identifier
— Methodcreate_custom_data_identifier(name, regex)
create_custom_data_identifier(name, regex, params::Dict{String,<:Any})
Creates and defines the criteria and other settings for a custom data identifier.
Arguments
name
: 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
: The regular expression (regex) that defines the pattern to match. The expression can contain as many as 512 characters.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"clientToken"
: A unique, case-sensitive token that you provide to ensure the idempotency of the request."description"
: 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."ignoreWords"
: 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"
: An array that lists specific character sequences (keywords), one of which must precede and 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."maximumMatchDistance"
: The maximum number of characters that can exist between the end of at least one complete character sequence specified by the keywords array and the end of the text that matches the regex pattern. If a complete keyword precedes all the text that matches the pattern and the keyword is within the specified distance, Amazon Macie includes the result. The distance can be 1-300 characters. The default value is 50."severityLevels"
: The severity to assign to findings that the custom data identifier produces, based on the number of occurrences of text that match 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"
: 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.
Main.Macie2.create_findings_filter
— Methodcreate_findings_filter(action, finding_criteria, name)
create_findings_filter(action, finding_criteria, name, params::Dict{String,<:Any})
Creates and defines the criteria and other settings for a findings filter.
Arguments
action
: The action to perform on findings that match the filter criteria (findingCriteria). Valid values are: ARCHIVE, suppress (automatically archive) the findings; and, NOOP, don't perform any action on the findings.finding_criteria
: The criteria to use to filter findings.name
: A custom name for the filter. The name must contain at least 3 characters and can contain as many as 64 characters. We strongly recommend that you avoid including any sensitive data in the name of a filter. 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.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"clientToken"
: A unique, case-sensitive token that you provide to ensure the idempotency of the request."description"
: A custom description of the filter. The description can contain as many as 512 characters. We strongly recommend that you avoid including any sensitive data in the description of a filter. 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."position"
: The position of the filter in the list of saved filters on the Amazon Macie console. This value also determines the order in which the filter is applied to findings, relative to other filters that are also applied to the findings."tags"
: A map of key-value pairs that specifies the tags to associate with the filter. A findings filter 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.
Main.Macie2.create_invitations
— Methodcreate_invitations(account_ids)
create_invitations(account_ids, params::Dict{String,<:Any})
Sends an Amazon Macie membership invitation to one or more accounts.
Arguments
account_ids
: An array that lists Amazon Web Services account IDs, one for each account to send the invitation to.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"disableEmailNotification"
: Specifies whether to send the invitation as an email message. If this value is false, Amazon Macie sends the invitation (as an email message) to the email address that you specified for the recipient's account when you associated the account with your account. The default value is false."message"
: Custom text to include in the email message that contains the invitation. The text can contain as many as 80 alphanumeric characters.
Main.Macie2.create_member
— Methodcreate_member(account)
create_member(account, params::Dict{String,<:Any})
Associates an account with an Amazon Macie administrator account.
Arguments
account
: The details of the account to associate with the administrator account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"tags"
: A map of key-value pairs that specifies the tags to associate with the account in Amazon Macie. An account 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.
Main.Macie2.create_sample_findings
— Methodcreate_sample_findings()
create_sample_findings(params::Dict{String,<:Any})
Creates sample findings.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"findingTypes"
: An array of finding types, one for each type of sample finding to create. To create a sample of every type of finding that Amazon Macie supports, don't include this array in your request.
Main.Macie2.decline_invitations
— Methoddecline_invitations(account_ids)
decline_invitations(account_ids, params::Dict{String,<:Any})
Declines Amazon Macie membership invitations that were received from specific accounts.
Arguments
account_ids
: An array that lists Amazon Web Services account IDs, one for each account that sent an invitation to decline.
Main.Macie2.delete_allow_list
— Methoddelete_allow_list(id)
delete_allow_list(id, params::Dict{String,<:Any})
Deletes an allow list.
Arguments
id
: The unique identifier for the Amazon Macie resource that the request applies to.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"ignoreJobChecks"
: Specifies whether to force deletion of the allow list, even if active classification jobs are configured to use the list. When you try to delete an allow list, Amazon Macie checks for classification jobs that use the list and have a status other than COMPLETE or CANCELLED. By default, Macie rejects your request if any jobs meet these criteria. To skip these checks and delete the list, set this value to true. To delete the list only if no active jobs are configured to use it, set this value to false.
Main.Macie2.delete_custom_data_identifier
— Methoddelete_custom_data_identifier(id)
delete_custom_data_identifier(id, params::Dict{String,<:Any})
Soft deletes a custom data identifier.
Arguments
id
: The unique identifier for the Amazon Macie resource that the request applies to.
Main.Macie2.delete_findings_filter
— Methoddelete_findings_filter(id)
delete_findings_filter(id, params::Dict{String,<:Any})
Deletes a findings filter.
Arguments
id
: The unique identifier for the Amazon Macie resource that the request applies to.
Main.Macie2.delete_invitations
— Methoddelete_invitations(account_ids)
delete_invitations(account_ids, params::Dict{String,<:Any})
Deletes Amazon Macie membership invitations that were received from specific accounts.
Arguments
account_ids
: An array that lists Amazon Web Services account IDs, one for each account that sent an invitation to delete.
Main.Macie2.delete_member
— Methoddelete_member(id)
delete_member(id, params::Dict{String,<:Any})
Deletes the association between an Amazon Macie administrator account and an account.
Arguments
id
: The unique identifier for the Amazon Macie resource that the request applies to.
Main.Macie2.describe_buckets
— Methoddescribe_buckets()
describe_buckets(params::Dict{String,<:Any})
Retrieves (queries) statistical data and other information about one or more S3 buckets that Amazon Macie monitors and analyzes for an account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"criteria"
: The criteria to use to filter the query results."maxResults"
: The maximum number of items to include in each page of the response. The default value is 50."nextToken"
: The nextToken string that specifies which page of results to return in a paginated response."sortCriteria"
: The criteria to use to sort the query results.
Main.Macie2.describe_classification_job
— Methoddescribe_classification_job(job_id)
describe_classification_job(job_id, params::Dict{String,<:Any})
Retrieves the status and settings for a classification job.
Arguments
job_id
: The unique identifier for the classification job.
Main.Macie2.describe_organization_configuration
— Methoddescribe_organization_configuration()
describe_organization_configuration(params::Dict{String,<:Any})
Retrieves the Amazon Macie configuration settings for an organization in Organizations.
Main.Macie2.disable_macie
— Methoddisable_macie()
disable_macie(params::Dict{String,<:Any})
Disables Amazon Macie and deletes all settings and resources for a Macie account.
Main.Macie2.disable_organization_admin_account
— Methoddisable_organization_admin_account(admin_account_id)
disable_organization_admin_account(admin_account_id, params::Dict{String,<:Any})
Disables an account as the delegated Amazon Macie administrator account for an organization in Organizations.
Arguments
admin_account_id
: The Amazon Web Services account ID of the delegated Amazon Macie administrator account.
Main.Macie2.disassociate_from_administrator_account
— Methoddisassociate_from_administrator_account()
disassociate_from_administrator_account(params::Dict{String,<:Any})
Disassociates a member account from its Amazon Macie administrator account.
Main.Macie2.disassociate_from_master_account
— Methoddisassociate_from_master_account()
disassociate_from_master_account(params::Dict{String,<:Any})
(Deprecated) Disassociates a member account from its Amazon Macie administrator account. This operation has been replaced by the DisassociateFromAdministratorAccount operation.
Main.Macie2.disassociate_member
— Methoddisassociate_member(id)
disassociate_member(id, params::Dict{String,<:Any})
Disassociates an Amazon Macie administrator account from a member account.
Arguments
id
: The unique identifier for the Amazon Macie resource that the request applies to.
Main.Macie2.enable_macie
— Methodenable_macie()
enable_macie(params::Dict{String,<:Any})
Enables Amazon Macie and specifies the configuration settings for a Macie account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"clientToken"
: A unique, case-sensitive token that you provide to ensure the idempotency of the request."findingPublishingFrequency"
: Specifies how often to publish updates to policy findings for the account. This includes publishing updates to Security Hub and Amazon EventBridge (formerly Amazon CloudWatch Events)."status"
: Specifies the new status for the account. To enable Amazon Macie and start all Macie activities for the account, set this value to ENABLED.
Main.Macie2.enable_organization_admin_account
— Methodenable_organization_admin_account(admin_account_id)
enable_organization_admin_account(admin_account_id, params::Dict{String,<:Any})
Designates an account as the delegated Amazon Macie administrator account for an organization in Organizations.
Arguments
admin_account_id
: The Amazon Web Services account ID for the account to designate as the delegated Amazon Macie administrator account for the organization.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"clientToken"
: A unique, case-sensitive token that you provide to ensure the idempotency of the request.
Main.Macie2.get_administrator_account
— Methodget_administrator_account()
get_administrator_account(params::Dict{String,<:Any})
Retrieves information about the Amazon Macie administrator account for an account.
Main.Macie2.get_allow_list
— Methodget_allow_list(id)
get_allow_list(id, params::Dict{String,<:Any})
Retrieves the settings and status of an allow list.
Arguments
id
: The unique identifier for the Amazon Macie resource that the request applies to.
Main.Macie2.get_automated_discovery_configuration
— Methodget_automated_discovery_configuration()
get_automated_discovery_configuration(params::Dict{String,<:Any})
Retrieves the configuration settings and status of automated sensitive data discovery for an organization or standalone account.
Main.Macie2.get_bucket_statistics
— Methodget_bucket_statistics()
get_bucket_statistics(params::Dict{String,<:Any})
Retrieves (queries) aggregated statistical data about all the S3 buckets that Amazon Macie monitors and analyzes for an account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"accountId"
: The unique identifier for the Amazon Web Services account.
Main.Macie2.get_classification_export_configuration
— Methodget_classification_export_configuration()
get_classification_export_configuration(params::Dict{String,<:Any})
Retrieves the configuration settings for storing data classification results.
Main.Macie2.get_classification_scope
— Methodget_classification_scope(id)
get_classification_scope(id, params::Dict{String,<:Any})
Retrieves the classification scope settings for an account.
Arguments
id
: The unique identifier for the Amazon Macie resource that the request applies to.
Main.Macie2.get_custom_data_identifier
— Methodget_custom_data_identifier(id)
get_custom_data_identifier(id, params::Dict{String,<:Any})
Retrieves the criteria and other settings for a custom data identifier.
Arguments
id
: The unique identifier for the Amazon Macie resource that the request applies to.
Main.Macie2.get_finding_statistics
— Methodget_finding_statistics(group_by)
get_finding_statistics(group_by, params::Dict{String,<:Any})
Retrieves (queries) aggregated statistical data about findings.
Arguments
group_by
: The finding property to use to group the query results. Valid values are: classificationDetails.jobId - The unique identifier for the classification job that produced the finding. resourcesAffected.s3Bucket.name - The name of the S3 bucket that the finding applies to. severity.description - The severity level of the finding, such as High or Medium. type - The type of finding, such as Policy:IAMUser/S3BucketPublic and SensitiveData:S3Object/Personal.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"findingCriteria"
: The criteria to use to filter the query results."size"
: The maximum number of items to include in each page of the response."sortCriteria"
: The criteria to use to sort the query results.
Main.Macie2.get_findings
— Methodget_findings(finding_ids)
get_findings(finding_ids, params::Dict{String,<:Any})
Retrieves the details of one or more findings.
Arguments
finding_ids
: An array of strings that lists the unique identifiers for the findings to retrieve. You can specify as many as 50 unique identifiers in this array.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"sortCriteria"
: The criteria for sorting the results of the request.
Main.Macie2.get_findings_filter
— Methodget_findings_filter(id)
get_findings_filter(id, params::Dict{String,<:Any})
Retrieves the criteria and other settings for a findings filter.
Arguments
id
: The unique identifier for the Amazon Macie resource that the request applies to.
Main.Macie2.get_findings_publication_configuration
— Methodget_findings_publication_configuration()
get_findings_publication_configuration(params::Dict{String,<:Any})
Retrieves the configuration settings for publishing findings to Security Hub.
Main.Macie2.get_invitations_count
— Methodget_invitations_count()
get_invitations_count(params::Dict{String,<:Any})
Retrieves the count of Amazon Macie membership invitations that were received by an account.
Main.Macie2.get_macie_session
— Methodget_macie_session()
get_macie_session(params::Dict{String,<:Any})
Retrieves the status and configuration settings for an Amazon Macie account.
Main.Macie2.get_master_account
— Methodget_master_account()
get_master_account(params::Dict{String,<:Any})
(Deprecated) Retrieves information about the Amazon Macie administrator account for an account. This operation has been replaced by the GetAdministratorAccount operation.
Main.Macie2.get_member
— Methodget_member(id)
get_member(id, params::Dict{String,<:Any})
Retrieves information about an account that's associated with an Amazon Macie administrator account.
Arguments
id
: The unique identifier for the Amazon Macie resource that the request applies to.
Main.Macie2.get_resource_profile
— Methodget_resource_profile(resource_arn)
get_resource_profile(resource_arn, params::Dict{String,<:Any})
Retrieves (queries) sensitive data discovery statistics and the sensitivity score for an S3 bucket.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the S3 bucket that the request applies to.
Main.Macie2.get_reveal_configuration
— Methodget_reveal_configuration()
get_reveal_configuration(params::Dict{String,<:Any})
Retrieves the status and configuration settings for retrieving occurrences of sensitive data reported by findings.
Main.Macie2.get_sensitive_data_occurrences
— Methodget_sensitive_data_occurrences(finding_id)
get_sensitive_data_occurrences(finding_id, params::Dict{String,<:Any})
Retrieves occurrences of sensitive data reported by a finding.
Arguments
finding_id
: The unique identifier for the finding.
Main.Macie2.get_sensitive_data_occurrences_availability
— Methodget_sensitive_data_occurrences_availability(finding_id)
get_sensitive_data_occurrences_availability(finding_id, params::Dict{String,<:Any})
Checks whether occurrences of sensitive data can be retrieved for a finding.
Arguments
finding_id
: The unique identifier for the finding.
Main.Macie2.get_sensitivity_inspection_template
— Methodget_sensitivity_inspection_template(id)
get_sensitivity_inspection_template(id, params::Dict{String,<:Any})
Retrieves the settings for the sensitivity inspection template for an account.
Arguments
id
: The unique identifier for the Amazon Macie resource that the request applies to.
Main.Macie2.get_usage_statistics
— Methodget_usage_statistics()
get_usage_statistics(params::Dict{String,<:Any})
Retrieves (queries) quotas and aggregated usage data for one or more accounts.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"filterBy"
: An array of objects, one for each condition to use to filter the query results. If you specify more than one condition, Amazon Macie uses an AND operator to join the conditions."maxResults"
: The maximum number of items to include in each page of the response."nextToken"
: The nextToken string that specifies which page of results to return in a paginated response."sortBy"
: The criteria to use to sort the query results."timeRange"
: The inclusive time period to query usage data for. Valid values are: MONTHTODATE, for the current calendar month to date; and, PAST30DAYS, for the preceding 30 days. If you don't specify a value, Amazon Macie provides usage data for the preceding 30 days.
Main.Macie2.get_usage_totals
— Methodget_usage_totals()
get_usage_totals(params::Dict{String,<:Any})
Retrieves (queries) aggregated usage data for an account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"timeRange"
: The inclusive time period to retrieve the data for. Valid values are: MONTHTODATE, for the current calendar month to date; and, PAST30DAYS, 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.
Main.Macie2.list_allow_lists
— Methodlist_allow_lists()
list_allow_lists(params::Dict{String,<:Any})
Retrieves a subset of information about all the allow lists for an account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: The maximum number of items to include in each page of a paginated response."nextToken"
: The nextToken string that specifies which page of results to return in a paginated response.
Main.Macie2.list_automated_discovery_accounts
— Methodlist_automated_discovery_accounts()
list_automated_discovery_accounts(params::Dict{String,<:Any})
Retrieves the status of automated sensitive data discovery for one or more accounts.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"accountIds"
: The Amazon Web Services account ID for each account, for as many as 50 accounts. To retrieve the status for multiple accounts, append the accountIds parameter and argument for each account, separated by an ampersand (&). To retrieve the status for all the accounts in an organization, omit this parameter."maxResults"
: The maximum number of items to include in each page of a paginated response."nextToken"
: The nextToken string that specifies which page of results to return in a paginated response.
Main.Macie2.list_classification_jobs
— Methodlist_classification_jobs()
list_classification_jobs(params::Dict{String,<:Any})
Retrieves a subset of information about one or more classification jobs.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"filterCriteria"
: The criteria to use to filter the results."maxResults"
: The maximum number of items to include in each page of the response."nextToken"
: The nextToken string that specifies which page of results to return in a paginated response."sortCriteria"
: The criteria to use to sort the results.
Main.Macie2.list_classification_scopes
— Methodlist_classification_scopes()
list_classification_scopes(params::Dict{String,<:Any})
Retrieves a subset of information about the classification scope for an account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"name"
: The name of the classification scope to retrieve the unique identifier for."nextToken"
: The nextToken string that specifies which page of results to return in a paginated response.
Main.Macie2.list_custom_data_identifiers
— Methodlist_custom_data_identifiers()
list_custom_data_identifiers(params::Dict{String,<:Any})
Retrieves a subset of information about all the custom data identifiers for an account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: The maximum number of items to include in each page of the response."nextToken"
: The nextToken string that specifies which page of results to return in a paginated response.
Main.Macie2.list_findings
— Methodlist_findings()
list_findings(params::Dict{String,<:Any})
Retrieves a subset of information about one or more findings.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"findingCriteria"
: The criteria to use to filter the results."maxResults"
: The maximum number of items to include in each page of the response."nextToken"
: The nextToken string that specifies which page of results to return in a paginated response."sortCriteria"
: The criteria to use to sort the results.
Main.Macie2.list_findings_filters
— Methodlist_findings_filters()
list_findings_filters(params::Dict{String,<:Any})
Retrieves a subset of information about all the findings filters for an account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: The maximum number of items to include in each page of a paginated response."nextToken"
: The nextToken string that specifies which page of results to return in a paginated response.
Main.Macie2.list_invitations
— Methodlist_invitations()
list_invitations(params::Dict{String,<:Any})
Retrieves information about Amazon Macie membership invitations that were received by an account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: The maximum number of items to include in each page of a paginated response."nextToken"
: The nextToken string that specifies which page of results to return in a paginated response.
Main.Macie2.list_managed_data_identifiers
— Methodlist_managed_data_identifiers()
list_managed_data_identifiers(params::Dict{String,<:Any})
Retrieves information about all the managed data identifiers that Amazon Macie currently provides.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"nextToken"
: The nextToken string that specifies which page of results to return in a paginated response.
Main.Macie2.list_members
— Methodlist_members()
list_members(params::Dict{String,<:Any})
Retrieves information about the accounts that are associated with an Amazon Macie administrator account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: The maximum number of items to include in each page of a paginated response."nextToken"
: The nextToken string that specifies which page of results to return in a paginated response."onlyAssociated"
: Specifies which accounts to include in the response, based on the status of an account's relationship with the administrator account. By default, the response includes only current member accounts. To include all accounts, set this value to false.
Main.Macie2.list_organization_admin_accounts
— Methodlist_organization_admin_accounts()
list_organization_admin_accounts(params::Dict{String,<:Any})
Retrieves information about the delegated Amazon Macie administrator account for an organization in Organizations.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: The maximum number of items to include in each page of a paginated response."nextToken"
: The nextToken string that specifies which page of results to return in a paginated response.
Main.Macie2.list_resource_profile_artifacts
— Methodlist_resource_profile_artifacts(resource_arn)
list_resource_profile_artifacts(resource_arn, params::Dict{String,<:Any})
Retrieves information about objects that Amazon Macie selected from an S3 bucket for automated sensitive data discovery.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the S3 bucket that the request applies to.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"nextToken"
: The nextToken string that specifies which page of results to return in a paginated response.
Main.Macie2.list_resource_profile_detections
— Methodlist_resource_profile_detections(resource_arn)
list_resource_profile_detections(resource_arn, params::Dict{String,<:Any})
Retrieves information about the types and amount of sensitive data that Amazon Macie found in an S3 bucket.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the S3 bucket that the request applies to.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: The maximum number of items to include in each page of a paginated response."nextToken"
: The nextToken string that specifies which page of results to return in a paginated response.
Main.Macie2.list_sensitivity_inspection_templates
— Methodlist_sensitivity_inspection_templates()
list_sensitivity_inspection_templates(params::Dict{String,<:Any})
Retrieves a subset of information about the sensitivity inspection template for an account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: The maximum number of items to include in each page of a paginated response."nextToken"
: The nextToken string that specifies which page of results to return in a paginated response.
Main.Macie2.list_tags_for_resource
— Methodlist_tags_for_resource(resource_arn)
list_tags_for_resource(resource_arn, params::Dict{String,<:Any})
Retrieves the tags (keys and values) that are associated with an Amazon Macie resource.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the resource.
Main.Macie2.put_classification_export_configuration
— Methodput_classification_export_configuration(configuration)
put_classification_export_configuration(configuration, params::Dict{String,<:Any})
Adds or updates the configuration settings for storing data classification results.
Arguments
configuration
: The location to store data classification results in, and the encryption settings to use when storing results in that location.
Main.Macie2.put_findings_publication_configuration
— Methodput_findings_publication_configuration()
put_findings_publication_configuration(params::Dict{String,<:Any})
Updates the configuration settings for publishing findings to Security Hub.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"clientToken"
: A unique, case-sensitive token that you provide to ensure the idempotency of the request."securityHubConfiguration"
: The configuration settings that determine which findings to publish to Security Hub.
Main.Macie2.search_resources
— Methodsearch_resources()
search_resources(params::Dict{String,<:Any})
Retrieves (queries) statistical data and other information about Amazon Web Services resources that Amazon Macie monitors and analyzes.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"bucketCriteria"
: The filter conditions that determine which S3 buckets to include or exclude from the query results."maxResults"
: The maximum number of items to include in each page of the response. The default value is 50."nextToken"
: The nextToken string that specifies which page of results to return in a paginated response."sortCriteria"
: The criteria to use to sort the results.
Main.Macie2.tag_resource
— Methodtag_resource(resource_arn, tags)
tag_resource(resource_arn, tags, params::Dict{String,<:Any})
Adds or updates one or more tags (keys and values) that are associated with an Amazon Macie resource.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the resource.tags
: A map of key-value pairs that specifies the tags to associate with the resource. A resource 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.
Main.Macie2.test_custom_data_identifier
— Methodtest_custom_data_identifier(regex, sample_text)
test_custom_data_identifier(regex, sample_text, params::Dict{String,<:Any})
Tests criteria for a custom data identifier.
Arguments
regex
: The regular expression (regex) that defines the pattern to match. The expression can contain as many as 512 characters.sample_text
: The sample text to inspect by using the custom data identifier. The text can contain as many as 1,000 characters.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"ignoreWords"
: 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"
: An array that lists specific character sequences (keywords), one of which must precede and 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."maximumMatchDistance"
: The maximum number of characters that can exist between the end of at least one complete character sequence specified by the keywords array and the end of the text that matches the regex pattern. If a complete keyword precedes all the text that matches the pattern and the keyword is within the specified distance, Amazon Macie includes the result. The distance can be 1-300 characters. The default value is 50.
Main.Macie2.untag_resource
— Methoduntag_resource(resource_arn, tag_keys)
untag_resource(resource_arn, tag_keys, params::Dict{String,<:Any})
Removes one or more tags (keys and values) from an Amazon Macie resource.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the resource.tag_keys
: One or more tags (keys) to remove from the resource. In an HTTP request to remove multiple tags, append the tagKeys parameter and argument for each tag to remove, separated by an ampersand (&).
Main.Macie2.update_allow_list
— Methodupdate_allow_list(criteria, id, name)
update_allow_list(criteria, id, name, params::Dict{String,<:Any})
Updates the settings for an allow list.
Arguments
criteria
: The criteria that specify the text or text pattern to ignore. The criteria can be the location and name of an S3 object that lists specific text to ignore (s3WordsList), or a regular expression that defines a text pattern to ignore (regex). You can change a list's underlying criteria, such as the name of the S3 object or the regular expression to use. However, you can't change the type from s3WordsList to regex or the other way around.id
: The unique identifier for the Amazon Macie resource that the request applies to.name
: A custom name for the allow list. The name can contain as many as 128 characters.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"description"
: A custom description of the allow list. The description can contain as many as 512 characters.
Main.Macie2.update_automated_discovery_configuration
— Methodupdate_automated_discovery_configuration(status)
update_automated_discovery_configuration(status, params::Dict{String,<:Any})
Changes the configuration settings and status of automated sensitive data discovery for an organization or standalone account.
Arguments
status
: The new status of automated sensitive data discovery for the organization or account. Valid values are: ENABLED, start or resume all automated sensitive data discovery activities; and, DISABLED, stop performing all automated sensitive data discovery activities. If you specify DISABLED for an administrator account, you also disable automated sensitive data discovery for all member accounts in the organization.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"autoEnableOrganizationMembers"
: Specifies whether to automatically enable automated sensitive data discovery for accounts in the organization. Valid values are: ALL (default), enable it for all existing accounts and new member accounts; NEW, enable it only for new member accounts; and, NONE, don't enable it for any accounts. If you specify NEW or NONE, automated sensitive data discovery continues to be enabled for any existing accounts that it's currently enabled for. To enable or disable it for individual member accounts, specify NEW or NONE, and then enable or disable it for each account by using the BatchUpdateAutomatedDiscoveryAccounts operation.
Main.Macie2.update_classification_job
— Methodupdate_classification_job(job_id, job_status)
update_classification_job(job_id, job_status, params::Dict{String,<:Any})
Changes the status of a classification job.
Arguments
job_id
: The unique identifier for the classification job.job_status
: 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 USERPAUSED. 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 USERPAUSED. 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,
Main.Macie2.update_classification_scope
— Methodupdate_classification_scope(id)
update_classification_scope(id, params::Dict{String,<:Any})
Updates the classification scope settings for an account.
Arguments
id
: The unique identifier for the Amazon Macie resource that the request applies to.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"s3"
: The S3 buckets to add or remove from the exclusion list defined by the classification scope.
Main.Macie2.update_findings_filter
— Methodupdate_findings_filter(id)
update_findings_filter(id, params::Dict{String,<:Any})
Updates the criteria and other settings for a findings filter.
Arguments
id
: The unique identifier for the Amazon Macie resource that the request applies to.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"action"
: The action to perform on findings that match the filter criteria (findingCriteria). Valid values are: ARCHIVE, suppress (automatically archive) the findings; and, NOOP, don't perform any action on the findings."clientToken"
: A unique, case-sensitive token that you provide to ensure the idempotency of the request."description"
: A custom description of the filter. The description can contain as many as 512 characters. We strongly recommend that you avoid including any sensitive data in the description of a filter. 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."findingCriteria"
: The criteria to use to filter findings."name"
: A custom name for the filter. The name must contain at least 3 characters and can contain as many as 64 characters. We strongly recommend that you avoid including any sensitive data in the name of a filter. 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."position"
: The position of the filter in the list of saved filters on the Amazon Macie console. This value also determines the order in which the filter is applied to findings, relative to other filters that are also applied to the findings.
Main.Macie2.update_macie_session
— Methodupdate_macie_session()
update_macie_session(params::Dict{String,<:Any})
Suspends or re-enables Amazon Macie, or updates the configuration settings for a Macie account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"findingPublishingFrequency"
: Specifies how often to publish updates to policy findings for the account. This includes publishing updates to Security Hub and Amazon EventBridge (formerly Amazon CloudWatch Events)."status"
: Specifies a new status for the account. Valid values are: ENABLED, resume all Amazon Macie activities for the account; and, PAUSED, suspend all Macie activities for the account.
Main.Macie2.update_member_session
— Methodupdate_member_session(id, status)
update_member_session(id, status, params::Dict{String,<:Any})
Enables an Amazon Macie administrator to suspend or re-enable Macie for a member account.
Arguments
id
: The unique identifier for the Amazon Macie resource that the request applies to.status
: Specifies the new status for the account. Valid values are: ENABLED, resume all Amazon Macie activities for the account; and, PAUSED, suspend all Macie activities for the account.
Main.Macie2.update_organization_configuration
— Methodupdate_organization_configuration(auto_enable)
update_organization_configuration(auto_enable, params::Dict{String,<:Any})
Updates the Amazon Macie configuration settings for an organization in Organizations.
Arguments
auto_enable
: Specifies whether to enable Amazon Macie automatically for accounts that are added to the organization in Organizations.
Main.Macie2.update_resource_profile
— Methodupdate_resource_profile(resource_arn)
update_resource_profile(resource_arn, params::Dict{String,<:Any})
Updates the sensitivity score for an S3 bucket.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the S3 bucket that the request applies to.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"sensitivityScoreOverride"
: The new sensitivity score for the bucket. Valid values are: 100, assign the maximum score and apply the Sensitive label to the bucket; and, null (empty), assign a score that Amazon Macie calculates automatically after you submit the request.
Main.Macie2.update_resource_profile_detections
— Methodupdate_resource_profile_detections(resource_arn)
update_resource_profile_detections(resource_arn, params::Dict{String,<:Any})
Updates the sensitivity scoring settings for an S3 bucket.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the S3 bucket that the request applies to.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"suppressDataIdentifiers"
: An array of objects, one for each custom data identifier or managed data identifier that detected the type of sensitive data to start excluding or including in the bucket's score. To start including all sensitive data types in the score, don't specify any values for this array.
Main.Macie2.update_reveal_configuration
— Methodupdate_reveal_configuration(configuration)
update_reveal_configuration(configuration, params::Dict{String,<:Any})
Updates the status and configuration settings for retrieving occurrences of sensitive data reported by findings.
Arguments
configuration
: The KMS key to use to encrypt the sensitive data, and the status of the configuration for the Amazon Macie account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"retrievalConfiguration"
: The access method and settings to use when retrieving the sensitive data.
Main.Macie2.update_sensitivity_inspection_template
— Methodupdate_sensitivity_inspection_template(id)
update_sensitivity_inspection_template(id, params::Dict{String,<:Any})
Updates the settings for the sensitivity inspection template for an account.
Arguments
id
: The unique identifier for the Amazon Macie resource that the request applies to.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"description"
: A custom description of the template. The description can contain as many as 200 characters."excludes"
: The managed data identifiers to explicitly exclude (not use) when performing automated sensitive data discovery. To exclude an allow list or custom data identifier that's currently included by the template, update the values for the SensitivityInspectionTemplateIncludes.allowListIds and SensitivityInspectionTemplateIncludes.customDataIdentifierIds properties, respectively."includes"
: The allow lists, custom data identifiers, and managed data identifiers to explicitly include (use) when performing automated sensitive data discovery.