pulumi-alicloud-kotlin/com.pulumi.alicloud.ram.kotlin/RamFunctions/getUsers

getUsers

suspend fun getUsers(argument: GetUsersPlainArgs): GetUsersResult

This data source provides a list of RAM users in an Alibaba Cloud account according to the specified filters.

NOTE: Available since v1.0.0+.

Example Usage

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.ram.RamFunctions;
import com.pulumi.alicloud.ram.inputs.GetUsersArgs;
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 usersDs = RamFunctions.getUsers(GetUsersArgs.builder()
            .outputFile("users.txt")
            .groupName("group1")
            .policyName("AliyunACSDefaultAccess")
            .policyType("Custom")
            .nameRegex("^user")
            .build());
        ctx.export("firstUserId", usersDs.applyValue(getUsersResult -> getUsersResult.users()[0].id()));
    }
}
Content copied to clipboard

Return

A collection of values returned by getUsers.

Parameters

argument

A collection of arguments for invoking getUsers.

suspend fun getUsers(groupName: String? = null, ids: List<String>? = null, nameRegex: String? = null, outputFile: String? = null, policyName: String? = null, policyType: String? = null): GetUsersResult

Return

A collection of values returned by getUsers.

See also

Parameters

groupName

Filter results by a specific group name. Returned users are in the specified group.

ids

A list of ram user IDs.

nameRegex

A regex string to filter resulting users by their names.

outputFile

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

policyName

Filter results by a specific policy name. If you set this parameter without setting policy_type, the later will be automatically set to System. Returned users are attached to the specified policy.

policyType

Filter results by a specific policy type. Valid values are Custom and System. If you set this parameter, you must set policy_name as well.

suspend fun getUsers(argument: suspend GetUsersPlainArgsBuilder.() -> Unit): GetUsersResult

Return

A collection of values returned by getUsers.

See also

Parameters

argument

Builder for com.pulumi.alicloud.ram.kotlin.inputs.GetUsersPlainArgs.