You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.
Class: Aws::ServiceQuotas::Client OverviewAn API client for Service Quotas. To construct a client, you need to configure a :region
and :credentials
.
servicequotas = Aws::ServiceQuotas::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::ServiceQuotas::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.
Associates the Service Quotas template with your organization so that when new accounts are created in your organization, the template submits increase requests for the specified service quotas.
Removes a service quota increase request from the Service Quotas template.
Disables the Service Quotas template.
Retrieves the ServiceQuotaTemplateAssociationStatus
value from the service.
Retrieves the default service quotas values.
Retrieves the details for a particular increase request.
Returns the details for the specified service quota.
Returns the details of the service quota increase request in your template.
.
Lists all default service quotas for the specified AWS service or all AWS services.
Requests a list of the changes to quotas for a service.
.
Requests a list of the changes to specific service quotas.
Returns a list of the quota increase requests in the template.
Lists all service quotas for the specified AWS service.
Lists the AWS services available in Service Quotas.
Defines and adds a quota to the service quota template.
Retrieves the details of a service quota increase request.
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 #associate_service_quota_template(options = {}) ⇒ StructAssociates the Service Quotas template with your organization so that when new accounts are created in your organization, the template submits increase requests for the specified service quotas. Use the Service Quotas template to request an increase for any adjustable quota value. After you define the Service Quotas template, use this operation to associate, or enable, the template.
#delete_service_quota_increase_request_from_template(options = {}) ⇒ StructRemoves a service quota increase request from the Service Quotas template.
#disassociate_service_quota_template(options = {}) ⇒ StructDisables the Service Quotas template. Once the template is disabled, it does not request quota increases for new accounts in your organization. Disabling the quota template does not apply the quota increase requests from the template.
Related operations
To enable the quota template, call AssociateServiceQuotaTemplate.
To delete a specific service quota from the template, use DeleteServiceQuotaIncreaseRequestFromTemplate.
Retrieves the ServiceQuotaTemplateAssociationStatus
value from the service. Use this action to determine if the Service Quota template is associated, or enabled.
Retrieves the default service quotas values. The Value returned for each quota is the AWS default value, even if the quotas have been increased..
#get_service_quota(options = {}) ⇒ Types::GetServiceQuotaResponseReturns the details for the specified service quota. This operation provides a different Value than the GetAWSDefaultServiceQuota
operation. This operation returns the applied value for each quota. GetAWSDefaultServiceQuota
returns the default AWS value for each quota.
Lists all default service quotas for the specified AWS service or all AWS services. ListAWSDefaultServiceQuotas is similar to ListServiceQuotas except for the Value object. The Value object returned by ListAWSDefaultServiceQuotas
is the default value assigned by AWS. This request returns a list of all service quotas for the specified service. The listing of each you'll see the default values are the values that AWS provides for the quotas.
Always check the NextToken
response parameter when calling any of the List*
operations. These operations can return an unexpected list of results, even when there are more results available. When this happens, the NextToken
response parameter contains a value to pass the next call to the same API to request the next part of the list.
Requests a list of the changes to specific service quotas. This command provides additional granularity over the ListRequestedServiceQuotaChangeHistory
command. Once a quota change request has reached CASE_CLOSED, APPROVED,
or DENIED
, the history has been kept for 90 days.
Lists all service quotas for the specified AWS service. This request returns a list of the service quotas for the specified service. you'll see the default values are the values that AWS provides for the quotas.
Always check the NextToken
response parameter when calling any of the List*
operations. These operations can return an unexpected list of results, even when there are more results available. When this happens, the NextToken
response parameter contains a value to pass the next call to the same API to request the next part of the list.
Lists the AWS services available in Service Quotas. Not all AWS services are available in Service Quotas. To list the see the list of the service quotas for a specific service, use ListServiceQuotas.
#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