1. Packages
  2. Packages
  3. Volcenginecc Provider
  4. API Docs
  5. gtm
  6. Rule
Viewing docs for volcenginecc v0.0.43
published on Monday, Jun 15, 2026 by Volcengine
volcenginecc logo
Viewing docs for volcenginecc v0.0.43
published on Monday, Jun 15, 2026 by Volcengine

    GTM routing rule resource, which defines the address pool set, health checks, and effective policies for a specific line.

    Example Usage

    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    resources:
      gTMRuleDemo:
        type: volcenginecc:gtm:Rule
        name: GTMRuleDemo
        properties:
          disable: false
          effectivePoolSetIndex: 0
          gtmId: gtm_id_xxxxx
          line: default
          name: Protocol-https
          policyType: policy_type_xxxxx
          poolSetMode: manual
          poolSets:
            - name: 主地址池集
              active_addr_thr: 1
              pools:
                - poolId: pool_id_xxxxx
                  weight: 1
          probe:
            advised_node_count: 8
            disable: false
            failed_count: 3
            protocol: https
            port: 443
            url: /content/pages
            host: www.example.com
            http_method: GET
            http_usability_codes:
              - operator: interval
                codes:
                  - 100
                  - 200
            ping_count: 0
            ping_loss_percent: 0
            interval: 60
            is_manual_nodes: false
            nodes:
              - China-North lq Bytedance
              - China-North lf Bytedance
              - China-North hl Bytedance
            timeout: 5
          remark: test for create
          useRuleProbeConfig: true
          usePolicyProbeNodes: false
          weight: 1
    
    Example coming soon!
    

    Create Rule Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Rule(name: string, args: RuleArgs, opts?: CustomResourceOptions);
    @overload
    def Rule(resource_name: str,
             args: RuleArgs,
             opts: Optional[ResourceOptions] = None)
    
    @overload
    def Rule(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             name: Optional[str] = None,
             policy_type: Optional[str] = None,
             gtm_id: Optional[str] = None,
             pool_set_mode: Optional[str] = None,
             line: Optional[str] = None,
             effective_pool_set_index: Optional[int] = None,
             disable: Optional[bool] = None,
             pool_sets: Optional[Sequence[RulePoolSetArgs]] = None,
             probe: Optional[RuleProbeArgs] = None,
             remark: Optional[str] = None,
             use_policy_probe_nodes: Optional[bool] = None,
             use_rule_probe_config: Optional[bool] = None,
             weight: Optional[int] = None)
    func NewRule(ctx *Context, name string, args RuleArgs, opts ...ResourceOption) (*Rule, error)
    public Rule(string name, RuleArgs args, CustomResourceOptions? opts = null)
    public Rule(String name, RuleArgs args)
    public Rule(String name, RuleArgs args, CustomResourceOptions options)
    
    type: volcenginecc:gtm:Rule
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "volcenginecc_gtm_rule" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args RuleArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args RuleArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args RuleArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args RuleArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args RuleArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var exampleruleResourceResourceFromGtmrule = new Volcenginecc.Gtm.Rule("exampleruleResourceResourceFromGtmrule", new()
    {
        Name = "string",
        PolicyType = "string",
        GtmId = "string",
        PoolSetMode = "string",
        Line = "string",
        EffectivePoolSetIndex = 0,
        Disable = false,
        PoolSets = new[]
        {
            new Volcenginecc.Gtm.Inputs.RulePoolSetArgs
            {
                ActiveAddrThr = 0,
                Name = "string",
                Pools = new[]
                {
                    new Volcenginecc.Gtm.Inputs.RulePoolSetPoolArgs
                    {
                        Addresses = new[]
                        {
                            new Volcenginecc.Gtm.Inputs.RulePoolSetPoolAddressArgs
                            {
                                Active = false,
                                Capacity = 0,
                                Geo = "string",
                                Latency = 0,
                                Mode = "string",
                                RectifiedGeos = new[]
                                {
                                    "string",
                                },
                                Value = "string",
                                Weight = 0,
                            },
                        },
                        InactiveAddrCount = 0,
                        Name = "string",
                        PoolId = "string",
                        Weight = 0,
                    },
                },
            },
        },
        Probe = new Volcenginecc.Gtm.Inputs.RuleProbeArgs
        {
            AdvisedNodeCount = 0,
            Disable = false,
            FailedCount = 0,
            Host = "string",
            HttpMethod = "string",
            HttpUsabilityCodes = new[]
            {
                new Volcenginecc.Gtm.Inputs.RuleProbeHttpUsabilityCodeArgs
                {
                    Codes = new[]
                    {
                        0,
                    },
                    Operator = "string",
                },
            },
            Interval = 0,
            IsManualNodes = false,
            Nodes = new[]
            {
                "string",
            },
            PingCount = 0,
            PingLossPercent = 0,
            Port = 0,
            Protocol = "string",
            Timeout = 0,
            Url = "string",
        },
        Remark = "string",
        UsePolicyProbeNodes = false,
        UseRuleProbeConfig = false,
        Weight = 0,
    });
    
    example, err := gtm.NewRule(ctx, "exampleruleResourceResourceFromGtmrule", &gtm.RuleArgs{
    	Name:                  pulumi.String("string"),
    	PolicyType:            pulumi.String("string"),
    	GtmId:                 pulumi.String("string"),
    	PoolSetMode:           pulumi.String("string"),
    	Line:                  pulumi.String("string"),
    	EffectivePoolSetIndex: pulumi.Int(0),
    	Disable:               pulumi.Bool(false),
    	PoolSets: gtm.RulePoolSetArray{
    		&gtm.RulePoolSetArgs{
    			ActiveAddrThr: pulumi.Int(0),
    			Name:          pulumi.String("string"),
    			Pools: gtm.RulePoolSetPoolArray{
    				&gtm.RulePoolSetPoolArgs{
    					Addresses: gtm.RulePoolSetPoolAddressArray{
    						&gtm.RulePoolSetPoolAddressArgs{
    							Active:   pulumi.Bool(false),
    							Capacity: pulumi.Int(0),
    							Geo:      pulumi.String("string"),
    							Latency:  pulumi.Int(0),
    							Mode:     pulumi.String("string"),
    							RectifiedGeos: pulumi.StringArray{
    								pulumi.String("string"),
    							},
    							Value:  pulumi.String("string"),
    							Weight: pulumi.Int(0),
    						},
    					},
    					InactiveAddrCount: pulumi.Int(0),
    					Name:              pulumi.String("string"),
    					PoolId:            pulumi.String("string"),
    					Weight:            pulumi.Int(0),
    				},
    			},
    		},
    	},
    	Probe: &gtm.RuleProbeArgs{
    		AdvisedNodeCount: pulumi.Int(0),
    		Disable:          pulumi.Bool(false),
    		FailedCount:      pulumi.Int(0),
    		Host:             pulumi.String("string"),
    		HttpMethod:       pulumi.String("string"),
    		HttpUsabilityCodes: gtm.RuleProbeHttpUsabilityCodeArray{
    			&gtm.RuleProbeHttpUsabilityCodeArgs{
    				Codes: pulumi.IntArray{
    					pulumi.Int(0),
    				},
    				Operator: pulumi.String("string"),
    			},
    		},
    		Interval:      pulumi.Int(0),
    		IsManualNodes: pulumi.Bool(false),
    		Nodes: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    		PingCount:       pulumi.Int(0),
    		PingLossPercent: pulumi.Int(0),
    		Port:            pulumi.Int(0),
    		Protocol:        pulumi.String("string"),
    		Timeout:         pulumi.Int(0),
    		Url:             pulumi.String("string"),
    	},
    	Remark:              pulumi.String("string"),
    	UsePolicyProbeNodes: pulumi.Bool(false),
    	UseRuleProbeConfig:  pulumi.Bool(false),
    	Weight:              pulumi.Int(0),
    })
    
    resource "volcenginecc_gtm_rule" "exampleruleResourceResourceFromGtmrule" {
      name                     = "string"
      policy_type              = "string"
      gtm_id                   = "string"
      pool_set_mode            = "string"
      line                     = "string"
      effective_pool_set_index = 0
      disable                  = false
      pool_sets {
        active_addr_thr = 0
        name            = "string"
        pools {
          addresses {
            active         = false
            capacity       = 0
            geo            = "string"
            latency        = 0
            mode           = "string"
            rectified_geos = ["string"]
            value          = "string"
            weight         = 0
          }
          inactive_addr_count = 0
          name                = "string"
          pool_id             = "string"
          weight              = 0
        }
      }
      probe = {
        advised_node_count = 0
        disable            = false
        failed_count       = 0
        host               = "string"
        http_method        = "string"
        http_usability_codes = [{
          "codes"    = [0]
          "operator" = "string"
        }]
        interval          = 0
        is_manual_nodes   = false
        nodes             = ["string"]
        ping_count        = 0
        ping_loss_percent = 0
        port              = 0
        protocol          = "string"
        timeout           = 0
        url               = "string"
      }
      remark                 = "string"
      use_policy_probe_nodes = false
      use_rule_probe_config  = false
      weight                 = 0
    }
    
    var exampleruleResourceResourceFromGtmrule = new com.volcengine.volcenginecc.gtm.Rule("exampleruleResourceResourceFromGtmrule", com.volcengine.volcenginecc.gtm.RuleArgs.builder()
        .name("string")
        .policyType("string")
        .gtmId("string")
        .poolSetMode("string")
        .line("string")
        .effectivePoolSetIndex(0)
        .disable(false)
        .poolSets(RulePoolSetArgs.builder()
            .activeAddrThr(0)
            .name("string")
            .pools(RulePoolSetPoolArgs.builder()
                .addresses(RulePoolSetPoolAddressArgs.builder()
                    .active(false)
                    .capacity(0)
                    .geo("string")
                    .latency(0)
                    .mode("string")
                    .rectifiedGeos("string")
                    .value("string")
                    .weight(0)
                    .build())
                .inactiveAddrCount(0)
                .name("string")
                .poolId("string")
                .weight(0)
                .build())
            .build())
        .probe(RuleProbeArgs.builder()
            .advisedNodeCount(0)
            .disable(false)
            .failedCount(0)
            .host("string")
            .httpMethod("string")
            .httpUsabilityCodes(RuleProbeHttpUsabilityCodeArgs.builder()
                .codes(0)
                .operator("string")
                .build())
            .interval(0)
            .isManualNodes(false)
            .nodes("string")
            .pingCount(0)
            .pingLossPercent(0)
            .port(0)
            .protocol("string")
            .timeout(0)
            .url("string")
            .build())
        .remark("string")
        .usePolicyProbeNodes(false)
        .useRuleProbeConfig(false)
        .weight(0)
        .build());
    
    examplerule_resource_resource_from_gtmrule = volcenginecc.gtm.Rule("exampleruleResourceResourceFromGtmrule",
        name="string",
        policy_type="string",
        gtm_id="string",
        pool_set_mode="string",
        line="string",
        effective_pool_set_index=0,
        disable=False,
        pool_sets=[{
            "active_addr_thr": 0,
            "name": "string",
            "pools": [{
                "addresses": [{
                    "active": False,
                    "capacity": 0,
                    "geo": "string",
                    "latency": 0,
                    "mode": "string",
                    "rectified_geos": ["string"],
                    "value": "string",
                    "weight": 0,
                }],
                "inactive_addr_count": 0,
                "name": "string",
                "pool_id": "string",
                "weight": 0,
            }],
        }],
        probe={
            "advised_node_count": 0,
            "disable": False,
            "failed_count": 0,
            "host": "string",
            "http_method": "string",
            "http_usability_codes": [{
                "codes": [0],
                "operator": "string",
            }],
            "interval": 0,
            "is_manual_nodes": False,
            "nodes": ["string"],
            "ping_count": 0,
            "ping_loss_percent": 0,
            "port": 0,
            "protocol": "string",
            "timeout": 0,
            "url": "string",
        },
        remark="string",
        use_policy_probe_nodes=False,
        use_rule_probe_config=False,
        weight=0)
    
    const exampleruleResourceResourceFromGtmrule = new volcenginecc.gtm.Rule("exampleruleResourceResourceFromGtmrule", {
        name: "string",
        policyType: "string",
        gtmId: "string",
        poolSetMode: "string",
        line: "string",
        effectivePoolSetIndex: 0,
        disable: false,
        poolSets: [{
            activeAddrThr: 0,
            name: "string",
            pools: [{
                addresses: [{
                    active: false,
                    capacity: 0,
                    geo: "string",
                    latency: 0,
                    mode: "string",
                    rectifiedGeos: ["string"],
                    value: "string",
                    weight: 0,
                }],
                inactiveAddrCount: 0,
                name: "string",
                poolId: "string",
                weight: 0,
            }],
        }],
        probe: {
            advisedNodeCount: 0,
            disable: false,
            failedCount: 0,
            host: "string",
            httpMethod: "string",
            httpUsabilityCodes: [{
                codes: [0],
                operator: "string",
            }],
            interval: 0,
            isManualNodes: false,
            nodes: ["string"],
            pingCount: 0,
            pingLossPercent: 0,
            port: 0,
            protocol: "string",
            timeout: 0,
            url: "string",
        },
        remark: "string",
        usePolicyProbeNodes: false,
        useRuleProbeConfig: false,
        weight: 0,
    });
    
    type: volcenginecc:gtm:Rule
    properties:
        disable: false
        effectivePoolSetIndex: 0
        gtmId: string
        line: string
        name: string
        policyType: string
        poolSetMode: string
        poolSets:
            - activeAddrThr: 0
              name: string
              pools:
                - addresses:
                    - active: false
                      capacity: 0
                      geo: string
                      latency: 0
                      mode: string
                      rectifiedGeos:
                        - string
                      value: string
                      weight: 0
                  inactiveAddrCount: 0
                  name: string
                  poolId: string
                  weight: 0
        probe:
            advisedNodeCount: 0
            disable: false
            failedCount: 0
            host: string
            httpMethod: string
            httpUsabilityCodes:
                - codes:
                    - 0
                  operator: string
            interval: 0
            isManualNodes: false
            nodes:
                - string
            pingCount: 0
            pingLossPercent: 0
            port: 0
            protocol: string
            timeout: 0
            url: string
        remark: string
        usePolicyProbeNodes: false
        useRuleProbeConfig: false
        weight: 0
    

    Rule Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Rule resource accepts the following input properties:

    GtmId string
    UUID of the GTM instance.
    Name string
    Route rule name.
    PolicyType string
    The policy type corresponding to the routing rule. geo: basic routing. perf: intelligent routing.
    Disable bool
    Whether this route rule is disabled. true: The route rule is disabled. false: The route rule is enabled.
    EffectivePoolSetIndex int
    Index of the effective address pool set.
    Line string
    Route rule applicable lines.
    PoolSetMode string
    Address pool set effective mode. auto: Automatically sets the effective address pool set. The highest-priority available address pool becomes effective automatically. If all address pools are unavailable, the highest-priority address pool becomes effective. manual: Manually sets the effective address pool set. In this mode, you need to set the index of the effective address pool set in the EffectivePoolSetIndex parameter.
    PoolSets List<Volcengine.RulePoolSet>
    Probe Volcengine.RuleProbe
    Health check parameters for the route rule.
    Remark string
    Route rule remarks.
    UsePolicyProbeNodes bool
    Whether to inherit instance-level health check nodes.
    UseRuleProbeConfig bool
    Whether to use route rule-level probe configuration.
    Weight int
    Routing rule weight.
    GtmId string
    UUID of the GTM instance.
    Name string
    Route rule name.
    PolicyType string
    The policy type corresponding to the routing rule. geo: basic routing. perf: intelligent routing.
    Disable bool
    Whether this route rule is disabled. true: The route rule is disabled. false: The route rule is enabled.
    EffectivePoolSetIndex int
    Index of the effective address pool set.
    Line string
    Route rule applicable lines.
    PoolSetMode string
    Address pool set effective mode. auto: Automatically sets the effective address pool set. The highest-priority available address pool becomes effective automatically. If all address pools are unavailable, the highest-priority address pool becomes effective. manual: Manually sets the effective address pool set. In this mode, you need to set the index of the effective address pool set in the EffectivePoolSetIndex parameter.
    PoolSets []RulePoolSetArgs
    Probe RuleProbeArgs
    Health check parameters for the route rule.
    Remark string
    Route rule remarks.
    UsePolicyProbeNodes bool
    Whether to inherit instance-level health check nodes.
    UseRuleProbeConfig bool
    Whether to use route rule-level probe configuration.
    Weight int
    Routing rule weight.
    gtm_id string
    UUID of the GTM instance.
    name string
    Route rule name.
    policy_type string
    The policy type corresponding to the routing rule. geo: basic routing. perf: intelligent routing.
    disable bool
    Whether this route rule is disabled. true: The route rule is disabled. false: The route rule is enabled.
    effective_pool_set_index number
    Index of the effective address pool set.
    line string
    Route rule applicable lines.
    pool_set_mode string
    Address pool set effective mode. auto: Automatically sets the effective address pool set. The highest-priority available address pool becomes effective automatically. If all address pools are unavailable, the highest-priority address pool becomes effective. manual: Manually sets the effective address pool set. In this mode, you need to set the index of the effective address pool set in the EffectivePoolSetIndex parameter.
    pool_sets list(object)
    probe object
    Health check parameters for the route rule.
    remark string
    Route rule remarks.
    use_policy_probe_nodes bool
    Whether to inherit instance-level health check nodes.
    use_rule_probe_config bool
    Whether to use route rule-level probe configuration.
    weight number
    Routing rule weight.
    gtmId String
    UUID of the GTM instance.
    name String
    Route rule name.
    policyType String
    The policy type corresponding to the routing rule. geo: basic routing. perf: intelligent routing.
    disable Boolean
    Whether this route rule is disabled. true: The route rule is disabled. false: The route rule is enabled.
    effectivePoolSetIndex Integer
    Index of the effective address pool set.
    line String
    Route rule applicable lines.
    poolSetMode String
    Address pool set effective mode. auto: Automatically sets the effective address pool set. The highest-priority available address pool becomes effective automatically. If all address pools are unavailable, the highest-priority address pool becomes effective. manual: Manually sets the effective address pool set. In this mode, you need to set the index of the effective address pool set in the EffectivePoolSetIndex parameter.
    poolSets List<RulePoolSet>
    probe RuleProbe
    Health check parameters for the route rule.
    remark String
    Route rule remarks.
    usePolicyProbeNodes Boolean
    Whether to inherit instance-level health check nodes.
    useRuleProbeConfig Boolean
    Whether to use route rule-level probe configuration.
    weight Integer
    Routing rule weight.
    gtmId string
    UUID of the GTM instance.
    name string
    Route rule name.
    policyType string
    The policy type corresponding to the routing rule. geo: basic routing. perf: intelligent routing.
    disable boolean
    Whether this route rule is disabled. true: The route rule is disabled. false: The route rule is enabled.
    effectivePoolSetIndex number
    Index of the effective address pool set.
    line string
    Route rule applicable lines.
    poolSetMode string
    Address pool set effective mode. auto: Automatically sets the effective address pool set. The highest-priority available address pool becomes effective automatically. If all address pools are unavailable, the highest-priority address pool becomes effective. manual: Manually sets the effective address pool set. In this mode, you need to set the index of the effective address pool set in the EffectivePoolSetIndex parameter.
    poolSets RulePoolSet[]
    probe RuleProbe
    Health check parameters for the route rule.
    remark string
    Route rule remarks.
    usePolicyProbeNodes boolean
    Whether to inherit instance-level health check nodes.
    useRuleProbeConfig boolean
    Whether to use route rule-level probe configuration.
    weight number
    Routing rule weight.
    gtm_id str
    UUID of the GTM instance.
    name str
    Route rule name.
    policy_type str
    The policy type corresponding to the routing rule. geo: basic routing. perf: intelligent routing.
    disable bool
    Whether this route rule is disabled. true: The route rule is disabled. false: The route rule is enabled.
    effective_pool_set_index int
    Index of the effective address pool set.
    line str
    Route rule applicable lines.
    pool_set_mode str
    Address pool set effective mode. auto: Automatically sets the effective address pool set. The highest-priority available address pool becomes effective automatically. If all address pools are unavailable, the highest-priority address pool becomes effective. manual: Manually sets the effective address pool set. In this mode, you need to set the index of the effective address pool set in the EffectivePoolSetIndex parameter.
    pool_sets Sequence[RulePoolSetArgs]
    probe RuleProbeArgs
    Health check parameters for the route rule.
    remark str
    Route rule remarks.
    use_policy_probe_nodes bool
    Whether to inherit instance-level health check nodes.
    use_rule_probe_config bool
    Whether to use route rule-level probe configuration.
    weight int
    Routing rule weight.
    gtmId String
    UUID of the GTM instance.
    name String
    Route rule name.
    policyType String
    The policy type corresponding to the routing rule. geo: basic routing. perf: intelligent routing.
    disable Boolean
    Whether this route rule is disabled. true: The route rule is disabled. false: The route rule is enabled.
    effectivePoolSetIndex Number
    Index of the effective address pool set.
    line String
    Route rule applicable lines.
    poolSetMode String
    Address pool set effective mode. auto: Automatically sets the effective address pool set. The highest-priority available address pool becomes effective automatically. If all address pools are unavailable, the highest-priority address pool becomes effective. manual: Manually sets the effective address pool set. In this mode, you need to set the index of the effective address pool set in the EffectivePoolSetIndex parameter.
    poolSets List<Property Map>
    probe Property Map
    Health check parameters for the route rule.
    remark String
    Route rule remarks.
    usePolicyProbeNodes Boolean
    Whether to inherit instance-level health check nodes.
    useRuleProbeConfig Boolean
    Whether to use route rule-level probe configuration.
    weight Number
    Routing rule weight.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Rule resource produces the following output properties:

    CreateTime string
    Route rule creation time.
    Id string
    The provider-assigned unique ID for this managed resource.
    ProbeMode string
    Health check mode.
    RuleId string
    Routing rule ID.
    UpdateTime string
    Route rule update time.
    CreateTime string
    Route rule creation time.
    Id string
    The provider-assigned unique ID for this managed resource.
    ProbeMode string
    Health check mode.
    RuleId string
    Routing rule ID.
    UpdateTime string
    Route rule update time.
    create_time string
    Route rule creation time.
    id string
    The provider-assigned unique ID for this managed resource.
    probe_mode string
    Health check mode.
    rule_id string
    Routing rule ID.
    update_time string
    Route rule update time.
    createTime String
    Route rule creation time.
    id String
    The provider-assigned unique ID for this managed resource.
    probeMode String
    Health check mode.
    ruleId String
    Routing rule ID.
    updateTime String
    Route rule update time.
    createTime string
    Route rule creation time.
    id string
    The provider-assigned unique ID for this managed resource.
    probeMode string
    Health check mode.
    ruleId string
    Routing rule ID.
    updateTime string
    Route rule update time.
    create_time str
    Route rule creation time.
    id str
    The provider-assigned unique ID for this managed resource.
    probe_mode str
    Health check mode.
    rule_id str
    Routing rule ID.
    update_time str
    Route rule update time.
    createTime String
    Route rule creation time.
    id String
    The provider-assigned unique ID for this managed resource.
    probeMode String
    Health check mode.
    ruleId String
    Routing rule ID.
    updateTime String
    Route rule update time.

    Look up Existing Rule Resource

    Get an existing Rule resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: RuleState, opts?: CustomResourceOptions): Rule
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            create_time: Optional[str] = None,
            disable: Optional[bool] = None,
            effective_pool_set_index: Optional[int] = None,
            gtm_id: Optional[str] = None,
            line: Optional[str] = None,
            name: Optional[str] = None,
            policy_type: Optional[str] = None,
            pool_set_mode: Optional[str] = None,
            pool_sets: Optional[Sequence[RulePoolSetArgs]] = None,
            probe: Optional[RuleProbeArgs] = None,
            probe_mode: Optional[str] = None,
            remark: Optional[str] = None,
            rule_id: Optional[str] = None,
            update_time: Optional[str] = None,
            use_policy_probe_nodes: Optional[bool] = None,
            use_rule_probe_config: Optional[bool] = None,
            weight: Optional[int] = None) -> Rule
    func GetRule(ctx *Context, name string, id IDInput, state *RuleState, opts ...ResourceOption) (*Rule, error)
    public static Rule Get(string name, Input<string> id, RuleState? state, CustomResourceOptions? opts = null)
    public static Rule get(String name, Output<String> id, RuleState state, CustomResourceOptions options)
    resources:  _:    type: volcenginecc:gtm:Rule    get:      id: ${id}
    import {
      to = volcenginecc_gtm_rule.example
      id = "${id}"
    }
    
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    CreateTime string
    Route rule creation time.
    Disable bool
    Whether this route rule is disabled. true: The route rule is disabled. false: The route rule is enabled.
    EffectivePoolSetIndex int
    Index of the effective address pool set.
    GtmId string
    UUID of the GTM instance.
    Line string
    Route rule applicable lines.
    Name string
    Route rule name.
    PolicyType string
    The policy type corresponding to the routing rule. geo: basic routing. perf: intelligent routing.
    PoolSetMode string
    Address pool set effective mode. auto: Automatically sets the effective address pool set. The highest-priority available address pool becomes effective automatically. If all address pools are unavailable, the highest-priority address pool becomes effective. manual: Manually sets the effective address pool set. In this mode, you need to set the index of the effective address pool set in the EffectivePoolSetIndex parameter.
    PoolSets List<Volcengine.RulePoolSet>
    Probe Volcengine.RuleProbe
    Health check parameters for the route rule.
    ProbeMode string
    Health check mode.
    Remark string
    Route rule remarks.
    RuleId string
    Routing rule ID.
    UpdateTime string
    Route rule update time.
    UsePolicyProbeNodes bool
    Whether to inherit instance-level health check nodes.
    UseRuleProbeConfig bool
    Whether to use route rule-level probe configuration.
    Weight int
    Routing rule weight.
    CreateTime string
    Route rule creation time.
    Disable bool
    Whether this route rule is disabled. true: The route rule is disabled. false: The route rule is enabled.
    EffectivePoolSetIndex int
    Index of the effective address pool set.
    GtmId string
    UUID of the GTM instance.
    Line string
    Route rule applicable lines.
    Name string
    Route rule name.
    PolicyType string
    The policy type corresponding to the routing rule. geo: basic routing. perf: intelligent routing.
    PoolSetMode string
    Address pool set effective mode. auto: Automatically sets the effective address pool set. The highest-priority available address pool becomes effective automatically. If all address pools are unavailable, the highest-priority address pool becomes effective. manual: Manually sets the effective address pool set. In this mode, you need to set the index of the effective address pool set in the EffectivePoolSetIndex parameter.
    PoolSets []RulePoolSetArgs
    Probe RuleProbeArgs
    Health check parameters for the route rule.
    ProbeMode string
    Health check mode.
    Remark string
    Route rule remarks.
    RuleId string
    Routing rule ID.
    UpdateTime string
    Route rule update time.
    UsePolicyProbeNodes bool
    Whether to inherit instance-level health check nodes.
    UseRuleProbeConfig bool
    Whether to use route rule-level probe configuration.
    Weight int
    Routing rule weight.
    create_time string
    Route rule creation time.
    disable bool
    Whether this route rule is disabled. true: The route rule is disabled. false: The route rule is enabled.
    effective_pool_set_index number
    Index of the effective address pool set.
    gtm_id string
    UUID of the GTM instance.
    line string
    Route rule applicable lines.
    name string
    Route rule name.
    policy_type string
    The policy type corresponding to the routing rule. geo: basic routing. perf: intelligent routing.
    pool_set_mode string
    Address pool set effective mode. auto: Automatically sets the effective address pool set. The highest-priority available address pool becomes effective automatically. If all address pools are unavailable, the highest-priority address pool becomes effective. manual: Manually sets the effective address pool set. In this mode, you need to set the index of the effective address pool set in the EffectivePoolSetIndex parameter.
    pool_sets list(object)
    probe object
    Health check parameters for the route rule.
    probe_mode string
    Health check mode.
    remark string
    Route rule remarks.
    rule_id string
    Routing rule ID.
    update_time string
    Route rule update time.
    use_policy_probe_nodes bool
    Whether to inherit instance-level health check nodes.
    use_rule_probe_config bool
    Whether to use route rule-level probe configuration.
    weight number
    Routing rule weight.
    createTime String
    Route rule creation time.
    disable Boolean
    Whether this route rule is disabled. true: The route rule is disabled. false: The route rule is enabled.
    effectivePoolSetIndex Integer
    Index of the effective address pool set.
    gtmId String
    UUID of the GTM instance.
    line String
    Route rule applicable lines.
    name String
    Route rule name.
    policyType String
    The policy type corresponding to the routing rule. geo: basic routing. perf: intelligent routing.
    poolSetMode String
    Address pool set effective mode. auto: Automatically sets the effective address pool set. The highest-priority available address pool becomes effective automatically. If all address pools are unavailable, the highest-priority address pool becomes effective. manual: Manually sets the effective address pool set. In this mode, you need to set the index of the effective address pool set in the EffectivePoolSetIndex parameter.
    poolSets List<RulePoolSet>
    probe RuleProbe
    Health check parameters for the route rule.
    probeMode String
    Health check mode.
    remark String
    Route rule remarks.
    ruleId String
    Routing rule ID.
    updateTime String
    Route rule update time.
    usePolicyProbeNodes Boolean
    Whether to inherit instance-level health check nodes.
    useRuleProbeConfig Boolean
    Whether to use route rule-level probe configuration.
    weight Integer
    Routing rule weight.
    createTime string
    Route rule creation time.
    disable boolean
    Whether this route rule is disabled. true: The route rule is disabled. false: The route rule is enabled.
    effectivePoolSetIndex number
    Index of the effective address pool set.
    gtmId string
    UUID of the GTM instance.
    line string
    Route rule applicable lines.
    name string
    Route rule name.
    policyType string
    The policy type corresponding to the routing rule. geo: basic routing. perf: intelligent routing.
    poolSetMode string
    Address pool set effective mode. auto: Automatically sets the effective address pool set. The highest-priority available address pool becomes effective automatically. If all address pools are unavailable, the highest-priority address pool becomes effective. manual: Manually sets the effective address pool set. In this mode, you need to set the index of the effective address pool set in the EffectivePoolSetIndex parameter.
    poolSets RulePoolSet[]
    probe RuleProbe
    Health check parameters for the route rule.
    probeMode string
    Health check mode.
    remark string
    Route rule remarks.
    ruleId string
    Routing rule ID.
    updateTime string
    Route rule update time.
    usePolicyProbeNodes boolean
    Whether to inherit instance-level health check nodes.
    useRuleProbeConfig boolean
    Whether to use route rule-level probe configuration.
    weight number
    Routing rule weight.
    create_time str
    Route rule creation time.
    disable bool
    Whether this route rule is disabled. true: The route rule is disabled. false: The route rule is enabled.
    effective_pool_set_index int
    Index of the effective address pool set.
    gtm_id str
    UUID of the GTM instance.
    line str
    Route rule applicable lines.
    name str
    Route rule name.
    policy_type str
    The policy type corresponding to the routing rule. geo: basic routing. perf: intelligent routing.
    pool_set_mode str
    Address pool set effective mode. auto: Automatically sets the effective address pool set. The highest-priority available address pool becomes effective automatically. If all address pools are unavailable, the highest-priority address pool becomes effective. manual: Manually sets the effective address pool set. In this mode, you need to set the index of the effective address pool set in the EffectivePoolSetIndex parameter.
    pool_sets Sequence[RulePoolSetArgs]
    probe RuleProbeArgs
    Health check parameters for the route rule.
    probe_mode str
    Health check mode.
    remark str
    Route rule remarks.
    rule_id str
    Routing rule ID.
    update_time str
    Route rule update time.
    use_policy_probe_nodes bool
    Whether to inherit instance-level health check nodes.
    use_rule_probe_config bool
    Whether to use route rule-level probe configuration.
    weight int
    Routing rule weight.
    createTime String
    Route rule creation time.
    disable Boolean
    Whether this route rule is disabled. true: The route rule is disabled. false: The route rule is enabled.
    effectivePoolSetIndex Number
    Index of the effective address pool set.
    gtmId String
    UUID of the GTM instance.
    line String
    Route rule applicable lines.
    name String
    Route rule name.
    policyType String
    The policy type corresponding to the routing rule. geo: basic routing. perf: intelligent routing.
    poolSetMode String
    Address pool set effective mode. auto: Automatically sets the effective address pool set. The highest-priority available address pool becomes effective automatically. If all address pools are unavailable, the highest-priority address pool becomes effective. manual: Manually sets the effective address pool set. In this mode, you need to set the index of the effective address pool set in the EffectivePoolSetIndex parameter.
    poolSets List<Property Map>
    probe Property Map
    Health check parameters for the route rule.
    probeMode String
    Health check mode.
    remark String
    Route rule remarks.
    ruleId String
    Routing rule ID.
    updateTime String
    Route rule update time.
    usePolicyProbeNodes Boolean
    Whether to inherit instance-level health check nodes.
    useRuleProbeConfig Boolean
    Whether to use route rule-level probe configuration.
    weight Number
    Routing rule weight.

    Supporting Types

    RulePoolSet, RulePoolSetArgs

    ActiveAddrThr int
    Minimum number of available addresses required for the address pool collection to be considered available.
    Name string
    Address pool name.
    Pools List<Volcengine.RulePoolSetPool>
    ActiveAddrThr int
    Minimum number of available addresses required for the address pool collection to be considered available.
    Name string
    Address pool name.
    Pools []RulePoolSetPool
    active_addr_thr number
    Minimum number of available addresses required for the address pool collection to be considered available.
    name string
    Address pool name.
    pools list(object)
    activeAddrThr Integer
    Minimum number of available addresses required for the address pool collection to be considered available.
    name String
    Address pool name.
    pools List<RulePoolSetPool>
    activeAddrThr number
    Minimum number of available addresses required for the address pool collection to be considered available.
    name string
    Address pool name.
    pools RulePoolSetPool[]
    active_addr_thr int
    Minimum number of available addresses required for the address pool collection to be considered available.
    name str
    Address pool name.
    pools Sequence[RulePoolSetPool]
    activeAddrThr Number
    Minimum number of available addresses required for the address pool collection to be considered available.
    name String
    Address pool name.
    pools List<Property Map>

    RulePoolSetPool, RulePoolSetPoolArgs

    Addresses List<Volcengine.RulePoolSetPoolAddress>
    InactiveAddrCount int
    The number of unavailable addresses in the address pool.
    Name string
    Address pool name.
    PoolId string
    Address pool ID.
    Weight int
    Address pool weight.
    Addresses []RulePoolSetPoolAddress
    InactiveAddrCount int
    The number of unavailable addresses in the address pool.
    Name string
    Address pool name.
    PoolId string
    Address pool ID.
    Weight int
    Address pool weight.
    addresses list(object)
    inactive_addr_count number
    The number of unavailable addresses in the address pool.
    name string
    Address pool name.
    pool_id string
    Address pool ID.
    weight number
    Address pool weight.
    addresses List<RulePoolSetPoolAddress>
    inactiveAddrCount Integer
    The number of unavailable addresses in the address pool.
    name String
    Address pool name.
    poolId String
    Address pool ID.
    weight Integer
    Address pool weight.
    addresses RulePoolSetPoolAddress[]
    inactiveAddrCount number
    The number of unavailable addresses in the address pool.
    name string
    Address pool name.
    poolId string
    Address pool ID.
    weight number
    Address pool weight.
    addresses Sequence[RulePoolSetPoolAddress]
    inactive_addr_count int
    The number of unavailable addresses in the address pool.
    name str
    Address pool name.
    pool_id str
    Address pool ID.
    weight int
    Address pool weight.
    addresses List<Property Map>
    inactiveAddrCount Number
    The number of unavailable addresses in the address pool.
    name String
    Address pool name.
    poolId String
    Address pool ID.
    weight Number
    Address pool weight.

    RulePoolSetPoolAddress, RulePoolSetPoolAddressArgs

    Active bool
    Whether the address is available. true: The address is available. false: The address is unavailable.
    Capacity int
    The capacity of the address. For addresses without a set capacity value, this parameter returns the default capacity value of 1000.
    Geo string
    This parameter has no practical significance. You can ignore this parameter.
    Latency int
    Latency (ms) for health check probe accessing the target address.
    Mode string
    The mechanism for determining whether an address is available. auto: automatic mode. Cloud Scheduling GTM determines address availability based on health check results. alwayson: address is always available. alwaysoff: address is always unavailable.
    RectifiedGeos List<string>
    The assigned region for the target address. See line codes for the mapping between line codes and specific regions (i.e., lines).
    Value string
    Address.
    Weight int
    Address weight. For addresses without a specified weight, this parameter returns the default weight value of 1.
    Active bool
    Whether the address is available. true: The address is available. false: The address is unavailable.
    Capacity int
    The capacity of the address. For addresses without a set capacity value, this parameter returns the default capacity value of 1000.
    Geo string
    This parameter has no practical significance. You can ignore this parameter.
    Latency int
    Latency (ms) for health check probe accessing the target address.
    Mode string
    The mechanism for determining whether an address is available. auto: automatic mode. Cloud Scheduling GTM determines address availability based on health check results. alwayson: address is always available. alwaysoff: address is always unavailable.
    RectifiedGeos []string
    The assigned region for the target address. See line codes for the mapping between line codes and specific regions (i.e., lines).
    Value string
    Address.
    Weight int
    Address weight. For addresses without a specified weight, this parameter returns the default weight value of 1.
    active bool
    Whether the address is available. true: The address is available. false: The address is unavailable.
    capacity number
    The capacity of the address. For addresses without a set capacity value, this parameter returns the default capacity value of 1000.
    geo string
    This parameter has no practical significance. You can ignore this parameter.
    latency number
    Latency (ms) for health check probe accessing the target address.
    mode string
    The mechanism for determining whether an address is available. auto: automatic mode. Cloud Scheduling GTM determines address availability based on health check results. alwayson: address is always available. alwaysoff: address is always unavailable.
    rectified_geos list(string)
    The assigned region for the target address. See line codes for the mapping between line codes and specific regions (i.e., lines).
    value string
    Address.
    weight number
    Address weight. For addresses without a specified weight, this parameter returns the default weight value of 1.
    active Boolean
    Whether the address is available. true: The address is available. false: The address is unavailable.
    capacity Integer
    The capacity of the address. For addresses without a set capacity value, this parameter returns the default capacity value of 1000.
    geo String
    This parameter has no practical significance. You can ignore this parameter.
    latency Integer
    Latency (ms) for health check probe accessing the target address.
    mode String
    The mechanism for determining whether an address is available. auto: automatic mode. Cloud Scheduling GTM determines address availability based on health check results. alwayson: address is always available. alwaysoff: address is always unavailable.
    rectifiedGeos List<String>
    The assigned region for the target address. See line codes for the mapping between line codes and specific regions (i.e., lines).
    value String
    Address.
    weight Integer
    Address weight. For addresses without a specified weight, this parameter returns the default weight value of 1.
    active boolean
    Whether the address is available. true: The address is available. false: The address is unavailable.
    capacity number
    The capacity of the address. For addresses without a set capacity value, this parameter returns the default capacity value of 1000.
    geo string
    This parameter has no practical significance. You can ignore this parameter.
    latency number
    Latency (ms) for health check probe accessing the target address.
    mode string
    The mechanism for determining whether an address is available. auto: automatic mode. Cloud Scheduling GTM determines address availability based on health check results. alwayson: address is always available. alwaysoff: address is always unavailable.
    rectifiedGeos string[]
    The assigned region for the target address. See line codes for the mapping between line codes and specific regions (i.e., lines).
    value string
    Address.
    weight number
    Address weight. For addresses without a specified weight, this parameter returns the default weight value of 1.
    active bool
    Whether the address is available. true: The address is available. false: The address is unavailable.
    capacity int
    The capacity of the address. For addresses without a set capacity value, this parameter returns the default capacity value of 1000.
    geo str
    This parameter has no practical significance. You can ignore this parameter.
    latency int
    Latency (ms) for health check probe accessing the target address.
    mode str
    The mechanism for determining whether an address is available. auto: automatic mode. Cloud Scheduling GTM determines address availability based on health check results. alwayson: address is always available. alwaysoff: address is always unavailable.
    rectified_geos Sequence[str]
    The assigned region for the target address. See line codes for the mapping between line codes and specific regions (i.e., lines).
    value str
    Address.
    weight int
    Address weight. For addresses without a specified weight, this parameter returns the default weight value of 1.
    active Boolean
    Whether the address is available. true: The address is available. false: The address is unavailable.
    capacity Number
    The capacity of the address. For addresses without a set capacity value, this parameter returns the default capacity value of 1000.
    geo String
    This parameter has no practical significance. You can ignore this parameter.
    latency Number
    Latency (ms) for health check probe accessing the target address.
    mode String
    The mechanism for determining whether an address is available. auto: automatic mode. Cloud Scheduling GTM determines address availability based on health check results. alwayson: address is always available. alwaysoff: address is always unavailable.
    rectifiedGeos List<String>
    The assigned region for the target address. See line codes for the mapping between line codes and specific regions (i.e., lines).
    value String
    Address.
    weight Number
    Address weight. For addresses without a specified weight, this parameter returns the default weight value of 1.

    RuleProbe, RuleProbeArgs

    AdvisedNodeCount int
    Recommended number of health check probe points.
    Disable bool
    Whether health checks are disabled. true: disabled. false: not disabled.
    FailedCount int
    The threshold for the number of health check failures before a single target address is considered faulty. For example, if you set this parameter to 3, a target address is marked as faulty after 3 consecutive health check failures. The default value is 3.
    Host string
    Domain name of the health check target address. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    HttpMethod string
    HTTP request method. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    HttpUsabilityCodes List<Volcengine.RuleProbeHttpUsabilityCode>
    Interval int
    The interval between each health check, in seconds.
    IsManualNodes bool
    Whether to manually configure the health check probe. true: Manually configure the health check probe. false: Use recommended health check probe.
    Nodes List<string>
    Health check probe point.
    PingCount int
    Packet count. If you set this parameter to 10, each ping check sends 10 packets simultaneously. This parameter is only valid when the health check protocol is set to ping.
    PingLossPercent int
    Packet loss rate, expressed as a percentage. If the packet loss rate exceeds this parameter, the result is considered abnormal. For example, if this parameter is set to 10 and the packet loss rate during the health check is 11%, the result is considered abnormal. This parameter is only valid when the health check protocol is set to ping.
    Port int
    Port of the health check target address. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    Protocol string
    Protocol used for health checks. ping: ICMP protocol. tcp: TCP protocol. http: HTTP protocol. https: HTTPS protocol.
    Timeout int
    The timeout period for the health check task, in seconds. ping: If the latency exceeds the value of Timeout, it is considered packet loss. http/https: If the latency exceeds the value of Timeout, it is considered an abnormal result.
    Url string
    Path part of the health check target address, starting with /. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    AdvisedNodeCount int
    Recommended number of health check probe points.
    Disable bool
    Whether health checks are disabled. true: disabled. false: not disabled.
    FailedCount int
    The threshold for the number of health check failures before a single target address is considered faulty. For example, if you set this parameter to 3, a target address is marked as faulty after 3 consecutive health check failures. The default value is 3.
    Host string
    Domain name of the health check target address. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    HttpMethod string
    HTTP request method. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    HttpUsabilityCodes []RuleProbeHttpUsabilityCode
    Interval int
    The interval between each health check, in seconds.
    IsManualNodes bool
    Whether to manually configure the health check probe. true: Manually configure the health check probe. false: Use recommended health check probe.
    Nodes []string
    Health check probe point.
    PingCount int
    Packet count. If you set this parameter to 10, each ping check sends 10 packets simultaneously. This parameter is only valid when the health check protocol is set to ping.
    PingLossPercent int
    Packet loss rate, expressed as a percentage. If the packet loss rate exceeds this parameter, the result is considered abnormal. For example, if this parameter is set to 10 and the packet loss rate during the health check is 11%, the result is considered abnormal. This parameter is only valid when the health check protocol is set to ping.
    Port int
    Port of the health check target address. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    Protocol string
    Protocol used for health checks. ping: ICMP protocol. tcp: TCP protocol. http: HTTP protocol. https: HTTPS protocol.
    Timeout int
    The timeout period for the health check task, in seconds. ping: If the latency exceeds the value of Timeout, it is considered packet loss. http/https: If the latency exceeds the value of Timeout, it is considered an abnormal result.
    Url string
    Path part of the health check target address, starting with /. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    advised_node_count number
    Recommended number of health check probe points.
    disable bool
    Whether health checks are disabled. true: disabled. false: not disabled.
    failed_count number
    The threshold for the number of health check failures before a single target address is considered faulty. For example, if you set this parameter to 3, a target address is marked as faulty after 3 consecutive health check failures. The default value is 3.
    host string
    Domain name of the health check target address. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    http_method string
    HTTP request method. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    http_usability_codes list(object)
    interval number
    The interval between each health check, in seconds.
    is_manual_nodes bool
    Whether to manually configure the health check probe. true: Manually configure the health check probe. false: Use recommended health check probe.
    nodes list(string)
    Health check probe point.
    ping_count number
    Packet count. If you set this parameter to 10, each ping check sends 10 packets simultaneously. This parameter is only valid when the health check protocol is set to ping.
    ping_loss_percent number
    Packet loss rate, expressed as a percentage. If the packet loss rate exceeds this parameter, the result is considered abnormal. For example, if this parameter is set to 10 and the packet loss rate during the health check is 11%, the result is considered abnormal. This parameter is only valid when the health check protocol is set to ping.
    port number
    Port of the health check target address. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    protocol string
    Protocol used for health checks. ping: ICMP protocol. tcp: TCP protocol. http: HTTP protocol. https: HTTPS protocol.
    timeout number
    The timeout period for the health check task, in seconds. ping: If the latency exceeds the value of Timeout, it is considered packet loss. http/https: If the latency exceeds the value of Timeout, it is considered an abnormal result.
    url string
    Path part of the health check target address, starting with /. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    advisedNodeCount Integer
    Recommended number of health check probe points.
    disable Boolean
    Whether health checks are disabled. true: disabled. false: not disabled.
    failedCount Integer
    The threshold for the number of health check failures before a single target address is considered faulty. For example, if you set this parameter to 3, a target address is marked as faulty after 3 consecutive health check failures. The default value is 3.
    host String
    Domain name of the health check target address. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    httpMethod String
    HTTP request method. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    httpUsabilityCodes List<RuleProbeHttpUsabilityCode>
    interval Integer
    The interval between each health check, in seconds.
    isManualNodes Boolean
    Whether to manually configure the health check probe. true: Manually configure the health check probe. false: Use recommended health check probe.
    nodes List<String>
    Health check probe point.
    pingCount Integer
    Packet count. If you set this parameter to 10, each ping check sends 10 packets simultaneously. This parameter is only valid when the health check protocol is set to ping.
    pingLossPercent Integer
    Packet loss rate, expressed as a percentage. If the packet loss rate exceeds this parameter, the result is considered abnormal. For example, if this parameter is set to 10 and the packet loss rate during the health check is 11%, the result is considered abnormal. This parameter is only valid when the health check protocol is set to ping.
    port Integer
    Port of the health check target address. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    protocol String
    Protocol used for health checks. ping: ICMP protocol. tcp: TCP protocol. http: HTTP protocol. https: HTTPS protocol.
    timeout Integer
    The timeout period for the health check task, in seconds. ping: If the latency exceeds the value of Timeout, it is considered packet loss. http/https: If the latency exceeds the value of Timeout, it is considered an abnormal result.
    url String
    Path part of the health check target address, starting with /. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    advisedNodeCount number
    Recommended number of health check probe points.
    disable boolean
    Whether health checks are disabled. true: disabled. false: not disabled.
    failedCount number
    The threshold for the number of health check failures before a single target address is considered faulty. For example, if you set this parameter to 3, a target address is marked as faulty after 3 consecutive health check failures. The default value is 3.
    host string
    Domain name of the health check target address. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    httpMethod string
    HTTP request method. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    httpUsabilityCodes RuleProbeHttpUsabilityCode[]
    interval number
    The interval between each health check, in seconds.
    isManualNodes boolean
    Whether to manually configure the health check probe. true: Manually configure the health check probe. false: Use recommended health check probe.
    nodes string[]
    Health check probe point.
    pingCount number
    Packet count. If you set this parameter to 10, each ping check sends 10 packets simultaneously. This parameter is only valid when the health check protocol is set to ping.
    pingLossPercent number
    Packet loss rate, expressed as a percentage. If the packet loss rate exceeds this parameter, the result is considered abnormal. For example, if this parameter is set to 10 and the packet loss rate during the health check is 11%, the result is considered abnormal. This parameter is only valid when the health check protocol is set to ping.
    port number
    Port of the health check target address. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    protocol string
    Protocol used for health checks. ping: ICMP protocol. tcp: TCP protocol. http: HTTP protocol. https: HTTPS protocol.
    timeout number
    The timeout period for the health check task, in seconds. ping: If the latency exceeds the value of Timeout, it is considered packet loss. http/https: If the latency exceeds the value of Timeout, it is considered an abnormal result.
    url string
    Path part of the health check target address, starting with /. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    advised_node_count int
    Recommended number of health check probe points.
    disable bool
    Whether health checks are disabled. true: disabled. false: not disabled.
    failed_count int
    The threshold for the number of health check failures before a single target address is considered faulty. For example, if you set this parameter to 3, a target address is marked as faulty after 3 consecutive health check failures. The default value is 3.
    host str
    Domain name of the health check target address. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    http_method str
    HTTP request method. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    http_usability_codes Sequence[RuleProbeHttpUsabilityCode]
    interval int
    The interval between each health check, in seconds.
    is_manual_nodes bool
    Whether to manually configure the health check probe. true: Manually configure the health check probe. false: Use recommended health check probe.
    nodes Sequence[str]
    Health check probe point.
    ping_count int
    Packet count. If you set this parameter to 10, each ping check sends 10 packets simultaneously. This parameter is only valid when the health check protocol is set to ping.
    ping_loss_percent int
    Packet loss rate, expressed as a percentage. If the packet loss rate exceeds this parameter, the result is considered abnormal. For example, if this parameter is set to 10 and the packet loss rate during the health check is 11%, the result is considered abnormal. This parameter is only valid when the health check protocol is set to ping.
    port int
    Port of the health check target address. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    protocol str
    Protocol used for health checks. ping: ICMP protocol. tcp: TCP protocol. http: HTTP protocol. https: HTTPS protocol.
    timeout int
    The timeout period for the health check task, in seconds. ping: If the latency exceeds the value of Timeout, it is considered packet loss. http/https: If the latency exceeds the value of Timeout, it is considered an abnormal result.
    url str
    Path part of the health check target address, starting with /. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    advisedNodeCount Number
    Recommended number of health check probe points.
    disable Boolean
    Whether health checks are disabled. true: disabled. false: not disabled.
    failedCount Number
    The threshold for the number of health check failures before a single target address is considered faulty. For example, if you set this parameter to 3, a target address is marked as faulty after 3 consecutive health check failures. The default value is 3.
    host String
    Domain name of the health check target address. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    httpMethod String
    HTTP request method. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    httpUsabilityCodes List<Property Map>
    interval Number
    The interval between each health check, in seconds.
    isManualNodes Boolean
    Whether to manually configure the health check probe. true: Manually configure the health check probe. false: Use recommended health check probe.
    nodes List<String>
    Health check probe point.
    pingCount Number
    Packet count. If you set this parameter to 10, each ping check sends 10 packets simultaneously. This parameter is only valid when the health check protocol is set to ping.
    pingLossPercent Number
    Packet loss rate, expressed as a percentage. If the packet loss rate exceeds this parameter, the result is considered abnormal. For example, if this parameter is set to 10 and the packet loss rate during the health check is 11%, the result is considered abnormal. This parameter is only valid when the health check protocol is set to ping.
    port Number
    Port of the health check target address. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.
    protocol String
    Protocol used for health checks. ping: ICMP protocol. tcp: TCP protocol. http: HTTP protocol. https: HTTPS protocol.
    timeout Number
    The timeout period for the health check task, in seconds. ping: If the latency exceeds the value of Timeout, it is considered packet loss. http/https: If the latency exceeds the value of Timeout, it is considered an abnormal result.
    url String
    Path part of the health check target address, starting with /. This parameter is only valid when the health check protocol is set to HTTP or HTTPS.

    RuleProbeHttpUsabilityCode, RuleProbeHttpUsabilityCodeArgs

    Codes List<int>
    HTTP status code list.
    Operator string
    Operator. interval: Matches values within the range. include: Matches specified values. exclude: Matches values other than the specified values.
    Codes []int
    HTTP status code list.
    Operator string
    Operator. interval: Matches values within the range. include: Matches specified values. exclude: Matches values other than the specified values.
    codes list(number)
    HTTP status code list.
    operator string
    Operator. interval: Matches values within the range. include: Matches specified values. exclude: Matches values other than the specified values.
    codes List<Integer>
    HTTP status code list.
    operator String
    Operator. interval: Matches values within the range. include: Matches specified values. exclude: Matches values other than the specified values.
    codes number[]
    HTTP status code list.
    operator string
    Operator. interval: Matches values within the range. include: Matches specified values. exclude: Matches values other than the specified values.
    codes Sequence[int]
    HTTP status code list.
    operator str
    Operator. interval: Matches values within the range. include: Matches specified values. exclude: Matches values other than the specified values.
    codes List<Number>
    HTTP status code list.
    operator String
    Operator. interval: Matches values within the range. include: Matches specified values. exclude: Matches values other than the specified values.

    Import

    $ pulumi import volcenginecc:gtm/rule:Rule example "gtm_id|policy_type|rule_id"
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    volcenginecc volcengine/pulumi-volcenginecc
    License
    MPL-2.0
    Notes
    This Pulumi package is based on the volcenginecc Terraform Provider.
    volcenginecc logo
    Viewing docs for volcenginecc v0.0.43
    published on Monday, Jun 15, 2026 by Volcengine

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial