pulumi-aws-kotlin/com.pulumi.aws.iam.kotlin/Group

Group

class Group : KotlinCustomResource

Provides an IAM group.

NOTE on user management: Using aws.iam.GroupMembership or aws.iam.UserGroupMembership resources in addition to manually managing user/group membership using the console may lead to configuration drift or conflicts. For this reason, it's recommended to either manage membership entirely with the provider or entirely within the AWS console.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const developers = new aws.iam.Group("developers", {
    name: "developers",
    path: "/users/",
});

import pulumi
import pulumi_aws as aws
developers = aws.iam.Group("developers",
    name="developers",
    path="/users/")

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
    var developers = new Aws.Iam.Group("developers", new()
    {
        Name = "developers",
        Path = "/users/",
    });
});

package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/iam"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := iam.NewGroup(ctx, "developers", &iam.GroupArgs{
			Name: pulumi.String("developers"),
			Path: pulumi.String("/users/"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.iam.Group;
import com.pulumi.aws.iam.GroupArgs;
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) {
        var developers = new Group("developers", GroupArgs.builder()
            .name("developers")
            .path("/users/")
            .build());
    }
}

resources:
  developers:
    type: aws:iam:Group
    properties:
      name: developers
      path: /users/

Import

Using pulumi import, import IAM Groups using the name. For example:

$ pulumi import aws:iam/group:Group developers developers

Properties

arn

val arn: Output<String>

The ARN assigned by AWS for this group.

val id: Output<String>

name

val name: Output<String>

The group's name. The name must consist of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: =,.@-_.. Group names are not distinguished by case. For example, you cannot create groups named both "ADMINS" and "admins".

path

val path: Output<String>?

Path in which to create the group.

pulumiChildResources

val pulumiChildResources: Set<KotlinResource>

pulumiResourceName

val pulumiResourceName: String

pulumiResourceType

val pulumiResourceType: String

uniqueId

val uniqueId: Output<String>

The 1 assigned by AWS.

urn

val urn: Output<String>