set_security_groups

ElasticLoadBalancingv2.Client.set_security_groups(**kwargs)

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

You can't specify a security group for a Network Load Balancer or Gateway Load Balancer.

See also: AWS API Documentation

Request Syntax

response = client.set_security_groups(
    LoadBalancerArn='string',
    SecurityGroups=[
        'string',
    ]
)
Parameters
  • LoadBalancerArn (string) --

    [REQUIRED]

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

  • SecurityGroups (list) --

    [REQUIRED]

    The IDs of the security groups.

    • (string) --
Return type

dict

Returns

Response Syntax

{
    'SecurityGroupIds': [
        'string',
    ]
}

Response Structure

  • (dict) --

    • SecurityGroupIds (list) --

      The IDs of the security groups associated with the load balancer.

      • (string) --

Exceptions

  • ElasticLoadBalancingv2.Client.exceptions.LoadBalancerNotFoundException
  • ElasticLoadBalancingv2.Client.exceptions.InvalidConfigurationRequestException
  • ElasticLoadBalancingv2.Client.exceptions.InvalidSecurityGroupException

Examples

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

response = client.set_security_groups(
    LoadBalancerArn='arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188',
    SecurityGroups=[
        'sg-5943793c',
    ],
)

print(response)

Expected Output:

{
    'SecurityGroupIds': [
        'sg-5943793c',
    ],
    'ResponseMetadata': {
        '...': '...',
    },
}