# SetSecurityGroups
<a name="API_SetSecurityGroups"></a>

Associates the specified security groups with the specified Application Load Balancer or Network Load Balancer. The specified security groups override the previously associated security groups.

You can't perform this operation on a Network Load Balancer unless you specified a security group for the load balancer when you created it.

You can't associate a security group with a Gateway Load Balancer.

## Request Parameters
<a name="API_SetSecurityGroups_RequestParameters"></a>

 For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

 ** EnforceSecurityGroupInboundRulesOnPrivateLinkTraffic **   
Indicates whether to evaluate inbound security group rules for traffic sent to a Network Load Balancer through Amazon PrivateLink. Applies only if the load balancer has an associated security group. The default is `on`.  
Type: String  
Valid Values: `on | off`   
Required: No

 ** 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
<a name="API_SetSecurityGroups_ResponseElements"></a>

The following elements are returned by the service.

 ** EnforceSecurityGroupInboundRulesOnPrivateLinkTraffic **   
Indicates whether to evaluate inbound security group rules for traffic sent to a Network Load Balancer through Amazon PrivateLink.  
Type: String  
Valid Values: `on | off` 

 **SecurityGroupIds.member.N**   
The IDs of the security groups associated with the load balancer.  
Type: Array of strings

## Errors
<a name="API_SetSecurityGroups_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** 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

## Examples
<a name="API_SetSecurityGroups_Examples"></a>

### Associate a security group with a load balancer
<a name="API_SetSecurityGroups_Example_1"></a>

This example associates the specified security group with the specified load balancer.

#### Sample Request
<a name="API_SetSecurityGroups_Example_1_Request"></a>

```
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
<a name="API_SetSecurityGroups_Example_1_Response"></a>

```
<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
<a name="API_SetSecurityGroups_SeeAlso"></a>

For more information about using this API in one of the language-specific Amazon SDKs, see the following:
+  [Amazon Command Line Interface V2](https://docs.amazonaws.cn/goto/cli2/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [Amazon SDK for .NET V4](https://docs.amazonaws.cn/goto/DotNetSDKV4/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [Amazon SDK for C\+\+](https://docs.amazonaws.cn/goto/SdkForCpp/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [Amazon SDK for Go v2](https://docs.amazonaws.cn/goto/SdkForGoV2/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [Amazon SDK for Java V2](https://docs.amazonaws.cn/goto/SdkForJavaV2/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [Amazon SDK for JavaScript V3](https://docs.amazonaws.cn/goto/SdkForJavaScriptV3/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [Amazon SDK for Kotlin](https://docs.amazonaws.cn/goto/SdkForKotlin/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [Amazon SDK for PHP V3](https://docs.amazonaws.cn/goto/SdkForPHPV3/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [Amazon SDK for Python](https://docs.amazonaws.cn/goto/boto3/elasticloadbalancingv2-2015-12-01/SetSecurityGroups) 
+  [Amazon SDK for Ruby V3](https://docs.amazonaws.cn/goto/SdkForRubyV3/elasticloadbalancingv2-2015-12-01/SetSecurityGroups)