pulumi-aiven 6.13.0a1711027602__py3-none-any.whl → 6.14.0__py3-none-any.whl

pulumi_aiven/organization_group_project.py

@@ -0,0 +1,336 @@
+# coding=utf-8
+# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import copy
+import warnings
+import pulumi
+import pulumi.runtime
+from typing import Any, Mapping, Optional, Sequence, Union, overload
+from . import _utilities
+from . import outputs
+from ._inputs import *
+
+__all__ = ['OrganizationGroupProjectArgs', 'OrganizationGroupProject']
+
+@pulumi.input_type
+class OrganizationGroupProjectArgs:
+    def __init__(__self__, *,
+                 group_id: pulumi.Input[str],
+                 project: pulumi.Input[str],
+                 role: pulumi.Input[str],
+                 timeouts: Optional[pulumi.Input['OrganizationGroupProjectTimeoutsArgs']] = None):
+        """
+        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: Role assigned to all users in the group for the project.
+        """
+        pulumi.set(__self__, "group_id", group_id)
+        pulumi.set(__self__, "project", project)
+        pulumi.set(__self__, "role", role)
+        if timeouts is not None:
+            pulumi.set(__self__, "timeouts", timeouts)
+
+    @property
+    @pulumi.getter(name="groupId")
+    def group_id(self) -> pulumi.Input[str]:
+        """
+        The ID of the user group.
+        """
+        return pulumi.get(self, "group_id")
+
+    @group_id.setter
+    def group_id(self, value: pulumi.Input[str]):
+        pulumi.set(self, "group_id", value)
+
+    @property
+    @pulumi.getter
+    def project(self) -> pulumi.Input[str]:
+        """
+        The project that the users in the group are members of.
+        """
+        return pulumi.get(self, "project")
+
+    @project.setter
+    def project(self, value: pulumi.Input[str]):
+        pulumi.set(self, "project", value)
+
+    @property
+    @pulumi.getter
+    def role(self) -> pulumi.Input[str]:
+        """
+        Role assigned to all users in the group for the project.
+        """
+        return pulumi.get(self, "role")
+
+    @role.setter
+    def role(self, value: pulumi.Input[str]):
+        pulumi.set(self, "role", value)
+
+    @property
+    @pulumi.getter
+    def timeouts(self) -> Optional[pulumi.Input['OrganizationGroupProjectTimeoutsArgs']]:
+        return pulumi.get(self, "timeouts")
+
+    @timeouts.setter
+    def timeouts(self, value: Optional[pulumi.Input['OrganizationGroupProjectTimeoutsArgs']]):
+        pulumi.set(self, "timeouts", value)
+
+
+@pulumi.input_type
+class _OrganizationGroupProjectState:
+    def __init__(__self__, *,
+                 group_id: Optional[pulumi.Input[str]] = None,
+                 project: Optional[pulumi.Input[str]] = None,
+                 role: Optional[pulumi.Input[str]] = None,
+                 timeouts: Optional[pulumi.Input['OrganizationGroupProjectTimeoutsArgs']] = None):
+        """
+        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: Role assigned to all users in the group for the project.
+        """
+        if group_id is not None:
+            pulumi.set(__self__, "group_id", group_id)
+        if project is not None:
+            pulumi.set(__self__, "project", project)
+        if role is not None:
+            pulumi.set(__self__, "role", role)
+        if timeouts is not None:
+            pulumi.set(__self__, "timeouts", timeouts)
+
+    @property
+    @pulumi.getter(name="groupId")
+    def group_id(self) -> Optional[pulumi.Input[str]]:
+        """
+        The ID of the user group.
+        """
+        return pulumi.get(self, "group_id")
+
+    @group_id.setter
+    def group_id(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "group_id", value)
+
+    @property
+    @pulumi.getter
+    def project(self) -> Optional[pulumi.Input[str]]:
+        """
+        The project that the users in the group are members of.
+        """
+        return pulumi.get(self, "project")
+
+    @project.setter
+    def project(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "project", value)
+
+    @property
+    @pulumi.getter
+    def role(self) -> Optional[pulumi.Input[str]]:
+        """
+        Role assigned to all users in the group for the project.
+        """
+        return pulumi.get(self, "role")
+
+    @role.setter
+    def role(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "role", value)
+
+    @property
+    @pulumi.getter
+    def timeouts(self) -> Optional[pulumi.Input['OrganizationGroupProjectTimeoutsArgs']]:
+        return pulumi.get(self, "timeouts")
+
+    @timeouts.setter
+    def timeouts(self, value: Optional[pulumi.Input['OrganizationGroupProjectTimeoutsArgs']]):
+        pulumi.set(self, "timeouts", value)
+
+
+class OrganizationGroupProject(pulumi.CustomResource):
+    @overload
+    def __init__(__self__,
+                 resource_name: str,
+                 opts: Optional[pulumi.ResourceOptions] = None,
+                 group_id: Optional[pulumi.Input[str]] = None,
+                 project: Optional[pulumi.Input[str]] = None,
+                 role: Optional[pulumi.Input[str]] = None,
+                 timeouts: Optional[pulumi.Input[pulumi.InputType['OrganizationGroupProjectTimeoutsArgs']]] = None,
+                 __props__=None):
+        """
+        Adds and manages a [group](https://aiven.io/docs/platform/concepts/projects_accounts_access#groups) of users as [members of a project](https://aiven.io/docs/platform/reference/project-member-privileges).
+
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_aiven as aiven
+
+        example_project = aiven.Project("example_project",
+            project="example-project",
+            parent_id=main["id"])
+        example = aiven.OrganizationUserGroup("example",
+            description="Example group of users.",
+            organization_id=main["id"],
+            name="Example group")
+        project_admin = aiven.OrganizationUserGroupMember("project_admin",
+            group_id=example.group_id,
+            organization_id=main["id"],
+            user_id="u123a456b7890c")
+        example_organization_group_project = aiven.OrganizationGroupProject("example",
+            group_id=example.group_id,
+            project=example_project_aiven_project["project"],
+            role="admin")
+        ```
+
+        ## Import
+
+        ```sh
+        $ pulumi import aiven:index/organizationGroupProject:OrganizationGroupProject example PROJECT/USER_GROUP_ID
+        ```
+
+        :param str resource_name: The name of the resource.
+        :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: Role assigned to all users in the group for the project.
+        """
+        ...
+    @overload
+    def __init__(__self__,
+                 resource_name: str,
+                 args: OrganizationGroupProjectArgs,
+                 opts: Optional[pulumi.ResourceOptions] = None):
+        """
+        Adds and manages a [group](https://aiven.io/docs/platform/concepts/projects_accounts_access#groups) of users as [members of a project](https://aiven.io/docs/platform/reference/project-member-privileges).
+
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_aiven as aiven
+
+        example_project = aiven.Project("example_project",
+            project="example-project",
+            parent_id=main["id"])
+        example = aiven.OrganizationUserGroup("example",
+            description="Example group of users.",
+            organization_id=main["id"],
+            name="Example group")
+        project_admin = aiven.OrganizationUserGroupMember("project_admin",
+            group_id=example.group_id,
+            organization_id=main["id"],
+            user_id="u123a456b7890c")
+        example_organization_group_project = aiven.OrganizationGroupProject("example",
+            group_id=example.group_id,
+            project=example_project_aiven_project["project"],
+            role="admin")
+        ```
+
+        ## Import
+
+        ```sh
+        $ pulumi import aiven:index/organizationGroupProject:OrganizationGroupProject example PROJECT/USER_GROUP_ID
+        ```
+
+        :param str resource_name: The name of the resource.
+        :param OrganizationGroupProjectArgs args: The arguments to use to populate this resource's properties.
+        :param pulumi.ResourceOptions opts: Options for the resource.
+        """
+        ...
+    def __init__(__self__, resource_name: str, *args, **kwargs):
+        resource_args, opts = _utilities.get_resource_args_opts(OrganizationGroupProjectArgs, pulumi.ResourceOptions, *args, **kwargs)
+        if resource_args is not None:
+            __self__._internal_init(resource_name, opts, **resource_args.__dict__)
+        else:
+            __self__._internal_init(resource_name, *args, **kwargs)
+
+    def _internal_init(__self__,
+                 resource_name: str,
+                 opts: Optional[pulumi.ResourceOptions] = None,
+                 group_id: Optional[pulumi.Input[str]] = None,
+                 project: Optional[pulumi.Input[str]] = None,
+                 role: Optional[pulumi.Input[str]] = None,
+                 timeouts: Optional[pulumi.Input[pulumi.InputType['OrganizationGroupProjectTimeoutsArgs']]] = None,
+                 __props__=None):
+        opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
+        if not isinstance(opts, pulumi.ResourceOptions):
+            raise TypeError('Expected resource options to be a ResourceOptions instance')
+        if opts.id is None:
+            if __props__ is not None:
+                raise TypeError('__props__ is only valid when passed in combination with a valid opts.id to get an existing resource')
+            __props__ = OrganizationGroupProjectArgs.__new__(OrganizationGroupProjectArgs)
+
+            if group_id is None and not opts.urn:
+                raise TypeError("Missing required property 'group_id'")
+            __props__.__dict__["group_id"] = group_id
+            if project is None and not opts.urn:
+                raise TypeError("Missing required property 'project'")
+            __props__.__dict__["project"] = project
+            if role is None and not opts.urn:
+                raise TypeError("Missing required property 'role'")
+            __props__.__dict__["role"] = role
+            __props__.__dict__["timeouts"] = timeouts
+        super(OrganizationGroupProject, __self__).__init__(
+            'aiven:index/organizationGroupProject:OrganizationGroupProject',
+            resource_name,
+            __props__,
+            opts)
+
+    @staticmethod
+    def get(resource_name: str,
+            id: pulumi.Input[str],
+            opts: Optional[pulumi.ResourceOptions] = None,
+            group_id: Optional[pulumi.Input[str]] = None,
+            project: Optional[pulumi.Input[str]] = None,
+            role: Optional[pulumi.Input[str]] = None,
+            timeouts: Optional[pulumi.Input[pulumi.InputType['OrganizationGroupProjectTimeoutsArgs']]] = None) -> 'OrganizationGroupProject':
+        """
+        Get an existing OrganizationGroupProject resource's state with the given name, id, and optional extra
+        properties used to qualify the lookup.
+
+        :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] 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: Role assigned to all users in the group for the project.
+        """
+        opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
+
+        __props__ = _OrganizationGroupProjectState.__new__(_OrganizationGroupProjectState)
+
+        __props__.__dict__["group_id"] = group_id
+        __props__.__dict__["project"] = project
+        __props__.__dict__["role"] = role
+        __props__.__dict__["timeouts"] = timeouts
+        return OrganizationGroupProject(resource_name, opts=opts, __props__=__props__)
+
+    @property
+    @pulumi.getter(name="groupId")
+    def group_id(self) -> pulumi.Output[str]:
+        """
+        The ID of the user group.
+        """
+        return pulumi.get(self, "group_id")
+
+    @property
+    @pulumi.getter
+    def project(self) -> pulumi.Output[str]:
+        """
+        The project that the users in the group are members of.
+        """
+        return pulumi.get(self, "project")
+
+    @property
+    @pulumi.getter
+    def role(self) -> pulumi.Output[str]:
+        """
+        Role assigned to all users in the group for the project.
+        """
+        return pulumi.get(self, "role")
+
+    @property
+    @pulumi.getter
+    def timeouts(self) -> pulumi.Output[Optional['outputs.OrganizationGroupProjectTimeouts']]:
+        return pulumi.get(self, "timeouts")
+

pulumi_aiven/organization_user.py

@@ -18,8 +18,8 @@ class OrganizationUserArgs:
                  user_email: pulumi.Input[str]):
         """
         The set of arguments for constructing a OrganizationUser resource.
-        :param pulumi.Input[str] organization_id: The unique organization ID. This property cannot be changed, doing so forces recreation of the resource.
-        :param pulumi.Input[str] user_email: This is a user email address that first will be invited, and after accepting an invitation, they become a member of the organization. Should be lowercase. This property cannot be changed, doing so forces recreation of the resource.
+        :param pulumi.Input[str] organization_id: The unique organization ID. Changing this property forces recreation of the resource.
+        :param pulumi.Input[str] user_email: This is a user email address that first will be invited, and after accepting an invitation, they become a member of the organization. Should be lowercase. Changing this property forces recreation of the resource.
         """
         pulumi.set(__self__, "organization_id", organization_id)
         pulumi.set(__self__, "user_email", user_email)
@@ -28,7 +28,7 @@ class OrganizationUserArgs:
     @pulumi.getter(name="organizationId")
     def organization_id(self) -> pulumi.Input[str]:
         """
-        The unique organization ID. This property cannot be changed, doing so forces recreation of the resource.
+        The unique organization ID. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "organization_id")
 
@@ -40,7 +40,7 @@ class OrganizationUserArgs:
     @pulumi.getter(name="userEmail")
     def user_email(self) -> pulumi.Input[str]:
         """
-        This is a user email address that first will be invited, and after accepting an invitation, they become a member of the organization. Should be lowercase. This property cannot be changed, doing so forces recreation of the resource.
+        This is a user email address that first will be invited, and after accepting an invitation, they become a member of the organization. Should be lowercase. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "user_email")
 
@@ -63,8 +63,8 @@ class _OrganizationUserState:
         :param pulumi.Input[bool] accepted: This is a boolean flag that determines whether an invitation was accepted or not by the user. `false` value means that the invitation was sent to the user but not yet accepted. `true` means that the user accepted the invitation and now a member of an organization.
         :param pulumi.Input[str] create_time: Time of creation
         :param pulumi.Input[str] invited_by: The email address of the user who sent an invitation to the user.
-        :param pulumi.Input[str] organization_id: The unique organization ID. This property cannot be changed, doing so forces recreation of the resource.
-        :param pulumi.Input[str] user_email: This is a user email address that first will be invited, and after accepting an invitation, they become a member of the organization. Should be lowercase. This property cannot be changed, doing so forces recreation of the resource.
+        :param pulumi.Input[str] organization_id: The unique organization ID. Changing this property forces recreation of the resource.
+        :param pulumi.Input[str] user_email: This is a user email address that first will be invited, and after accepting an invitation, they become a member of the organization. Should be lowercase. Changing this property forces recreation of the resource.
         :param pulumi.Input[str] user_id: The unique organization user ID
         """
         if accepted is not None:
@@ -132,7 +132,7 @@ class _OrganizationUserState:
     @pulumi.getter(name="organizationId")
     def organization_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The unique organization ID. This property cannot be changed, doing so forces recreation of the resource.
+        The unique organization ID. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "organization_id")
 
@@ -144,7 +144,7 @@ class _OrganizationUserState:
     @pulumi.getter(name="userEmail")
     def user_email(self) -> Optional[pulumi.Input[str]]:
         """
-        This is a user email address that first will be invited, and after accepting an invitation, they become a member of the organization. Should be lowercase. This property cannot be changed, doing so forces recreation of the resource.
+        This is a user email address that first will be invited, and after accepting an invitation, they become a member of the organization. Should be lowercase. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "user_email")
 
@@ -174,20 +174,11 @@ class OrganizationUser(pulumi.CustomResource):
                  user_email: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        **This resource is deprecated**. Use the OrganizationUser data source instead.
-
-        The organization user resource allows the creation and management of an Aiven organization user.
-
-        During the creation of `OrganizationUser`resource, an email invitation will be sent
-        to a user using `user_email` address. If the user accepts an invitation, they will become
-        a member of the organization. The deletion of `OrganizationUser` will not only
-        delete the invitation if one was sent but not yet accepted by the user, it will also
-        eliminate the member from the organization if one has accepted an invitation previously.
-
+        Create a OrganizationUser resource with the given unique name, props, and options.
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] organization_id: The unique organization ID. This property cannot be changed, doing so forces recreation of the resource.
-        :param pulumi.Input[str] user_email: This is a user email address that first will be invited, and after accepting an invitation, they become a member of the organization. Should be lowercase. This property cannot be changed, doing so forces recreation of the resource.
+        :param pulumi.Input[str] organization_id: The unique organization ID. Changing this property forces recreation of the resource.
+        :param pulumi.Input[str] user_email: This is a user email address that first will be invited, and after accepting an invitation, they become a member of the organization. Should be lowercase. Changing this property forces recreation of the resource.
         """
         ...
     @overload
@@ -196,16 +187,7 @@ class OrganizationUser(pulumi.CustomResource):
                  args: OrganizationUserArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        **This resource is deprecated**. Use the OrganizationUser data source instead.
-
-        The organization user resource allows the creation and management of an Aiven organization user.
-
-        During the creation of `OrganizationUser`resource, an email invitation will be sent
-        to a user using `user_email` address. If the user accepts an invitation, they will become
-        a member of the organization. The deletion of `OrganizationUser` will not only
-        delete the invitation if one was sent but not yet accepted by the user, it will also
-        eliminate the member from the organization if one has accepted an invitation previously.
-
+        Create a OrganizationUser resource with the given unique name, props, and options.
         :param str resource_name: The name of the resource.
         :param OrganizationUserArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -268,8 +250,8 @@ class OrganizationUser(pulumi.CustomResource):
         :param pulumi.Input[bool] accepted: This is a boolean flag that determines whether an invitation was accepted or not by the user. `false` value means that the invitation was sent to the user but not yet accepted. `true` means that the user accepted the invitation and now a member of an organization.
         :param pulumi.Input[str] create_time: Time of creation
         :param pulumi.Input[str] invited_by: The email address of the user who sent an invitation to the user.
-        :param pulumi.Input[str] organization_id: The unique organization ID. This property cannot be changed, doing so forces recreation of the resource.
-        :param pulumi.Input[str] user_email: This is a user email address that first will be invited, and after accepting an invitation, they become a member of the organization. Should be lowercase. This property cannot be changed, doing so forces recreation of the resource.
+        :param pulumi.Input[str] organization_id: The unique organization ID. Changing this property forces recreation of the resource.
+        :param pulumi.Input[str] user_email: This is a user email address that first will be invited, and after accepting an invitation, they become a member of the organization. Should be lowercase. Changing this property forces recreation of the resource.
         :param pulumi.Input[str] user_id: The unique organization user ID
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -318,7 +300,7 @@ class OrganizationUser(pulumi.CustomResource):
     @pulumi.getter(name="organizationId")
     def organization_id(self) -> pulumi.Output[str]:
         """
-        The unique organization ID. This property cannot be changed, doing so forces recreation of the resource.
+        The unique organization ID. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "organization_id")
 
@@ -326,7 +308,7 @@ class OrganizationUser(pulumi.CustomResource):
     @pulumi.getter(name="userEmail")
     def user_email(self) -> pulumi.Output[str]:
         """
-        This is a user email address that first will be invited, and after accepting an invitation, they become a member of the organization. Should be lowercase. This property cannot be changed, doing so forces recreation of the resource.
+        This is a user email address that first will be invited, and after accepting an invitation, they become a member of the organization. Should be lowercase. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "user_email")
 

pulumi_aiven/organization_user_group.py

@@ -19,9 +19,9 @@ class OrganizationUserGroupArgs:
                  name: Optional[pulumi.Input[str]] = None):
         """
         The set of arguments for constructing a OrganizationUserGroup resource.
-        :param pulumi.Input[str] description: The description of the user group. This property cannot be changed, doing so forces recreation of the resource.
-        :param pulumi.Input[str] organization_id: The ID of the organization. This property cannot be changed, doing so forces recreation of the resource.
-        :param pulumi.Input[str] name: The name of the user group. This property cannot be changed, doing so forces recreation of the resource.
+        :param pulumi.Input[str] description: The description of the user group. Changing this property forces recreation of the resource.
+        :param pulumi.Input[str] organization_id: The ID of the organization. Changing this property forces recreation of the resource.
+        :param pulumi.Input[str] name: The name of the user group. Changing this property forces recreation of the resource.
         """
         pulumi.set(__self__, "description", description)
         pulumi.set(__self__, "organization_id", organization_id)
@@ -32,7 +32,7 @@ class OrganizationUserGroupArgs:
     @pulumi.getter
     def description(self) -> pulumi.Input[str]:
         """
-        The description of the user group. This property cannot be changed, doing so forces recreation of the resource.
+        The description of the user group. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "description")
 
@@ -44,7 +44,7 @@ class OrganizationUserGroupArgs:
     @pulumi.getter(name="organizationId")
     def organization_id(self) -> pulumi.Input[str]:
         """
-        The ID of the organization. This property cannot be changed, doing so forces recreation of the resource.
+        The ID of the organization. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "organization_id")
 
@@ -56,7 +56,7 @@ class OrganizationUserGroupArgs:
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[str]]:
         """
-        The name of the user group. This property cannot be changed, doing so forces recreation of the resource.
+        The name of the user group. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "name")
 
@@ -77,10 +77,10 @@ class _OrganizationUserGroupState:
         """
         Input properties used for looking up and filtering OrganizationUserGroup resources.
         :param pulumi.Input[str] create_time: Time of creation.
-        :param pulumi.Input[str] description: The description of the user group. This property cannot be changed, doing so forces recreation of the resource.
+        :param pulumi.Input[str] description: The description of the user group. Changing this property forces recreation of the resource.
         :param pulumi.Input[str] group_id: The ID of the user group.
-        :param pulumi.Input[str] name: The name of the user group. This property cannot be changed, doing so forces recreation of the resource.
-        :param pulumi.Input[str] organization_id: The ID of the organization. This property cannot be changed, doing so forces recreation of the resource.
+        :param pulumi.Input[str] name: The name of the user group. Changing this property forces recreation of the resource.
+        :param pulumi.Input[str] organization_id: The ID of the organization. Changing this property forces recreation of the resource.
         :param pulumi.Input[str] update_time: Time of last update.
         """
         if create_time is not None:
@@ -112,7 +112,7 @@ class _OrganizationUserGroupState:
     @pulumi.getter
     def description(self) -> Optional[pulumi.Input[str]]:
         """
-        The description of the user group. This property cannot be changed, doing so forces recreation of the resource.
+        The description of the user group. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "description")
 
@@ -136,7 +136,7 @@ class _OrganizationUserGroupState:
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[str]]:
         """
-        The name of the user group. This property cannot be changed, doing so forces recreation of the resource.
+        The name of the user group. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "name")
 
@@ -148,7 +148,7 @@ class _OrganizationUserGroupState:
     @pulumi.getter(name="organizationId")
     def organization_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The ID of the organization. This property cannot be changed, doing so forces recreation of the resource.
+        The ID of the organization. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "organization_id")
 
@@ -179,13 +179,31 @@ class OrganizationUserGroup(pulumi.CustomResource):
                  organization_id: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        Creates and manages a user group in an organization.
+        Creates and manages a [user group](https://aiven.io/docs/platform/concepts/projects_accounts_access#groups) in an organization.
+
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_aiven as aiven
+
+        example = aiven.OrganizationUserGroup("example",
+            description="Example group of users.",
+            organization_id=main["id"],
+            name="Example group")
+        ```
+
+        ## Import
+
+        ```sh
+        $ pulumi import aiven:index/organizationUserGroup:OrganizationUserGroup example ORGANIZATION_ID/USER_GROUP_ID
+        ```
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] description: The description of the user group. This property cannot be changed, doing so forces recreation of the resource.
-        :param pulumi.Input[str] name: The name of the user group. This property cannot be changed, doing so forces recreation of the resource.
-        :param pulumi.Input[str] organization_id: The ID of the organization. This property cannot be changed, doing so forces recreation of the resource.
+        :param pulumi.Input[str] description: The description of the user group. Changing this property forces recreation of the resource.
+        :param pulumi.Input[str] name: The name of the user group. Changing this property forces recreation of the resource.
+        :param pulumi.Input[str] organization_id: The ID of the organization. Changing this property forces recreation of the resource.
         """
         ...
     @overload
@@ -194,7 +212,25 @@ class OrganizationUserGroup(pulumi.CustomResource):
                  args: OrganizationUserGroupArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Creates and manages a user group in an organization.
+        Creates and manages a [user group](https://aiven.io/docs/platform/concepts/projects_accounts_access#groups) in an organization.
+
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_aiven as aiven
+
+        example = aiven.OrganizationUserGroup("example",
+            description="Example group of users.",
+            organization_id=main["id"],
+            name="Example group")
+        ```
+
+        ## Import
+
+        ```sh
+        $ pulumi import aiven:index/organizationUserGroup:OrganizationUserGroup example ORGANIZATION_ID/USER_GROUP_ID
+        ```
 
         :param str resource_name: The name of the resource.
         :param OrganizationUserGroupArgs args: The arguments to use to populate this resource's properties.
@@ -257,10 +293,10 @@ class OrganizationUserGroup(pulumi.CustomResource):
         :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] create_time: Time of creation.
-        :param pulumi.Input[str] description: The description of the user group. This property cannot be changed, doing so forces recreation of the resource.
+        :param pulumi.Input[str] description: The description of the user group. Changing this property forces recreation of the resource.
         :param pulumi.Input[str] group_id: The ID of the user group.
-        :param pulumi.Input[str] name: The name of the user group. This property cannot be changed, doing so forces recreation of the resource.
-        :param pulumi.Input[str] organization_id: The ID of the organization. This property cannot be changed, doing so forces recreation of the resource.
+        :param pulumi.Input[str] name: The name of the user group. Changing this property forces recreation of the resource.
+        :param pulumi.Input[str] organization_id: The ID of the organization. Changing this property forces recreation of the resource.
         :param pulumi.Input[str] update_time: Time of last update.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -287,7 +323,7 @@ class OrganizationUserGroup(pulumi.CustomResource):
     @pulumi.getter
     def description(self) -> pulumi.Output[str]:
         """
-        The description of the user group. This property cannot be changed, doing so forces recreation of the resource.
+        The description of the user group. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "description")
 
@@ -303,7 +339,7 @@ class OrganizationUserGroup(pulumi.CustomResource):
     @pulumi.getter
     def name(self) -> pulumi.Output[str]:
         """
-        The name of the user group. This property cannot be changed, doing so forces recreation of the resource.
+        The name of the user group. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "name")
 
@@ -311,7 +347,7 @@ class OrganizationUserGroup(pulumi.CustomResource):
     @pulumi.getter(name="organizationId")
     def organization_id(self) -> pulumi.Output[str]:
         """
-        The ID of the organization. This property cannot be changed, doing so forces recreation of the resource.
+        The ID of the organization. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "organization_id")