google-cloud-data_catalog-v1 0.7.3 → 0.8.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (30) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/data_catalog/v1/data_catalog.rb +2 -2
  3. data/lib/google/cloud/data_catalog/v1/data_catalog/client.rb +303 -291
  4. data/lib/google/cloud/data_catalog/v1/policy_tag_manager.rb +1 -1
  5. data/lib/google/cloud/data_catalog/v1/policy_tag_manager/client.rb +54 -45
  6. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization.rb +4 -3
  7. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/client.rb +109 -22
  8. data/lib/google/cloud/data_catalog/v1/version.rb +1 -1
  9. data/lib/google/cloud/datacatalog/v1/bigquery_pb.rb +48 -0
  10. data/lib/google/cloud/datacatalog/v1/datacatalog_pb.rb +44 -0
  11. data/lib/google/cloud/datacatalog/v1/datacatalog_services_pb.rb +179 -142
  12. data/lib/google/cloud/datacatalog/v1/policytagmanager_services_pb.rb +15 -14
  13. data/lib/google/cloud/datacatalog/v1/policytagmanagerserialization_pb.rb +5 -0
  14. data/lib/google/cloud/datacatalog/v1/policytagmanagerserialization_services_pb.rb +28 -14
  15. data/lib/google/cloud/datacatalog/v1/tags_pb.rb +3 -0
  16. data/lib/google/cloud/datacatalog/v1/usage_pb.rb +31 -0
  17. data/proto_docs/google/cloud/datacatalog/v1/bigquery.rb +87 -0
  18. data/proto_docs/google/cloud/datacatalog/v1/common.rb +1 -2
  19. data/proto_docs/google/cloud/datacatalog/v1/data_source.rb +6 -5
  20. data/proto_docs/google/cloud/datacatalog/v1/datacatalog.rb +370 -246
  21. data/proto_docs/google/cloud/datacatalog/v1/gcs_fileset_spec.rb +16 -15
  22. data/proto_docs/google/cloud/datacatalog/v1/policytagmanager.rb +87 -71
  23. data/proto_docs/google/cloud/datacatalog/v1/policytagmanagerserialization.rb +34 -19
  24. data/proto_docs/google/cloud/datacatalog/v1/schema.rb +3 -3
  25. data/proto_docs/google/cloud/datacatalog/v1/search.rb +43 -29
  26. data/proto_docs/google/cloud/datacatalog/v1/table_spec.rb +23 -16
  27. data/proto_docs/google/cloud/datacatalog/v1/tags.rb +96 -51
  28. data/proto_docs/google/cloud/datacatalog/v1/timestamps.rb +12 -5
  29. data/proto_docs/google/cloud/datacatalog/v1/usage.rb +79 -0
  30. metadata +6 -2
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