Documentation ¶
Overview ¶
Package elasticloadbalancingv2 provides the API client, operations, and parameter types for Elastic Load Balancing.
Elastic Load Balancing A load balancer distributes incoming traffic across targets, such as your EC2 instances. This enables you to increase the availability of your application. The load balancer also monitors the health of its registered targets and ensures that it routes traffic only to healthy targets. You configure your load balancer to accept incoming traffic by specifying one or more listeners, which are configured with a protocol and port number for connections from clients to the load balancer. You configure a target group with a protocol and port number for connections from the load balancer to the targets, and with health check settings to be used when checking the health status of the targets. Elastic Load Balancing supports the following types of load balancers: Application Load Balancers, Network Load Balancers, Gateway Load Balancers, and Classic Load Balancers. This reference covers the following load balancer types:
- Application Load Balancer - Operates at the application layer (layer 7) and supports HTTP and HTTPS.
- Network Load Balancer - Operates at the transport layer (layer 4) and supports TCP, TLS, and UDP.
- Gateway Load Balancer - Operates at the network layer (layer 3).
For more information, see the Elastic Load Balancing User Guide (https://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/) . All Elastic Load Balancing operations are idempotent, which means that they complete at most one time. If you repeat an operation, it succeeds.
Index ¶
- Constants
- func NewDefaultEndpointResolver() *internalendpoints.Resolver
- func WithAPIOptions(optFns ...func(*middleware.Stack) error) func(*Options)
- func WithEndpointResolver(v EndpointResolver) func(*Options)
- type AddListenerCertificatesInput
- type AddListenerCertificatesOutput
- type AddTagsInput
- type AddTagsOutput
- type Client
- func (c *Client) AddListenerCertificates(ctx context.Context, params *AddListenerCertificatesInput, ...) (*AddListenerCertificatesOutput, error)
- func (c *Client) AddTags(ctx context.Context, params *AddTagsInput, optFns ...func(*Options)) (*AddTagsOutput, error)
- func (c *Client) CreateListener(ctx context.Context, params *CreateListenerInput, optFns ...func(*Options)) (*CreateListenerOutput, error)
- func (c *Client) CreateLoadBalancer(ctx context.Context, params *CreateLoadBalancerInput, optFns ...func(*Options)) (*CreateLoadBalancerOutput, error)
- func (c *Client) CreateRule(ctx context.Context, params *CreateRuleInput, optFns ...func(*Options)) (*CreateRuleOutput, error)
- func (c *Client) CreateTargetGroup(ctx context.Context, params *CreateTargetGroupInput, optFns ...func(*Options)) (*CreateTargetGroupOutput, error)
- func (c *Client) DeleteListener(ctx context.Context, params *DeleteListenerInput, optFns ...func(*Options)) (*DeleteListenerOutput, error)
- func (c *Client) DeleteLoadBalancer(ctx context.Context, params *DeleteLoadBalancerInput, optFns ...func(*Options)) (*DeleteLoadBalancerOutput, error)
- func (c *Client) DeleteRule(ctx context.Context, params *DeleteRuleInput, optFns ...func(*Options)) (*DeleteRuleOutput, error)
- func (c *Client) DeleteTargetGroup(ctx context.Context, params *DeleteTargetGroupInput, optFns ...func(*Options)) (*DeleteTargetGroupOutput, error)
- func (c *Client) DeregisterTargets(ctx context.Context, params *DeregisterTargetsInput, optFns ...func(*Options)) (*DeregisterTargetsOutput, error)
- func (c *Client) DescribeAccountLimits(ctx context.Context, params *DescribeAccountLimitsInput, ...) (*DescribeAccountLimitsOutput, error)
- func (c *Client) DescribeListenerCertificates(ctx context.Context, params *DescribeListenerCertificatesInput, ...) (*DescribeListenerCertificatesOutput, error)
- func (c *Client) DescribeListeners(ctx context.Context, params *DescribeListenersInput, optFns ...func(*Options)) (*DescribeListenersOutput, error)
- func (c *Client) DescribeLoadBalancerAttributes(ctx context.Context, params *DescribeLoadBalancerAttributesInput, ...) (*DescribeLoadBalancerAttributesOutput, error)
- func (c *Client) DescribeLoadBalancers(ctx context.Context, params *DescribeLoadBalancersInput, ...) (*DescribeLoadBalancersOutput, error)
- func (c *Client) DescribeRules(ctx context.Context, params *DescribeRulesInput, optFns ...func(*Options)) (*DescribeRulesOutput, error)
- func (c *Client) DescribeSSLPolicies(ctx context.Context, params *DescribeSSLPoliciesInput, ...) (*DescribeSSLPoliciesOutput, error)
- func (c *Client) DescribeTags(ctx context.Context, params *DescribeTagsInput, optFns ...func(*Options)) (*DescribeTagsOutput, error)
- func (c *Client) DescribeTargetGroupAttributes(ctx context.Context, params *DescribeTargetGroupAttributesInput, ...) (*DescribeTargetGroupAttributesOutput, error)
- func (c *Client) DescribeTargetGroups(ctx context.Context, params *DescribeTargetGroupsInput, ...) (*DescribeTargetGroupsOutput, error)
- func (c *Client) DescribeTargetHealth(ctx context.Context, params *DescribeTargetHealthInput, ...) (*DescribeTargetHealthOutput, error)
- func (c *Client) ModifyListener(ctx context.Context, params *ModifyListenerInput, optFns ...func(*Options)) (*ModifyListenerOutput, error)
- func (c *Client) ModifyLoadBalancerAttributes(ctx context.Context, params *ModifyLoadBalancerAttributesInput, ...) (*ModifyLoadBalancerAttributesOutput, error)
- func (c *Client) ModifyRule(ctx context.Context, params *ModifyRuleInput, optFns ...func(*Options)) (*ModifyRuleOutput, error)
- func (c *Client) ModifyTargetGroup(ctx context.Context, params *ModifyTargetGroupInput, optFns ...func(*Options)) (*ModifyTargetGroupOutput, error)
- func (c *Client) ModifyTargetGroupAttributes(ctx context.Context, params *ModifyTargetGroupAttributesInput, ...) (*ModifyTargetGroupAttributesOutput, error)
- func (c *Client) RegisterTargets(ctx context.Context, params *RegisterTargetsInput, optFns ...func(*Options)) (*RegisterTargetsOutput, error)
- func (c *Client) RemoveListenerCertificates(ctx context.Context, params *RemoveListenerCertificatesInput, ...) (*RemoveListenerCertificatesOutput, error)
- func (c *Client) RemoveTags(ctx context.Context, params *RemoveTagsInput, optFns ...func(*Options)) (*RemoveTagsOutput, error)
- func (c *Client) SetIpAddressType(ctx context.Context, params *SetIpAddressTypeInput, optFns ...func(*Options)) (*SetIpAddressTypeOutput, error)
- func (c *Client) SetRulePriorities(ctx context.Context, params *SetRulePrioritiesInput, optFns ...func(*Options)) (*SetRulePrioritiesOutput, error)
- func (c *Client) SetSecurityGroups(ctx context.Context, params *SetSecurityGroupsInput, optFns ...func(*Options)) (*SetSecurityGroupsOutput, error)
- func (c *Client) SetSubnets(ctx context.Context, params *SetSubnetsInput, optFns ...func(*Options)) (*SetSubnetsOutput, error)
- type CreateListenerInput
- type CreateListenerOutput
- type CreateLoadBalancerInput
- type CreateLoadBalancerOutput
- type CreateRuleInput
- type CreateRuleOutput
- type CreateTargetGroupInput
- type CreateTargetGroupOutput
- type DeleteListenerInput
- type DeleteListenerOutput
- type DeleteLoadBalancerInput
- type DeleteLoadBalancerOutput
- type DeleteRuleInput
- type DeleteRuleOutput
- type DeleteTargetGroupInput
- type DeleteTargetGroupOutput
- type DeregisterTargetsInput
- type DeregisterTargetsOutput
- type DescribeAccountLimitsInput
- type DescribeAccountLimitsOutput
- type DescribeListenerCertificatesInput
- type DescribeListenerCertificatesOutput
- type DescribeListenersAPIClient
- type DescribeListenersInput
- type DescribeListenersOutput
- type DescribeListenersPaginator
- type DescribeListenersPaginatorOptions
- type DescribeLoadBalancerAttributesInput
- type DescribeLoadBalancerAttributesOutput
- type DescribeLoadBalancersAPIClient
- type DescribeLoadBalancersInput
- type DescribeLoadBalancersOutput
- type DescribeLoadBalancersPaginator
- type DescribeLoadBalancersPaginatorOptions
- type DescribeRulesInput
- type DescribeRulesOutput
- type DescribeSSLPoliciesInput
- type DescribeSSLPoliciesOutput
- type DescribeTagsInput
- type DescribeTagsOutput
- type DescribeTargetGroupAttributesInput
- type DescribeTargetGroupAttributesOutput
- type DescribeTargetGroupsAPIClient
- type DescribeTargetGroupsInput
- type DescribeTargetGroupsOutput
- type DescribeTargetGroupsPaginator
- type DescribeTargetGroupsPaginatorOptions
- type DescribeTargetHealthAPIClient
- type DescribeTargetHealthInput
- type DescribeTargetHealthOutput
- type EndpointResolver
- type EndpointResolverFunc
- type EndpointResolverOptions
- type HTTPClient
- type HTTPSignerV4
- type LoadBalancerAvailableWaiter
- type LoadBalancerAvailableWaiterOptions
- type LoadBalancerExistsWaiter
- type LoadBalancerExistsWaiterOptions
- type LoadBalancersDeletedWaiter
- type LoadBalancersDeletedWaiterOptions
- type ModifyListenerInput
- type ModifyListenerOutput
- type ModifyLoadBalancerAttributesInput
- type ModifyLoadBalancerAttributesOutput
- type ModifyRuleInput
- type ModifyRuleOutput
- type ModifyTargetGroupAttributesInput
- type ModifyTargetGroupAttributesOutput
- type ModifyTargetGroupInput
- type ModifyTargetGroupOutput
- type Options
- type RegisterTargetsInput
- type RegisterTargetsOutput
- type RemoveListenerCertificatesInput
- type RemoveListenerCertificatesOutput
- type RemoveTagsInput
- type RemoveTagsOutput
- type ResolveEndpoint
- type SetIpAddressTypeInput
- type SetIpAddressTypeOutput
- type SetRulePrioritiesInput
- type SetRulePrioritiesOutput
- type SetSecurityGroupsInput
- type SetSecurityGroupsOutput
- type SetSubnetsInput
- type SetSubnetsOutput
- type TargetDeregisteredWaiter
- type TargetDeregisteredWaiterOptions
- type TargetInServiceWaiter
- type TargetInServiceWaiterOptions
Constants ¶
const ServiceAPIVersion = "2015-12-01"
const ServiceID = "Elastic Load Balancing v2"
Variables ¶
This section is empty.
Functions ¶
func NewDefaultEndpointResolver ¶
func NewDefaultEndpointResolver() *internalendpoints.Resolver
NewDefaultEndpointResolver constructs a new service endpoint resolver
func WithAPIOptions ¶ added in v1.0.0
func WithAPIOptions(optFns ...func(*middleware.Stack) error) func(*Options)
WithAPIOptions returns a functional option for setting the Client's APIOptions option.
func WithEndpointResolver ¶
func WithEndpointResolver(v EndpointResolver) func(*Options)
WithEndpointResolver returns a functional option for setting the Client's EndpointResolver option.
Types ¶
type AddListenerCertificatesInput ¶
type AddListenerCertificatesInput struct { // The certificate to add. You can specify one certificate per call. Set // CertificateArn to the certificate ARN but do not set IsDefault . // // This member is required. Certificates []types.Certificate // The Amazon Resource Name (ARN) of the listener. // // This member is required. ListenerArn *string // contains filtered or unexported fields }
type AddListenerCertificatesOutput ¶
type AddListenerCertificatesOutput struct { // Information about the certificates in the certificate list. Certificates []types.Certificate // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type AddTagsInput ¶
type AddTagsOutput ¶
type AddTagsOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type Client ¶
type Client struct {
// contains filtered or unexported fields
}
Client provides the API client to make operations call for Elastic Load Balancing.
func New ¶
New returns an initialized Client based on the functional options. Provide additional functional options to further configure the behavior of the client, such as changing the client's endpoint or adding custom middleware behavior.
func NewFromConfig ¶
NewFromConfig returns a new client from the provided config.
func (*Client) AddListenerCertificates ¶
func (c *Client) AddListenerCertificates(ctx context.Context, params *AddListenerCertificatesInput, optFns ...func(*Options)) (*AddListenerCertificatesOutput, error)
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 HTTPS listeners (https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-https-listener.html) in the Application Load Balancers Guide or TLS listeners (https://docs.aws.amazon.com/elasticloadbalancing/latest/network/create-tls-listener.html) in the Network Load Balancers Guide.
func (*Client) AddTags ¶
func (c *Client) AddTags(ctx context.Context, params *AddTagsInput, optFns ...func(*Options)) (*AddTagsOutput, error)
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, 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.
func (*Client) CreateListener ¶
func (c *Client) CreateListener(ctx context.Context, params *CreateListenerInput, optFns ...func(*Options)) (*CreateListenerOutput, error)
Creates a listener for the specified Application Load Balancer, Network Load Balancer, or Gateway Load Balancer. For more information, see the following:
- Listeners for your Application Load Balancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-listeners.html)
- Listeners for your Network Load Balancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-listeners.html)
- Listeners for your Gateway Load Balancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/gateway-listeners.html)
This operation is idempotent, which means that it completes at most one time. If you attempt to create multiple listeners with the same settings, each call succeeds.
func (*Client) CreateLoadBalancer ¶
func (c *Client) CreateLoadBalancer(ctx context.Context, params *CreateLoadBalancerInput, optFns ...func(*Options)) (*CreateLoadBalancerOutput, error)
Creates an Application Load Balancer, Network Load Balancer, or Gateway Load Balancer. For more information, see the following:
- Application Load Balancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/application/application-load-balancers.html)
- Network Load Balancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancers.html)
- Gateway Load Balancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/gateway-load-balancers.html)
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.
func (*Client) CreateRule ¶
func (c *Client) CreateRule(ctx context.Context, params *CreateRuleInput, optFns ...func(*Options)) (*CreateRuleOutput, error)
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, and one or more conditions. 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 (https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-listeners.html#listener-rules) in the Application Load Balancers Guide.
func (*Client) CreateTargetGroup ¶
func (c *Client) CreateTargetGroup(ctx context.Context, params *CreateTargetGroupInput, optFns ...func(*Options)) (*CreateTargetGroupOutput, error)
Creates a target group. For more information, see the following:
- Target groups for your Application Load Balancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html)
- Target groups for your Network Load Balancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-target-groups.html)
- Target groups for your Gateway Load Balancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/target-groups.html)
This operation is idempotent, which means that it completes at most one time. If you attempt to create multiple target groups with the same settings, each call succeeds.
func (*Client) DeleteListener ¶
func (c *Client) DeleteListener(ctx context.Context, params *DeleteListenerInput, optFns ...func(*Options)) (*DeleteListenerOutput, error)
Deletes the specified listener. Alternatively, your listener is deleted when you delete the load balancer to which it is attached.
func (*Client) DeleteLoadBalancer ¶
func (c *Client) DeleteLoadBalancer(ctx context.Context, params *DeleteLoadBalancerInput, optFns ...func(*Options)) (*DeleteLoadBalancerOutput, error)
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.
func (*Client) DeleteRule ¶
func (c *Client) DeleteRule(ctx context.Context, params *DeleteRuleInput, optFns ...func(*Options)) (*DeleteRuleOutput, error)
Deletes the specified rule. You can't delete the default rule.
func (*Client) DeleteTargetGroup ¶
func (c *Client) DeleteTargetGroup(ctx context.Context, params *DeleteTargetGroupInput, optFns ...func(*Options)) (*DeleteTargetGroupOutput, error)
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.
func (*Client) DeregisterTargets ¶
func (c *Client) DeregisterTargets(ctx context.Context, params *DeregisterTargetsInput, optFns ...func(*Options)) (*DeregisterTargetsOutput, error)
Deregisters the specified targets from the specified target group. After the targets are deregistered, they no longer receive traffic from the load balancer.
func (*Client) DescribeAccountLimits ¶
func (c *Client) DescribeAccountLimits(ctx context.Context, params *DescribeAccountLimitsInput, optFns ...func(*Options)) (*DescribeAccountLimitsOutput, error)
Describes the current Elastic Load Balancing resource limits for your Amazon Web Services account. For more information, see the following:
- Quotas for your Application Load Balancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-limits.html)
- Quotas for your Network Load Balancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-limits.html)
- Quotas for your Gateway Load Balancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/quotas-limits.html)
func (*Client) DescribeListenerCertificates ¶
func (c *Client) DescribeListenerCertificates(ctx context.Context, params *DescribeListenerCertificatesInput, optFns ...func(*Options)) (*DescribeListenerCertificatesOutput, error)
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 with IsDefault set to false). For more information, see SSL certificates (https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-https-listener.html#https-listener-certificates) in the Application Load Balancers Guide or Server certificates (https://docs.aws.amazon.com/elasticloadbalancing/latest/network/create-tls-listener.html#tls-listener-certificate) in the Network Load Balancers Guide.
func (*Client) DescribeListeners ¶
func (c *Client) DescribeListeners(ctx context.Context, params *DescribeListenersInput, optFns ...func(*Options)) (*DescribeListenersOutput, error)
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.
func (*Client) DescribeLoadBalancerAttributes ¶
func (c *Client) DescribeLoadBalancerAttributes(ctx context.Context, params *DescribeLoadBalancerAttributesInput, optFns ...func(*Options)) (*DescribeLoadBalancerAttributesOutput, error)
Describes the attributes for the specified Application Load Balancer, Network Load Balancer, or Gateway Load Balancer. For more information, see the following:
- Load balancer attributes (https://docs.aws.amazon.com/elasticloadbalancing/latest/application/application-load-balancers.html#load-balancer-attributes) in the Application Load Balancers Guide
- Load balancer attributes (https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancers.html#load-balancer-attributes) in the Network Load Balancers Guide
- Load balancer attributes (https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/gateway-load-balancers.html#load-balancer-attributes) in the Gateway Load Balancers Guide
func (*Client) DescribeLoadBalancers ¶
func (c *Client) DescribeLoadBalancers(ctx context.Context, params *DescribeLoadBalancersInput, optFns ...func(*Options)) (*DescribeLoadBalancersOutput, error)
Describes the specified load balancers or all of your load balancers.
func (*Client) DescribeRules ¶
func (c *Client) DescribeRules(ctx context.Context, params *DescribeRulesInput, optFns ...func(*Options)) (*DescribeRulesOutput, error)
Describes the specified rules or the rules for the specified listener. You must specify either a listener or one or more rules.
func (*Client) DescribeSSLPolicies ¶
func (c *Client) DescribeSSLPolicies(ctx context.Context, params *DescribeSSLPoliciesInput, optFns ...func(*Options)) (*DescribeSSLPoliciesOutput, error)
Describes the specified policies or all policies used for SSL negotiation. For more information, see Security policies (https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-https-listener.html#describe-ssl-policies) in the Application Load Balancers Guide or Security policies (https://docs.aws.amazon.com/elasticloadbalancing/latest/network/create-tls-listener.html#describe-ssl-policies) in the Network Load Balancers Guide.
func (*Client) DescribeTags ¶
func (c *Client) DescribeTags(ctx context.Context, params *DescribeTagsInput, optFns ...func(*Options)) (*DescribeTagsOutput, error)
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.
func (*Client) DescribeTargetGroupAttributes ¶
func (c *Client) DescribeTargetGroupAttributes(ctx context.Context, params *DescribeTargetGroupAttributesInput, optFns ...func(*Options)) (*DescribeTargetGroupAttributesOutput, error)
Describes the attributes for the specified target group. For more information, see the following:
- Target group attributes (https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html#target-group-attributes) in the Application Load Balancers Guide
- Target group attributes (https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-target-groups.html#target-group-attributes) in the Network Load Balancers Guide
- Target group attributes (https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/target-groups.html#target-group-attributes) in the Gateway Load Balancers Guide
func (*Client) DescribeTargetGroups ¶
func (c *Client) DescribeTargetGroups(ctx context.Context, params *DescribeTargetGroupsInput, optFns ...func(*Options)) (*DescribeTargetGroupsOutput, error)
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.
func (*Client) DescribeTargetHealth ¶
func (c *Client) DescribeTargetHealth(ctx context.Context, params *DescribeTargetHealthInput, optFns ...func(*Options)) (*DescribeTargetHealthOutput, error)
Describes the health of the specified targets or all of your targets.
func (*Client) ModifyListener ¶
func (c *Client) ModifyListener(ctx context.Context, params *ModifyListenerInput, optFns ...func(*Options)) (*ModifyListenerOutput, error)
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.
func (*Client) ModifyLoadBalancerAttributes ¶
func (c *Client) ModifyLoadBalancerAttributes(ctx context.Context, params *ModifyLoadBalancerAttributesInput, optFns ...func(*Options)) (*ModifyLoadBalancerAttributesOutput, error)
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.
func (*Client) ModifyRule ¶
func (c *Client) ModifyRule(ctx context.Context, params *ModifyRuleInput, optFns ...func(*Options)) (*ModifyRuleOutput, error)
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.
func (*Client) ModifyTargetGroup ¶
func (c *Client) ModifyTargetGroup(ctx context.Context, params *ModifyTargetGroupInput, optFns ...func(*Options)) (*ModifyTargetGroupOutput, error)
Modifies the health checks used when evaluating the health state of the targets in the specified target group.
func (*Client) ModifyTargetGroupAttributes ¶
func (c *Client) ModifyTargetGroupAttributes(ctx context.Context, params *ModifyTargetGroupAttributesInput, optFns ...func(*Options)) (*ModifyTargetGroupAttributesOutput, error)
Modifies the specified attributes of the specified target group.
func (*Client) RegisterTargets ¶
func (c *Client) RegisterTargets(ctx context.Context, params *RegisterTargetsInput, optFns ...func(*Options)) (*RegisterTargetsOutput, error)
Registers the specified targets with the specified target group. If the target is an EC2 instance, it must be in the running state when you register it. By default, the load balancer routes requests to registered targets using the protocol and port for the target group. Alternatively, you can override the port for a target when you register it. You can register each EC2 instance or IP address with the same target group multiple times using different ports. With a Network Load Balancer, you cannot register instances by instance ID if they have the following instance types: C1, CC1, CC2, CG1, CG2, CR1, CS1, G1, G2, HI1, HS1, M1, M2, M3, and T1. You can register instances of these types by IP address.
func (*Client) RemoveListenerCertificates ¶
func (c *Client) RemoveListenerCertificates(ctx context.Context, params *RemoveListenerCertificatesInput, optFns ...func(*Options)) (*RemoveListenerCertificatesOutput, error)
Removes the specified certificate from the certificate list for the specified HTTPS or TLS listener.
func (*Client) RemoveTags ¶
func (c *Client) RemoveTags(ctx context.Context, params *RemoveTagsInput, optFns ...func(*Options)) (*RemoveTagsOutput, error)
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.
func (*Client) SetIpAddressType ¶
func (c *Client) SetIpAddressType(ctx context.Context, params *SetIpAddressTypeInput, optFns ...func(*Options)) (*SetIpAddressTypeOutput, error)
Sets the type of IP addresses used by the subnets of the specified load balancer.
func (*Client) SetRulePriorities ¶
func (c *Client) SetRulePriorities(ctx context.Context, params *SetRulePrioritiesInput, optFns ...func(*Options)) (*SetRulePrioritiesOutput, error)
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.
func (*Client) SetSecurityGroups ¶
func (c *Client) SetSecurityGroups(ctx context.Context, params *SetSecurityGroupsInput, optFns ...func(*Options)) (*SetSecurityGroupsOutput, error)
Associates the specified security groups with the specified Application Load Balancer. The specified security groups override the previously associated security groups. You can't specify a security group for a Network Load Balancer or Gateway Load Balancer.
func (*Client) SetSubnets ¶
func (c *Client) SetSubnets(ctx context.Context, params *SetSubnetsInput, optFns ...func(*Options)) (*SetSubnetsOutput, error)
Enables the Availability Zones for the specified public subnets for the specified Application Load Balancer or Network Load Balancer. The specified subnets replace the previously enabled subnets. When you specify subnets for a Network Load Balancer, you must include all subnets that were enabled previously, with their existing configurations, plus any additional subnets.
type CreateListenerInput ¶
type CreateListenerInput struct { // The actions for the default rule. // // This member is required. DefaultActions []types.Action // The Amazon Resource Name (ARN) of the load balancer. // // This member is required. LoadBalancerArn *string // [TLS listeners] The name of the Application-Layer Protocol Negotiation (ALPN) // policy. You can specify one policy name. The following are the possible values: // - HTTP1Only // - HTTP2Only // - HTTP2Optional // - HTTP2Preferred // - None // For more information, see ALPN policies (https://docs.aws.amazon.com/elasticloadbalancing/latest/network/create-tls-listener.html#alpn-policies) // in the Network Load Balancers Guide. AlpnPolicy []string // [HTTPS and TLS listeners] The default certificate for the listener. You must // provide exactly one certificate. Set CertificateArn to the certificate ARN but // do not set IsDefault . Certificates []types.Certificate // The port on which the load balancer is listening. You cannot specify a port for // a Gateway Load Balancer. Port *int32 // The protocol for connections from clients to the load balancer. For Application // Load Balancers, the supported protocols are HTTP and HTTPS. For Network Load // Balancers, the supported protocols are TCP, TLS, UDP, and TCP_UDP. You can’t // specify the UDP or TCP_UDP protocol if dual-stack mode is enabled. You cannot // specify a protocol for a Gateway Load Balancer. Protocol types.ProtocolEnum // [HTTPS and TLS listeners] The security policy that defines which protocols and // ciphers are supported. For more information, see Security policies (https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-https-listener.html#describe-ssl-policies) // in the Application Load Balancers Guide and Security policies (https://docs.aws.amazon.com/elasticloadbalancing/latest/network/create-tls-listener.html#describe-ssl-policies) // in the Network Load Balancers Guide. SslPolicy *string // The tags to assign to the listener. Tags []types.Tag // contains filtered or unexported fields }
type CreateListenerOutput ¶
type CreateListenerOutput struct { // Information about the listener. Listeners []types.Listener // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type CreateLoadBalancerInput ¶
type CreateLoadBalancerInput struct { // The name of the load balancer. This name must be unique per region per account, // can have a maximum of 32 characters, must contain only alphanumeric characters // or hyphens, must not begin or end with a hyphen, and must not begin with // "internal-". // // This member is required. Name *string // [Application Load Balancers on Outposts] The ID of the customer-owned address // pool (CoIP pool). CustomerOwnedIpv4Pool *string // The type of IP addresses used by the subnets for your load balancer. The // possible values are ipv4 (for IPv4 addresses) and dualstack (for IPv4 and IPv6 // addresses). IpAddressType types.IpAddressType // The nodes of an Internet-facing load balancer have public IP addresses. The DNS // name of an Internet-facing load balancer is publicly resolvable to the public IP // addresses of the nodes. Therefore, Internet-facing load balancers can route // requests from clients over the internet. The nodes of an internal load balancer // have only private IP addresses. The DNS name of an internal load balancer is // publicly resolvable to the private IP addresses of the nodes. Therefore, // internal load balancers can route requests only from clients with access to the // VPC for the load balancer. The default is an Internet-facing load balancer. You // cannot specify a scheme for a Gateway Load Balancer. Scheme types.LoadBalancerSchemeEnum // [Application Load Balancers] The IDs of the security groups for the load // balancer. SecurityGroups []string // The IDs of the public subnets. You can specify only one subnet per Availability // Zone. You must specify either subnets or subnet mappings, but not both. // [Application Load Balancers] You must specify subnets from at least two // Availability Zones. You cannot specify Elastic IP addresses for your subnets. // [Application Load Balancers on Outposts] You must specify one Outpost subnet. // [Application Load Balancers on Local Zones] You can specify subnets from one or // more Local Zones. [Network Load Balancers] You can specify subnets from one or // more Availability Zones. You can specify one Elastic IP address per subnet if // you need static IP addresses for your internet-facing load balancer. For // internal load balancers, you can specify one private IP address per subnet from // the IPv4 range of the subnet. For internet-facing load balancer, you can specify // one IPv6 address per subnet. [Gateway Load Balancers] You can specify subnets // from one or more Availability Zones. You cannot specify Elastic IP addresses for // your subnets. SubnetMappings []types.SubnetMapping // The IDs of the public subnets. You can specify only one subnet per Availability // Zone. You must specify either subnets or subnet mappings, but not both. To // specify an Elastic IP address, specify subnet mappings instead of subnets. // [Application Load Balancers] You must specify subnets from at least two // Availability Zones. [Application Load Balancers on Outposts] You must specify // one Outpost subnet. [Application Load Balancers on Local Zones] You can specify // subnets from one or more Local Zones. [Network Load Balancers] You can specify // subnets from one or more Availability Zones. [Gateway Load Balancers] You can // specify subnets from one or more Availability Zones. Subnets []string // The tags to assign to the load balancer. Tags []types.Tag // The type of load balancer. The default is application . Type types.LoadBalancerTypeEnum // contains filtered or unexported fields }
type CreateLoadBalancerOutput ¶
type CreateLoadBalancerOutput struct { // Information about the load balancer. LoadBalancers []types.LoadBalancer // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type CreateRuleInput ¶
type CreateRuleInput struct { // The actions. // // This member is required. Actions []types.Action // The conditions. // // This member is required. Conditions []types.RuleCondition // The Amazon Resource Name (ARN) of the listener. // // This member is required. ListenerArn *string // The rule priority. A listener can't have multiple rules with the same priority. // // This member is required. Priority *int32 // The tags to assign to the rule. Tags []types.Tag // contains filtered or unexported fields }
type CreateRuleOutput ¶
type CreateRuleOutput struct { // Information about the rule. Rules []types.Rule // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type CreateTargetGroupInput ¶
type CreateTargetGroupInput struct { // The name of the target group. This name must be unique per region per account, // can have a maximum of 32 characters, must contain only alphanumeric characters // or hyphens, and must not begin or end with a hyphen. // // This member is required. Name *string // Indicates whether health checks are enabled. If the target type is lambda , // health checks are disabled by default but can be enabled. If the target type is // instance , ip , or alb , health checks are always enabled and cannot be disabled. HealthCheckEnabled *bool // The approximate amount of time, in seconds, between health checks of an // individual target. The range is 5-300. If the target group protocol is TCP, TLS, // UDP, TCP_UDP, HTTP or HTTPS, the default is 30 seconds. If the target group // protocol is GENEVE, the default is 10 seconds. If the target type is lambda , // the default is 35 seconds. HealthCheckIntervalSeconds *int32 // [HTTP/HTTPS health checks] The destination for health checks on the targets. // [HTTP1 or HTTP2 protocol version] The ping path. The default is /. [GRPC // protocol version] The path of a custom health check method with the format // /package.service/method. The default is /Amazon Web Services.ALB/healthcheck. HealthCheckPath *string // The port the load balancer uses when performing health checks on targets. If // the protocol is HTTP, HTTPS, TCP, TLS, UDP, or TCP_UDP, the default is // traffic-port , which is the port on which each target receives traffic from the // load balancer. If the protocol is GENEVE, the default is port 80. HealthCheckPort *string // The protocol the load balancer uses when performing health checks on targets. // For Application Load Balancers, the default is HTTP. For Network Load Balancers // and Gateway Load Balancers, the default is TCP. The TCP protocol is not // supported for health checks if the protocol of the target group is HTTP or // HTTPS. The GENEVE, TLS, UDP, and TCP_UDP protocols are not supported for health // checks. HealthCheckProtocol types.ProtocolEnum // The amount of time, in seconds, during which no response from a target means a // failed health check. The range is 2–120 seconds. For target groups with a // protocol of HTTP, the default is 6 seconds. For target groups with a protocol of // TCP, TLS or HTTPS, the default is 10 seconds. For target groups with a protocol // of GENEVE, the default is 5 seconds. If the target type is lambda , the default // is 30 seconds. HealthCheckTimeoutSeconds *int32 // The number of consecutive health check successes required before considering a // target healthy. The range is 2-10. If the target group protocol is TCP, TCP_UDP, // UDP, TLS, HTTP or HTTPS, the default is 5. For target groups with a protocol of // GENEVE, the default is 5. If the target type is lambda , the default is 5. HealthyThresholdCount *int32 // The type of IP address used for this target group. The possible values are ipv4 // and ipv6 . This is an optional parameter. If not specified, the IP address type // defaults to ipv4 . IpAddressType types.TargetGroupIpAddressTypeEnum // [HTTP/HTTPS health checks] The HTTP or gRPC codes to use when checking for a // successful response from a target. For target groups with a protocol of TCP, // TCP_UDP, UDP or TLS the range is 200-599. For target groups with a protocol of // HTTP or HTTPS, the range is 200-499. For target groups with a protocol of // GENEVE, the range is 200-399. Matcher *types.Matcher // The port on which the targets receive traffic. This port is used unless you // specify a port override when registering the target. If the target is a Lambda // function, this parameter does not apply. If the protocol is GENEVE, the // supported port is 6081. Port *int32 // The protocol to use for routing traffic to the targets. For Application Load // Balancers, the supported protocols are HTTP and HTTPS. For Network Load // Balancers, the supported protocols are TCP, TLS, UDP, or TCP_UDP. For Gateway // Load Balancers, the supported protocol is GENEVE. A TCP_UDP listener must be // associated with a TCP_UDP target group. If the target is a Lambda function, this // parameter does not apply. Protocol types.ProtocolEnum // [HTTP/HTTPS protocol] The protocol version. Specify GRPC to send requests to // targets using gRPC. Specify HTTP2 to send requests to targets using HTTP/2. The // default is HTTP1 , which sends requests to targets using HTTP/1.1. ProtocolVersion *string // The tags to assign to the target group. Tags []types.Tag // The type of target that you must specify when registering targets with this // target group. You can't specify targets for a target group using more than one // target type. // - instance - Register targets by instance ID. This is the default value. // - ip - Register targets by IP address. You can specify IP addresses from the // subnets of the virtual private cloud (VPC) for the target group, the RFC 1918 // range (10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16), and the RFC 6598 range // (100.64.0.0/10). You can't specify publicly routable IP addresses. // - lambda - Register a single Lambda function as a target. // - alb - Register a single Application Load Balancer as a target. TargetType types.TargetTypeEnum // The number of consecutive health check failures required before considering a // target unhealthy. The range is 2-10. If the target group protocol is TCP, // TCP_UDP, UDP, TLS, HTTP or HTTPS, the default is 2. For target groups with a // protocol of GENEVE, the default is 2. If the target type is lambda , the default // is 5. UnhealthyThresholdCount *int32 // The identifier of the virtual private cloud (VPC). If the target is a Lambda // function, this parameter does not apply. Otherwise, this parameter is required. VpcId *string // contains filtered or unexported fields }
type CreateTargetGroupOutput ¶
type CreateTargetGroupOutput struct { // Information about the target group. TargetGroups []types.TargetGroup // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DeleteListenerInput ¶
type DeleteListenerInput struct { // The Amazon Resource Name (ARN) of the listener. // // This member is required. ListenerArn *string // contains filtered or unexported fields }
type DeleteListenerOutput ¶
type DeleteListenerOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DeleteLoadBalancerInput ¶
type DeleteLoadBalancerInput struct { // The Amazon Resource Name (ARN) of the load balancer. // // This member is required. LoadBalancerArn *string // contains filtered or unexported fields }
type DeleteLoadBalancerOutput ¶
type DeleteLoadBalancerOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DeleteRuleInput ¶
type DeleteRuleInput struct { // The Amazon Resource Name (ARN) of the rule. // // This member is required. RuleArn *string // contains filtered or unexported fields }
type DeleteRuleOutput ¶
type DeleteRuleOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DeleteTargetGroupInput ¶
type DeleteTargetGroupInput struct { // The Amazon Resource Name (ARN) of the target group. // // This member is required. TargetGroupArn *string // contains filtered or unexported fields }
type DeleteTargetGroupOutput ¶
type DeleteTargetGroupOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DeregisterTargetsInput ¶
type DeregisterTargetsInput struct { // The Amazon Resource Name (ARN) of the target group. // // This member is required. TargetGroupArn *string // The targets. If you specified a port override when you registered a target, you // must specify both the target ID and the port when you deregister it. // // This member is required. Targets []types.TargetDescription // contains filtered or unexported fields }
type DeregisterTargetsOutput ¶
type DeregisterTargetsOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DescribeAccountLimitsOutput ¶
type DescribeAccountLimitsOutput struct { // Information about the limits. Limits []types.Limit // If there are additional results, this is the marker for the next set of // results. Otherwise, this is null. NextMarker *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DescribeListenerCertificatesInput ¶
type DescribeListenerCertificatesInput struct { // The Amazon Resource Names (ARN) of the listener. // // This member is required. ListenerArn *string // The marker for the next set of results. (You received this marker from a // previous call.) Marker *string // The maximum number of results to return with this call. PageSize *int32 // contains filtered or unexported fields }
type DescribeListenerCertificatesOutput ¶
type DescribeListenerCertificatesOutput struct { // Information about the certificates. Certificates []types.Certificate // If there are additional results, this is the marker for the next set of // results. Otherwise, this is null. NextMarker *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DescribeListenersAPIClient ¶ added in v0.30.0
type DescribeListenersAPIClient interface {
DescribeListeners(context.Context, *DescribeListenersInput, ...func(*Options)) (*DescribeListenersOutput, error)
}
DescribeListenersAPIClient is a client that implements the DescribeListeners operation.
type DescribeListenersInput ¶
type DescribeListenersInput struct { // The Amazon Resource Names (ARN) of the listeners. ListenerArns []string // The Amazon Resource Name (ARN) of the load balancer. LoadBalancerArn *string // The marker for the next set of results. (You received this marker from a // previous call.) Marker *string // The maximum number of results to return with this call. PageSize *int32 // contains filtered or unexported fields }
type DescribeListenersOutput ¶
type DescribeListenersOutput struct { // Information about the listeners. Listeners []types.Listener // If there are additional results, this is the marker for the next set of // results. Otherwise, this is null. NextMarker *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DescribeListenersPaginator ¶ added in v0.30.0
type DescribeListenersPaginator struct {
// contains filtered or unexported fields
}
DescribeListenersPaginator is a paginator for DescribeListeners
func NewDescribeListenersPaginator ¶ added in v0.30.0
func NewDescribeListenersPaginator(client DescribeListenersAPIClient, params *DescribeListenersInput, optFns ...func(*DescribeListenersPaginatorOptions)) *DescribeListenersPaginator
NewDescribeListenersPaginator returns a new DescribeListenersPaginator
func (*DescribeListenersPaginator) HasMorePages ¶ added in v0.30.0
func (p *DescribeListenersPaginator) HasMorePages() bool
HasMorePages returns a boolean indicating whether more pages are available
func (*DescribeListenersPaginator) NextPage ¶ added in v0.30.0
func (p *DescribeListenersPaginator) NextPage(ctx context.Context, optFns ...func(*Options)) (*DescribeListenersOutput, error)
NextPage retrieves the next DescribeListeners page.
type DescribeListenersPaginatorOptions ¶ added in v0.30.0
type DescribeListenersPaginatorOptions struct { // Set to true if pagination should stop if the service returns a pagination token // that matches the most recent token provided to the service. StopOnDuplicateToken bool }
DescribeListenersPaginatorOptions is the paginator options for DescribeListeners
type DescribeLoadBalancerAttributesInput ¶
type DescribeLoadBalancerAttributesInput struct { // The Amazon Resource Name (ARN) of the load balancer. // // This member is required. LoadBalancerArn *string // contains filtered or unexported fields }
type DescribeLoadBalancerAttributesOutput ¶
type DescribeLoadBalancerAttributesOutput struct { // Information about the load balancer attributes. Attributes []types.LoadBalancerAttribute // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DescribeLoadBalancersAPIClient ¶ added in v0.30.0
type DescribeLoadBalancersAPIClient interface {
DescribeLoadBalancers(context.Context, *DescribeLoadBalancersInput, ...func(*Options)) (*DescribeLoadBalancersOutput, error)
}
DescribeLoadBalancersAPIClient is a client that implements the DescribeLoadBalancers operation.
type DescribeLoadBalancersInput ¶
type DescribeLoadBalancersInput struct { // The Amazon Resource Names (ARN) of the load balancers. You can specify up to 20 // load balancers in a single call. LoadBalancerArns []string // The marker for the next set of results. (You received this marker from a // previous call.) Marker *string // The names of the load balancers. Names []string // The maximum number of results to return with this call. PageSize *int32 // contains filtered or unexported fields }
type DescribeLoadBalancersOutput ¶
type DescribeLoadBalancersOutput struct { // Information about the load balancers. LoadBalancers []types.LoadBalancer // If there are additional results, this is the marker for the next set of // results. Otherwise, this is null. NextMarker *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DescribeLoadBalancersPaginator ¶ added in v0.30.0
type DescribeLoadBalancersPaginator struct {
// contains filtered or unexported fields
}
DescribeLoadBalancersPaginator is a paginator for DescribeLoadBalancers
func NewDescribeLoadBalancersPaginator ¶ added in v0.30.0
func NewDescribeLoadBalancersPaginator(client DescribeLoadBalancersAPIClient, params *DescribeLoadBalancersInput, optFns ...func(*DescribeLoadBalancersPaginatorOptions)) *DescribeLoadBalancersPaginator
NewDescribeLoadBalancersPaginator returns a new DescribeLoadBalancersPaginator
func (*DescribeLoadBalancersPaginator) HasMorePages ¶ added in v0.30.0
func (p *DescribeLoadBalancersPaginator) HasMorePages() bool
HasMorePages returns a boolean indicating whether more pages are available
func (*DescribeLoadBalancersPaginator) NextPage ¶ added in v0.30.0
func (p *DescribeLoadBalancersPaginator) NextPage(ctx context.Context, optFns ...func(*Options)) (*DescribeLoadBalancersOutput, error)
NextPage retrieves the next DescribeLoadBalancers page.
type DescribeLoadBalancersPaginatorOptions ¶ added in v0.30.0
type DescribeLoadBalancersPaginatorOptions struct { // Set to true if pagination should stop if the service returns a pagination token // that matches the most recent token provided to the service. StopOnDuplicateToken bool }
DescribeLoadBalancersPaginatorOptions is the paginator options for DescribeLoadBalancers
type DescribeRulesInput ¶
type DescribeRulesInput struct { // The Amazon Resource Name (ARN) of the listener. ListenerArn *string // The marker for the next set of results. (You received this marker from a // previous call.) Marker *string // The maximum number of results to return with this call. PageSize *int32 // The Amazon Resource Names (ARN) of the rules. RuleArns []string // contains filtered or unexported fields }
type DescribeRulesOutput ¶
type DescribeRulesOutput struct { // If there are additional results, this is the marker for the next set of // results. Otherwise, this is null. NextMarker *string // Information about the rules. Rules []types.Rule // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DescribeSSLPoliciesInput ¶
type DescribeSSLPoliciesInput struct { // The type of load balancer. The default lists the SSL policies for all load // balancers. LoadBalancerType types.LoadBalancerTypeEnum // The marker for the next set of results. (You received this marker from a // previous call.) Marker *string // The names of the policies. Names []string // The maximum number of results to return with this call. PageSize *int32 // contains filtered or unexported fields }
type DescribeSSLPoliciesOutput ¶
type DescribeSSLPoliciesOutput struct { // If there are additional results, this is the marker for the next set of // results. Otherwise, this is null. NextMarker *string // Information about the security policies. SslPolicies []types.SslPolicy // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DescribeTagsInput ¶
type DescribeTagsInput struct { // The Amazon Resource Names (ARN) of the resources. You can specify up to 20 // resources in a single call. // // This member is required. ResourceArns []string // contains filtered or unexported fields }
type DescribeTagsOutput ¶
type DescribeTagsOutput struct { // Information about the tags. TagDescriptions []types.TagDescription // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DescribeTargetGroupAttributesInput ¶
type DescribeTargetGroupAttributesInput struct { // The Amazon Resource Name (ARN) of the target group. // // This member is required. TargetGroupArn *string // contains filtered or unexported fields }
type DescribeTargetGroupAttributesOutput ¶
type DescribeTargetGroupAttributesOutput struct { // Information about the target group attributes Attributes []types.TargetGroupAttribute // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DescribeTargetGroupsAPIClient ¶ added in v0.30.0
type DescribeTargetGroupsAPIClient interface {
DescribeTargetGroups(context.Context, *DescribeTargetGroupsInput, ...func(*Options)) (*DescribeTargetGroupsOutput, error)
}
DescribeTargetGroupsAPIClient is a client that implements the DescribeTargetGroups operation.
type DescribeTargetGroupsInput ¶
type DescribeTargetGroupsInput struct { // The Amazon Resource Name (ARN) of the load balancer. LoadBalancerArn *string // The marker for the next set of results. (You received this marker from a // previous call.) Marker *string // The names of the target groups. Names []string // The maximum number of results to return with this call. PageSize *int32 // The Amazon Resource Names (ARN) of the target groups. TargetGroupArns []string // contains filtered or unexported fields }
type DescribeTargetGroupsOutput ¶
type DescribeTargetGroupsOutput struct { // If there are additional results, this is the marker for the next set of // results. Otherwise, this is null. NextMarker *string // Information about the target groups. TargetGroups []types.TargetGroup // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type DescribeTargetGroupsPaginator ¶ added in v0.30.0
type DescribeTargetGroupsPaginator struct {
// contains filtered or unexported fields
}
DescribeTargetGroupsPaginator is a paginator for DescribeTargetGroups
func NewDescribeTargetGroupsPaginator ¶ added in v0.30.0
func NewDescribeTargetGroupsPaginator(client DescribeTargetGroupsAPIClient, params *DescribeTargetGroupsInput, optFns ...func(*DescribeTargetGroupsPaginatorOptions)) *DescribeTargetGroupsPaginator
NewDescribeTargetGroupsPaginator returns a new DescribeTargetGroupsPaginator
func (*DescribeTargetGroupsPaginator) HasMorePages ¶ added in v0.30.0
func (p *DescribeTargetGroupsPaginator) HasMorePages() bool
HasMorePages returns a boolean indicating whether more pages are available
func (*DescribeTargetGroupsPaginator) NextPage ¶ added in v0.30.0
func (p *DescribeTargetGroupsPaginator) NextPage(ctx context.Context, optFns ...func(*Options)) (*DescribeTargetGroupsOutput, error)
NextPage retrieves the next DescribeTargetGroups page.
type DescribeTargetGroupsPaginatorOptions ¶ added in v0.30.0
type DescribeTargetGroupsPaginatorOptions struct { // Set to true if pagination should stop if the service returns a pagination token // that matches the most recent token provided to the service. StopOnDuplicateToken bool }
DescribeTargetGroupsPaginatorOptions is the paginator options for DescribeTargetGroups
type DescribeTargetHealthAPIClient ¶ added in v1.6.0
type DescribeTargetHealthAPIClient interface {
DescribeTargetHealth(context.Context, *DescribeTargetHealthInput, ...func(*Options)) (*DescribeTargetHealthOutput, error)
}
DescribeTargetHealthAPIClient is a client that implements the DescribeTargetHealth operation.
type DescribeTargetHealthInput ¶
type DescribeTargetHealthInput struct { // The Amazon Resource Name (ARN) of the target group. // // This member is required. TargetGroupArn *string // The targets. Targets []types.TargetDescription // contains filtered or unexported fields }
type DescribeTargetHealthOutput ¶
type DescribeTargetHealthOutput struct { // Information about the health of the targets. TargetHealthDescriptions []types.TargetHealthDescription // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type EndpointResolver ¶
type EndpointResolver interface {
ResolveEndpoint(region string, options EndpointResolverOptions) (aws.Endpoint, error)
}
EndpointResolver interface for resolving service endpoints.
func EndpointResolverFromURL ¶ added in v1.1.0
func EndpointResolverFromURL(url string, optFns ...func(*aws.Endpoint)) EndpointResolver
EndpointResolverFromURL returns an EndpointResolver configured using the provided endpoint url. By default, the resolved endpoint resolver uses the client region as signing region, and the endpoint source is set to EndpointSourceCustom.You can provide functional options to configure endpoint values for the resolved endpoint.
type EndpointResolverFunc ¶
type EndpointResolverFunc func(region string, options EndpointResolverOptions) (aws.Endpoint, error)
EndpointResolverFunc is a helper utility that wraps a function so it satisfies the EndpointResolver interface. This is useful when you want to add additional endpoint resolving logic, or stub out specific endpoints with custom values.
func (EndpointResolverFunc) ResolveEndpoint ¶
func (fn EndpointResolverFunc) ResolveEndpoint(region string, options EndpointResolverOptions) (endpoint aws.Endpoint, err error)
type EndpointResolverOptions ¶ added in v0.29.0
type EndpointResolverOptions = internalendpoints.Options
EndpointResolverOptions is the service endpoint resolver options
type HTTPSignerV4 ¶
type LoadBalancerAvailableWaiter ¶ added in v1.6.0
type LoadBalancerAvailableWaiter struct {
// contains filtered or unexported fields
}
LoadBalancerAvailableWaiter defines the waiters for LoadBalancerAvailable
func NewLoadBalancerAvailableWaiter ¶ added in v1.6.0
func NewLoadBalancerAvailableWaiter(client DescribeLoadBalancersAPIClient, optFns ...func(*LoadBalancerAvailableWaiterOptions)) *LoadBalancerAvailableWaiter
NewLoadBalancerAvailableWaiter constructs a LoadBalancerAvailableWaiter.
func (*LoadBalancerAvailableWaiter) Wait ¶ added in v1.6.0
func (w *LoadBalancerAvailableWaiter) Wait(ctx context.Context, params *DescribeLoadBalancersInput, maxWaitDur time.Duration, optFns ...func(*LoadBalancerAvailableWaiterOptions)) error
Wait calls the waiter function for LoadBalancerAvailable waiter. The maxWaitDur is the maximum wait duration the waiter will wait. The maxWaitDur is required and must be greater than zero.
func (*LoadBalancerAvailableWaiter) WaitForOutput ¶ added in v1.12.0
func (w *LoadBalancerAvailableWaiter) WaitForOutput(ctx context.Context, params *DescribeLoadBalancersInput, maxWaitDur time.Duration, optFns ...func(*LoadBalancerAvailableWaiterOptions)) (*DescribeLoadBalancersOutput, error)
WaitForOutput calls the waiter function for LoadBalancerAvailable waiter and returns the output of the successful operation. The maxWaitDur is the maximum wait duration the waiter will wait. The maxWaitDur is required and must be greater than zero.
type LoadBalancerAvailableWaiterOptions ¶ added in v1.6.0
type LoadBalancerAvailableWaiterOptions struct { // Set of options to modify how an operation is invoked. These apply to all // operations invoked for this client. Use functional options on operation call to // modify this list for per operation behavior. APIOptions []func(*middleware.Stack) error // MinDelay is the minimum amount of time to delay between retries. If unset, // LoadBalancerAvailableWaiter will use default minimum delay of 15 seconds. Note // that MinDelay must resolve to a value lesser than or equal to the MaxDelay. MinDelay time.Duration // MaxDelay is the maximum amount of time to delay between retries. If unset or // set to zero, LoadBalancerAvailableWaiter will use default max delay of 120 // seconds. Note that MaxDelay must resolve to value greater than or equal to the // MinDelay. MaxDelay time.Duration // LogWaitAttempts is used to enable logging for waiter retry attempts LogWaitAttempts bool // Retryable is function that can be used to override the service defined // waiter-behavior based on operation output, or returned error. This function is // used by the waiter to decide if a state is retryable or a terminal state. By // default service-modeled logic will populate this option. This option can thus be // used to define a custom waiter state with fall-back to service-modeled waiter // state mutators.The function returns an error in case of a failure state. In case // of retry state, this function returns a bool value of true and nil error, while // in case of success it returns a bool value of false and nil error. Retryable func(context.Context, *DescribeLoadBalancersInput, *DescribeLoadBalancersOutput, error) (bool, error) }
LoadBalancerAvailableWaiterOptions are waiter options for LoadBalancerAvailableWaiter
type LoadBalancerExistsWaiter ¶ added in v1.6.0
type LoadBalancerExistsWaiter struct {
// contains filtered or unexported fields
}
LoadBalancerExistsWaiter defines the waiters for LoadBalancerExists
func NewLoadBalancerExistsWaiter ¶ added in v1.6.0
func NewLoadBalancerExistsWaiter(client DescribeLoadBalancersAPIClient, optFns ...func(*LoadBalancerExistsWaiterOptions)) *LoadBalancerExistsWaiter
NewLoadBalancerExistsWaiter constructs a LoadBalancerExistsWaiter.
func (*LoadBalancerExistsWaiter) Wait ¶ added in v1.6.0
func (w *LoadBalancerExistsWaiter) Wait(ctx context.Context, params *DescribeLoadBalancersInput, maxWaitDur time.Duration, optFns ...func(*LoadBalancerExistsWaiterOptions)) error
Wait calls the waiter function for LoadBalancerExists waiter. The maxWaitDur is the maximum wait duration the waiter will wait. The maxWaitDur is required and must be greater than zero.
func (*LoadBalancerExistsWaiter) WaitForOutput ¶ added in v1.12.0
func (w *LoadBalancerExistsWaiter) WaitForOutput(ctx context.Context, params *DescribeLoadBalancersInput, maxWaitDur time.Duration, optFns ...func(*LoadBalancerExistsWaiterOptions)) (*DescribeLoadBalancersOutput, error)
WaitForOutput calls the waiter function for LoadBalancerExists waiter and returns the output of the successful operation. The maxWaitDur is the maximum wait duration the waiter will wait. The maxWaitDur is required and must be greater than zero.
type LoadBalancerExistsWaiterOptions ¶ added in v1.6.0
type LoadBalancerExistsWaiterOptions struct { // Set of options to modify how an operation is invoked. These apply to all // operations invoked for this client. Use functional options on operation call to // modify this list for per operation behavior. APIOptions []func(*middleware.Stack) error // MinDelay is the minimum amount of time to delay between retries. If unset, // LoadBalancerExistsWaiter will use default minimum delay of 15 seconds. Note that // MinDelay must resolve to a value lesser than or equal to the MaxDelay. MinDelay time.Duration // MaxDelay is the maximum amount of time to delay between retries. If unset or // set to zero, LoadBalancerExistsWaiter will use default max delay of 120 seconds. // Note that MaxDelay must resolve to value greater than or equal to the MinDelay. MaxDelay time.Duration // LogWaitAttempts is used to enable logging for waiter retry attempts LogWaitAttempts bool // Retryable is function that can be used to override the service defined // waiter-behavior based on operation output, or returned error. This function is // used by the waiter to decide if a state is retryable or a terminal state. By // default service-modeled logic will populate this option. This option can thus be // used to define a custom waiter state with fall-back to service-modeled waiter // state mutators.The function returns an error in case of a failure state. In case // of retry state, this function returns a bool value of true and nil error, while // in case of success it returns a bool value of false and nil error. Retryable func(context.Context, *DescribeLoadBalancersInput, *DescribeLoadBalancersOutput, error) (bool, error) }
LoadBalancerExistsWaiterOptions are waiter options for LoadBalancerExistsWaiter
type LoadBalancersDeletedWaiter ¶ added in v1.6.0
type LoadBalancersDeletedWaiter struct {
// contains filtered or unexported fields
}
LoadBalancersDeletedWaiter defines the waiters for LoadBalancersDeleted
func NewLoadBalancersDeletedWaiter ¶ added in v1.6.0
func NewLoadBalancersDeletedWaiter(client DescribeLoadBalancersAPIClient, optFns ...func(*LoadBalancersDeletedWaiterOptions)) *LoadBalancersDeletedWaiter
NewLoadBalancersDeletedWaiter constructs a LoadBalancersDeletedWaiter.
func (*LoadBalancersDeletedWaiter) Wait ¶ added in v1.6.0
func (w *LoadBalancersDeletedWaiter) Wait(ctx context.Context, params *DescribeLoadBalancersInput, maxWaitDur time.Duration, optFns ...func(*LoadBalancersDeletedWaiterOptions)) error
Wait calls the waiter function for LoadBalancersDeleted waiter. The maxWaitDur is the maximum wait duration the waiter will wait. The maxWaitDur is required and must be greater than zero.
func (*LoadBalancersDeletedWaiter) WaitForOutput ¶ added in v1.12.0
func (w *LoadBalancersDeletedWaiter) WaitForOutput(ctx context.Context, params *DescribeLoadBalancersInput, maxWaitDur time.Duration, optFns ...func(*LoadBalancersDeletedWaiterOptions)) (*DescribeLoadBalancersOutput, error)
WaitForOutput calls the waiter function for LoadBalancersDeleted waiter and returns the output of the successful operation. The maxWaitDur is the maximum wait duration the waiter will wait. The maxWaitDur is required and must be greater than zero.
type LoadBalancersDeletedWaiterOptions ¶ added in v1.6.0
type LoadBalancersDeletedWaiterOptions struct { // Set of options to modify how an operation is invoked. These apply to all // operations invoked for this client. Use functional options on operation call to // modify this list for per operation behavior. APIOptions []func(*middleware.Stack) error // MinDelay is the minimum amount of time to delay between retries. If unset, // LoadBalancersDeletedWaiter will use default minimum delay of 15 seconds. Note // that MinDelay must resolve to a value lesser than or equal to the MaxDelay. MinDelay time.Duration // MaxDelay is the maximum amount of time to delay between retries. If unset or // set to zero, LoadBalancersDeletedWaiter will use default max delay of 120 // seconds. Note that MaxDelay must resolve to value greater than or equal to the // MinDelay. MaxDelay time.Duration // LogWaitAttempts is used to enable logging for waiter retry attempts LogWaitAttempts bool // Retryable is function that can be used to override the service defined // waiter-behavior based on operation output, or returned error. This function is // used by the waiter to decide if a state is retryable or a terminal state. By // default service-modeled logic will populate this option. This option can thus be // used to define a custom waiter state with fall-back to service-modeled waiter // state mutators.The function returns an error in case of a failure state. In case // of retry state, this function returns a bool value of true and nil error, while // in case of success it returns a bool value of false and nil error. Retryable func(context.Context, *DescribeLoadBalancersInput, *DescribeLoadBalancersOutput, error) (bool, error) }
LoadBalancersDeletedWaiterOptions are waiter options for LoadBalancersDeletedWaiter
type ModifyListenerInput ¶
type ModifyListenerInput struct { // The Amazon Resource Name (ARN) of the listener. // // This member is required. ListenerArn *string // [TLS listeners] The name of the Application-Layer Protocol Negotiation (ALPN) // policy. You can specify one policy name. The following are the possible values: // - HTTP1Only // - HTTP2Only // - HTTP2Optional // - HTTP2Preferred // - None // For more information, see ALPN policies (https://docs.aws.amazon.com/elasticloadbalancing/latest/network/create-tls-listener.html#alpn-policies) // in the Network Load Balancers Guide. AlpnPolicy []string // [HTTPS and TLS listeners] The default certificate for the listener. You must // provide exactly one certificate. Set CertificateArn to the certificate ARN but // do not set IsDefault . Certificates []types.Certificate // The actions for the default rule. DefaultActions []types.Action // The port for connections from clients to the load balancer. You cannot specify // a port for a Gateway Load Balancer. Port *int32 // The protocol for connections from clients to the load balancer. Application // Load Balancers support the HTTP and HTTPS protocols. Network Load Balancers // support the TCP, TLS, UDP, and TCP_UDP protocols. You can’t change the protocol // to UDP or TCP_UDP if dual-stack mode is enabled. You cannot specify a protocol // for a Gateway Load Balancer. Protocol types.ProtocolEnum // [HTTPS and TLS listeners] The security policy that defines which protocols and // ciphers are supported. For more information, see Security policies (https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-https-listener.html#describe-ssl-policies) // in the Application Load Balancers Guide or Security policies (https://docs.aws.amazon.com/elasticloadbalancing/latest/network/create-tls-listener.html#describe-ssl-policies) // in the Network Load Balancers Guide. SslPolicy *string // contains filtered or unexported fields }
type ModifyListenerOutput ¶
type ModifyListenerOutput struct { // Information about the modified listener. Listeners []types.Listener // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type ModifyLoadBalancerAttributesInput ¶
type ModifyLoadBalancerAttributesInput struct { // The load balancer attributes. // // This member is required. Attributes []types.LoadBalancerAttribute // The Amazon Resource Name (ARN) of the load balancer. // // This member is required. LoadBalancerArn *string // contains filtered or unexported fields }
type ModifyLoadBalancerAttributesOutput ¶
type ModifyLoadBalancerAttributesOutput struct { // Information about the load balancer attributes. Attributes []types.LoadBalancerAttribute // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type ModifyRuleInput ¶
type ModifyRuleInput struct { // The Amazon Resource Name (ARN) of the rule. // // This member is required. RuleArn *string // The actions. Actions []types.Action // The conditions. Conditions []types.RuleCondition // contains filtered or unexported fields }
type ModifyRuleOutput ¶
type ModifyRuleOutput struct { // Information about the modified rule. Rules []types.Rule // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type ModifyTargetGroupAttributesInput ¶
type ModifyTargetGroupAttributesInput struct { // The attributes. // // This member is required. Attributes []types.TargetGroupAttribute // The Amazon Resource Name (ARN) of the target group. // // This member is required. TargetGroupArn *string // contains filtered or unexported fields }
type ModifyTargetGroupAttributesOutput ¶
type ModifyTargetGroupAttributesOutput struct { // Information about the attributes. Attributes []types.TargetGroupAttribute // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type ModifyTargetGroupInput ¶
type ModifyTargetGroupInput struct { // The Amazon Resource Name (ARN) of the target group. // // This member is required. TargetGroupArn *string // Indicates whether health checks are enabled. HealthCheckEnabled *bool // The approximate amount of time, in seconds, between health checks of an // individual target. HealthCheckIntervalSeconds *int32 // [HTTP/HTTPS health checks] The destination for health checks on the targets. // [HTTP1 or HTTP2 protocol version] The ping path. The default is /. [GRPC // protocol version] The path of a custom health check method with the format // /package.service/method. The default is /Amazon Web Services.ALB/healthcheck. HealthCheckPath *string // The port the load balancer uses when performing health checks on targets. HealthCheckPort *string // The protocol the load balancer uses when performing health checks on targets. // For Application Load Balancers, the default is HTTP. For Network Load Balancers // and Gateway Load Balancers, the default is TCP. The TCP protocol is not // supported for health checks if the protocol of the target group is HTTP or // HTTPS. It is supported for health checks only if the protocol of the target // group is TCP, TLS, UDP, or TCP_UDP. The GENEVE, TLS, UDP, and TCP_UDP protocols // are not supported for health checks. HealthCheckProtocol types.ProtocolEnum // [HTTP/HTTPS health checks] The amount of time, in seconds, during which no // response means a failed health check. HealthCheckTimeoutSeconds *int32 // The number of consecutive health checks successes required before considering // an unhealthy target healthy. HealthyThresholdCount *int32 // [HTTP/HTTPS health checks] The HTTP or gRPC codes to use when checking for a // successful response from a target. For target groups with a protocol of TCP, // TCP_UDP, UDP or TLS the range is 200-599. For target groups with a protocol of // HTTP or HTTPS, the range is 200-499. For target groups with a protocol of // GENEVE, the range is 200-399. Matcher *types.Matcher // The number of consecutive health check failures required before considering the // target unhealthy. UnhealthyThresholdCount *int32 // contains filtered or unexported fields }
type ModifyTargetGroupOutput ¶
type ModifyTargetGroupOutput struct { // Information about the modified target group. TargetGroups []types.TargetGroup // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type Options ¶
type Options struct { // Set of options to modify how an operation is invoked. These apply to all // operations invoked for this client. Use functional options on operation call to // modify this list for per operation behavior. APIOptions []func(*middleware.Stack) error // Configures the events that will be sent to the configured logger. ClientLogMode aws.ClientLogMode // The credentials object to use when signing requests. Credentials aws.CredentialsProvider // The configuration DefaultsMode that the SDK should use when constructing the // clients initial default settings. DefaultsMode aws.DefaultsMode // The endpoint options to be used when attempting to resolve an endpoint. EndpointOptions EndpointResolverOptions // The service endpoint resolver. EndpointResolver EndpointResolver // Signature Version 4 (SigV4) Signer HTTPSignerV4 HTTPSignerV4 // The logger writer interface to write logging messages to. Logger logging.Logger // The region to send requests to. (Required) Region string // RetryMaxAttempts specifies the maximum number attempts an API client will call // an operation that fails with a retryable error. A value of 0 is ignored, and // will not be used to configure the API client created default retryer, or modify // per operation call's retry max attempts. When creating a new API Clients this // member will only be used if the Retryer Options member is nil. This value will // be ignored if Retryer is not nil. If specified in an operation call's functional // options with a value that is different than the constructed client's Options, // the Client's Retryer will be wrapped to use the operation's specific // RetryMaxAttempts value. RetryMaxAttempts int // RetryMode specifies the retry mode the API client will be created with, if // Retryer option is not also specified. When creating a new API Clients this // member will only be used if the Retryer Options member is nil. This value will // be ignored if Retryer is not nil. Currently does not support per operation call // overrides, may in the future. RetryMode aws.RetryMode // Retryer guides how HTTP requests should be retried in case of recoverable // failures. When nil the API client will use a default retryer. The kind of // default retry created by the API client can be changed with the RetryMode // option. Retryer aws.Retryer // The RuntimeEnvironment configuration, only populated if the DefaultsMode is set // to DefaultsModeAuto and is initialized using config.LoadDefaultConfig . You // should not populate this structure programmatically, or rely on the values here // within your applications. RuntimeEnvironment aws.RuntimeEnvironment // The HTTP client to invoke API calls with. Defaults to client's default HTTP // implementation if nil. HTTPClient HTTPClient // contains filtered or unexported fields }
type RegisterTargetsInput ¶
type RegisterTargetsInput struct { // The Amazon Resource Name (ARN) of the target group. // // This member is required. TargetGroupArn *string // The targets. // // This member is required. Targets []types.TargetDescription // contains filtered or unexported fields }
type RegisterTargetsOutput ¶
type RegisterTargetsOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type RemoveListenerCertificatesInput ¶
type RemoveListenerCertificatesInput struct { // The certificate to remove. You can specify one certificate per call. Set // CertificateArn to the certificate ARN but do not set IsDefault . // // This member is required. Certificates []types.Certificate // The Amazon Resource Name (ARN) of the listener. // // This member is required. ListenerArn *string // contains filtered or unexported fields }
type RemoveListenerCertificatesOutput ¶
type RemoveListenerCertificatesOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type RemoveTagsInput ¶
type RemoveTagsOutput ¶
type RemoveTagsOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type ResolveEndpoint ¶
type ResolveEndpoint struct { Resolver EndpointResolver Options EndpointResolverOptions }
func (*ResolveEndpoint) HandleSerialize ¶
func (m *ResolveEndpoint) HandleSerialize(ctx context.Context, in middleware.SerializeInput, next middleware.SerializeHandler) ( out middleware.SerializeOutput, metadata middleware.Metadata, err error, )
func (*ResolveEndpoint) ID ¶
func (*ResolveEndpoint) ID() string
type SetIpAddressTypeInput ¶
type SetIpAddressTypeInput struct { // The IP address type. The possible values are ipv4 (for IPv4 addresses) and // dualstack (for IPv4 and IPv6 addresses). You can’t specify dualstack for a load // balancer with a UDP or TCP_UDP listener. // // This member is required. IpAddressType types.IpAddressType // The Amazon Resource Name (ARN) of the load balancer. // // This member is required. LoadBalancerArn *string // contains filtered or unexported fields }
type SetIpAddressTypeOutput ¶
type SetIpAddressTypeOutput struct { // The IP address type. IpAddressType types.IpAddressType // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type SetRulePrioritiesInput ¶
type SetRulePrioritiesInput struct { // The rule priorities. // // This member is required. RulePriorities []types.RulePriorityPair // contains filtered or unexported fields }
type SetRulePrioritiesOutput ¶
type SetRulePrioritiesOutput struct { // Information about the rules. Rules []types.Rule // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type SetSecurityGroupsInput ¶
type SetSecurityGroupsOutput ¶
type SetSecurityGroupsOutput struct { // The IDs of the security groups associated with the load balancer. SecurityGroupIds []string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type SetSubnetsInput ¶
type SetSubnetsInput struct { // The Amazon Resource Name (ARN) of the load balancer. // // This member is required. LoadBalancerArn *string // [Network Load Balancers] The type of IP addresses used by the subnets for your // load balancer. The possible values are ipv4 (for IPv4 addresses) and dualstack // (for IPv4 and IPv6 addresses). You can’t specify dualstack for a load balancer // with a UDP or TCP_UDP listener. . IpAddressType types.IpAddressType // The IDs of the public subnets. You can specify only one subnet per Availability // Zone. You must specify either subnets or subnet mappings. [Application Load // Balancers] You must specify subnets from at least two Availability Zones. You // cannot specify Elastic IP addresses for your subnets. [Application Load // Balancers on Outposts] You must specify one Outpost subnet. [Application Load // Balancers on Local Zones] You can specify subnets from one or more Local Zones. // [Network Load Balancers] You can specify subnets from one or more Availability // Zones. You can specify one Elastic IP address per subnet if you need static IP // addresses for your internet-facing load balancer. For internal load balancers, // you can specify one private IP address per subnet from the IPv4 range of the // subnet. For internet-facing load balancer, you can specify one IPv6 address per // subnet. SubnetMappings []types.SubnetMapping // The IDs of the public subnets. You can specify only one subnet per Availability // Zone. You must specify either subnets or subnet mappings. [Application Load // Balancers] You must specify subnets from at least two Availability Zones. // [Application Load Balancers on Outposts] You must specify one Outpost subnet. // [Application Load Balancers on Local Zones] You can specify subnets from one or // more Local Zones. [Network Load Balancers] You can specify subnets from one or // more Availability Zones. Subnets []string // contains filtered or unexported fields }
type SetSubnetsOutput ¶
type SetSubnetsOutput struct { // Information about the subnets. AvailabilityZones []types.AvailabilityZone // [Network Load Balancers] The IP address type. IpAddressType types.IpAddressType // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata // contains filtered or unexported fields }
type TargetDeregisteredWaiter ¶ added in v1.6.0
type TargetDeregisteredWaiter struct {
// contains filtered or unexported fields
}
TargetDeregisteredWaiter defines the waiters for TargetDeregistered
func NewTargetDeregisteredWaiter ¶ added in v1.6.0
func NewTargetDeregisteredWaiter(client DescribeTargetHealthAPIClient, optFns ...func(*TargetDeregisteredWaiterOptions)) *TargetDeregisteredWaiter
NewTargetDeregisteredWaiter constructs a TargetDeregisteredWaiter.
func (*TargetDeregisteredWaiter) Wait ¶ added in v1.6.0
func (w *TargetDeregisteredWaiter) Wait(ctx context.Context, params *DescribeTargetHealthInput, maxWaitDur time.Duration, optFns ...func(*TargetDeregisteredWaiterOptions)) error
Wait calls the waiter function for TargetDeregistered waiter. The maxWaitDur is the maximum wait duration the waiter will wait. The maxWaitDur is required and must be greater than zero.
func (*TargetDeregisteredWaiter) WaitForOutput ¶ added in v1.12.0
func (w *TargetDeregisteredWaiter) WaitForOutput(ctx context.Context, params *DescribeTargetHealthInput, maxWaitDur time.Duration, optFns ...func(*TargetDeregisteredWaiterOptions)) (*DescribeTargetHealthOutput, error)
WaitForOutput calls the waiter function for TargetDeregistered waiter and returns the output of the successful operation. The maxWaitDur is the maximum wait duration the waiter will wait. The maxWaitDur is required and must be greater than zero.
type TargetDeregisteredWaiterOptions ¶ added in v1.6.0
type TargetDeregisteredWaiterOptions struct { // Set of options to modify how an operation is invoked. These apply to all // operations invoked for this client. Use functional options on operation call to // modify this list for per operation behavior. APIOptions []func(*middleware.Stack) error // MinDelay is the minimum amount of time to delay between retries. If unset, // TargetDeregisteredWaiter will use default minimum delay of 15 seconds. Note that // MinDelay must resolve to a value lesser than or equal to the MaxDelay. MinDelay time.Duration // MaxDelay is the maximum amount of time to delay between retries. If unset or // set to zero, TargetDeregisteredWaiter will use default max delay of 120 seconds. // Note that MaxDelay must resolve to value greater than or equal to the MinDelay. MaxDelay time.Duration // LogWaitAttempts is used to enable logging for waiter retry attempts LogWaitAttempts bool // Retryable is function that can be used to override the service defined // waiter-behavior based on operation output, or returned error. This function is // used by the waiter to decide if a state is retryable or a terminal state. By // default service-modeled logic will populate this option. This option can thus be // used to define a custom waiter state with fall-back to service-modeled waiter // state mutators.The function returns an error in case of a failure state. In case // of retry state, this function returns a bool value of true and nil error, while // in case of success it returns a bool value of false and nil error. Retryable func(context.Context, *DescribeTargetHealthInput, *DescribeTargetHealthOutput, error) (bool, error) }
TargetDeregisteredWaiterOptions are waiter options for TargetDeregisteredWaiter
type TargetInServiceWaiter ¶ added in v1.6.0
type TargetInServiceWaiter struct {
// contains filtered or unexported fields
}
TargetInServiceWaiter defines the waiters for TargetInService
func NewTargetInServiceWaiter ¶ added in v1.6.0
func NewTargetInServiceWaiter(client DescribeTargetHealthAPIClient, optFns ...func(*TargetInServiceWaiterOptions)) *TargetInServiceWaiter
NewTargetInServiceWaiter constructs a TargetInServiceWaiter.
func (*TargetInServiceWaiter) Wait ¶ added in v1.6.0
func (w *TargetInServiceWaiter) Wait(ctx context.Context, params *DescribeTargetHealthInput, maxWaitDur time.Duration, optFns ...func(*TargetInServiceWaiterOptions)) error
Wait calls the waiter function for TargetInService waiter. The maxWaitDur is the maximum wait duration the waiter will wait. The maxWaitDur is required and must be greater than zero.
func (*TargetInServiceWaiter) WaitForOutput ¶ added in v1.12.0
func (w *TargetInServiceWaiter) WaitForOutput(ctx context.Context, params *DescribeTargetHealthInput, maxWaitDur time.Duration, optFns ...func(*TargetInServiceWaiterOptions)) (*DescribeTargetHealthOutput, error)
WaitForOutput calls the waiter function for TargetInService waiter and returns the output of the successful operation. The maxWaitDur is the maximum wait duration the waiter will wait. The maxWaitDur is required and must be greater than zero.
type TargetInServiceWaiterOptions ¶ added in v1.6.0
type TargetInServiceWaiterOptions struct { // Set of options to modify how an operation is invoked. These apply to all // operations invoked for this client. Use functional options on operation call to // modify this list for per operation behavior. APIOptions []func(*middleware.Stack) error // MinDelay is the minimum amount of time to delay between retries. If unset, // TargetInServiceWaiter will use default minimum delay of 15 seconds. Note that // MinDelay must resolve to a value lesser than or equal to the MaxDelay. MinDelay time.Duration // MaxDelay is the maximum amount of time to delay between retries. If unset or // set to zero, TargetInServiceWaiter will use default max delay of 120 seconds. // Note that MaxDelay must resolve to value greater than or equal to the MinDelay. MaxDelay time.Duration // LogWaitAttempts is used to enable logging for waiter retry attempts LogWaitAttempts bool // Retryable is function that can be used to override the service defined // waiter-behavior based on operation output, or returned error. This function is // used by the waiter to decide if a state is retryable or a terminal state. By // default service-modeled logic will populate this option. This option can thus be // used to define a custom waiter state with fall-back to service-modeled waiter // state mutators.The function returns an error in case of a failure state. In case // of retry state, this function returns a bool value of true and nil error, while // in case of success it returns a bool value of false and nil error. Retryable func(context.Context, *DescribeTargetHealthInput, *DescribeTargetHealthOutput, error) (bool, error) }
TargetInServiceWaiterOptions are waiter options for TargetInServiceWaiter
Source Files ¶
- api_client.go
- api_op_AddListenerCertificates.go
- api_op_AddTags.go
- api_op_CreateListener.go
- api_op_CreateLoadBalancer.go
- api_op_CreateRule.go
- api_op_CreateTargetGroup.go
- api_op_DeleteListener.go
- api_op_DeleteLoadBalancer.go
- api_op_DeleteRule.go
- api_op_DeleteTargetGroup.go
- api_op_DeregisterTargets.go
- api_op_DescribeAccountLimits.go
- api_op_DescribeListenerCertificates.go
- api_op_DescribeListeners.go
- api_op_DescribeLoadBalancerAttributes.go
- api_op_DescribeLoadBalancers.go
- api_op_DescribeRules.go
- api_op_DescribeSSLPolicies.go
- api_op_DescribeTags.go
- api_op_DescribeTargetGroupAttributes.go
- api_op_DescribeTargetGroups.go
- api_op_DescribeTargetHealth.go
- api_op_ModifyListener.go
- api_op_ModifyLoadBalancerAttributes.go
- api_op_ModifyRule.go
- api_op_ModifyTargetGroup.go
- api_op_ModifyTargetGroupAttributes.go
- api_op_RegisterTargets.go
- api_op_RemoveListenerCertificates.go
- api_op_RemoveTags.go
- api_op_SetIpAddressType.go
- api_op_SetRulePriorities.go
- api_op_SetSecurityGroups.go
- api_op_SetSubnets.go
- deserializers.go
- doc.go
- endpoints.go
- go_module_metadata.go
- serializers.go
- validators.go