google-cloud-data_catalog-v1 0.7.1 → 0.8.1

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.
Files changed (34) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +8 -8
  3. data/README.md +1 -1
  4. data/lib/google/cloud/data_catalog/v1/data_catalog.rb +2 -2
  5. data/lib/google/cloud/data_catalog/v1/data_catalog/client.rb +424 -387
  6. data/lib/google/cloud/data_catalog/v1/policy_tag_manager.rb +1 -1
  7. data/lib/google/cloud/data_catalog/v1/policy_tag_manager/client.rb +123 -95
  8. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization.rb +4 -3
  9. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/client.rb +142 -56
  10. data/lib/google/cloud/data_catalog/v1/version.rb +1 -1
  11. data/lib/google/cloud/datacatalog/v1/bigquery_pb.rb +48 -0
  12. data/lib/google/cloud/datacatalog/v1/datacatalog_pb.rb +44 -0
  13. data/lib/google/cloud/datacatalog/v1/datacatalog_services_pb.rb +179 -142
  14. data/lib/google/cloud/datacatalog/v1/policytagmanager_services_pb.rb +15 -14
  15. data/lib/google/cloud/datacatalog/v1/policytagmanagerserialization_pb.rb +5 -0
  16. data/lib/google/cloud/datacatalog/v1/policytagmanagerserialization_services_pb.rb +28 -14
  17. data/lib/google/cloud/datacatalog/v1/tags_pb.rb +3 -0
  18. data/lib/google/cloud/datacatalog/v1/usage_pb.rb +31 -0
  19. data/proto_docs/google/api/field_behavior.rb +7 -1
  20. data/proto_docs/google/cloud/datacatalog/v1/bigquery.rb +87 -0
  21. data/proto_docs/google/cloud/datacatalog/v1/common.rb +1 -2
  22. data/proto_docs/google/cloud/datacatalog/v1/data_source.rb +6 -5
  23. data/proto_docs/google/cloud/datacatalog/v1/datacatalog.rb +370 -246
  24. data/proto_docs/google/cloud/datacatalog/v1/gcs_fileset_spec.rb +16 -15
  25. data/proto_docs/google/cloud/datacatalog/v1/policytagmanager.rb +87 -71
  26. data/proto_docs/google/cloud/datacatalog/v1/policytagmanagerserialization.rb +34 -19
  27. data/proto_docs/google/cloud/datacatalog/v1/schema.rb +3 -3
  28. data/proto_docs/google/cloud/datacatalog/v1/search.rb +43 -29
  29. data/proto_docs/google/cloud/datacatalog/v1/table_spec.rb +23 -16
  30. data/proto_docs/google/cloud/datacatalog/v1/tags.rb +96 -51
  31. data/proto_docs/google/cloud/datacatalog/v1/timestamps.rb +12 -5
  32. data/proto_docs/google/cloud/datacatalog/v1/usage.rb +79 -0
  33. data/proto_docs/google/type/expr.rb +35 -12
  34. metadata +19 -9
data/proto_docs/google/cloud/datacatalog/v1/gcs_fileset_spec.rb CHANGED
@@ -25,17 +25,18 @@ module Google
25
25
  # @!attribute [rw] file_patterns
26
26
  # @return [::Array<::String>]
27
27
  # Required. Patterns to identify a set of files in Google Cloud Storage.
28
- # See [Cloud Storage
29
- # documentation](https://cloud.google.com/storage/docs/gsutil/addlhelp/WildcardNames)
30
- # for more information. Note that bucket wildcards are currently not
31
- # supported.
32
28
  #
33
- # Examples of valid file_patterns:
29
+ # For more information, see [Wildcard Names]
30
+ # (https://cloud.google.com/storage/docs/gsutil/addlhelp/WildcardNames).
34
31
  #
35
- # * `gs://bucket_name/dir/*`: matches all files within `bucket_name/dir`
36
- # directory.
32
+ # Note: Currently, bucket wildcards are not supported.
33
+ #
34
+ # Examples of valid `file_patterns`:
35
+ #
36
+ # * `gs://bucket_name/dir/*`: matches all files in `bucket_name/dir`
37
+ # directory
37
38
  # * `gs://bucket_name/dir/**`: matches all files in `bucket_name/dir`
38
- # spanning all subdirectories.
39
+ # and all subdirectories
39
40
  # * `gs://bucket_name/file*`: matches files prefixed by `file` in
40
41
  # `bucket_name`
41
42
  # * `gs://bucket_name/??.txt`: matches files with two characters followed by
@@ -46,12 +47,12 @@ module Google
46
47
  # * `gs://bucket_name/[a-m].txt`: matches files that contain `a`, `b`, ...
47
48
  # or `m` followed by `.txt` in `bucket_name`
48
49
  # * `gs://bucket_name/a/*/b`: matches all files in `bucket_name` that match
49
- # `a/*/b` pattern, such as `a/c/b`, `a/d/b`
50
+ # the `a/*/b` pattern, such as `a/c/b`, `a/d/b`
50
51
  # * `gs://another_bucket/a.txt`: matches `gs://another_bucket/a.txt`
51
52
  #
52
- # You can combine wildcards to provide more powerful matches, for example:
53
+ # You can combine wildcards to match complex sets of files, for example:
53
54
  #
54
- # * `gs://bucket_name/[a-m]??.j*g`
55
+ # `gs://bucket_name/[a-m]??.j*g`
55
56
  # @!attribute [r] sample_gcs_file_specs
56
57
  # @return [::Array<::Google::Cloud::DataCatalog::V1::GcsFileSpec>]
57
58
  # Output only. Sample files contained in this fileset, not all files
@@ -61,16 +62,16 @@ module Google
61
62
  extend ::Google::Protobuf::MessageExts::ClassMethods
62
63
  end
63
64
 
64
- # Specifications of a single file in Cloud Storage.
65
+ # Specification of a single file in Cloud Storage.
65
66
  # @!attribute [rw] file_path
66
67
  # @return [::String]
67
- # Required. The full file path. Example: `gs://bucket_name/a/b.txt`.
68
+ # Required. Full file path. Example: `gs://bucket_name/a/b.txt`.
68
69
  # @!attribute [r] gcs_timestamps
69
70
  # @return [::Google::Cloud::DataCatalog::V1::SystemTimestamps]
70
- # Output only. Timestamps about the Cloud Storage file.
71
+ # Output only. Creation, modification, and expiration timestamps of a Cloud Storage file.
71
72
  # @!attribute [r] size_bytes
72
73
  # @return [::Integer]
73
- # Output only. The size of the file, in bytes.
74
+ # Output only. File size in bytes.
74
75
  class GcsFileSpec
75
76
  include ::Google::Protobuf::MessageExts
76
77
  extend ::Google::Protobuf::MessageExts::ClassMethods
data/proto_docs/google/cloud/datacatalog/v1/policytagmanager.rb CHANGED
@@ -22,8 +22,10 @@ module Google
22
22
  module DataCatalog
23
23
  module V1
24
24
  # A taxonomy is a collection of hierarchical policy tags that classify data
25
- # along a common axis. For instance a "data sensitivity" taxonomy could contain
26
- # the following policy tags:
25
+ # along a common axis.
26
+ #
27
+ # For example, a "data sensitivity" taxonomy might contain the following policy
28
+ # tags:
27
29
  #
28
30
  # ```
29
31
  # + PII
@@ -35,7 +37,7 @@ module Google
35
37
  # + Revenue
36
38
  # ```
37
39
  #
38
- # A "data origin" taxonomy could contain the following policy tags:
40
+ # A "data origin" taxonomy might contain the following policy tags:
39
41
  #
40
42
  # ```
41
43
  # + User data
@@ -45,25 +47,29 @@ module Google
45
47
  # ```
46
48
  # @!attribute [r] name
47
49
  # @return [::String]
48
- # Output only. Resource name of this taxonomy in format:
49
- # "projects/\\{project_number}/locations/\\{location_id}/taxonomies/\\{taxonomy_id}".
50
- # Note that taxonomy_id's are unique and generated by Policy Tag Manager.
50
+ # Output only. Resource name of this taxonomy in URL format.
51
+ #
52
+ # Note: Policy tag manager generates unique taxonomy IDs.
51
53
  # @!attribute [rw] display_name
52
54
  # @return [::String]
53
- # Required. User-defined name of this taxonomy. It must: contain only unicode letters,
54
- # numbers, underscores, dashes and spaces; not start or end with spaces; and
55
- # be at most 200 bytes long when encoded in UTF-8.
55
+ # Required. User-defined name of this taxonomy.
56
+ #
57
+ # The name can't start or end with spaces, must contain only Unicode letters,
58
+ # numbers, underscores, dashes, and spaces, and be at most 200 bytes long
59
+ # when encoded in UTF-8.
56
60
  # @!attribute [rw] description
57
61
  # @return [::String]
58
- # Optional. Description of this taxonomy. It must: contain only unicode characters,
59
- # tabs, newlines, carriage returns and page breaks; and be at most 2000 bytes
60
- # long when encoded in UTF-8. If not set, defaults to an empty description.
62
+ # Optional. Description of this taxonomy. If not set, defaults to empty.
63
+ #
64
+ # The description must contain only Unicode characters, tabs, newlines,
65
+ # carriage returns, and page breaks, and be at most 2000 bytes long when
66
+ # encoded in UTF-8.
61
67
  # @!attribute [r] policy_tag_count
62
68
  # @return [::Integer]
63
- # Output only. Number of policy tags contained in this taxonomy.
69
+ # Output only. Number of policy tags in this taxonomy.
64
70
  # @!attribute [r] taxonomy_timestamps
65
71
  # @return [::Google::Cloud::DataCatalog::V1::SystemTimestamps]
66
- # Output only. Timestamps about this taxonomy. Only create_time and update_time are used.
72
+ # Output only. Creation and modification timestamps of this taxonomy.
67
73
  # @!attribute [rw] activated_policy_types
68
74
  # @return [::Array<::Google::Cloud::DataCatalog::V1::Taxonomy::PolicyType>]
69
75
  # Optional. A list of policy types that are activated for this taxonomy. If not set,
@@ -77,14 +83,15 @@ module Google
77
83
  # Unspecified policy type.
78
84
  POLICY_TYPE_UNSPECIFIED = 0
79
85
 
80
- # Fine-grained access control policy, which enables access control on
86
+ # Fine-grained access control policy that enables access control on
81
87
  # tagged sub-resources.
82
88
  FINE_GRAINED_ACCESS_CONTROL = 1
83
89
  end
84
90
  end
85
91
 
86
- # Denotes one policy tag in a taxonomy (e.g. ssn). Policy tags can be defined
87
- # in a hierarchy. For example, consider the following hierarchy:
92
+ # Denotes one policy tag in a taxonomy, for example, SSN.
93
+ #
94
+ # Policy tags can be defined in a hierarchy. For example:
88
95
  #
89
96
  # ```
90
97
  # + Geolocation
@@ -93,34 +100,35 @@ module Google
93
100
  # + ZipCode
94
101
  # ```
95
102
  #
96
- # Policy tag "Geolocation" contains 3 child policy tags: "LatLong", "City", and
97
- # "ZipCode".
103
+ # Where the "Geolocation" policy tag contains three children.
98
104
  # @!attribute [r] name
99
105
  # @return [::String]
100
- # Output only. Resource name of this policy tag in format:
101
- # "projects/\\{project_number}/locations/\\{location_id}/taxonomies/\\{taxonomy_id}/policyTags/\\{policy_tag_id}".
102
- # Both taxonomy_ids and policy_tag_ids are unique and generated by Policy Tag
103
- # Manager.
106
+ # Output only. Resource name of this policy tag in the URL format.
107
+ #
108
+ # The policy tag manager generates unique taxonomy IDs and policy tag IDs.<br
109
+ # /><br />
104
110
  # @!attribute [rw] display_name
105
111
  # @return [::String]
106
- # Required. User-defined name of this policy tag. It must: be unique within the parent
107
- # taxonomy; contain only unicode letters, numbers, underscores, dashes and
108
- # spaces; not start or end with spaces; and be at most 200 bytes long when
109
- # encoded in UTF-8.
112
+ # Required. User-defined name of this policy tag.
113
+ #
114
+ # The name can't start or end with spaces and must be unique within the
115
+ # parent taxonomy, contain only Unicode letters, numbers, underscores, dashes
116
+ # and spaces, and be at most 200 bytes long when encoded in UTF-8.
110
117
  # @!attribute [rw] description
111
118
  # @return [::String]
112
- # Description of this policy tag. It must: contain only unicode characters,
113
- # tabs, newlines, carriage returns and page breaks; and be at most 2000 bytes
114
- # long when encoded in UTF-8. If not set, defaults to an empty description.
115
- # If not set, defaults to an empty description.
119
+ # Description of this policy tag. If not set, defaults to empty.
120
+ #
121
+ # The description must contain only Unicode characters,
122
+ # tabs, newlines, carriage returns and page breaks, and be at most 2000 bytes
123
+ # long when encoded in UTF-8.
116
124
  # @!attribute [rw] parent_policy_tag
117
125
  # @return [::String]
118
- # Resource name of this policy tag's parent policy tag (e.g. for the
119
- # "LatLong" policy tag in the example above, this field contains the
120
- # resource name of the "Geolocation" policy tag). If empty, it means this
121
- # policy tag is a top level policy tag (e.g. this field is empty for the
122
- # "Geolocation" policy tag in the example above). If not set, defaults to an
123
- # empty string.
126
+ # Resource name of this policy tag's parent policy tag. If empty, this is a
127
+ # top level tag. If not set, defaults to an empty string.
128
+ #
129
+ # For example, for the "LatLong" policy tag in the example above, this field
130
+ # contains the resource name of the "Geolocation" policy tag, and, for
131
+ # "Geolocation", this field is empty.
124
132
  # @!attribute [r] child_policy_tags
125
133
  # @return [::Array<::String>]
126
134
  # Output only. Resource names of child policy tags of this policy tag.
@@ -136,7 +144,7 @@ module Google
136
144
  # Required. Resource name of the project that the taxonomy will belong to.
137
145
  # @!attribute [rw] taxonomy
138
146
  # @return [::Google::Cloud::DataCatalog::V1::Taxonomy]
139
- # The taxonomy to be created.
147
+ # The taxonomy to create.
140
148
  class CreateTaxonomyRequest
141
149
  include ::Google::Protobuf::MessageExts
142
150
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -146,8 +154,9 @@ module Google
146
154
  # {::Google::Cloud::DataCatalog::V1::PolicyTagManager::Client#delete_taxonomy DeleteTaxonomy}.
147
155
  # @!attribute [rw] name
148
156
  # @return [::String]
149
- # Required. Resource name of the taxonomy to be deleted. All policy tags in
150
- # this taxonomy will also be deleted.
157
+ # Required. Resource name of the taxonomy to delete.
158
+ #
159
+ # Note: All policy tags in this taxonomy are also deleted.
151
160
  class DeleteTaxonomyRequest
152
161
  include ::Google::Protobuf::MessageExts
153
162
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -157,14 +166,15 @@ module Google
157
166
  # {::Google::Cloud::DataCatalog::V1::PolicyTagManager::Client#update_taxonomy UpdateTaxonomy}.
158
167
  # @!attribute [rw] taxonomy
159
168
  # @return [::Google::Cloud::DataCatalog::V1::Taxonomy]
160
- # The taxonomy to update. Only description, display_name, and activated
161
- # policy types can be updated.
169
+ # The taxonomy to update. You can update only its description, display name,
170
+ # and activated policy types.
162
171
  # @!attribute [rw] update_mask
163
172
  # @return [::Google::Protobuf::FieldMask]
164
- # The update mask applies to the resource. For the `FieldMask` definition,
165
- # see
166
- # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
167
- # If not set, defaults to all of the fields that are allowed to update.
173
+ # Specifies fields to update. If not set, defaults to all fields you can
174
+ # update.
175
+ #
176
+ # For more information, see [FieldMask]
177
+ # (https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask).
168
178
  class UpdateTaxonomyRequest
169
179
  include ::Google::Protobuf::MessageExts
170
180
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -177,12 +187,14 @@ module Google
177
187
  # Required. Resource name of the project to list the taxonomies of.
178
188
  # @!attribute [rw] page_size
179
189
  # @return [::Integer]
180
- # The maximum number of items to return. Must be a value between 1 and 1000.
181
- # If not set, defaults to 50.
190
+ # The maximum number of items to return. Must be a value between 1 and 1000
191
+ # inclusively. If not set, defaults to 50.
182
192
  # @!attribute [rw] page_token
183
193
  # @return [::String]
184
- # The next_page_token value returned from a previous list request, if any. If
185
- # not set, defaults to an empty string.
194
+ # The pagination token of the next results page. If not set,
195
+ # the first page is returned.
196
+ #
197
+ # The token is returned in the response to a previous list request.
186
198
  class ListTaxonomiesRequest
187
199
  include ::Google::Protobuf::MessageExts
188
200
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -195,7 +207,7 @@ module Google
195
207
  # Taxonomies that the project contains.
196
208
  # @!attribute [rw] next_page_token
197
209
  # @return [::String]
198
- # Token used to retrieve the next page of results, or empty if there are no
210
+ # Pagination token of the next results page. Empty if there are no
199
211
  # more results in the list.
200
212
  class ListTaxonomiesResponse
201
213
  include ::Google::Protobuf::MessageExts
@@ -206,7 +218,7 @@ module Google
206
218
  # {::Google::Cloud::DataCatalog::V1::PolicyTagManager::Client#get_taxonomy GetTaxonomy}.
207
219
  # @!attribute [rw] name
208
220
  # @return [::String]
209
- # Required. Resource name of the requested taxonomy.
221
+ # Required. Resource name of the taxonomy to get.
210
222
  class GetTaxonomyRequest
211
223
  include ::Google::Protobuf::MessageExts
212
224
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -216,10 +228,11 @@ module Google
216
228
  # {::Google::Cloud::DataCatalog::V1::PolicyTagManager::Client#create_policy_tag CreatePolicyTag}.
217
229
  # @!attribute [rw] parent
218
230
  # @return [::String]
219
- # Required. Resource name of the taxonomy that the policy tag will belong to.
231
+ # Required. Resource name of the taxonomy that the policy tag will belong to.<br /><br
232
+ # />
220
233
  # @!attribute [rw] policy_tag
221
234
  # @return [::Google::Cloud::DataCatalog::V1::PolicyTag]
222
- # The policy tag to be created.
235
+ # The policy tag to create.
223
236
  class CreatePolicyTagRequest
224
237
  include ::Google::Protobuf::MessageExts
225
238
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -229,8 +242,9 @@ module Google
229
242
  # {::Google::Cloud::DataCatalog::V1::PolicyTagManager::Client#delete_policy_tag DeletePolicyTag}.
230
243
  # @!attribute [rw] name
231
244
  # @return [::String]
232
- # Required. Resource name of the policy tag to be deleted. All of its descendant
233
- # policy tags will also be deleted.
245
+ # Required. Resource name of the policy tag to delete.
246
+ #
247
+ # Note: All of its descendant policy tags are also deleted.
234
248
  class DeletePolicyTagRequest
235
249
  include ::Google::Protobuf::MessageExts
236
250
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -240,17 +254,16 @@ module Google
240
254
  # {::Google::Cloud::DataCatalog::V1::PolicyTagManager::Client#update_policy_tag UpdatePolicyTag}.
241
255
  # @!attribute [rw] policy_tag
242
256
  # @return [::Google::Cloud::DataCatalog::V1::PolicyTag]
243
- # The policy tag to update. Only the description, display_name, and
244
- # parent_policy_tag fields can be updated.
257
+ # The policy tag to update. You can update only its description, display
258
+ # name, and parent policy tag fields.
245
259
  # @!attribute [rw] update_mask
246
260
  # @return [::Google::Protobuf::FieldMask]
247
- # The update mask applies to the resource. Only display_name, description and
248
- # parent_policy_tag can be updated and thus can be listed in the mask. If
249
- # update_mask is not provided, all allowed fields (i.e. display_name,
250
- # description and parent) will be updated. For more information including the
251
- # `FieldMask` definition, see
252
- # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
253
- # If not set, defaults to all of the fields that are allowed to update.
261
+ # Specifies the fields to update.
262
+ #
263
+ # You can update only display name, description, and parent policy tag.
264
+ # If not set, defaults to all updatable fields.
265
+ # For more information, see [FieldMask]
266
+ # (https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask).
254
267
  class UpdatePolicyTagRequest
255
268
  include ::Google::Protobuf::MessageExts
256
269
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -263,12 +276,15 @@ module Google
263
276
  # Required. Resource name of the taxonomy to list the policy tags of.
264
277
  # @!attribute [rw] page_size
265
278
  # @return [::Integer]
266
- # The maximum number of items to return. Must be a value between 1 and 1000.
279
+ # The maximum number of items to return. Must be a value between 1 and 1000
280
+ # inclusively.
267
281
  # If not set, defaults to 50.
268
282
  # @!attribute [rw] page_token
269
283
  # @return [::String]
270
- # The next_page_token value returned from a previous List request, if any. If
271
- # not set, defaults to an empty string.
284
+ # The pagination token of the next results page. If not set, returns the
285
+ # first page.
286
+ #
287
+ # The token is returned in the response to a previous list request.
272
288
  class ListPolicyTagsRequest
273
289
  include ::Google::Protobuf::MessageExts
274
290
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -278,10 +294,10 @@ module Google
278
294
  # {::Google::Cloud::DataCatalog::V1::PolicyTagManager::Client#list_policy_tags ListPolicyTags}.
279
295
  # @!attribute [rw] policy_tags
280
296
  # @return [::Array<::Google::Cloud::DataCatalog::V1::PolicyTag>]
281
- # The policy tags that are in the requested taxonomy.
297
+ # The policy tags that belong to the taxonomy.
282
298
  # @!attribute [rw] next_page_token
283
299
  # @return [::String]
284
- # Token used to retrieve the next page of results, or empty if there are no
300
+ # Pagination token of the next results page. Empty if there are no
285
301
  # more results in the list.
286
302
  class ListPolicyTagsResponse
287
303
  include ::Google::Protobuf::MessageExts
@@ -292,7 +308,7 @@ module Google
292
308
  # {::Google::Cloud::DataCatalog::V1::PolicyTagManager::Client#get_policy_tag GetPolicyTag}.
293
309
  # @!attribute [rw] name
294
310
  # @return [::String]
295
- # Required. Resource name of the requested policy tag.
311
+ # Required. Resource name of the policy tag.
296
312
  class GetPolicyTagRequest
297
313
  include ::Google::Protobuf::MessageExts
298
314
  extend ::Google::Protobuf::MessageExts::ClassMethods
data/proto_docs/google/cloud/datacatalog/v1/policytagmanagerserialization.rb CHANGED
@@ -21,15 +21,16 @@ module Google
21
21
  module Cloud
22
22
  module DataCatalog
23
23
  module V1
24
- # Message representing a taxonomy, including its policy tags in hierarchy, as a
25
- # nested proto. Used for taxonomy replacement, import, and export.
24
+ # A nested protocol buffer that represents a taxonomy and the hierarchy of its
25
+ # policy tags. Used for taxonomy replacement, import, and
26
+ # export.
26
27
  # @!attribute [rw] display_name
27
28
  # @return [::String]
28
29
  # Required. Display name of the taxonomy. At most 200 bytes when encoded in UTF-8.
29
30
  # @!attribute [rw] description
30
31
  # @return [::String]
31
- # Description of the serialized taxonomy. At most 2000 bytes when encoded in
32
- # UTF-8. If not set, defaults to an empty description.
32
+ # Description of the serialized taxonomy. At most 2000 bytes when
33
+ # encoded in UTF-8. If not set, defaults to an empty description.
33
34
  # @!attribute [rw] policy_tags
34
35
  # @return [::Array<::Google::Cloud::DataCatalog::V1::SerializedPolicyTag>]
35
36
  # Top level policy tags associated with the taxonomy, if any.
@@ -41,20 +42,21 @@ module Google
41
42
  extend ::Google::Protobuf::MessageExts::ClassMethods
42
43
  end
43
44
 
44
- # Message representing one policy tag, including all its descendant policy
45
- # tags, as a nested proto.
45
+ # A nested protocol buffer that represents a policy tag and all its
46
+ # descendants.
46
47
  # @!attribute [rw] policy_tag
47
48
  # @return [::String]
48
49
  # Resource name of the policy tag.
49
50
  #
50
- # This field will be ignored when calling ImportTaxonomies.
51
+ # This field is ignored when calling `ImportTaxonomies`.
51
52
  # @!attribute [rw] display_name
52
53
  # @return [::String]
53
- # Required. Display name of the policy tag. At most 200 bytes when encoded in UTF-8.
54
+ # Required. Display name of the policy tag. At most 200 bytes when encoded
55
+ # in UTF-8.
54
56
  # @!attribute [rw] description
55
57
  # @return [::String]
56
- # Description of the serialized policy tag. The length of the description is
57
- # limited to 2000 bytes when encoded in UTF-8. If not set, defaults to an
58
+ # Description of the serialized policy tag. At most
59
+ # 2000 bytes when encoded in UTF-8. If not set, defaults to an
58
60
  # empty description.
59
61
  # @!attribute [rw] child_policy_tags
60
62
  # @return [::Array<::Google::Cloud::DataCatalog::V1::SerializedPolicyTag>]
@@ -64,6 +66,19 @@ module Google
64
66
  extend ::Google::Protobuf::MessageExts::ClassMethods
65
67
  end
66
68
 
69
+ # Request message for
70
+ # {::Google::Cloud::DataCatalog::V1::PolicyTagManagerSerialization::Client#replace_taxonomy ReplaceTaxonomy}.
71
+ # @!attribute [rw] name
72
+ # @return [::String]
73
+ # Required. Resource name of the taxonomy to update.
74
+ # @!attribute [rw] serialized_taxonomy
75
+ # @return [::Google::Cloud::DataCatalog::V1::SerializedTaxonomy]
76
+ # Required. Taxonomy to update along with its child policy tags.
77
+ class ReplaceTaxonomyRequest
78
+ include ::Google::Protobuf::MessageExts
79
+ extend ::Google::Protobuf::MessageExts::ClassMethods
80
+ end
81
+
67
82
  # Request message for
68
83
  # {::Google::Cloud::DataCatalog::V1::PolicyTagManagerSerialization::Client#import_taxonomies ImportTaxonomies}.
69
84
  # @!attribute [rw] parent
@@ -71,10 +86,10 @@ module Google
71
86
  # Required. Resource name of project that the imported taxonomies will belong to.
72
87
  # @!attribute [rw] inline_source
73
88
  # @return [::Google::Cloud::DataCatalog::V1::InlineSource]
74
- # Inline source used for taxonomies import.
89
+ # Inline source taxonomy to import.
75
90
  # @!attribute [rw] cross_regional_source
76
91
  # @return [::Google::Cloud::DataCatalog::V1::CrossRegionalSource]
77
- # Cross-regional source taxonomy to be imported.
92
+ # Cross-regional source taxonomy to import.
78
93
  class ImportTaxonomiesRequest
79
94
  include ::Google::Protobuf::MessageExts
80
95
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -83,7 +98,7 @@ module Google
83
98
  # Inline source containing taxonomies to import.
84
99
  # @!attribute [rw] taxonomies
85
100
  # @return [::Array<::Google::Cloud::DataCatalog::V1::SerializedTaxonomy>]
86
- # Required. Taxonomies to be imported.
101
+ # Required. Taxonomies to import.
87
102
  class InlineSource
88
103
  include ::Google::Protobuf::MessageExts
89
104
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -93,7 +108,7 @@ module Google
93
108
  # region.
94
109
  # @!attribute [rw] taxonomy
95
110
  # @return [::String]
96
- # Required. The resource name of the source taxonomy to be imported.
111
+ # Required. The resource name of the source taxonomy to import.
97
112
  class CrossRegionalSource
98
113
  include ::Google::Protobuf::MessageExts
99
114
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -103,7 +118,7 @@ module Google
103
118
  # {::Google::Cloud::DataCatalog::V1::PolicyTagManagerSerialization::Client#import_taxonomies ImportTaxonomies}.
104
119
  # @!attribute [rw] taxonomies
105
120
  # @return [::Array<::Google::Cloud::DataCatalog::V1::Taxonomy>]
106
- # Taxonomies that were imported.
121
+ # Imported taxonomies.
107
122
  class ImportTaxonomiesResponse
108
123
  include ::Google::Protobuf::MessageExts
109
124
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -116,11 +131,11 @@ module Google
116
131
  # Required. Resource name of the project that the exported taxonomies belong to.
117
132
  # @!attribute [rw] taxonomies
118
133
  # @return [::Array<::String>]
119
- # Required. Resource names of the taxonomies to be exported.
134
+ # Required. Resource names of the taxonomies to export.
120
135
  # @!attribute [rw] serialized_taxonomies
121
136
  # @return [::Boolean]
122
- # Export taxonomies as serialized taxonomies, which contain all the policy
123
- # tags as nested protos.
137
+ # Serialized export taxonomies that contain all the policy
138
+ # tags as nested protocol buffers.
124
139
  class ExportTaxonomiesRequest
125
140
  include ::Google::Protobuf::MessageExts
126
141
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -130,7 +145,7 @@ module Google
130
145
  # {::Google::Cloud::DataCatalog::V1::PolicyTagManagerSerialization::Client#export_taxonomies ExportTaxonomies}.
131
146
  # @!attribute [rw] taxonomies
132
147
  # @return [::Array<::Google::Cloud::DataCatalog::V1::SerializedTaxonomy>]
133
- # List of taxonomies and policy tags as nested protos.
148
+ # List of taxonomies and policy tags as nested protocol buffers.
134
149
  class ExportTaxonomiesResponse
135
150
  include ::Google::Protobuf::MessageExts
136
151
  extend ::Google::Protobuf::MessageExts::ClassMethods