pulumi-aiven 6.19.0a1721845827__py3-none-any.whl → 6.19.0a1721847551__py3-none-any.whl

pulumi_aiven/kafka_topic.py

@@ -31,8 +31,8 @@ class KafkaTopicArgs:
         :param pulumi.Input[int] replication: The replication factor for the topic.
         :param pulumi.Input[str] service_name: The name of the service that this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
         :param pulumi.Input[str] topic_name: The name of the topic. Changing this property forces recreation of the resource.
-        :param pulumi.Input['KafkaTopicConfigArgs'] config: Kafka topic configuration.
-        :param pulumi.Input[Sequence[pulumi.Input['KafkaTopicTagArgs']]] tags: Tags for the Kafka topic.
+        :param pulumi.Input['KafkaTopicConfigArgs'] config: [Advanced parameters](https://aiven.io/docs/products/kafka/reference/advanced-params) to configure topics.
+        :param pulumi.Input[Sequence[pulumi.Input['KafkaTopicTagArgs']]] tags: Tags for the topic.
         """
         pulumi.set(__self__, "partitions", partitions)
         pulumi.set(__self__, "project", project)
@@ -110,7 +110,7 @@ class KafkaTopicArgs:
     @pulumi.getter
     def config(self) -> Optional[pulumi.Input['KafkaTopicConfigArgs']]:
         """
-        Kafka topic configuration.
+        [Advanced parameters](https://aiven.io/docs/products/kafka/reference/advanced-params) to configure topics.
         """
         return pulumi.get(self, "config")
 
@@ -122,7 +122,7 @@ class KafkaTopicArgs:
     @pulumi.getter
     def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['KafkaTopicTagArgs']]]]:
         """
-        Tags for the Kafka topic.
+        Tags for the topic.
         """
         return pulumi.get(self, "tags")
 
@@ -153,12 +153,12 @@ class _KafkaTopicState:
                  topic_name: Optional[pulumi.Input[str]] = None):
         """
         Input properties used for looking up and filtering KafkaTopic resources.
-        :param pulumi.Input['KafkaTopicConfigArgs'] config: Kafka topic configuration.
+        :param pulumi.Input['KafkaTopicConfigArgs'] config: [Advanced parameters](https://aiven.io/docs/products/kafka/reference/advanced-params) to configure topics.
         :param pulumi.Input[int] partitions: The number of partitions to create in the topic.
         :param pulumi.Input[str] project: The name of the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
         :param pulumi.Input[int] replication: The replication factor for the topic.
         :param pulumi.Input[str] service_name: The name of the service that this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
-        :param pulumi.Input[Sequence[pulumi.Input['KafkaTopicTagArgs']]] tags: Tags for the Kafka topic.
+        :param pulumi.Input[Sequence[pulumi.Input['KafkaTopicTagArgs']]] tags: Tags for the topic.
         :param pulumi.Input[str] topic_name: The name of the topic. Changing this property forces recreation of the resource.
         """
         if config is not None:
@@ -182,7 +182,7 @@ class _KafkaTopicState:
     @pulumi.getter
     def config(self) -> Optional[pulumi.Input['KafkaTopicConfigArgs']]:
         """
-        Kafka topic configuration.
+        [Advanced parameters](https://aiven.io/docs/products/kafka/reference/advanced-params) to configure topics.
         """
         return pulumi.get(self, "config")
 
@@ -242,7 +242,7 @@ class _KafkaTopicState:
     @pulumi.getter
     def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['KafkaTopicTagArgs']]]]:
         """
-        Tags for the Kafka topic.
+        Tags for the topic.
         """
         return pulumi.get(self, "tags")
 
@@ -287,7 +287,7 @@ class KafkaTopic(pulumi.CustomResource):
                  topic_name: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        Creates and manages an Aiven for Apache Kafka® topic.
+        Creates and manages an Aiven for Apache Kafka® [topic](https://aiven.io/docs/products/kafka/concepts).
 
         ## Example Usage
 
@@ -316,12 +316,12 @@ class KafkaTopic(pulumi.CustomResource):
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[pulumi.InputType['KafkaTopicConfigArgs']] config: Kafka topic configuration.
+        :param pulumi.Input[pulumi.InputType['KafkaTopicConfigArgs']] config: [Advanced parameters](https://aiven.io/docs/products/kafka/reference/advanced-params) to configure topics.
         :param pulumi.Input[int] partitions: The number of partitions to create in the topic.
         :param pulumi.Input[str] project: The name of the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
         :param pulumi.Input[int] replication: The replication factor for the topic.
         :param pulumi.Input[str] service_name: The name of the service that this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['KafkaTopicTagArgs']]]] tags: Tags for the Kafka topic.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['KafkaTopicTagArgs']]]] tags: Tags for the topic.
         :param pulumi.Input[str] topic_name: The name of the topic. Changing this property forces recreation of the resource.
         """
         ...
@@ -331,7 +331,7 @@ class KafkaTopic(pulumi.CustomResource):
                  args: KafkaTopicArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Creates and manages an Aiven for Apache Kafka® topic.
+        Creates and manages an Aiven for Apache Kafka® [topic](https://aiven.io/docs/products/kafka/concepts).
 
         ## Example Usage
 
@@ -433,12 +433,12 @@ class KafkaTopic(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[pulumi.InputType['KafkaTopicConfigArgs']] config: Kafka topic configuration.
+        :param pulumi.Input[pulumi.InputType['KafkaTopicConfigArgs']] config: [Advanced parameters](https://aiven.io/docs/products/kafka/reference/advanced-params) to configure topics.
         :param pulumi.Input[int] partitions: The number of partitions to create in the topic.
         :param pulumi.Input[str] project: The name of the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
         :param pulumi.Input[int] replication: The replication factor for the topic.
         :param pulumi.Input[str] service_name: The name of the service that this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['KafkaTopicTagArgs']]]] tags: Tags for the Kafka topic.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['KafkaTopicTagArgs']]]] tags: Tags for the topic.
         :param pulumi.Input[str] topic_name: The name of the topic. Changing this property forces recreation of the resource.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -459,7 +459,7 @@ class KafkaTopic(pulumi.CustomResource):
     @pulumi.getter
     def config(self) -> pulumi.Output[Optional['outputs.KafkaTopicConfig']]:
         """
-        Kafka topic configuration.
+        [Advanced parameters](https://aiven.io/docs/products/kafka/reference/advanced-params) to configure topics.
         """
         return pulumi.get(self, "config")
 
@@ -499,7 +499,7 @@ class KafkaTopic(pulumi.CustomResource):
     @pulumi.getter
     def tags(self) -> pulumi.Output[Optional[Sequence['outputs.KafkaTopicTag']]]:
         """
-        Tags for the Kafka topic.
+        Tags for the topic.
         """
         return pulumi.get(self, "tags")
 

pulumi_aiven/kafka_user.py

@@ -22,8 +22,8 @@ class KafkaUserArgs:
         The set of arguments for constructing a KafkaUser resource.
         :param pulumi.Input[str] project: The name of the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
         :param pulumi.Input[str] service_name: The name of the service that this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
-        :param pulumi.Input[str] username: The actual name of the Kafka User. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
-        :param pulumi.Input[str] password: The password of the Kafka User.
+        :param pulumi.Input[str] username: Name of the Kafka service user. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
+        :param pulumi.Input[str] password: The Kafka service user's password.
         """
         pulumi.set(__self__, "project", project)
         pulumi.set(__self__, "service_name", service_name)
@@ -59,7 +59,7 @@ class KafkaUserArgs:
     @pulumi.getter
     def username(self) -> pulumi.Input[str]:
         """
-        The actual name of the Kafka User. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
+        Name of the Kafka service user. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "username")
 
@@ -71,7 +71,7 @@ class KafkaUserArgs:
     @pulumi.getter
     def password(self) -> Optional[pulumi.Input[str]]:
         """
-        The password of the Kafka User.
+        The Kafka service user's password.
         """
         return pulumi.get(self, "password")
 
@@ -92,13 +92,13 @@ class _KafkaUserState:
                  username: Optional[pulumi.Input[str]] = None):
         """
         Input properties used for looking up and filtering KafkaUser resources.
-        :param pulumi.Input[str] access_cert: Access certificate for the user
-        :param pulumi.Input[str] access_key: Access certificate key for the user
-        :param pulumi.Input[str] password: The password of the Kafka User.
+        :param pulumi.Input[str] access_cert: Access certificate for the user.
+        :param pulumi.Input[str] access_key: Access certificate key for the user.
+        :param pulumi.Input[str] password: The Kafka service user's password.
         :param pulumi.Input[str] project: The name of the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
         :param pulumi.Input[str] service_name: The name of the service that this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
-        :param pulumi.Input[str] type: Type of the user account. Tells whether the user is the primary account or a regular account.
-        :param pulumi.Input[str] username: The actual name of the Kafka User. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
+        :param pulumi.Input[str] type: User account type, such as primary or regular account.
+        :param pulumi.Input[str] username: Name of the Kafka service user. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
         """
         if access_cert is not None:
             pulumi.set(__self__, "access_cert", access_cert)
@@ -119,7 +119,7 @@ class _KafkaUserState:
     @pulumi.getter(name="accessCert")
     def access_cert(self) -> Optional[pulumi.Input[str]]:
         """
-        Access certificate for the user
+        Access certificate for the user.
         """
         return pulumi.get(self, "access_cert")
 
@@ -131,7 +131,7 @@ class _KafkaUserState:
     @pulumi.getter(name="accessKey")
     def access_key(self) -> Optional[pulumi.Input[str]]:
         """
-        Access certificate key for the user
+        Access certificate key for the user.
         """
         return pulumi.get(self, "access_key")
 
@@ -143,7 +143,7 @@ class _KafkaUserState:
     @pulumi.getter
     def password(self) -> Optional[pulumi.Input[str]]:
         """
-        The password of the Kafka User.
+        The Kafka service user's password.
         """
         return pulumi.get(self, "password")
 
@@ -179,7 +179,7 @@ class _KafkaUserState:
     @pulumi.getter
     def type(self) -> Optional[pulumi.Input[str]]:
         """
-        Type of the user account. Tells whether the user is the primary account or a regular account.
+        User account type, such as primary or regular account.
         """
         return pulumi.get(self, "type")
 
@@ -191,7 +191,7 @@ class _KafkaUserState:
     @pulumi.getter
     def username(self) -> Optional[pulumi.Input[str]]:
         """
-        The actual name of the Kafka User. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
+        Name of the Kafka service user. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "username")
 
@@ -211,7 +211,7 @@ class KafkaUser(pulumi.CustomResource):
                  username: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        The Kafka User resource allows the creation and management of Aiven Kafka Users.
+        Creates and manages an Aiven for Apache Kafka® service user.
 
         ## Example Usage
 
@@ -219,25 +219,25 @@ class KafkaUser(pulumi.CustomResource):
         import pulumi
         import pulumi_aiven as aiven
 
-        foo = aiven.KafkaUser("foo",
-            service_name=bar["serviceName"],
-            project="my-project",
-            username="user-1",
-            password="Test$1234")
+        example_service_user = aiven.KafkaUser("example_service_user",
+            service_name=example_kafka["serviceName"],
+            project=example_project["project"],
+            username="example-kafka-user",
+            password=service_user_pw)
         ```
 
         ## Import
 
         ```sh
-        $ pulumi import aiven:index/kafkaUser:KafkaUser foo PROJECT/SERVICE_NAME/USERNAME
+        $ pulumi import aiven:index/kafkaUser:KafkaUser example_user PROJECT/SERVICE_NAME/USERNAME
         ```
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] password: The password of the Kafka User.
+        :param pulumi.Input[str] password: The Kafka service user's password.
         :param pulumi.Input[str] project: The name of the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
         :param pulumi.Input[str] service_name: The name of the service that this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
-        :param pulumi.Input[str] username: The actual name of the Kafka User. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
+        :param pulumi.Input[str] username: Name of the Kafka service user. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
         """
         ...
     @overload
@@ -246,7 +246,7 @@ class KafkaUser(pulumi.CustomResource):
                  args: KafkaUserArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        The Kafka User resource allows the creation and management of Aiven Kafka Users.
+        Creates and manages an Aiven for Apache Kafka® service user.
 
         ## Example Usage
 
@@ -254,17 +254,17 @@ class KafkaUser(pulumi.CustomResource):
         import pulumi
         import pulumi_aiven as aiven
 
-        foo = aiven.KafkaUser("foo",
-            service_name=bar["serviceName"],
-            project="my-project",
-            username="user-1",
-            password="Test$1234")
+        example_service_user = aiven.KafkaUser("example_service_user",
+            service_name=example_kafka["serviceName"],
+            project=example_project["project"],
+            username="example-kafka-user",
+            password=service_user_pw)
         ```
 
         ## Import
 
         ```sh
-        $ pulumi import aiven:index/kafkaUser:KafkaUser foo PROJECT/SERVICE_NAME/USERNAME
+        $ pulumi import aiven:index/kafkaUser:KafkaUser example_user PROJECT/SERVICE_NAME/USERNAME
         ```
 
         :param str resource_name: The name of the resource.
@@ -334,13 +334,13 @@ class KafkaUser(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] access_cert: Access certificate for the user
-        :param pulumi.Input[str] access_key: Access certificate key for the user
-        :param pulumi.Input[str] password: The password of the Kafka User.
+        :param pulumi.Input[str] access_cert: Access certificate for the user.
+        :param pulumi.Input[str] access_key: Access certificate key for the user.
+        :param pulumi.Input[str] password: The Kafka service user's password.
         :param pulumi.Input[str] project: The name of the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
         :param pulumi.Input[str] service_name: The name of the service that this resource belongs to. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
-        :param pulumi.Input[str] type: Type of the user account. Tells whether the user is the primary account or a regular account.
-        :param pulumi.Input[str] username: The actual name of the Kafka User. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
+        :param pulumi.Input[str] type: User account type, such as primary or regular account.
+        :param pulumi.Input[str] username: Name of the Kafka service user. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -359,7 +359,7 @@ class KafkaUser(pulumi.CustomResource):
     @pulumi.getter(name="accessCert")
     def access_cert(self) -> pulumi.Output[str]:
         """
-        Access certificate for the user
+        Access certificate for the user.
         """
         return pulumi.get(self, "access_cert")
 
@@ -367,7 +367,7 @@ class KafkaUser(pulumi.CustomResource):
     @pulumi.getter(name="accessKey")
     def access_key(self) -> pulumi.Output[str]:
         """
-        Access certificate key for the user
+        Access certificate key for the user.
         """
         return pulumi.get(self, "access_key")
 
@@ -375,7 +375,7 @@ class KafkaUser(pulumi.CustomResource):
     @pulumi.getter
     def password(self) -> pulumi.Output[str]:
         """
-        The password of the Kafka User.
+        The Kafka service user's password.
         """
         return pulumi.get(self, "password")
 
@@ -399,7 +399,7 @@ class KafkaUser(pulumi.CustomResource):
     @pulumi.getter
     def type(self) -> pulumi.Output[str]:
         """
-        Type of the user account. Tells whether the user is the primary account or a regular account.
+        User account type, such as primary or regular account.
         """
         return pulumi.get(self, "type")
 
@@ -407,7 +407,7 @@ class KafkaUser(pulumi.CustomResource):
     @pulumi.getter
     def username(self) -> pulumi.Output[str]:
         """
-        The actual name of the Kafka User. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
+        Name of the Kafka service user. To set up proper dependencies please refer to this variable as a reference. Changing this property forces recreation of the resource.
         """
         return pulumi.get(self, "username")
 

pulumi_aiven/organization_application_user.py

@@ -164,7 +164,12 @@ class OrganizationApplicationUser(pulumi.CustomResource):
                  organization_id: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        Creates and manages an organization application user. [Application users](https://aiven.io/docs/platform/howto/manage-application-users) can be used for programmatic access to the platform.
+        Creates and manages an organization application user. [Application users](https://aiven.io/docs/platform/concepts/application-users) can be used for
+        programmatic access to the platform.
+
+        You give application users access to projects by adding them as members of a group using `OrganizationUserGroupMember`
+        and assigning the group to a project with `OrganizationGroupProject`. You can give an application user access to all
+        resources in your organization by setting `is_super_admin = true` .
 
         ## Example Usage
 
@@ -196,7 +201,12 @@ class OrganizationApplicationUser(pulumi.CustomResource):
                  args: OrganizationApplicationUserArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Creates and manages an organization application user. [Application users](https://aiven.io/docs/platform/howto/manage-application-users) can be used for programmatic access to the platform.
+        Creates and manages an organization application user. [Application users](https://aiven.io/docs/platform/concepts/application-users) can be used for
+        programmatic access to the platform.
+
+        You give application users access to projects by adding them as members of a group using `OrganizationUserGroupMember`
+        and assigning the group to a project with `OrganizationGroupProject`. You can give an application user access to all
+        resources in your organization by setting `is_super_admin = true` .
 
         ## Example Usage
 

pulumi_aiven/organization_application_user_token.py

@@ -27,7 +27,7 @@ class OrganizationApplicationUserTokenArgs:
         :param pulumi.Input[str] description: Description of the token.
         :param pulumi.Input[bool] extend_when_used: Extends the token session duration when the token is used. Only applicable if a value is set for `max_age_seconds`.
         :param pulumi.Input[int] max_age_seconds: The number of hours after which a token expires. Default session duration is 10 hours.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] scopes: Restricts the scopes for this token.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] scopes: Limits access to specific resources by granting read or write privileges to them. For example: `billing:read`. Available scopes are: `authentication`, `billing`, `payments` for [payment methods](https://aiven.io/docs/platform/howto/list-billing), `privatelink`, `projects`, `services`, `static_ips`, and `user`.
         """
         pulumi.set(__self__, "organization_id", organization_id)
         pulumi.set(__self__, "user_id", user_id)
@@ -104,7 +104,7 @@ class OrganizationApplicationUserTokenArgs:
     @pulumi.getter
     def scopes(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        Restricts the scopes for this token.
+        Limits access to specific resources by granting read or write privileges to them. For example: `billing:read`. Available scopes are: `authentication`, `billing`, `payments` for [payment methods](https://aiven.io/docs/platform/howto/list-billing), `privatelink`, `projects`, `services`, `static_ips`, and `user`.
         """
         return pulumi.get(self, "scopes")
 
@@ -147,7 +147,7 @@ class _OrganizationApplicationUserTokenState:
         :param pulumi.Input[str] last_user_agent_human_readable: User agent of the last request made with this token in human-readable format.
         :param pulumi.Input[int] max_age_seconds: The number of hours after which a token expires. Default session duration is 10 hours.
         :param pulumi.Input[str] organization_id: The ID of the organization the application user belongs to.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] scopes: Restricts the scopes for this token.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] scopes: Limits access to specific resources by granting read or write privileges to them. For example: `billing:read`. Available scopes are: `authentication`, `billing`, `payments` for [payment methods](https://aiven.io/docs/platform/howto/list-billing), `privatelink`, `projects`, `services`, `static_ips`, and `user`.
         :param pulumi.Input[str] token_prefix: Prefix of the token.
         :param pulumi.Input[str] user_id: The ID of the application user the token is created for.
         """
@@ -344,7 +344,7 @@ class _OrganizationApplicationUserTokenState:
     @pulumi.getter
     def scopes(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        Restricts the scopes for this token.
+        Limits access to specific resources by granting read or write privileges to them. For example: `billing:read`. Available scopes are: `authentication`, `billing`, `payments` for [payment methods](https://aiven.io/docs/platform/howto/list-billing), `privatelink`, `projects`, `services`, `static_ips`, and `user`.
         """
         return pulumi.get(self, "scopes")
 
@@ -419,7 +419,7 @@ class OrganizationApplicationUserToken(pulumi.CustomResource):
         :param pulumi.Input[bool] extend_when_used: Extends the token session duration when the token is used. Only applicable if a value is set for `max_age_seconds`.
         :param pulumi.Input[int] max_age_seconds: The number of hours after which a token expires. Default session duration is 10 hours.
         :param pulumi.Input[str] organization_id: The ID of the organization the application user belongs to.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] scopes: Restricts the scopes for this token.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] scopes: Limits access to specific resources by granting read or write privileges to them. For example: `billing:read`. Available scopes are: `authentication`, `billing`, `payments` for [payment methods](https://aiven.io/docs/platform/howto/list-billing), `privatelink`, `projects`, `services`, `static_ips`, and `user`.
         :param pulumi.Input[str] user_id: The ID of the application user the token is created for.
         """
         ...
@@ -550,7 +550,7 @@ class OrganizationApplicationUserToken(pulumi.CustomResource):
         :param pulumi.Input[str] last_user_agent_human_readable: User agent of the last request made with this token in human-readable format.
         :param pulumi.Input[int] max_age_seconds: The number of hours after which a token expires. Default session duration is 10 hours.
         :param pulumi.Input[str] organization_id: The ID of the organization the application user belongs to.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] scopes: Restricts the scopes for this token.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] scopes: Limits access to specific resources by granting read or write privileges to them. For example: `billing:read`. Available scopes are: `authentication`, `billing`, `payments` for [payment methods](https://aiven.io/docs/platform/howto/list-billing), `privatelink`, `projects`, `services`, `static_ips`, and `user`.
         :param pulumi.Input[str] token_prefix: Prefix of the token.
         :param pulumi.Input[str] user_id: The ID of the application user the token is created for.
         """
@@ -684,7 +684,7 @@ class OrganizationApplicationUserToken(pulumi.CustomResource):
     @pulumi.getter
     def scopes(self) -> pulumi.Output[Optional[Sequence[str]]]:
         """
-        Restricts the scopes for this token.
+        Limits access to specific resources by granting read or write privileges to them. For example: `billing:read`. Available scopes are: `authentication`, `billing`, `payments` for [payment methods](https://aiven.io/docs/platform/howto/list-billing), `privatelink`, `projects`, `services`, `static_ips`, and `user`.
         """
         return pulumi.get(self, "scopes")
 

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: Role assigned to all users in the group for the project.
+        :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`.
         """
         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]:
         """
-        Role assigned to all users in the group for the project.
+        [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`.
         """
         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: Role assigned to all users in the group for the project.
+        :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`.
         """
         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]]:
         """
-        Role assigned to all users in the group for the project.
+        [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`.
         """
         return pulumi.get(self, "role")
 
@@ -157,7 +157,7 @@ class OrganizationGroupProject(pulumi.CustomResource):
                  timeouts: Optional[pulumi.Input[pulumi.InputType['OrganizationGroupProjectTimeoutsArgs']]] = None,
                  __props__=None):
         """
-        Adds and manages a [group](https://aiven.io/docs/platform/howto/list-groups) of users as [members of a project](https://aiven.io/docs/platform/reference/project-member-privileges).
+        Adds and manages a [group](https://aiven.io/docs/platform/howto/list-groups) of users as members of a project.
 
         ## Example Usage
 
@@ -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: Role assigned to all users in the group for the project.
+        :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`.
         """
         ...
     @overload
@@ -201,7 +201,7 @@ class OrganizationGroupProject(pulumi.CustomResource):
                  args: OrganizationGroupProjectArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Adds and manages a [group](https://aiven.io/docs/platform/howto/list-groups) of users as [members of a project](https://aiven.io/docs/platform/reference/project-member-privileges).
+        Adds and manages a [group](https://aiven.io/docs/platform/howto/list-groups) of users as members of a project.
 
         ## Example Usage
 
@@ -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: Role assigned to all users in the group for the project.
+        :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`.
         """
         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]:
         """
-        Role assigned to all users in the group for the project.
+        [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`.
         """
         return pulumi.get(self, "role")
 

pulumi_aiven/organization_user_group_member.py

@@ -24,7 +24,7 @@ class OrganizationUserGroupMemberArgs:
         The set of arguments for constructing a OrganizationUserGroupMember resource.
         :param pulumi.Input[str] group_id: The ID of the user group.
         :param pulumi.Input[str] organization_id: The ID of the organization.
-        :param pulumi.Input[str] user_id: The ID of the organization user.
+        :param pulumi.Input[str] user_id: The ID of the organization user or application user.
         """
         pulumi.set(__self__, "group_id", group_id)
         pulumi.set(__self__, "organization_id", organization_id)
@@ -60,7 +60,7 @@ class OrganizationUserGroupMemberArgs:
     @pulumi.getter(name="userId")
     def user_id(self) -> pulumi.Input[str]:
         """
-        The ID of the organization user.
+        The ID of the organization user or application user.
         """
         return pulumi.get(self, "user_id")
 
@@ -91,7 +91,7 @@ class _OrganizationUserGroupMemberState:
         :param pulumi.Input[str] group_id: The ID of the user group.
         :param pulumi.Input[str] last_activity_time: Last activity time of the user group member.
         :param pulumi.Input[str] organization_id: The ID of the organization.
-        :param pulumi.Input[str] user_id: The ID of the organization user.
+        :param pulumi.Input[str] user_id: The ID of the organization user or application user.
         """
         if group_id is not None:
             pulumi.set(__self__, "group_id", group_id)
@@ -153,7 +153,7 @@ class _OrganizationUserGroupMemberState:
     @pulumi.getter(name="userId")
     def user_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The ID of the organization user.
+        The ID of the organization user or application user.
         """
         return pulumi.get(self, "user_id")
 
@@ -173,7 +173,9 @@ class OrganizationUserGroupMember(pulumi.CustomResource):
                  user_id: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        Adds and manages users in a [user group](https://aiven.io/docs/platform/howto/list-groups).
+        Adds and manages users in a [user group](https://aiven.io/docs/platform/howto/list-groups). You can add organization users and application users to groups.
+
+        Groups are given access to projects using the `OrganizationGroupProject` resource.
 
         ## Example Usage
 
@@ -201,7 +203,7 @@ class OrganizationUserGroupMember(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] organization_id: The ID of the organization.
-        :param pulumi.Input[str] user_id: The ID of the organization user.
+        :param pulumi.Input[str] user_id: The ID of the organization user or application user.
         """
         ...
     @overload
@@ -210,7 +212,9 @@ class OrganizationUserGroupMember(pulumi.CustomResource):
                  args: OrganizationUserGroupMemberArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Adds and manages users in a [user group](https://aiven.io/docs/platform/howto/list-groups).
+        Adds and manages users in a [user group](https://aiven.io/docs/platform/howto/list-groups). You can add organization users and application users to groups.
+
+        Groups are given access to projects using the `OrganizationGroupProject` resource.
 
         ## Example Usage
 
@@ -298,7 +302,7 @@ class OrganizationUserGroupMember(pulumi.CustomResource):
         :param pulumi.Input[str] group_id: The ID of the user group.
         :param pulumi.Input[str] last_activity_time: Last activity time of the user group member.
         :param pulumi.Input[str] organization_id: The ID of the organization.
-        :param pulumi.Input[str] user_id: The ID of the organization user.
+        :param pulumi.Input[str] user_id: The ID of the organization user or application user.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -344,7 +348,7 @@ class OrganizationUserGroupMember(pulumi.CustomResource):
     @pulumi.getter(name="userId")
     def user_id(self) -> pulumi.Output[str]:
         """
-        The ID of the organization user.
+        The ID of the organization user or application user.
         """
         return pulumi.get(self, "user_id")