1. Packages
  2. Tencentcloud Provider
  3. API Docs
  4. getClbIdleInstances
tencentcloud 1.82.35 published on Friday, Nov 7, 2025 by tencentcloudstack
tencentcloudstack/terraform-provider-tencentcloud

tencentcloud.getClbIdleInstances

Start a Neo task
Explain and create a tencentcloud.getClbIdleInstances resource
tencentcloud logo
tencentcloud 1.82.35 published on Friday, Nov 7, 2025 by tencentcloudstack
tencentcloudstack/terraform-provider-tencentcloud

    Use this data source to query detailed information of clb idle_loadbalancers

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as tencentcloud from "@pulumi/tencentcloud";

const idleInstance = tencentcloud.getClbIdleInstances({
    loadBalancerRegion: "ap-guangzhou",
});

    import pulumi
import pulumi_tencentcloud as tencentcloud

idle_instance = tencentcloud.get_clb_idle_instances(load_balancer_region="ap-guangzhou")

    package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/tencentcloud/tencentcloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := tencentcloud.GetClbIdleInstances(ctx, &tencentcloud.GetClbIdleInstancesArgs{
			LoadBalancerRegion: pulumi.StringRef("ap-guangzhou"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Tencentcloud = Pulumi.Tencentcloud;

return await Deployment.RunAsync(() => 
{
    var idleInstance = Tencentcloud.GetClbIdleInstances.Invoke(new()
    {
        LoadBalancerRegion = "ap-guangzhou",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.tencentcloud.TencentcloudFunctions;
import com.pulumi.tencentcloud.inputs.GetClbIdleInstancesArgs;
import java.util.List;
import java.util.ArrayList;
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) {
        final var idleInstance = TencentcloudFunctions.getClbIdleInstances(GetClbIdleInstancesArgs.builder()
            .loadBalancerRegion("ap-guangzhou")
            .build());

    }
}

    variables:
  idleInstance:
    fn::invoke:
      function: tencentcloud:getClbIdleInstances
      arguments:
        loadBalancerRegion: ap-guangzhou

    Using getClbIdleInstances

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getClbIdleInstances(args: GetClbIdleInstancesArgs, opts?: InvokeOptions): Promise<GetClbIdleInstancesResult>
function getClbIdleInstancesOutput(args: GetClbIdleInstancesOutputArgs, opts?: InvokeOptions): Output<GetClbIdleInstancesResult>
    def get_clb_idle_instances(id: Optional[str] = None,
                           load_balancer_region: Optional[str] = None,
                           result_output_file: Optional[str] = None,
                           opts: Optional[InvokeOptions] = None) -> GetClbIdleInstancesResult
def get_clb_idle_instances_output(id: Optional[pulumi.Input[str]] = None,
                           load_balancer_region: Optional[pulumi.Input[str]] = None,
                           result_output_file: Optional[pulumi.Input[str]] = None,
                           opts: Optional[InvokeOptions] = None) -> Output[GetClbIdleInstancesResult]
    func GetClbIdleInstances(ctx *Context, args *GetClbIdleInstancesArgs, opts ...InvokeOption) (*GetClbIdleInstancesResult, error)
func GetClbIdleInstancesOutput(ctx *Context, args *GetClbIdleInstancesOutputArgs, opts ...InvokeOption) GetClbIdleInstancesResultOutput

    > Note: This function is named GetClbIdleInstances in the Go SDK.

    public static class GetClbIdleInstances 
{
    public static Task<GetClbIdleInstancesResult> InvokeAsync(GetClbIdleInstancesArgs args, InvokeOptions? opts = null)
    public static Output<GetClbIdleInstancesResult> Invoke(GetClbIdleInstancesInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetClbIdleInstancesResult> getClbIdleInstances(GetClbIdleInstancesArgs args, InvokeOptions options)
public static Output<GetClbIdleInstancesResult> getClbIdleInstances(GetClbIdleInstancesArgs args, InvokeOptions options)

    fn::invoke:
  function: tencentcloud:index/getClbIdleInstances:getClbIdleInstances
  arguments:
    # arguments dictionary

    The following arguments are supported:

    Id string
    LoadBalancerRegion string
    CLB instance region.
    ResultOutputFile string
    Used to save results.
    Id string
    LoadBalancerRegion string
    CLB instance region.
    ResultOutputFile string
    Used to save results.
    id String
    loadBalancerRegion String
    CLB instance region.
    resultOutputFile String
    Used to save results.
    id string
    loadBalancerRegion string
    CLB instance region.
    resultOutputFile string
    Used to save results.
    id str
    load_balancer_region str
    CLB instance region.
    result_output_file str
    Used to save results.
    id String
    loadBalancerRegion String
    CLB instance region.
    resultOutputFile String
    Used to save results.

    getClbIdleInstances Result

    The following output properties are available:

    Id string
    IdleLoadBalancers List<GetClbIdleInstancesIdleLoadBalancer>
    List of idle CLBs. Note: This field may return null, indicating that no valid values can be obtained.
    LoadBalancerRegion string
    ResultOutputFile string
    Id string
    IdleLoadBalancers []GetClbIdleInstancesIdleLoadBalancer
    List of idle CLBs. Note: This field may return null, indicating that no valid values can be obtained.
    LoadBalancerRegion string
    ResultOutputFile string
    id String
    idleLoadBalancers List<GetClbIdleInstancesIdleLoadBalancer>
    List of idle CLBs. Note: This field may return null, indicating that no valid values can be obtained.
    loadBalancerRegion String
    resultOutputFile String
    id string
    idleLoadBalancers GetClbIdleInstancesIdleLoadBalancer[]
    List of idle CLBs. Note: This field may return null, indicating that no valid values can be obtained.
    loadBalancerRegion string
    resultOutputFile string
    id str
    idle_load_balancers Sequence[GetClbIdleInstancesIdleLoadBalancer]
    List of idle CLBs. Note: This field may return null, indicating that no valid values can be obtained.
    load_balancer_region str
    result_output_file str
    id String
    idleLoadBalancers List<Property Map>
    List of idle CLBs. Note: This field may return null, indicating that no valid values can be obtained.
    loadBalancerRegion String
    resultOutputFile String

    Supporting Types

    GetClbIdleInstancesIdleLoadBalancer

    Domain string
    The load balancing hostname.Note: This field may return null, indicating that no valid values can be obtained.
    Forward double
    CLB type. Value range: 1 (CLB); 0 (classic CLB).
    IdleReason string
    The reason why the load balancer is considered idle. NO_RULES: No rules configured. NO_RS: The rules are not associated with servers.
    LoadBalancerId string
    CLB instance ID.
    LoadBalancerName string
    CLB instance name.
    Region string
    CLB instance region.
    Status double
    CLB instance status, including:0: Creating; 1: Running.
    Vip string
    CLB instance VIP.
    Domain string
    The load balancing hostname.Note: This field may return null, indicating that no valid values can be obtained.
    Forward float64
    CLB type. Value range: 1 (CLB); 0 (classic CLB).
    IdleReason string
    The reason why the load balancer is considered idle. NO_RULES: No rules configured. NO_RS: The rules are not associated with servers.
    LoadBalancerId string
    CLB instance ID.
    LoadBalancerName string
    CLB instance name.
    Region string
    CLB instance region.
    Status float64
    CLB instance status, including:0: Creating; 1: Running.
    Vip string
    CLB instance VIP.
    domain String
    The load balancing hostname.Note: This field may return null, indicating that no valid values can be obtained.
    forward Double
    CLB type. Value range: 1 (CLB); 0 (classic CLB).
    idleReason String
    The reason why the load balancer is considered idle. NO_RULES: No rules configured. NO_RS: The rules are not associated with servers.
    loadBalancerId String
    CLB instance ID.
    loadBalancerName String
    CLB instance name.
    region String
    CLB instance region.
    status Double
    CLB instance status, including:0: Creating; 1: Running.
    vip String
    CLB instance VIP.
    domain string
    The load balancing hostname.Note: This field may return null, indicating that no valid values can be obtained.
    forward number
    CLB type. Value range: 1 (CLB); 0 (classic CLB).
    idleReason string
    The reason why the load balancer is considered idle. NO_RULES: No rules configured. NO_RS: The rules are not associated with servers.
    loadBalancerId string
    CLB instance ID.
    loadBalancerName string
    CLB instance name.
    region string
    CLB instance region.
    status number
    CLB instance status, including:0: Creating; 1: Running.
    vip string
    CLB instance VIP.
    domain str
    The load balancing hostname.Note: This field may return null, indicating that no valid values can be obtained.
    forward float
    CLB type. Value range: 1 (CLB); 0 (classic CLB).
    idle_reason str
    The reason why the load balancer is considered idle. NO_RULES: No rules configured. NO_RS: The rules are not associated with servers.
    load_balancer_id str
    CLB instance ID.
    load_balancer_name str
    CLB instance name.
    region str
    CLB instance region.
    status float
    CLB instance status, including:0: Creating; 1: Running.
    vip str
    CLB instance VIP.
    domain String
    The load balancing hostname.Note: This field may return null, indicating that no valid values can be obtained.
    forward Number
    CLB type. Value range: 1 (CLB); 0 (classic CLB).
    idleReason String
    The reason why the load balancer is considered idle. NO_RULES: No rules configured. NO_RS: The rules are not associated with servers.
    loadBalancerId String
    CLB instance ID.
    loadBalancerName String
    CLB instance name.
    region String
    CLB instance region.
    status Number
    CLB instance status, including:0: Creating; 1: Running.
    vip String
    CLB instance VIP.

    Package Details

    Repository
    tencentcloud tencentcloudstack/terraform-provider-tencentcloud
    License
    Notes
    This Pulumi package is based on the tencentcloud Terraform Provider.
    tencentcloud logo
    tencentcloud 1.82.35 published on Friday, Nov 7, 2025 by tencentcloudstack
    tencentcloudstack/terraform-provider-tencentcloud
      Meet Neo: Your AI Platform Teammate