@pulumi/aws/iam/getRoles.js

A Pulumi package for creating and managing Amazon Web Services (AWS) cloud resources.

"use strict";
// *** WARNING: this file was generated by pulumi-language-nodejs. ***
// *** Do not edit by hand unless you're certain you know what you are doing! ***
Object.defineProperty(exports, "__esModule", { value: true });
exports.getRolesOutput = exports.getRoles = void 0;
const pulumi = require("@pulumi/pulumi");
const utilities = require("../utilities");
/**
 * Use this data source to get the ARNs and Names of IAM Roles.
 *
 * ## Example Usage
 *
 * ### All roles in an account
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as aws from "@pulumi/aws";
 *
 * const roles = aws.iam.getRoles({});
 * ```
 *
 * ### Roles filtered by name regex
 *
 * Roles whose role-name contains `project`
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as aws from "@pulumi/aws";
 *
 * const roles = aws.iam.getRoles({
 *     nameRegex: ".*project.*",
 * });
 * ```
 *
 * ### Roles filtered by path prefix
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as aws from "@pulumi/aws";
 *
 * const roles = aws.iam.getRoles({
 *     pathPrefix: "/custom-path",
 * });
 * ```
 *
 * ### Roles provisioned by AWS SSO
 *
 * Roles in the account filtered by path prefix
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as aws from "@pulumi/aws";
 *
 * const roles = aws.iam.getRoles({
 *     pathPrefix: "/aws-reserved/sso.amazonaws.com/",
 * });
 * ```
 *
 * Specific role in the account filtered by name regex and path prefix
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as aws from "@pulumi/aws";
 *
 * const roles = aws.iam.getRoles({
 *     nameRegex: "AWSReservedSSO_permission_set_name_.*",
 *     pathPrefix: "/aws-reserved/sso.amazonaws.com/",
 * });
 * ```
 */
function getRoles(args, opts) {
    args = args || {};
    opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts || {});
    return pulumi.runtime.invoke("aws:iam/getRoles:getRoles", {
        "nameRegex": args.nameRegex,
        "pathPrefix": args.pathPrefix,
    }, opts);
}
exports.getRoles = getRoles;
/**
 * Use this data source to get the ARNs and Names of IAM Roles.
 *
 * ## Example Usage
 *
 * ### All roles in an account
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as aws from "@pulumi/aws";
 *
 * const roles = aws.iam.getRoles({});
 * ```
 *
 * ### Roles filtered by name regex
 *
 * Roles whose role-name contains `project`
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as aws from "@pulumi/aws";
 *
 * const roles = aws.iam.getRoles({
 *     nameRegex: ".*project.*",
 * });
 * ```
 *
 * ### Roles filtered by path prefix
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as aws from "@pulumi/aws";
 *
 * const roles = aws.iam.getRoles({
 *     pathPrefix: "/custom-path",
 * });
 * ```
 *
 * ### Roles provisioned by AWS SSO
 *
 * Roles in the account filtered by path prefix
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as aws from "@pulumi/aws";
 *
 * const roles = aws.iam.getRoles({
 *     pathPrefix: "/aws-reserved/sso.amazonaws.com/",
 * });
 * ```
 *
 * Specific role in the account filtered by name regex and path prefix
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as aws from "@pulumi/aws";
 *
 * const roles = aws.iam.getRoles({
 *     nameRegex: "AWSReservedSSO_permission_set_name_.*",
 *     pathPrefix: "/aws-reserved/sso.amazonaws.com/",
 * });
 * ```
 */
function getRolesOutput(args, opts) {
    args = args || {};
    opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts || {});
    return pulumi.runtime.invokeOutput("aws:iam/getRoles:getRoles", {
        "nameRegex": args.nameRegex,
        "pathPrefix": args.pathPrefix,
    }, opts);
}
exports.getRolesOutput = getRolesOutput;
//# sourceMappingURL=getRoles.js.map