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

ApplySecurityGroupsToLoadBalancer

Associates one or more security groups with your load balancer in a virtual private cloud (VPC). The specified security groups override the previously associated security groups.

For more information, see Security Groups for Load Balancers 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

SecurityGroups.member.N

The IDs of the security groups to associate with the load balancer. Note that you cannot specify the name of the security group.

Type: Array of strings

Required: Yes

Response Elements

The following element is returned by the service.

SecurityGroups.member.N

The IDs of the security groups associated with 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

InvalidSecurityGroup

One or more of the specified security groups do not exist.

HTTP Status Code: 400

LoadBalancerNotFound

The specified load balancer does not exist.

HTTP Status Code: 400

Example

Associate a Security Group

This example associates a security group with the specified load balancer in a VPC.

Sample Request

https://elasticloadbalancing.amazonaws.com/?Action=ApplySecurityGroupsToLoadBalancer
&LoadBalancerName=my-vpc-loadbalancer
&SecurityGroups.member.1=sg-123456789
&Version=2012-06-01
&AUTHPARAMS 

Sample Response

<ApplySecurityGroupsToLoadBalancerResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2012-06-01/">
  <ApplySecurityGroupsToLoadBalancerResult>
    <SecurityGroups>
      <member>sg-123456789</member>
    </SecurityGroups>
  </ApplySecurityGroupsToLoadBalancerResult>
  <ResponseMetadata>
    <RequestId>06b5decc-102a-11e3-9ad6-bf3e4EXAMPLE</RequestId>
  </ResponseMetadata>
</ApplySecurityGroupsToLoadBalancerResponse> 

See Also

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