1. Packages
  2. Strata Cloud Manager Provider
  3. API Docs
  4. getUrlCategoryList
Strata Cloud Manager v0.4.3 published on Saturday, Nov 8, 2025 by Pulumi
scm logo
Strata Cloud Manager v0.4.3 published on Saturday, Nov 8, 2025 by Pulumi

    Retrieves a listing of config items.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as scm from "@pulumi/scm";
    
    //
    // Data source to retrieve a list of URL Category objects.
    //
    // Example 1: Fetch a list of all URL Categories in the "Shared" folder.
    const allShared = scm.getUrlCategoryList({
        folder: "All",
    });
    export const urlCategoriesListAllShared = allShared.then(allShared => allShared.datas);
    // Example 2: Use pagination to get the first 5 URL Categories by name.
    const paginated = scm.getUrlCategoryList({
        folder: "All",
        limit: 5,
        offset: 0,
    });
    export const urlCategoriesListPaginated = paginated.then(paginated => paginated.datas);
    
    import pulumi
    import pulumi_scm as scm
    
    #
    # Data source to retrieve a list of URL Category objects.
    #
    # Example 1: Fetch a list of all URL Categories in the "Shared" folder.
    all_shared = scm.get_url_category_list(folder="All")
    pulumi.export("urlCategoriesListAllShared", all_shared.datas)
    # Example 2: Use pagination to get the first 5 URL Categories by name.
    paginated = scm.get_url_category_list(folder="All",
        limit=5,
        offset=0)
    pulumi.export("urlCategoriesListPaginated", paginated.datas)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-scm/sdk/go/scm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// Data source to retrieve a list of URL Category objects.
    		//
    		// Example 1: Fetch a list of all URL Categories in the "Shared" folder.
    		allShared, err := scm.GetUrlCategoryList(ctx, &scm.GetUrlCategoryListArgs{
    			Folder: pulumi.StringRef("All"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		ctx.Export("urlCategoriesListAllShared", allShared.Datas)
    		// Example 2: Use pagination to get the first 5 URL Categories by name.
    		paginated, err := scm.GetUrlCategoryList(ctx, &scm.GetUrlCategoryListArgs{
    			Folder: pulumi.StringRef("All"),
    			Limit:  pulumi.IntRef(5),
    			Offset: pulumi.IntRef(0),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		ctx.Export("urlCategoriesListPaginated", paginated.Datas)
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Scm = Pulumi.Scm;
    
    return await Deployment.RunAsync(() => 
    {
        //
        // Data source to retrieve a list of URL Category objects.
        //
        // Example 1: Fetch a list of all URL Categories in the "Shared" folder.
        var allShared = Scm.GetUrlCategoryList.Invoke(new()
        {
            Folder = "All",
        });
    
        // Example 2: Use pagination to get the first 5 URL Categories by name.
        var paginated = Scm.GetUrlCategoryList.Invoke(new()
        {
            Folder = "All",
            Limit = 5,
            Offset = 0,
        });
    
        return new Dictionary<string, object?>
        {
            ["urlCategoriesListAllShared"] = allShared.Apply(getUrlCategoryListResult => getUrlCategoryListResult.Datas),
            ["urlCategoriesListPaginated"] = paginated.Apply(getUrlCategoryListResult => getUrlCategoryListResult.Datas),
        };
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.scm.ScmFunctions;
    import com.pulumi.scm.inputs.GetUrlCategoryListArgs;
    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) {
            //
            // Data source to retrieve a list of URL Category objects.
            //
            // Example 1: Fetch a list of all URL Categories in the "Shared" folder.
            final var allShared = ScmFunctions.getUrlCategoryList(GetUrlCategoryListArgs.builder()
                .folder("All")
                .build());
    
            ctx.export("urlCategoriesListAllShared", allShared.datas());
            // Example 2: Use pagination to get the first 5 URL Categories by name.
            final var paginated = ScmFunctions.getUrlCategoryList(GetUrlCategoryListArgs.builder()
                .folder("All")
                .limit(5)
                .offset(0)
                .build());
    
            ctx.export("urlCategoriesListPaginated", paginated.datas());
        }
    }
    
    variables:
      #
      # Data source to retrieve a list of URL Category objects.
      #
    
      # Example 1: Fetch a list of all URL Categories in the "Shared" folder.
      allShared:
        fn::invoke:
          function: scm:getUrlCategoryList
          arguments:
            folder: All
      # Example 2: Use pagination to get the first 5 URL Categories by name.
      paginated:
        fn::invoke:
          function: scm:getUrlCategoryList
          arguments:
            folder: All
            limit: 5
            offset: 0
    outputs:
      # Output the list of all URL Category objects from the "Shared" folder.
      urlCategoriesListAllShared: ${allShared.datas}
      urlCategoriesListPaginated: ${paginated.datas}
    

    Using getUrlCategoryList

    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 getUrlCategoryList(args: GetUrlCategoryListArgs, opts?: InvokeOptions): Promise<GetUrlCategoryListResult>
    function getUrlCategoryListOutput(args: GetUrlCategoryListOutputArgs, opts?: InvokeOptions): Output<GetUrlCategoryListResult>
    def get_url_category_list(device: Optional[str] = None,
                              folder: Optional[str] = None,
                              limit: Optional[int] = None,
                              name: Optional[str] = None,
                              offset: Optional[int] = None,
                              snippet: Optional[str] = None,
                              opts: Optional[InvokeOptions] = None) -> GetUrlCategoryListResult
    def get_url_category_list_output(device: Optional[pulumi.Input[str]] = None,
                              folder: Optional[pulumi.Input[str]] = None,
                              limit: Optional[pulumi.Input[int]] = None,
                              name: Optional[pulumi.Input[str]] = None,
                              offset: Optional[pulumi.Input[int]] = None,
                              snippet: Optional[pulumi.Input[str]] = None,
                              opts: Optional[InvokeOptions] = None) -> Output[GetUrlCategoryListResult]
    func GetUrlCategoryList(ctx *Context, args *GetUrlCategoryListArgs, opts ...InvokeOption) (*GetUrlCategoryListResult, error)
    func GetUrlCategoryListOutput(ctx *Context, args *GetUrlCategoryListOutputArgs, opts ...InvokeOption) GetUrlCategoryListResultOutput

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

    public static class GetUrlCategoryList 
    {
        public static Task<GetUrlCategoryListResult> InvokeAsync(GetUrlCategoryListArgs args, InvokeOptions? opts = null)
        public static Output<GetUrlCategoryListResult> Invoke(GetUrlCategoryListInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetUrlCategoryListResult> getUrlCategoryList(GetUrlCategoryListArgs args, InvokeOptions options)
    public static Output<GetUrlCategoryListResult> getUrlCategoryList(GetUrlCategoryListArgs args, InvokeOptions options)
    
    fn::invoke:
      function: scm:index/getUrlCategoryList:getUrlCategoryList
      arguments:
        # arguments dictionary

    The following arguments are supported:

    Device string
    The device of the item.
    Folder string
    The folder of the item. Default: Shared.
    Limit int
    The max number of items to return. Default: 200.
    Name string
    The name of the item.
    Offset int
    The offset of the first item to return.
    Snippet string
    The snippet of the item.
    Device string
    The device of the item.
    Folder string
    The folder of the item. Default: Shared.
    Limit int
    The max number of items to return. Default: 200.
    Name string
    The name of the item.
    Offset int
    The offset of the first item to return.
    Snippet string
    The snippet of the item.
    device String
    The device of the item.
    folder String
    The folder of the item. Default: Shared.
    limit Integer
    The max number of items to return. Default: 200.
    name String
    The name of the item.
    offset Integer
    The offset of the first item to return.
    snippet String
    The snippet of the item.
    device string
    The device of the item.
    folder string
    The folder of the item. Default: Shared.
    limit number
    The max number of items to return. Default: 200.
    name string
    The name of the item.
    offset number
    The offset of the first item to return.
    snippet string
    The snippet of the item.
    device str
    The device of the item.
    folder str
    The folder of the item. Default: Shared.
    limit int
    The max number of items to return. Default: 200.
    name str
    The name of the item.
    offset int
    The offset of the first item to return.
    snippet str
    The snippet of the item.
    device String
    The device of the item.
    folder String
    The folder of the item. Default: Shared.
    limit Number
    The max number of items to return. Default: 200.
    name String
    The name of the item.
    offset Number
    The offset of the first item to return.
    snippet String
    The snippet of the item.

    getUrlCategoryList Result

    The following output properties are available:

    Datas List<GetUrlCategoryListData>
    The data.
    Id string
    The provider-assigned unique ID for this managed resource.
    Tfid string
    Total int
    The total number of items.
    Device string
    The device of the item.
    Folder string
    The folder of the item. Default: Shared.
    Limit int
    The max number of items to return. Default: 200.
    Name string
    The name of the item.
    Offset int
    The offset of the first item to return.
    Snippet string
    The snippet of the item.
    Datas []GetUrlCategoryListData
    The data.
    Id string
    The provider-assigned unique ID for this managed resource.
    Tfid string
    Total int
    The total number of items.
    Device string
    The device of the item.
    Folder string
    The folder of the item. Default: Shared.
    Limit int
    The max number of items to return. Default: 200.
    Name string
    The name of the item.
    Offset int
    The offset of the first item to return.
    Snippet string
    The snippet of the item.
    datas List<GetUrlCategoryListData>
    The data.
    id String
    The provider-assigned unique ID for this managed resource.
    tfid String
    total Integer
    The total number of items.
    device String
    The device of the item.
    folder String
    The folder of the item. Default: Shared.
    limit Integer
    The max number of items to return. Default: 200.
    name String
    The name of the item.
    offset Integer
    The offset of the first item to return.
    snippet String
    The snippet of the item.
    datas GetUrlCategoryListData[]
    The data.
    id string
    The provider-assigned unique ID for this managed resource.
    tfid string
    total number
    The total number of items.
    device string
    The device of the item.
    folder string
    The folder of the item. Default: Shared.
    limit number
    The max number of items to return. Default: 200.
    name string
    The name of the item.
    offset number
    The offset of the first item to return.
    snippet string
    The snippet of the item.
    datas Sequence[GetUrlCategoryListData]
    The data.
    id str
    The provider-assigned unique ID for this managed resource.
    tfid str
    total int
    The total number of items.
    device str
    The device of the item.
    folder str
    The folder of the item. Default: Shared.
    limit int
    The max number of items to return. Default: 200.
    name str
    The name of the item.
    offset int
    The offset of the first item to return.
    snippet str
    The snippet of the item.
    datas List<Property Map>
    The data.
    id String
    The provider-assigned unique ID for this managed resource.
    tfid String
    total Number
    The total number of items.
    device String
    The device of the item.
    folder String
    The folder of the item. Default: Shared.
    limit Number
    The max number of items to return. Default: 200.
    name String
    The name of the item.
    offset Number
    The offset of the first item to return.
    snippet String
    The snippet of the item.

    Supporting Types

    GetUrlCategoryListData

    Description string
    Description
    Device string
    The device in which the resource is defined
    Folder string
    The folder in which the resource is defined
    Id string
    UUID of the resource
    Lists List<string>
    List
    Name string
    Name
    Snippet string
    The snippet in which the resource is defined
    Tfid string
    Type string
    Type
    Description string
    Description
    Device string
    The device in which the resource is defined
    Folder string
    The folder in which the resource is defined
    Id string
    UUID of the resource
    Lists []string
    List
    Name string
    Name
    Snippet string
    The snippet in which the resource is defined
    Tfid string
    Type string
    Type
    description String
    Description
    device String
    The device in which the resource is defined
    folder String
    The folder in which the resource is defined
    id String
    UUID of the resource
    lists List<String>
    List
    name String
    Name
    snippet String
    The snippet in which the resource is defined
    tfid String
    type String
    Type
    description string
    Description
    device string
    The device in which the resource is defined
    folder string
    The folder in which the resource is defined
    id string
    UUID of the resource
    lists string[]
    List
    name string
    Name
    snippet string
    The snippet in which the resource is defined
    tfid string
    type string
    Type
    description str
    Description
    device str
    The device in which the resource is defined
    folder str
    The folder in which the resource is defined
    id str
    UUID of the resource
    lists Sequence[str]
    List
    name str
    Name
    snippet str
    The snippet in which the resource is defined
    tfid str
    type str
    Type
    description String
    Description
    device String
    The device in which the resource is defined
    folder String
    The folder in which the resource is defined
    id String
    UUID of the resource
    lists List<String>
    List
    name String
    Name
    snippet String
    The snippet in which the resource is defined
    tfid String
    type String
    Type

    Package Details

    Repository
    scm pulumi/pulumi-scm
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the scm Terraform Provider.
    scm logo
    Strata Cloud Manager v0.4.3 published on Saturday, Nov 8, 2025 by Pulumi
      Meet Neo: Your AI Platform Teammate