1. Packages
  2. Volcengine
  3. API Docs
  4. tls
  5. getTagResources
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 tag resources

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as volcengine from "@pulumi/volcengine";
    
    const basic = volcengine.tls.getTagResources({
        maxResults: 10,
        resourceIds: ["6e6ea17f-ee1d-494f-83f7-c3ecc5c351ea"],
        resourceType: "project",
    });
    const withFilters = volcengine.tls.getTagResources({
        maxResults: 50,
        resourceIds: [
            "project-123456",
            "project-789012",
        ],
        resourceType: "project",
        tagFilters: [
            {
                key: "environment",
                values: [
                    "production",
                    "development",
                ],
            },
            {
                key: "department",
                values: ["devops"],
            },
        ],
    });
    const firstPage = volcengine.tls.getTagResources({
        maxResults: 20,
        resourceIds: ["topic-123456"],
        resourceType: "topic",
    });
    
    import pulumi
    import pulumi_volcengine as volcengine
    
    basic = volcengine.tls.get_tag_resources(max_results=10,
        resource_ids=["6e6ea17f-ee1d-494f-83f7-c3ecc5c351ea"],
        resource_type="project")
    with_filters = volcengine.tls.get_tag_resources(max_results=50,
        resource_ids=[
            "project-123456",
            "project-789012",
        ],
        resource_type="project",
        tag_filters=[
            volcengine.tls.GetTagResourcesTagFilterArgs(
                key="environment",
                values=[
                    "production",
                    "development",
                ],
            ),
            volcengine.tls.GetTagResourcesTagFilterArgs(
                key="department",
                values=["devops"],
            ),
        ])
    first_page = volcengine.tls.get_tag_resources(max_results=20,
        resource_ids=["topic-123456"],
        resource_type="topic")
    
    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.GetTagResources(ctx, &tls.GetTagResourcesArgs{
    			MaxResults: pulumi.IntRef(10),
    			ResourceIds: []string{
    				"6e6ea17f-ee1d-494f-83f7-c3ecc5c351ea",
    			},
    			ResourceType: "project",
    		}, nil)
    		if err != nil {
    			return err
    		}
    		_, err = tls.GetTagResources(ctx, &tls.GetTagResourcesArgs{
    			MaxResults: pulumi.IntRef(50),
    			ResourceIds: []string{
    				"project-123456",
    				"project-789012",
    			},
    			ResourceType: "project",
    			TagFilters: []tls.GetTagResourcesTagFilter{
    				{
    					Key: "environment",
    					Values: []string{
    						"production",
    						"development",
    					},
    				},
    				{
    					Key: "department",
    					Values: []string{
    						"devops",
    					},
    				},
    			},
    		}, nil)
    		if err != nil {
    			return err
    		}
    		_, err = tls.GetTagResources(ctx, &tls.GetTagResourcesArgs{
    			MaxResults: pulumi.IntRef(20),
    			ResourceIds: []string{
    				"topic-123456",
    			},
    			ResourceType: "topic",
    		}, 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 basic = Volcengine.Tls.GetTagResources.Invoke(new()
        {
            MaxResults = 10,
            ResourceIds = new[]
            {
                "6e6ea17f-ee1d-494f-83f7-c3ecc5c351ea",
            },
            ResourceType = "project",
        });
    
        var withFilters = Volcengine.Tls.GetTagResources.Invoke(new()
        {
            MaxResults = 50,
            ResourceIds = new[]
            {
                "project-123456",
                "project-789012",
            },
            ResourceType = "project",
            TagFilters = new[]
            {
                new Volcengine.Tls.Inputs.GetTagResourcesTagFilterInputArgs
                {
                    Key = "environment",
                    Values = new[]
                    {
                        "production",
                        "development",
                    },
                },
                new Volcengine.Tls.Inputs.GetTagResourcesTagFilterInputArgs
                {
                    Key = "department",
                    Values = new[]
                    {
                        "devops",
                    },
                },
            },
        });
    
        var firstPage = Volcengine.Tls.GetTagResources.Invoke(new()
        {
            MaxResults = 20,
            ResourceIds = new[]
            {
                "topic-123456",
            },
            ResourceType = "topic",
        });
    
    });
    
    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.GetTagResourcesArgs;
    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 basic = TlsFunctions.getTagResources(GetTagResourcesArgs.builder()
                .maxResults(10)
                .resourceIds("6e6ea17f-ee1d-494f-83f7-c3ecc5c351ea")
                .resourceType("project")
                .build());
    
            final var withFilters = TlsFunctions.getTagResources(GetTagResourcesArgs.builder()
                .maxResults(50)
                .resourceIds(            
                    "project-123456",
                    "project-789012")
                .resourceType("project")
                .tagFilters(            
                    GetTagResourcesTagFilterArgs.builder()
                        .key("environment")
                        .values(                    
                            "production",
                            "development")
                        .build(),
                    GetTagResourcesTagFilterArgs.builder()
                        .key("department")
                        .values("devops")
                        .build())
                .build());
    
            final var firstPage = TlsFunctions.getTagResources(GetTagResourcesArgs.builder()
                .maxResults(20)
                .resourceIds("topic-123456")
                .resourceType("topic")
                .build());
    
        }
    }
    
    variables:
      basic:
        fn::invoke:
          Function: volcengine:tls:getTagResources
          Arguments:
            maxResults: 10
            resourceIds:
              - 6e6ea17f-ee1d-494f-83f7-c3ecc5c351ea
            resourceType: project
      withFilters:
        fn::invoke:
          Function: volcengine:tls:getTagResources
          Arguments:
            maxResults: 50
            resourceIds:
              - project-123456
              - project-789012
            resourceType: project
            tagFilters:
              - key: environment
                values:
                  - production
                  - development
              - key: department
                values:
                  - devops
      firstPage:
        fn::invoke:
          Function: volcengine:tls:getTagResources
          Arguments:
            maxResults: 20
            resourceIds:
              - topic-123456
            resourceType: topic
    

    Using getTagResources

    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 getTagResources(args: GetTagResourcesArgs, opts?: InvokeOptions): Promise<GetTagResourcesResult>
    function getTagResourcesOutput(args: GetTagResourcesOutputArgs, opts?: InvokeOptions): Output<GetTagResourcesResult>
    def get_tag_resources(max_results: Optional[int] = None,
                          next_token: Optional[str] = None,
                          output_file: Optional[str] = None,
                          resource_ids: Optional[Sequence[str]] = None,
                          resource_type: Optional[str] = None,
                          tag_filters: Optional[Sequence[GetTagResourcesTagFilter]] = None,
                          opts: Optional[InvokeOptions] = None) -> GetTagResourcesResult
    def get_tag_resources_output(max_results: Optional[pulumi.Input[int]] = None,
                          next_token: Optional[pulumi.Input[str]] = None,
                          output_file: Optional[pulumi.Input[str]] = None,
                          resource_ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                          resource_type: Optional[pulumi.Input[str]] = None,
                          tag_filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetTagResourcesTagFilterArgs]]]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetTagResourcesResult]
    func GetTagResources(ctx *Context, args *GetTagResourcesArgs, opts ...InvokeOption) (*GetTagResourcesResult, error)
    func GetTagResourcesOutput(ctx *Context, args *GetTagResourcesOutputArgs, opts ...InvokeOption) GetTagResourcesResultOutput

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

    public static class GetTagResources 
    {
        public static Task<GetTagResourcesResult> InvokeAsync(GetTagResourcesArgs args, InvokeOptions? opts = null)
        public static Output<GetTagResourcesResult> Invoke(GetTagResourcesInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetTagResourcesResult> getTagResources(GetTagResourcesArgs args, InvokeOptions options)
    public static Output<GetTagResourcesResult> getTagResources(GetTagResourcesArgs args, InvokeOptions options)
    
    fn::invoke:
      function: volcengine:tls/getTagResources:getTagResources
      arguments:
        # arguments dictionary

    The following arguments are supported:

    ResourceIds List<string>
    The IDs of the resources.
    ResourceType string
    The type of the resource. Valid values: project, topic, shipper, host_group, host, consumer_group, rule, alarm, alarm_notify_group, etl_task, import_task, schedule_sql_task, download_task, trace_instance.
    MaxResults int
    The number of results returned per page. Default value: 20. Maximum value: 100.
    NextToken string
    The token to get the next page of results. If this parameter is left empty, it means to get the first page of results.
    OutputFile string
    File name where to save data source results.
    TagFilters List<GetTagResourcesTagFilter>
    The tag filters.
    ResourceIds []string
    The IDs of the resources.
    ResourceType string
    The type of the resource. Valid values: project, topic, shipper, host_group, host, consumer_group, rule, alarm, alarm_notify_group, etl_task, import_task, schedule_sql_task, download_task, trace_instance.
    MaxResults int
    The number of results returned per page. Default value: 20. Maximum value: 100.
    NextToken string
    The token to get the next page of results. If this parameter is left empty, it means to get the first page of results.
    OutputFile string
    File name where to save data source results.
    TagFilters []GetTagResourcesTagFilter
    The tag filters.
    resourceIds List<String>
    The IDs of the resources.
    resourceType String
    The type of the resource. Valid values: project, topic, shipper, host_group, host, consumer_group, rule, alarm, alarm_notify_group, etl_task, import_task, schedule_sql_task, download_task, trace_instance.
    maxResults Integer
    The number of results returned per page. Default value: 20. Maximum value: 100.
    nextToken String
    The token to get the next page of results. If this parameter is left empty, it means to get the first page of results.
    outputFile String
    File name where to save data source results.
    tagFilters List<GetTagResourcesTagFilter>
    The tag filters.
    resourceIds string[]
    The IDs of the resources.
    resourceType string
    The type of the resource. Valid values: project, topic, shipper, host_group, host, consumer_group, rule, alarm, alarm_notify_group, etl_task, import_task, schedule_sql_task, download_task, trace_instance.
    maxResults number
    The number of results returned per page. Default value: 20. Maximum value: 100.
    nextToken string
    The token to get the next page of results. If this parameter is left empty, it means to get the first page of results.
    outputFile string
    File name where to save data source results.
    tagFilters GetTagResourcesTagFilter[]
    The tag filters.
    resource_ids Sequence[str]
    The IDs of the resources.
    resource_type str
    The type of the resource. Valid values: project, topic, shipper, host_group, host, consumer_group, rule, alarm, alarm_notify_group, etl_task, import_task, schedule_sql_task, download_task, trace_instance.
    max_results int
    The number of results returned per page. Default value: 20. Maximum value: 100.
    next_token str
    The token to get the next page of results. If this parameter is left empty, it means to get the first page of results.
    output_file str
    File name where to save data source results.
    tag_filters Sequence[GetTagResourcesTagFilter]
    The tag filters.
    resourceIds List<String>
    The IDs of the resources.
    resourceType String
    The type of the resource. Valid values: project, topic, shipper, host_group, host, consumer_group, rule, alarm, alarm_notify_group, etl_task, import_task, schedule_sql_task, download_task, trace_instance.
    maxResults Number
    The number of results returned per page. Default value: 20. Maximum value: 100.
    nextToken String
    The token to get the next page of results. If this parameter is left empty, it means to get the first page of results.
    outputFile String
    File name where to save data source results.
    tagFilters List<Property Map>
    The tag filters.

    getTagResources Result

    The following output properties are available:

    Id string
    The provider-assigned unique ID for this managed resource.
    ResourceIds List<string>
    ResourceType string
    The type of the resource.
    Tags List<GetTagResourcesTag>
    The list of tags.
    MaxResults int
    NextToken string
    OutputFile string
    TagFilters List<GetTagResourcesTagFilter>
    Id string
    The provider-assigned unique ID for this managed resource.
    ResourceIds []string
    ResourceType string
    The type of the resource.
    Tags []GetTagResourcesTag
    The list of tags.
    MaxResults int
    NextToken string
    OutputFile string
    TagFilters []GetTagResourcesTagFilter
    id String
    The provider-assigned unique ID for this managed resource.
    resourceIds List<String>
    resourceType String
    The type of the resource.
    tags List<GetTagResourcesTag>
    The list of tags.
    maxResults Integer
    nextToken String
    outputFile String
    tagFilters List<GetTagResourcesTagFilter>
    id string
    The provider-assigned unique ID for this managed resource.
    resourceIds string[]
    resourceType string
    The type of the resource.
    tags GetTagResourcesTag[]
    The list of tags.
    maxResults number
    nextToken string
    outputFile string
    tagFilters GetTagResourcesTagFilter[]
    id str
    The provider-assigned unique ID for this managed resource.
    resource_ids Sequence[str]
    resource_type str
    The type of the resource.
    tags Sequence[GetTagResourcesTag]
    The list of tags.
    max_results int
    next_token str
    output_file str
    tag_filters Sequence[GetTagResourcesTagFilter]
    id String
    The provider-assigned unique ID for this managed resource.
    resourceIds List<String>
    resourceType String
    The type of the resource.
    tags List<Property Map>
    The list of tags.
    maxResults Number
    nextToken String
    outputFile String
    tagFilters List<Property Map>

    Supporting Types

    GetTagResourcesTag

    Key string
    The key of the tag.
    ResourceId string
    The ID of the resource.
    ResourceType string
    The type of the resource. Valid values: project, topic, shipper, host_group, host, consumer_group, rule, alarm, alarm_notify_group, etl_task, import_task, schedule_sql_task, download_task, trace_instance.
    Value string
    The value of the tag.
    Key string
    The key of the tag.
    ResourceId string
    The ID of the resource.
    ResourceType string
    The type of the resource. Valid values: project, topic, shipper, host_group, host, consumer_group, rule, alarm, alarm_notify_group, etl_task, import_task, schedule_sql_task, download_task, trace_instance.
    Value string
    The value of the tag.
    key String
    The key of the tag.
    resourceId String
    The ID of the resource.
    resourceType String
    The type of the resource. Valid values: project, topic, shipper, host_group, host, consumer_group, rule, alarm, alarm_notify_group, etl_task, import_task, schedule_sql_task, download_task, trace_instance.
    value String
    The value of the tag.
    key string
    The key of the tag.
    resourceId string
    The ID of the resource.
    resourceType string
    The type of the resource. Valid values: project, topic, shipper, host_group, host, consumer_group, rule, alarm, alarm_notify_group, etl_task, import_task, schedule_sql_task, download_task, trace_instance.
    value string
    The value of the tag.
    key str
    The key of the tag.
    resource_id str
    The ID of the resource.
    resource_type str
    The type of the resource. Valid values: project, topic, shipper, host_group, host, consumer_group, rule, alarm, alarm_notify_group, etl_task, import_task, schedule_sql_task, download_task, trace_instance.
    value str
    The value of the tag.
    key String
    The key of the tag.
    resourceId String
    The ID of the resource.
    resourceType String
    The type of the resource. Valid values: project, topic, shipper, host_group, host, consumer_group, rule, alarm, alarm_notify_group, etl_task, import_task, schedule_sql_task, download_task, trace_instance.
    value String
    The value of the tag.

    GetTagResourcesTagFilter

    Key string
    The key of the tag filter.
    Values List<string>
    The values of the tag filter.
    Key string
    The key of the tag filter.
    Values []string
    The values of the tag filter.
    key String
    The key of the tag filter.
    values List<String>
    The values of the tag filter.
    key string
    The key of the tag filter.
    values string[]
    The values of the tag filter.
    key str
    The key of the tag filter.
    values Sequence[str]
    The values of the tag filter.
    key String
    The key of the tag filter.
    values List<String>
    The values of the tag filter.

    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