@pulumi/aws
Version:
A Pulumi package for creating and managing Amazon Web Services (AWS) cloud resources.
142 lines (141 loc) • 5.71 kB
TypeScript
import * as pulumi from "@pulumi/pulumi";
import * as inputs from "../types/input";
import * as outputs from "../types/output";
/**
* Provides a resource to manage an RDS DB proxy default target group resource.
*
* The `aws.rds.ProxyDefaultTargetGroup` behaves differently from normal resources, in that the provider does not _create_ or _destroy_ this resource, since it implicitly exists as part of an RDS DB Proxy. On the provider resource creation it is automatically imported and on resource destruction, the provider performs no actions in RDS.
*
* ## Example Usage
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as aws from "@pulumi/aws";
*
* const example = new aws.rds.Proxy("example", {
* name: "example",
* debugLogging: false,
* engineFamily: "MYSQL",
* idleClientTimeout: 1800,
* requireTls: true,
* roleArn: exampleAwsIamRole.arn,
* vpcSecurityGroupIds: [exampleAwsSecurityGroup.id],
* vpcSubnetIds: [exampleAwsSubnet.id],
* auths: [{
* authScheme: "SECRETS",
* description: "example",
* iamAuth: "DISABLED",
* secretArn: exampleAwsSecretsmanagerSecret.arn,
* }],
* tags: {
* Name: "example",
* Key: "value",
* },
* });
* const exampleProxyDefaultTargetGroup = new aws.rds.ProxyDefaultTargetGroup("example", {
* dbProxyName: example.name,
* connectionPoolConfig: {
* connectionBorrowTimeout: 120,
* initQuery: "SET x=1, y=2",
* maxConnectionsPercent: 100,
* maxIdleConnectionsPercent: 50,
* sessionPinningFilters: ["EXCLUDE_VARIABLE_SETS"],
* },
* });
* ```
*
* ## Import
*
* Using `pulumi import`, import DB proxy default target groups using the `db_proxy_name`. For example:
*
* ```sh
* $ pulumi import aws:rds/proxyDefaultTargetGroup:ProxyDefaultTargetGroup example example
* ```
*/
export declare class ProxyDefaultTargetGroup extends pulumi.CustomResource {
/**
* Get an existing ProxyDefaultTargetGroup resource's state with the given name, ID, and optional extra
* properties used to qualify the lookup.
*
* @param name The _unique_ name of the resulting resource.
* @param id The _unique_ provider ID of the resource to lookup.
* @param state Any extra arguments used during the lookup.
* @param opts Optional settings to control the behavior of the CustomResource.
*/
static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ProxyDefaultTargetGroupState, opts?: pulumi.CustomResourceOptions): ProxyDefaultTargetGroup;
/**
* Returns true if the given object is an instance of ProxyDefaultTargetGroup. This is designed to work even
* when multiple copies of the Pulumi SDK have been loaded into the same process.
*/
static isInstance(obj: any): obj is ProxyDefaultTargetGroup;
/**
* The Amazon Resource Name (ARN) representing the target group.
*/
readonly arn: pulumi.Output<string>;
/**
* The settings that determine the size and behavior of the connection pool for the target group.
*/
readonly connectionPoolConfig: pulumi.Output<outputs.rds.ProxyDefaultTargetGroupConnectionPoolConfig>;
/**
* Name of the RDS DB Proxy.
*/
readonly dbProxyName: pulumi.Output<string>;
/**
* The name of the default target group.
*/
readonly name: pulumi.Output<string>;
/**
* Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
*/
readonly region: pulumi.Output<string>;
/**
* Create a ProxyDefaultTargetGroup resource with the given unique name, arguments, and options.
*
* @param name The _unique_ name of the resource.
* @param args The arguments to use to populate this resource's properties.
* @param opts A bag of options that control this resource's behavior.
*/
constructor(name: string, args: ProxyDefaultTargetGroupArgs, opts?: pulumi.CustomResourceOptions);
}
/**
* Input properties used for looking up and filtering ProxyDefaultTargetGroup resources.
*/
export interface ProxyDefaultTargetGroupState {
/**
* The Amazon Resource Name (ARN) representing the target group.
*/
arn?: pulumi.Input<string>;
/**
* The settings that determine the size and behavior of the connection pool for the target group.
*/
connectionPoolConfig?: pulumi.Input<inputs.rds.ProxyDefaultTargetGroupConnectionPoolConfig>;
/**
* Name of the RDS DB Proxy.
*/
dbProxyName?: pulumi.Input<string>;
/**
* The name of the default target group.
*/
name?: pulumi.Input<string>;
/**
* Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
*/
region?: pulumi.Input<string>;
}
/**
* The set of arguments for constructing a ProxyDefaultTargetGroup resource.
*/
export interface ProxyDefaultTargetGroupArgs {
/**
* The settings that determine the size and behavior of the connection pool for the target group.
*/
connectionPoolConfig?: pulumi.Input<inputs.rds.ProxyDefaultTargetGroupConnectionPoolConfig>;
/**
* Name of the RDS DB Proxy.
*/
dbProxyName: pulumi.Input<string>;
/**
* Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
*/
region?: pulumi.Input<string>;
}