You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.
Class: Aws::GroundStation::Client OverviewAn API client for AWS Ground Station. To construct a client, you need to configure a :region
and :credentials
.
groundstation = Aws::GroundStation::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::GroundStation::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.
Cancels a contact with a specified contact ID.
.
Creates a Config
with the specified configData
parameters.
Only one type of configData
can be specified.
.
Creates a DataflowEndpoint
group containing the specified list of DataflowEndpoint
objects.
The name
field in each endpoint is used in your mission profile DataflowEndpointConfig
to specify which endpoints to use during a contact.
When a contact uses multiple DataflowEndpointConfig
objects, each Config
must match a DataflowEndpoint
in the same group.
.
Creates a mission profile.
dataflowEdges
is a list of lists of strings.
Deletes a dataflow endpoint group.
.
Deletes a mission profile.
.
Describes an existing contact.
.
Returns Config
information.
Only one Config
response can be returned.
.
Returns the dataflow endpoint group.
.
Returns the number of minutes used by account.
.
Returns a mission profile.
.
Returns a list of Config
objects.
.
Returns a list of contacts.
If statusList
contains AVAILABLE, the request must include groundStation
, missionprofileArn
, and satelliteArn
.
Returns a list of DataflowEndpoint
groups.
.
Returns a list of ground stations.
Returns a list of mission profiles.
.
Returns a list of satellites.
.
Returns a list of tags for a specified resource.
.
Reserves a contact using specified parameters.
.
Assigns a tag to a resource.
.
Deassigns a resource tag.
.
Updates the Config
used when scheduling contacts.
Updating a Config
will not update the execution parameters for existing future contacts scheduled with this Config
.
.
Updates a mission profile.
Updating a mission profile will not update the execution parameters for existing future contacts.
.
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_config(options = {}) ⇒ Types::ConfigIdResponseCreates a Config
with the specified configData
parameters.
Only one type of configData
can be specified.
Creates a DataflowEndpoint
group containing the specified list of DataflowEndpoint
objects.
The name
field in each endpoint is used in your mission profile DataflowEndpointConfig
to specify which endpoints to use during a contact.
When a contact uses multiple DataflowEndpointConfig
objects, each Config
must match a DataflowEndpoint
in the same group.
Creates a mission profile.
dataflowEdges
is a list of lists of strings. Each lower level list of strings has two elements: a from ARN and a to ARN.
Returns Config
information.
Only one Config
response can be returned.
Returns a list of contacts.
If statusList
contains AVAILABLE, the request must include groundStation
, missionprofileArn
, and satelliteArn
.
Assigns a tag to a resource.
#untag_resource(options = {}) ⇒ StructDeassigns a resource tag.
#update_config(options = {}) ⇒ Types::ConfigIdResponseUpdates the Config
used when scheduling contacts.
Updating a Config
will not update the execution parameters for existing future contacts scheduled with this Config
.
Updates a mission profile.
Updating a mission profile will not update the execution parameters for existing future contacts.
#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