google-apis-dataplex_v1 0.73.0 → 0.75.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.
@@ -51,6 +51,106 @@ module Google
51
51
  @batch_path = 'batch'
52
52
  end
53
53
 
54
+ # Create an EncryptionConfig.
55
+ # @param [String] parent
56
+ # Required. The location at which the EncryptionConfig is to be created.
57
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1EncryptionConfig] google_cloud_dataplex_v1_encryption_config_object
58
+ # @param [String] encryption_config_id
59
+ # Required. The ID of the EncryptionConfig to create. Currently, only a value of
60
+ # "default" is supported.
61
+ # @param [String] fields
62
+ # Selector specifying which fields to include in a partial response.
63
+ # @param [String] quota_user
64
+ # Available to use for quota purposes for server-side applications. Can be any
65
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
66
+ # @param [Google::Apis::RequestOptions] options
67
+ # Request-specific options
68
+ #
69
+ # @yield [result, err] Result & error if block supplied
70
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
71
+ # @yieldparam err [StandardError] error object if request failed
72
+ #
73
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
74
+ #
75
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
76
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
77
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
78
+ def create_organization_location_encryption_config(parent, google_cloud_dataplex_v1_encryption_config_object = nil, encryption_config_id: nil, fields: nil, quota_user: nil, options: nil, &block)
79
+ command = make_simple_command(:post, 'v1/{+parent}/encryptionConfigs', options)
80
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1EncryptionConfig::Representation
81
+ command.request_object = google_cloud_dataplex_v1_encryption_config_object
82
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
83
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
84
+ command.params['parent'] = parent unless parent.nil?
85
+ command.query['encryptionConfigId'] = encryption_config_id unless encryption_config_id.nil?
86
+ command.query['fields'] = fields unless fields.nil?
87
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
88
+ execute_or_queue_command(command, &block)
89
+ end
90
+
91
+ # Delete an EncryptionConfig.
92
+ # @param [String] name
93
+ # Required. The name of the EncryptionConfig to delete.
94
+ # @param [String] etag
95
+ # Optional. Etag of the EncryptionConfig. This is a strong etag.
96
+ # @param [String] fields
97
+ # Selector specifying which fields to include in a partial response.
98
+ # @param [String] quota_user
99
+ # Available to use for quota purposes for server-side applications. Can be any
100
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
101
+ # @param [Google::Apis::RequestOptions] options
102
+ # Request-specific options
103
+ #
104
+ # @yield [result, err] Result & error if block supplied
105
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
106
+ # @yieldparam err [StandardError] error object if request failed
107
+ #
108
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
109
+ #
110
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
111
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
112
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
113
+ def delete_organization_location_encryption_config(name, etag: nil, fields: nil, quota_user: nil, options: nil, &block)
114
+ command = make_simple_command(:delete, 'v1/{+name}', options)
115
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
116
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
117
+ command.params['name'] = name unless name.nil?
118
+ command.query['etag'] = etag unless etag.nil?
119
+ command.query['fields'] = fields unless fields.nil?
120
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
121
+ execute_or_queue_command(command, &block)
122
+ end
123
+
124
+ # Get an EncryptionConfig.
125
+ # @param [String] name
126
+ # Required. The name of the EncryptionConfig to fetch.
127
+ # @param [String] fields
128
+ # Selector specifying which fields to include in a partial response.
129
+ # @param [String] quota_user
130
+ # Available to use for quota purposes for server-side applications. Can be any
131
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
132
+ # @param [Google::Apis::RequestOptions] options
133
+ # Request-specific options
134
+ #
135
+ # @yield [result, err] Result & error if block supplied
136
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1EncryptionConfig] parsed result object
137
+ # @yieldparam err [StandardError] error object if request failed
138
+ #
139
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1EncryptionConfig]
140
+ #
141
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
142
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
143
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
144
+ def get_organization_location_encryption_config(name, fields: nil, quota_user: nil, options: nil, &block)
145
+ command = make_simple_command(:get, 'v1/{+name}', options)
146
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1EncryptionConfig::Representation
147
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1EncryptionConfig
148
+ command.params['name'] = name unless name.nil?
149
+ command.query['fields'] = fields unless fields.nil?
150
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
151
+ execute_or_queue_command(command, &block)
152
+ end
153
+
54
154
  # Gets the access control policy for a resource. Returns an empty policy if the
55
155
  # resource exists and does not have a policy set.
56
156
  # @param [String] resource
@@ -96,6 +196,102 @@ module Google
96
196
  execute_or_queue_command(command, &block)
97
197
  end
98
198
 
199
+ # List EncryptionConfigs.
200
+ # @param [String] parent
201
+ # Required. The location for which the EncryptionConfig is to be listed.
202
+ # @param [String] filter
203
+ # Optional. Filter the EncryptionConfigs to be returned. Using bare literals: (
204
+ # These values will be matched anywhere it may appear in the object's field
205
+ # values) * filter=some_value Using fields: (These values will be matched only
206
+ # in the specified field) * filter=some_field=some_value Supported fields: *
207
+ # name, key, create_time, update_time, encryption_state Example: * filter=name=
208
+ # organizations/123/locations/us-central1/encryptionConfigs/test-config
209
+ # conjunctions: (AND, OR, NOT) * filter=name=organizations/123/locations/us-
210
+ # central1/encryptionConfigs/test-config AND mode=CMEK logical operators: (>, <,
211
+ # >=, <=, !=, =, :), * filter=create_time>2024-05-01T00:00:00.000Z
212
+ # @param [String] order_by
213
+ # Optional. Order by fields for the result.
214
+ # @param [Fixnum] page_size
215
+ # Optional. Maximum number of EncryptionConfigs to return. The service may
216
+ # return fewer than this value. If unspecified, at most 10 EncryptionConfigs
217
+ # will be returned. The maximum value is 1000; values above 1000 will be coerced
218
+ # to 1000.
219
+ # @param [String] page_token
220
+ # Optional. Page token received from a previous ListEncryptionConfigs call.
221
+ # Provide this to retrieve the subsequent page. When paginating, the parameters -
222
+ # filter and order_by provided to ListEncryptionConfigs must match the call
223
+ # that provided the page token.
224
+ # @param [String] fields
225
+ # Selector specifying which fields to include in a partial response.
226
+ # @param [String] quota_user
227
+ # Available to use for quota purposes for server-side applications. Can be any
228
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
229
+ # @param [Google::Apis::RequestOptions] options
230
+ # Request-specific options
231
+ #
232
+ # @yield [result, err] Result & error if block supplied
233
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEncryptionConfigsResponse] parsed result object
234
+ # @yieldparam err [StandardError] error object if request failed
235
+ #
236
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEncryptionConfigsResponse]
237
+ #
238
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
239
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
240
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
241
+ def list_organization_location_encryption_configs(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
242
+ command = make_simple_command(:get, 'v1/{+parent}/encryptionConfigs', options)
243
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEncryptionConfigsResponse::Representation
244
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListEncryptionConfigsResponse
245
+ command.params['parent'] = parent unless parent.nil?
246
+ command.query['filter'] = filter unless filter.nil?
247
+ command.query['orderBy'] = order_by unless order_by.nil?
248
+ command.query['pageSize'] = page_size unless page_size.nil?
249
+ command.query['pageToken'] = page_token unless page_token.nil?
250
+ command.query['fields'] = fields unless fields.nil?
251
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
252
+ execute_or_queue_command(command, &block)
253
+ end
254
+
255
+ # Update an EncryptionConfig.
256
+ # @param [String] name
257
+ # Identifier. The resource name of the EncryptionConfig. Format: organizations/`
258
+ # organization`/locations/`location`/encryptionConfigs/`encryption_config`
259
+ # Global location is not supported.
260
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1EncryptionConfig] google_cloud_dataplex_v1_encryption_config_object
261
+ # @param [String] update_mask
262
+ # Optional. Mask of fields to update. The service treats an omitted field mask
263
+ # as an implied field mask equivalent to all fields that are populated (have a
264
+ # non-empty value).
265
+ # @param [String] fields
266
+ # Selector specifying which fields to include in a partial response.
267
+ # @param [String] quota_user
268
+ # Available to use for quota purposes for server-side applications. Can be any
269
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
270
+ # @param [Google::Apis::RequestOptions] options
271
+ # Request-specific options
272
+ #
273
+ # @yield [result, err] Result & error if block supplied
274
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
275
+ # @yieldparam err [StandardError] error object if request failed
276
+ #
277
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
278
+ #
279
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
280
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
281
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
282
+ def patch_organization_location_encryption_config(name, google_cloud_dataplex_v1_encryption_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
283
+ command = make_simple_command(:patch, 'v1/{+name}', options)
284
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1EncryptionConfig::Representation
285
+ command.request_object = google_cloud_dataplex_v1_encryption_config_object
286
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
287
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
288
+ command.params['name'] = name unless name.nil?
289
+ command.query['updateMask'] = update_mask unless update_mask.nil?
290
+ command.query['fields'] = fields unless fields.nil?
291
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
292
+ execute_or_queue_command(command, &block)
293
+ end
294
+
99
295
  # Sets the access control policy on the specified resource. Replaces any
100
296
  # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
101
297
  # errors.
@@ -442,7 +638,7 @@ module Google
442
638
  # Searches for Entries matching the given query and scope.
443
639
  # @param [String] name
444
640
  # Required. The project to which the request should be attributed in the
445
- # following form: projects/`project`/locations/`location`.
641
+ # following form: projects/`project`/locations/global.
446
642
  # @param [String] order_by
447
643
  # Optional. Specifies the ordering of results. Supported values are: relevance (
448
644
  # default) last_modified_timestamp last_modified_timestamp asc
@@ -461,6 +657,8 @@ module Google
461
657
  # Optional. The scope under which the search should be operating. It must either
462
658
  # be organizations/ or projects/. If it is unspecified, it defaults to the
463
659
  # organization where the project provided in name is located.
660
+ # @param [Boolean] semantic_search
661
+ # Optional. Internal only.
464
662
  # @param [String] fields
465
663
  # Selector specifying which fields to include in a partial response.
466
664
  # @param [String] quota_user
@@ -478,7 +676,7 @@ module Google
478
676
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
479
677
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
480
678
  # @raise [Google::Apis::AuthorizationError] Authorization is required
481
- def search_project_location_entries(name, order_by: nil, page_size: nil, page_token: nil, query: nil, scope: nil, fields: nil, quota_user: nil, options: nil, &block)
679
+ def search_project_location_entries(name, order_by: nil, page_size: nil, page_token: nil, query: nil, scope: nil, semantic_search: nil, fields: nil, quota_user: nil, options: nil, &block)
482
680
  command = make_simple_command(:post, 'v1/{+name}:searchEntries', options)
483
681
  command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1SearchEntriesResponse::Representation
484
682
  command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1SearchEntriesResponse
@@ -488,6 +686,7 @@ module Google
488
686
  command.query['pageToken'] = page_token unless page_token.nil?
489
687
  command.query['query'] = query unless query.nil?
490
688
  command.query['scope'] = scope unless scope.nil?
689
+ command.query['semanticSearch'] = semantic_search unless semantic_search.nil?
491
690
  command.query['fields'] = fields unless fields.nil?
492
691
  command.query['quotaUser'] = quota_user unless quota_user.nil?
493
692
  execute_or_queue_command(command, &block)
@@ -2869,6 +3068,109 @@ module Google
2869
3068
  execute_or_queue_command(command, &block)
2870
3069
  end
2871
3070
 
3071
+ # Creates an Entry Link.
3072
+ # @param [String] parent
3073
+ # Required. The resource name of the parent Entry Group: projects/`
3074
+ # project_id_or_number`/locations/`location_id`/entryGroups/`entry_group_id`.
3075
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryLink] google_cloud_dataplex_v1_entry_link_object
3076
+ # @param [String] entry_link_id
3077
+ # Required. Entry Link identifier * Must contain only lowercase letters, numbers
3078
+ # and hyphens. * Must start with a letter. * Must be between 1-63 characters. *
3079
+ # Must end with a number or a letter. * Must be unique within the EntryGroup.
3080
+ # @param [String] fields
3081
+ # Selector specifying which fields to include in a partial response.
3082
+ # @param [String] quota_user
3083
+ # Available to use for quota purposes for server-side applications. Can be any
3084
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3085
+ # @param [Google::Apis::RequestOptions] options
3086
+ # Request-specific options
3087
+ #
3088
+ # @yield [result, err] Result & error if block supplied
3089
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryLink] parsed result object
3090
+ # @yieldparam err [StandardError] error object if request failed
3091
+ #
3092
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryLink]
3093
+ #
3094
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3095
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3096
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3097
+ def create_project_location_entry_group_entry_link(parent, google_cloud_dataplex_v1_entry_link_object = nil, entry_link_id: nil, fields: nil, quota_user: nil, options: nil, &block)
3098
+ command = make_simple_command(:post, 'v1/{+parent}/entryLinks', options)
3099
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryLink::Representation
3100
+ command.request_object = google_cloud_dataplex_v1_entry_link_object
3101
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryLink::Representation
3102
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryLink
3103
+ command.params['parent'] = parent unless parent.nil?
3104
+ command.query['entryLinkId'] = entry_link_id unless entry_link_id.nil?
3105
+ command.query['fields'] = fields unless fields.nil?
3106
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3107
+ execute_or_queue_command(command, &block)
3108
+ end
3109
+
3110
+ # Deletes an Entry Link.
3111
+ # @param [String] name
3112
+ # Required. The resource name of the Entry Link: projects/`project_id_or_number`/
3113
+ # locations/`location_id`/entryGroups/`entry_group_id`/entryLinks/`entry_link_id`
3114
+ # .
3115
+ # @param [String] fields
3116
+ # Selector specifying which fields to include in a partial response.
3117
+ # @param [String] quota_user
3118
+ # Available to use for quota purposes for server-side applications. Can be any
3119
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3120
+ # @param [Google::Apis::RequestOptions] options
3121
+ # Request-specific options
3122
+ #
3123
+ # @yield [result, err] Result & error if block supplied
3124
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryLink] parsed result object
3125
+ # @yieldparam err [StandardError] error object if request failed
3126
+ #
3127
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryLink]
3128
+ #
3129
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3130
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3131
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3132
+ def delete_project_location_entry_group_entry_link(name, fields: nil, quota_user: nil, options: nil, &block)
3133
+ command = make_simple_command(:delete, 'v1/{+name}', options)
3134
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryLink::Representation
3135
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryLink
3136
+ command.params['name'] = name unless name.nil?
3137
+ command.query['fields'] = fields unless fields.nil?
3138
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3139
+ execute_or_queue_command(command, &block)
3140
+ end
3141
+
3142
+ # Gets an Entry Link.
3143
+ # @param [String] name
3144
+ # Required. The resource name of the Entry Link: projects/`project_id_or_number`/
3145
+ # locations/`location_id`/entryGroups/`entry_group_id`/entryLinks/`entry_link_id`
3146
+ # .
3147
+ # @param [String] fields
3148
+ # Selector specifying which fields to include in a partial response.
3149
+ # @param [String] quota_user
3150
+ # Available to use for quota purposes for server-side applications. Can be any
3151
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3152
+ # @param [Google::Apis::RequestOptions] options
3153
+ # Request-specific options
3154
+ #
3155
+ # @yield [result, err] Result & error if block supplied
3156
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryLink] parsed result object
3157
+ # @yieldparam err [StandardError] error object if request failed
3158
+ #
3159
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryLink]
3160
+ #
3161
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3162
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3163
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3164
+ def get_project_location_entry_group_entry_link(name, fields: nil, quota_user: nil, options: nil, &block)
3165
+ command = make_simple_command(:get, 'v1/{+name}', options)
3166
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryLink::Representation
3167
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1EntryLink
3168
+ command.params['name'] = name unless name.nil?
3169
+ command.query['fields'] = fields unless fields.nil?
3170
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3171
+ execute_or_queue_command(command, &block)
3172
+ end
3173
+
2872
3174
  # Gets the access control policy for a resource. Returns an empty policy if the
2873
3175
  # resource exists and does not have a policy set.
2874
3176
  # @param [String] resource
@@ -3312,23 +3614,17 @@ module Google
3312
3614
  execute_or_queue_command(command, &block)
3313
3615
  end
3314
3616
 
3315
- # Gets the access control policy for a resource. Returns an empty policy if the
3316
- # resource exists and does not have a policy set.
3317
- # @param [String] resource
3318
- # REQUIRED: The resource for which the policy is being requested. See Resource
3319
- # names (https://cloud.google.com/apis/design/resource_names) for the
3320
- # appropriate value for this field.
3321
- # @param [Fixnum] options_requested_policy_version
3322
- # Optional. The maximum policy version that will be used to format the policy.
3323
- # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
3324
- # rejected.Requests for policies with any conditional role bindings must specify
3325
- # version 3. Policies with no conditional role bindings may specify any valid
3326
- # value or leave the field unset.The policy in the response might use the policy
3327
- # version that you specified, or it might use a lower policy version. For
3328
- # example, if you specify version 3, but the policy has no conditional role
3329
- # bindings, the response uses version 1.To learn which resources support
3330
- # conditions in their IAM policies, see the IAM documentation (https://cloud.
3331
- # google.com/iam/help/conditions/resource-policies).
3617
+ # Creates a new Glossary resource.
3618
+ # @param [String] parent
3619
+ # Required. The parent resource where this Glossary will be created. Format:
3620
+ # projects/`projectId`/locations/`locationId` where locationId refers to a GCP
3621
+ # region.
3622
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Glossary] google_cloud_dataplex_v1_glossary_object
3623
+ # @param [String] glossary_id
3624
+ # Required. Glossary ID: Glossary identifier.
3625
+ # @param [Boolean] validate_only
3626
+ # Optional. Validates the request without actually creating the glossary.
3627
+ # Default: false.
3332
3628
  # @param [String] fields
3333
3629
  # Selector specifying which fields to include in a partial response.
3334
3630
  # @param [String] quota_user
@@ -3338,33 +3634,37 @@ module Google
3338
3634
  # Request-specific options
3339
3635
  #
3340
3636
  # @yield [result, err] Result & error if block supplied
3341
- # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
3637
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
3342
3638
  # @yieldparam err [StandardError] error object if request failed
3343
3639
  #
3344
- # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
3640
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
3345
3641
  #
3346
3642
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3347
3643
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3348
3644
  # @raise [Google::Apis::AuthorizationError] Authorization is required
3349
- def get_project_location_glossary_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
3350
- command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
3351
- command.response_representation = Google::Apis::DataplexV1::GoogleIamV1Policy::Representation
3352
- command.response_class = Google::Apis::DataplexV1::GoogleIamV1Policy
3353
- command.params['resource'] = resource unless resource.nil?
3354
- command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
3645
+ def create_project_location_glossary(parent, google_cloud_dataplex_v1_glossary_object = nil, glossary_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
3646
+ command = make_simple_command(:post, 'v1/{+parent}/glossaries', options)
3647
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Glossary::Representation
3648
+ command.request_object = google_cloud_dataplex_v1_glossary_object
3649
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
3650
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
3651
+ command.params['parent'] = parent unless parent.nil?
3652
+ command.query['glossaryId'] = glossary_id unless glossary_id.nil?
3653
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
3355
3654
  command.query['fields'] = fields unless fields.nil?
3356
3655
  command.query['quotaUser'] = quota_user unless quota_user.nil?
3357
3656
  execute_or_queue_command(command, &block)
3358
3657
  end
3359
3658
 
3360
- # Sets the access control policy on the specified resource. Replaces any
3361
- # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
3362
- # errors.
3363
- # @param [String] resource
3364
- # REQUIRED: The resource for which the policy is being specified. See Resource
3365
- # names (https://cloud.google.com/apis/design/resource_names) for the
3366
- # appropriate value for this field.
3367
- # @param [Google::Apis::DataplexV1::GoogleIamV1SetIamPolicyRequest] google_iam_v1_set_iam_policy_request_object
3659
+ # Deletes a Glossary resource. All the categories and terms within the glossary
3660
+ # must be deleted before a glossary can be deleted.
3661
+ # @param [String] name
3662
+ # Required. The name of the Glossary to delete. Format: projects/`project`/
3663
+ # locations/`location`/glossary/`glossary`
3664
+ # @param [String] etag
3665
+ # Optional. The etag of the Glossary. If this is provided, it must match the
3666
+ # server's etag. If the etag is provided and does not match the server-computed
3667
+ # etag, the request must fail with a ABORTED error code.
3368
3668
  # @param [String] fields
3369
3669
  # Selector specifying which fields to include in a partial response.
3370
3670
  # @param [String] quota_user
@@ -3374,10 +3674,213 @@ module Google
3374
3674
  # Request-specific options
3375
3675
  #
3376
3676
  # @yield [result, err] Result & error if block supplied
3377
- # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
3677
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
3378
3678
  # @yieldparam err [StandardError] error object if request failed
3379
3679
  #
3380
- # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
3680
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
3681
+ #
3682
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3683
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3684
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3685
+ def delete_project_location_glossary(name, etag: nil, fields: nil, quota_user: nil, options: nil, &block)
3686
+ command = make_simple_command(:delete, 'v1/{+name}', options)
3687
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
3688
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
3689
+ command.params['name'] = name unless name.nil?
3690
+ command.query['etag'] = etag unless etag.nil?
3691
+ command.query['fields'] = fields unless fields.nil?
3692
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3693
+ execute_or_queue_command(command, &block)
3694
+ end
3695
+
3696
+ # Retrieves a specified Glossary resource.
3697
+ # @param [String] name
3698
+ # Required. The name of the Glossary to retrieve. Format: projects/`project`/
3699
+ # locations/`location`/glossaries/`glossary`
3700
+ # @param [String] fields
3701
+ # Selector specifying which fields to include in a partial response.
3702
+ # @param [String] quota_user
3703
+ # Available to use for quota purposes for server-side applications. Can be any
3704
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3705
+ # @param [Google::Apis::RequestOptions] options
3706
+ # Request-specific options
3707
+ #
3708
+ # @yield [result, err] Result & error if block supplied
3709
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1Glossary] parsed result object
3710
+ # @yieldparam err [StandardError] error object if request failed
3711
+ #
3712
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1Glossary]
3713
+ #
3714
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3715
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3716
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3717
+ def get_project_location_glossary(name, fields: nil, quota_user: nil, options: nil, &block)
3718
+ command = make_simple_command(:get, 'v1/{+name}', options)
3719
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Glossary::Representation
3720
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1Glossary
3721
+ command.params['name'] = name unless name.nil?
3722
+ command.query['fields'] = fields unless fields.nil?
3723
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3724
+ execute_or_queue_command(command, &block)
3725
+ end
3726
+
3727
+ # Gets the access control policy for a resource. Returns an empty policy if the
3728
+ # resource exists and does not have a policy set.
3729
+ # @param [String] resource
3730
+ # REQUIRED: The resource for which the policy is being requested. See Resource
3731
+ # names (https://cloud.google.com/apis/design/resource_names) for the
3732
+ # appropriate value for this field.
3733
+ # @param [Fixnum] options_requested_policy_version
3734
+ # Optional. The maximum policy version that will be used to format the policy.
3735
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
3736
+ # rejected.Requests for policies with any conditional role bindings must specify
3737
+ # version 3. Policies with no conditional role bindings may specify any valid
3738
+ # value or leave the field unset.The policy in the response might use the policy
3739
+ # version that you specified, or it might use a lower policy version. For
3740
+ # example, if you specify version 3, but the policy has no conditional role
3741
+ # bindings, the response uses version 1.To learn which resources support
3742
+ # conditions in their IAM policies, see the IAM documentation (https://cloud.
3743
+ # google.com/iam/help/conditions/resource-policies).
3744
+ # @param [String] fields
3745
+ # Selector specifying which fields to include in a partial response.
3746
+ # @param [String] quota_user
3747
+ # Available to use for quota purposes for server-side applications. Can be any
3748
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3749
+ # @param [Google::Apis::RequestOptions] options
3750
+ # Request-specific options
3751
+ #
3752
+ # @yield [result, err] Result & error if block supplied
3753
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
3754
+ # @yieldparam err [StandardError] error object if request failed
3755
+ #
3756
+ # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
3757
+ #
3758
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3759
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3760
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3761
+ def get_project_location_glossary_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
3762
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
3763
+ command.response_representation = Google::Apis::DataplexV1::GoogleIamV1Policy::Representation
3764
+ command.response_class = Google::Apis::DataplexV1::GoogleIamV1Policy
3765
+ command.params['resource'] = resource unless resource.nil?
3766
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
3767
+ command.query['fields'] = fields unless fields.nil?
3768
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3769
+ execute_or_queue_command(command, &block)
3770
+ end
3771
+
3772
+ # Lists Glossary resources in a project and location.
3773
+ # @param [String] parent
3774
+ # Required. The parent, which has this collection of glossaries. Format:
3775
+ # projects/`project`/locations/`location` Location is the GCP region.
3776
+ # @param [String] filter
3777
+ # Optional. Filter expression that filters glossaries listed in the response.
3778
+ # Initially, no filter is supported.
3779
+ # @param [String] order_by
3780
+ # Optional. Order by expression that orders glossaries listed in the response.
3781
+ # Order by fields are: name or create_time for the result. If not specified, the
3782
+ # ordering is undefined.
3783
+ # @param [Fixnum] page_size
3784
+ # Optional. The maximum number of glossaries to return. The service may return
3785
+ # fewer than this value. If unspecified, at most 50 glossaries will be returned.
3786
+ # The maximum value is 1000; values above 1000 will be coerced to 1000.
3787
+ # @param [String] page_token
3788
+ # Optional. A page token, received from a previous ListGlossaries call. Provide
3789
+ # this to retrieve the subsequent page. When paginating, all other parameters
3790
+ # provided to ListGlossaries must match the call that provided the page token.
3791
+ # @param [String] fields
3792
+ # Selector specifying which fields to include in a partial response.
3793
+ # @param [String] quota_user
3794
+ # Available to use for quota purposes for server-side applications. Can be any
3795
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3796
+ # @param [Google::Apis::RequestOptions] options
3797
+ # Request-specific options
3798
+ #
3799
+ # @yield [result, err] Result & error if block supplied
3800
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListGlossariesResponse] parsed result object
3801
+ # @yieldparam err [StandardError] error object if request failed
3802
+ #
3803
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListGlossariesResponse]
3804
+ #
3805
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3806
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3807
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3808
+ def list_project_location_glossaries(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3809
+ command = make_simple_command(:get, 'v1/{+parent}/glossaries', options)
3810
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListGlossariesResponse::Representation
3811
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListGlossariesResponse
3812
+ command.params['parent'] = parent unless parent.nil?
3813
+ command.query['filter'] = filter unless filter.nil?
3814
+ command.query['orderBy'] = order_by unless order_by.nil?
3815
+ command.query['pageSize'] = page_size unless page_size.nil?
3816
+ command.query['pageToken'] = page_token unless page_token.nil?
3817
+ command.query['fields'] = fields unless fields.nil?
3818
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3819
+ execute_or_queue_command(command, &block)
3820
+ end
3821
+
3822
+ # Updates a Glossary resource.
3823
+ # @param [String] name
3824
+ # Output only. Identifier. The resource name of the Glossary. Format: projects/`
3825
+ # projectId`/locations/`locationId`/glossaries/`glossaryId`
3826
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1Glossary] google_cloud_dataplex_v1_glossary_object
3827
+ # @param [String] update_mask
3828
+ # Required. The list of fields to update.
3829
+ # @param [Boolean] validate_only
3830
+ # Optional. Validates the request without actually updating the glossary.
3831
+ # Default: false.
3832
+ # @param [String] fields
3833
+ # Selector specifying which fields to include in a partial response.
3834
+ # @param [String] quota_user
3835
+ # Available to use for quota purposes for server-side applications. Can be any
3836
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3837
+ # @param [Google::Apis::RequestOptions] options
3838
+ # Request-specific options
3839
+ #
3840
+ # @yield [result, err] Result & error if block supplied
3841
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleLongrunningOperation] parsed result object
3842
+ # @yieldparam err [StandardError] error object if request failed
3843
+ #
3844
+ # @return [Google::Apis::DataplexV1::GoogleLongrunningOperation]
3845
+ #
3846
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3847
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3848
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3849
+ def patch_project_location_glossary(name, google_cloud_dataplex_v1_glossary_object = nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
3850
+ command = make_simple_command(:patch, 'v1/{+name}', options)
3851
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1Glossary::Representation
3852
+ command.request_object = google_cloud_dataplex_v1_glossary_object
3853
+ command.response_representation = Google::Apis::DataplexV1::GoogleLongrunningOperation::Representation
3854
+ command.response_class = Google::Apis::DataplexV1::GoogleLongrunningOperation
3855
+ command.params['name'] = name unless name.nil?
3856
+ command.query['updateMask'] = update_mask unless update_mask.nil?
3857
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
3858
+ command.query['fields'] = fields unless fields.nil?
3859
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3860
+ execute_or_queue_command(command, &block)
3861
+ end
3862
+
3863
+ # Sets the access control policy on the specified resource. Replaces any
3864
+ # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
3865
+ # errors.
3866
+ # @param [String] resource
3867
+ # REQUIRED: The resource for which the policy is being specified. See Resource
3868
+ # names (https://cloud.google.com/apis/design/resource_names) for the
3869
+ # appropriate value for this field.
3870
+ # @param [Google::Apis::DataplexV1::GoogleIamV1SetIamPolicyRequest] google_iam_v1_set_iam_policy_request_object
3871
+ # @param [String] fields
3872
+ # Selector specifying which fields to include in a partial response.
3873
+ # @param [String] quota_user
3874
+ # Available to use for quota purposes for server-side applications. Can be any
3875
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3876
+ # @param [Google::Apis::RequestOptions] options
3877
+ # Request-specific options
3878
+ #
3879
+ # @yield [result, err] Result & error if block supplied
3880
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleIamV1Policy] parsed result object
3881
+ # @yieldparam err [StandardError] error object if request failed
3882
+ #
3883
+ # @return [Google::Apis::DataplexV1::GoogleIamV1Policy]
3381
3884
  #
3382
3885
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3383
3886
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
@@ -3433,6 +3936,111 @@ module Google
3433
3936
  execute_or_queue_command(command, &block)
3434
3937
  end
3435
3938
 
3939
+ # GlossaryCategory APIs are CCFE passthrough APIs. Creates a new
3940
+ # GlossaryCategory resource.
3941
+ # @param [String] parent
3942
+ # Required. The parent resource where this GlossaryCategory will be created.
3943
+ # Format: projects/`projectId`/locations/`locationId`/glossaries/`glossaryId`
3944
+ # where locationId refers to a GCP region.
3945
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory] google_cloud_dataplex_v1_glossary_category_object
3946
+ # @param [String] category_id
3947
+ # Required. Category ID: GlossaryCategory identifier.
3948
+ # @param [String] fields
3949
+ # Selector specifying which fields to include in a partial response.
3950
+ # @param [String] quota_user
3951
+ # Available to use for quota purposes for server-side applications. Can be any
3952
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3953
+ # @param [Google::Apis::RequestOptions] options
3954
+ # Request-specific options
3955
+ #
3956
+ # @yield [result, err] Result & error if block supplied
3957
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory] parsed result object
3958
+ # @yieldparam err [StandardError] error object if request failed
3959
+ #
3960
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory]
3961
+ #
3962
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3963
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3964
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3965
+ def create_project_location_glossary_category(parent, google_cloud_dataplex_v1_glossary_category_object = nil, category_id: nil, fields: nil, quota_user: nil, options: nil, &block)
3966
+ command = make_simple_command(:post, 'v1/{+parent}/categories', options)
3967
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory::Representation
3968
+ command.request_object = google_cloud_dataplex_v1_glossary_category_object
3969
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory::Representation
3970
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory
3971
+ command.params['parent'] = parent unless parent.nil?
3972
+ command.query['categoryId'] = category_id unless category_id.nil?
3973
+ command.query['fields'] = fields unless fields.nil?
3974
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3975
+ execute_or_queue_command(command, &block)
3976
+ end
3977
+
3978
+ # Deletes a GlossaryCategory resource. All the categories and terms nested
3979
+ # directly under the category will be moved one level up to the parent in the
3980
+ # hierarchy.
3981
+ # @param [String] name
3982
+ # Required. The name of the GlossaryCategory to delete. Format: projects/`
3983
+ # project`/locations/`location`/glossary/`glossary`/categories/`
3984
+ # glossary_category`
3985
+ # @param [String] fields
3986
+ # Selector specifying which fields to include in a partial response.
3987
+ # @param [String] quota_user
3988
+ # Available to use for quota purposes for server-side applications. Can be any
3989
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3990
+ # @param [Google::Apis::RequestOptions] options
3991
+ # Request-specific options
3992
+ #
3993
+ # @yield [result, err] Result & error if block supplied
3994
+ # @yieldparam result [Google::Apis::DataplexV1::Empty] parsed result object
3995
+ # @yieldparam err [StandardError] error object if request failed
3996
+ #
3997
+ # @return [Google::Apis::DataplexV1::Empty]
3998
+ #
3999
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4000
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4001
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4002
+ def delete_project_location_glossary_category(name, fields: nil, quota_user: nil, options: nil, &block)
4003
+ command = make_simple_command(:delete, 'v1/{+name}', options)
4004
+ command.response_representation = Google::Apis::DataplexV1::Empty::Representation
4005
+ command.response_class = Google::Apis::DataplexV1::Empty
4006
+ command.params['name'] = name unless name.nil?
4007
+ command.query['fields'] = fields unless fields.nil?
4008
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4009
+ execute_or_queue_command(command, &block)
4010
+ end
4011
+
4012
+ # Retrieves a specified GlossaryCategory resource.
4013
+ # @param [String] name
4014
+ # Required. The name of the GlossaryCategory to retrieve. Format: projects/`
4015
+ # project`/locations/`location`/glossaries/`glossary`/categories/`
4016
+ # glossary_category`
4017
+ # @param [String] fields
4018
+ # Selector specifying which fields to include in a partial response.
4019
+ # @param [String] quota_user
4020
+ # Available to use for quota purposes for server-side applications. Can be any
4021
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4022
+ # @param [Google::Apis::RequestOptions] options
4023
+ # Request-specific options
4024
+ #
4025
+ # @yield [result, err] Result & error if block supplied
4026
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory] parsed result object
4027
+ # @yieldparam err [StandardError] error object if request failed
4028
+ #
4029
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory]
4030
+ #
4031
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4032
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4033
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4034
+ def get_project_location_glossary_category(name, fields: nil, quota_user: nil, options: nil, &block)
4035
+ command = make_simple_command(:get, 'v1/{+name}', options)
4036
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory::Representation
4037
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory
4038
+ command.params['name'] = name unless name.nil?
4039
+ command.query['fields'] = fields unless fields.nil?
4040
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4041
+ execute_or_queue_command(command, &block)
4042
+ end
4043
+
3436
4044
  # Gets the access control policy for a resource. Returns an empty policy if the
3437
4045
  # resource exists and does not have a policy set.
3438
4046
  # @param [String] resource
@@ -3478,6 +4086,99 @@ module Google
3478
4086
  execute_or_queue_command(command, &block)
3479
4087
  end
3480
4088
 
4089
+ # Lists GlossaryCategory resources in a glossary.
4090
+ # @param [String] parent
4091
+ # Required. The parent, which has this collection of categories. Format:
4092
+ # projects/`project`/locations/`location`/glossaries/`glossary` Location is the
4093
+ # GCP region.
4094
+ # @param [String] filter
4095
+ # Optional. Filter expression that filters categories listed in the response.
4096
+ # Filters supported: List GlossaryCategories based on immediate parent in the
4097
+ # resource hierarchy. This will only return the GlossaryCategories nested
4098
+ # directly under the parent and no other subsequent nested categories will be
4099
+ # returned.
4100
+ # @param [String] order_by
4101
+ # Optional. Order by expression that orders categories listed in the response.
4102
+ # Order by fields are: name or create_time for the result. If not specified, the
4103
+ # ordering is undefined.
4104
+ # @param [Fixnum] page_size
4105
+ # Optional. The maximum number of categories to return. The service may return
4106
+ # fewer than this value. If unspecified, at most 50 categories will be returned.
4107
+ # The maximum value is 1000; values above 1000 will be coerced to 1000.
4108
+ # @param [String] page_token
4109
+ # Optional. A page token, received from a previous ListGlossaryCategories call.
4110
+ # Provide this to retrieve the subsequent page. When paginating, all other
4111
+ # parameters provided to ListGlossaryCategories must match the call that
4112
+ # provided the page token.
4113
+ # @param [String] fields
4114
+ # Selector specifying which fields to include in a partial response.
4115
+ # @param [String] quota_user
4116
+ # Available to use for quota purposes for server-side applications. Can be any
4117
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4118
+ # @param [Google::Apis::RequestOptions] options
4119
+ # Request-specific options
4120
+ #
4121
+ # @yield [result, err] Result & error if block supplied
4122
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListGlossaryCategoriesResponse] parsed result object
4123
+ # @yieldparam err [StandardError] error object if request failed
4124
+ #
4125
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListGlossaryCategoriesResponse]
4126
+ #
4127
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4128
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4129
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4130
+ def list_project_location_glossary_categories(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
4131
+ command = make_simple_command(:get, 'v1/{+parent}/categories', options)
4132
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListGlossaryCategoriesResponse::Representation
4133
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListGlossaryCategoriesResponse
4134
+ command.params['parent'] = parent unless parent.nil?
4135
+ command.query['filter'] = filter unless filter.nil?
4136
+ command.query['orderBy'] = order_by unless order_by.nil?
4137
+ command.query['pageSize'] = page_size unless page_size.nil?
4138
+ command.query['pageToken'] = page_token unless page_token.nil?
4139
+ command.query['fields'] = fields unless fields.nil?
4140
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4141
+ execute_or_queue_command(command, &block)
4142
+ end
4143
+
4144
+ # Updates a GlossaryCategory resource.
4145
+ # @param [String] name
4146
+ # Output only. Identifier. The resource name of the GlossaryCategory. Format:
4147
+ # projects/`projectId`/locations/`locationId`/glossaries/`glossaryId`/categories/
4148
+ # `categoryId`
4149
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory] google_cloud_dataplex_v1_glossary_category_object
4150
+ # @param [String] update_mask
4151
+ # Required. The list of fields to update.
4152
+ # @param [String] fields
4153
+ # Selector specifying which fields to include in a partial response.
4154
+ # @param [String] quota_user
4155
+ # Available to use for quota purposes for server-side applications. Can be any
4156
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4157
+ # @param [Google::Apis::RequestOptions] options
4158
+ # Request-specific options
4159
+ #
4160
+ # @yield [result, err] Result & error if block supplied
4161
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory] parsed result object
4162
+ # @yieldparam err [StandardError] error object if request failed
4163
+ #
4164
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory]
4165
+ #
4166
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4167
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4168
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4169
+ def patch_project_location_glossary_category(name, google_cloud_dataplex_v1_glossary_category_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
4170
+ command = make_simple_command(:patch, 'v1/{+name}', options)
4171
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory::Representation
4172
+ command.request_object = google_cloud_dataplex_v1_glossary_category_object
4173
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory::Representation
4174
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryCategory
4175
+ command.params['name'] = name unless name.nil?
4176
+ command.query['updateMask'] = update_mask unless update_mask.nil?
4177
+ command.query['fields'] = fields unless fields.nil?
4178
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4179
+ execute_or_queue_command(command, &block)
4180
+ end
4181
+
3481
4182
  # Sets the access control policy on the specified resource. Replaces any
3482
4183
  # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
3483
4184
  # errors.
@@ -3554,6 +4255,107 @@ module Google
3554
4255
  execute_or_queue_command(command, &block)
3555
4256
  end
3556
4257
 
4258
+ # GlossaryTerm APIs are CCFE passthrough APIs. Creates a new GlossaryTerm
4259
+ # resource.
4260
+ # @param [String] parent
4261
+ # Required. The parent resource where this GlossaryTerm will be created. Format:
4262
+ # projects/`projectId`/locations/`locationId`/glossaries/`glossaryId` where
4263
+ # locationId refers to a GCP region.
4264
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm] google_cloud_dataplex_v1_glossary_term_object
4265
+ # @param [String] term_id
4266
+ # Required. Term ID: GlossaryTerm identifier.
4267
+ # @param [String] fields
4268
+ # Selector specifying which fields to include in a partial response.
4269
+ # @param [String] quota_user
4270
+ # Available to use for quota purposes for server-side applications. Can be any
4271
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4272
+ # @param [Google::Apis::RequestOptions] options
4273
+ # Request-specific options
4274
+ #
4275
+ # @yield [result, err] Result & error if block supplied
4276
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm] parsed result object
4277
+ # @yieldparam err [StandardError] error object if request failed
4278
+ #
4279
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm]
4280
+ #
4281
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4282
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4283
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4284
+ def create_project_location_glossary_term(parent, google_cloud_dataplex_v1_glossary_term_object = nil, term_id: nil, fields: nil, quota_user: nil, options: nil, &block)
4285
+ command = make_simple_command(:post, 'v1/{+parent}/terms', options)
4286
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm::Representation
4287
+ command.request_object = google_cloud_dataplex_v1_glossary_term_object
4288
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm::Representation
4289
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm
4290
+ command.params['parent'] = parent unless parent.nil?
4291
+ command.query['termId'] = term_id unless term_id.nil?
4292
+ command.query['fields'] = fields unless fields.nil?
4293
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4294
+ execute_or_queue_command(command, &block)
4295
+ end
4296
+
4297
+ # Deletes a GlossaryTerm resource.
4298
+ # @param [String] name
4299
+ # Required. The name of the GlossaryTerm to delete. Format: projects/`project`/
4300
+ # locations/`location`/glossary/`glossary`/terms/`glossary_term`
4301
+ # @param [String] fields
4302
+ # Selector specifying which fields to include in a partial response.
4303
+ # @param [String] quota_user
4304
+ # Available to use for quota purposes for server-side applications. Can be any
4305
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4306
+ # @param [Google::Apis::RequestOptions] options
4307
+ # Request-specific options
4308
+ #
4309
+ # @yield [result, err] Result & error if block supplied
4310
+ # @yieldparam result [Google::Apis::DataplexV1::Empty] parsed result object
4311
+ # @yieldparam err [StandardError] error object if request failed
4312
+ #
4313
+ # @return [Google::Apis::DataplexV1::Empty]
4314
+ #
4315
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4316
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4317
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4318
+ def delete_project_location_glossary_term(name, fields: nil, quota_user: nil, options: nil, &block)
4319
+ command = make_simple_command(:delete, 'v1/{+name}', options)
4320
+ command.response_representation = Google::Apis::DataplexV1::Empty::Representation
4321
+ command.response_class = Google::Apis::DataplexV1::Empty
4322
+ command.params['name'] = name unless name.nil?
4323
+ command.query['fields'] = fields unless fields.nil?
4324
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4325
+ execute_or_queue_command(command, &block)
4326
+ end
4327
+
4328
+ # Retrieves a specified GlossaryTerm resource.
4329
+ # @param [String] name
4330
+ # Required. The name of the GlossaryTerm to retrieve. Format: projects/`project`/
4331
+ # locations/`location`/glossaries/`glossary`/terms/`glossary_term`
4332
+ # @param [String] fields
4333
+ # Selector specifying which fields to include in a partial response.
4334
+ # @param [String] quota_user
4335
+ # Available to use for quota purposes for server-side applications. Can be any
4336
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4337
+ # @param [Google::Apis::RequestOptions] options
4338
+ # Request-specific options
4339
+ #
4340
+ # @yield [result, err] Result & error if block supplied
4341
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm] parsed result object
4342
+ # @yieldparam err [StandardError] error object if request failed
4343
+ #
4344
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm]
4345
+ #
4346
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4347
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4348
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4349
+ def get_project_location_glossary_term(name, fields: nil, quota_user: nil, options: nil, &block)
4350
+ command = make_simple_command(:get, 'v1/{+name}', options)
4351
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm::Representation
4352
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm
4353
+ command.params['name'] = name unless name.nil?
4354
+ command.query['fields'] = fields unless fields.nil?
4355
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4356
+ execute_or_queue_command(command, &block)
4357
+ end
4358
+
3557
4359
  # Gets the access control policy for a resource. Returns an empty policy if the
3558
4360
  # resource exists and does not have a policy set.
3559
4361
  # @param [String] resource
@@ -3599,6 +4401,97 @@ module Google
3599
4401
  execute_or_queue_command(command, &block)
3600
4402
  end
3601
4403
 
4404
+ # Lists GlossaryTerm resources in a glossary.
4405
+ # @param [String] parent
4406
+ # Required. The parent, which has this collection of terms. Format: projects/`
4407
+ # project`/locations/`location`/glossaries/`glossary` Location is the GCP region.
4408
+ # @param [String] filter
4409
+ # Optional. Filter expression that filters terms listed in the response. Filters
4410
+ # supported: List GlossaryTerms based on immediate parent in the resource
4411
+ # hierarchy. This will only return the terms nested directly under the parent
4412
+ # and no other subsequent nested terms will be returned.
4413
+ # @param [String] order_by
4414
+ # Optional. Order by expression that orders terms listed in the response. Order
4415
+ # by fields are: name or create_time for the result. If not specified, the
4416
+ # ordering is undefined.
4417
+ # @param [Fixnum] page_size
4418
+ # Optional. The maximum number of terms to return. The service may return fewer
4419
+ # than this value. If unspecified, at most 50 terms will be returned. The
4420
+ # maximum value is 1000; values above 1000 will be coerced to 1000.
4421
+ # @param [String] page_token
4422
+ # Optional. A page token, received from a previous ListGlossaryTerms call.
4423
+ # Provide this to retrieve the subsequent page. When paginating, all other
4424
+ # parameters provided to ListGlossaryTerms must match the call that provided the
4425
+ # page token.
4426
+ # @param [String] fields
4427
+ # Selector specifying which fields to include in a partial response.
4428
+ # @param [String] quota_user
4429
+ # Available to use for quota purposes for server-side applications. Can be any
4430
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4431
+ # @param [Google::Apis::RequestOptions] options
4432
+ # Request-specific options
4433
+ #
4434
+ # @yield [result, err] Result & error if block supplied
4435
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListGlossaryTermsResponse] parsed result object
4436
+ # @yieldparam err [StandardError] error object if request failed
4437
+ #
4438
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1ListGlossaryTermsResponse]
4439
+ #
4440
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4441
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4442
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4443
+ def list_project_location_glossary_terms(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
4444
+ command = make_simple_command(:get, 'v1/{+parent}/terms', options)
4445
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListGlossaryTermsResponse::Representation
4446
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1ListGlossaryTermsResponse
4447
+ command.params['parent'] = parent unless parent.nil?
4448
+ command.query['filter'] = filter unless filter.nil?
4449
+ command.query['orderBy'] = order_by unless order_by.nil?
4450
+ command.query['pageSize'] = page_size unless page_size.nil?
4451
+ command.query['pageToken'] = page_token unless page_token.nil?
4452
+ command.query['fields'] = fields unless fields.nil?
4453
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4454
+ execute_or_queue_command(command, &block)
4455
+ end
4456
+
4457
+ # Updates a GlossaryTerm resource.
4458
+ # @param [String] name
4459
+ # Output only. Identifier. The resource name of the GlossaryTerm. Format:
4460
+ # projects/`projectId`/locations/`locationId`/glossaries/`glossaryId`/terms/`
4461
+ # termId`
4462
+ # @param [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm] google_cloud_dataplex_v1_glossary_term_object
4463
+ # @param [String] update_mask
4464
+ # Required. The list of fields to update.
4465
+ # @param [String] fields
4466
+ # Selector specifying which fields to include in a partial response.
4467
+ # @param [String] quota_user
4468
+ # Available to use for quota purposes for server-side applications. Can be any
4469
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4470
+ # @param [Google::Apis::RequestOptions] options
4471
+ # Request-specific options
4472
+ #
4473
+ # @yield [result, err] Result & error if block supplied
4474
+ # @yieldparam result [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm] parsed result object
4475
+ # @yieldparam err [StandardError] error object if request failed
4476
+ #
4477
+ # @return [Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm]
4478
+ #
4479
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4480
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4481
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4482
+ def patch_project_location_glossary_term(name, google_cloud_dataplex_v1_glossary_term_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
4483
+ command = make_simple_command(:patch, 'v1/{+name}', options)
4484
+ command.request_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm::Representation
4485
+ command.request_object = google_cloud_dataplex_v1_glossary_term_object
4486
+ command.response_representation = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm::Representation
4487
+ command.response_class = Google::Apis::DataplexV1::GoogleCloudDataplexV1GlossaryTerm
4488
+ command.params['name'] = name unless name.nil?
4489
+ command.query['updateMask'] = update_mask unless update_mask.nil?
4490
+ command.query['fields'] = fields unless fields.nil?
4491
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4492
+ execute_or_queue_command(command, &block)
4493
+ end
4494
+
3602
4495
  # Sets the access control policy on the specified resource. Replaces any
3603
4496
  # existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
3604
4497
  # errors.