Menu
Elastic Load Balancing
API Reference (API Version 2012-06-01)

AttachLoadBalancerToSubnets

Adds one or more subnets to the set of configured subnets for the specified load balancer.

The load balancer evenly distributes requests across all registered subnets. For more information, see Add or Remove Subnets for Your Load Balancer in a VPC in the Classic Load Balancer Guide.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

LoadBalancerName

The name of the load balancer.

Type: String

Required: Yes

Subnets.member.N

The IDs of the subnets to add. You can add only one subnet per Availability Zone.

Type: Array of strings

Required: Yes

Response Elements

The following element is returned by the service.

Subnets.member.N

The IDs of the subnets attached to the load balancer.

Type: Array of strings

Errors

For information about the errors that are common to all actions, see Common Errors.

InvalidConfigurationRequest

The requested configuration change is not valid.

HTTP Status Code: 409

InvalidSubnet

The specified VPC has no associated Internet gateway.

HTTP Status Code: 400

LoadBalancerNotFound

The specified load balancer does not exist.

HTTP Status Code: 400

SubnetNotFound

One or more of the specified subnets do not exist.

HTTP Status Code: 400

Example

Attach Subnets

This example adds the specified subnet to the set of configured subnets for the specified load balancer.

Sample Request

https://elasticloadbalancing.amazonaws.com/?Action=AttachLoadBalancerToSubnets
&LoadBalancerName=my-vpc-loadbalancer
&Subnets.member.1=subnet-3561b05e
&Version=2012-06-01
&AUTHPARAMS 

Sample Response

<AttachLoadBalancerToSubnetsResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2012-06-01/">
  <AttachLoadBalancerToSubnetsResult>
    <Subnets>
      <member>subnet-119f0078</member>
      <member>subnet-3561b05e</member>
    </Subnets>
  </AttachLoadBalancerToSubnetsResult>
  <ResponseMetadata>
    <RequestId>07b1ecbc-1100-11e3-acaf-dd7edEXAMPLE</RequestId>
  </ResponseMetadata>
</AttachLoadBalancerToSubnetsResponse> 

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: