IAmazonElasticLoadBalancing.SetLoadBalancerPoliciesForBackendServer Method (SetLoadBalancerPoliciesForBackendServerRequest)

Replaces the set of policies associated with the specified port on which the EC2 instance is listening with a new set of policies. At this time, only the back-end server authentication policy type can be applied to the instance ports; this policy type is composed of multiple public key policies.

Each time you use SetLoadBalancerPoliciesForBackendServer to enable the policies, use the PolicyNames parameter to list the policies that you want to enable.

You can use DescribeLoadBalancers or DescribeLoadBalancerPolicies to verify that the policy is associated with the EC2 instance.

For more information about enabling back-end instance authentication, see Configure Back-end Instance Authentication in the Classic Load Balancers Guide. For more information about Proxy Protocol, see Configure Proxy Protocol Support in the Classic Load Balancers Guide.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to SetLoadBalancerPoliciesForBackendServerAsync.

Namespace: Amazon.ElasticLoadBalancing
Assembly: AWSSDK.ElasticLoadBalancing.dll
Version: 3.x.y.z

Syntax

public abstract SetLoadBalancerPoliciesForBackendServerResponse SetLoadBalancerPoliciesForBackendServer(
         SetLoadBalancerPoliciesForBackendServerRequest request
)

Parameters

request: Type: Amazon.ElasticLoadBalancing.Model.SetLoadBalancerPoliciesForBackendServerRequest

Container for the necessary parameters to execute the SetLoadBalancerPoliciesForBackendServer service method.

Return Value

Type: SetLoadBalancerPoliciesForBackendServerResponse

The response from the SetLoadBalancerPoliciesForBackendServer service method, as returned by ElasticLoadBalancing.

Exceptions

Exception	Condition
AccessPointNotFoundException	The specified load balancer does not exist.
InvalidConfigurationRequestException	The requested configuration change is not valid.
PolicyNotFoundException	One or more of the specified policies do not exist.

Examples

This example replaces the policies that are currently associated with the specified port.

To replace the policies associated with a port for a backend instance


var client = new AmazonElasticLoadBalancingClient();
var response = client.SetLoadBalancerPoliciesForBackendServer(new SetLoadBalancerPoliciesForBackendServerRequest 
{
    InstancePort = 80,
    LoadBalancerName = "my-load-balancer",
    PolicyNames = new List<string> {
        "my-ProxyProtocol-policy"
    }
});

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

IAmazonElasticLoadBalancing.SetLoadBalancerPoliciesForBackendServer (SetLoadBalancerPoliciesForBackendServerRequest)

Method