pulumi-aiven 6.25.0a1727423161__py3-none-any.whl → 6.26.0__py3-none-any.whl

pulumi_aiven/kafka.py

@@ -399,6 +399,9 @@ class _KafkaState:
             pulumi.set(__self__, "disk_space_default", disk_space_default)
         if disk_space_step is not None:
             pulumi.set(__self__, "disk_space_step", disk_space_step)
+        if disk_space_used is not None:
+            warnings.warn("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""", DeprecationWarning)
+            pulumi.log.warn("""disk_space_used is deprecated: This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
         if disk_space_used is not None:
             pulumi.set(__self__, "disk_space_used", disk_space_used)
         if kafka_user_config is not None:
@@ -546,6 +549,7 @@ class _KafkaState:
 
     @property
     @pulumi.getter(name="diskSpaceUsed")
+    @_utilities.deprecated("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
     def disk_space_used(self) -> Optional[pulumi.Input[str]]:
         """
         Disk space that service is currently using
@@ -1198,6 +1202,7 @@ class Kafka(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="diskSpaceUsed")
+    @_utilities.deprecated("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
     def disk_space_used(self) -> pulumi.Output[str]:
         """
         Disk space that service is currently using
@@ -1263,7 +1268,7 @@ class Kafka(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="projectVpcId")
-    def project_vpc_id(self) -> pulumi.Output[Optional[str]]:
+    def project_vpc_id(self) -> pulumi.Output[str]:
         """
         Specifies the VPC the service should run in. If the value is not set the service is not run inside a VPC. When set, the value should be given as a reference to set up dependencies correctly and the VPC must be in the same cloud and region as the service itself. Project can be freely moved to and from VPC after creation but doing so triggers migration to new servers so the operation can take significant amount of time to complete if the service has a lot of data.
         """
@@ -1279,7 +1284,7 @@ class Kafka(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="serviceIntegrations")
-    def service_integrations(self) -> pulumi.Output[Optional[Sequence['outputs.KafkaServiceIntegration']]]:
+    def service_integrations(self) -> pulumi.Output[Sequence['outputs.KafkaServiceIntegration']]:
         """
         Service integrations to specify when creating a service. Not applied after initial service creation
         """

pulumi_aiven/kafka_connect.py

@@ -339,6 +339,9 @@ class _KafkaConnectState:
             pulumi.set(__self__, "disk_space_default", disk_space_default)
         if disk_space_step is not None:
             pulumi.set(__self__, "disk_space_step", disk_space_step)
+        if disk_space_used is not None:
+            warnings.warn("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""", DeprecationWarning)
+            pulumi.log.warn("""disk_space_used is deprecated: This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
         if disk_space_used is not None:
             pulumi.set(__self__, "disk_space_used", disk_space_used)
         if kafka_connect_user_config is not None:
@@ -467,6 +470,7 @@ class _KafkaConnectState:
 
     @property
     @pulumi.getter(name="diskSpaceUsed")
+    @_utilities.deprecated("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
     def disk_space_used(self) -> Optional[pulumi.Input[str]]:
         """
         Disk space that service is currently using
@@ -1105,6 +1109,7 @@ class KafkaConnect(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="diskSpaceUsed")
+    @_utilities.deprecated("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
     def disk_space_used(self) -> pulumi.Output[str]:
         """
         Disk space that service is currently using
@@ -1153,7 +1158,7 @@ class KafkaConnect(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="projectVpcId")
-    def project_vpc_id(self) -> pulumi.Output[Optional[str]]:
+    def project_vpc_id(self) -> pulumi.Output[str]:
         """
         Specifies the VPC the service should run in. If the value is not set the service is not run inside a VPC. When set, the value should be given as a reference to set up dependencies correctly and the VPC must be in the same cloud and region as the service itself. Project can be freely moved to and from VPC after creation but doing so triggers migration to new servers so the operation can take significant amount of time to complete if the service has a lot of data.
         """
@@ -1169,7 +1174,7 @@ class KafkaConnect(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="serviceIntegrations")
-    def service_integrations(self) -> pulumi.Output[Optional[Sequence['outputs.KafkaConnectServiceIntegration']]]:
+    def service_integrations(self) -> pulumi.Output[Sequence['outputs.KafkaConnectServiceIntegration']]:
         """
         Service integrations to specify when creating a service. Not applied after initial service creation
         """

pulumi_aiven/kafka_mirror_maker.py

@@ -339,6 +339,9 @@ class _KafkaMirrorMakerState:
             pulumi.set(__self__, "disk_space_default", disk_space_default)
         if disk_space_step is not None:
             pulumi.set(__self__, "disk_space_step", disk_space_step)
+        if disk_space_used is not None:
+            warnings.warn("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""", DeprecationWarning)
+            pulumi.log.warn("""disk_space_used is deprecated: This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
         if disk_space_used is not None:
             pulumi.set(__self__, "disk_space_used", disk_space_used)
         if kafka_mirrormaker_user_config is not None:
@@ -467,6 +470,7 @@ class _KafkaMirrorMakerState:
 
     @property
     @pulumi.getter(name="diskSpaceUsed")
+    @_utilities.deprecated("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
     def disk_space_used(self) -> Optional[pulumi.Input[str]]:
         """
         Disk space that service is currently using
@@ -1049,6 +1053,7 @@ class KafkaMirrorMaker(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="diskSpaceUsed")
+    @_utilities.deprecated("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
     def disk_space_used(self) -> pulumi.Output[str]:
         """
         Disk space that service is currently using
@@ -1097,7 +1102,7 @@ class KafkaMirrorMaker(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="projectVpcId")
-    def project_vpc_id(self) -> pulumi.Output[Optional[str]]:
+    def project_vpc_id(self) -> pulumi.Output[str]:
         """
         Specifies the VPC the service should run in. If the value is not set the service is not run inside a VPC. When set, the value should be given as a reference to set up dependencies correctly and the VPC must be in the same cloud and region as the service itself. Project can be freely moved to and from VPC after creation but doing so triggers migration to new servers so the operation can take significant amount of time to complete if the service has a lot of data.
         """
@@ -1113,7 +1118,7 @@ class KafkaMirrorMaker(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="serviceIntegrations")
-    def service_integrations(self) -> pulumi.Output[Optional[Sequence['outputs.KafkaMirrorMakerServiceIntegration']]]:
+    def service_integrations(self) -> pulumi.Output[Sequence['outputs.KafkaMirrorMakerServiceIntegration']]:
         """
         Service integrations to specify when creating a service. Not applied after initial service creation
         """

pulumi_aiven/m3_aggregator.py

@@ -357,6 +357,9 @@ class _M3AggregatorState:
             pulumi.set(__self__, "disk_space_default", disk_space_default)
         if disk_space_step is not None:
             pulumi.set(__self__, "disk_space_step", disk_space_step)
+        if disk_space_used is not None:
+            warnings.warn("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""", DeprecationWarning)
+            pulumi.log.warn("""disk_space_used is deprecated: This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
         if disk_space_used is not None:
             pulumi.set(__self__, "disk_space_used", disk_space_used)
         if m3aggregator is not None:
@@ -487,6 +490,7 @@ class _M3AggregatorState:
 
     @property
     @pulumi.getter(name="diskSpaceUsed")
+    @_utilities.deprecated("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
     def disk_space_used(self) -> Optional[pulumi.Input[str]]:
         """
         Disk space that service is currently using
@@ -1082,6 +1086,7 @@ class M3Aggregator(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="diskSpaceUsed")
+    @_utilities.deprecated("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
     def disk_space_used(self) -> pulumi.Output[str]:
         """
         Disk space that service is currently using
@@ -1138,7 +1143,7 @@ class M3Aggregator(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="projectVpcId")
-    def project_vpc_id(self) -> pulumi.Output[Optional[str]]:
+    def project_vpc_id(self) -> pulumi.Output[str]:
         """
         Specifies the VPC the service should run in. If the value is not set the service is not run inside a VPC. When set, the value should be given as a reference to set up dependencies correctly and the VPC must be in the same cloud and region as the service itself. Project can be freely moved to and from VPC after creation but doing so triggers migration to new servers so the operation can take significant amount of time to complete if the service has a lot of data.
         """
@@ -1154,7 +1159,7 @@ class M3Aggregator(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="serviceIntegrations")
-    def service_integrations(self) -> pulumi.Output[Optional[Sequence['outputs.M3AggregatorServiceIntegration']]]:
+    def service_integrations(self) -> pulumi.Output[Sequence['outputs.M3AggregatorServiceIntegration']]:
         """
         Service integrations to specify when creating a service. Not applied after initial service creation
         """

pulumi_aiven/m3_db.py

@@ -357,6 +357,9 @@ class _M3DbState:
             pulumi.set(__self__, "disk_space_default", disk_space_default)
         if disk_space_step is not None:
             pulumi.set(__self__, "disk_space_step", disk_space_step)
+        if disk_space_used is not None:
+            warnings.warn("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""", DeprecationWarning)
+            pulumi.log.warn("""disk_space_used is deprecated: This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
         if disk_space_used is not None:
             pulumi.set(__self__, "disk_space_used", disk_space_used)
         if m3db is not None:
@@ -487,6 +490,7 @@ class _M3DbState:
 
     @property
     @pulumi.getter(name="diskSpaceUsed")
+    @_utilities.deprecated("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
     def disk_space_used(self) -> Optional[pulumi.Input[str]]:
         """
         Disk space that service is currently using
@@ -1090,6 +1094,7 @@ class M3Db(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="diskSpaceUsed")
+    @_utilities.deprecated("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
     def disk_space_used(self) -> pulumi.Output[str]:
         """
         Disk space that service is currently using
@@ -1146,7 +1151,7 @@ class M3Db(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="projectVpcId")
-    def project_vpc_id(self) -> pulumi.Output[Optional[str]]:
+    def project_vpc_id(self) -> pulumi.Output[str]:
         """
         Specifies the VPC the service should run in. If the value is not set the service is not run inside a VPC. When set, the value should be given as a reference to set up dependencies correctly and the VPC must be in the same cloud and region as the service itself. Project can be freely moved to and from VPC after creation but doing so triggers migration to new servers so the operation can take significant amount of time to complete if the service has a lot of data.
         """
@@ -1162,7 +1167,7 @@ class M3Db(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="serviceIntegrations")
-    def service_integrations(self) -> pulumi.Output[Optional[Sequence['outputs.M3DbServiceIntegration']]]:
+    def service_integrations(self) -> pulumi.Output[Sequence['outputs.M3DbServiceIntegration']]:
         """
         Service integrations to specify when creating a service. Not applied after initial service creation
         """

pulumi_aiven/my_sql.py

@@ -357,6 +357,9 @@ class _MySqlState:
             pulumi.set(__self__, "disk_space_default", disk_space_default)
         if disk_space_step is not None:
             pulumi.set(__self__, "disk_space_step", disk_space_step)
+        if disk_space_used is not None:
+            warnings.warn("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""", DeprecationWarning)
+            pulumi.log.warn("""disk_space_used is deprecated: This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
         if disk_space_used is not None:
             pulumi.set(__self__, "disk_space_used", disk_space_used)
         if maintenance_window_dow is not None:
@@ -487,6 +490,7 @@ class _MySqlState:
 
     @property
     @pulumi.getter(name="diskSpaceUsed")
+    @_utilities.deprecated("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
     def disk_space_used(self) -> Optional[pulumi.Input[str]]:
         """
         Disk space that service is currently using
@@ -1096,6 +1100,7 @@ class MySql(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="diskSpaceUsed")
+    @_utilities.deprecated("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
     def disk_space_used(self) -> pulumi.Output[str]:
         """
         Disk space that service is currently using
@@ -1152,7 +1157,7 @@ class MySql(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="projectVpcId")
-    def project_vpc_id(self) -> pulumi.Output[Optional[str]]:
+    def project_vpc_id(self) -> pulumi.Output[str]:
         """
         Specifies the VPC the service should run in. If the value is not set the service is not run inside a VPC. When set, the value should be given as a reference to set up dependencies correctly and the VPC must be in the same cloud and region as the service itself. Project can be freely moved to and from VPC after creation but doing so triggers migration to new servers so the operation can take significant amount of time to complete if the service has a lot of data.
         """
@@ -1168,7 +1173,7 @@ class MySql(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="serviceIntegrations")
-    def service_integrations(self) -> pulumi.Output[Optional[Sequence['outputs.MySqlServiceIntegration']]]:
+    def service_integrations(self) -> pulumi.Output[Sequence['outputs.MySqlServiceIntegration']]:
         """
         Service integrations to specify when creating a service. Not applied after initial service creation
         """

pulumi_aiven/open_search.py

@@ -357,6 +357,9 @@ class _OpenSearchState:
             pulumi.set(__self__, "disk_space_default", disk_space_default)
         if disk_space_step is not None:
             pulumi.set(__self__, "disk_space_step", disk_space_step)
+        if disk_space_used is not None:
+            warnings.warn("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""", DeprecationWarning)
+            pulumi.log.warn("""disk_space_used is deprecated: This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
         if disk_space_used is not None:
             pulumi.set(__self__, "disk_space_used", disk_space_used)
         if maintenance_window_dow is not None:
@@ -487,6 +490,7 @@ class _OpenSearchState:
 
     @property
     @pulumi.getter(name="diskSpaceUsed")
+    @_utilities.deprecated("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
     def disk_space_used(self) -> Optional[pulumi.Input[str]]:
         """
         Disk space that service is currently using
@@ -1098,6 +1102,7 @@ class OpenSearch(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="diskSpaceUsed")
+    @_utilities.deprecated("""This will be removed in v5.0.0. Please use `additional_disk_space` to specify the space to be added to the default `disk_space` defined by the plan.""")
     def disk_space_used(self) -> pulumi.Output[str]:
         """
         Disk space that service is currently using
@@ -1154,7 +1159,7 @@ class OpenSearch(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="projectVpcId")
-    def project_vpc_id(self) -> pulumi.Output[Optional[str]]:
+    def project_vpc_id(self) -> pulumi.Output[str]:
         """
         Specifies the VPC the service should run in. If the value is not set the service is not run inside a VPC. When set, the value should be given as a reference to set up dependencies correctly and the VPC must be in the same cloud and region as the service itself. Project can be freely moved to and from VPC after creation but doing so triggers migration to new servers so the operation can take significant amount of time to complete if the service has a lot of data.
         """
@@ -1170,7 +1175,7 @@ class OpenSearch(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="serviceIntegrations")
-    def service_integrations(self) -> pulumi.Output[Optional[Sequence['outputs.OpenSearchServiceIntegration']]]:
+    def service_integrations(self) -> pulumi.Output[Sequence['outputs.OpenSearchServiceIntegration']]:
         """
         Service integrations to specify when creating a service. Not applied after initial service creation
         """

pulumi_aiven/organization_group_project.py

@@ -24,7 +24,7 @@ class OrganizationGroupProjectArgs:
         The set of arguments for constructing a OrganizationGroupProject resource.
         :param pulumi.Input[str] group_id: The ID of the user group.
         :param pulumi.Input[str] project: The project that the users in the group are members of.
-        :param pulumi.Input[str] role: [Project-level role](https://aiven.io/docs/platform/reference/project-member-privileges) assigned to all users in the group. The possible values are `admin`, `operator`, `developer` and `read_only`.
+        :param pulumi.Input[str] role: [Project-level role](https://aiven.io/docs/platform/reference/project-member-privileges) assigned to all users in the group. The possible values are `admin`, `operator`, `developer`, `read_only` and `project:permissions:read`.
         """
         pulumi.set(__self__, "group_id", group_id)
         pulumi.set(__self__, "project", project)
@@ -60,7 +60,7 @@ class OrganizationGroupProjectArgs:
     @pulumi.getter
     def role(self) -> pulumi.Input[str]:
         """
-        [Project-level role](https://aiven.io/docs/platform/reference/project-member-privileges) assigned to all users in the group. The possible values are `admin`, `operator`, `developer` and `read_only`.
+        [Project-level role](https://aiven.io/docs/platform/reference/project-member-privileges) assigned to all users in the group. The possible values are `admin`, `operator`, `developer`, `read_only` and `project:permissions:read`.
         """
         return pulumi.get(self, "role")
 
@@ -89,7 +89,7 @@ class _OrganizationGroupProjectState:
         Input properties used for looking up and filtering OrganizationGroupProject resources.
         :param pulumi.Input[str] group_id: The ID of the user group.
         :param pulumi.Input[str] project: The project that the users in the group are members of.
-        :param pulumi.Input[str] role: [Project-level role](https://aiven.io/docs/platform/reference/project-member-privileges) assigned to all users in the group. The possible values are `admin`, `operator`, `developer` and `read_only`.
+        :param pulumi.Input[str] role: [Project-level role](https://aiven.io/docs/platform/reference/project-member-privileges) assigned to all users in the group. The possible values are `admin`, `operator`, `developer`, `read_only` and `project:permissions:read`.
         """
         if group_id is not None:
             pulumi.set(__self__, "group_id", group_id)
@@ -128,7 +128,7 @@ class _OrganizationGroupProjectState:
     @pulumi.getter
     def role(self) -> Optional[pulumi.Input[str]]:
         """
-        [Project-level role](https://aiven.io/docs/platform/reference/project-member-privileges) assigned to all users in the group. The possible values are `admin`, `operator`, `developer` and `read_only`.
+        [Project-level role](https://aiven.io/docs/platform/reference/project-member-privileges) assigned to all users in the group. The possible values are `admin`, `operator`, `developer`, `read_only` and `project:permissions:read`.
         """
         return pulumi.get(self, "role")
 
@@ -192,7 +192,7 @@ class OrganizationGroupProject(pulumi.CustomResource):
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] group_id: The ID of the user group.
         :param pulumi.Input[str] project: The project that the users in the group are members of.
-        :param pulumi.Input[str] role: [Project-level role](https://aiven.io/docs/platform/reference/project-member-privileges) assigned to all users in the group. The possible values are `admin`, `operator`, `developer` and `read_only`.
+        :param pulumi.Input[str] role: [Project-level role](https://aiven.io/docs/platform/reference/project-member-privileges) assigned to all users in the group. The possible values are `admin`, `operator`, `developer`, `read_only` and `project:permissions:read`.
         """
         ...
     @overload
@@ -293,7 +293,7 @@ class OrganizationGroupProject(pulumi.CustomResource):
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] group_id: The ID of the user group.
         :param pulumi.Input[str] project: The project that the users in the group are members of.
-        :param pulumi.Input[str] role: [Project-level role](https://aiven.io/docs/platform/reference/project-member-privileges) assigned to all users in the group. The possible values are `admin`, `operator`, `developer` and `read_only`.
+        :param pulumi.Input[str] role: [Project-level role](https://aiven.io/docs/platform/reference/project-member-privileges) assigned to all users in the group. The possible values are `admin`, `operator`, `developer`, `read_only` and `project:permissions:read`.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -325,7 +325,7 @@ class OrganizationGroupProject(pulumi.CustomResource):
     @pulumi.getter
     def role(self) -> pulumi.Output[str]:
         """
-        [Project-level role](https://aiven.io/docs/platform/reference/project-member-privileges) assigned to all users in the group. The possible values are `admin`, `operator`, `developer` and `read_only`.
+        [Project-level role](https://aiven.io/docs/platform/reference/project-member-privileges) assigned to all users in the group. The possible values are `admin`, `operator`, `developer`, `read_only` and `project:permissions:read`.
         """
         return pulumi.get(self, "role")
 

pulumi_aiven/organization_permission.py

@@ -22,9 +22,9 @@ class OrganizationPermissionArgs:
                  resource_type: pulumi.Input[str]):
         """
         The set of arguments for constructing a OrganizationPermission resource.
-        :param pulumi.Input[str] organization_id: Organization ID
-        :param pulumi.Input[Sequence[pulumi.Input['OrganizationPermissionPermissionArgs']]] permissions: A permission to set
-        :param pulumi.Input[str] resource_id: Resource Id.
+        :param pulumi.Input[str] organization_id: Organization ID.
+        :param pulumi.Input[Sequence[pulumi.Input['OrganizationPermissionPermissionArgs']]] permissions: Permissions to grant to principals.
+        :param pulumi.Input[str] resource_id: Resource ID.
         :param pulumi.Input[str] resource_type: Resource type. The possible values are `project`.
         """
         pulumi.set(__self__, "organization_id", organization_id)
@@ -36,7 +36,7 @@ class OrganizationPermissionArgs:
     @pulumi.getter(name="organizationId")
     def organization_id(self) -> pulumi.Input[str]:
         """
-        Organization ID
+        Organization ID.
         """
         return pulumi.get(self, "organization_id")
 
@@ -48,7 +48,7 @@ class OrganizationPermissionArgs:
     @pulumi.getter
     def permissions(self) -> pulumi.Input[Sequence[pulumi.Input['OrganizationPermissionPermissionArgs']]]:
         """
-        A permission to set
+        Permissions to grant to principals.
         """
         return pulumi.get(self, "permissions")
 
@@ -60,7 +60,7 @@ class OrganizationPermissionArgs:
     @pulumi.getter(name="resourceId")
     def resource_id(self) -> pulumi.Input[str]:
         """
-        Resource Id.
+        Resource ID.
         """
         return pulumi.get(self, "resource_id")
 
@@ -90,9 +90,9 @@ class _OrganizationPermissionState:
                  resource_type: Optional[pulumi.Input[str]] = None):
         """
         Input properties used for looking up and filtering OrganizationPermission resources.
-        :param pulumi.Input[str] organization_id: Organization ID
-        :param pulumi.Input[Sequence[pulumi.Input['OrganizationPermissionPermissionArgs']]] permissions: A permission to set
-        :param pulumi.Input[str] resource_id: Resource Id.
+        :param pulumi.Input[str] organization_id: Organization ID.
+        :param pulumi.Input[Sequence[pulumi.Input['OrganizationPermissionPermissionArgs']]] permissions: Permissions to grant to principals.
+        :param pulumi.Input[str] resource_id: Resource ID.
         :param pulumi.Input[str] resource_type: Resource type. The possible values are `project`.
         """
         if organization_id is not None:
@@ -108,7 +108,7 @@ class _OrganizationPermissionState:
     @pulumi.getter(name="organizationId")
     def organization_id(self) -> Optional[pulumi.Input[str]]:
         """
-        Organization ID
+        Organization ID.
         """
         return pulumi.get(self, "organization_id")
 
@@ -120,7 +120,7 @@ class _OrganizationPermissionState:
     @pulumi.getter
     def permissions(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['OrganizationPermissionPermissionArgs']]]]:
         """
-        A permission to set
+        Permissions to grant to principals.
         """
         return pulumi.get(self, "permissions")
 
@@ -132,7 +132,7 @@ class _OrganizationPermissionState:
     @pulumi.getter(name="resourceId")
     def resource_id(self) -> Optional[pulumi.Input[str]]:
         """
-        Resource Id.
+        Resource ID.
         """
         return pulumi.get(self, "resource_id")
 
@@ -169,11 +169,45 @@ class OrganizationPermission(pulumi.CustomResource):
         **This resource is in the beta stage and may change without notice.** Set
         the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.
 
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_aiven as aiven
+
+        # Grant permission to a user
+        operator = aiven.OrganizationPermission("operator",
+            organization_id=main["id"],
+            resource_id=example_project["id"],
+            resource_type="project",
+            permissions=[{
+                "permissions": ["operator"],
+                "principal_id": "u123a456b7890c",
+                "principal_type": "user",
+            }])
+        # Grant permission to a group
+        developers = aiven.OrganizationPermission("developers",
+            organization_id=main["id"],
+            resource_id=example_project["id"],
+            resource_type="project",
+            permissions=[{
+                "permissions": ["developer"],
+                "principal_id": example_group["groupId"],
+                "principal_type": "user_group",
+            }])
+        ```
+
+        ## Import
+
+        ```sh
+        $ pulumi import aiven:index/organizationPermission:OrganizationPermission operator ORGANIZATION_ID/ID
+        ```
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] organization_id: Organization ID
-        :param pulumi.Input[Sequence[pulumi.Input[Union['OrganizationPermissionPermissionArgs', 'OrganizationPermissionPermissionArgsDict']]]] permissions: A permission to set
-        :param pulumi.Input[str] resource_id: Resource Id.
+        :param pulumi.Input[str] organization_id: Organization ID.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['OrganizationPermissionPermissionArgs', 'OrganizationPermissionPermissionArgsDict']]]] permissions: Permissions to grant to principals.
+        :param pulumi.Input[str] resource_id: Resource ID.
         :param pulumi.Input[str] resource_type: Resource type. The possible values are `project`.
         """
         ...
@@ -188,6 +222,40 @@ class OrganizationPermission(pulumi.CustomResource):
         **This resource is in the beta stage and may change without notice.** Set
         the `PROVIDER_AIVEN_ENABLE_BETA` environment variable to use the resource.
 
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_aiven as aiven
+
+        # Grant permission to a user
+        operator = aiven.OrganizationPermission("operator",
+            organization_id=main["id"],
+            resource_id=example_project["id"],
+            resource_type="project",
+            permissions=[{
+                "permissions": ["operator"],
+                "principal_id": "u123a456b7890c",
+                "principal_type": "user",
+            }])
+        # Grant permission to a group
+        developers = aiven.OrganizationPermission("developers",
+            organization_id=main["id"],
+            resource_id=example_project["id"],
+            resource_type="project",
+            permissions=[{
+                "permissions": ["developer"],
+                "principal_id": example_group["groupId"],
+                "principal_type": "user_group",
+            }])
+        ```
+
+        ## Import
+
+        ```sh
+        $ pulumi import aiven:index/organizationPermission:OrganizationPermission operator ORGANIZATION_ID/ID
+        ```
+
         :param str resource_name: The name of the resource.
         :param OrganizationPermissionArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -249,9 +317,9 @@ class OrganizationPermission(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] organization_id: Organization ID
-        :param pulumi.Input[Sequence[pulumi.Input[Union['OrganizationPermissionPermissionArgs', 'OrganizationPermissionPermissionArgsDict']]]] permissions: A permission to set
-        :param pulumi.Input[str] resource_id: Resource Id.
+        :param pulumi.Input[str] organization_id: Organization ID.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['OrganizationPermissionPermissionArgs', 'OrganizationPermissionPermissionArgsDict']]]] permissions: Permissions to grant to principals.
+        :param pulumi.Input[str] resource_id: Resource ID.
         :param pulumi.Input[str] resource_type: Resource type. The possible values are `project`.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -268,7 +336,7 @@ class OrganizationPermission(pulumi.CustomResource):
     @pulumi.getter(name="organizationId")
     def organization_id(self) -> pulumi.Output[str]:
         """
-        Organization ID
+        Organization ID.
         """
         return pulumi.get(self, "organization_id")
 
@@ -276,7 +344,7 @@ class OrganizationPermission(pulumi.CustomResource):
     @pulumi.getter
     def permissions(self) -> pulumi.Output[Sequence['outputs.OrganizationPermissionPermission']]:
         """
-        A permission to set
+        Permissions to grant to principals.
         """
         return pulumi.get(self, "permissions")
 
@@ -284,7 +352,7 @@ class OrganizationPermission(pulumi.CustomResource):
     @pulumi.getter(name="resourceId")
     def resource_id(self) -> pulumi.Output[str]:
         """
-        Resource Id.
+        Resource ID.
         """
         return pulumi.get(self, "resource_id")