You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.
Class: Aws::Schemas::Client OverviewAn API client for Schemas. To construct a client, you need to configure a :region
and :credentials
.
schemas = Aws::Schemas::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::Schemas::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.
Creates a schema definition.
Inactive schemas will be deleted after two years.
.
Delete the resource-based policy attached to the specified registry.
.
Delete a schema definition.
.
Delete the schema version definition
.
Describe the code binding URI.
.
Describes the discoverer.
.
Describes the registry.
.
Retrieve the schema definition.
.
Exports a schema to a different specification.
.
Get the code binding source URI.
.
Get the discovered schema that was generated based on sampled events.
.
Retrieves the resource-based policy attached to a given registry.
.
Provides a list of the schema versions and related information.
.
The name of the policy.
.
Add tags to a resource.
.
Removes tags from a resource.
.
Updates the schema definition
Inactive schemas will be deleted after two years.
.
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 #create_schema(options = {}) ⇒ Types::CreateSchemaResponseCreates a schema definition.
Inactive schemas will be deleted after two years.
#delete_discoverer(options = {}) ⇒ Struct #delete_registry(options = {}) ⇒ Struct #delete_resource_policy(options = {}) ⇒ StructDelete the resource-based policy attached to the specified registry.
#delete_schema(options = {}) ⇒ StructDelete a schema definition.
#delete_schema_version(options = {}) ⇒ StructDelete the schema version definition
#tag_resource(options = {}) ⇒ Struct #untag_resource(options = {}) ⇒ StructRemoves tags from a resource.
#update_schema(options = {}) ⇒ Types::UpdateSchemaResponseUpdates the schema definition
Inactive schemas will be deleted after two years.
#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: :code_binding_exists #describe_code_binding 2 30RetroSearch 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