1. Packages
  2. Volcengine
  3. API Docs
  4. tls
  5. getTraceInstances
Volcengine v0.0.45 published on Tuesday, Feb 10, 2026 by Volcengine
volcengine logo
Volcengine v0.0.45 published on Tuesday, Feb 10, 2026 by Volcengine

    Use this data source to query detailed information of tls trace instances

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as volcengine from "@pulumi/volcengine";
    
    const byName = volcengine.tls.getTraceInstances({
        projectId: "bdb87e4d-7dad-4b96-ac43-e1b09e9dc8ac",
        traceInstanceName: "测试trace",
    });
    const byStatus = volcengine.tls.getTraceInstances({
        projectId: "bdb87e4d-7dad-4b96-ac43-e1b09e9dc8ac",
        status: "CREATED",
    });
    
    import pulumi
    import pulumi_volcengine as volcengine
    
    by_name = volcengine.tls.get_trace_instances(project_id="bdb87e4d-7dad-4b96-ac43-e1b09e9dc8ac",
        trace_instance_name="测试trace")
    by_status = volcengine.tls.get_trace_instances(project_id="bdb87e4d-7dad-4b96-ac43-e1b09e9dc8ac",
        status="CREATED")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/volcengine/pulumi-volcengine/sdk/go/volcengine/tls"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := tls.GetTraceInstances(ctx, &tls.GetTraceInstancesArgs{
    			ProjectId:         pulumi.StringRef("bdb87e4d-7dad-4b96-ac43-e1b09e9dc8ac"),
    			TraceInstanceName: pulumi.StringRef("测试trace"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		_, err = tls.GetTraceInstances(ctx, &tls.GetTraceInstancesArgs{
    			ProjectId: pulumi.StringRef("bdb87e4d-7dad-4b96-ac43-e1b09e9dc8ac"),
    			Status:    pulumi.StringRef("CREATED"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Volcengine = Pulumi.Volcengine;
    
    return await Deployment.RunAsync(() => 
    {
        var byName = Volcengine.Tls.GetTraceInstances.Invoke(new()
        {
            ProjectId = "bdb87e4d-7dad-4b96-ac43-e1b09e9dc8ac",
            TraceInstanceName = "测试trace",
        });
    
        var byStatus = Volcengine.Tls.GetTraceInstances.Invoke(new()
        {
            ProjectId = "bdb87e4d-7dad-4b96-ac43-e1b09e9dc8ac",
            Status = "CREATED",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.volcengine.tls.TlsFunctions;
    import com.pulumi.volcengine.tls.inputs.GetTraceInstancesArgs;
    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 byName = TlsFunctions.getTraceInstances(GetTraceInstancesArgs.builder()
                .projectId("bdb87e4d-7dad-4b96-ac43-e1b09e9dc8ac")
                .traceInstanceName("测试trace")
                .build());
    
            final var byStatus = TlsFunctions.getTraceInstances(GetTraceInstancesArgs.builder()
                .projectId("bdb87e4d-7dad-4b96-ac43-e1b09e9dc8ac")
                .status("CREATED")
                .build());
    
        }
    }
    
    variables:
      byName:
        fn::invoke:
          Function: volcengine:tls:getTraceInstances
          Arguments:
            projectId: bdb87e4d-7dad-4b96-ac43-e1b09e9dc8ac
            traceInstanceName: 测试trace
      byStatus:
        fn::invoke:
          Function: volcengine:tls:getTraceInstances
          Arguments:
            projectId: bdb87e4d-7dad-4b96-ac43-e1b09e9dc8ac
            status: CREATED
    

    Using getTraceInstances

    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 getTraceInstances(args: GetTraceInstancesArgs, opts?: InvokeOptions): Promise<GetTraceInstancesResult>
    function getTraceInstancesOutput(args: GetTraceInstancesOutputArgs, opts?: InvokeOptions): Output<GetTraceInstancesResult>
    def get_trace_instances(cs_account_channel: Optional[str] = None,
                            iam_project_name: Optional[str] = None,
                            output_file: Optional[str] = None,
                            project_id: Optional[str] = None,
                            project_name: Optional[str] = None,
                            status: Optional[str] = None,
                            trace_instance_id: Optional[str] = None,
                            trace_instance_name: Optional[str] = None,
                            opts: Optional[InvokeOptions] = None) -> GetTraceInstancesResult
    def get_trace_instances_output(cs_account_channel: Optional[pulumi.Input[str]] = None,
                            iam_project_name: Optional[pulumi.Input[str]] = None,
                            output_file: Optional[pulumi.Input[str]] = None,
                            project_id: Optional[pulumi.Input[str]] = None,
                            project_name: Optional[pulumi.Input[str]] = None,
                            status: Optional[pulumi.Input[str]] = None,
                            trace_instance_id: Optional[pulumi.Input[str]] = None,
                            trace_instance_name: Optional[pulumi.Input[str]] = None,
                            opts: Optional[InvokeOptions] = None) -> Output[GetTraceInstancesResult]
    func GetTraceInstances(ctx *Context, args *GetTraceInstancesArgs, opts ...InvokeOption) (*GetTraceInstancesResult, error)
    func GetTraceInstancesOutput(ctx *Context, args *GetTraceInstancesOutputArgs, opts ...InvokeOption) GetTraceInstancesResultOutput

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

    public static class GetTraceInstances 
    {
        public static Task<GetTraceInstancesResult> InvokeAsync(GetTraceInstancesArgs args, InvokeOptions? opts = null)
        public static Output<GetTraceInstancesResult> Invoke(GetTraceInstancesInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetTraceInstancesResult> getTraceInstances(GetTraceInstancesArgs args, InvokeOptions options)
    public static Output<GetTraceInstancesResult> getTraceInstances(GetTraceInstancesArgs args, InvokeOptions options)
    
    fn::invoke:
      function: volcengine:tls/getTraceInstances:getTraceInstances
      arguments:
        # arguments dictionary

    The following arguments are supported:

    CsAccountChannel string
    CS account channel identifier.
    IamProjectName string
    The IAM project name.
    OutputFile string
    File name where to save data source results.
    ProjectId string
    The ID of the project.
    ProjectName string
    The name of the project.
    Status string
    The status of the trace instance.
    TraceInstanceId string
    The ID of the trace instance.
    TraceInstanceName string
    The name of the trace instance.
    CsAccountChannel string
    CS account channel identifier.
    IamProjectName string
    The IAM project name.
    OutputFile string
    File name where to save data source results.
    ProjectId string
    The ID of the project.
    ProjectName string
    The name of the project.
    Status string
    The status of the trace instance.
    TraceInstanceId string
    The ID of the trace instance.
    TraceInstanceName string
    The name of the trace instance.
    csAccountChannel String
    CS account channel identifier.
    iamProjectName String
    The IAM project name.
    outputFile String
    File name where to save data source results.
    projectId String
    The ID of the project.
    projectName String
    The name of the project.
    status String
    The status of the trace instance.
    traceInstanceId String
    The ID of the trace instance.
    traceInstanceName String
    The name of the trace instance.
    csAccountChannel string
    CS account channel identifier.
    iamProjectName string
    The IAM project name.
    outputFile string
    File name where to save data source results.
    projectId string
    The ID of the project.
    projectName string
    The name of the project.
    status string
    The status of the trace instance.
    traceInstanceId string
    The ID of the trace instance.
    traceInstanceName string
    The name of the trace instance.
    cs_account_channel str
    CS account channel identifier.
    iam_project_name str
    The IAM project name.
    output_file str
    File name where to save data source results.
    project_id str
    The ID of the project.
    project_name str
    The name of the project.
    status str
    The status of the trace instance.
    trace_instance_id str
    The ID of the trace instance.
    trace_instance_name str
    The name of the trace instance.
    csAccountChannel String
    CS account channel identifier.
    iamProjectName String
    The IAM project name.
    outputFile String
    File name where to save data source results.
    projectId String
    The ID of the project.
    projectName String
    The name of the project.
    status String
    The status of the trace instance.
    traceInstanceId String
    The ID of the trace instance.
    traceInstanceName String
    The name of the trace instance.

    getTraceInstances Result

    The following output properties are available:

    Id string
    The provider-assigned unique ID for this managed resource.
    TotalCount int
    The total count of trace instances.
    TraceInstances List<GetTraceInstancesTraceInstance>
    The list of trace instances.
    CsAccountChannel string
    CS account channel identifier.
    IamProjectName string
    OutputFile string
    ProjectId string
    The ID of the project.
    ProjectName string
    The name of the project.
    Status string
    TraceInstanceId string
    The ID of the trace instance.
    TraceInstanceName string
    The name of the trace instance.
    Id string
    The provider-assigned unique ID for this managed resource.
    TotalCount int
    The total count of trace instances.
    TraceInstances []GetTraceInstancesTraceInstance
    The list of trace instances.
    CsAccountChannel string
    CS account channel identifier.
    IamProjectName string
    OutputFile string
    ProjectId string
    The ID of the project.
    ProjectName string
    The name of the project.
    Status string
    TraceInstanceId string
    The ID of the trace instance.
    TraceInstanceName string
    The name of the trace instance.
    id String
    The provider-assigned unique ID for this managed resource.
    totalCount Integer
    The total count of trace instances.
    traceInstances List<GetTraceInstancesTraceInstance>
    The list of trace instances.
    csAccountChannel String
    CS account channel identifier.
    iamProjectName String
    outputFile String
    projectId String
    The ID of the project.
    projectName String
    The name of the project.
    status String
    traceInstanceId String
    The ID of the trace instance.
    traceInstanceName String
    The name of the trace instance.
    id string
    The provider-assigned unique ID for this managed resource.
    totalCount number
    The total count of trace instances.
    traceInstances GetTraceInstancesTraceInstance[]
    The list of trace instances.
    csAccountChannel string
    CS account channel identifier.
    iamProjectName string
    outputFile string
    projectId string
    The ID of the project.
    projectName string
    The name of the project.
    status string
    traceInstanceId string
    The ID of the trace instance.
    traceInstanceName string
    The name of the trace instance.
    id str
    The provider-assigned unique ID for this managed resource.
    total_count int
    The total count of trace instances.
    trace_instances Sequence[GetTraceInstancesTraceInstance]
    The list of trace instances.
    cs_account_channel str
    CS account channel identifier.
    iam_project_name str
    output_file str
    project_id str
    The ID of the project.
    project_name str
    The name of the project.
    status str
    trace_instance_id str
    The ID of the trace instance.
    trace_instance_name str
    The name of the trace instance.
    id String
    The provider-assigned unique ID for this managed resource.
    totalCount Number
    The total count of trace instances.
    traceInstances List<Property Map>
    The list of trace instances.
    csAccountChannel String
    CS account channel identifier.
    iamProjectName String
    outputFile String
    projectId String
    The ID of the project.
    projectName String
    The name of the project.
    status String
    traceInstanceId String
    The ID of the trace instance.
    traceInstanceName String
    The name of the trace instance.

    Supporting Types

    GetTraceInstancesTraceInstance

    BackendConfig GetTraceInstancesTraceInstanceBackendConfig
    The backend config of the trace instance.
    CreateTime string
    The create time of the trace instance.
    CsAccountChannel string
    CS account channel identifier.
    DependencyTopicId string
    The ID of the dependency topic.
    DependencyTopicTopicName string
    The name of the dependency topic.
    Description string
    The description of the trace instance.
    ModifyTime string
    The update time of the trace instance.
    ProjectId string
    The ID of the project.
    ProjectName string
    The name of the project.
    TraceInstanceId string
    The ID of the trace instance.
    TraceInstanceName string
    The name of the trace instance.
    TraceInstanceStatus string
    The status of the trace instance.
    TraceTopicId string
    The ID of the trace topic.
    TraceTopicName string
    The name of the trace topic.
    BackendConfig GetTraceInstancesTraceInstanceBackendConfig
    The backend config of the trace instance.
    CreateTime string
    The create time of the trace instance.
    CsAccountChannel string
    CS account channel identifier.
    DependencyTopicId string
    The ID of the dependency topic.
    DependencyTopicTopicName string
    The name of the dependency topic.
    Description string
    The description of the trace instance.
    ModifyTime string
    The update time of the trace instance.
    ProjectId string
    The ID of the project.
    ProjectName string
    The name of the project.
    TraceInstanceId string
    The ID of the trace instance.
    TraceInstanceName string
    The name of the trace instance.
    TraceInstanceStatus string
    The status of the trace instance.
    TraceTopicId string
    The ID of the trace topic.
    TraceTopicName string
    The name of the trace topic.
    backendConfig GetTraceInstancesTraceInstanceBackendConfig
    The backend config of the trace instance.
    createTime String
    The create time of the trace instance.
    csAccountChannel String
    CS account channel identifier.
    dependencyTopicId String
    The ID of the dependency topic.
    dependencyTopicTopicName String
    The name of the dependency topic.
    description String
    The description of the trace instance.
    modifyTime String
    The update time of the trace instance.
    projectId String
    The ID of the project.
    projectName String
    The name of the project.
    traceInstanceId String
    The ID of the trace instance.
    traceInstanceName String
    The name of the trace instance.
    traceInstanceStatus String
    The status of the trace instance.
    traceTopicId String
    The ID of the trace topic.
    traceTopicName String
    The name of the trace topic.
    backendConfig GetTraceInstancesTraceInstanceBackendConfig
    The backend config of the trace instance.
    createTime string
    The create time of the trace instance.
    csAccountChannel string
    CS account channel identifier.
    dependencyTopicId string
    The ID of the dependency topic.
    dependencyTopicTopicName string
    The name of the dependency topic.
    description string
    The description of the trace instance.
    modifyTime string
    The update time of the trace instance.
    projectId string
    The ID of the project.
    projectName string
    The name of the project.
    traceInstanceId string
    The ID of the trace instance.
    traceInstanceName string
    The name of the trace instance.
    traceInstanceStatus string
    The status of the trace instance.
    traceTopicId string
    The ID of the trace topic.
    traceTopicName string
    The name of the trace topic.
    backend_config GetTraceInstancesTraceInstanceBackendConfig
    The backend config of the trace instance.
    create_time str
    The create time of the trace instance.
    cs_account_channel str
    CS account channel identifier.
    dependency_topic_id str
    The ID of the dependency topic.
    dependency_topic_topic_name str
    The name of the dependency topic.
    description str
    The description of the trace instance.
    modify_time str
    The update time of the trace instance.
    project_id str
    The ID of the project.
    project_name str
    The name of the project.
    trace_instance_id str
    The ID of the trace instance.
    trace_instance_name str
    The name of the trace instance.
    trace_instance_status str
    The status of the trace instance.
    trace_topic_id str
    The ID of the trace topic.
    trace_topic_name str
    The name of the trace topic.
    backendConfig Property Map
    The backend config of the trace instance.
    createTime String
    The create time of the trace instance.
    csAccountChannel String
    CS account channel identifier.
    dependencyTopicId String
    The ID of the dependency topic.
    dependencyTopicTopicName String
    The name of the dependency topic.
    description String
    The description of the trace instance.
    modifyTime String
    The update time of the trace instance.
    projectId String
    The ID of the project.
    projectName String
    The name of the project.
    traceInstanceId String
    The ID of the trace instance.
    traceInstanceName String
    The name of the trace instance.
    traceInstanceStatus String
    The status of the trace instance.
    traceTopicId String
    The ID of the trace topic.
    traceTopicName String
    The name of the trace topic.

    GetTraceInstancesTraceInstanceBackendConfig

    ArchiveTtl int
    Archive storage duration in days.
    AutoSplit bool
    Whether to enable auto split.
    ColdTtl int
    Infrequent storage duration in days.
    EnableHotTtl bool
    Whether to enable tiered storage.
    HotTtl int
    Standard storage duration in days.
    MaxSplitPartitions int
    Max split partitions.
    Ttl int
    Total log retention time in days.
    ArchiveTtl int
    Archive storage duration in days.
    AutoSplit bool
    Whether to enable auto split.
    ColdTtl int
    Infrequent storage duration in days.
    EnableHotTtl bool
    Whether to enable tiered storage.
    HotTtl int
    Standard storage duration in days.
    MaxSplitPartitions int
    Max split partitions.
    Ttl int
    Total log retention time in days.
    archiveTtl Integer
    Archive storage duration in days.
    autoSplit Boolean
    Whether to enable auto split.
    coldTtl Integer
    Infrequent storage duration in days.
    enableHotTtl Boolean
    Whether to enable tiered storage.
    hotTtl Integer
    Standard storage duration in days.
    maxSplitPartitions Integer
    Max split partitions.
    ttl Integer
    Total log retention time in days.
    archiveTtl number
    Archive storage duration in days.
    autoSplit boolean
    Whether to enable auto split.
    coldTtl number
    Infrequent storage duration in days.
    enableHotTtl boolean
    Whether to enable tiered storage.
    hotTtl number
    Standard storage duration in days.
    maxSplitPartitions number
    Max split partitions.
    ttl number
    Total log retention time in days.
    archive_ttl int
    Archive storage duration in days.
    auto_split bool
    Whether to enable auto split.
    cold_ttl int
    Infrequent storage duration in days.
    enable_hot_ttl bool
    Whether to enable tiered storage.
    hot_ttl int
    Standard storage duration in days.
    max_split_partitions int
    Max split partitions.
    ttl int
    Total log retention time in days.
    archiveTtl Number
    Archive storage duration in days.
    autoSplit Boolean
    Whether to enable auto split.
    coldTtl Number
    Infrequent storage duration in days.
    enableHotTtl Boolean
    Whether to enable tiered storage.
    hotTtl Number
    Standard storage duration in days.
    maxSplitPartitions Number
    Max split partitions.
    ttl Number
    Total log retention time in days.

    Package Details

    Repository
    volcengine volcengine/pulumi-volcengine
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the volcengine Terraform Provider.
    volcengine logo
    Volcengine v0.0.45 published on Tuesday, Feb 10, 2026 by Volcengine
      Meet Neo: Your AI Platform Teammate