AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::Macie2::Client

Inherits:
Seahorse::Client::Base show all
Defined in:
(unknown)

Overview

An API client for Amazon Macie 2. To construct a client, you need to configure a :region and :credentials.

macie2 = Aws::Macie2::Client.new(
  region: region_name,
  credentials: credentials,
  # ...
)

See #initialize for a full list of supported configuration options.

Region

You can configure a default region in the following locations:

  • ENV['AWS_REGION']
  • Aws.config[:region]

Go here for a list of supported regions.

Credentials

Default credentials are loaded automatically from the following locations:

  • ENV['AWS_ACCESS_KEY_ID'] and ENV['AWS_SECRET_ACCESS_KEY']
  • Aws.config[:credentials]
  • The shared credentials ini file at ~/.aws/credentials (more information)
  • From an instance profile when running on EC2

You can also construct a credentials object from one of the following classes:

Alternatively, you configure credentials with :access_key_id and :secret_access_key:

# load credentials from disk
creds = YAML.load(File.read('/path/to/secrets'))

Aws::Macie2::Client.new(
  access_key_id: creds['access_key_id'],
  secret_access_key: creds['secret_access_key']
)

Always load your credentials from outside your application. Avoid configuring credentials statically and never commit them to source control.

Instance Attribute Summary

Attributes inherited from Seahorse::Client::Base

#config, #handlers

Constructor collapse

API Operations collapse

Instance Method Summary collapse

Methods inherited from Seahorse::Client::Base

add_plugin, api, #build_request, clear_plugins, define, new, #operation, #operation_names, plugins, remove_plugin, set_api, set_plugins

Methods included from Seahorse::Client::HandlerBuilder

#handle, #handle_request, #handle_response

Constructor Details

#initialize(options = {}) ⇒ Aws::Macie2::Client

Constructs an API client.

Options Hash (options):

  • :access_key_id (String)

    Used to set credentials statically. See Plugins::RequestSigner for more details.

  • :active_endpoint_cache (Boolean)

    When set to true, a thread polling for endpoints will be running in the background every 60 secs (default). Defaults to false. See Plugins::EndpointDiscovery for more details.

  • :convert_params (Boolean) — default: true

    When true, an attempt is made to coerce request parameters into the required types. See Plugins::ParamConverter for more details.

  • :credentials (required, Credentials)

    Your AWS credentials. The following locations will be searched in order for credentials:

    • :access_key_id, :secret_access_key, and :session_token options
    • ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
    • HOME/.aws/credentials shared credentials file
    • EC2 instance profile credentials See Plugins::RequestSigner for more details.
  • :disable_host_prefix_injection (Boolean)

    Set to true to disable SDK automatically adding host prefix to default service endpoint when available. See Plugins::EndpointPattern for more details.

  • :endpoint (String)

    A default endpoint is constructed from the :region. See Plugins::RegionalEndpoint for more details.

  • :endpoint_cache_max_entries (Integer)

    Used for the maximum size limit of the LRU cache storing endpoints data for endpoint discovery enabled operations. Defaults to 1000. See Plugins::EndpointDiscovery for more details.

  • :endpoint_cache_max_threads (Integer)

    Used for the maximum threads in use for polling endpoints to be cached, defaults to 10. See Plugins::EndpointDiscovery for more details.

  • :endpoint_cache_poll_interval (Integer)

    When :endpoint_discovery and :active_endpoint_cache is enabled, Use this option to config the time interval in seconds for making requests fetching endpoints information. Defaults to 60 sec. See Plugins::EndpointDiscovery for more details.

  • :endpoint_discovery (Boolean)

    When set to true, endpoint discovery will be enabled for operations when available. Defaults to false. See Plugins::EndpointDiscovery for more details.

  • :http_continue_timeout (Float) — default: 1

    See Seahorse::Client::Plugins::NetHttp for more details.

  • :http_idle_timeout (Integer) — default: 5

    See Seahorse::Client::Plugins::NetHttp for more details.

  • :http_open_timeout (Integer) — default: 15

    See Seahorse::Client::Plugins::NetHttp for more details.

  • :http_proxy (String)

    See Seahorse::Client::Plugins::NetHttp for more details.

  • :http_read_timeout (Integer) — default: 60

    See Seahorse::Client::Plugins::NetHttp for more details.

  • :http_wire_trace (Boolean) — default: false

    See Seahorse::Client::Plugins::NetHttp for more details.

  • :log_level (Symbol) — default: :info

    The log level to send messages to the logger at. See Plugins::Logging for more details.

  • :log_formatter (Logging::LogFormatter)

    The log formatter. Defaults to Seahorse::Client::Logging::Formatter.default. See Plugins::Logging for more details.

  • :logger (Logger) — default: nil

    The Logger instance to send log messages to. If this option is not set, logging will be disabled. See Plugins::Logging for more details.

  • :profile (String)

    Used when loading credentials from the shared credentials file at HOME/.aws/credentials. When not specified, 'default' is used. See Plugins::RequestSigner for more details.

  • :raise_response_errors (Boolean) — default: true

    When true, response errors are raised. See Seahorse::Client::Plugins::RaiseResponseErrors for more details.

  • :region (required, String)

    The AWS region to connect to. The region is used to construct the client endpoint. Defaults to ENV['AWS_REGION']. Also checks AMAZON_REGION and AWS_DEFAULT_REGION. See Plugins::RegionalEndpoint for more details.

  • :retry_limit (Integer) — default: 3

    The maximum number of times to retry failed requests. Only ~ 500 level server errors and certain ~ 400 level client errors are retried. Generally, these are throttling errors, data checksum errors, networking errors, timeout errors and auth errors from expired credentials. See Plugins::RetryErrors for more details.

  • :secret_access_key (String)

    Used to set credentials statically. See Plugins::RequestSigner for more details.

  • :session_token (String)

    Used to set credentials statically. See Plugins::RequestSigner for more details.

  • :ssl_ca_bundle (String)

    See Seahorse::Client::Plugins::NetHttp for more details.

  • :ssl_ca_directory (String)

    See Seahorse::Client::Plugins::NetHttp for more details.

  • :ssl_ca_store (String)

    See Seahorse::Client::Plugins::NetHttp for more details.

  • :ssl_verify_peer (Boolean) — default: true

    See Seahorse::Client::Plugins::NetHttp for more details.

  • :stub_responses (Boolean) — default: false

    Causes the client to return stubbed responses. By default fake responses are generated and returned. You can specify the response data to return or errors to raise by calling ClientStubs#stub_responses. See ClientStubs for more information.

    Please note When response stubbing is enabled, no HTTP requests are made, and retries are disabled. See Plugins::StubResponses for more details.

  • :validate_params (Boolean) — default: true

    When true, request parameters are validated before sending the request. See Plugins::ParamValidator for more details.

Instance Method Details

#accept_invitation(options = {}) ⇒ Struct

Accepts an Amazon Macie membership invitation that was received from a specific account.

Examples:

Request syntax with placeholder values


resp = client.accept_invitation({
  invitation_id: "__string", # required
  master_account: "__string", # required
})

Options Hash (options):

  • :invitation_id (required, String)
  • :master_account (required, String)

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#archive_findings(options = {}) ⇒ Struct

Archives one or more findings.

Examples:

Request syntax with placeholder values


resp = client.archive_findings({
  finding_ids: ["__string"], # required
})

Options Hash (options):

  • :finding_ids (required, Array<String>)

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#batch_get_custom_data_identifiers(options = {}) ⇒ Types::BatchGetCustomDataIdentifiersResponse

Retrieves information about one or more custom data identifiers.

Examples:

Request syntax with placeholder values


resp = client.batch_get_custom_data_identifiers({
  ids: ["__string"],
})

Response structure


resp.custom_data_identifiers #=> Array
resp.custom_data_identifiers[0].arn #=> String
resp.custom_data_identifiers[0].created_at #=> Time
resp.custom_data_identifiers[0].deleted #=> true/false
resp.custom_data_identifiers[0].description #=> String
resp.custom_data_identifiers[0].id #=> String
resp.custom_data_identifiers[0].name #=> String
resp.not_found_identifier_ids #=> Array
resp.not_found_identifier_ids[0] #=> String

Options Hash (options):

  • :ids (Array<String>)

Returns:

See Also:

#create_classification_job(options = {}) ⇒ Types::CreateClassificationJobResponse

Creates and defines the settings for a classification job.

Examples:

Request syntax with placeholder values


resp = client.create_classification_job({
  client_token: "__string", # required
  custom_data_identifier_ids: ["__string"],
  description: "__string",
  initial_run: false,
  job_type: "ONE_TIME", # required, accepts ONE_TIME, SCHEDULED
  name: "__string", # required
  s3_job_definition: { # required
    bucket_definitions: [
      {
        account_id: "__string",
        buckets: ["__string"],
      },
    ],
    scoping: {
      excludes: {
        and: [
          {
            simple_scope_term: {
              comparator: "EQ", # accepts EQ, GT, GTE, LT, LTE, NE, CONTAINS
              key: "BUCKET_CREATION_DATE", # accepts BUCKET_CREATION_DATE, OBJECT_EXTENSION, OBJECT_LAST_MODIFIED_DATE, OBJECT_SIZE, TAG
              values: ["__string"],
            },
            tag_scope_term: {
              comparator: "EQ", # accepts EQ, GT, GTE, LT, LTE, NE, CONTAINS
              key: "__string",
              tag_values: [
                {
                  key: "__string",
                  value: "__string",
                },
              ],
              target: "S3_OBJECT", # accepts S3_OBJECT
            },
          },
        ],
      },
      includes: {
        and: [
          {
            simple_scope_term: {
              comparator: "EQ", # accepts EQ, GT, GTE, LT, LTE, NE, CONTAINS
              key: "BUCKET_CREATION_DATE", # accepts BUCKET_CREATION_DATE, OBJECT_EXTENSION, OBJECT_LAST_MODIFIED_DATE, OBJECT_SIZE, TAG
              values: ["__string"],
            },
            tag_scope_term: {
              comparator: "EQ", # accepts EQ, GT, GTE, LT, LTE, NE, CONTAINS
              key: "__string",
              tag_values: [
                {
                  key: "__string",
                  value: "__string",
                },
              ],
              target: "S3_OBJECT", # accepts S3_OBJECT
            },
          },
        ],
      },
    },
  },
  sampling_percentage: 1,
  schedule_frequency: {
    daily_schedule: {
    },
    monthly_schedule: {
      day_of_month: 1,
    },
    weekly_schedule: {
      day_of_week: "SUNDAY", # accepts SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY
    },
  },
  tags: {
    "__string" => "__string",
  },
})

Response structure


resp.job_arn #=> String
resp.job_id #=> String

Options Hash (options):

  • :client_token (required, String)

    This parameter will be auto-filled on your behalf with a random UUIDv4 when no value is provided.

  • :custom_data_identifier_ids (Array<String>)
  • :description (String)
  • :initial_run (Boolean)
  • :job_type (required, String)

    The schedule for running a classification job. Valid values are:

  • :name (required, String)
  • :s3_job_definition (required, Types::S3JobDefinition)

    Specifies which S3 buckets contain the objects that a classification job analyzes, and the scope of that analysis.

  • :sampling_percentage (Integer)
  • :schedule_frequency (Types::JobScheduleFrequency)

    Specifies the recurrence pattern for running a classification job.

  • :tags (Hash<String,String>)

    A string-to-string map of key-value pairs that specifies the tags (keys and values) for a classification job, custom data identifier, findings filter, or member account.

Returns:

See Also:

#create_custom_data_identifier(options = {}) ⇒ Types::CreateCustomDataIdentifierResponse

Creates and defines the criteria and other settings for a custom data identifier.

Examples:

Request syntax with placeholder values


resp = client.create_custom_data_identifier({
  client_token: "__string",
  description: "__string",
  ignore_words: ["__string"],
  keywords: ["__string"],
  maximum_match_distance: 1,
  name: "__string",
  regex: "__string",
  tags: {
    "__string" => "__string",
  },
})

Response structure


resp.custom_data_identifier_id #=> String

Options Hash (options):

  • :client_token (String)

    This parameter will be auto-filled on your behalf with a random UUIDv4 when no value is provided.

  • :description (String)
  • :ignore_words (Array<String>)
  • :keywords (Array<String>)
  • :maximum_match_distance (Integer)
  • :name (String)
  • :regex (String)
  • :tags (Hash<String,String>)

    A string-to-string map of key-value pairs that specifies the tags (keys and values) for a classification job, custom data identifier, findings filter, or member account.

Returns:

See Also:

#create_findings_filter(options = {}) ⇒ Types::CreateFindingsFilterResponse

Creates and defines the criteria and other settings for a findings filter.

Examples:

Request syntax with placeholder values


resp = client.create_findings_filter({
  action: "ARCHIVE", # required, accepts ARCHIVE, NOOP
  client_token: "__string",
  description: "__string",
  finding_criteria: { # required
    criterion: {
      "__string" => {
        eq: ["__string"],
        gt: 1,
        gte: 1,
        lt: 1,
        lte: 1,
        neq: ["__string"],
      },
    },
  },
  name: "__string", # required
  position: 1,
  tags: {
    "__string" => "__string",
  },
})

Response structure


resp.arn #=> String
resp.id #=> String

Options Hash (options):

  • :action (required, String)

    The action to perform on findings that meet the filter criteria. Valid values are:

  • :client_token (String)

    This parameter will be auto-filled on your behalf with a random UUIDv4 when no value is provided.

  • :description (String)
  • :finding_criteria (required, Types::FindingCriteria)

    Specifies, as a map, one or more property-based conditions that filter the results of a query for findings.

  • :name (required, String)
  • :position (Integer)
  • :tags (Hash<String,String>)

    A string-to-string map of key-value pairs that specifies the tags (keys and values) for a classification job, custom data identifier, findings filter, or member account.

Returns:

See Also:

#create_invitations(options = {}) ⇒ Types::CreateInvitationsResponse

Sends an Amazon Macie membership invitation to one or more accounts.

Examples:

Request syntax with placeholder values


resp = client.create_invitations({
  account_ids: ["__string"], # required
  disable_email_notification: false,
  message: "__string",
})

Response structure


resp.unprocessed_accounts #=> Array
resp.unprocessed_accounts[0]. #=> String
resp.unprocessed_accounts[0].error_code #=> String, one of "ClientError", "InternalError"
resp.unprocessed_accounts[0].error_message #=> String

Options Hash (options):

  • :account_ids (required, Array<String>)
  • :disable_email_notification (Boolean)
  • :message (String)

Returns:

See Also:

#create_member(options = {}) ⇒ Types::CreateMemberResponse

Associates an account with an Amazon Macie master account.

Examples:

Request syntax with placeholder values


resp = client.create_member({
  account: { # required
    account_id: "__string", # required
    email: "__string", # required
  },
  tags: {
    "__string" => "__string",
  },
})

Response structure


resp.arn #=> String

Options Hash (options):

  • :account (required, Types::AccountDetail)

    Specifies details for an account to associate with an Amazon Macie master account.

  • :tags (Hash<String,String>)

    A string-to-string map of key-value pairs that specifies the tags (keys and values) for a classification job, custom data identifier, findings filter, or member account.

Returns:

See Also:

#create_sample_findings(options = {}) ⇒ Struct

Creates sample findings.

Examples:

Request syntax with placeholder values


resp = client.create_sample_findings({
  finding_types: ["SensitiveData:S3Object/Multiple"], # accepts SensitiveData:S3Object/Multiple, SensitiveData:S3Object/Financial, SensitiveData:S3Object/Personal, SensitiveData:S3Object/Credentials, SensitiveData:S3Object/CustomIdentifier, Policy:IAMUser/S3BucketPublic, Policy:IAMUser/S3BucketSharedExternally, Policy:IAMUser/S3BucketReplicatedExternally, Policy:IAMUser/S3BucketEncryptionDisabled, Policy:IAMUser/S3BlockPublicAccessDisabled
})

Options Hash (options):

  • :finding_types (Array<String>)

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#decline_invitations(options = {}) ⇒ Types::DeclineInvitationsResponse

Declines Amazon Macie membership invitations that were received from specific accounts.

Examples:

Request syntax with placeholder values


resp = client.decline_invitations({
  account_ids: ["__string"], # required
})

Response structure


resp.unprocessed_accounts #=> Array
resp.unprocessed_accounts[0]. #=> String
resp.unprocessed_accounts[0].error_code #=> String, one of "ClientError", "InternalError"
resp.unprocessed_accounts[0].error_message #=> String

Options Hash (options):

  • :account_ids (required, Array<String>)

Returns:

See Also:

#delete_custom_data_identifier(options = {}) ⇒ Struct

Deletes a custom data identifier.

Examples:

Request syntax with placeholder values


resp = client.delete_custom_data_identifier({
  id: "__string", # required
})

Options Hash (options):

  • :id (required, String)

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#delete_findings_filter(options = {}) ⇒ Struct

Deletes a findings filter.

Examples:

Request syntax with placeholder values


resp = client.delete_findings_filter({
  id: "__string", # required
})

Options Hash (options):

  • :id (required, String)

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#delete_invitations(options = {}) ⇒ Types::DeleteInvitationsResponse

Deletes Amazon Macie membership invitations that were received from specific accounts.

Examples:

Request syntax with placeholder values


resp = client.delete_invitations({
  account_ids: ["__string"], # required
})

Response structure


resp.unprocessed_accounts #=> Array
resp.unprocessed_accounts[0]. #=> String
resp.unprocessed_accounts[0].error_code #=> String, one of "ClientError", "InternalError"
resp.unprocessed_accounts[0].error_message #=> String

Options Hash (options):

  • :account_ids (required, Array<String>)

Returns:

See Also:

#delete_member(options = {}) ⇒ Struct

Deletes the association between an Amazon Macie master account and an account.

Examples:

Request syntax with placeholder values


resp = client.delete_member({
  id: "__string", # required
})

Options Hash (options):

  • :id (required, String)

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#describe_buckets(options = {}) ⇒ Types::DescribeBucketsResponse

Retrieves (queries) statistical data and other information about one or more S3 buckets that Amazon Macie monitors and analyzes.

Examples:

Request syntax with placeholder values


resp = client.describe_buckets({
  criteria: {
    "__string" => {
      eq: ["__string"],
      gt: 1,
      gte: 1,
      lt: 1,
      lte: 1,
      neq: ["__string"],
      prefix: "__string",
    },
  },
  max_results: 1,
  next_token: "__string",
  sort_criteria: {
    attribute_name: "__string",
    order_by: "ASC", # accepts ASC, DESC
  },
})

Response structure


resp.buckets #=> Array
resp.buckets[0]. #=> String
resp.buckets[0].bucket_arn #=> String
resp.buckets[0].bucket_created_at #=> Time
resp.buckets[0].bucket_name #=> String
resp.buckets[0].classifiable_object_count #=> Integer
resp.buckets[0].last_updated #=> Time
resp.buckets[0].object_count #=> Integer
resp.buckets[0].object_count_by_encryption_type.customer_managed #=> Integer
resp.buckets[0].object_count_by_encryption_type.kms_managed #=> Integer
resp.buckets[0].object_count_by_encryption_type.s3_managed #=> Integer
resp.buckets[0].object_count_by_encryption_type.unencrypted #=> Integer
resp.buckets[0].public_access.effective_permission #=> String, one of "PUBLIC", "NOT_PUBLIC"
resp.buckets[0].public_access.permission_configuration..block_public_access.block_public_acls #=> true/false
resp.buckets[0].public_access.permission_configuration..block_public_access.block_public_policy #=> true/false
resp.buckets[0].public_access.permission_configuration..block_public_access.ignore_public_acls #=> true/false
resp.buckets[0].public_access.permission_configuration..block_public_access.restrict_public_buckets #=> true/false
resp.buckets[0].public_access.permission_configuration.bucket_level_permissions.access_control_list.allows_public_read_access #=> true/false
resp.buckets[0].public_access.permission_configuration.bucket_level_permissions.access_control_list.allows_public_write_access #=> true/false
resp.buckets[0].public_access.permission_configuration.bucket_level_permissions.block_public_access.block_public_acls #=> true/false
resp.buckets[0].public_access.permission_configuration.bucket_level_permissions.block_public_access.block_public_policy #=> true/false
resp.buckets[0].public_access.permission_configuration.bucket_level_permissions.block_public_access.ignore_public_acls #=> true/false
resp.buckets[0].public_access.permission_configuration.bucket_level_permissions.block_public_access.restrict_public_buckets #=> true/false
resp.buckets[0].public_access.permission_configuration.bucket_level_permissions.bucket_policy.allows_public_read_access #=> true/false
resp.buckets[0].public_access.permission_configuration.bucket_level_permissions.bucket_policy.allows_public_write_access #=> true/false
resp.buckets[0].region #=> String
resp.buckets[0].replication_details.replicated #=> true/false
resp.buckets[0].replication_details.replicated_externally #=> true/false
resp.buckets[0].replication_details.replication_accounts #=> Array
resp.buckets[0].replication_details.replication_accounts[0] #=> String
resp.buckets[0].shared_access #=> String, one of "EXTERNAL", "INTERNAL", "NOT_SHARED"
resp.buckets[0].size_in_bytes #=> Integer
resp.buckets[0].size_in_bytes_compressed #=> Integer
resp.buckets[0].tags #=> Array
resp.buckets[0].tags[0].key #=> String
resp.buckets[0].tags[0].value #=> String
resp.buckets[0].versioning #=> true/false
resp.next_token #=> String

Options Hash (options):

  • :criteria (Hash<String,Types::BucketCriteriaAdditionalProperties>)

    Specifies, as a map, one or more attribute-based conditions that filter the results of a query for information about S3 buckets.

  • :max_results (Integer)
  • :next_token (String)
  • :sort_criteria (Types::BucketSortCriteria)

    Specifies criteria for sorting the results of a query for information about S3 buckets.

Returns:

See Also:

#describe_classification_job(options = {}) ⇒ Types::DescribeClassificationJobResponse

Retrieves information about the status and settings for a classification job.

Examples:

Request syntax with placeholder values


resp = client.describe_classification_job({
  job_id: "__string", # required
})

Response structure


resp.client_token #=> String
resp.created_at #=> Time
resp.custom_data_identifier_ids #=> Array
resp.custom_data_identifier_ids[0] #=> String
resp.description #=> String
resp.initial_run #=> true/false
resp.job_arn #=> String
resp.job_id #=> String
resp.job_status #=> String, one of "RUNNING", "PAUSED", "CANCELLED", "COMPLETE", "IDLE"
resp.job_type #=> String, one of "ONE_TIME", "SCHEDULED"
resp.last_run_time #=> Time
resp.name #=> String
resp.s3_job_definition.bucket_definitions #=> Array
resp.s3_job_definition.bucket_definitions[0]. #=> String
resp.s3_job_definition.bucket_definitions[0].buckets #=> Array
resp.s3_job_definition.bucket_definitions[0].buckets[0] #=> String
resp.s3_job_definition.scoping.excludes.and #=> Array
resp.s3_job_definition.scoping.excludes.and[0].simple_scope_term.comparator #=> String, one of "EQ", "GT", "GTE", "LT", "LTE", "NE", "CONTAINS"
resp.s3_job_definition.scoping.excludes.and[0].simple_scope_term.key #=> String, one of "BUCKET_CREATION_DATE", "OBJECT_EXTENSION", "OBJECT_LAST_MODIFIED_DATE", "OBJECT_SIZE", "TAG"
resp.s3_job_definition.scoping.excludes.and[0].simple_scope_term.values #=> Array
resp.s3_job_definition.scoping.excludes.and[0].simple_scope_term.values[0] #=> String
resp.s3_job_definition.scoping.excludes.and[0].tag_scope_term.comparator #=> String, one of "EQ", "GT", "GTE", "LT", "LTE", "NE", "CONTAINS"
resp.s3_job_definition.scoping.excludes.and[0].tag_scope_term.key #=> String
resp.s3_job_definition.scoping.excludes.and[0].tag_scope_term.tag_values #=> Array
resp.s3_job_definition.scoping.excludes.and[0].tag_scope_term.tag_values[0].key #=> String
resp.s3_job_definition.scoping.excludes.and[0].tag_scope_term.tag_values[0].value #=> String
resp.s3_job_definition.scoping.excludes.and[0].tag_scope_term.target #=> String, one of "S3_OBJECT"
resp.s3_job_definition.scoping.includes.and #=> Array
resp.s3_job_definition.scoping.includes.and[0].simple_scope_term.comparator #=> String, one of "EQ", "GT", "GTE", "LT", "LTE", "NE", "CONTAINS"
resp.s3_job_definition.scoping.includes.and[0].simple_scope_term.key #=> String, one of "BUCKET_CREATION_DATE", "OBJECT_EXTENSION", "OBJECT_LAST_MODIFIED_DATE", "OBJECT_SIZE", "TAG"
resp.s3_job_definition.scoping.includes.and[0].simple_scope_term.values #=> Array
resp.s3_job_definition.scoping.includes.and[0].simple_scope_term.values[0] #=> String
resp.s3_job_definition.scoping.includes.and[0].tag_scope_term.comparator #=> String, one of "EQ", "GT", "GTE", "LT", "LTE", "NE", "CONTAINS"
resp.s3_job_definition.scoping.includes.and[0].tag_scope_term.key #=> String
resp.s3_job_definition.scoping.includes.and[0].tag_scope_term.tag_values #=> Array
resp.s3_job_definition.scoping.includes.and[0].tag_scope_term.tag_values[0].key #=> String
resp.s3_job_definition.scoping.includes.and[0].tag_scope_term.tag_values[0].value #=> String
resp.s3_job_definition.scoping.includes.and[0].tag_scope_term.target #=> String, one of "S3_OBJECT"
resp.sampling_percentage #=> Integer
resp.schedule_frequency.monthly_schedule.day_of_month #=> Integer
resp.schedule_frequency.weekly_schedule.day_of_week #=> String, one of "SUNDAY", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY"
resp.statistics.approximate_number_of_objects_to_process #=> Float
resp.statistics.number_of_runs #=> Float
resp.tags #=> Hash
resp.tags["__string"] #=> String

Options Hash (options):

  • :job_id (required, String)

Returns:

See Also:

#describe_organization_configuration(options = {}) ⇒ Types::DescribeOrganizationConfigurationResponse

Retrieves information about the Amazon Macie configuration settings for an AWS organization.

Examples:

Request syntax with placeholder values


resp = client.describe_organization_configuration()

Response structure


resp.auto_enable #=> true/false
resp. #=> true/false

Returns:

See Also:

#disable_macie(options = {}) ⇒ Struct

Disables an Amazon Macie account and deletes Macie resources for the account.

Examples:

Request syntax with placeholder values


resp = client.disable_macie()

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#disable_organization_admin_account(options = {}) ⇒ Struct

Disables an account as a delegated administrator of Amazon Macie for an AWS organization.

Examples:

Request syntax with placeholder values


resp = client.({
  admin_account_id: "__string", # required
})

Options Hash (options):

  • :admin_account_id (required, String)

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#disassociate_from_master_account(options = {}) ⇒ Struct

Disassociates a member account from its Amazon Macie master account.

Examples:

Request syntax with placeholder values


resp = client.()

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#disassociate_member(options = {}) ⇒ Struct

Disassociates an Amazon Macie master account from a member account.

Examples:

Request syntax with placeholder values


resp = client.disassociate_member({
  id: "__string", # required
})

Options Hash (options):

  • :id (required, String)

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#enable_macie(options = {}) ⇒ Struct

Enables Amazon Macie and specifies the configuration settings for a Macie account.

Examples:

Request syntax with placeholder values


resp = client.enable_macie({
  client_token: "__string",
  finding_publishing_frequency: "FIFTEEN_MINUTES", # accepts FIFTEEN_MINUTES, ONE_HOUR, SIX_HOURS
  status: "PAUSED", # accepts PAUSED, ENABLED
})

Options Hash (options):

  • :client_token (String)

    This parameter will be auto-filled on your behalf with a random UUIDv4 when no value is provided.

  • :finding_publishing_frequency (String)

    The frequency with which Amazon Macie publishes findings for an account. This includes adding findings to AWS Security Hub and exporting finding events to Amazon CloudWatch. Valid values are:

  • :status (String)

    The status of an Amazon Macie account. Valid values are:

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#enable_organization_admin_account(options = {}) ⇒ Struct

Enables an account as a delegated administrator of Amazon Macie for an AWS organization.

Examples:

Request syntax with placeholder values


resp = client.({
  admin_account_id: "__string", # required
  client_token: "__string",
})

Options Hash (options):

  • :admin_account_id (required, String)
  • :client_token (String)

    This parameter will be auto-filled on your behalf with a random UUIDv4 when no value is provided.

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#get_bucket_statistics(options = {}) ⇒ Types::GetBucketStatisticsResponse

Retrieves (queries) aggregated statistical data for all the S3 buckets that Amazon Macie monitors and analyzes.

Examples:

Request syntax with placeholder values


resp = client.get_bucket_statistics({
  account_id: "__string",
})

Response structure


resp.bucket_count #=> Integer
resp.bucket_count_by_effective_permission.publicly_accessible #=> Integer
resp.bucket_count_by_effective_permission.publicly_readable #=> Integer
resp.bucket_count_by_effective_permission.publicly_writable #=> Integer
resp.bucket_count_by_encryption_type.kms_managed #=> Integer
resp.bucket_count_by_encryption_type.s3_managed #=> Integer
resp.bucket_count_by_encryption_type.unencrypted #=> Integer
resp.bucket_count_by_shared_access_type.external #=> Integer
resp.bucket_count_by_shared_access_type.internal #=> Integer
resp.bucket_count_by_shared_access_type.not_shared #=> Integer
resp.classifiable_object_count #=> Integer
resp.last_updated #=> Time
resp.object_count #=> Integer
resp.size_in_bytes #=> Integer
resp.size_in_bytes_compressed #=> Integer

Options Hash (options):

  • :account_id (String)

Returns:

See Also:

#get_classification_export_configuration(options = {}) ⇒ Types::GetClassificationExportConfigurationResponse

Retrieves the configuration settings for exporting data classification results.

Examples:

Request syntax with placeholder values


resp = client.get_classification_export_configuration()

Response structure


resp.configuration.s3_destination.bucket_name #=> String
resp.configuration.s3_destination.key_prefix #=> String
resp.configuration.s3_destination.kms_key_arn #=> String

Returns:

See Also:

#get_custom_data_identifier(options = {}) ⇒ Types::GetCustomDataIdentifierResponse

Retrieves information about the criteria and other settings for a custom data identifier.

Examples:

Request syntax with placeholder values


resp = client.get_custom_data_identifier({
  id: "__string", # required
})

Response structure


resp.arn #=> String
resp.created_at #=> Time
resp.deleted #=> true/false
resp.description #=> String
resp.id #=> String
resp.ignore_words #=> Array
resp.ignore_words[0] #=> String
resp.keywords #=> Array
resp.keywords[0] #=> String
resp.maximum_match_distance #=> Integer
resp.name #=> String
resp.regex #=> String
resp.tags #=> Hash
resp.tags["__string"] #=> String

Options Hash (options):

  • :id (required, String)

Returns:

See Also:

#get_finding_statistics(options = {}) ⇒ Types::GetFindingStatisticsResponse

Retrieves (queries) aggregated statistical data about findings.

Examples:

Request syntax with placeholder values


resp = client.get_finding_statistics({
  finding_criteria: {
    criterion: {
      "__string" => {
        eq: ["__string"],
        gt: 1,
        gte: 1,
        lt: 1,
        lte: 1,
        neq: ["__string"],
      },
    },
  },
  group_by: "resourcesAffected.s3Bucket.name", # required, accepts resourcesAffected.s3Bucket.name, type, classificationDetails.jobId, severity.description
  size: 1,
  sort_criteria: {
    attribute_name: "groupKey", # accepts groupKey, count
    order_by: "ASC", # accepts ASC, DESC
  },
})

Response structure


resp.counts_by_group #=> Array
resp.counts_by_group[0].count #=> Integer
resp.counts_by_group[0].group_key #=> String

Options Hash (options):

  • :finding_criteria (Types::FindingCriteria)

    Specifies, as a map, one or more property-based conditions that filter the results of a query for findings.

  • :group_by (required, String)
  • :size (Integer)
  • :sort_criteria (Types::FindingStatisticsSortCriteria)

    Specifies criteria for sorting the results of a query for information about findings.

Returns:

See Also:

#get_findings(options = {}) ⇒ Types::GetFindingsResponse

Retrieves information about one or more findings.

Examples:

Request syntax with placeholder values


resp = client.get_findings({
  finding_ids: ["__string"], # required
  sort_criteria: {
    attribute_name: "__string",
    order_by: "ASC", # accepts ASC, DESC
  },
})

Response structure


resp.findings #=> Array
resp.findings[0]. #=> String
resp.findings[0].archived #=> true/false
resp.findings[0].category #=> String, one of "CLASSIFICATION", "POLICY"
resp.findings[0].classification_details.detailed_results_location #=> String
resp.findings[0].classification_details.job_arn #=> String
resp.findings[0].classification_details.job_id #=> String
resp.findings[0].classification_details.result.custom_data_identifiers.detections #=> Array
resp.findings[0].classification_details.result.custom_data_identifiers.detections[0].arn #=> String
resp.findings[0].classification_details.result.custom_data_identifiers.detections[0].count #=> Integer
resp.findings[0].classification_details.result.custom_data_identifiers.detections[0].name #=> String
resp.findings[0].classification_details.result.custom_data_identifiers.total_count #=> Integer
resp.findings[0].classification_details.result.mime_type #=> String
resp.findings[0].classification_details.result.sensitive_data #=> Array
resp.findings[0].classification_details.result.sensitive_data[0].category #=> String, one of "FINANCIAL_INFORMATION", "PERSONAL_INFORMATION", "CREDENTIALS", "CUSTOM_IDENTIFIER"
resp.findings[0].classification_details.result.sensitive_data[0].detections #=> Array
resp.findings[0].classification_details.result.sensitive_data[0].detections[0].count #=> Integer
resp.findings[0].classification_details.result.sensitive_data[0].detections[0].type #=> String
resp.findings[0].classification_details.result.sensitive_data[0].total_count #=> Integer
resp.findings[0].classification_details.result.size_classified #=> Integer
resp.findings[0].classification_details.result.status.code #=> String
resp.findings[0].classification_details.result.status.reason #=> String
resp.findings[0].count #=> Integer
resp.findings[0].created_at #=> Time
resp.findings[0].description #=> String
resp.findings[0].id #=> String
resp.findings[0].partition #=> String
resp.findings[0].policy_details.action.action_type #=> String, one of "AWS_API_CALL"
resp.findings[0].policy_details.action.api_call_details.api #=> String
resp.findings[0].policy_details.action.api_call_details.api_service_name #=> String
resp.findings[0].policy_details.action.api_call_details.first_seen #=> Time
resp.findings[0].policy_details.action.api_call_details.last_seen #=> Time
resp.findings[0].policy_details.actor.domain_details.domain_name #=> String
resp.findings[0].policy_details.actor.ip_address_details.ip_address_v4 #=> String
resp.findings[0].policy_details.actor.ip_address_details.ip_city.name #=> String
resp.findings[0].policy_details.actor.ip_address_details.ip_country.code #=> String
resp.findings[0].policy_details.actor.ip_address_details.ip_country.name #=> String
resp.findings[0].policy_details.actor.ip_address_details.ip_geo_location.lat #=> Float
resp.findings[0].policy_details.actor.ip_address_details.ip_geo_location.lon #=> Float
resp.findings[0].policy_details.actor.ip_address_details.ip_owner.asn #=> String
resp.findings[0].policy_details.actor.ip_address_details.ip_owner.asn_org #=> String
resp.findings[0].policy_details.actor.ip_address_details.ip_owner.isp #=> String
resp.findings[0].policy_details.actor.ip_address_details.ip_owner.org #=> String
resp.findings[0].policy_details.actor.user_identity.assumed_role.access_key_id #=> String
resp.findings[0].policy_details.actor.user_identity.assumed_role. #=> String
resp.findings[0].policy_details.actor.user_identity.assumed_role.arn #=> String
resp.findings[0].policy_details.actor.user_identity.assumed_role.principal_id #=> String
resp.findings[0].policy_details.actor.user_identity.assumed_role.session_context.attributes.creation_date #=> Time
resp.findings[0].policy_details.actor.user_identity.assumed_role.session_context.attributes.mfa_authenticated #=> true/false
resp.findings[0].policy_details.actor.user_identity.assumed_role.session_context.session_issuer. #=> String
resp.findings[0].policy_details.actor.user_identity.assumed_role.session_context.session_issuer.arn #=> String
resp.findings[0].policy_details.actor.user_identity.assumed_role.session_context.session_issuer.principal_id #=> String
resp.findings[0].policy_details.actor.user_identity.assumed_role.session_context.session_issuer.type #=> String
resp.findings[0].policy_details.actor.user_identity.assumed_role.session_context.session_issuer.user_name #=> String
resp.findings[0].policy_details.actor.user_identity.. #=> String
resp.findings[0].policy_details.actor.user_identity..principal_id #=> String
resp.findings[0].policy_details.actor.user_identity.aws_service.invoked_by #=> String
resp.findings[0].policy_details.actor.user_identity.federated_user.access_key_id #=> String
resp.findings[0].policy_details.actor.user_identity.federated_user. #=> String
resp.findings[0].policy_details.actor.user_identity.federated_user.arn #=> String
resp.findings[0].policy_details.actor.user_identity.federated_user.principal_id #=> String
resp.findings[0].policy_details.actor.user_identity.federated_user.session_context.attributes.creation_date #=> Time
resp.findings[0].policy_details.actor.user_identity.federated_user.session_context.attributes.mfa_authenticated #=> true/false
resp.findings[0].policy_details.actor.user_identity.federated_user.session_context.session_issuer. #=> String
resp.findings[0].policy_details.actor.user_identity.federated_user.session_context.session_issuer.arn #=> String
resp.findings[0].policy_details.actor.user_identity.federated_user.session_context.session_issuer.principal_id #=> String
resp.findings[0].policy_details.actor.user_identity.federated_user.session_context.session_issuer.type #=> String
resp.findings[0].policy_details.actor.user_identity.federated_user.session_context.session_issuer.user_name #=> String
resp.findings[0].policy_details.actor.user_identity.iam_user. #=> String
resp.findings[0].policy_details.actor.user_identity.iam_user.arn #=> String
resp.findings[0].policy_details.actor.user_identity.iam_user.principal_id #=> String
resp.findings[0].policy_details.actor.user_identity.iam_user.user_name #=> String
resp.findings[0].policy_details.actor.user_identity.root. #=> String
resp.findings[0].policy_details.actor.user_identity.root.arn #=> String
resp.findings[0].policy_details.actor.user_identity.root.principal_id #=> String
resp.findings[0].policy_details.actor.user_identity.type #=> String, one of "AssumedRole", "IAMUser", "FederatedUser", "Root", "AWSAccount", "AWSService"
resp.findings[0].region #=> String
resp.findings[0].resources_affected.s3_bucket.arn #=> String
resp.findings[0].resources_affected.s3_bucket.created_at #=> Time
resp.findings[0].resources_affected.s3_bucket.default_server_side_encryption.encryption_type #=> String, one of "NONE", "AES256", "aws:kms"
resp.findings[0].resources_affected.s3_bucket.default_server_side_encryption.kms_master_key_id #=> String
resp.findings[0].resources_affected.s3_bucket.name #=> String
resp.findings[0].resources_affected.s3_bucket.owner.display_name #=> String
resp.findings[0].resources_affected.s3_bucket.owner.id #=> String
resp.findings[0].resources_affected.s3_bucket.public_access.effective_permission #=> String, one of "PUBLIC", "NOT_PUBLIC"
resp.findings[0].resources_affected.s3_bucket.public_access.permission_configuration..block_public_access.block_public_acls #=> true/false
resp.findings[0].resources_affected.s3_bucket.public_access.permission_configuration..block_public_access.block_public_policy #=> true/false
resp.findings[0].resources_affected.s3_bucket.public_access.permission_configuration..block_public_access.ignore_public_acls #=> true/false
resp.findings[0].resources_affected.s3_bucket.public_access.permission_configuration..block_public_access.restrict_public_buckets #=> true/false
resp.findings[0].resources_affected.s3_bucket.public_access.permission_configuration.bucket_level_permissions.access_control_list.allows_public_read_access #=> true/false
resp.findings[0].resources_affected.s3_bucket.public_access.permission_configuration.bucket_level_permissions.access_control_list.allows_public_write_access #=> true/false
resp.findings[0].resources_affected.s3_bucket.public_access.permission_configuration.bucket_level_permissions.block_public_access.block_public_acls #=> true/false
resp.findings[0].resources_affected.s3_bucket.public_access.permission_configuration.bucket_level_permissions.block_public_access.block_public_policy #=> true/false
resp.findings[0].resources_affected.s3_bucket.public_access.permission_configuration.bucket_level_permissions.block_public_access.ignore_public_acls #=> true/false
resp.findings[0].resources_affected.s3_bucket.public_access.permission_configuration.bucket_level_permissions.block_public_access.restrict_public_buckets #=> true/false
resp.findings[0].resources_affected.s3_bucket.public_access.permission_configuration.bucket_level_permissions.bucket_policy.allows_public_read_access #=> true/false
resp.findings[0].resources_affected.s3_bucket.public_access.permission_configuration.bucket_level_permissions.bucket_policy.allows_public_write_access #=> true/false
resp.findings[0].resources_affected.s3_bucket.tags #=> Array
resp.findings[0].resources_affected.s3_bucket.tags[0].key #=> String
resp.findings[0].resources_affected.s3_bucket.tags[0].value #=> String
resp.findings[0].resources_affected.s3_object.bucket_arn #=> String
resp.findings[0].resources_affected.s3_object.e_tag #=> String
resp.findings[0].resources_affected.s3_object.extension #=> String
resp.findings[0].resources_affected.s3_object.key #=> String
resp.findings[0].resources_affected.s3_object.last_modified #=> Time
resp.findings[0].resources_affected.s3_object.path #=> String
resp.findings[0].resources_affected.s3_object.public_access #=> true/false
resp.findings[0].resources_affected.s3_object.server_side_encryption.encryption_type #=> String, one of "NONE", "AES256", "aws:kms"
resp.findings[0].resources_affected.s3_object.server_side_encryption.kms_master_key_id #=> String
resp.findings[0].resources_affected.s3_object.size #=> Integer
resp.findings[0].resources_affected.s3_object.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "ONEZONE_IA", "GLACIER"
resp.findings[0].resources_affected.s3_object.tags #=> Array
resp.findings[0].resources_affected.s3_object.tags[0].key #=> String
resp.findings[0].resources_affected.s3_object.tags[0].value #=> String
resp.findings[0].resources_affected.s3_object.version_id #=> String
resp.findings[0].sample #=> true/false
resp.findings[0].schema_version #=> String
resp.findings[0].severity.description #=> String, one of "Low", "Medium", "High"
resp.findings[0].severity.score #=> Integer
resp.findings[0].title #=> String
resp.findings[0].type #=> String, one of "SensitiveData:S3Object/Multiple", "SensitiveData:S3Object/Financial", "SensitiveData:S3Object/Personal", "SensitiveData:S3Object/Credentials", "SensitiveData:S3Object/CustomIdentifier", "Policy:IAMUser/S3BucketPublic", "Policy:IAMUser/S3BucketSharedExternally", "Policy:IAMUser/S3BucketReplicatedExternally", "Policy:IAMUser/S3BucketEncryptionDisabled", "Policy:IAMUser/S3BlockPublicAccessDisabled"
resp.findings[0].updated_at #=> Time

Options Hash (options):

  • :finding_ids (required, Array<String>)
  • :sort_criteria (Types::SortCriteria)

    Specifies criteria for sorting the results of a request for information about findings.

Returns:

See Also:

#get_findings_filter(options = {}) ⇒ Types::GetFindingsFilterResponse

Retrieves information about the criteria and other settings for a findings filter.

Examples:

Request syntax with placeholder values


resp = client.get_findings_filter({
  id: "__string", # required
})

Response structure


resp.action #=> String, one of "ARCHIVE", "NOOP"
resp.arn #=> String
resp.description #=> String
resp.finding_criteria.criterion #=> Hash
resp.finding_criteria.criterion["__string"].eq #=> Array
resp.finding_criteria.criterion["__string"].eq[0] #=> String
resp.finding_criteria.criterion["__string"].gt #=> Integer
resp.finding_criteria.criterion["__string"].gte #=> Integer
resp.finding_criteria.criterion["__string"].lt #=> Integer
resp.finding_criteria.criterion["__string"].lte #=> Integer
resp.finding_criteria.criterion["__string"].neq #=> Array
resp.finding_criteria.criterion["__string"].neq[0] #=> String
resp.id #=> String
resp.name #=> String
resp.position #=> Integer
resp.tags #=> Hash
resp.tags["__string"] #=> String

Options Hash (options):

  • :id (required, String)

Returns:

See Also:

#get_invitations_count(options = {}) ⇒ Types::GetInvitationsCountResponse

Retrieves the count of Amazon Macie membership invitations that were received by an account.

Examples:

Request syntax with placeholder values


resp = client.get_invitations_count()

Response structure


resp.invitations_count #=> Integer

Returns:

See Also:

#get_macie_session(options = {}) ⇒ Types::GetMacieSessionResponse

Retrieves information about the current status and configuration settings for an Amazon Macie account.

Examples:

Request syntax with placeholder values


resp = client.get_macie_session()

Response structure


resp.created_at #=> Time
resp.finding_publishing_frequency #=> String, one of "FIFTEEN_MINUTES", "ONE_HOUR", "SIX_HOURS"
resp.service_role #=> String
resp.status #=> String, one of "PAUSED", "ENABLED"
resp.updated_at #=> Time

Returns:

See Also:

#get_master_account(options = {}) ⇒ Types::GetMasterAccountResponse

Retrieves information about the Amazon Macie master account for an account.

Examples:

Request syntax with placeholder values


resp = client.()

Response structure


resp.master. #=> String
resp.master.invitation_id #=> String
resp.master.invited_at #=> Time
resp.master.relationship_status #=> String, one of "Enabled", "Paused", "Invited", "Created", "Removed", "Resigned", "EmailVerificationInProgress", "EmailVerificationFailed"

Returns:

See Also:

#get_member(options = {}) ⇒ Types::GetMemberResponse

Retrieves information about a member account that's associated with an Amazon Macie master account.

Examples:

Request syntax with placeholder values


resp = client.get_member({
  id: "__string", # required
})

Response structure


resp. #=> String
resp.arn #=> String
resp.email #=> String
resp.invited_at #=> Time
resp. #=> String
resp.relationship_status #=> String, one of "Enabled", "Paused", "Invited", "Created", "Removed", "Resigned", "EmailVerificationInProgress", "EmailVerificationFailed"
resp.tags #=> Hash
resp.tags["__string"] #=> String
resp.updated_at #=> Time

Options Hash (options):

  • :id (required, String)

Returns:

See Also:

#get_usage_statistics(options = {}) ⇒ Types::GetUsageStatisticsResponse

Retrieves (queries) quotas and aggregated usage data for one or more accounts.

Examples:

Request syntax with placeholder values


resp = client.get_usage_statistics({
  filter_by: [
    {
      key: "accountId", # accepts accountId
      values: ["__string"],
    },
  ],
  max_results: 1,
  next_token: "__string",
  sort_by: {
    key: "accountId", # accepts accountId, total
    order_by: "ASC", # accepts ASC, DESC
  },
})

Response structure


resp.next_token #=> String
resp.records #=> Array
resp.records[0]. #=> String
resp.records[0].free_trial_start_date #=> Time
resp.records[0].usage #=> Array
resp.records[0].usage[0].currency #=> String, one of "USD"
resp.records[0].usage[0].estimated_cost #=> String
resp.records[0].usage[0].service_limit.is_service_limited #=> true/false
resp.records[0].usage[0].service_limit.unit #=> String, one of "TERABYTES"
resp.records[0].usage[0].service_limit.value #=> Integer
resp.records[0].usage[0].type #=> String, one of "DATA_INVENTORY_EVALUATION", "SENSITIVE_DATA_DISCOVERY"

Options Hash (options):

Returns:

See Also:

#get_usage_totals(options = {}) ⇒ Types::GetUsageTotalsResponse

Retrieves (queries) aggregated usage data for an account.

Examples:

Request syntax with placeholder values


resp = client.get_usage_totals()

Response structure


resp.usage_totals #=> Array
resp.usage_totals[0].currency #=> String, one of "USD"
resp.usage_totals[0].estimated_cost #=> String
resp.usage_totals[0].type #=> String, one of "DATA_INVENTORY_EVALUATION", "SENSITIVE_DATA_DISCOVERY"

Returns:

See Also:

#list_classification_jobs(options = {}) ⇒ Types::ListClassificationJobsResponse

Retrieves information about the status and settings for one or more classification jobs.

Examples:

Request syntax with placeholder values


resp = client.list_classification_jobs({
  filter_criteria: {
    excludes: [
      {
        comparator: "EQ", # accepts EQ, GT, GTE, LT, LTE, NE, CONTAINS
        key: "jobType", # accepts jobType, jobStatus, createdAt, name
        values: ["__string"],
      },
    ],
    includes: [
      {
        comparator: "EQ", # accepts EQ, GT, GTE, LT, LTE, NE, CONTAINS
        key: "jobType", # accepts jobType, jobStatus, createdAt, name
        values: ["__string"],
      },
    ],
  },
  max_results: 1,
  next_token: "__string",
  sort_criteria: {
    attribute_name: "createdAt", # accepts createdAt, jobStatus, name, jobType
    order_by: "ASC", # accepts ASC, DESC
  },
})

Response structure


resp.items #=> Array
resp.items[0].bucket_definitions #=> Array
resp.items[0].bucket_definitions[0]. #=> String
resp.items[0].bucket_definitions[0].buckets #=> Array
resp.items[0].bucket_definitions[0].buckets[0] #=> String
resp.items[0].created_at #=> Time
resp.items[0].job_id #=> String
resp.items[0].job_status #=> String, one of "RUNNING", "PAUSED", "CANCELLED", "COMPLETE", "IDLE"
resp.items[0].job_type #=> String, one of "ONE_TIME", "SCHEDULED"
resp.items[0].name #=> String
resp.next_token #=> String

Options Hash (options):

  • :filter_criteria (Types::ListJobsFilterCriteria)

    Specifies criteria for filtering the results of a request for information about classification jobs.

  • :max_results (Integer)
  • :next_token (String)
  • :sort_criteria (Types::ListJobsSortCriteria)

    Specifies criteria for sorting the results of a request for information about classification jobs.

Returns:

See Also:

#list_custom_data_identifiers(options = {}) ⇒ Types::ListCustomDataIdentifiersResponse

Retrieves a subset of information about all the custom data identifiers for an account.

Examples:

Request syntax with placeholder values


resp = client.list_custom_data_identifiers({
  max_results: 1,
  next_token: "__string",
})

Response structure


resp.items #=> Array
resp.items[0].arn #=> String
resp.items[0].created_at #=> Time
resp.items[0].description #=> String
resp.items[0].id #=> String
resp.items[0].name #=> String
resp.next_token #=> String

Options Hash (options):

  • :max_results (Integer)
  • :next_token (String)

Returns:

See Also:

#list_findings(options = {}) ⇒ Types::ListFindingsResponse

Retrieves a subset of information about one or more findings.

Examples:

Request syntax with placeholder values


resp = client.list_findings({
  finding_criteria: {
    criterion: {
      "__string" => {
        eq: ["__string"],
        gt: 1,
        gte: 1,
        lt: 1,
        lte: 1,
        neq: ["__string"],
      },
    },
  },
  max_results: 1,
  next_token: "__string",
  sort_criteria: {
    attribute_name: "__string",
    order_by: "ASC", # accepts ASC, DESC
  },
})

Response structure


resp.finding_ids #=> Array
resp.finding_ids[0] #=> String
resp.next_token #=> String

Options Hash (options):

  • :finding_criteria (Types::FindingCriteria)

    Specifies, as a map, one or more property-based conditions that filter the results of a query for findings.

  • :max_results (Integer)
  • :next_token (String)
  • :sort_criteria (Types::SortCriteria)

    Specifies criteria for sorting the results of a request for information about findings.

Returns:

See Also:

#list_findings_filters(options = {}) ⇒ Types::ListFindingsFiltersResponse

Retrieves a subset of information about all the findings filters for an account.

Examples:

Request syntax with placeholder values


resp = client.list_findings_filters({
  max_results: 1,
  next_token: "__string",
})

Response structure


resp.findings_filter_list_items #=> Array
resp.findings_filter_list_items[0].arn #=> String
resp.findings_filter_list_items[0].id #=> String
resp.findings_filter_list_items[0].name #=> String
resp.findings_filter_list_items[0].tags #=> Hash
resp.findings_filter_list_items[0].tags["__string"] #=> String
resp.next_token #=> String

Options Hash (options):

  • :max_results (Integer)
  • :next_token (String)

Returns:

See Also:

#list_invitations(options = {}) ⇒ Types::ListInvitationsResponse

Retrieves information about all the Amazon Macie membership invitations that were received by an account.

Examples:

Request syntax with placeholder values


resp = client.list_invitations({
  max_results: 1,
  next_token: "__string",
})

Response structure


resp.invitations #=> Array
resp.invitations[0]. #=> String
resp.invitations[0].invitation_id #=> String
resp.invitations[0].invited_at #=> Time
resp.invitations[0].relationship_status #=> String, one of "Enabled", "Paused", "Invited", "Created", "Removed", "Resigned", "EmailVerificationInProgress", "EmailVerificationFailed"
resp.next_token #=> String

Options Hash (options):

  • :max_results (Integer)
  • :next_token (String)

Returns:

See Also:

#list_members(options = {}) ⇒ Types::ListMembersResponse

Retrieves information about the accounts that are associated with an Amazon Macie master account.

Examples:

Request syntax with placeholder values


resp = client.list_members({
  max_results: 1,
  next_token: "__string",
  only_associated: "__string",
})

Response structure


resp.members #=> Array
resp.members[0]. #=> String
resp.members[0].arn #=> String
resp.members[0].email #=> String
resp.members[0].invited_at #=> Time
resp.members[0]. #=> String
resp.members[0].relationship_status #=> String, one of "Enabled", "Paused", "Invited", "Created", "Removed", "Resigned", "EmailVerificationInProgress", "EmailVerificationFailed"
resp.members[0].tags #=> Hash
resp.members[0].tags["__string"] #=> String
resp.members[0].updated_at #=> Time
resp.next_token #=> String

Options Hash (options):

  • :max_results (Integer)
  • :next_token (String)
  • :only_associated (String)

Returns:

See Also:

#list_organization_admin_accounts(options = {}) ⇒ Types::ListOrganizationAdminAccountsResponse

Retrieves information about the account that's designated as the delegated administrator of Amazon Macie for an AWS organization.

Examples:

Request syntax with placeholder values


resp = client.list_organization_admin_accounts({
  max_results: 1,
  next_token: "__string",
})

Response structure


resp.admin_accounts #=> Array
resp.admin_accounts[0]. #=> String
resp.admin_accounts[0].status #=> String, one of "ENABLED", "DISABLING_IN_PROGRESS"
resp.next_token #=> String

Options Hash (options):

  • :max_results (Integer)
  • :next_token (String)

Returns:

See Also:

#list_tags_for_resource(options = {}) ⇒ Types::ListTagsForResourceResponse

Retrieves the tags (keys and values) that are associated with a classification job, custom data identifier, findings filter, or member account.

Examples:

Request syntax with placeholder values


resp = client.list_tags_for_resource({
  resource_arn: "__string", # required
})

Response structure


resp.tags #=> Hash
resp.tags["__string"] #=> String

Options Hash (options):

  • :resource_arn (required, String)

Returns:

See Also:

#put_classification_export_configuration(options = {}) ⇒ Types::PutClassificationExportConfigurationResponse

Creates or updates the configuration settings for exporting data classification results.

Examples:

Request syntax with placeholder values


resp = client.put_classification_export_configuration({
  configuration: { # required
    s3_destination: {
      bucket_name: "__string", # required
      key_prefix: "__string",
      kms_key_arn: "__string", # required
    },
  },
})

Response structure


resp.configuration.s3_destination.bucket_name #=> String
resp.configuration.s3_destination.key_prefix #=> String
resp.configuration.s3_destination.kms_key_arn #=> String

Options Hash (options):

  • :configuration (required, Types::ClassificationExportConfiguration)

    Specifies where to export data classification results to, and the encryption settings to use when storing results in that location. Currently, you can export classification results only to an S3 bucket.

Returns:

See Also:

#tag_resource(options = {}) ⇒ Struct

Adds or updates one or more tags (keys and values) that are associated with a classification job, custom data identifier, findings filter, or member account.

Examples:

Request syntax with placeholder values


resp = client.tag_resource({
  resource_arn: "__string", # required
  tags: { # required
    "__string" => "__string",
  },
})

Options Hash (options):

  • :resource_arn (required, String)
  • :tags (required, Hash<String,String>)

    A string-to-string map of key-value pairs that specifies the tags (keys and values) for a classification job, custom data identifier, findings filter, or member account.

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#test_custom_data_identifier(options = {}) ⇒ Types::TestCustomDataIdentifierResponse

Tests a custom data identifier.

Examples:

Request syntax with placeholder values


resp = client.test_custom_data_identifier({
  ignore_words: ["__string"],
  keywords: ["__string"],
  maximum_match_distance: 1,
  regex: "__string", # required
  sample_text: "__string", # required
})

Response structure


resp.match_count #=> Integer

Options Hash (options):

  • :ignore_words (Array<String>)
  • :keywords (Array<String>)
  • :maximum_match_distance (Integer)
  • :regex (required, String)
  • :sample_text (required, String)

Returns:

See Also:

#unarchive_findings(options = {}) ⇒ Struct

Reactivates (unarchives) one or more findings.

Examples:

Request syntax with placeholder values


resp = client.unarchive_findings({
  finding_ids: ["__string"], # required
})

Options Hash (options):

  • :finding_ids (required, Array<String>)

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#untag_resource(options = {}) ⇒ Struct

Removes one or more tags (keys and values) from a classification job, custom data identifier, findings filter, or member account.

Examples:

Request syntax with placeholder values


resp = client.untag_resource({
  resource_arn: "__string", # required
  tag_keys: ["__string"], # required
})

Options Hash (options):

  • :resource_arn (required, String)
  • :tag_keys (required, Array<String>)

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#update_classification_job(options = {}) ⇒ Struct

Cancels a classification job.

Examples:

Request syntax with placeholder values


resp = client.update_classification_job({
  job_id: "__string", # required
  job_status: "RUNNING", # required, accepts RUNNING, PAUSED, CANCELLED, COMPLETE, IDLE
})

Options Hash (options):

  • :job_id (required, String)
  • :job_status (required, String)

    The current status of a classification job. Valid values are:

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#update_findings_filter(options = {}) ⇒ Types::UpdateFindingsFilterResponse

Updates the criteria and other settings for a findings filter.

Examples:

Request syntax with placeholder values


resp = client.update_findings_filter({
  action: "ARCHIVE", # accepts ARCHIVE, NOOP
  description: "__string",
  finding_criteria: {
    criterion: {
      "__string" => {
        eq: ["__string"],
        gt: 1,
        gte: 1,
        lt: 1,
        lte: 1,
        neq: ["__string"],
      },
    },
  },
  id: "__string", # required
  name: "__string",
  position: 1,
})

Response structure


resp.arn #=> String
resp.id #=> String

Options Hash (options):

  • :action (String)

    The action to perform on findings that meet the filter criteria. Valid values are:

  • :description (String)
  • :finding_criteria (Types::FindingCriteria)

    Specifies, as a map, one or more property-based conditions that filter the results of a query for findings.

  • :id (required, String)
  • :name (String)
  • :position (Integer)

Returns:

See Also:

#update_macie_session(options = {}) ⇒ Struct

Suspends or re-enables an Amazon Macie account, or updates the configuration settings for a Macie account.

Examples:

Request syntax with placeholder values


resp = client.update_macie_session({
  finding_publishing_frequency: "FIFTEEN_MINUTES", # accepts FIFTEEN_MINUTES, ONE_HOUR, SIX_HOURS
  status: "PAUSED", # accepts PAUSED, ENABLED
})

Options Hash (options):

  • :finding_publishing_frequency (String)

    The frequency with which Amazon Macie publishes findings for an account. This includes adding findings to AWS Security Hub and exporting finding events to Amazon CloudWatch. Valid values are:

  • :status (String)

    The status of an Amazon Macie account. Valid values are:

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#update_member_session(options = {}) ⇒ Struct

Enables an Amazon Macie master account to suspend or re-enable a member account.

Examples:

Request syntax with placeholder values


resp = client.update_member_session({
  id: "__string", # required
  status: "PAUSED", # required, accepts PAUSED, ENABLED
})

Options Hash (options):

  • :id (required, String)
  • :status (required, String)

    The status of an Amazon Macie account. Valid values are:

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#update_organization_configuration(options = {}) ⇒ Struct

Updates Amazon Macie configuration settings for an AWS organization.

Examples:

Request syntax with placeholder values


resp = client.update_organization_configuration({
  auto_enable: false, # required
})

Options Hash (options):

  • :auto_enable (required, Boolean)

Returns:

  • (Struct)

    Returns an empty response.

See Also:

#wait_until(waiter_name, params = {}) {|waiter| ... } ⇒ Boolean

Waiters polls an API operation until a resource enters a desired state.

Basic Usage

Waiters will poll until they are succesful, they fail by entering a terminal state, or until a maximum number of attempts are made.

# polls in a loop, sleeping between attempts client.waiter_until(waiter_name, params)

Configuration

You can configure the maximum number of polling attempts, and the delay (in seconds) between each polling attempt. You configure waiters by passing a block to #wait_until:

# poll for ~25 seconds
client.wait_until(...) do |w|
  w.max_attempts = 5
  w.delay = 5
end

Callbacks

You can be notified before each polling attempt and before each delay. If you throw :success or :failure from these callbacks, it will terminate the waiter.

started_at = Time.now
client.wait_until(...) do |w|

  # disable max attempts
  w.max_attempts = nil

  # poll for 1 hour, instead of a number of attempts
  w.before_wait do |attempts, response|
    throw :failure if Time.now - started_at > 3600
  end

end

Handling Errors

When a waiter is successful, it returns true. When a waiter fails, it raises an error. All errors raised extend from Waiters::Errors::WaiterFailed.

begin
  client.wait_until(...)
rescue Aws::Waiters::Errors::WaiterFailed
  # resource did not enter the desired state in time
end

Parameters:

  • waiter_name (Symbol)

    The name of the waiter. See #waiter_names for a full list of supported waiters.

  • params (Hash) (defaults to: {})

    Additional request parameters. See the #waiter_names for a list of supported waiters and what request they call. The called request determines the list of accepted parameters.

Yield Parameters:

Returns:

  • (Boolean)

    Returns true if the waiter was successful.

Raises:

  • (Errors::FailureStateError)

    Raised when the waiter terminates because the waiter has entered a state that it will not transition out of, preventing success.

  • (Errors::TooManyAttemptsError)

    Raised when the configured maximum number of attempts have been made, and the waiter is not yet successful.

  • (Errors::UnexpectedError)

    Raised when an error is encounted while polling for a resource that is not expected.

  • (Errors::NoSuchWaiterError)

    Raised when you request to wait for an unknown state.

#waiter_namesArray<Symbol>

Returns the list of supported waiters. The following table lists the supported waiters and the client method they call:

Waiter NameClient MethodDefault Delay:Default Max Attempts:

Returns:

  • (Array<Symbol>)

    the list of supported waiters.