AWS::IAM::UserToGroupAddition - Amazon CloudFormation
SyntaxPropertiesReturn valuesSee also
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).

This is the new Amazon CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the Amazon CloudFormation User Guide.

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.

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

Id

The stable and unique string identifying the group. For more information about IDs, see IAM identifiers in the IAM User Guide.

See also