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 Balancers 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
Examples
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 Amazon SDKs, see the following: