You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
| additional\_tag\_map | Additional tags for appending to tags\_as\_list\_of\_maps. Not added to `tags`. |`map(string)`|`{}`| no |
156
157
| attributes | Additional attributes (e.g. `1`) |`list(string)`|`[]`| no |
157
158
| cloud\_watch\_logs\_group\_arn | Specifies a log group name using an Amazon Resource Name (ARN), that represents the log group to which CloudTrail logs will be delivered |`string`|`""`| no |
158
159
| cloud\_watch\_logs\_role\_arn | Specifies the role for the CloudWatch Logs endpoint to assume to write to a user’s log group |`string`|`""`| no |
159
-
| delimiter | Delimiter to be used between `namespace`, `environment`, `stage`, `name` and `attributes`|`string`|`"-"`| no |
160
+
| context | Single object for setting entire context at once.<br>See description of individual variables for details.<br>Leave string and numeric variables as `null` to use default value.<br>Individual variable settings (non-null) override settings in context object,<br>except for attributes, tags, and additional\_tag\_map, which are merged. | <pre>object({<br> enabled = bool<br> namespace = string<br> environment = string<br> stage = string<br> name = string<br> delimiter = string<br> attributes = list(string)<br> tags = map(string)<br> additional_tag_map = map(string)<br> regex_replace_chars = string<br> label_order = list(string)<br> id_length_limit = number<br> })</pre> | <pre>{<br> "additional_tag_map": {},<br> "attributes": [],<br> "delimiter": null,<br> "enabled": true,<br> "environment": null,<br> "id_length_limit": null,<br> "label_order": [],<br> "name": null,<br> "namespace": null,<br> "regex_replace_chars": null,<br> "stage": null,<br> "tags": {}<br>}</pre> | no |
161
+
| delimiter | Delimiter to be used between `namespace`, `environment`, `stage`, `name` and `attributes`.<br>Defaults to `-` (hyphen). Set to `""` to use no delimiter at all. |`string`|`null`| no |
160
162
| enable\_log\_file\_validation | Specifies whether log file integrity validation is enabled. Creates signed digest for validated contents of logs |`bool`|`true`| no |
161
163
| enable\_logging | Enable logging for the trail |`bool`|`true`| no |
162
-
| enabled | Set to false to prevent the module from creating any resources |`bool`|`true`| no |
163
-
| environment | Environment, e.g. 'prod', 'staging', 'dev', 'pre-prod', 'UAT' |`string`|`""`| no |
164
+
| enabled | Set to false to prevent the module from creating any resources |`bool`|`null`| no |
165
+
| environment | Environment, e.g. 'uw2', 'us-west-2', OR 'prod', 'staging', 'dev', 'UAT' |`string`|`null`| no |
164
166
| event\_selector | Specifies an event selector for enabling data event logging. See: https://www.terraform.io/docs/providers/aws/r/cloudtrail.html for details on this variable | <pre>list(object({<br> include_management_events = bool<br> read_write_type = string<br><br> data_resource = list(object({<br> type = string<br> values = list(string)<br> }))<br> }))</pre> |`[]`| no |
167
+
| id\_length\_limit | Limit `id` to this many characters.<br>Set to `0` for unlimited length.<br>Set to `null` for default, which is `0`.<br>Does not affect `id_full`. |`number`|`null`| no |
165
168
| include\_global\_service\_events | Specifies whether the trail is publishing events from global services such as IAM to the log files |`bool`|`false`| no |
166
169
| is\_multi\_region\_trail | Specifies whether the trail is created in the current region or in all regions |`bool`|`false`| no |
167
170
| is\_organization\_trail | The trail is an AWS Organizations trail |`bool`|`false`| no |
168
171
| kms\_key\_arn | Specifies the KMS key ARN to use to encrypt the logs delivered by CloudTrail |`string`|`""`| no |
169
-
| name | Solution name, e.g. 'app' or 'jenkins' |`string`|`""`| no |
170
-
| namespace | Namespace, which could be your organization name or abbreviation, e.g. 'eg' or 'cp' |`string`|`""`| no |
172
+
| label\_order | The naming order of the id output and Name tag.<br>Defaults to ["namespace", "environment", "stage", "name", "attributes"].<br>You can omit any of the 5 elements, but at least one must be present. |`list(string)`|`null`| no |
173
+
| name | Solution name, e.g. 'app' or 'jenkins' |`string`|`null`| no |
174
+
| namespace | Namespace, which could be your organization name or abbreviation, e.g. 'eg' or 'cp' |`string`|`null`| no |
175
+
| regex\_replace\_chars | Regex to replace chars with empty string in `namespace`, `environment`, `stage` and `name`.<br>If not set, `"/[^a-zA-Z0-9-]/"` is used to remove all characters other than hyphens, letters and digits. |`string`|`null`| no |
171
176
| s3\_bucket\_name | S3 bucket name for CloudTrail logs |`string`| n/a | yes |
172
-
| stage | Stage, e.g. 'prod', 'staging', 'dev', OR 'source', 'build', 'test', 'deploy', 'release' |`string`|`""`| no |
177
+
| stage | Stage, e.g. 'prod', 'staging', 'dev', OR 'source', 'build', 'test', 'deploy', 'release' |`string`|`null`| no |
173
178
| tags | Additional tags (e.g. `map('BusinessUnit','XYZ')`|`map(string)`|`{}`| no |
174
179
175
180
## Outputs
@@ -180,6 +185,7 @@ Available targets:
180
185
| cloudtrail\_home\_region | The region in which the trail was created |
0 commit comments