docs: add guide for moving projects

docs/data-sources/alloydbomni.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_alloydbomni (Data Source)
 
-Gets information about an Aiven for AlloyDB Omni service.
+Gets information about an Aiven for AlloyDB Omni service. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/data-sources/alloydbomni_database.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_alloydbomni_database (Data Source)
 
-Gets information about a database in an Aiven for AlloyDB Omni service.
+Gets information about a database in an Aiven for AlloyDB Omni service. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/data-sources/alloydbomni_user.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_alloydbomni_user (Data Source)
 
-Gets information about an Aiven for AlloyDB Omni service user.
+Gets information about an Aiven for AlloyDB Omni service user. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/data-sources/aws_org_vpc_peering_connection.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_aws_org_vpc_peering_connection (Data Source)
 
-Gets information about an AWS VPC peering connection.
+Gets information about an AWS VPC peering connection. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/data-sources/azure_org_vpc_peering_connection.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_azure_org_vpc_peering_connection (Data Source)
 
-Gets information about about an Azure VPC peering connection.
+Gets information about about an Azure VPC peering connection. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/data-sources/external_identity.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_external_identity (Data Source)
 
-Links external usernames to Aiven users, ensuring that requesters and approvers are correctly identified for [Aiven for Apache Kafka® Governance approval workflows](https://aiven.io/docs/products/kafka/howto/terraform-governance-approvals).
+Links external usernames to Aiven users, ensuring that requesters and approvers are correctly identified for [Aiven for Apache Kafka® Governance approval workflows](https://aiven.io/docs/products/kafka/howto/terraform-governance-approvals). 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/data-sources/gcp_org_vpc_peering_connection.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_gcp_org_vpc_peering_connection (Data Source)
 
-The GCP VPC Peering Connection data source provides information about the existing Aiven VPC Peering Connection.
+The GCP VPC Peering Connection data source provides information about the existing Aiven VPC Peering Connection. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/data-sources/organization_address.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_organization_address (Data Source)
 
-Gets information about an organization address.
+Gets information about an organization address. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/data-sources/organization_billing_group.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_organization_billing_group (Data Source)
 
-Gets information about a billing group.
+Gets information about a billing group. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/data-sources/organization_billing_group_list.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_organization_billing_group_list (Data Source)
 
-Lists billing groups for an organization.
+Lists billing groups for an organization. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/data-sources/organization_project.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_organization_project (Data Source)
 
-Gets information about an Aiven project.
+Gets information about an Aiven project. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/data-sources/organization_user_group.md

@@ -14,7 +14,7 @@ Gets information about an existing user group in an organization.
 
 ```terraform
 data "aiven_organization_user_group" "example" {
-  name = "Example group"
+  name            = "Example group"
   organization_id = aiven_organization.main.id
 }
 ```

docs/data-sources/organization_vpc.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_organization_vpc (Data Source)
 
-Gets information about an existing VPC in an Aiven organization.
+Gets information about an existing VPC in an Aiven organization. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/data-sources/service_component.md

@@ -41,3 +41,4 @@ data "aiven_service_component" "sc1" {
 - `id` (String) The ID of this resource.
 - `kafka_ssl_ca` (String) Kafka certificate used. The possible values are `letsencrypt` and `project_ca`.
 - `port` (Number) Port number for connecting to the service component
+

docs/guides/move-projects.md

@@ -0,0 +1,86 @@
+---
+page_title: "Move projects"
+---
+
+# Move projects
+
+You can move a project to another [organization or organizational unit](https://aiven.io/docs/platform/concepts/orgs-units-projects) by updating the `aiven_project` or `aiven_organization_project` resource.
+
+Services in the project continue running during the move.
+
+## Move a project within an organization
+
+Users with the organization admin or project admin [role](https://aiven.io/docs/platform/concepts/permissions#organization-roles-and-permissions) can move projects within an organization.
+
+To move a project to another organizational unit in your organization, change the `parent_id` of the project resource. The following example shows an `aiven_project` resource with the `parent_id`
+of the destination unit:
+
+```hcl
+resource "aiven_organizational_unit" "destination_unit" {
+  name = "dest-unit"
+  parent_id = data.aiven_organization.main.id
+}
+
+resource "aiven_project" "example_project" {
+  project    = "example-project"
+  parent_id = aiven_organizational_unit.destination_unit.id
+}
+```
+
+You can also move a project out of an organizational unit and put it directly under the organization. The following example shows an `aiven_organization_project` resource
+with the `parent_id` of the organization:
+
+```hcl
+resource "aiven_organization_project" "example_project" {
+  project_id       = "example-project"
+  organization_id  = data.aiven_organization.main.id
+  parent_id        = data.aiven_organization.main.id
+  billing_group_id = aiven_billing_group.main.id
+}
+```
+
+## Move a project to another organization
+
+To move a project to a different organization, you must be an [organization admin](https://aiven.io/docs/platform/concepts/permissions#organization-roles-and-permissions) of both organizations.
+All users with permission to access the project lose the permissions when you move it to a different organization unless they are members of the target organization.
+
+~> **Note**
+To move an `aiven_project` resource to another organization, change the `parent_id` to the ID of the destination organization.
+
+To move an `aiven_organization_project` resource to another organization, you have to change the:
+
+* `organization_id` to the ID of the destination organization
+* `parent_id` to the ID of the destination organization or organizational unit
+* `billing_group_id` to the ID of one of the billing groups in the destination organization
+
+-> **Tip**
+You can get the billing group ID [in the Aiven Console](https://aiven.io/docs/platform/reference/get-resource-IDs) or by using
+the `aiven_organization_billing_group_list` data source.
+
+In the following example the project was moved to an organizational unit in another organization:
+
+```hcl
+# Destination organization
+data "aiven_organization" "dest_org" {
+  name = "Destination organization"
+}
+
+# Destination unit
+data "aiven_organizational_unit" "dest_unit" {
+  name      = "Example organizational unit"
+  parent_id = data.aiven_organization.dest_org.id
+}
+
+# Billing groups in destination organization
+data "aiven_organization_billing_group_list" "billing_groups" {
+  organization_id = data.aiven_organization.dest_org.id
+}
+
+# Project
+resource "aiven_organization_project" "example_project" {
+  project_id       = "example-project"
+  organization_id  = data.aiven_organization.dest_org.id
+  parent_id        = data.aiven_organizational_unit.dest_unit.id
+  billing_group_id = one([for bg in data.aiven_organization_billing_group_list.billing_groups.billing_groups : bg.billing_group_id if bg.billing_group_name == "Default billing group"])
+}
+```

docs/resources/alloydbomni.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_alloydbomni (Resource)
 
-Creates and manages an Aiven for AlloyDB Omni service.
+Creates and manages an Aiven for AlloyDB Omni service. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/resources/alloydbomni_database.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_alloydbomni_database (Resource)
 
-Creates and manages a database in an Aiven for AlloyDB Omni service.
+Creates and manages a database in an Aiven for AlloyDB Omni service. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/resources/alloydbomni_user.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_alloydbomni_user (Resource)
 
-Creates and manages an Aiven for AlloyDB Omni service user.
+Creates and manages an Aiven for AlloyDB Omni service user. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/resources/aws_org_vpc_peering_connection.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_aws_org_vpc_peering_connection (Resource)
 
-Creates and manages an AWS VPC peering connection with an Aiven Organization VPC.
+Creates and manages an AWS VPC peering connection with an Aiven Organization VPC. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.
@@ -20,16 +20,16 @@ the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.
 ```terraform
 resource "aiven_organization_vpc" "example_vpc" {
   organization_id = data.aiven_organization.example.id
-  cloud_name     = "aws-eu-central-1"
-  network_cidr   = "10.0.0.0/24"
+  cloud_name      = "aws-eu-central-1"
+  network_cidr    = "10.0.0.0/24"
 }
 
 resource "aiven_aws_org_vpc_peering_connection" "example_peering" {
-  organization_id         = aiven_organization_vpc.example_vpc.organization_id
-  organization_vpc_id         = aiven_organization_vpc.example_vpc.organization_vpc_id
-  aws_account_id = var.aws_id
-  aws_vpc_id     = "vpc-1a2b3c4d5e6f7g8h9"
-  aws_vpc_region = "aws-us-east-2"
+  organization_id     = aiven_organization_vpc.example_vpc.organization_id
+  organization_vpc_id = aiven_organization_vpc.example_vpc.organization_vpc_id
+  aws_account_id      = var.aws_id
+  aws_vpc_id          = "vpc-1a2b3c4d5e6f7g8h9"
+  aws_vpc_region      = "aws-us-east-2"
 }
 ```
 

docs/resources/azure_org_vpc_peering_connection.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_azure_org_vpc_peering_connection (Resource)
 
-Creates and manages an Azure VPC peering connection with an Aiven VPC.
+Creates and manages an Azure VPC peering connection with an Aiven VPC. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.
@@ -20,14 +20,14 @@ the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.
 ```terraform
 resource "aiven_organization_vpc" "example_vpc" {
   organization_id = data.aiven_organization.example.id
-  cloud_name     = "azure-germany-westcentral"
-  network_cidr   = "10.0.0.0/24"
+  cloud_name      = "azure-germany-westcentral"
+  network_cidr    = "10.0.0.0/24"
 }
 
 resource "aiven_azure_org_vpc_peering_connection" "example_peering" {
-  organization_id                 = aiven_organization_vpc.example_vpc.organization_id
-  organization_vpc_id                = aiven_organization_vpc.example_vpc.organization_vpc_id
-  azure_subscription_id  = "12345678-1234-1234-1234-123456789012"
+  organization_id       = aiven_organization_vpc.example_vpc.organization_id
+  organization_vpc_id   = aiven_organization_vpc.example_vpc.organization_vpc_id
+  azure_subscription_id = "12345678-1234-1234-1234-123456789012"
   vnet_name             = "my-vnet"
   peer_resource_group   = "my-resource-group"
   peer_azure_app_id     = "87654321-4321-4321-4321-210987654321"

docs/resources/azure_privatelink_connection_approval.md

@@ -39,8 +39,8 @@ resource "aiven_pg" "default" {
 }
 
 resource "aiven_azure_privatelink" "privatelink" {
-  project               = var.aiven_project_id
-  service_name          = aiven_pg.default.name
+  project      = var.aiven_project_id
+  service_name = aiven_pg.default.name
   user_subscription_ids = [
     var.azure_subscription_id
   ]

docs/resources/billing_group.md

@@ -17,7 +17,7 @@ resource "aiven_billing_group" "example_billing_group" {
   name             = "example-billing-group"
   billing_currency = "USD"
   vat_id           = "123ABC"
-  parent_id        =  data.aiven_organization.main.id
+  parent_id        = data.aiven_organization.main.id
 }
 
 resource "aiven_project" "example_project" {

docs/resources/clickhouse_grant.md

@@ -45,7 +45,7 @@ resource "aiven_clickhouse_grant" "role_privileges" {
   }
 
   # Global privileges
-    privilege_grant {
+  privilege_grant {
     privilege = "CREATE TEMPORARY TABLE"
     database  = "*"
   }

docs/resources/dragonfly.md

@@ -14,14 +14,14 @@ Creates and manages an [Aiven for Dragonfly®](https://aiven.io/docs/products/dr
 
 ```terraform
 resource "aiven_dragonfly" "example_dragonfly" {
-    project      = data.aiven_project.example_project.project
-    plan         = "startup-4"
-    cloud_name   = "google-europe-west1"
-    service_name = "example-dragonfly-service"
-
-    dragonfly_user_config {
-        cache_mode = true
-    }
+  project      = data.aiven_project.example_project.project
+  plan         = "startup-4"
+  cloud_name   = "google-europe-west1"
+  service_name = "example-dragonfly-service"
+
+  dragonfly_user_config {
+    cache_mode = true
+  }
 }
 ```
 

docs/resources/flink_jar_application.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_flink_jar_application (Resource)
 
-Creates and manages an [Aiven for Apache Flink® jar application](https://aiven.io/docs/products/flink/howto/create-jar-application).
+Creates and manages an [Aiven for Apache Flink® jar application](https://aiven.io/docs/products/flink/howto/create-jar-application). 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.

docs/resources/flink_jar_application_deployment.md

@@ -10,7 +10,7 @@ description: |-
 
 # aiven_flink_jar_application_deployment (Resource)
 
-Creates and manages the deployment of an Aiven for Apache Flink® application.
+Creates and manages the deployment of an Aiven for Apache Flink® application. 
 
 **This resource is in the beta stage and may change without notice.** Set
 the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.
@@ -39,15 +39,15 @@ resource "aiven_flink_jar_application" "example" {
 }
 
 resource "aiven_flink_jar_application_version" "example" {
-  project      = aiven_flink.example.project
-  service_name = aiven_flink.example.service_name
+  project        = aiven_flink.example.project
+  service_name   = aiven_flink.example.service_name
   application_id = aiven_flink_jar_application.example.application_id
   source         = "./example.jar"
 }
 
 resource "aiven_flink_jar_application_deployment" "example" {
-  project      = aiven_flink.example.project
-  service_name = aiven_flink.example.service_name
+  project        = aiven_flink.example.project
+  service_name   = aiven_flink.example.service_name
   application_id = aiven_flink_jar_application.example.application_id
   version_id     = aiven_flink_jar_application_version.example.application_version_id
 }