AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates a policy with the specified attributes for the specified load balancer.

Policies are settings that are saved for your load balancer and that can be applied to the listener or the application server, depending on the policy type.

Note:

For PCL this operation is only available in asynchronous form. Please refer to CreateLoadBalancerPolicyAsync.

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

Syntax

C#
public virtual CreateLoadBalancerPolicyResponse CreateLoadBalancerPolicy(
         CreateLoadBalancerPolicyRequest request
)
Parameters
request
Type: Amazon.ElasticLoadBalancing.Model.CreateLoadBalancerPolicyRequest

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

Return Value
The response from the CreateLoadBalancerPolicy service method, as returned by ElasticLoadBalancing.

Exceptions

ExceptionCondition
AccessPointNotFoundException The specified load balancer does not exist.
DuplicatePolicyNameException A policy with the specified name already exists for this load balancer.
InvalidConfigurationRequestException The requested configuration change is not valid.
PolicyTypeNotFoundException One or more of the specified policy types do not exist.
TooManyPoliciesException The quota for the number of policies for this load balancer has been reached.

Examples

This example creates a policy that enables Proxy Protocol on the specified load balancer.

To create a policy that enables Proxy Protocol on a load balancer


var response = client.CreateLoadBalancerPolicy(new CreateLoadBalancerPolicyRequest 
{
    LoadBalancerName = "my-load-balancer",
    PolicyAttributes = new List {
        new PolicyAttribute {
            AttributeName = "ProxyProtocol",
            AttributeValue = "true"
        }
    },
    PolicyName = "my-ProxyProtocol-policy",
    PolicyTypeName = "ProxyProtocolPolicyType"
});


            

This example creates a public key policy.

To create a public key policy


var response = client.CreateLoadBalancerPolicy(new CreateLoadBalancerPolicyRequest 
{
    LoadBalancerName = "my-load-balancer",
    PolicyAttributes = new List {
        new PolicyAttribute {
            AttributeName = "PublicKey",
            AttributeValue = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAwAYUjnfyEyXr1pxjhFWBpMlggUcqoi3kl+dS74kj//c6x7ROtusUaeQCTgIUkayttRDWchuqo1pHC1u+n5xxXnBBe2ejbb2WRsKIQ5rXEeixsjFpFsojpSQKkzhVGI6mJVZBJDVKSHmswnwLBdofLhzvllpovBPTHe+o4haAWvDBALJU0pkSI1FecPHcs2hwxf14zHoXy1e2k36A64nXW43wtfx5qcVSIxtCEOjnYRg7RPvybaGfQ+v6Iaxb/+7J5kEvZhTFQId+bSiJImF1FSUT1W1xwzBZPUbcUkkXDj45vC2s3Z8E+Lk7a3uZhvsQHLZnrfuWjBWGWvZ/MhZYgEXAMPLE"
        }
    },
    PolicyName = "my-PublicKey-policy",
    PolicyTypeName = "PublicKeyPolicyType"
});


            

This example creates a backend server authentication policy that enables authentication on your backend instance using a public key policy.

To create a backend server authentication policy


var response = client.CreateLoadBalancerPolicy(new CreateLoadBalancerPolicyRequest 
{
    LoadBalancerName = "my-load-balancer",
    PolicyAttributes = new List {
        new PolicyAttribute {
            AttributeName = "PublicKeyPolicyName",
            AttributeValue = "my-PublicKey-policy"
        }
    },
    PolicyName = "my-authentication-policy",
    PolicyTypeName = "BackendServerAuthenticationPolicyType"
});


            

Version Information

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

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also