@volcengine/pulumi
Version:
A Pulumi package for creating and managing volcengine cloud resources.
253 lines (252 loc) • 12.2 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 rds mysql endpoint
* ## Example Usage
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as volcengine from "@volcengine/pulumi";
*
* const foo = new volcengine.rds_mysql.Endpoint("foo", {
* autoAddNewNodes: true,
* description: "tf-test-1",
* dnsVisibility: false,
* endpointName: "tf-test-1",
* instanceId: "mysql-b51d37110dd1",
* nodes: ["Primary"],
* readOnlyNodeDistributionType: "RoundRobinAuto",
* readOnlyNodeMaxDelayTime: 30,
* readOnlyNodeWeights: [{
* nodeType: "Primary",
* weight: 100,
* }],
* readWriteMode: "ReadWrite",
* readWriteSpliting: true,
* });
* ```
*
* ## Import
*
* RdsMysqlEndpoint can be imported using the instance id and endpoint id, e.g.
*
* ```sh
* $ pulumi import volcengine:rds_mysql/endpoint:Endpoint default mysql-3c25f219***:mysql-3c25f219****-custom-eeb5
* ```
*/
export declare class Endpoint extends pulumi.CustomResource {
/**
* Get an existing Endpoint 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?: EndpointState, opts?: pulumi.CustomResourceOptions): Endpoint;
/**
* Returns true if the given object is an instance of Endpoint. 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 Endpoint;
/**
* When the terminal type is a read-write terminal or a read-only terminal, support is provided for setting whether new nodes are automatically added. The values are:
* true: Automatically add.
* false: Do not automatically add (default).
*/
readonly autoAddNewNodes: pulumi.Output<boolean | undefined>;
/**
* The description of the endpoint.
*/
readonly description: pulumi.Output<string | undefined>;
/**
* Values:
* false: Volcano Engine private network resolution (default).
* true: Volcano Engine private and public network resolution.
*/
readonly dnsVisibility: pulumi.Output<boolean>;
/**
* Connection address, Please note that the connection address can only modify the prefix. In one call, it is not possible to modify both the connection address prefix and the port at the same time.
*/
readonly domain: pulumi.Output<string>;
/**
* The id of the endpoint. Import an exist endpoint, usually for import a default endpoint generated with instance creating.
*/
readonly endpointId: pulumi.Output<string>;
/**
* The name of the endpoint.
*/
readonly endpointName: pulumi.Output<string>;
/**
* The id of the mysql instance.
*/
readonly instanceId: pulumi.Output<string>;
/**
* List of node IDs configured for the endpoint. Required when EndpointType is Custom. To add a master node to the terminal, there is no need to fill in the master node ID, just fill in `Primary`.
*/
readonly nodes: pulumi.Output<string[]>;
/**
* The port. Cannot modify public network port. In one call, it is not possible to modify both the connection address prefix and the port at the same time.
*/
readonly port: pulumi.Output<number>;
/**
* Read weight distribution mode. This parameter needs to be passed in when the read-write separation setting is true. When used as a request parameter in the CreateDBEndpoint and ModifyDBEndpoint interfaces, the value range is as follows: LoadSchedule: Load scheduling. RoundRobinCustom: Polling scheduling with custom weights. RoundRobinAuto: Polling scheduling with automatically allocated weights.
*/
readonly readOnlyNodeDistributionType: pulumi.Output<string>;
/**
* The maximum delay threshold for read-only nodes, when the delay time of a read-only node exceeds this value, the read traffic will not be sent to that node, unit: seconds. Value range: 0~3600. Default value: 30.
*/
readonly readOnlyNodeMaxDelayTime: pulumi.Output<number>;
/**
* Customize read weight distribution, that is, pass in the read request weight of the master node and read-only nodes. It increases by 100 and the maximum value is 10000. When the ReadOnlyNodeDistributionType value is Custom, this parameter needs to be passed in.
*/
readonly readOnlyNodeWeights: pulumi.Output<outputs.rds_mysql.EndpointReadOnlyNodeWeight[]>;
/**
* Reading and writing mode: ReadWrite, ReadOnly(Default).
*/
readonly readWriteMode: pulumi.Output<string | undefined>;
/**
* Whether to enable read-write splitting. Values: true: Yes. Default value. false: No.
*/
readonly readWriteSpliting: pulumi.Output<boolean>;
/**
* Create a Endpoint 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: EndpointArgs, opts?: pulumi.CustomResourceOptions);
}
/**
* Input properties used for looking up and filtering Endpoint resources.
*/
export interface EndpointState {
/**
* When the terminal type is a read-write terminal or a read-only terminal, support is provided for setting whether new nodes are automatically added. The values are:
* true: Automatically add.
* false: Do not automatically add (default).
*/
autoAddNewNodes?: pulumi.Input<boolean>;
/**
* The description of the endpoint.
*/
description?: pulumi.Input<string>;
/**
* Values:
* false: Volcano Engine private network resolution (default).
* true: Volcano Engine private and public network resolution.
*/
dnsVisibility?: pulumi.Input<boolean>;
/**
* Connection address, Please note that the connection address can only modify the prefix. In one call, it is not possible to modify both the connection address prefix and the port at the same time.
*/
domain?: pulumi.Input<string>;
/**
* The id of the endpoint. Import an exist endpoint, usually for import a default endpoint generated with instance creating.
*/
endpointId?: pulumi.Input<string>;
/**
* The name of the endpoint.
*/
endpointName?: pulumi.Input<string>;
/**
* The id of the mysql instance.
*/
instanceId?: pulumi.Input<string>;
/**
* List of node IDs configured for the endpoint. Required when EndpointType is Custom. To add a master node to the terminal, there is no need to fill in the master node ID, just fill in `Primary`.
*/
nodes?: pulumi.Input<pulumi.Input<string>[]>;
/**
* The port. Cannot modify public network port. In one call, it is not possible to modify both the connection address prefix and the port at the same time.
*/
port?: pulumi.Input<number>;
/**
* Read weight distribution mode. This parameter needs to be passed in when the read-write separation setting is true. When used as a request parameter in the CreateDBEndpoint and ModifyDBEndpoint interfaces, the value range is as follows: LoadSchedule: Load scheduling. RoundRobinCustom: Polling scheduling with custom weights. RoundRobinAuto: Polling scheduling with automatically allocated weights.
*/
readOnlyNodeDistributionType?: pulumi.Input<string>;
/**
* The maximum delay threshold for read-only nodes, when the delay time of a read-only node exceeds this value, the read traffic will not be sent to that node, unit: seconds. Value range: 0~3600. Default value: 30.
*/
readOnlyNodeMaxDelayTime?: pulumi.Input<number>;
/**
* Customize read weight distribution, that is, pass in the read request weight of the master node and read-only nodes. It increases by 100 and the maximum value is 10000. When the ReadOnlyNodeDistributionType value is Custom, this parameter needs to be passed in.
*/
readOnlyNodeWeights?: pulumi.Input<pulumi.Input<inputs.rds_mysql.EndpointReadOnlyNodeWeight>[]>;
/**
* Reading and writing mode: ReadWrite, ReadOnly(Default).
*/
readWriteMode?: pulumi.Input<string>;
/**
* Whether to enable read-write splitting. Values: true: Yes. Default value. false: No.
*/
readWriteSpliting?: pulumi.Input<boolean>;
}
/**
* The set of arguments for constructing a Endpoint resource.
*/
export interface EndpointArgs {
/**
* When the terminal type is a read-write terminal or a read-only terminal, support is provided for setting whether new nodes are automatically added. The values are:
* true: Automatically add.
* false: Do not automatically add (default).
*/
autoAddNewNodes?: pulumi.Input<boolean>;
/**
* The description of the endpoint.
*/
description?: pulumi.Input<string>;
/**
* Values:
* false: Volcano Engine private network resolution (default).
* true: Volcano Engine private and public network resolution.
*/
dnsVisibility?: pulumi.Input<boolean>;
/**
* Connection address, Please note that the connection address can only modify the prefix. In one call, it is not possible to modify both the connection address prefix and the port at the same time.
*/
domain?: pulumi.Input<string>;
/**
* The id of the endpoint. Import an exist endpoint, usually for import a default endpoint generated with instance creating.
*/
endpointId?: pulumi.Input<string>;
/**
* The name of the endpoint.
*/
endpointName?: pulumi.Input<string>;
/**
* The id of the mysql instance.
*/
instanceId: pulumi.Input<string>;
/**
* List of node IDs configured for the endpoint. Required when EndpointType is Custom. To add a master node to the terminal, there is no need to fill in the master node ID, just fill in `Primary`.
*/
nodes: pulumi.Input<pulumi.Input<string>[]>;
/**
* The port. Cannot modify public network port. In one call, it is not possible to modify both the connection address prefix and the port at the same time.
*/
port?: pulumi.Input<number>;
/**
* Read weight distribution mode. This parameter needs to be passed in when the read-write separation setting is true. When used as a request parameter in the CreateDBEndpoint and ModifyDBEndpoint interfaces, the value range is as follows: LoadSchedule: Load scheduling. RoundRobinCustom: Polling scheduling with custom weights. RoundRobinAuto: Polling scheduling with automatically allocated weights.
*/
readOnlyNodeDistributionType?: pulumi.Input<string>;
/**
* The maximum delay threshold for read-only nodes, when the delay time of a read-only node exceeds this value, the read traffic will not be sent to that node, unit: seconds. Value range: 0~3600. Default value: 30.
*/
readOnlyNodeMaxDelayTime?: pulumi.Input<number>;
/**
* Customize read weight distribution, that is, pass in the read request weight of the master node and read-only nodes. It increases by 100 and the maximum value is 10000. When the ReadOnlyNodeDistributionType value is Custom, this parameter needs to be passed in.
*/
readOnlyNodeWeights?: pulumi.Input<pulumi.Input<inputs.rds_mysql.EndpointReadOnlyNodeWeight>[]>;
/**
* Reading and writing mode: ReadWrite, ReadOnly(Default).
*/
readWriteMode?: pulumi.Input<string>;
/**
* Whether to enable read-write splitting. Values: true: Yes. Default value. false: No.
*/
readWriteSpliting?: pulumi.Input<boolean>;
}