1. Packages
  2. Volcengine
  3. API Docs
  4. tls
  5. TagResources
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
    Deprecated: volcengine.tls.TagResources has been deprecated in favor of volcengine.tls.getTagResources

    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 TagResources

    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 tagResources(args: TagResourcesArgs, opts?: InvokeOptions): Promise<TagResourcesResult>
    function tagResourcesOutput(args: TagResourcesOutputArgs, opts?: InvokeOptions): Output<TagResourcesResult>
    def 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[TagResourcesTagFilter]] = None,
                      opts: Optional[InvokeOptions] = None) -> TagResourcesResult
    def 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[TagResourcesTagFilterArgs]]]] = None,
                      opts: Optional[InvokeOptions] = None) -> Output[TagResourcesResult]
    func TagResources(ctx *Context, args *TagResourcesArgs, opts ...InvokeOption) (*TagResourcesResult, error)
    func TagResourcesOutput(ctx *Context, args *TagResourcesOutputArgs, opts ...InvokeOption) TagResourcesResultOutput
    public static class TagResources 
    {
        public static Task<TagResourcesResult> InvokeAsync(TagResourcesArgs args, InvokeOptions? opts = null)
        public static Output<TagResourcesResult> Invoke(TagResourcesInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<TagResourcesResult> tagResources(TagResourcesArgs args, InvokeOptions options)
    public static Output<TagResourcesResult> tagResources(TagResourcesArgs args, InvokeOptions options)
    
    fn::invoke:
      function: volcengine:tls:TagResources
      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<TagResourcesTagFilter>
    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 []TagResourcesTagFilter
    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<TagResourcesTagFilter>
    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 TagResourcesTagFilter[]
    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[TagResourcesTagFilter]
    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.

    TagResources 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<TagResourcesTag>
    The list of tags.
    MaxResults int
    NextToken string
    OutputFile string
    TagFilters List<TagResourcesTagFilter>
    Id string
    The provider-assigned unique ID for this managed resource.
    ResourceIds []string
    ResourceType string
    The type of the resource.
    Tags []TagResourcesTag
    The list of tags.
    MaxResults int
    NextToken string
    OutputFile string
    TagFilters []TagResourcesTagFilter
    id String
    The provider-assigned unique ID for this managed resource.
    resourceIds List<String>
    resourceType String
    The type of the resource.
    tags List<TagResourcesTag>
    The list of tags.
    maxResults Integer
    nextToken String
    outputFile String
    tagFilters List<TagResourcesTagFilter>
    id string
    The provider-assigned unique ID for this managed resource.
    resourceIds string[]
    resourceType string
    The type of the resource.
    tags TagResourcesTag[]
    The list of tags.
    maxResults number
    nextToken string
    outputFile string
    tagFilters TagResourcesTagFilter[]
    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[TagResourcesTag]
    The list of tags.
    max_results int
    next_token str
    output_file str
    tag_filters Sequence[TagResourcesTagFilter]
    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

    TagResourcesTag

    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.

    TagResourcesTagFilter

    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