1. Packages
  2. Packages
  3. Volcenginecc Provider
  4. API Docs
  5. tls
  6. RuleBoundHostGroup
Viewing docs for volcenginecc v0.0.50
published on Monday, Jul 20, 2026 by Volcengine
volcenginecc logo
Viewing docs for volcenginecc v0.0.50
published on Monday, Jul 20, 2026 by Volcengine

    Resource representing the binding relationship between collection configuration and machine group

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as volcenginecc from "@volcengine/pulumi-volcenginecc";
    
    const example = new volcenginecc.tls.RuleBoundHostGroup("Example", {
        hostGroupId: "38feb3b9-xxxxxx-a53b-de52cd9103d2",
        ruleId: "09046b89-xxxx-90e5-5e878de6b710",
    });
    
    import pulumi
    import pulumi_volcenginecc as volcenginecc
    
    example = volcenginecc.tls.RuleBoundHostGroup("Example",
        host_group_id="38feb3b9-xxxxxx-a53b-de52cd9103d2",
        rule_id="09046b89-xxxx-90e5-5e878de6b710")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/volcengine/pulumi-volcenginecc/sdk/go/volcenginecc/tls"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := tls.NewRuleBoundHostGroup(ctx, "Example", &tls.RuleBoundHostGroupArgs{
    			HostGroupId: pulumi.String("38feb3b9-xxxxxx-a53b-de52cd9103d2"),
    			RuleId:      pulumi.String("09046b89-xxxx-90e5-5e878de6b710"),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Volcenginecc = Volcengine.Pulumi.Volcenginecc;
    
    return await Deployment.RunAsync(() => 
    {
        var example = new Volcenginecc.Tls.RuleBoundHostGroup("Example", new()
        {
            HostGroupId = "38feb3b9-xxxxxx-a53b-de52cd9103d2",
            RuleId = "09046b89-xxxx-90e5-5e878de6b710",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.volcengine.volcenginecc.tls.RuleBoundHostGroup;
    import com.volcengine.volcenginecc.tls.RuleBoundHostGroupArgs;
    import java.util.ArrayList;
    import java.util.Arrays;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var example = new RuleBoundHostGroup("example", RuleBoundHostGroupArgs.builder()
                .hostGroupId("38feb3b9-xxxxxx-a53b-de52cd9103d2")
                .ruleId("09046b89-xxxx-90e5-5e878de6b710")
                .build());
    
        }
    }
    
    resources:
      example:
        type: volcenginecc:tls:RuleBoundHostGroup
        name: Example
        properties:
          hostGroupId: 38feb3b9-xxxxxx-a53b-de52cd9103d2
          ruleId: 09046b89-xxxx-90e5-5e878de6b710
    
    pulumi {
      required_providers {
        volcenginecc = {
          source = "pulumi/volcenginecc"
        }
      }
    }
    
    resource "volcenginecc_tls_ruleboundhostgroup" "Example" {
      host_group_id = "38feb3b9-xxxxxx-a53b-de52cd9103d2"
      rule_id       = "09046b89-xxxx-90e5-5e878de6b710"
    }
    

    Create RuleBoundHostGroup Resource

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

    Constructor syntax

    new RuleBoundHostGroup(name: string, args: RuleBoundHostGroupArgs, opts?: CustomResourceOptions);
    @overload
    def RuleBoundHostGroup(resource_name: str,
                           args: RuleBoundHostGroupArgs,
                           opts: Optional[ResourceOptions] = None)
    
    @overload
    def RuleBoundHostGroup(resource_name: str,
                           opts: Optional[ResourceOptions] = None,
                           host_group_id: Optional[str] = None,
                           rule_id: Optional[str] = None)
    func NewRuleBoundHostGroup(ctx *Context, name string, args RuleBoundHostGroupArgs, opts ...ResourceOption) (*RuleBoundHostGroup, error)
    public RuleBoundHostGroup(string name, RuleBoundHostGroupArgs args, CustomResourceOptions? opts = null)
    public RuleBoundHostGroup(String name, RuleBoundHostGroupArgs args)
    public RuleBoundHostGroup(String name, RuleBoundHostGroupArgs args, CustomResourceOptions options)
    
    type: volcenginecc:tls:RuleBoundHostGroup
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "volcenginecc_tls_rule_bound_host_group" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args RuleBoundHostGroupArgs
    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 RuleBoundHostGroupArgs
    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 RuleBoundHostGroupArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args RuleBoundHostGroupArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args RuleBoundHostGroupArgs
    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 ruleBoundHostGroupResource = new Volcenginecc.Tls.RuleBoundHostGroup("ruleBoundHostGroupResource", new()
    {
        HostGroupId = "string",
        RuleId = "string",
    });
    
    example, err := tls.NewRuleBoundHostGroup(ctx, "ruleBoundHostGroupResource", &tls.RuleBoundHostGroupArgs{
    	HostGroupId: pulumi.String("string"),
    	RuleId:      pulumi.String("string"),
    })
    
    resource "volcenginecc_tls_rule_bound_host_group" "ruleBoundHostGroupResource" {
      lifecycle {
        create_before_destroy = true
      }
      host_group_id = "string"
      rule_id       = "string"
    }
    
    var ruleBoundHostGroupResource = new RuleBoundHostGroup("ruleBoundHostGroupResource", RuleBoundHostGroupArgs.builder()
        .hostGroupId("string")
        .ruleId("string")
        .build());
    
    rule_bound_host_group_resource = volcenginecc.tls.RuleBoundHostGroup("ruleBoundHostGroupResource",
        host_group_id="string",
        rule_id="string")
    
    const ruleBoundHostGroupResource = new volcenginecc.tls.RuleBoundHostGroup("ruleBoundHostGroupResource", {
        hostGroupId: "string",
        ruleId: "string",
    });
    
    type: volcenginecc:tls:RuleBoundHostGroup
    properties:
        hostGroupId: string
        ruleId: string
    

    RuleBoundHostGroup 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 RuleBoundHostGroup resource accepts the following input properties:

    HostGroupId string
    Machine group ID
    RuleId string
    Collection configuration ID
    HostGroupId string
    Machine group ID
    RuleId string
    Collection configuration ID
    host_group_id string
    Machine group ID
    rule_id string
    Collection configuration ID
    hostGroupId String
    Machine group ID
    ruleId String
    Collection configuration ID
    hostGroupId string
    Machine group ID
    ruleId string
    Collection configuration ID
    host_group_id str
    Machine group ID
    rule_id str
    Collection configuration ID
    hostGroupId String
    Machine group ID
    ruleId String
    Collection configuration ID

    Outputs

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

    HostGroup Volcengine.RuleBoundHostGroupHostGroup
    Bound machine group configuration information
    Id string
    The provider-assigned unique ID for this managed resource.
    HostGroup RuleBoundHostGroupHostGroup
    Bound machine group configuration information
    Id string
    The provider-assigned unique ID for this managed resource.
    host_group object
    Bound machine group configuration information
    id string
    The provider-assigned unique ID for this managed resource.
    hostGroup RuleBoundHostGroupHostGroup
    Bound machine group configuration information
    id String
    The provider-assigned unique ID for this managed resource.
    hostGroup RuleBoundHostGroupHostGroup
    Bound machine group configuration information
    id string
    The provider-assigned unique ID for this managed resource.
    host_group RuleBoundHostGroupHostGroup
    Bound machine group configuration information
    id str
    The provider-assigned unique ID for this managed resource.
    hostGroup Property Map
    Bound machine group configuration information
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing RuleBoundHostGroup Resource

    Get an existing RuleBoundHostGroup 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?: RuleBoundHostGroupState, opts?: CustomResourceOptions): RuleBoundHostGroup
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            host_group: Optional[RuleBoundHostGroupHostGroupArgs] = None,
            host_group_id: Optional[str] = None,
            rule_id: Optional[str] = None) -> RuleBoundHostGroup
    func GetRuleBoundHostGroup(ctx *Context, name string, id IDInput, state *RuleBoundHostGroupState, opts ...ResourceOption) (*RuleBoundHostGroup, error)
    public static RuleBoundHostGroup Get(string name, Input<string> id, RuleBoundHostGroupState? state, CustomResourceOptions? opts = null)
    public static RuleBoundHostGroup get(String name, Output<String> id, RuleBoundHostGroupState state, CustomResourceOptions options)
    resources:  _:    type: volcenginecc:tls:RuleBoundHostGroup    get:      id: ${id}
    import {
      to = volcenginecc_tls_rule_bound_host_group.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:
    HostGroup Volcengine.RuleBoundHostGroupHostGroup
    Bound machine group configuration information
    HostGroupId string
    Machine group ID
    RuleId string
    Collection configuration ID
    HostGroup RuleBoundHostGroupHostGroupArgs
    Bound machine group configuration information
    HostGroupId string
    Machine group ID
    RuleId string
    Collection configuration ID
    host_group object
    Bound machine group configuration information
    host_group_id string
    Machine group ID
    rule_id string
    Collection configuration ID
    hostGroup RuleBoundHostGroupHostGroup
    Bound machine group configuration information
    hostGroupId String
    Machine group ID
    ruleId String
    Collection configuration ID
    hostGroup RuleBoundHostGroupHostGroup
    Bound machine group configuration information
    hostGroupId string
    Machine group ID
    ruleId string
    Collection configuration ID
    host_group RuleBoundHostGroupHostGroupArgs
    Bound machine group configuration information
    host_group_id str
    Machine group ID
    rule_id str
    Collection configuration ID
    hostGroup Property Map
    Bound machine group configuration information
    hostGroupId String
    Machine group ID
    ruleId String
    Collection configuration ID

    Supporting Types

    RuleBoundHostGroupHostGroup, RuleBoundHostGroupHostGroupArgs

    AbnormalHeartbeatStatusCount int
    Number of machines with abnormal heartbeat status
    AgentLatestVersion string
    Latest LogCollector version number available for upgrade
    AutoUpdate bool
    Enable LogCollector auto upgrade on machine group servers. true: The log service will check upgrade conditions during the specified time period each day. If conditions are met, LogCollector will be upgraded automatically without manual intervention. false (default): LogCollector will not upgrade automatically. To use a newer version, refer to the LogCollector upgrade procedure.
    CreateTime string
    Machine group creation time
    HostCount int
    Number of machines in the machine group
    HostGroupId string
    Machine group ID
    HostGroupName string
    Machine group name
    HostGroupType string
    Machine group type. IP: machine IP. Label: machine label.
    HostIdentifier string
    Machine identifier
    IamProjectName string
    IAM project associated with the machine group
    ModifyTime string
    Machine group modification time
    NormalHeartbeatStatusCount int
    Number of machines with normal heartbeat status
    RuleCount int
    Number of collection configurations bound to the machine group
    ServiceLogging bool
    Enable LogCollector service log feature. true: enabled. false (default): disabled.
    UpdateEndTime string
    LogCollector auto upgrade end time
    UpdateStartTime string
    LogCollector auto upgrade start time. Note: Only required when AutoUpdate is set to true. It is recommended to schedule auto upgrade during off-peak hours. LogCollector may restart during the upgrade process, but logs will not be lost.
    AbnormalHeartbeatStatusCount int
    Number of machines with abnormal heartbeat status
    AgentLatestVersion string
    Latest LogCollector version number available for upgrade
    AutoUpdate bool
    Enable LogCollector auto upgrade on machine group servers. true: The log service will check upgrade conditions during the specified time period each day. If conditions are met, LogCollector will be upgraded automatically without manual intervention. false (default): LogCollector will not upgrade automatically. To use a newer version, refer to the LogCollector upgrade procedure.
    CreateTime string
    Machine group creation time
    HostCount int
    Number of machines in the machine group
    HostGroupId string
    Machine group ID
    HostGroupName string
    Machine group name
    HostGroupType string
    Machine group type. IP: machine IP. Label: machine label.
    HostIdentifier string
    Machine identifier
    IamProjectName string
    IAM project associated with the machine group
    ModifyTime string
    Machine group modification time
    NormalHeartbeatStatusCount int
    Number of machines with normal heartbeat status
    RuleCount int
    Number of collection configurations bound to the machine group
    ServiceLogging bool
    Enable LogCollector service log feature. true: enabled. false (default): disabled.
    UpdateEndTime string
    LogCollector auto upgrade end time
    UpdateStartTime string
    LogCollector auto upgrade start time. Note: Only required when AutoUpdate is set to true. It is recommended to schedule auto upgrade during off-peak hours. LogCollector may restart during the upgrade process, but logs will not be lost.
    abnormal_heartbeat_status_count number
    Number of machines with abnormal heartbeat status
    agent_latest_version string
    Latest LogCollector version number available for upgrade
    auto_update bool
    Enable LogCollector auto upgrade on machine group servers. true: The log service will check upgrade conditions during the specified time period each day. If conditions are met, LogCollector will be upgraded automatically without manual intervention. false (default): LogCollector will not upgrade automatically. To use a newer version, refer to the LogCollector upgrade procedure.
    create_time string
    Machine group creation time
    host_count number
    Number of machines in the machine group
    host_group_id string
    Machine group ID
    host_group_name string
    Machine group name
    host_group_type string
    Machine group type. IP: machine IP. Label: machine label.
    host_identifier string
    Machine identifier
    iam_project_name string
    IAM project associated with the machine group
    modify_time string
    Machine group modification time
    normal_heartbeat_status_count number
    Number of machines with normal heartbeat status
    rule_count number
    Number of collection configurations bound to the machine group
    service_logging bool
    Enable LogCollector service log feature. true: enabled. false (default): disabled.
    update_end_time string
    LogCollector auto upgrade end time
    update_start_time string
    LogCollector auto upgrade start time. Note: Only required when AutoUpdate is set to true. It is recommended to schedule auto upgrade during off-peak hours. LogCollector may restart during the upgrade process, but logs will not be lost.
    abnormalHeartbeatStatusCount Integer
    Number of machines with abnormal heartbeat status
    agentLatestVersion String
    Latest LogCollector version number available for upgrade
    autoUpdate Boolean
    Enable LogCollector auto upgrade on machine group servers. true: The log service will check upgrade conditions during the specified time period each day. If conditions are met, LogCollector will be upgraded automatically without manual intervention. false (default): LogCollector will not upgrade automatically. To use a newer version, refer to the LogCollector upgrade procedure.
    createTime String
    Machine group creation time
    hostCount Integer
    Number of machines in the machine group
    hostGroupId String
    Machine group ID
    hostGroupName String
    Machine group name
    hostGroupType String
    Machine group type. IP: machine IP. Label: machine label.
    hostIdentifier String
    Machine identifier
    iamProjectName String
    IAM project associated with the machine group
    modifyTime String
    Machine group modification time
    normalHeartbeatStatusCount Integer
    Number of machines with normal heartbeat status
    ruleCount Integer
    Number of collection configurations bound to the machine group
    serviceLogging Boolean
    Enable LogCollector service log feature. true: enabled. false (default): disabled.
    updateEndTime String
    LogCollector auto upgrade end time
    updateStartTime String
    LogCollector auto upgrade start time. Note: Only required when AutoUpdate is set to true. It is recommended to schedule auto upgrade during off-peak hours. LogCollector may restart during the upgrade process, but logs will not be lost.
    abnormalHeartbeatStatusCount number
    Number of machines with abnormal heartbeat status
    agentLatestVersion string
    Latest LogCollector version number available for upgrade
    autoUpdate boolean
    Enable LogCollector auto upgrade on machine group servers. true: The log service will check upgrade conditions during the specified time period each day. If conditions are met, LogCollector will be upgraded automatically without manual intervention. false (default): LogCollector will not upgrade automatically. To use a newer version, refer to the LogCollector upgrade procedure.
    createTime string
    Machine group creation time
    hostCount number
    Number of machines in the machine group
    hostGroupId string
    Machine group ID
    hostGroupName string
    Machine group name
    hostGroupType string
    Machine group type. IP: machine IP. Label: machine label.
    hostIdentifier string
    Machine identifier
    iamProjectName string
    IAM project associated with the machine group
    modifyTime string
    Machine group modification time
    normalHeartbeatStatusCount number
    Number of machines with normal heartbeat status
    ruleCount number
    Number of collection configurations bound to the machine group
    serviceLogging boolean
    Enable LogCollector service log feature. true: enabled. false (default): disabled.
    updateEndTime string
    LogCollector auto upgrade end time
    updateStartTime string
    LogCollector auto upgrade start time. Note: Only required when AutoUpdate is set to true. It is recommended to schedule auto upgrade during off-peak hours. LogCollector may restart during the upgrade process, but logs will not be lost.
    abnormal_heartbeat_status_count int
    Number of machines with abnormal heartbeat status
    agent_latest_version str
    Latest LogCollector version number available for upgrade
    auto_update bool
    Enable LogCollector auto upgrade on machine group servers. true: The log service will check upgrade conditions during the specified time period each day. If conditions are met, LogCollector will be upgraded automatically without manual intervention. false (default): LogCollector will not upgrade automatically. To use a newer version, refer to the LogCollector upgrade procedure.
    create_time str
    Machine group creation time
    host_count int
    Number of machines in the machine group
    host_group_id str
    Machine group ID
    host_group_name str
    Machine group name
    host_group_type str
    Machine group type. IP: machine IP. Label: machine label.
    host_identifier str
    Machine identifier
    iam_project_name str
    IAM project associated with the machine group
    modify_time str
    Machine group modification time
    normal_heartbeat_status_count int
    Number of machines with normal heartbeat status
    rule_count int
    Number of collection configurations bound to the machine group
    service_logging bool
    Enable LogCollector service log feature. true: enabled. false (default): disabled.
    update_end_time str
    LogCollector auto upgrade end time
    update_start_time str
    LogCollector auto upgrade start time. Note: Only required when AutoUpdate is set to true. It is recommended to schedule auto upgrade during off-peak hours. LogCollector may restart during the upgrade process, but logs will not be lost.
    abnormalHeartbeatStatusCount Number
    Number of machines with abnormal heartbeat status
    agentLatestVersion String
    Latest LogCollector version number available for upgrade
    autoUpdate Boolean
    Enable LogCollector auto upgrade on machine group servers. true: The log service will check upgrade conditions during the specified time period each day. If conditions are met, LogCollector will be upgraded automatically without manual intervention. false (default): LogCollector will not upgrade automatically. To use a newer version, refer to the LogCollector upgrade procedure.
    createTime String
    Machine group creation time
    hostCount Number
    Number of machines in the machine group
    hostGroupId String
    Machine group ID
    hostGroupName String
    Machine group name
    hostGroupType String
    Machine group type. IP: machine IP. Label: machine label.
    hostIdentifier String
    Machine identifier
    iamProjectName String
    IAM project associated with the machine group
    modifyTime String
    Machine group modification time
    normalHeartbeatStatusCount Number
    Number of machines with normal heartbeat status
    ruleCount Number
    Number of collection configurations bound to the machine group
    serviceLogging Boolean
    Enable LogCollector service log feature. true: enabled. false (default): disabled.
    updateEndTime String
    LogCollector auto upgrade end time
    updateStartTime String
    LogCollector auto upgrade start time. Note: Only required when AutoUpdate is set to true. It is recommended to schedule auto upgrade during off-peak hours. LogCollector may restart during the upgrade process, but logs will not be lost.

    Import

    $ pulumi import volcenginecc:tls/ruleBoundHostGroup:RuleBoundHostGroup example "rule_id|host_group_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.50
    published on Monday, Jul 20, 2026 by Volcengine

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial