google-apis-managedkafka_v1 0.4.0 → 0.5.0

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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 65caecafd2bbd4ea329038d844373d85770b4b08a5385f584907c97785a439de
4
- data.tar.gz: aa494dc157d232b88cda9f2dd6abe2e985e2770d7a9c90d5f83ce2dfc8ac7634
3
+ metadata.gz: ac98830a1082d30d942b32c58b6bc30cd1e1394b41aee0fe6aa30dac32640300
4
+ data.tar.gz: 6f69e551b58a90b56f5a6a952825aa777d72d16b8b5c95e3eafc0b2b21da862d
5
5
  SHA512:
6
- metadata.gz: e3868f9a53c0ec12516e32013a23aa30345ac903eee702f9158f973e5f493a2366c9bb42b5a12e2580ccaa5cacbc26749431ac729fc6bcfe1c5831f539c18eef
7
- data.tar.gz: df90c29e136566d11c7fba96b210fb5fb69cd607dc365514677d35814e7183d49a615bcecc22aea895c7eb8a4f55465c97547a8edb2b2837e66e2c6a9ef9a54e
6
+ metadata.gz: c74d6ed6c7ca2eee74073116d0cb156f84e7a38d8ae7e37ccb93e0d0adebd7e5ceeb662e13c5a582175bba7361bc43af1bb0643e590a8f61df125092c6d938e2
7
+ data.tar.gz: f3e48d263aed74362d9e9f3dda657c67b737bef3dff02c05bf9a2c556fc13112cb588ca6548e4e0906d0cd502e01e9c6fe96941c3092aa73f8778b520320085d
data/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Release history for google-apis-managedkafka_v1
2
2
 
3
+ ### v0.5.0 (2025-04-27)
4
+
5
+ * Regenerated from discovery document revision 20250414
6
+
3
7
  ### v0.4.0 (2025-04-20)
4
8
 
5
9
  * Regenerated from discovery document revision 20250327
@@ -43,6 +43,149 @@ module Google
43
43
  end
44
44
  end
45
45
 
46
+ # Represents the set of ACLs for a given Kafka Resource Pattern, which consists
47
+ # of resource_type, resource_name and pattern_type.
48
+ class Acl
49
+ include Google::Apis::Core::Hashable
50
+
51
+ # Required. The ACL entries that apply to the resource pattern. The maximum
52
+ # number of allowed entries 100.
53
+ # Corresponds to the JSON property `aclEntries`
54
+ # @return [Array<Google::Apis::ManagedkafkaV1::AclEntry>]
55
+ attr_accessor :acl_entries
56
+
57
+ # Optional. `etag` is used for concurrency control. An `etag` is returned in the
58
+ # response to `GetAcl` and `CreateAcl`. Callers are required to put that etag in
59
+ # the request to `UpdateAcl` to ensure that their change will be applied to the
60
+ # same version of the acl that exists in the Kafka Cluster. A terminal 'T'
61
+ # character in the etag indicates that the AclEntries were truncated; more
62
+ # entries for the Acl exist on the Kafka Cluster, but can't be returned in the
63
+ # Acl due to repeated field limits.
64
+ # Corresponds to the JSON property `etag`
65
+ # @return [String]
66
+ attr_accessor :etag
67
+
68
+ # Identifier. The name for the acl. Represents a single Resource Pattern.
69
+ # Structured like: projects/`project`/locations/`location`/clusters/`cluster`/
70
+ # acls/`acl_id` The structure of `acl_id` defines the Resource Pattern (
71
+ # resource_type, resource_name, pattern_type) of the acl. `acl_id` is structured
72
+ # like one of the following: For acls on the cluster: `cluster` For acls on a
73
+ # single resource within the cluster: `topic/`resource_name`` `consumerGroup/`
74
+ # resource_name`` `transactionalId/`resource_name`` For acls on all resources
75
+ # that match a prefix: `topicPrefixed/`resource_name`` `consumerGroupPrefixed/`
76
+ # resource_name`` `transactionalIdPrefixed/`resource_name`` For acls on all
77
+ # resources of a given type (i.e. the wildcard literal "*"): `allTopics` (
78
+ # represents `topic/*`) `allConsumerGroups` (represents `consumerGroup/*`) `
79
+ # allTransactionalIds` (represents `transactionalId/*`)
80
+ # Corresponds to the JSON property `name`
81
+ # @return [String]
82
+ attr_accessor :name
83
+
84
+ # Output only. The ACL pattern type derived from the name. One of: LITERAL,
85
+ # PREFIXED.
86
+ # Corresponds to the JSON property `patternType`
87
+ # @return [String]
88
+ attr_accessor :pattern_type
89
+
90
+ # Output only. The ACL resource name derived from the name. For cluster
91
+ # resource_type, this is always "kafka-cluster". Can be the wildcard literal "*".
92
+ # Corresponds to the JSON property `resourceName`
93
+ # @return [String]
94
+ attr_accessor :resource_name
95
+
96
+ # Output only. The ACL resource type derived from the name. One of: CLUSTER,
97
+ # TOPIC, GROUP, TRANSACTIONAL_ID.
98
+ # Corresponds to the JSON property `resourceType`
99
+ # @return [String]
100
+ attr_accessor :resource_type
101
+
102
+ def initialize(**args)
103
+ update!(**args)
104
+ end
105
+
106
+ # Update properties of this object
107
+ def update!(**args)
108
+ @acl_entries = args[:acl_entries] if args.key?(:acl_entries)
109
+ @etag = args[:etag] if args.key?(:etag)
110
+ @name = args[:name] if args.key?(:name)
111
+ @pattern_type = args[:pattern_type] if args.key?(:pattern_type)
112
+ @resource_name = args[:resource_name] if args.key?(:resource_name)
113
+ @resource_type = args[:resource_type] if args.key?(:resource_type)
114
+ end
115
+ end
116
+
117
+ # Represents the access granted for a given Resource Pattern in an ACL.
118
+ class AclEntry
119
+ include Google::Apis::Core::Hashable
120
+
121
+ # Required. The host. Must be set to "*" for Managed Service for Apache Kafka.
122
+ # Corresponds to the JSON property `host`
123
+ # @return [String]
124
+ attr_accessor :host
125
+
126
+ # Required. The operation type. Allowed values are (case insensitive): ALL, READ,
127
+ # WRITE, CREATE, DELETE, ALTER, DESCRIBE, CLUSTER_ACTION, DESCRIBE_CONFIGS,
128
+ # ALTER_CONFIGS, and IDEMPOTENT_WRITE. See https://kafka.apache.org/
129
+ # documentation/#operations_resources_and_protocols for valid combinations of
130
+ # resource_type and operation for different Kafka API requests.
131
+ # Corresponds to the JSON property `operation`
132
+ # @return [String]
133
+ attr_accessor :operation
134
+
135
+ # Required. The permission type. Accepted values are (case insensitive): ALLOW,
136
+ # DENY.
137
+ # Corresponds to the JSON property `permissionType`
138
+ # @return [String]
139
+ attr_accessor :permission_type
140
+
141
+ # Required. The principal. Specified as Google Cloud account, with the Kafka
142
+ # StandardAuthorizer prefix "User:". For example: "User:test-kafka-client@test-
143
+ # project.iam.gserviceaccount.com". Can be the wildcard "User:*" to refer to all
144
+ # users.
145
+ # Corresponds to the JSON property `principal`
146
+ # @return [String]
147
+ attr_accessor :principal
148
+
149
+ def initialize(**args)
150
+ update!(**args)
151
+ end
152
+
153
+ # Update properties of this object
154
+ def update!(**args)
155
+ @host = args[:host] if args.key?(:host)
156
+ @operation = args[:operation] if args.key?(:operation)
157
+ @permission_type = args[:permission_type] if args.key?(:permission_type)
158
+ @principal = args[:principal] if args.key?(:principal)
159
+ end
160
+ end
161
+
162
+ # Response for AddAclEntry.
163
+ class AddAclEntryResponse
164
+ include Google::Apis::Core::Hashable
165
+
166
+ # Represents the set of ACLs for a given Kafka Resource Pattern, which consists
167
+ # of resource_type, resource_name and pattern_type.
168
+ # Corresponds to the JSON property `acl`
169
+ # @return [Google::Apis::ManagedkafkaV1::Acl]
170
+ attr_accessor :acl
171
+
172
+ # Whether the acl was created as a result of adding the acl entry.
173
+ # Corresponds to the JSON property `aclCreated`
174
+ # @return [Boolean]
175
+ attr_accessor :acl_created
176
+ alias_method :acl_created?, :acl_created
177
+
178
+ def initialize(**args)
179
+ update!(**args)
180
+ end
181
+
182
+ # Update properties of this object
183
+ def update!(**args)
184
+ @acl = args[:acl] if args.key?(:acl)
185
+ @acl_created = args[:acl_created] if args.key?(:acl_created)
186
+ end
187
+ end
188
+
46
189
  # The request message for Operations.CancelOperation.
47
190
  class CancelOperationRequest
48
191
  include Google::Apis::Core::Hashable
@@ -490,6 +633,32 @@ module Google
490
633
  end
491
634
  end
492
635
 
636
+ # Response for ListAcls.
637
+ class ListAclsResponse
638
+ include Google::Apis::Core::Hashable
639
+
640
+ # The list of acls in the requested parent. The order of the acls is unspecified.
641
+ # Corresponds to the JSON property `acls`
642
+ # @return [Array<Google::Apis::ManagedkafkaV1::Acl>]
643
+ attr_accessor :acls
644
+
645
+ # A token that can be sent as `page_token` to retrieve the next page of results.
646
+ # If this field is omitted, there are no more results.
647
+ # Corresponds to the JSON property `nextPageToken`
648
+ # @return [String]
649
+ attr_accessor :next_page_token
650
+
651
+ def initialize(**args)
652
+ update!(**args)
653
+ end
654
+
655
+ # Update properties of this object
656
+ def update!(**args)
657
+ @acls = args[:acls] if args.key?(:acls)
658
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
659
+ end
660
+ end
661
+
493
662
  # Response for ListClusters.
494
663
  class ListClustersResponse
495
664
  include Google::Apis::Core::Hashable
@@ -922,6 +1091,34 @@ module Google
922
1091
  end
923
1092
  end
924
1093
 
1094
+ # Response for RemoveAclEntry.
1095
+ class RemoveAclEntryResponse
1096
+ include Google::Apis::Core::Hashable
1097
+
1098
+ # Represents the set of ACLs for a given Kafka Resource Pattern, which consists
1099
+ # of resource_type, resource_name and pattern_type.
1100
+ # Corresponds to the JSON property `acl`
1101
+ # @return [Google::Apis::ManagedkafkaV1::Acl]
1102
+ attr_accessor :acl
1103
+
1104
+ # Returned with value true if the removed acl entry was the last entry in the
1105
+ # acl, resulting in acl deletion.
1106
+ # Corresponds to the JSON property `aclDeleted`
1107
+ # @return [Boolean]
1108
+ attr_accessor :acl_deleted
1109
+ alias_method :acl_deleted?, :acl_deleted
1110
+
1111
+ def initialize(**args)
1112
+ update!(**args)
1113
+ end
1114
+
1115
+ # Update properties of this object
1116
+ def update!(**args)
1117
+ @acl = args[:acl] if args.key?(:acl)
1118
+ @acl_deleted = args[:acl_deleted] if args.key?(:acl_deleted)
1119
+ end
1120
+ end
1121
+
925
1122
  # Request for RestartConnector.
926
1123
  class RestartConnectorRequest
927
1124
  include Google::Apis::Core::Hashable
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module ManagedkafkaV1
18
18
  # Version of the google-apis-managedkafka_v1 gem
19
- GEM_VERSION = "0.4.0"
19
+ GEM_VERSION = "0.5.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.16.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20250327"
25
+ REVISION = "20250414"
26
26
  end
27
27
  end
28
28
  end
@@ -28,6 +28,24 @@ module Google
28
28
  include Google::Apis::Core::JsonObjectSupport
29
29
  end
30
30
 
31
+ class Acl
32
+ class Representation < Google::Apis::Core::JsonRepresentation; end
33
+
34
+ include Google::Apis::Core::JsonObjectSupport
35
+ end
36
+
37
+ class AclEntry
38
+ class Representation < Google::Apis::Core::JsonRepresentation; end
39
+
40
+ include Google::Apis::Core::JsonObjectSupport
41
+ end
42
+
43
+ class AddAclEntryResponse
44
+ class Representation < Google::Apis::Core::JsonRepresentation; end
45
+
46
+ include Google::Apis::Core::JsonObjectSupport
47
+ end
48
+
31
49
  class CancelOperationRequest
32
50
  class Representation < Google::Apis::Core::JsonRepresentation; end
33
51
 
@@ -106,6 +124,12 @@ module Google
106
124
  include Google::Apis::Core::JsonObjectSupport
107
125
  end
108
126
 
127
+ class ListAclsResponse
128
+ class Representation < Google::Apis::Core::JsonRepresentation; end
129
+
130
+ include Google::Apis::Core::JsonObjectSupport
131
+ end
132
+
109
133
  class ListClustersResponse
110
134
  class Representation < Google::Apis::Core::JsonRepresentation; end
111
135
 
@@ -190,6 +214,12 @@ module Google
190
214
  include Google::Apis::Core::JsonObjectSupport
191
215
  end
192
216
 
217
+ class RemoveAclEntryResponse
218
+ class Representation < Google::Apis::Core::JsonRepresentation; end
219
+
220
+ include Google::Apis::Core::JsonObjectSupport
221
+ end
222
+
193
223
  class RestartConnectorRequest
194
224
  class Representation < Google::Apis::Core::JsonRepresentation; end
195
225
 
@@ -252,6 +282,38 @@ module Google
252
282
  end
253
283
  end
254
284
 
285
+ class Acl
286
+ # @private
287
+ class Representation < Google::Apis::Core::JsonRepresentation
288
+ collection :acl_entries, as: 'aclEntries', class: Google::Apis::ManagedkafkaV1::AclEntry, decorator: Google::Apis::ManagedkafkaV1::AclEntry::Representation
289
+
290
+ property :etag, as: 'etag'
291
+ property :name, as: 'name'
292
+ property :pattern_type, as: 'patternType'
293
+ property :resource_name, as: 'resourceName'
294
+ property :resource_type, as: 'resourceType'
295
+ end
296
+ end
297
+
298
+ class AclEntry
299
+ # @private
300
+ class Representation < Google::Apis::Core::JsonRepresentation
301
+ property :host, as: 'host'
302
+ property :operation, as: 'operation'
303
+ property :permission_type, as: 'permissionType'
304
+ property :principal, as: 'principal'
305
+ end
306
+ end
307
+
308
+ class AddAclEntryResponse
309
+ # @private
310
+ class Representation < Google::Apis::Core::JsonRepresentation
311
+ property :acl, as: 'acl', class: Google::Apis::ManagedkafkaV1::Acl, decorator: Google::Apis::ManagedkafkaV1::Acl::Representation
312
+
313
+ property :acl_created, as: 'aclCreated'
314
+ end
315
+ end
316
+
255
317
  class CancelOperationRequest
256
318
  # @private
257
319
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -379,6 +441,15 @@ module Google
379
441
  end
380
442
  end
381
443
 
444
+ class ListAclsResponse
445
+ # @private
446
+ class Representation < Google::Apis::Core::JsonRepresentation
447
+ collection :acls, as: 'acls', class: Google::Apis::ManagedkafkaV1::Acl, decorator: Google::Apis::ManagedkafkaV1::Acl::Representation
448
+
449
+ property :next_page_token, as: 'nextPageToken'
450
+ end
451
+ end
452
+
382
453
  class ListClustersResponse
383
454
  # @private
384
455
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -506,6 +577,15 @@ module Google
506
577
  end
507
578
  end
508
579
 
580
+ class RemoveAclEntryResponse
581
+ # @private
582
+ class Representation < Google::Apis::Core::JsonRepresentation
583
+ property :acl, as: 'acl', class: Google::Apis::ManagedkafkaV1::Acl, decorator: Google::Apis::ManagedkafkaV1::Acl::Representation
584
+
585
+ property :acl_deleted, as: 'aclDeleted'
586
+ end
587
+ end
588
+
509
589
  class RestartConnectorRequest
510
590
  # @private
511
591
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -351,6 +351,284 @@ module Google
351
351
  execute_or_queue_command(command, &block)
352
352
  end
353
353
 
354
+ # Incremental update: Adds an acl entry to an acl. Creates the acl if it does
355
+ # not exist yet.
356
+ # @param [String] acl
357
+ # Required. The name of the acl to add the acl entry to. Structured like: `
358
+ # projects/`project`/locations/`location`/clusters/`cluster`/acls/`acl_id``. The
359
+ # structure of `acl_id` defines the Resource Pattern (resource_type,
360
+ # resource_name, pattern_type) of the acl. See `Acl.name` for details.
361
+ # @param [Google::Apis::ManagedkafkaV1::AclEntry] acl_entry_object
362
+ # @param [String] fields
363
+ # Selector specifying which fields to include in a partial response.
364
+ # @param [String] quota_user
365
+ # Available to use for quota purposes for server-side applications. Can be any
366
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
367
+ # @param [Google::Apis::RequestOptions] options
368
+ # Request-specific options
369
+ #
370
+ # @yield [result, err] Result & error if block supplied
371
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::AddAclEntryResponse] parsed result object
372
+ # @yieldparam err [StandardError] error object if request failed
373
+ #
374
+ # @return [Google::Apis::ManagedkafkaV1::AddAclEntryResponse]
375
+ #
376
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
377
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
378
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
379
+ def add_project_location_cluster_acl_acl_entry(acl, acl_entry_object = nil, fields: nil, quota_user: nil, options: nil, &block)
380
+ command = make_simple_command(:post, 'v1/{+acl}:addAclEntry', options)
381
+ command.request_representation = Google::Apis::ManagedkafkaV1::AclEntry::Representation
382
+ command.request_object = acl_entry_object
383
+ command.response_representation = Google::Apis::ManagedkafkaV1::AddAclEntryResponse::Representation
384
+ command.response_class = Google::Apis::ManagedkafkaV1::AddAclEntryResponse
385
+ command.params['acl'] = acl unless acl.nil?
386
+ command.query['fields'] = fields unless fields.nil?
387
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
388
+ execute_or_queue_command(command, &block)
389
+ end
390
+
391
+ # Creates a new acl in the given project, location, and cluster.
392
+ # @param [String] parent
393
+ # Required. The parent cluster in which to create the acl. Structured like `
394
+ # projects/`project`/locations/`location`/clusters/`cluster``.
395
+ # @param [Google::Apis::ManagedkafkaV1::Acl] acl_object
396
+ # @param [String] acl_id
397
+ # Required. The ID to use for the acl, which will become the final component of
398
+ # the acl's name. The structure of `acl_id` defines the Resource Pattern (
399
+ # resource_type, resource_name, pattern_type) of the acl. `acl_id` is structured
400
+ # like one of the following: For acls on the cluster: `cluster` For acls on a
401
+ # single resource within the cluster: `topic/`resource_name`` `consumerGroup/`
402
+ # resource_name`` `transactionalId/`resource_name`` For acls on all resources
403
+ # that match a prefix: `topicPrefixed/`resource_name`` `consumerGroupPrefixed/`
404
+ # resource_name`` `transactionalIdPrefixed/`resource_name`` For acls on all
405
+ # resources of a given type (i.e. the wildcard literal "*"): `allTopics` (
406
+ # represents `topic/*`) `allConsumerGroups` (represents `consumerGroup/*`) `
407
+ # allTransactionalIds` (represents `transactionalId/*`)
408
+ # @param [String] fields
409
+ # Selector specifying which fields to include in a partial response.
410
+ # @param [String] quota_user
411
+ # Available to use for quota purposes for server-side applications. Can be any
412
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
413
+ # @param [Google::Apis::RequestOptions] options
414
+ # Request-specific options
415
+ #
416
+ # @yield [result, err] Result & error if block supplied
417
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::Acl] parsed result object
418
+ # @yieldparam err [StandardError] error object if request failed
419
+ #
420
+ # @return [Google::Apis::ManagedkafkaV1::Acl]
421
+ #
422
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
423
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
424
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
425
+ def create_project_location_cluster_acl(parent, acl_object = nil, acl_id: nil, fields: nil, quota_user: nil, options: nil, &block)
426
+ command = make_simple_command(:post, 'v1/{+parent}/acls', options)
427
+ command.request_representation = Google::Apis::ManagedkafkaV1::Acl::Representation
428
+ command.request_object = acl_object
429
+ command.response_representation = Google::Apis::ManagedkafkaV1::Acl::Representation
430
+ command.response_class = Google::Apis::ManagedkafkaV1::Acl
431
+ command.params['parent'] = parent unless parent.nil?
432
+ command.query['aclId'] = acl_id unless acl_id.nil?
433
+ command.query['fields'] = fields unless fields.nil?
434
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
435
+ execute_or_queue_command(command, &block)
436
+ end
437
+
438
+ # Deletes an acl.
439
+ # @param [String] name
440
+ # Required. The name of the acl to delete. Structured like: `projects/`project`/
441
+ # locations/`location`/clusters/`cluster`/acls/`acl_id``. The structure of `
442
+ # acl_id` defines the Resource Pattern (resource_type, resource_name,
443
+ # pattern_type) of the acl. See `Acl.name` for details.
444
+ # @param [String] fields
445
+ # Selector specifying which fields to include in a partial response.
446
+ # @param [String] quota_user
447
+ # Available to use for quota purposes for server-side applications. Can be any
448
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
449
+ # @param [Google::Apis::RequestOptions] options
450
+ # Request-specific options
451
+ #
452
+ # @yield [result, err] Result & error if block supplied
453
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::Empty] parsed result object
454
+ # @yieldparam err [StandardError] error object if request failed
455
+ #
456
+ # @return [Google::Apis::ManagedkafkaV1::Empty]
457
+ #
458
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
459
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
460
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
461
+ def delete_project_location_cluster_acl(name, fields: nil, quota_user: nil, options: nil, &block)
462
+ command = make_simple_command(:delete, 'v1/{+name}', options)
463
+ command.response_representation = Google::Apis::ManagedkafkaV1::Empty::Representation
464
+ command.response_class = Google::Apis::ManagedkafkaV1::Empty
465
+ command.params['name'] = name unless name.nil?
466
+ command.query['fields'] = fields unless fields.nil?
467
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
468
+ execute_or_queue_command(command, &block)
469
+ end
470
+
471
+ # Returns the properties of a single acl.
472
+ # @param [String] name
473
+ # Required. The name of the acl to return. Structured like: `projects/`project`/
474
+ # locations/`location`/clusters/`cluster`/acls/`acl_id``. The structure of `
475
+ # acl_id` defines the Resource Pattern (resource_type, resource_name,
476
+ # pattern_type) of the acl. See `Acl.name` for details.
477
+ # @param [String] fields
478
+ # Selector specifying which fields to include in a partial response.
479
+ # @param [String] quota_user
480
+ # Available to use for quota purposes for server-side applications. Can be any
481
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
482
+ # @param [Google::Apis::RequestOptions] options
483
+ # Request-specific options
484
+ #
485
+ # @yield [result, err] Result & error if block supplied
486
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::Acl] parsed result object
487
+ # @yieldparam err [StandardError] error object if request failed
488
+ #
489
+ # @return [Google::Apis::ManagedkafkaV1::Acl]
490
+ #
491
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
492
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
493
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
494
+ def get_project_location_cluster_acl(name, fields: nil, quota_user: nil, options: nil, &block)
495
+ command = make_simple_command(:get, 'v1/{+name}', options)
496
+ command.response_representation = Google::Apis::ManagedkafkaV1::Acl::Representation
497
+ command.response_class = Google::Apis::ManagedkafkaV1::Acl
498
+ command.params['name'] = name unless name.nil?
499
+ command.query['fields'] = fields unless fields.nil?
500
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
501
+ execute_or_queue_command(command, &block)
502
+ end
503
+
504
+ # Lists the acls in a given cluster.
505
+ # @param [String] parent
506
+ # Required. The parent cluster whose acls are to be listed. Structured like `
507
+ # projects/`project`/locations/`location`/clusters/`cluster``.
508
+ # @param [Fixnum] page_size
509
+ # Optional. The maximum number of acls to return. The service may return fewer
510
+ # than this value. If unset or zero, all acls for the parent is returned.
511
+ # @param [String] page_token
512
+ # Optional. A page token, received from a previous `ListAcls` call. Provide this
513
+ # to retrieve the subsequent page. When paginating, all other parameters
514
+ # provided to `ListAcls` must match the call that provided the page token.
515
+ # @param [String] fields
516
+ # Selector specifying which fields to include in a partial response.
517
+ # @param [String] quota_user
518
+ # Available to use for quota purposes for server-side applications. Can be any
519
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
520
+ # @param [Google::Apis::RequestOptions] options
521
+ # Request-specific options
522
+ #
523
+ # @yield [result, err] Result & error if block supplied
524
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::ListAclsResponse] parsed result object
525
+ # @yieldparam err [StandardError] error object if request failed
526
+ #
527
+ # @return [Google::Apis::ManagedkafkaV1::ListAclsResponse]
528
+ #
529
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
530
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
531
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
532
+ def list_project_location_cluster_acls(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
533
+ command = make_simple_command(:get, 'v1/{+parent}/acls', options)
534
+ command.response_representation = Google::Apis::ManagedkafkaV1::ListAclsResponse::Representation
535
+ command.response_class = Google::Apis::ManagedkafkaV1::ListAclsResponse
536
+ command.params['parent'] = parent unless parent.nil?
537
+ command.query['pageSize'] = page_size unless page_size.nil?
538
+ command.query['pageToken'] = page_token unless page_token.nil?
539
+ command.query['fields'] = fields unless fields.nil?
540
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
541
+ execute_or_queue_command(command, &block)
542
+ end
543
+
544
+ # Updates the properties of a single acl.
545
+ # @param [String] name
546
+ # Identifier. The name for the acl. Represents a single Resource Pattern.
547
+ # Structured like: projects/`project`/locations/`location`/clusters/`cluster`/
548
+ # acls/`acl_id` The structure of `acl_id` defines the Resource Pattern (
549
+ # resource_type, resource_name, pattern_type) of the acl. `acl_id` is structured
550
+ # like one of the following: For acls on the cluster: `cluster` For acls on a
551
+ # single resource within the cluster: `topic/`resource_name`` `consumerGroup/`
552
+ # resource_name`` `transactionalId/`resource_name`` For acls on all resources
553
+ # that match a prefix: `topicPrefixed/`resource_name`` `consumerGroupPrefixed/`
554
+ # resource_name`` `transactionalIdPrefixed/`resource_name`` For acls on all
555
+ # resources of a given type (i.e. the wildcard literal "*"): `allTopics` (
556
+ # represents `topic/*`) `allConsumerGroups` (represents `consumerGroup/*`) `
557
+ # allTransactionalIds` (represents `transactionalId/*`)
558
+ # @param [Google::Apis::ManagedkafkaV1::Acl] acl_object
559
+ # @param [String] update_mask
560
+ # Optional. Field mask is used to specify the fields to be overwritten in the
561
+ # Acl resource by the update. The fields specified in the update_mask are
562
+ # relative to the resource, not the full request. A field will be overwritten if
563
+ # it is in the mask.
564
+ # @param [String] fields
565
+ # Selector specifying which fields to include in a partial response.
566
+ # @param [String] quota_user
567
+ # Available to use for quota purposes for server-side applications. Can be any
568
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
569
+ # @param [Google::Apis::RequestOptions] options
570
+ # Request-specific options
571
+ #
572
+ # @yield [result, err] Result & error if block supplied
573
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::Acl] parsed result object
574
+ # @yieldparam err [StandardError] error object if request failed
575
+ #
576
+ # @return [Google::Apis::ManagedkafkaV1::Acl]
577
+ #
578
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
579
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
580
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
581
+ def patch_project_location_cluster_acl(name, acl_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
582
+ command = make_simple_command(:patch, 'v1/{+name}', options)
583
+ command.request_representation = Google::Apis::ManagedkafkaV1::Acl::Representation
584
+ command.request_object = acl_object
585
+ command.response_representation = Google::Apis::ManagedkafkaV1::Acl::Representation
586
+ command.response_class = Google::Apis::ManagedkafkaV1::Acl
587
+ command.params['name'] = name unless name.nil?
588
+ command.query['updateMask'] = update_mask unless update_mask.nil?
589
+ command.query['fields'] = fields unless fields.nil?
590
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
591
+ execute_or_queue_command(command, &block)
592
+ end
593
+
594
+ # Incremental update: Removes an acl entry from an acl. Deletes the acl if its
595
+ # acl entries become empty (i.e. if the removed entry was the last one in the
596
+ # acl).
597
+ # @param [String] acl
598
+ # Required. The name of the acl to remove the acl entry from. Structured like: `
599
+ # projects/`project`/locations/`location`/clusters/`cluster`/acls/`acl_id``. The
600
+ # structure of `acl_id` defines the Resource Pattern (resource_type,
601
+ # resource_name, pattern_type) of the acl. See `Acl.name` for details.
602
+ # @param [Google::Apis::ManagedkafkaV1::AclEntry] acl_entry_object
603
+ # @param [String] fields
604
+ # Selector specifying which fields to include in a partial response.
605
+ # @param [String] quota_user
606
+ # Available to use for quota purposes for server-side applications. Can be any
607
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
608
+ # @param [Google::Apis::RequestOptions] options
609
+ # Request-specific options
610
+ #
611
+ # @yield [result, err] Result & error if block supplied
612
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::RemoveAclEntryResponse] parsed result object
613
+ # @yieldparam err [StandardError] error object if request failed
614
+ #
615
+ # @return [Google::Apis::ManagedkafkaV1::RemoveAclEntryResponse]
616
+ #
617
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
618
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
619
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
620
+ def remove_project_location_cluster_acl_acl_entry(acl, acl_entry_object = nil, fields: nil, quota_user: nil, options: nil, &block)
621
+ command = make_simple_command(:post, 'v1/{+acl}:removeAclEntry', options)
622
+ command.request_representation = Google::Apis::ManagedkafkaV1::AclEntry::Representation
623
+ command.request_object = acl_entry_object
624
+ command.response_representation = Google::Apis::ManagedkafkaV1::RemoveAclEntryResponse::Representation
625
+ command.response_class = Google::Apis::ManagedkafkaV1::RemoveAclEntryResponse
626
+ command.params['acl'] = acl unless acl.nil?
627
+ command.query['fields'] = fields unless fields.nil?
628
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
629
+ execute_or_queue_command(command, &block)
630
+ end
631
+
354
632
  # Deletes a single consumer group.
355
633
  # @param [String] name
356
634
  # Required. The name of the consumer group to delete. `projects/`project`/
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-managedkafka_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.0
4
+ version: 0.5.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  bindir: bin
9
9
  cert_chain: []
10
- date: 2025-04-20 00:00:00.000000000 Z
10
+ date: 2025-04-27 00:00:00.000000000 Z
11
11
  dependencies:
12
12
  - !ruby/object:Gem::Dependency
13
13
  name: google-apis-core
@@ -57,7 +57,7 @@ licenses:
57
57
  metadata:
58
58
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
59
59
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-managedkafka_v1/CHANGELOG.md
60
- documentation_uri: https://googleapis.dev/ruby/google-apis-managedkafka_v1/v0.4.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-managedkafka_v1/v0.5.0
61
61
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-managedkafka_v1
62
62
  rdoc_options: []
63
63
  require_paths: