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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of pulumi-aiven might be problematic. Click here for more details.

Files changed (169) hide show
  1. pulumi_aiven/__init__.py +136 -0
  2. pulumi_aiven/_inputs.py +32749 -13711
  3. pulumi_aiven/_utilities.py +41 -5
  4. pulumi_aiven/account.py +32 -45
  5. pulumi_aiven/account_authentication.py +24 -9
  6. pulumi_aiven/account_team.py +35 -14
  7. pulumi_aiven/account_team_member.py +48 -39
  8. pulumi_aiven/account_team_project.py +40 -27
  9. pulumi_aiven/alloydbomni.py +1335 -0
  10. pulumi_aiven/alloydbomni_database.py +347 -0
  11. pulumi_aiven/alloydbomni_user.py +433 -0
  12. pulumi_aiven/aws_privatelink.py +44 -43
  13. pulumi_aiven/aws_vpc_peering_connection.py +72 -61
  14. pulumi_aiven/azure_privatelink.py +54 -53
  15. pulumi_aiven/azure_privatelink_connection_approval.py +136 -33
  16. pulumi_aiven/azure_vpc_peering_connection.py +86 -77
  17. pulumi_aiven/billing_group.py +33 -34
  18. pulumi_aiven/cassandra.py +145 -126
  19. pulumi_aiven/cassandra_user.py +59 -58
  20. pulumi_aiven/clickhouse.py +133 -114
  21. pulumi_aiven/clickhouse_database.py +58 -62
  22. pulumi_aiven/clickhouse_grant.py +135 -134
  23. pulumi_aiven/clickhouse_role.py +36 -49
  24. pulumi_aiven/clickhouse_user.py +50 -49
  25. pulumi_aiven/config/__init__.pyi +5 -0
  26. pulumi_aiven/config/vars.py +5 -0
  27. pulumi_aiven/connection_pool.py +67 -66
  28. pulumi_aiven/dragonfly.py +1256 -0
  29. pulumi_aiven/flink.py +104 -104
  30. pulumi_aiven/flink_application.py +58 -55
  31. pulumi_aiven/flink_application_deployment.py +178 -73
  32. pulumi_aiven/flink_application_version.py +179 -96
  33. pulumi_aiven/gcp_privatelink.py +69 -42
  34. pulumi_aiven/gcp_privatelink_connection_approval.py +78 -49
  35. pulumi_aiven/gcp_vpc_peering_connection.py +49 -48
  36. pulumi_aiven/get_account.py +20 -9
  37. pulumi_aiven/get_account_authentication.py +31 -5
  38. pulumi_aiven/get_account_team.py +18 -5
  39. pulumi_aiven/get_account_team_member.py +29 -14
  40. pulumi_aiven/get_account_team_project.py +19 -6
  41. pulumi_aiven/get_alloydbomni.py +499 -0
  42. pulumi_aiven/get_alloydbomni_database.py +168 -0
  43. pulumi_aiven/get_alloydbomni_user.py +210 -0
  44. pulumi_aiven/get_aws_privatelink.py +33 -24
  45. pulumi_aiven/get_aws_vpc_peering_connection.py +56 -33
  46. pulumi_aiven/get_azure_privatelink.py +37 -26
  47. pulumi_aiven/get_azure_vpc_peering_connection.py +77 -28
  48. pulumi_aiven/get_billing_group.py +31 -8
  49. pulumi_aiven/get_cassanda.py +55 -23
  50. pulumi_aiven/get_cassandra.py +55 -23
  51. pulumi_aiven/get_cassandra_user.py +42 -30
  52. pulumi_aiven/get_clickhouse.py +55 -23
  53. pulumi_aiven/get_clickhouse_database.py +35 -26
  54. pulumi_aiven/get_clickhouse_user.py +40 -29
  55. pulumi_aiven/get_connection_pool.py +43 -30
  56. pulumi_aiven/get_dragonfly.py +499 -0
  57. pulumi_aiven/get_external_identity.py +160 -0
  58. pulumi_aiven/get_flink.py +55 -23
  59. pulumi_aiven/get_flink_application.py +44 -31
  60. pulumi_aiven/get_flink_application_version.py +55 -37
  61. pulumi_aiven/get_gcp_privatelink.py +63 -7
  62. pulumi_aiven/get_gcp_vpc_peering_connection.py +39 -28
  63. pulumi_aiven/get_grafana.py +55 -23
  64. pulumi_aiven/get_influx_db.py +41 -5
  65. pulumi_aiven/get_influxdb_database.py +18 -5
  66. pulumi_aiven/get_influxdb_user.py +21 -5
  67. pulumi_aiven/get_kafka.py +59 -25
  68. pulumi_aiven/get_kafka_acl.py +50 -37
  69. pulumi_aiven/get_kafka_connect.py +54 -36
  70. pulumi_aiven/get_kafka_connector.py +44 -28
  71. pulumi_aiven/get_kafka_mirror_maker.py +50 -32
  72. pulumi_aiven/get_kafka_schema.py +35 -23
  73. pulumi_aiven/get_kafka_schema_configuration.py +32 -21
  74. pulumi_aiven/get_kafka_schema_registry_acl.py +37 -20
  75. pulumi_aiven/get_kafka_topic.py +70 -29
  76. pulumi_aiven/get_kafka_user.py +42 -30
  77. pulumi_aiven/get_m3_aggregator.py +51 -19
  78. pulumi_aiven/get_m3_db.py +55 -23
  79. pulumi_aiven/get_m3db_user.py +38 -28
  80. pulumi_aiven/get_mirror_maker_replication_flow.py +86 -25
  81. pulumi_aiven/get_my_sql.py +50 -18
  82. pulumi_aiven/get_mysql_database.py +31 -22
  83. pulumi_aiven/get_mysql_user.py +36 -23
  84. pulumi_aiven/get_open_search.py +50 -18
  85. pulumi_aiven/get_open_search_acl_config.py +27 -19
  86. pulumi_aiven/get_open_search_acl_rule.py +37 -25
  87. pulumi_aiven/get_opensearch_security_plugin_config.py +29 -19
  88. pulumi_aiven/get_opensearch_user.py +32 -22
  89. pulumi_aiven/get_organization.py +25 -17
  90. pulumi_aiven/get_organization_application_user.py +176 -0
  91. pulumi_aiven/get_organization_user.py +18 -5
  92. pulumi_aiven/get_organization_user_group.py +48 -14
  93. pulumi_aiven/get_organization_user_list.py +121 -0
  94. pulumi_aiven/get_organizational_unit.py +26 -14
  95. pulumi_aiven/get_pg.py +55 -23
  96. pulumi_aiven/get_pg_database.py +39 -28
  97. pulumi_aiven/get_pg_user.py +44 -31
  98. pulumi_aiven/get_project.py +43 -26
  99. pulumi_aiven/get_project_user.py +27 -19
  100. pulumi_aiven/get_project_vpc.py +31 -23
  101. pulumi_aiven/get_redis.py +50 -18
  102. pulumi_aiven/get_redis_user.py +40 -26
  103. pulumi_aiven/get_service_component.py +40 -22
  104. pulumi_aiven/get_service_integration.py +163 -53
  105. pulumi_aiven/get_service_integration_endpoint.py +128 -37
  106. pulumi_aiven/get_thanos.py +499 -0
  107. pulumi_aiven/get_transit_gateway_vpc_attachment.py +35 -22
  108. pulumi_aiven/get_valkey.py +499 -0
  109. pulumi_aiven/get_valkey_user.py +218 -0
  110. pulumi_aiven/grafana.py +188 -322
  111. pulumi_aiven/influx_db.py +127 -90
  112. pulumi_aiven/influxdb_database.py +40 -55
  113. pulumi_aiven/influxdb_user.py +47 -42
  114. pulumi_aiven/kafka.py +157 -144
  115. pulumi_aiven/kafka_acl.py +64 -57
  116. pulumi_aiven/kafka_connect.py +201 -332
  117. pulumi_aiven/kafka_connector.py +67 -60
  118. pulumi_aiven/kafka_mirror_maker.py +137 -320
  119. pulumi_aiven/kafka_native_acl.py +588 -0
  120. pulumi_aiven/kafka_quota.py +604 -0
  121. pulumi_aiven/kafka_schema.py +63 -58
  122. pulumi_aiven/kafka_schema_configuration.py +25 -24
  123. pulumi_aiven/kafka_schema_registry_acl.py +80 -35
  124. pulumi_aiven/kafka_topic.py +184 -65
  125. pulumi_aiven/kafka_user.py +59 -58
  126. pulumi_aiven/m3_aggregator.py +174 -310
  127. pulumi_aiven/m3_db.py +190 -326
  128. pulumi_aiven/m3db_user.py +51 -50
  129. pulumi_aiven/mirror_maker_replication_flow.py +215 -55
  130. pulumi_aiven/my_sql.py +188 -324
  131. pulumi_aiven/mysql_database.py +32 -51
  132. pulumi_aiven/mysql_user.py +37 -36
  133. pulumi_aiven/open_search.py +126 -107
  134. pulumi_aiven/open_search_acl_config.py +33 -36
  135. pulumi_aiven/open_search_acl_rule.py +55 -54
  136. pulumi_aiven/opensearch_security_plugin_config.py +69 -16
  137. pulumi_aiven/opensearch_user.py +30 -29
  138. pulumi_aiven/organization.py +18 -17
  139. pulumi_aiven/organization_application_user.py +345 -0
  140. pulumi_aiven/organization_application_user_token.py +711 -0
  141. pulumi_aiven/organization_group_project.py +349 -0
  142. pulumi_aiven/organization_permission.py +421 -0
  143. pulumi_aiven/organization_user.py +25 -46
  144. pulumi_aiven/organization_user_group.py +64 -23
  145. pulumi_aiven/organization_user_group_member.py +359 -0
  146. pulumi_aiven/organizational_unit.py +41 -36
  147. pulumi_aiven/outputs.py +38976 -21894
  148. pulumi_aiven/pg.py +92 -88
  149. pulumi_aiven/pg_database.py +52 -71
  150. pulumi_aiven/pg_user.py +80 -65
  151. pulumi_aiven/project.py +111 -102
  152. pulumi_aiven/project_user.py +44 -35
  153. pulumi_aiven/project_vpc.py +58 -29
  154. pulumi_aiven/provider.py +5 -0
  155. pulumi_aiven/pulumi-plugin.json +2 -1
  156. pulumi_aiven/redis.py +161 -297
  157. pulumi_aiven/redis_user.py +58 -57
  158. pulumi_aiven/service_integration.py +511 -165
  159. pulumi_aiven/service_integration_endpoint.py +466 -158
  160. pulumi_aiven/static_ip.py +21 -16
  161. pulumi_aiven/thanos.py +1262 -0
  162. pulumi_aiven/transit_gateway_vpc_attachment.py +44 -58
  163. pulumi_aiven/valkey.py +1256 -0
  164. pulumi_aiven/valkey_user.py +606 -0
  165. {pulumi_aiven-6.13.0a1710156545.dist-info → pulumi_aiven-6.31.0.dist-info}/METADATA +7 -6
  166. pulumi_aiven-6.31.0.dist-info/RECORD +170 -0
  167. {pulumi_aiven-6.13.0a1710156545.dist-info → pulumi_aiven-6.31.0.dist-info}/WHEEL +1 -1
  168. pulumi_aiven-6.13.0a1710156545.dist-info/RECORD +0 -146
  169. {pulumi_aiven-6.13.0a1710156545.dist-info → pulumi_aiven-6.31.0.dist-info}/top_level.txt +0 -0
pulumi_aiven/kafka_acl.py CHANGED
@@ -4,9 +4,14 @@
4
4
 
5
5
  import copy
6
6
  import warnings
7
+ import sys
7
8
  import pulumi
8
9
  import pulumi.runtime
9
10
  from typing import Any, Mapping, Optional, Sequence, Union, overload
11
+ if sys.version_info >= (3, 11):
12
+ from typing import NotRequired, TypedDict, TypeAlias
13
+ else:
14
+ from typing_extensions import NotRequired, TypedDict, TypeAlias
10
15
  from . import _utilities
11
16
 
12
17
  __all__ = ['KafkaAclArgs', 'KafkaAcl']
@@ -21,11 +26,11 @@ class KafkaAclArgs:
21
26
  username: pulumi.Input[str]):
22
27
  """
23
28
  The set of arguments for constructing a KafkaAcl resource.
24
- :param pulumi.Input[str] permission: Kafka permission to grant. The possible values are `admin`, `read`, `readwrite` and `write`. This property cannot be changed, doing so forces recreation of the resource.
25
- :param pulumi.Input[str] project: Identifies the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. This property cannot be changed, doing so forces recreation of the resource.
26
- :param pulumi.Input[str] service_name: Specifies the name of the service that this resource belongs to. To set up proper dependencies please refer to this variable as a reference. This property cannot be changed, doing so forces recreation of the resource.
27
- :param pulumi.Input[str] topic: Topic name pattern for the ACL entry. This property cannot be changed, doing so forces recreation of the resource.
28
- :param pulumi.Input[str] username: Username pattern for the ACL entry. This property cannot be changed, doing so forces recreation of the resource.
29
+ :param pulumi.Input[str] permission: Permissions to grant. The possible values are `admin`, `read`, `readwrite` and `write`. Changing this property forces recreation of the resource.
30
+ :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.
31
+ :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.
32
+ :param pulumi.Input[str] topic: Topics that the permissions apply to. Changing this property forces recreation of the resource.
33
+ :param pulumi.Input[str] username: Usernames to grant permissions to. Changing this property forces recreation of the resource.
29
34
  """
30
35
  pulumi.set(__self__, "permission", permission)
31
36
  pulumi.set(__self__, "project", project)
@@ -37,7 +42,7 @@ class KafkaAclArgs:
37
42
  @pulumi.getter
38
43
  def permission(self) -> pulumi.Input[str]:
39
44
  """
40
- Kafka permission to grant. The possible values are `admin`, `read`, `readwrite` and `write`. This property cannot be changed, doing so forces recreation of the resource.
45
+ Permissions to grant. The possible values are `admin`, `read`, `readwrite` and `write`. Changing this property forces recreation of the resource.
41
46
  """
42
47
  return pulumi.get(self, "permission")
43
48
 
@@ -49,7 +54,7 @@ class KafkaAclArgs:
49
54
  @pulumi.getter
50
55
  def project(self) -> pulumi.Input[str]:
51
56
  """
52
- Identifies the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. This property cannot be changed, doing so forces recreation of the resource.
57
+ 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.
53
58
  """
54
59
  return pulumi.get(self, "project")
55
60
 
@@ -61,7 +66,7 @@ class KafkaAclArgs:
61
66
  @pulumi.getter(name="serviceName")
62
67
  def service_name(self) -> pulumi.Input[str]:
63
68
  """
64
- Specifies the name of the service that this resource belongs to. To set up proper dependencies please refer to this variable as a reference. This property cannot be changed, doing so forces recreation of the resource.
69
+ 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.
65
70
  """
66
71
  return pulumi.get(self, "service_name")
67
72
 
@@ -73,7 +78,7 @@ class KafkaAclArgs:
73
78
  @pulumi.getter
74
79
  def topic(self) -> pulumi.Input[str]:
75
80
  """
76
- Topic name pattern for the ACL entry. This property cannot be changed, doing so forces recreation of the resource.
81
+ Topics that the permissions apply to. Changing this property forces recreation of the resource.
77
82
  """
78
83
  return pulumi.get(self, "topic")
79
84
 
@@ -85,7 +90,7 @@ class KafkaAclArgs:
85
90
  @pulumi.getter
86
91
  def username(self) -> pulumi.Input[str]:
87
92
  """
88
- Username pattern for the ACL entry. This property cannot be changed, doing so forces recreation of the resource.
93
+ Usernames to grant permissions to. Changing this property forces recreation of the resource.
89
94
  """
90
95
  return pulumi.get(self, "username")
91
96
 
@@ -105,12 +110,12 @@ class _KafkaAclState:
105
110
  username: Optional[pulumi.Input[str]] = None):
106
111
  """
107
112
  Input properties used for looking up and filtering KafkaAcl resources.
108
- :param pulumi.Input[str] acl_id: Kafka ACL ID
109
- :param pulumi.Input[str] permission: Kafka permission to grant. The possible values are `admin`, `read`, `readwrite` and `write`. This property cannot be changed, doing so forces recreation of the resource.
110
- :param pulumi.Input[str] project: Identifies the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. This property cannot be changed, doing so forces recreation of the resource.
111
- :param pulumi.Input[str] service_name: Specifies the name of the service that this resource belongs to. To set up proper dependencies please refer to this variable as a reference. This property cannot be changed, doing so forces recreation of the resource.
112
- :param pulumi.Input[str] topic: Topic name pattern for the ACL entry. This property cannot be changed, doing so forces recreation of the resource.
113
- :param pulumi.Input[str] username: Username pattern for the ACL entry. This property cannot be changed, doing so forces recreation of the resource.
113
+ :param pulumi.Input[str] acl_id: Kafka ACL ID.
114
+ :param pulumi.Input[str] permission: Permissions to grant. The possible values are `admin`, `read`, `readwrite` and `write`. Changing this property forces recreation of the resource.
115
+ :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.
116
+ :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.
117
+ :param pulumi.Input[str] topic: Topics that the permissions apply to. Changing this property forces recreation of the resource.
118
+ :param pulumi.Input[str] username: Usernames to grant permissions to. Changing this property forces recreation of the resource.
114
119
  """
115
120
  if acl_id is not None:
116
121
  pulumi.set(__self__, "acl_id", acl_id)
@@ -129,7 +134,7 @@ class _KafkaAclState:
129
134
  @pulumi.getter(name="aclId")
130
135
  def acl_id(self) -> Optional[pulumi.Input[str]]:
131
136
  """
132
- Kafka ACL ID
137
+ Kafka ACL ID.
133
138
  """
134
139
  return pulumi.get(self, "acl_id")
135
140
 
@@ -141,7 +146,7 @@ class _KafkaAclState:
141
146
  @pulumi.getter
142
147
  def permission(self) -> Optional[pulumi.Input[str]]:
143
148
  """
144
- Kafka permission to grant. The possible values are `admin`, `read`, `readwrite` and `write`. This property cannot be changed, doing so forces recreation of the resource.
149
+ Permissions to grant. The possible values are `admin`, `read`, `readwrite` and `write`. Changing this property forces recreation of the resource.
145
150
  """
146
151
  return pulumi.get(self, "permission")
147
152
 
@@ -153,7 +158,7 @@ class _KafkaAclState:
153
158
  @pulumi.getter
154
159
  def project(self) -> Optional[pulumi.Input[str]]:
155
160
  """
156
- Identifies the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. This property cannot be changed, doing so forces recreation of the resource.
161
+ 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.
157
162
  """
158
163
  return pulumi.get(self, "project")
159
164
 
@@ -165,7 +170,7 @@ class _KafkaAclState:
165
170
  @pulumi.getter(name="serviceName")
166
171
  def service_name(self) -> Optional[pulumi.Input[str]]:
167
172
  """
168
- Specifies the name of the service that this resource belongs to. To set up proper dependencies please refer to this variable as a reference. This property cannot be changed, doing so forces recreation of the resource.
173
+ 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.
169
174
  """
170
175
  return pulumi.get(self, "service_name")
171
176
 
@@ -177,7 +182,7 @@ class _KafkaAclState:
177
182
  @pulumi.getter
178
183
  def topic(self) -> Optional[pulumi.Input[str]]:
179
184
  """
180
- Topic name pattern for the ACL entry. This property cannot be changed, doing so forces recreation of the resource.
185
+ Topics that the permissions apply to. Changing this property forces recreation of the resource.
181
186
  """
182
187
  return pulumi.get(self, "topic")
183
188
 
@@ -189,7 +194,7 @@ class _KafkaAclState:
189
194
  @pulumi.getter
190
195
  def username(self) -> Optional[pulumi.Input[str]]:
191
196
  """
192
- Username pattern for the ACL entry. This property cannot be changed, doing so forces recreation of the resource.
197
+ Usernames to grant permissions to. Changing this property forces recreation of the resource.
193
198
  """
194
199
  return pulumi.get(self, "username")
195
200
 
@@ -210,37 +215,38 @@ class KafkaAcl(pulumi.CustomResource):
210
215
  username: Optional[pulumi.Input[str]] = None,
211
216
  __props__=None):
212
217
  """
213
- The Resource Kafka ACL resource allows the creation and management of ACLs for an Aiven Kafka service.
218
+ Creates and manages Aiven [access control lists](https://aiven.io/docs/products/kafka/concepts/acl) (ACLs) for an Aiven for Apache Kafka® service. ACLs control access to Kafka topics, consumer groups,
219
+ clusters, and Schema Registry.
220
+
221
+ Aiven ACLs provide simplified topic-level control with basic permissions and wildcard support. For more advanced access control, you can use Kafka-native ACLs.
214
222
 
215
223
  ## Example Usage
216
224
 
217
- <!--Start PulumiCodeChooser -->
218
225
  ```python
219
226
  import pulumi
220
227
  import pulumi_aiven as aiven
221
228
 
222
- mytestacl = aiven.KafkaAcl("mytestacl",
223
- project=aiven_project["myproject"]["project"],
224
- service_name=aiven_kafka["myservice"]["service_name"],
225
- topic="<TOPIC_NAME_PATTERN>",
229
+ example_acl = aiven.KafkaAcl("example_acl",
230
+ project=example_project["project"],
231
+ service_name=example_kafka["serviceName"],
232
+ topic="example-topic",
226
233
  permission="admin",
227
- username="<USERNAME_PATTERN>")
234
+ username="example-user")
228
235
  ```
229
- <!--End PulumiCodeChooser -->
230
236
 
231
237
  ## Import
232
238
 
233
239
  ```sh
234
- $ pulumi import aiven:index/kafkaAcl:KafkaAcl mytestacl project/service_name/id
240
+ $ pulumi import aiven:index/kafkaAcl:KafkaAcl example_acl PROJECT/SERVICE_NAME/ID
235
241
  ```
236
242
 
237
243
  :param str resource_name: The name of the resource.
238
244
  :param pulumi.ResourceOptions opts: Options for the resource.
239
- :param pulumi.Input[str] permission: Kafka permission to grant. The possible values are `admin`, `read`, `readwrite` and `write`. This property cannot be changed, doing so forces recreation of the resource.
240
- :param pulumi.Input[str] project: Identifies the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. This property cannot be changed, doing so forces recreation of the resource.
241
- :param pulumi.Input[str] service_name: Specifies the name of the service that this resource belongs to. To set up proper dependencies please refer to this variable as a reference. This property cannot be changed, doing so forces recreation of the resource.
242
- :param pulumi.Input[str] topic: Topic name pattern for the ACL entry. This property cannot be changed, doing so forces recreation of the resource.
243
- :param pulumi.Input[str] username: Username pattern for the ACL entry. This property cannot be changed, doing so forces recreation of the resource.
245
+ :param pulumi.Input[str] permission: Permissions to grant. The possible values are `admin`, `read`, `readwrite` and `write`. Changing this property forces recreation of the resource.
246
+ :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.
247
+ :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.
248
+ :param pulumi.Input[str] topic: Topics that the permissions apply to. Changing this property forces recreation of the resource.
249
+ :param pulumi.Input[str] username: Usernames to grant permissions to. Changing this property forces recreation of the resource.
244
250
  """
245
251
  ...
246
252
  @overload
@@ -249,28 +255,29 @@ class KafkaAcl(pulumi.CustomResource):
249
255
  args: KafkaAclArgs,
250
256
  opts: Optional[pulumi.ResourceOptions] = None):
251
257
  """
252
- The Resource Kafka ACL resource allows the creation and management of ACLs for an Aiven Kafka service.
258
+ Creates and manages Aiven [access control lists](https://aiven.io/docs/products/kafka/concepts/acl) (ACLs) for an Aiven for Apache Kafka® service. ACLs control access to Kafka topics, consumer groups,
259
+ clusters, and Schema Registry.
260
+
261
+ Aiven ACLs provide simplified topic-level control with basic permissions and wildcard support. For more advanced access control, you can use Kafka-native ACLs.
253
262
 
254
263
  ## Example Usage
255
264
 
256
- <!--Start PulumiCodeChooser -->
257
265
  ```python
258
266
  import pulumi
259
267
  import pulumi_aiven as aiven
260
268
 
261
- mytestacl = aiven.KafkaAcl("mytestacl",
262
- project=aiven_project["myproject"]["project"],
263
- service_name=aiven_kafka["myservice"]["service_name"],
264
- topic="<TOPIC_NAME_PATTERN>",
269
+ example_acl = aiven.KafkaAcl("example_acl",
270
+ project=example_project["project"],
271
+ service_name=example_kafka["serviceName"],
272
+ topic="example-topic",
265
273
  permission="admin",
266
- username="<USERNAME_PATTERN>")
274
+ username="example-user")
267
275
  ```
268
- <!--End PulumiCodeChooser -->
269
276
 
270
277
  ## Import
271
278
 
272
279
  ```sh
273
- $ pulumi import aiven:index/kafkaAcl:KafkaAcl mytestacl project/service_name/id
280
+ $ pulumi import aiven:index/kafkaAcl:KafkaAcl example_acl PROJECT/SERVICE_NAME/ID
274
281
  ```
275
282
 
276
283
  :param str resource_name: The name of the resource.
@@ -341,12 +348,12 @@ class KafkaAcl(pulumi.CustomResource):
341
348
  :param str resource_name: The unique name of the resulting resource.
342
349
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
343
350
  :param pulumi.ResourceOptions opts: Options for the resource.
344
- :param pulumi.Input[str] acl_id: Kafka ACL ID
345
- :param pulumi.Input[str] permission: Kafka permission to grant. The possible values are `admin`, `read`, `readwrite` and `write`. This property cannot be changed, doing so forces recreation of the resource.
346
- :param pulumi.Input[str] project: Identifies the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. This property cannot be changed, doing so forces recreation of the resource.
347
- :param pulumi.Input[str] service_name: Specifies the name of the service that this resource belongs to. To set up proper dependencies please refer to this variable as a reference. This property cannot be changed, doing so forces recreation of the resource.
348
- :param pulumi.Input[str] topic: Topic name pattern for the ACL entry. This property cannot be changed, doing so forces recreation of the resource.
349
- :param pulumi.Input[str] username: Username pattern for the ACL entry. This property cannot be changed, doing so forces recreation of the resource.
351
+ :param pulumi.Input[str] acl_id: Kafka ACL ID.
352
+ :param pulumi.Input[str] permission: Permissions to grant. The possible values are `admin`, `read`, `readwrite` and `write`. Changing this property forces recreation of the resource.
353
+ :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.
354
+ :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.
355
+ :param pulumi.Input[str] topic: Topics that the permissions apply to. Changing this property forces recreation of the resource.
356
+ :param pulumi.Input[str] username: Usernames to grant permissions to. Changing this property forces recreation of the resource.
350
357
  """
351
358
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
352
359
 
@@ -364,7 +371,7 @@ class KafkaAcl(pulumi.CustomResource):
364
371
  @pulumi.getter(name="aclId")
365
372
  def acl_id(self) -> pulumi.Output[str]:
366
373
  """
367
- Kafka ACL ID
374
+ Kafka ACL ID.
368
375
  """
369
376
  return pulumi.get(self, "acl_id")
370
377
 
@@ -372,7 +379,7 @@ class KafkaAcl(pulumi.CustomResource):
372
379
  @pulumi.getter
373
380
  def permission(self) -> pulumi.Output[str]:
374
381
  """
375
- Kafka permission to grant. The possible values are `admin`, `read`, `readwrite` and `write`. This property cannot be changed, doing so forces recreation of the resource.
382
+ Permissions to grant. The possible values are `admin`, `read`, `readwrite` and `write`. Changing this property forces recreation of the resource.
376
383
  """
377
384
  return pulumi.get(self, "permission")
378
385
 
@@ -380,7 +387,7 @@ class KafkaAcl(pulumi.CustomResource):
380
387
  @pulumi.getter
381
388
  def project(self) -> pulumi.Output[str]:
382
389
  """
383
- Identifies the project this resource belongs to. To set up proper dependencies please refer to this variable as a reference. This property cannot be changed, doing so forces recreation of the resource.
390
+ 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.
384
391
  """
385
392
  return pulumi.get(self, "project")
386
393
 
@@ -388,7 +395,7 @@ class KafkaAcl(pulumi.CustomResource):
388
395
  @pulumi.getter(name="serviceName")
389
396
  def service_name(self) -> pulumi.Output[str]:
390
397
  """
391
- Specifies the name of the service that this resource belongs to. To set up proper dependencies please refer to this variable as a reference. This property cannot be changed, doing so forces recreation of the resource.
398
+ 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.
392
399
  """
393
400
  return pulumi.get(self, "service_name")
394
401
 
@@ -396,7 +403,7 @@ class KafkaAcl(pulumi.CustomResource):
396
403
  @pulumi.getter
397
404
  def topic(self) -> pulumi.Output[str]:
398
405
  """
399
- Topic name pattern for the ACL entry. This property cannot be changed, doing so forces recreation of the resource.
406
+ Topics that the permissions apply to. Changing this property forces recreation of the resource.
400
407
  """
401
408
  return pulumi.get(self, "topic")
402
409
 
@@ -404,7 +411,7 @@ class KafkaAcl(pulumi.CustomResource):
404
411
  @pulumi.getter
405
412
  def username(self) -> pulumi.Output[str]:
406
413
  """
407
- Username pattern for the ACL entry. This property cannot be changed, doing so forces recreation of the resource.
414
+ Usernames to grant permissions to. Changing this property forces recreation of the resource.
408
415
  """
409
416
  return pulumi.get(self, "username")
410
417