AWS::IAM::UserToGroupAddition - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::IAM::UserToGroupAddition

Adds the specified user to the specified group.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON

{ "Type" : "AWS::IAM::UserToGroupAddition", "Properties" : { "GroupName" : String, "Users" : [ String, ... ] } }

YAML

Type: AWS::IAM::UserToGroupAddition Properties: GroupName: String Users: - String

Properties

GroupName

The name of the group to update.

This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

Required: Yes

Type: String

Pattern: [\w+=,.@-]+

Minimum: 1

Maximum: 128

Update requires: No interruption

Users

A list of the names of the users that you want to add to the group.

Required: Yes

Type: Array of String

Update requires: No interruption

Return values

Ref

When the logical ID of this resource is provided to the Ref intrinsic function, Ref returns the resource name.

For example:

{ "Ref": "MyUserToGroupAddition" }

For the AWS::IAM::UserToGroupAddition resource with the logical ID MyUserToGroupAddition, Ref will return the Amazon resource name.

For more information about using the Ref function, see Ref.

See also