Class CfnDBProxyProps

Properties for defining a CfnDBProxy.

Inheritance

System.Object

CfnDBProxyProps

Implements

ICfnDBProxyProps

Namespace: Amazon.CDK.AWS.RDS

Assembly: Amazon.CDK.AWS.RDS.dll

Syntax (csharp)

public class CfnDBProxyProps : Object, ICfnDBProxyProps

Syntax (vb)

Public Class CfnDBProxyProps
    Inherits Object
    Implements ICfnDBProxyProps

Remarks

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbproxy.html

ExampleMetadata: fixture=_generated

Examples

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.RDS;

var cfnDBProxyProps = new CfnDBProxyProps {
    Auth = new [] { new AuthFormatProperty {
        AuthScheme = "authScheme",
        ClientPasswordAuthType = "clientPasswordAuthType",
        Description = "description",
        IamAuth = "iamAuth",
        SecretArn = "secretArn"
    } },
    DbProxyName = "dbProxyName",
    EngineFamily = "engineFamily",
    RoleArn = "roleArn",
    VpcSubnetIds = new [] { "vpcSubnetIds" },

    // the properties below are optional
    DebugLogging = false,
    IdleClientTimeout = 123,
    RequireTls = false,
    Tags = new [] { new TagFormatProperty {
        Key = "key",
        Value = "value"
    } },
    VpcSecurityGroupIds = new [] { "vpcSecurityGroupIds" }
};

Synopsis

Constructors

CfnDBProxyProps()

Properties

Auth	The authorization mechanism that the proxy uses.
DbProxyName	The identifier for the proxy.
DebugLogging	Whether the proxy includes detailed information about SQL statements in its logs.
EngineFamily	The kinds of databases that the proxy can connect to.
IdleClientTimeout	The number of seconds that a connection to the proxy can be inactive before the proxy disconnects it.
RequireTls	A Boolean parameter that specifies whether Transport Layer Security (TLS) encryption is required for connections to the proxy.
RoleArn	The Amazon Resource Name (ARN) of the IAM role that the proxy uses to access secrets in AWS Secrets Manager.
Tags	An optional set of key-value pairs to associate arbitrary data of your choosing with the proxy.
VpcSecurityGroupIds	One or more VPC security group IDs to associate with the new proxy.
VpcSubnetIds	One or more VPC subnet IDs to associate with the new proxy.

Constructors

CfnDBProxyProps()

public CfnDBProxyProps()

Properties

Auth

The authorization mechanism that the proxy uses.

public object Auth { get; set; }

Property Value

System.Object

Remarks

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbproxy.html#cfn-rds-dbproxy-auth

DbProxyName

The identifier for the proxy.

public string DbProxyName { get; set; }

Property Value

System.String

Remarks

This name must be unique for all proxies owned by your AWS account in the specified AWS Region . An identifier must begin with a letter and must contain only ASCII letters, digits, and hyphens; it can't end with a hyphen or contain two consecutive hyphens.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbproxy.html#cfn-rds-dbproxy-dbproxyname

DebugLogging

Whether the proxy includes detailed information about SQL statements in its logs.

public object DebugLogging { get; set; }

Property Value

System.Object

Remarks

This information helps you to debug issues involving SQL behavior or the performance and scalability of the proxy connections. The debug information includes the text of SQL statements that you submit through the proxy. Thus, only enable this setting when needed for debugging, and only when you have security measures in place to safeguard any sensitive information that appears in the logs.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbproxy.html#cfn-rds-dbproxy-debuglogging

EngineFamily

The kinds of databases that the proxy can connect to.

public string EngineFamily { get; set; }

Property Value

System.String

Remarks

This value determines which database network protocol the proxy recognizes when it interprets network traffic to and from the database. For Aurora MySQL, RDS for MariaDB, and RDS for MySQL databases, specify MYSQL . For Aurora PostgreSQL and RDS for PostgreSQL databases, specify POSTGRESQL . For RDS for Microsoft SQL Server, specify SQLSERVER .

Valid values : MYSQL | POSTGRESQL | SQLSERVER

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbproxy.html#cfn-rds-dbproxy-enginefamily

IdleClientTimeout

The number of seconds that a connection to the proxy can be inactive before the proxy disconnects it.

public Nullable<double> IdleClientTimeout { get; set; }

Property Value

System.Nullable<System.Double>

Remarks

You can set this value higher or lower than the connection timeout limit for the associated database.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbproxy.html#cfn-rds-dbproxy-idleclienttimeout

RequireTls

A Boolean parameter that specifies whether Transport Layer Security (TLS) encryption is required for connections to the proxy.

public object RequireTls { get; set; }

Property Value

System.Object

Remarks

By enabling this setting, you can enforce encrypted TLS connections to the proxy.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbproxy.html#cfn-rds-dbproxy-requiretls

RoleArn

The Amazon Resource Name (ARN) of the IAM role that the proxy uses to access secrets in AWS Secrets Manager.

public string RoleArn { get; set; }

Property Value

System.String

Remarks

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbproxy.html#cfn-rds-dbproxy-rolearn

VpcSecurityGroupIds

One or more VPC security group IDs to associate with the new proxy.

public string[] VpcSecurityGroupIds { get; set; }

Property Value

System.String[]

Remarks

If you plan to update the resource, don't specify VPC security groups in a shared VPC.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbproxy.html#cfn-rds-dbproxy-vpcsecuritygroupids

VpcSubnetIds

One or more VPC subnet IDs to associate with the new proxy.

public string[] VpcSubnetIds { get; set; }

Property Value

System.String[]

Remarks

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbproxy.html#cfn-rds-dbproxy-vpcsubnetids

Implements

ICfnDBProxyProps