@volcengine/pulumi
Version:
A Pulumi package for creating and managing volcengine cloud resources.
336 lines (335 loc) • 11.5 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 alb rule
* ## Example Usage
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as volcengine from "@volcengine/pulumi";
*
* // Basic edition
* const foo = new volcengine.alb.Rule("foo", {
* description: "test",
* domain: "www.test.com",
* listenerId: "lsn-1iidd19u4oni874adhezjkyj3",
* redirectConfig: {
* redirectDomain: "www.testtest.com",
* redirectHttpCode: "302",
* redirectPort: "555",
* redirectUri: "/testtest",
* },
* rewriteConfig: {
* rewritePath: "/test",
* },
* rewriteEnabled: "off",
* ruleAction: "Redirect",
* serverGroupId: "rsp-1g72w74y4umf42zbhq4k4hnln",
* trafficLimitEnabled: "off",
* trafficLimitQps: 100,
* url: "/test",
* });
* // Standard edition
* const example = new volcengine.alb.Rule("example", {
* description: "standard edition alb rule",
* listenerId: "lsn-bddjp5fcof0g8dv40naga1yd",
* priority: 1,
* ruleAction: "",
* ruleActions: [{
* forwardGroupConfig: {
* serverGroupStickySession: {
* enabled: "off",
* },
* serverGroupTuples: [{
* serverGroupId: "rsp-bdd1lpcbvv288dv40ov1sye0",
* weight: 50,
* }],
* },
* type: "ForwardGroup",
* }],
* ruleConditions: [
* {
* hostConfig: {
* values: ["www.example.com"],
* },
* type: "Host",
* },
* {
* pathConfig: {
* values: ["/app/*"],
* },
* type: "Path",
* },
* ],
* url: "",
* });
* ```
*
* ## Import
*
* AlbRule can be imported using the listener id and rule id, e.g.
*
* ```sh
* $ pulumi import volcengine:alb/rule:Rule default lsn-273yv0mhs5xj47fap8sehiiso:rule-****
* ```
*/
export declare class Rule extends pulumi.CustomResource {
/**
* Get an existing Rule 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?: RuleState, opts?: pulumi.CustomResourceOptions): Rule;
/**
* Returns true if the given object is an instance of Rule. 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 Rule;
/**
* The description of the Rule.
*/
readonly description: pulumi.Output<string | undefined>;
/**
* The domain of Rule.
*/
readonly domain: pulumi.Output<string>;
/**
* The ID of listener.
*/
readonly listenerId: pulumi.Output<string>;
/**
* The priority of the Rule.Only the standard version is supported.
*/
readonly priority: pulumi.Output<number>;
/**
* The redirect related configuration.
*/
readonly redirectConfig: pulumi.Output<outputs.alb.RuleRedirectConfig | undefined>;
/**
* The list of rewrite configurations.
*/
readonly rewriteConfig: pulumi.Output<outputs.alb.RuleRewriteConfig | undefined>;
/**
* Rewrite configuration switch for forwarding rules, only allows configuration and takes effect when RuleAction is empty (i.e., forwarding to server group). Only available for whitelist users, please submit an application to experience. Supported values are as follows:
* on: enable.
* off: disable.
*/
readonly rewriteEnabled: pulumi.Output<string | undefined>;
/**
* The forwarding rule action, if this parameter is empty(`""`), forward to server group, if value is `Redirect`, will redirect.
*/
readonly ruleAction: pulumi.Output<string>;
/**
* The rule actions for standard edition forwarding rules.
*/
readonly ruleActions: pulumi.Output<outputs.alb.RuleRuleAction[]>;
/**
* The rule conditions for standard edition forwarding rules.
*/
readonly ruleConditions: pulumi.Output<outputs.alb.RuleRuleCondition[]>;
/**
* The ID of rule.
*/
readonly ruleId: pulumi.Output<string>;
/**
* Server group ID, this parameter is required if `ruleAction` is empty.
*/
readonly serverGroupId: pulumi.Output<string | undefined>;
/**
* Weight forwarded to the corresponding backend server group.
*/
readonly serverGroupTuples: pulumi.Output<outputs.alb.RuleServerGroupTuple[]>;
/**
* Whether to enable group session stickiness. Valid values are 'on' and 'off'.
*/
readonly stickySessionEnabled: pulumi.Output<string>;
/**
* The group session stickiness timeout, in seconds.
*/
readonly stickySessionTimeout: pulumi.Output<number>;
/**
* Forwarding rule QPS rate limiting switch:
* on: enable.
* off: disable (default).
*/
readonly trafficLimitEnabled: pulumi.Output<string | undefined>;
/**
* When Rules.N.TrafficLimitEnabled is turned on, this field is required. Requests per second. Valid values are between 100 and 100000.
*/
readonly trafficLimitQps: pulumi.Output<number | undefined>;
/**
* The Url of Rule.
*/
readonly url: pulumi.Output<string>;
/**
* Create a Rule 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: RuleArgs, opts?: pulumi.CustomResourceOptions);
}
/**
* Input properties used for looking up and filtering Rule resources.
*/
export interface RuleState {
/**
* The description of the Rule.
*/
description?: pulumi.Input<string>;
/**
* The domain of Rule.
*/
domain?: pulumi.Input<string>;
/**
* The ID of listener.
*/
listenerId?: pulumi.Input<string>;
/**
* The priority of the Rule.Only the standard version is supported.
*/
priority?: pulumi.Input<number>;
/**
* The redirect related configuration.
*/
redirectConfig?: pulumi.Input<inputs.alb.RuleRedirectConfig>;
/**
* The list of rewrite configurations.
*/
rewriteConfig?: pulumi.Input<inputs.alb.RuleRewriteConfig>;
/**
* Rewrite configuration switch for forwarding rules, only allows configuration and takes effect when RuleAction is empty (i.e., forwarding to server group). Only available for whitelist users, please submit an application to experience. Supported values are as follows:
* on: enable.
* off: disable.
*/
rewriteEnabled?: pulumi.Input<string>;
/**
* The forwarding rule action, if this parameter is empty(`""`), forward to server group, if value is `Redirect`, will redirect.
*/
ruleAction?: pulumi.Input<string>;
/**
* The rule actions for standard edition forwarding rules.
*/
ruleActions?: pulumi.Input<pulumi.Input<inputs.alb.RuleRuleAction>[]>;
/**
* The rule conditions for standard edition forwarding rules.
*/
ruleConditions?: pulumi.Input<pulumi.Input<inputs.alb.RuleRuleCondition>[]>;
/**
* The ID of rule.
*/
ruleId?: pulumi.Input<string>;
/**
* Server group ID, this parameter is required if `ruleAction` is empty.
*/
serverGroupId?: pulumi.Input<string>;
/**
* Weight forwarded to the corresponding backend server group.
*/
serverGroupTuples?: pulumi.Input<pulumi.Input<inputs.alb.RuleServerGroupTuple>[]>;
/**
* Whether to enable group session stickiness. Valid values are 'on' and 'off'.
*/
stickySessionEnabled?: pulumi.Input<string>;
/**
* The group session stickiness timeout, in seconds.
*/
stickySessionTimeout?: pulumi.Input<number>;
/**
* Forwarding rule QPS rate limiting switch:
* on: enable.
* off: disable (default).
*/
trafficLimitEnabled?: pulumi.Input<string>;
/**
* When Rules.N.TrafficLimitEnabled is turned on, this field is required. Requests per second. Valid values are between 100 and 100000.
*/
trafficLimitQps?: pulumi.Input<number>;
/**
* The Url of Rule.
*/
url?: pulumi.Input<string>;
}
/**
* The set of arguments for constructing a Rule resource.
*/
export interface RuleArgs {
/**
* The description of the Rule.
*/
description?: pulumi.Input<string>;
/**
* The domain of Rule.
*/
domain?: pulumi.Input<string>;
/**
* The ID of listener.
*/
listenerId: pulumi.Input<string>;
/**
* The priority of the Rule.Only the standard version is supported.
*/
priority?: pulumi.Input<number>;
/**
* The redirect related configuration.
*/
redirectConfig?: pulumi.Input<inputs.alb.RuleRedirectConfig>;
/**
* The list of rewrite configurations.
*/
rewriteConfig?: pulumi.Input<inputs.alb.RuleRewriteConfig>;
/**
* Rewrite configuration switch for forwarding rules, only allows configuration and takes effect when RuleAction is empty (i.e., forwarding to server group). Only available for whitelist users, please submit an application to experience. Supported values are as follows:
* on: enable.
* off: disable.
*/
rewriteEnabled?: pulumi.Input<string>;
/**
* The forwarding rule action, if this parameter is empty(`""`), forward to server group, if value is `Redirect`, will redirect.
*/
ruleAction: pulumi.Input<string>;
/**
* The rule actions for standard edition forwarding rules.
*/
ruleActions?: pulumi.Input<pulumi.Input<inputs.alb.RuleRuleAction>[]>;
/**
* The rule conditions for standard edition forwarding rules.
*/
ruleConditions?: pulumi.Input<pulumi.Input<inputs.alb.RuleRuleCondition>[]>;
/**
* Server group ID, this parameter is required if `ruleAction` is empty.
*/
serverGroupId?: pulumi.Input<string>;
/**
* Weight forwarded to the corresponding backend server group.
*/
serverGroupTuples?: pulumi.Input<pulumi.Input<inputs.alb.RuleServerGroupTuple>[]>;
/**
* Whether to enable group session stickiness. Valid values are 'on' and 'off'.
*/
stickySessionEnabled?: pulumi.Input<string>;
/**
* The group session stickiness timeout, in seconds.
*/
stickySessionTimeout?: pulumi.Input<number>;
/**
* Forwarding rule QPS rate limiting switch:
* on: enable.
* off: disable (default).
*/
trafficLimitEnabled?: pulumi.Input<string>;
/**
* When Rules.N.TrafficLimitEnabled is turned on, this field is required. Requests per second. Valid values are between 100 and 100000.
*/
trafficLimitQps?: pulumi.Input<number>;
/**
* The Url of Rule.
*/
url?: pulumi.Input<string>;
}