pulumi-aiven 6.13.0a1710156545__py3-none-any.whl → 6.31.0__py3-none-any.whl

pulumi_aiven/project.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 from . import outputs
 from ._inputs import *
@@ -28,15 +33,15 @@ class ProjectArgs:
                  use_source_project_billing_group: Optional[pulumi.Input[bool]] = None):
         """
         The set of arguments for constructing a Project resource.
-        :param pulumi.Input[str] project: Defines the name of the project. Name must be globally unique (between all Aiven customers) and cannot be changed later without destroying and re-creating the project, including all sub-resources.
-        :param pulumi.Input[str] account_id: An optional property to link a project to an already existing account by using account ID. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] project: The name of the project. Names must be globally unique among all Aiven customers and cannot be changed later without destroying and re-creating the project, including all sub-resources.
+        :param pulumi.Input[str] account_id: Link a project to an existing account using its account ID. This field is deprecated. Use `parent_id` instead. To set up proper dependencies please refer to this variable as a reference.
         :param pulumi.Input[bool] add_account_owners_admin_access: If parent_id is set, grant account owner team admin access to the new project. The default value is `true`.
-        :param pulumi.Input[str] billing_group: The id of the billing group that is linked to this project. To set up proper dependencies please refer to this variable as a reference.
-        :param pulumi.Input[str] copy_from_project: is the name of another project used to copy billing information and some other project attributes like technical contacts from. This is mostly relevant when an existing project has billing type set to invoice and that needs to be copied over to a new project. (Setting billing is otherwise not allowed over the API.) This only has effect when the project is created. To set up proper dependencies please refer to this variable as a reference.
-        :param pulumi.Input[str] default_cloud: Defines the default cloud provider and region where services are hosted. This can be changed freely after the project is created. This will not affect existing services.
-        :param pulumi.Input[str] parent_id: An optional property to link a project to an already existing organization or account by using its ID. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] billing_group: The ID of the billing group this project is assigned to. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] copy_from_project: The name of the project to copy billing information, technical contacts, and some other project attributes from. This is most useful to set up the same billing method when you use bank transfers to pay invoices for other projects. You can only do this when creating a project. You can't set the billing over the API for an existing. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] default_cloud: Default cloud provider and region where services are hosted. This can be changed after the project is created and will not affect existing services.
+        :param pulumi.Input[str] parent_id: Link a project to an [organization, organizational unit,](https://aiven.io/docs/platform/concepts/orgs-units-projects) or account by using its ID. To set up proper dependencies please refer to this variable as a reference.
         :param pulumi.Input[Sequence[pulumi.Input['ProjectTagArgs']]] tags: Tags are key-value pairs that allow you to categorize projects.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] technical_emails: Defines the email addresses that will receive alerts about upcoming maintenance updates or warnings about service instability. It is a good practice to keep this up-to-date to be aware of any potential issues with your project.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] technical_emails: The email addresses for [project contacts](https://aiven.io/docs/platform/howto/technical-emails), who will receive important alerts and updates about this project and its services. You can also set email contacts at the service level. It's good practice to keep these up-to-date to be aware of any potential issues with your project.
         :param pulumi.Input[bool] use_source_project_billing_group: Use the same billing group that is used in source project.
         """
         pulumi.set(__self__, "project", project)
@@ -72,7 +77,7 @@ class ProjectArgs:
     @pulumi.getter
     def project(self) -> pulumi.Input[str]:
         """
-        Defines the name of the project. Name must be globally unique (between all Aiven customers) and cannot be changed later without destroying and re-creating the project, including all sub-resources.
+        The name of the project. Names must be globally unique among all Aiven customers and cannot be changed later without destroying and re-creating the project, including all sub-resources.
         """
         return pulumi.get(self, "project")
 
@@ -82,13 +87,11 @@ class ProjectArgs:
 
     @property
     @pulumi.getter(name="accountId")
+    @_utilities.deprecated("""Use parent_id instead. This field will be removed in the next major release.""")
     def account_id(self) -> Optional[pulumi.Input[str]]:
         """
-        An optional property to link a project to an already existing account by using account ID. To set up proper dependencies please refer to this variable as a reference.
+        Link a project to an existing account using its account ID. This field is deprecated. Use `parent_id` instead. To set up proper dependencies please refer to this variable as a reference.
         """
-        warnings.warn("""Use parent_id instead. This field will be removed in the next major release.""", DeprecationWarning)
-        pulumi.log.warn("""account_id is deprecated: Use parent_id instead. This field will be removed in the next major release.""")
-
         return pulumi.get(self, "account_id")
 
     @account_id.setter
@@ -97,13 +100,11 @@ class ProjectArgs:
 
     @property
     @pulumi.getter(name="addAccountOwnersAdminAccess")
+    @_utilities.deprecated("""This field is deprecated and will be removed in the next major release. Currently, it will always be set to true, regardless of the value set in the manifest.""")
     def add_account_owners_admin_access(self) -> Optional[pulumi.Input[bool]]:
         """
         If parent_id is set, grant account owner team admin access to the new project. The default value is `true`.
         """
-        warnings.warn("""This field is deprecated and will be removed in the next major release. Currently, it will always be set to true, regardless of the value set in the manifest.""", DeprecationWarning)
-        pulumi.log.warn("""add_account_owners_admin_access is deprecated: This field is deprecated and will be removed in the next major release. Currently, it will always be set to true, regardless of the value set in the manifest.""")
-
         return pulumi.get(self, "add_account_owners_admin_access")
 
     @add_account_owners_admin_access.setter
@@ -114,7 +115,7 @@ class ProjectArgs:
     @pulumi.getter(name="billingGroup")
     def billing_group(self) -> Optional[pulumi.Input[str]]:
         """
-        The id of the billing group that is linked to this project. To set up proper dependencies please refer to this variable as a reference.
+        The ID of the billing group this project is assigned to. To set up proper dependencies please refer to this variable as a reference.
         """
         return pulumi.get(self, "billing_group")
 
@@ -126,7 +127,7 @@ class ProjectArgs:
     @pulumi.getter(name="copyFromProject")
     def copy_from_project(self) -> Optional[pulumi.Input[str]]:
         """
-        is the name of another project used to copy billing information and some other project attributes like technical contacts from. This is mostly relevant when an existing project has billing type set to invoice and that needs to be copied over to a new project. (Setting billing is otherwise not allowed over the API.) This only has effect when the project is created. To set up proper dependencies please refer to this variable as a reference.
+        The name of the project to copy billing information, technical contacts, and some other project attributes from. This is most useful to set up the same billing method when you use bank transfers to pay invoices for other projects. You can only do this when creating a project. You can't set the billing over the API for an existing. To set up proper dependencies please refer to this variable as a reference.
         """
         return pulumi.get(self, "copy_from_project")
 
@@ -138,7 +139,7 @@ class ProjectArgs:
     @pulumi.getter(name="defaultCloud")
     def default_cloud(self) -> Optional[pulumi.Input[str]]:
         """
-        Defines the default cloud provider and region where services are hosted. This can be changed freely after the project is created. This will not affect existing services.
+        Default cloud provider and region where services are hosted. This can be changed after the project is created and will not affect existing services.
         """
         return pulumi.get(self, "default_cloud")
 
@@ -150,7 +151,7 @@ class ProjectArgs:
     @pulumi.getter(name="parentId")
     def parent_id(self) -> Optional[pulumi.Input[str]]:
         """
-        An optional property to link a project to an already existing organization or account by using its ID. To set up proper dependencies please refer to this variable as a reference.
+        Link a project to an [organization, organizational unit,](https://aiven.io/docs/platform/concepts/orgs-units-projects) or account by using its ID. To set up proper dependencies please refer to this variable as a reference.
         """
         return pulumi.get(self, "parent_id")
 
@@ -174,7 +175,7 @@ class ProjectArgs:
     @pulumi.getter(name="technicalEmails")
     def technical_emails(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        Defines the email addresses that will receive alerts about upcoming maintenance updates or warnings about service instability. It is a good practice to keep this up-to-date to be aware of any potential issues with your project.
+        The email addresses for [project contacts](https://aiven.io/docs/platform/howto/technical-emails), who will receive important alerts and updates about this project and its services. You can also set email contacts at the service level. It's good practice to keep these up-to-date to be aware of any potential issues with your project.
         """
         return pulumi.get(self, "technical_emails")
 
@@ -184,13 +185,11 @@ class ProjectArgs:
 
     @property
     @pulumi.getter(name="useSourceProjectBillingGroup")
+    @_utilities.deprecated("""This field is deprecated and will be removed in the next major release.""")
     def use_source_project_billing_group(self) -> Optional[pulumi.Input[bool]]:
         """
         Use the same billing group that is used in source project.
         """
-        warnings.warn("""This field is deprecated and will be removed in the next major release.""", DeprecationWarning)
-        pulumi.log.warn("""use_source_project_billing_group is deprecated: This field is deprecated and will be removed in the next major release.""")
-
         return pulumi.get(self, "use_source_project_billing_group")
 
     @use_source_project_billing_group.setter
@@ -217,19 +216,19 @@ class _ProjectState:
                  use_source_project_billing_group: Optional[pulumi.Input[bool]] = None):
         """
         Input properties used for looking up and filtering Project resources.
-        :param pulumi.Input[str] account_id: An optional property to link a project to an already existing account by using account ID. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] account_id: Link a project to an existing account using its account ID. This field is deprecated. Use `parent_id` instead. To set up proper dependencies please refer to this variable as a reference.
         :param pulumi.Input[bool] add_account_owners_admin_access: If parent_id is set, grant account owner team admin access to the new project. The default value is `true`.
-        :param pulumi.Input[str] available_credits: The amount of platform credits available to the project. This could be your free trial or other promotional credits.
-        :param pulumi.Input[str] billing_group: The id of the billing group that is linked to this project. To set up proper dependencies please refer to this variable as a reference.
-        :param pulumi.Input[str] ca_cert: The CA certificate of the project. This is required for configuring clients that connect to certain services like Kafka.
-        :param pulumi.Input[str] copy_from_project: is the name of another project used to copy billing information and some other project attributes like technical contacts from. This is mostly relevant when an existing project has billing type set to invoice and that needs to be copied over to a new project. (Setting billing is otherwise not allowed over the API.) This only has effect when the project is created. To set up proper dependencies please refer to this variable as a reference.
-        :param pulumi.Input[str] default_cloud: Defines the default cloud provider and region where services are hosted. This can be changed freely after the project is created. This will not affect existing services.
-        :param pulumi.Input[str] estimated_balance: The current accumulated bill for this project in the current billing period.
-        :param pulumi.Input[str] parent_id: An optional property to link a project to an already existing organization or account by using its ID. To set up proper dependencies please refer to this variable as a reference.
-        :param pulumi.Input[str] payment_method: The method of invoicing used for payments for this project, e.g. `card`.
-        :param pulumi.Input[str] project: Defines the name of the project. Name must be globally unique (between all Aiven customers) and cannot be changed later without destroying and re-creating the project, including all sub-resources.
+        :param pulumi.Input[str] available_credits: The number of trial or promotional credits remaining for this project.
+        :param pulumi.Input[str] billing_group: The ID of the billing group this project is assigned to. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] ca_cert: The CA certificate for the project. This is required for configuring clients that connect to certain services like Kafka.
+        :param pulumi.Input[str] copy_from_project: The name of the project to copy billing information, technical contacts, and some other project attributes from. This is most useful to set up the same billing method when you use bank transfers to pay invoices for other projects. You can only do this when creating a project. You can't set the billing over the API for an existing. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] default_cloud: Default cloud provider and region where services are hosted. This can be changed after the project is created and will not affect existing services.
+        :param pulumi.Input[str] estimated_balance: The monthly running estimate for this project for the current billing period.
+        :param pulumi.Input[str] parent_id: Link a project to an [organization, organizational unit,](https://aiven.io/docs/platform/concepts/orgs-units-projects) or account by using its ID. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] payment_method: The payment type used for this project. For example,`card`.
+        :param pulumi.Input[str] project: The name of the project. Names must be globally unique among all Aiven customers and cannot be changed later without destroying and re-creating the project, including all sub-resources.
         :param pulumi.Input[Sequence[pulumi.Input['ProjectTagArgs']]] tags: Tags are key-value pairs that allow you to categorize projects.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] technical_emails: Defines the email addresses that will receive alerts about upcoming maintenance updates or warnings about service instability. It is a good practice to keep this up-to-date to be aware of any potential issues with your project.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] technical_emails: The email addresses for [project contacts](https://aiven.io/docs/platform/howto/technical-emails), who will receive important alerts and updates about this project and its services. You can also set email contacts at the service level. It's good practice to keep these up-to-date to be aware of any potential issues with your project.
         :param pulumi.Input[bool] use_source_project_billing_group: Use the same billing group that is used in source project.
         """
         if account_id is not None:
@@ -272,13 +271,11 @@ class _ProjectState:
 
     @property
     @pulumi.getter(name="accountId")
+    @_utilities.deprecated("""Use parent_id instead. This field will be removed in the next major release.""")
     def account_id(self) -> Optional[pulumi.Input[str]]:
         """
-        An optional property to link a project to an already existing account by using account ID. To set up proper dependencies please refer to this variable as a reference.
+        Link a project to an existing account using its account ID. This field is deprecated. Use `parent_id` instead. To set up proper dependencies please refer to this variable as a reference.
         """
-        warnings.warn("""Use parent_id instead. This field will be removed in the next major release.""", DeprecationWarning)
-        pulumi.log.warn("""account_id is deprecated: Use parent_id instead. This field will be removed in the next major release.""")
-
         return pulumi.get(self, "account_id")
 
     @account_id.setter
@@ -287,13 +284,11 @@ class _ProjectState:
 
     @property
     @pulumi.getter(name="addAccountOwnersAdminAccess")
+    @_utilities.deprecated("""This field is deprecated and will be removed in the next major release. Currently, it will always be set to true, regardless of the value set in the manifest.""")
     def add_account_owners_admin_access(self) -> Optional[pulumi.Input[bool]]:
         """
         If parent_id is set, grant account owner team admin access to the new project. The default value is `true`.
         """
-        warnings.warn("""This field is deprecated and will be removed in the next major release. Currently, it will always be set to true, regardless of the value set in the manifest.""", DeprecationWarning)
-        pulumi.log.warn("""add_account_owners_admin_access is deprecated: This field is deprecated and will be removed in the next major release. Currently, it will always be set to true, regardless of the value set in the manifest.""")
-
         return pulumi.get(self, "add_account_owners_admin_access")
 
     @add_account_owners_admin_access.setter
@@ -304,7 +299,7 @@ class _ProjectState:
     @pulumi.getter(name="availableCredits")
     def available_credits(self) -> Optional[pulumi.Input[str]]:
         """
-        The amount of platform credits available to the project. This could be your free trial or other promotional credits.
+        The number of trial or promotional credits remaining for this project.
         """
         return pulumi.get(self, "available_credits")
 
@@ -316,7 +311,7 @@ class _ProjectState:
     @pulumi.getter(name="billingGroup")
     def billing_group(self) -> Optional[pulumi.Input[str]]:
         """
-        The id of the billing group that is linked to this project. To set up proper dependencies please refer to this variable as a reference.
+        The ID of the billing group this project is assigned to. To set up proper dependencies please refer to this variable as a reference.
         """
         return pulumi.get(self, "billing_group")
 
@@ -328,7 +323,7 @@ class _ProjectState:
     @pulumi.getter(name="caCert")
     def ca_cert(self) -> Optional[pulumi.Input[str]]:
         """
-        The CA certificate of the project. This is required for configuring clients that connect to certain services like Kafka.
+        The CA certificate for the project. This is required for configuring clients that connect to certain services like Kafka.
         """
         return pulumi.get(self, "ca_cert")
 
@@ -340,7 +335,7 @@ class _ProjectState:
     @pulumi.getter(name="copyFromProject")
     def copy_from_project(self) -> Optional[pulumi.Input[str]]:
         """
-        is the name of another project used to copy billing information and some other project attributes like technical contacts from. This is mostly relevant when an existing project has billing type set to invoice and that needs to be copied over to a new project. (Setting billing is otherwise not allowed over the API.) This only has effect when the project is created. To set up proper dependencies please refer to this variable as a reference.
+        The name of the project to copy billing information, technical contacts, and some other project attributes from. This is most useful to set up the same billing method when you use bank transfers to pay invoices for other projects. You can only do this when creating a project. You can't set the billing over the API for an existing. To set up proper dependencies please refer to this variable as a reference.
         """
         return pulumi.get(self, "copy_from_project")
 
@@ -352,7 +347,7 @@ class _ProjectState:
     @pulumi.getter(name="defaultCloud")
     def default_cloud(self) -> Optional[pulumi.Input[str]]:
         """
-        Defines the default cloud provider and region where services are hosted. This can be changed freely after the project is created. This will not affect existing services.
+        Default cloud provider and region where services are hosted. This can be changed after the project is created and will not affect existing services.
         """
         return pulumi.get(self, "default_cloud")
 
@@ -364,7 +359,7 @@ class _ProjectState:
     @pulumi.getter(name="estimatedBalance")
     def estimated_balance(self) -> Optional[pulumi.Input[str]]:
         """
-        The current accumulated bill for this project in the current billing period.
+        The monthly running estimate for this project for the current billing period.
         """
         return pulumi.get(self, "estimated_balance")
 
@@ -376,7 +371,7 @@ class _ProjectState:
     @pulumi.getter(name="parentId")
     def parent_id(self) -> Optional[pulumi.Input[str]]:
         """
-        An optional property to link a project to an already existing organization or account by using its ID. To set up proper dependencies please refer to this variable as a reference.
+        Link a project to an [organization, organizational unit,](https://aiven.io/docs/platform/concepts/orgs-units-projects) or account by using its ID. To set up proper dependencies please refer to this variable as a reference.
         """
         return pulumi.get(self, "parent_id")
 
@@ -388,7 +383,7 @@ class _ProjectState:
     @pulumi.getter(name="paymentMethod")
     def payment_method(self) -> Optional[pulumi.Input[str]]:
         """
-        The method of invoicing used for payments for this project, e.g. `card`.
+        The payment type used for this project. For example,`card`.
         """
         return pulumi.get(self, "payment_method")
 
@@ -400,7 +395,7 @@ class _ProjectState:
     @pulumi.getter
     def project(self) -> Optional[pulumi.Input[str]]:
         """
-        Defines the name of the project. Name must be globally unique (between all Aiven customers) and cannot be changed later without destroying and re-creating the project, including all sub-resources.
+        The name of the project. Names must be globally unique among all Aiven customers and cannot be changed later without destroying and re-creating the project, including all sub-resources.
         """
         return pulumi.get(self, "project")
 
@@ -424,7 +419,7 @@ class _ProjectState:
     @pulumi.getter(name="technicalEmails")
     def technical_emails(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        Defines the email addresses that will receive alerts about upcoming maintenance updates or warnings about service instability. It is a good practice to keep this up-to-date to be aware of any potential issues with your project.
+        The email addresses for [project contacts](https://aiven.io/docs/platform/howto/technical-emails), who will receive important alerts and updates about this project and its services. You can also set email contacts at the service level. It's good practice to keep these up-to-date to be aware of any potential issues with your project.
         """
         return pulumi.get(self, "technical_emails")
 
@@ -434,13 +429,11 @@ class _ProjectState:
 
     @property
     @pulumi.getter(name="useSourceProjectBillingGroup")
+    @_utilities.deprecated("""This field is deprecated and will be removed in the next major release.""")
     def use_source_project_billing_group(self) -> Optional[pulumi.Input[bool]]:
         """
         Use the same billing group that is used in source project.
         """
-        warnings.warn("""This field is deprecated and will be removed in the next major release.""", DeprecationWarning)
-        pulumi.log.warn("""use_source_project_billing_group is deprecated: This field is deprecated and will be removed in the next major release.""")
-
         return pulumi.get(self, "use_source_project_billing_group")
 
     @use_source_project_billing_group.setter
@@ -460,30 +453,41 @@ class Project(pulumi.CustomResource):
                  default_cloud: Optional[pulumi.Input[str]] = None,
                  parent_id: Optional[pulumi.Input[str]] = None,
                  project: Optional[pulumi.Input[str]] = None,
-                 tags: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ProjectTagArgs']]]]] = None,
+                 tags: Optional[pulumi.Input[Sequence[pulumi.Input[Union['ProjectTagArgs', 'ProjectTagArgsDict']]]]] = None,
                  technical_emails: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  use_source_project_billing_group: Optional[pulumi.Input[bool]] = None,
                  __props__=None):
         """
-        The Project resource allows the creation and management of Aiven Projects.
+        Creates and manages an [Aiven project](https://aiven.io/docs/platform/concepts/orgs-units-projects#projects).
+
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_aiven as aiven
+
+        example_project = aiven.Project("example_project",
+            project="example-project",
+            parent_id=main["id"])
+        ```
 
         ## Import
 
         ```sh
-        $ pulumi import aiven:index/project:Project myproject project
+        $ pulumi import aiven:index/project:Project example_project PROJECT
         ```
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] account_id: An optional property to link a project to an already existing account by using account ID. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] account_id: Link a project to an existing account using its account ID. This field is deprecated. Use `parent_id` instead. To set up proper dependencies please refer to this variable as a reference.
         :param pulumi.Input[bool] add_account_owners_admin_access: If parent_id is set, grant account owner team admin access to the new project. The default value is `true`.
-        :param pulumi.Input[str] billing_group: The id of the billing group that is linked to this project. To set up proper dependencies please refer to this variable as a reference.
-        :param pulumi.Input[str] copy_from_project: is the name of another project used to copy billing information and some other project attributes like technical contacts from. This is mostly relevant when an existing project has billing type set to invoice and that needs to be copied over to a new project. (Setting billing is otherwise not allowed over the API.) This only has effect when the project is created. To set up proper dependencies please refer to this variable as a reference.
-        :param pulumi.Input[str] default_cloud: Defines the default cloud provider and region where services are hosted. This can be changed freely after the project is created. This will not affect existing services.
-        :param pulumi.Input[str] parent_id: An optional property to link a project to an already existing organization or account by using its ID. To set up proper dependencies please refer to this variable as a reference.
-        :param pulumi.Input[str] project: Defines the name of the project. Name must be globally unique (between all Aiven customers) and cannot be changed later without destroying and re-creating the project, including all sub-resources.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ProjectTagArgs']]]] tags: Tags are key-value pairs that allow you to categorize projects.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] technical_emails: Defines the email addresses that will receive alerts about upcoming maintenance updates or warnings about service instability. It is a good practice to keep this up-to-date to be aware of any potential issues with your project.
+        :param pulumi.Input[str] billing_group: The ID of the billing group this project is assigned to. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] copy_from_project: The name of the project to copy billing information, technical contacts, and some other project attributes from. This is most useful to set up the same billing method when you use bank transfers to pay invoices for other projects. You can only do this when creating a project. You can't set the billing over the API for an existing. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] default_cloud: Default cloud provider and region where services are hosted. This can be changed after the project is created and will not affect existing services.
+        :param pulumi.Input[str] parent_id: Link a project to an [organization, organizational unit,](https://aiven.io/docs/platform/concepts/orgs-units-projects) or account by using its ID. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] project: The name of the project. Names must be globally unique among all Aiven customers and cannot be changed later without destroying and re-creating the project, including all sub-resources.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['ProjectTagArgs', 'ProjectTagArgsDict']]]] tags: Tags are key-value pairs that allow you to categorize projects.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] technical_emails: The email addresses for [project contacts](https://aiven.io/docs/platform/howto/technical-emails), who will receive important alerts and updates about this project and its services. You can also set email contacts at the service level. It's good practice to keep these up-to-date to be aware of any potential issues with your project.
         :param pulumi.Input[bool] use_source_project_billing_group: Use the same billing group that is used in source project.
         """
         ...
@@ -493,12 +497,23 @@ class Project(pulumi.CustomResource):
                  args: ProjectArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        The Project resource allows the creation and management of Aiven Projects.
+        Creates and manages an [Aiven project](https://aiven.io/docs/platform/concepts/orgs-units-projects#projects).
+
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_aiven as aiven
+
+        example_project = aiven.Project("example_project",
+            project="example-project",
+            parent_id=main["id"])
+        ```
 
         ## Import
 
         ```sh
-        $ pulumi import aiven:index/project:Project myproject project
+        $ pulumi import aiven:index/project:Project example_project PROJECT
         ```
 
         :param str resource_name: The name of the resource.
@@ -523,7 +538,7 @@ class Project(pulumi.CustomResource):
                  default_cloud: Optional[pulumi.Input[str]] = None,
                  parent_id: Optional[pulumi.Input[str]] = None,
                  project: Optional[pulumi.Input[str]] = None,
-                 tags: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ProjectTagArgs']]]]] = None,
+                 tags: Optional[pulumi.Input[Sequence[pulumi.Input[Union['ProjectTagArgs', 'ProjectTagArgsDict']]]]] = None,
                  technical_emails: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  use_source_project_billing_group: Optional[pulumi.Input[bool]] = None,
                  __props__=None):
@@ -574,7 +589,7 @@ class Project(pulumi.CustomResource):
             parent_id: Optional[pulumi.Input[str]] = None,
             payment_method: Optional[pulumi.Input[str]] = None,
             project: Optional[pulumi.Input[str]] = None,
-            tags: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ProjectTagArgs']]]]] = None,
+            tags: Optional[pulumi.Input[Sequence[pulumi.Input[Union['ProjectTagArgs', 'ProjectTagArgsDict']]]]] = None,
             technical_emails: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
             use_source_project_billing_group: Optional[pulumi.Input[bool]] = None) -> 'Project':
         """
@@ -584,19 +599,19 @@ class Project(pulumi.CustomResource):
         :param str resource_name: The unique name of the resulting resource.
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] account_id: An optional property to link a project to an already existing account by using account ID. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] account_id: Link a project to an existing account using its account ID. This field is deprecated. Use `parent_id` instead. To set up proper dependencies please refer to this variable as a reference.
         :param pulumi.Input[bool] add_account_owners_admin_access: If parent_id is set, grant account owner team admin access to the new project. The default value is `true`.
-        :param pulumi.Input[str] available_credits: The amount of platform credits available to the project. This could be your free trial or other promotional credits.
-        :param pulumi.Input[str] billing_group: The id of the billing group that is linked to this project. To set up proper dependencies please refer to this variable as a reference.
-        :param pulumi.Input[str] ca_cert: The CA certificate of the project. This is required for configuring clients that connect to certain services like Kafka.
-        :param pulumi.Input[str] copy_from_project: is the name of another project used to copy billing information and some other project attributes like technical contacts from. This is mostly relevant when an existing project has billing type set to invoice and that needs to be copied over to a new project. (Setting billing is otherwise not allowed over the API.) This only has effect when the project is created. To set up proper dependencies please refer to this variable as a reference.
-        :param pulumi.Input[str] default_cloud: Defines the default cloud provider and region where services are hosted. This can be changed freely after the project is created. This will not affect existing services.
-        :param pulumi.Input[str] estimated_balance: The current accumulated bill for this project in the current billing period.
-        :param pulumi.Input[str] parent_id: An optional property to link a project to an already existing organization or account by using its ID. To set up proper dependencies please refer to this variable as a reference.
-        :param pulumi.Input[str] payment_method: The method of invoicing used for payments for this project, e.g. `card`.
-        :param pulumi.Input[str] project: Defines the name of the project. Name must be globally unique (between all Aiven customers) and cannot be changed later without destroying and re-creating the project, including all sub-resources.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ProjectTagArgs']]]] tags: Tags are key-value pairs that allow you to categorize projects.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] technical_emails: Defines the email addresses that will receive alerts about upcoming maintenance updates or warnings about service instability. It is a good practice to keep this up-to-date to be aware of any potential issues with your project.
+        :param pulumi.Input[str] available_credits: The number of trial or promotional credits remaining for this project.
+        :param pulumi.Input[str] billing_group: The ID of the billing group this project is assigned to. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] ca_cert: The CA certificate for the project. This is required for configuring clients that connect to certain services like Kafka.
+        :param pulumi.Input[str] copy_from_project: The name of the project to copy billing information, technical contacts, and some other project attributes from. This is most useful to set up the same billing method when you use bank transfers to pay invoices for other projects. You can only do this when creating a project. You can't set the billing over the API for an existing. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] default_cloud: Default cloud provider and region where services are hosted. This can be changed after the project is created and will not affect existing services.
+        :param pulumi.Input[str] estimated_balance: The monthly running estimate for this project for the current billing period.
+        :param pulumi.Input[str] parent_id: Link a project to an [organization, organizational unit,](https://aiven.io/docs/platform/concepts/orgs-units-projects) or account by using its ID. To set up proper dependencies please refer to this variable as a reference.
+        :param pulumi.Input[str] payment_method: The payment type used for this project. For example,`card`.
+        :param pulumi.Input[str] project: The name of the project. Names must be globally unique among all Aiven customers and cannot be changed later without destroying and re-creating the project, including all sub-resources.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['ProjectTagArgs', 'ProjectTagArgsDict']]]] tags: Tags are key-value pairs that allow you to categorize projects.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] technical_emails: The email addresses for [project contacts](https://aiven.io/docs/platform/howto/technical-emails), who will receive important alerts and updates about this project and its services. You can also set email contacts at the service level. It's good practice to keep these up-to-date to be aware of any potential issues with your project.
         :param pulumi.Input[bool] use_source_project_billing_group: Use the same billing group that is used in source project.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -621,31 +636,27 @@ class Project(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="accountId")
-    def account_id(self) -> pulumi.Output[Optional[str]]:
+    @_utilities.deprecated("""Use parent_id instead. This field will be removed in the next major release.""")
+    def account_id(self) -> pulumi.Output[str]:
         """
-        An optional property to link a project to an already existing account by using account ID. To set up proper dependencies please refer to this variable as a reference.
+        Link a project to an existing account using its account ID. This field is deprecated. Use `parent_id` instead. To set up proper dependencies please refer to this variable as a reference.
         """
-        warnings.warn("""Use parent_id instead. This field will be removed in the next major release.""", DeprecationWarning)
-        pulumi.log.warn("""account_id is deprecated: Use parent_id instead. This field will be removed in the next major release.""")
-
         return pulumi.get(self, "account_id")
 
     @property
     @pulumi.getter(name="addAccountOwnersAdminAccess")
+    @_utilities.deprecated("""This field is deprecated and will be removed in the next major release. Currently, it will always be set to true, regardless of the value set in the manifest.""")
     def add_account_owners_admin_access(self) -> pulumi.Output[Optional[bool]]:
         """
         If parent_id is set, grant account owner team admin access to the new project. The default value is `true`.
         """
-        warnings.warn("""This field is deprecated and will be removed in the next major release. Currently, it will always be set to true, regardless of the value set in the manifest.""", DeprecationWarning)
-        pulumi.log.warn("""add_account_owners_admin_access is deprecated: This field is deprecated and will be removed in the next major release. Currently, it will always be set to true, regardless of the value set in the manifest.""")
-
         return pulumi.get(self, "add_account_owners_admin_access")
 
     @property
     @pulumi.getter(name="availableCredits")
     def available_credits(self) -> pulumi.Output[str]:
         """
-        The amount of platform credits available to the project. This could be your free trial or other promotional credits.
+        The number of trial or promotional credits remaining for this project.
         """
         return pulumi.get(self, "available_credits")
 
@@ -653,7 +664,7 @@ class Project(pulumi.CustomResource):
     @pulumi.getter(name="billingGroup")
     def billing_group(self) -> pulumi.Output[Optional[str]]:
         """
-        The id of the billing group that is linked to this project. To set up proper dependencies please refer to this variable as a reference.
+        The ID of the billing group this project is assigned to. To set up proper dependencies please refer to this variable as a reference.
         """
         return pulumi.get(self, "billing_group")
 
@@ -661,7 +672,7 @@ class Project(pulumi.CustomResource):
     @pulumi.getter(name="caCert")
     def ca_cert(self) -> pulumi.Output[str]:
         """
-        The CA certificate of the project. This is required for configuring clients that connect to certain services like Kafka.
+        The CA certificate for the project. This is required for configuring clients that connect to certain services like Kafka.
         """
         return pulumi.get(self, "ca_cert")
 
@@ -669,7 +680,7 @@ class Project(pulumi.CustomResource):
     @pulumi.getter(name="copyFromProject")
     def copy_from_project(self) -> pulumi.Output[Optional[str]]:
         """
-        is the name of another project used to copy billing information and some other project attributes like technical contacts from. This is mostly relevant when an existing project has billing type set to invoice and that needs to be copied over to a new project. (Setting billing is otherwise not allowed over the API.) This only has effect when the project is created. To set up proper dependencies please refer to this variable as a reference.
+        The name of the project to copy billing information, technical contacts, and some other project attributes from. This is most useful to set up the same billing method when you use bank transfers to pay invoices for other projects. You can only do this when creating a project. You can't set the billing over the API for an existing. To set up proper dependencies please refer to this variable as a reference.
         """
         return pulumi.get(self, "copy_from_project")
 
@@ -677,7 +688,7 @@ class Project(pulumi.CustomResource):
     @pulumi.getter(name="defaultCloud")
     def default_cloud(self) -> pulumi.Output[Optional[str]]:
         """
-        Defines the default cloud provider and region where services are hosted. This can be changed freely after the project is created. This will not affect existing services.
+        Default cloud provider and region where services are hosted. This can be changed after the project is created and will not affect existing services.
         """
         return pulumi.get(self, "default_cloud")
 
@@ -685,7 +696,7 @@ class Project(pulumi.CustomResource):
     @pulumi.getter(name="estimatedBalance")
     def estimated_balance(self) -> pulumi.Output[str]:
         """
-        The current accumulated bill for this project in the current billing period.
+        The monthly running estimate for this project for the current billing period.
         """
         return pulumi.get(self, "estimated_balance")
 
@@ -693,7 +704,7 @@ class Project(pulumi.CustomResource):
     @pulumi.getter(name="parentId")
     def parent_id(self) -> pulumi.Output[Optional[str]]:
         """
-        An optional property to link a project to an already existing organization or account by using its ID. To set up proper dependencies please refer to this variable as a reference.
+        Link a project to an [organization, organizational unit,](https://aiven.io/docs/platform/concepts/orgs-units-projects) or account by using its ID. To set up proper dependencies please refer to this variable as a reference.
         """
         return pulumi.get(self, "parent_id")
 
@@ -701,7 +712,7 @@ class Project(pulumi.CustomResource):
     @pulumi.getter(name="paymentMethod")
     def payment_method(self) -> pulumi.Output[str]:
         """
-        The method of invoicing used for payments for this project, e.g. `card`.
+        The payment type used for this project. For example,`card`.
         """
         return pulumi.get(self, "payment_method")
 
@@ -709,7 +720,7 @@ class Project(pulumi.CustomResource):
     @pulumi.getter
     def project(self) -> pulumi.Output[str]:
         """
-        Defines the name of the project. Name must be globally unique (between all Aiven customers) and cannot be changed later without destroying and re-creating the project, including all sub-resources.
+        The name of the project. Names must be globally unique among all Aiven customers and cannot be changed later without destroying and re-creating the project, including all sub-resources.
         """
         return pulumi.get(self, "project")
 
@@ -725,18 +736,16 @@ class Project(pulumi.CustomResource):
     @pulumi.getter(name="technicalEmails")
     def technical_emails(self) -> pulumi.Output[Optional[Sequence[str]]]:
         """
-        Defines the email addresses that will receive alerts about upcoming maintenance updates or warnings about service instability. It is a good practice to keep this up-to-date to be aware of any potential issues with your project.
+        The email addresses for [project contacts](https://aiven.io/docs/platform/howto/technical-emails), who will receive important alerts and updates about this project and its services. You can also set email contacts at the service level. It's good practice to keep these up-to-date to be aware of any potential issues with your project.
         """
         return pulumi.get(self, "technical_emails")
 
     @property
     @pulumi.getter(name="useSourceProjectBillingGroup")
+    @_utilities.deprecated("""This field is deprecated and will be removed in the next major release.""")
     def use_source_project_billing_group(self) -> pulumi.Output[Optional[bool]]:
         """
         Use the same billing group that is used in source project.
         """
-        warnings.warn("""This field is deprecated and will be removed in the next major release.""", DeprecationWarning)
-        pulumi.log.warn("""use_source_project_billing_group is deprecated: This field is deprecated and will be removed in the next major release.""")
-
         return pulumi.get(self, "use_source_project_billing_group")