SetSecurityGroups
Associates the specified security groups with the specified Application Load Balancer. The specified security groups override the previously associated security groups.
Note that you can't specify a security group for a Network Load Balancer.
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
- SecurityGroups.member.N
-
The IDs of the security groups.
Type: Array of strings
Required: Yes
Response Elements
The following element is returned by the service.
- SecurityGroupIds.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 is not valid.
HTTP Status Code: 400
- InvalidSecurityGroup
-
The specified security group does not exist.
HTTP Status Code: 400
- LoadBalancerNotFound
-
The specified load balancer does not exist.
HTTP Status Code: 400
Example
Associate a security group with a load balancer
This example associates the specified security group with the specified load balancer.
Sample Request
https://elasticloadbalancing.amazonaws.com/?Action=SetSecurityGroups &LoadBalancerArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 &SecurityGroups.member.1=sg-5943793c &Version=2015-12-01 &AUTHPARAMS
Sample Response
<SetSecurityGroupsResponse xmlns="http://elasticloadbalancing.amazonaws.com/doc/2015-12-01/"> <SetSecurityGroupsResult> <SecurityGroupIds> <member>sg-5943793c</member> </SecurityGroupIds> </SetSecurityGroupsResult> <ResponseMetadata> <RequestId>a127426b-f3ab-11e5-9192-3fff33344cfa</RequestId> </ResponseMetadata> </SetSecurityGroupsResponse>
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
