release: v0.60.0 (#1518)

* cdktf: update documentation

* Empty-Commit

---------

Co-authored-by: sebasslash <[email protected]>
Co-authored-by: Sebastian Rivera <[email protected]>

Author: github-actions[bot]

website/docs/cdktf/csharp/d/github_app_installation.html.markdown

@@ -0,0 +1,69 @@
+---
+layout: "tfe"
+page_title: "Terraform Enterprise: tfe_github_app_installation"
+description: |-
+Get information on the Github App Installation.
+---
+
+
+<!-- Please do not edit this file, it is generated. -->
+# Data Source: tfe_github_app_installation
+
+Use this data source to get information about the Github App Installation.
+
+## Example Usage
+
+### Finding a Github App Installation by its installation ID
+
+```csharp
+using Constructs;
+using HashiCorp.Cdktf;
+/*Provider bindings are generated by running cdktf get.
+See https://cdk.tf/provider-generation for more details.*/
+using Gen.Providers.Tfe;
+class MyConvertedCode : TerraformStack
+{
+    public MyConvertedCode(Construct scope, string name) : base(scope, name)
+    {
+        new DataTfeGithubAppInstallation.DataTfeGithubAppInstallation(this, "gha_installation", new DataTfeGithubAppInstallationConfig {
+            InstallationId = 12345678
+        });
+    }
+}
+```
+
+### Finding a Github App Installation by its name
+
+```csharp
+using Constructs;
+using HashiCorp.Cdktf;
+/*Provider bindings are generated by running cdktf get.
+See https://cdk.tf/provider-generation for more details.*/
+using Gen.Providers.Tfe;
+class MyConvertedCode : TerraformStack
+{
+    public MyConvertedCode(Construct scope, string name) : base(scope, name)
+    {
+        new DataTfeGithubAppInstallation.DataTfeGithubAppInstallation(this, "gha_installation", new DataTfeGithubAppInstallationConfig {
+            Name = "github_username_or_organization"
+        });
+    }
+}
+```
+
+## Argument Reference
+
+The following arguments are supported. At least one of `Name`, `InstallationId` must be set.
+
+* `InstallationId` - (Optional) ID of the Github Installation. The installation ID can be found in the URL slug when visiting the installation's configuration page, e.g `Https://githubCom/settings/installations/12345678`.
+* `Name` - (Optional) Name of the Github user or organization account that installed the app.
+
+Must be one of: `InstallationId` or `Name`.
+
+## Attributes Reference
+
+In addition to all arguments above, the following attributes are exported:
+
+* `Id` - The internal ID of the Github Installation. This is different from the `InstallationId`.
+
+<!-- cache-key: cdktf-0.17.0-pre.15 input-5d439ec2ae1e837495b8cb500e2fcfe96d47a32f9fce3a10ffac876fe18a89dc -->

website/docs/cdktf/csharp/d/organization.html.markdown

@@ -47,6 +47,7 @@ In addition to all arguments above, the following attributes are exported:
 * `OwnersTeamSamlRoleId` - The name of the "owners" team.
 * `SendPassingStatusesForUntriggeredSpeculativePlans` - Whether or not to send VCS status updates for untriggered speculative plans. This can be useful if large numbers of untriggered workspaces are exhausting request limits for connected version control service providers like GitHub. Defaults to true. In Terraform Enterprise, this setting has no effect and cannot be changed but is also available in Site Administration.
 * `AggregatedCommitStatusEnabled` - Whether or not to enable Aggregated Status Checks. This can be useful for monorepo repositories with multiple workspaces receiving status checks for events such as a pull request.
+* `SpeculativePlanManagementEnabled` - Whether or not to enable Speculative Plan Management. If true, pending VCS-triggered speculative plans from outdated commits will be cancelled if a newer commit is pushed to the same branch.
 * `DefaultProjectId` - ID of the organization's default project. All workspaces created without specifying a project ID are created in this project.
 
-<!-- cache-key: cdktf-0.17.0-pre.15 input-ef8f010996544db238976f7a2b7dfb50d77204d9275aeacc742c10b942f7c3e6 -->
+<!-- cache-key: cdktf-0.17.0-pre.15 input-9b73f546422e0ab13be41c89f26de4669725b44bfaf8e4720bbd31f838e37f2f -->

website/docs/cdktf/csharp/d/organization_run_task_global_settings.html.markdown

@@ -0,0 +1,49 @@
+---
+layout: "tfe"
+page_title: "Terraform Enterprise: tfe_organization_run_task_global_settings"
+description: |-
+  Get information on a Run task's global settings.
+---
+
+
+<!-- Please do not edit this file, it is generated. -->
+# Data Source: tfe_organization_run_task_global_settings
+
+[Run tasks](https://developer.hashicorp.com/terraform/cloud-docs/workspaces/settings/run-tasks) allow HCP Terraform to interact with external systems at specific points in the HCP Terraform run lifecycle. Run tasks are reusable configurations that you can attach to any workspace in an organization.
+
+The tfe_organization_run_task_global_settings resource creates, updates and destroys the [global settings](https://developer.hashicorp.com/terraform/cloud-docs/workspaces/settings/run-tasks#global-run-tasks) for an [Organization Run task](https://developer.hashicorp.com/terraform/cloud-docs/workspaces/settings/run-tasks#creating-a-run-task). Your organization must have the `GlobalRunTask` [entitlement](https://developer.hashicorp.com/terraform/cloud-docs/api-docs#feature-entitlements) to use global run tasks.
+
+## Example Usage
+
+```csharp
+using Constructs;
+using HashiCorp.Cdktf;
+/*Provider bindings are generated by running cdktf get.
+See https://cdk.tf/provider-generation for more details.*/
+using Gen.Providers.Tfe;
+class MyConvertedCode : TerraformStack
+{
+    public MyConvertedCode(Construct scope, string name) : base(scope, name)
+    {
+        new DataTfeOrganizationRunTaskGlobalSettings.DataTfeOrganizationRunTaskGlobalSettings(this, "example", new DataTfeOrganizationRunTaskGlobalSettingsConfig {
+            TaskId = "task-abc123"
+        });
+    }
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `TaskId` - (Required) The id of the Run task with the global settings.
+
+## Attributes Reference
+
+In addition to all arguments above, the following attributes are exported:
+
+* `Enabled` - Whether the run task will be applied globally.
+* `EnforcementLevel` - The enforcement level of the global task. Valid values are `Advisory` and `Mandatory`.
+* `Stages` - The stages to run the task in. Valid values are one or more of `PrePlan`, `PostPlan`, `PreApply` and `post apply`.
+
+<!-- cache-key: cdktf-0.17.0-pre.15 input-28126418850a686e0d2f6cf108d96720ece413d7749e5fd727286729c468b717 -->

website/docs/cdktf/csharp/d/project.html.markdown

@@ -5,10 +5,14 @@ description: |-
 Get information on a Project.
 ---
 
+
+<!-- Please do not edit this file, it is generated. -->
 # Data Source: tfe_project
 
 Use this data source to get information about a project.
 
+~> **NOTE:** The `WorkspaceIds` and `WorkspaceNames` attributes are not guaranteed to return values in the same order, so they cannot be reliably mapped to one another. To map workspace names to IDs reliably, it is recommended to pass those names into the `TfeWorkspaceIds` data source.
+
 ## Example Usage
 
 ```csharp
@@ -42,4 +46,6 @@ In addition to all arguments above, the following attributes are exported:
 
 * `Id` - The project ID.
 * `WorkspaceIds` - IDs of the workspaces that are associated with the project.
-<!-- cache-key: cdktf-0.17.0-pre.15 input-6d3f57f584544e1199917337f5f8954b7b7709d2cb911131273294430f81b2f2 -->
+* `WorkspaceNames` - Names of the workspaces that are associated with the project.
+
+<!-- cache-key: cdktf-0.17.0-pre.15 input-c0fb226c1ac838d85660d99cb036d77ac141264beb3f94ffd4b3e2369f67b971 -->

website/docs/cdktf/csharp/d/projects.html.markdown

@@ -0,0 +1,48 @@
+---
+layout: "tfe"
+page_title: "Terraform Enterprise: tfe_projects"
+description: |-
+  Get information on projects in an organization.
+---
+
+
+<!-- Please do not edit this file, it is generated. -->
+# Data Source: tfe_projects
+
+Use this data source to get information about all projects in an organization.
+
+## Example Usage
+
+```csharp
+using Constructs;
+using HashiCorp.Cdktf;
+/*Provider bindings are generated by running cdktf get.
+See https://cdk.tf/provider-generation for more details.*/
+using Gen.Providers.Tfe;
+class MyConvertedCode : TerraformStack
+{
+    public MyConvertedCode(Construct scope, string name) : base(scope, name)
+    {
+        new DataTfeProjects.DataTfeProjects(this, "all", new Struct {
+            Organization = "my-org-name"
+        });
+    }
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `Organization` - (Optional) Name of the organization. If omitted, organization must be defined in the provider config.
+
+## Attributes Reference
+
+* `Projects` - List of projects in the organization. Each element contains the following attributes:
+  * `Id` - ID of the project.
+  * `Name` - Name of the project.
+  * `Description` - Description of the organization.
+  * `Organization` - Name of the organization.
+
+
+<!-- cache-key: cdktf-0.17.0-pre.15 input-98a90539531e97fa5e4034996187e685dd605e9a2a8a2d3a58acca240f7dc197 -->

website/docs/cdktf/csharp/d/workspace.html.markdown

@@ -48,6 +48,7 @@ In addition to all arguments above, the following attributes are exported:
 * `AllowDestroyPlan` - Indicates whether destroy plans can be queued on the workspace.
 * `AutoApply` - Indicates whether to automatically apply changes when a Terraform plan is successful.
 * `AutoApplyRunTrigger` - Whether the workspace will automatically apply changes for runs that were created by run triggers from another workspace.
+* `AutoDestroyActivityDuration` - A duration string representing time after workspace activity when an auto-destroy run will be triggered.
 * `AutoDestroyAt` - Future date/time string at which point all resources in a workspace will be scheduled to be deleted.
 * `AssessmentsEnabled` - (Available only in HCP Terraform) Indicates whether health assessments such as drift detection are enabled for the workspace.
 * `FileTriggersEnabled` - Indicates whether runs are triggered based on the changed files in a VCS push (if `True`) or always triggered on every push (if `False`).
@@ -89,4 +90,4 @@ The `VcsRepo` block contains:
 * `OauthTokenId` - OAuth token ID of the configured VCS connection.
 * `TagsRegex` - A regular expression used to trigger a Workspace run for matching Git tags.
 
-<!-- cache-key: cdktf-0.17.0-pre.15 input-7500b2311f3804feb075f040e60989aa8e4fc69cc4ef327b51b7e3ab1f599d6d -->
+<!-- cache-key: cdktf-0.17.0-pre.15 input-ae8f9f76e2d23dc67ab5c3690201b7bf88a8d93dc83db02352e0f31425999200 -->

website/docs/cdktf/csharp/d/workspace_run_task.html.markdown

@@ -46,6 +46,7 @@ In addition to all arguments above, the following attributes are exported:
 
 * `EnforcementLevel` - The enforcement level of the task.
 * `Id` - The ID of the Workspace Run task.
-* `Stage` - Which stage the task will run in.
+* `Stage` - **Deprecated** Use `Stages` instead.
+* `Stages` - Which stages the task will run in.
 
-<!-- cache-key: cdktf-0.17.0-pre.15 input-86410a403310625b9c9007c1409553681e71bb1d5dfb652c72477e846011cede -->
+<!-- cache-key: cdktf-0.17.0-pre.15 input-7fbd90d138dd4a2dc68a0f3441cd300ba07517660e0b7b4fdab7dbddd51d71b5 -->

website/docs/cdktf/csharp/index.html.markdown

@@ -77,7 +77,7 @@ automatically installed by `terraform init` in the future:
 terraform {
   required_providers {
     tfe = {
-      version = "~> 0.57.0"
+      version = "~> 0.60.0"
     }
   }
 }
@@ -90,7 +90,7 @@ The above snippet using `RequiredProviders` is for Terraform 0.13+; if you are u
 
 ```hcl
 provider "tfe" {
-  version = "~> 0.57.0"
+  version = "~> 0.60.0"
   ...
 }
 ```
@@ -103,7 +103,7 @@ For more information on provider installation and constraining provider versions
 provider "tfe" {
   hostname = var.hostname # Optional, defaults to HCP Terraform `AppTerraformIo`
   token    = var.token
-  version  = "~> 0.57.0"
+  version  = "~> 0.60.0"
 }
 
 # Create an organization
@@ -129,4 +129,4 @@ The following arguments are supported:
   arguments. Ensure that the organization already exists prior to using this argument.
   This can also be specified using the `TfeOrganization` environment variable.
 
-<!-- cache-key: cdktf-0.17.0-pre.15 input-d72291151cea8709b729b9dcfb06e9dae682a8cb6e399d427d05e29354451180 -->
+<!-- cache-key: cdktf-0.17.0-pre.15 input-a77df58c9615ebcb917fe58dd81f9e798ce819182034bd2e639ba91520a1ccad -->

website/docs/cdktf/csharp/r/data_retention_policy.html.markdown

@@ -0,0 +1,120 @@
+---
+layout: "tfe"
+page_title: "Terraform Enterprise: tfe_data_retention_policy"
+description: |-
+  Manages data retention policies for organizations and workspaces
+---
+
+
+<!-- Please do not edit this file, it is generated. -->
+# tfe_data_retention_policy
+
+Creates a data retention policy attached to either an organization or workspace. This resource is for Terraform Enterprise only.
+
+## Example Usage
+
+Creating a data retention policy for a workspace:
+
+```csharp
+using Constructs;
+using HashiCorp.Cdktf;
+/*Provider bindings are generated by running cdktf get.
+See https://cdk.tf/provider-generation for more details.*/
+using Gen.Providers.Tfe;
+class MyConvertedCode : TerraformStack
+{
+    public MyConvertedCode(Construct scope, string name) : base(scope, name)
+    {
+        var tfeOrganizationTestOrganization = new Organization.Organization(this, "test-organization", new OrganizationConfig {
+            Email = "[email protected]",
+            Name = "my-org-name"
+        });
+        var tfeWorkspaceTestWorkspace = new Workspace.Workspace(this, "test-workspace", new WorkspaceConfig {
+            Name = "my-workspace-name",
+            Organization = Token.AsString(tfeOrganizationTestOrganization.Name)
+        });
+        new DataRetentionPolicy.DataRetentionPolicy(this, "foobar", new DataRetentionPolicyConfig {
+            DeleteOlderThan = new [] { new Struct {
+                Days = 42
+            } },
+            WorkspaceId = Token.AsString(tfeWorkspaceTestWorkspace.Id)
+        });
+    }
+}
+```
+
+Creating a data retention policy for an organization:
+
+```csharp
+using Constructs;
+using HashiCorp.Cdktf;
+/*Provider bindings are generated by running cdktf get.
+See https://cdk.tf/provider-generation for more details.*/
+using Gen.Providers.Tfe;
+class MyConvertedCode : TerraformStack
+{
+    public MyConvertedCode(Construct scope, string name) : base(scope, name)
+    {
+        var tfeOrganizationTestOrganization = new Organization.Organization(this, "test-organization", new OrganizationConfig {
+            Email = "[email protected]",
+            Name = "my-org-name"
+        });
+        new DataRetentionPolicy.DataRetentionPolicy(this, "foobar", new DataRetentionPolicyConfig {
+            DeleteOlderThan = new [] { new Struct {
+                Days = 1138
+            } },
+            Organization = Token.AsString(tfeOrganizationTestOrganization.Name)
+        });
+    }
+}
+```
+
+Creating a data retention policy for an organization and exclude a single workspace from it:
+
+```hcl
+resource "tfe_organization" "test-organization" {
+  name  = "my-org-name"
+  email = "[email protected]"
+}
+
+// create data retention policy the organization
+resource "tfe_data_retention_policy" "foobar" {
+  organization = tfe_organization.test-organization.name
+
+  delete_older_than {
+    days = 1138
+  }
+}
+
+resource "tfe_workspace" "test-workspace" {
+  name         = "my-workspace-name"
+  organization = tfe_organization.test-organization.name
+}
+
+// create a policy that prevents automatic deletion of data in the test-workspace
+resource "tfe_data_retention_policy" "foobar" {
+  workspace_id = tfe_workspace.test-workspace.id
+
+  dont_delete {}
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `Organization` - (Optional) The name of the organization you want the policy to apply to. Must not be set if `WorkspaceId` is set.
+* `WorkspaceId` - (Optional) The ID of the workspace you want the policy to apply to. Must not be set if `Organization` is set.
+* `DeleteOlderThan` - (Optional) If this block is set, the created policy will apply to any data older than the configured number of days. Must not be set if `DontDelete` is set.
+* `DontDelete` - (Optional) If this block is set, the created policy will prevent other policies from deleting data from this workspace or organization. Must not be set if `DeleteOlderThan` is set.
+
+
+## Import
+
+A resource can be imported; use `<ORGANIZATION>/<WORKSPACE NAME>` or `<ORGANIZATION>` as the import ID. For example:
+
+```shell
+terraform import tfe_data_retention_policy.foobar my-org-name/my-workspace-name
+```
+
+<!-- cache-key: cdktf-0.17.0-pre.15 input-f96ec458c2bca8796e296f06011ad4fc674072a5029841651f6906f053e79d76 -->