getFolders

This data source provides the Resource Manager Folders of the current Alibaba Cloud user.

NOTE: Available since v1.84.0.

Example Usage

Basic Usage

import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const config = new pulumi.Config();
const name = config.get("name") || "terraform-example";
const _default = new alicloud.resourcemanager.Folder("default", {folderName: name});
const ids = alicloud.resourcemanager.getFoldersOutput({
ids: [_default.id],
});
export const resourceManagerFolderId0 = ids.apply(ids => ids.folders?.[0]?.id);
import pulumi
import pulumi_alicloud as alicloud
config = pulumi.Config()
name = config.get("name")
if name is None:
name = "terraform-example"
default = alicloud.resourcemanager.Folder("default", folder_name=name)
ids = alicloud.resourcemanager.get_folders_output(ids=[default.id])
pulumi.export("resourceManagerFolderId0", ids.folders[0].id)
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
var config = new Config();
var name = config.Get("name") ?? "terraform-example";
var @default = new AliCloud.ResourceManager.Folder("default", new()
{
FolderName = name,
});
var ids = AliCloud.ResourceManager.GetFolders.Invoke(new()
{
Ids = new[]
{
@default.Id,
},
});
return new Dictionary<string, object?>
{
["resourceManagerFolderId0"] = ids&#46;Apply(getFoldersResult => getFoldersResult&#46;Folders[0]?.Id),
};
});
package main
import (
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/resourcemanager"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
cfg := config.New(ctx, "")
name := "terraform-example"
if param := cfg.Get("name"); param != "" {
name = param
}
_default, err := resourcemanager.NewFolder(ctx, "default", &resourcemanager.FolderArgs{
FolderName: pulumi.String(name),
})
if err != nil {
return err
}
ids := resourcemanager.GetFoldersOutput(ctx, resourcemanager.GetFoldersOutputArgs{
Ids: pulumi.StringArray{
_default.ID(),
},
}, nil)
ctx.Export("resourceManagerFolderId0", ids.ApplyT(func(ids resourcemanager.GetFoldersResult) (*string, error) {
return &ids.Folders[0].Id, nil
}).(pulumi.StringPtrOutput))
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.resourcemanager.Folder;
import com.pulumi.alicloud.resourcemanager.FolderArgs;
import com.pulumi.alicloud.resourcemanager.ResourcemanagerFunctions;
import com.pulumi.alicloud.resourcemanager.inputs.GetFoldersArgs;
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 config = ctx.config();
final var name = config.get("name").orElse("terraform-example");
var default_ = new Folder("default", FolderArgs.builder()
.folderName(name)
.build());
final var ids = ResourcemanagerFunctions.getFolders(GetFoldersArgs.builder()
.ids(default_.id())
.build());
ctx.export("resourceManagerFolderId0", ids.applyValue(_ids -> _ids.folders()[0].id()));
}
}
configuration:
name:
type: string
default: terraform-example
resources:
default:
type: alicloud:resourcemanager:Folder
properties:
folderName: ${name}
variables:
ids:
fn::invoke:
function: alicloud:resourcemanager:getFolders
arguments:
ids:
- ${default.id}
outputs:
resourceManagerFolderId0: ${ids.folders[0].id}

Return

A collection of values returned by getFolders.

Parameters

argument

A collection of arguments for invoking getFolders.


suspend fun getFolders(enableDetails: Boolean? = null, ids: List<String>? = null, nameRegex: String? = null, outputFile: String? = null, parentFolderId: String? = null, queryKeyword: String? = null): GetFoldersResult

Return

A collection of values returned by getFolders.

Parameters

enableDetails

Whether to query the detailed list of resource attributes. Default value: false.

ids

A list of Folders IDs.

nameRegex

A regex string to filter results by Folder name.

outputFile

File name where to save data source results (after running pulumi preview).

parentFolderId

The ID of the parent folder. NOTE: If parent_folder_id is not set, the information of the first-level subfolders of the Root folder is queried.

queryKeyword

The keyword used for the query, such as a folder name. Fuzzy match is supported.

See also


suspend fun getFolders(argument: suspend GetFoldersPlainArgsBuilder.() -> Unit): GetFoldersResult

Return

A collection of values returned by getFolders.

Parameters

argument

Builder for com.pulumi.alicloud.resourcemanager.kotlin.inputs.GetFoldersPlainArgs.

See also