Client — AWS SDK for Ruby V3 (original) (raw)

Constructor Details

#initialize(options) ⇒ Client

Returns a new instance of Client.

Instance Method Details

#add_listener_certificates(params = {}) ⇒ Types::AddListenerCertificatesOutput

Adds the specified SSL server certificate to the certificate list for the specified HTTPS or TLS listener.

If the certificate in already in the certificate list, the call is successful but the certificate is not added again.

For more information, see SSL certificates in the Application Load Balancers Guide or Server certificates in the Network Load Balancers Guide.

#add_tags(params = {}) ⇒ Struct

Adds the specified tags to the specified Elastic Load Balancing resource. You can tag your Application Load Balancers, Network Load Balancers, Gateway Load Balancers, target groups, trust stores, listeners, and rules.

Each tag consists of a key and an optional value. If a resource already has a tag with the same key, AddTags updates its value.

#add_trust_store_revocations(params = {}) ⇒ Types::AddTrustStoreRevocationsOutput

Adds the specified revocation file to the specified trust store.

#create_listener(params = {}) ⇒ Types::CreateListenerOutput

#create_load_balancer(params = {}) ⇒ Types::CreateLoadBalancerOutput

Creates an Application Load Balancer, Network Load Balancer, or Gateway Load Balancer.

For more information, see the following:

• Application Load Balancers
• Network Load Balancers
• Gateway Load Balancers

This operation is idempotent, which means that it completes at most one time. If you attempt to create multiple load balancers with the same settings, each call succeeds.

#create_rule(params = {}) ⇒ Types::CreateRuleOutput

Creates a rule for the specified listener. The listener must be associated with an Application Load Balancer.

Each rule consists of a priority, one or more actions, one or more conditions, and up to two optional transforms. Rules are evaluated in priority order, from the lowest value to the highest value. When the conditions for a rule are met, its actions are performed. If the conditions for no rules are met, the actions for the default rule are performed. For more information, see Listener rules in the_Application Load Balancers Guide_.

#create_target_group(params = {}) ⇒ Types::CreateTargetGroupOutput

#create_trust_store(params = {}) ⇒ Types::CreateTrustStoreOutput

#delete_listener(params = {}) ⇒ Struct

Deletes the specified listener.

Alternatively, your listener is deleted when you delete the load balancer to which it is attached.

#delete_load_balancer(params = {}) ⇒ Struct

Deletes the specified Application Load Balancer, Network Load Balancer, or Gateway Load Balancer. Deleting a load balancer also deletes its listeners.

You can't delete a load balancer if deletion protection is enabled. If the load balancer does not exist or has already been deleted, the call succeeds.

Deleting a load balancer does not affect its registered targets. For example, your EC2 instances continue to run and are still registered to their target groups. If you no longer need these EC2 instances, you can stop or terminate them.

#delete_rule(params = {}) ⇒ Struct

Deletes the specified rule.

You can't delete the default rule.

#delete_shared_trust_store_association(params = {}) ⇒ Struct

Deletes a shared trust store association.

#delete_target_group(params = {}) ⇒ Struct

Deletes the specified target group.

You can delete a target group if it is not referenced by any actions. Deleting a target group also deletes any associated health checks. Deleting a target group does not affect its registered targets. For example, any EC2 instances continue to run until you stop or terminate them.

#delete_trust_store(params = {}) ⇒ Struct

#deregister_targets(params = {}) ⇒ Struct

Deregisters the specified targets from the specified target group. After the targets are deregistered, they no longer receive traffic from the load balancer.

The load balancer stops sending requests to targets that are deregistering, but uses connection draining to ensure that in-flight traffic completes on the existing connections. This deregistration delay is configured by default but can be updated for each target group.

For more information, see the following:

• Deregistration delay in the Application Load Balancers User Guide
• Deregistration delay in the Network Load Balancers User Guide
• Deregistration delay in the Gateway Load Balancers User Guide

Note: If the specified target does not exist, the action returns successfully.

#describe_account_limits(params = {}) ⇒ Types::DescribeAccountLimitsOutput

#describe_capacity_reservation(params = {}) ⇒ Types::DescribeCapacityReservationOutput

Describes the capacity reservation status for the specified load balancer.

#describe_listener_attributes(params = {}) ⇒ Types::DescribeListenerAttributesOutput

Describes the attributes for the specified listener.

#describe_listener_certificates(params = {}) ⇒ Types::DescribeListenerCertificatesOutput

Describes the default certificate and the certificate list for the specified HTTPS or TLS listener.

If the default certificate is also in the certificate list, it appears twice in the results (once with IsDefault set to true and once withIsDefault set to false).

For more information, see SSL certificates in the Application Load Balancers Guide or Server certificates in the Network Load Balancers Guide.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

#describe_listeners(params = {}) ⇒ Types::DescribeListenersOutput

Describes the specified listeners or the listeners for the specified Application Load Balancer, Network Load Balancer, or Gateway Load Balancer. You must specify either a load balancer or one or more listeners.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

#describe_load_balancer_attributes(params = {}) ⇒ Types::DescribeLoadBalancerAttributesOutput

#describe_load_balancers(params = {}) ⇒ Types::DescribeLoadBalancersOutput

Describes the specified load balancers or all of your load balancers.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

The following waiters are defined for this operation (see #wait_until for detailed usage):

• load_balancer_available
• load_balancer_exists
• load_balancers_deleted

#describe_rules(params = {}) ⇒ Types::DescribeRulesOutput

Describes the specified rules or the rules for the specified listener. You must specify either a listener or rules.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

#describe_ssl_policies(params = {}) ⇒ Types::DescribeSSLPoliciesOutput

Describes the specified policies or all policies used for SSL negotiation.

For more information, see Security policies in the Application Load Balancers Guide and Security policies in the Network Load Balancers Guide.

#describe_tags(params = {}) ⇒ Types::DescribeTagsOutput

Describes the tags for the specified Elastic Load Balancing resources. You can describe the tags for one or more Application Load Balancers, Network Load Balancers, Gateway Load Balancers, target groups, listeners, or rules.

#describe_target_group_attributes(params = {}) ⇒ Types::DescribeTargetGroupAttributesOutput

#describe_target_groups(params = {}) ⇒ Types::DescribeTargetGroupsOutput

Describes the specified target groups or all of your target groups. By default, all target groups are described. Alternatively, you can specify one of the following to filter the results: the ARN of the load balancer, the names of one or more target groups, or the ARNs of one or more target groups.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

#describe_target_health(params = {}) ⇒ Types::DescribeTargetHealthOutput

Describes the health of the specified targets or all of your targets.

The following waiters are defined for this operation (see #wait_until for detailed usage):

• target_deregistered
• target_in_service

#describe_trust_store_associations(params = {}) ⇒ Types::DescribeTrustStoreAssociationsOutput

Describes all resources associated with the specified trust store.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

#describe_trust_store_revocations(params = {}) ⇒ Types::DescribeTrustStoreRevocationsOutput

Describes the revocation files in use by the specified trust store or revocation files.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

#describe_trust_stores(params = {}) ⇒ Types::DescribeTrustStoresOutput

Describes all trust stores for the specified account.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

#get_resource_policy(params = {}) ⇒ Types::GetResourcePolicyOutput

Retrieves the resource policy for a specified resource.

#get_trust_store_ca_certificates_bundle(params = {}) ⇒ Types::GetTrustStoreCaCertificatesBundleOutput

Retrieves the ca certificate bundle.

This action returns a pre-signed S3 URI which is active for ten minutes.

#get_trust_store_revocation_content(params = {}) ⇒ Types::GetTrustStoreRevocationContentOutput

Retrieves the specified revocation file.

This action returns a pre-signed S3 URI which is active for ten minutes.

#modify_capacity_reservation(params = {}) ⇒ Types::ModifyCapacityReservationOutput

Modifies the capacity reservation of the specified load balancer.

When modifying capacity reservation, you must include at least oneMinimumLoadBalancerCapacity or ResetCapacityReservation.

#modify_ip_pools(params = {}) ⇒ Types::ModifyIpPoolsOutput

[Application Load Balancers] Modify the IP pool associated to a load balancer.

#modify_listener(params = {}) ⇒ Types::ModifyListenerOutput

Replaces the specified properties of the specified listener. Any properties that you do not specify remain unchanged.

Changing the protocol from HTTPS to HTTP, or from TLS to TCP, removes the security policy and default certificate properties. If you change the protocol from HTTP to HTTPS, or from TCP to TLS, you must add the security policy and default certificate properties.

To add an item to a list, remove an item from a list, or update an item in a list, you must provide the entire list. For example, to add an action, specify a list with the current actions plus the new action.

#modify_listener_attributes(params = {}) ⇒ Types::ModifyListenerAttributesOutput

Modifies the specified attributes of the specified listener.

#modify_load_balancer_attributes(params = {}) ⇒ Types::ModifyLoadBalancerAttributesOutput

Modifies the specified attributes of the specified Application Load Balancer, Network Load Balancer, or Gateway Load Balancer.

If any of the specified attributes can't be modified as requested, the call fails. Any existing attributes that you do not modify retain their current values.

#modify_rule(params = {}) ⇒ Types::ModifyRuleOutput

Replaces the specified properties of the specified rule. Any properties that you do not specify are unchanged.

To add an item to a list, remove an item from a list, or update an item in a list, you must provide the entire list. For example, to add an action, specify a list with the current actions plus the new action.

#modify_target_group(params = {}) ⇒ Types::ModifyTargetGroupOutput

Modifies the health checks used when evaluating the health state of the targets in the specified target group.

#modify_target_group_attributes(params = {}) ⇒ Types::ModifyTargetGroupAttributesOutput

Modifies the specified attributes of the specified target group.

#modify_trust_store(params = {}) ⇒ Types::ModifyTrustStoreOutput

Update the ca certificate bundle for the specified trust store.

#register_targets(params = {}) ⇒ Struct

#remove_listener_certificates(params = {}) ⇒ Struct

Removes the specified certificate from the certificate list for the specified HTTPS or TLS listener.

#remove_tags(params = {}) ⇒ Struct

Removes the specified tags from the specified Elastic Load Balancing resources. You can remove the tags for one or more Application Load Balancers, Network Load Balancers, Gateway Load Balancers, target groups, listeners, or rules.

#remove_trust_store_revocations(params = {}) ⇒ Struct

Removes the specified revocation file from the specified trust store.

#set_ip_address_type(params = {}) ⇒ Types::SetIpAddressTypeOutput

Sets the type of IP addresses used by the subnets of the specified load balancer.

#set_rule_priorities(params = {}) ⇒ Types::SetRulePrioritiesOutput

Sets the priorities of the specified rules.

You can reorder the rules as long as there are no priority conflicts in the new order. Any existing rules that you do not specify retain their current priority.

#set_security_groups(params = {}) ⇒ Types::SetSecurityGroupsOutput

Associates the specified security groups with the specified Application Load Balancer or Network Load Balancer. The specified security groups override the previously associated security groups.

You can't perform this operation on a Network Load Balancer unless you specified a security group for the load balancer when you created it.

You can't associate a security group with a Gateway Load Balancer.

#set_subnets(params = {}) ⇒ Types::SetSubnetsOutput

Enables the Availability Zones for the specified public subnets for the specified Application Load Balancer, Network Load Balancer or Gateway Load Balancer. The specified subnets replace the previously enabled subnets.

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

Polls an API operation until a resource enters a desired state.

Basic Usage

A waiter will call an API operation until:

• It is successful
• It enters a terminal state
• It makes the maximum number of attempts

In between attempts, the waiter will sleep.

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

Configuration

You can configure the maximum number of polling attempts, and the delay (in seconds) between each polling attempt. You can pass configuration as the final arguments hash.

# poll for ~25 seconds
client.wait_until(waiter_name, params, {
  max_attempts: 5,
  delay: 5,
})

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(waiter_name, params, {

  # disable max attempts
  max_attempts: nil,

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

Handling Errors

When a waiter is unsuccessful, it will raise an error. All of the failure errors extend fromWaiters::Errors::WaiterFailed.

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

Valid Waiters

The following table lists the valid waiter names, the operations they call, and the default :delay and :max_attempts values.