Skip to content

Latest commit

 

History

History
111 lines (67 loc) · 3.25 KB

iam_group.md

File metadata and controls

111 lines (67 loc) · 3.25 KB
Raw
permalink
/iam_group/

iam_group

iam_group represents the aws_iam_group Terraform resource.

This package contains functions and utilities for setting up the resource using Jsonnet code.

Index

Fields

fn new

new()

aws.iam_group.new injects a new aws_iam_group Terraform resource block into the root module document.

Additionally, this inserts a private function into the _ref attribute that generates references to attributes of the resource. For example, if you added a new instance to the root using:

# arguments omitted for brevity
aws.iam_group.new('some_id')

You can get the reference to the id field of the created aws.iam_group using the reference:

$._ref.aws_iam_group.some_id.get('id')

This is the same as directly entering "${ aws_iam_group.some_id.id }" as the value.

NOTE: if you are chaining multiple resources together in a merge operation, you may not be able to use super, self, or $ to refer to the root object. Instead, make an explicit outer object using local.

Args:

  • resourceLabel (string): The name label of the block.
  • name (string): Set the name field on the resulting resource block.
  • path (string): Set the path field on the resulting resource block. When null, the path field will be omitted from the resulting object.

Returns:

  • A mixin object that injects the new resource into the root Terraform configuration.

fn newAttrs

newAttrs()

aws.iam_group.newAttrs constructs a new object with attributes and blocks configured for the iam_group Terraform resource.

Unlike aws.iam_group.new, this function will not inject the resource block into the root Terraform document. Instead, this must be passed in as the attrs argument for the tf.withResource function to build a complete block.

This is most useful when you need to preprocess the attributes with functions, conditional, or looping logic prior to injecting into a complete block.

Args:

  • name (string): Set the name field on the resulting object.
  • path (string): Set the path field on the resulting object. When null, the path field will be omitted from the resulting object.

Returns:

  • An attribute object that can be used with tf.withResource to construct a new iam_group resource into the root Terraform configuration.

fn withName

withName()

aws.string.withName constructs a mixin object that can be merged into the string Terraform resource block to set or update the name field.

Args:

  • resourceLabel (string): The name label of the block to update.
  • value (string): The value to set for the name field.

fn withPath

withPath()

aws.string.withPath constructs a mixin object that can be merged into the string Terraform resource block to set or update the path field.

Args:

  • resourceLabel (string): The name label of the block to update.
  • value (string): The value to set for the path field.