You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.
Class: Aws::AccessAnalyzer::Client OverviewAn API client for Access Analyzer. To construct a client, you need to configure a :region
and :credentials
.
accessanalyzer = Aws::AccessAnalyzer::Client.new(
region: region_name,
credentials: credentials,
)
See #initialize for a full list of supported configuration options.
RegionYou can configure a default region in the following locations:
ENV['AWS_REGION']
Aws.config[:region]
Go here for a list of supported regions.
CredentialsDefault credentials are loaded automatically from the following locations:
ENV['AWS_ACCESS_KEY_ID']
and ENV['AWS_SECRET_ACCESS_KEY']
Aws.config[:credentials]
~/.aws/credentials
(more information)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
:
creds = YAML.load(File.read('/path/to/secrets'))
Aws::AccessAnalyzer::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.
Attribute Summary collapseConstructs an API client.
Retroactively applies the archive rule to existing findings that meet the archive rule criteria.
.
Creates an analyzer for your account.
.
Creates an archive rule for the specified analyzer.
Deletes the specified analyzer.
Deletes the specified archive rule.
.
Retrieves information about a resource that was analyzed.
.
Retrieves information about the specified analyzer.
.
Retrieves information about an archive rule.
To learn about filter keys that you can use to create an archive rule, see Access Analyzer filter keys in the IAM User Guide.
.
Retrieves information about the specified finding.
.
Retrieves a list of resources of the specified type that have been analyzed by the specified analyzer..
.
Retrieves a list of analyzers.
.
Retrieves a list of archive rules created for the specified analyzer.
.
Retrieves a list of findings generated by the specified analyzer.
To learn about filter keys that you can use to create an archive rule, see Access Analyzer filter keys in the IAM User Guide.
.
Retrieves a list of tags applied to the specified resource.
.
Immediately starts a scan of the policies applied to the specified resource.
.
Adds a tag to the specified resource.
.
Removes a tag from the specified resource.
.
Updates the criteria and values for the specified archive rule.
.
Updates the status for the specified findings.
.
Waiters polls an API operation until a resource enters a desired state.
Returns the list of supported waiters.
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
Instance Method Details #apply_archive_rule(options = {}) ⇒ StructRetroactively applies the archive rule to existing findings that meet the archive rule criteria.
#create_archive_rule(options = {}) ⇒ StructCreates an archive rule for the specified analyzer. Archive rules automatically archive new findings that meet the criteria you define when you create the rule.
#delete_analyzer(options = {}) ⇒ StructDeletes the specified analyzer. When you delete an analyzer, Access Analyzer is disabled for the account in the current or specific Region. All findings that were generated by the analyzer are deleted. You cannot undo this action.
#delete_archive_rule(options = {}) ⇒ StructDeletes the specified archive rule.
#list_analyzed_resources(options = {}) ⇒ Types::ListAnalyzedResourcesResponseRetrieves a list of resources of the specified type that have been analyzed by the specified analyzer..
#start_resource_scan(options = {}) ⇒ StructImmediately starts a scan of the policies applied to the specified resource.
#tag_resource(options = {}) ⇒ StructAdds a tag to the specified resource.
#untag_resource(options = {}) ⇒ StructRemoves a tag from the specified resource.
#update_archive_rule(options = {}) ⇒ StructUpdates the criteria and values for the specified archive rule.
#update_findings(options = {}) ⇒ StructUpdates the status for the specified findings.
#wait_until(waiter_name, params = {}) {|waiter| ... } ⇒ BooleanWaiters polls an API operation until a resource enters a desired state.
Basic UsageWaiters 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)
ConfigurationYou 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
#waiter_names ⇒ Array<Symbol>
Returns the list of supported waiters. The following table lists the supported waiters and the client method they call:
Waiter Name Client Method Default Delay: Default Max Attempts:RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4