Menu
Elastic Load Balancing
API Reference (API Version 2015-12-01)

SetSubnets

Enables the Availability Zone for the specified subnets for the specified load balancer. The specified subnets replace the previously enabled subnets.

Request Parameters

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

LoadBalancerArn

The Amazon Resource Name (ARN) of the load balancer.

Type: String

Required: Yes

Subnets.member.N

The IDs of the subnets. You must specify at least two subnets. 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.

AvailabilityZones.member.N

Information about the subnet and Availability Zone.

Type: Array of AvailabilityZone objects

Errors

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

InvalidConfigurationRequest

The requested configuration is not valid.

HTTP Status Code: 400

InvalidSubnet

The specified subnet is out of available addresses.

HTTP Status Code: 400

LoadBalancerNotFound

The specified load balancer does not exist.

HTTP Status Code: 400

SubnetNotFound

The specified subnet does not exist.

HTTP Status Code: 400

Example

Enable Availability Zones for a load balancer

This example enables the Availability Zone for the specified subnet for the specified load balancer.

Sample Request

Copy
https://elasticloadbalancing.amazonaws.com/?Action=SetSubnets &LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 &Subnets.member.1=subnet-8360a9e7 &Subnets.member.2=subnet-b7d581c0 &Version=2015-12-01 &AUTHPARAMS

Sample Response

Copy
<SetSubnetsResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/"> <SetSubnetsResult> <AvailabilityZones> <member> <SubnetId>subnet-8360a9e7</SubnetId> <ZoneName>us-west-2a</ZoneName> </member> <member> <SubnetId>subnet-b7d581c0</SubnetId> <ZoneName>us-west-2b</ZoneName> </member> </AvailabilityZones> </SetSubnetsResult> <ResponseMetadata> <RequestId>c1a80803-f3ab-11e5-b673-8d4a8a9e6f48</RequestId> </ResponseMetadata> </SetSubnetsResponse>

See Also

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