google-cloud-data_catalog-v1 0.7.1 → 0.8.1

Sign up to get free protection for your applications and to get access to all the features.
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
@@ -24,8 +24,8 @@ module Google
24
24
  module DataCatalog
25
25
  module V1
26
26
  module DataCatalog
27
- # Data Catalog API service allows clients to discover, understand, and manage
28
- # their data.
27
+ # Data Catalog API service allows you to discover, understand, and manage
28
+ # your data.
29
29
  class Service
30
30
 
31
31
  include GRPC::GenericService
@@ -34,199 +34,236 @@ module Google
34
34
  self.unmarshal_class_method = :decode
35
35
  self.service_name = 'google.cloud.datacatalog.v1.DataCatalog'
36
36
 
37
- # Searches Data Catalog for multiple resources like entries, tags that
37
+ # Searches Data Catalog for multiple resources like entries and tags that
38
38
  # match a query.
39
39
  #
40
- # This is a custom method
41
- # (https://cloud.google.com/apis/design/custom_methods) and does not return
42
- # the complete resource, only the resource identifier and high level
43
- # fields. Clients can subsequently call `Get` methods.
40
+ # This is a [Custom Method]
41
+ # (https://cloud.google.com/apis/design/custom_methods) that doesn't return
42
+ # all information on a resource, only its ID and high level fields. To get
43
+ # more information, you can subsequently call specific get methods.
44
44
  #
45
- # Note that Data Catalog search queries do not guarantee full recall. Query
46
- # results that match your query may not be returned, even in subsequent
47
- # result pages. Also note that results returned (and not returned) can vary
48
- # across repeated search queries.
45
+ # Note: Data Catalog search queries don't guarantee full recall. Results
46
+ # that match your query might not be returned, even in subsequent
47
+ # result pages. Additionally, returned (and not returned) results can vary
48
+ # if you repeat search queries.
49
49
  #
50
- # See [Data Catalog Search
51
- # Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference)
52
- # for more information.
50
+ # For more information, see [Data Catalog search syntax]
51
+ # (https://cloud.google.com/data-catalog/docs/how-to/search-reference).
53
52
  rpc :SearchCatalog, ::Google::Cloud::DataCatalog::V1::SearchCatalogRequest, ::Google::Cloud::DataCatalog::V1::SearchCatalogResponse
54
- # Creates an EntryGroup.
53
+ # Creates an entry group.
55
54
  #
56
- # An entry group contains logically related entries together with Cloud
57
- # Identity and Access Management policies that specify the users who can
58
- # create, edit, and view entries within the entry group.
55
+ # An entry group contains logically related entries together with [Cloud
56
+ # Identity and Access Management](/data-catalog/docs/concepts/iam) policies.
57
+ # These policies specify users who can create, edit, and view entries
58
+ # within entry groups.
59
59
  #
60
- # Data Catalog automatically creates an entry group for BigQuery entries
61
- # ("@bigquery") and Pub/Sub topics ("@pubsub"). Users create their own entry
62
- # group to contain Cloud Storage fileset entries or custom type entries,
63
- # and the IAM policies associated with those entries. Entry groups, like
64
- # entries, can be searched.
60
+ # Data Catalog automatically creates entry groups with names that start with
61
+ # the `@` symbol for the following resources:
62
+ #
63
+ # * BigQuery entries (`@bigquery`)
64
+ # * Pub/Sub topics (`@pubsub`)
65
+ # * Dataproc Metastore services (`@dataproc_metastore_{SERVICE_NAME_HASH}`)
66
+ #
67
+ # You can create your own entry groups for Cloud Storage fileset entries
68
+ # and custom entries together with the corresponding IAM policies.
69
+ # User-created entry groups can't contain the `@` symbol, it is reserved
70
+ # for automatically created groups.
71
+ #
72
+ # Entry groups, like entries, can be searched.
65
73
  #
66
74
  # A maximum of 10,000 entry groups may be created per organization across all
67
75
  # locations.
68
76
  #
69
- # Users should enable the Data Catalog API in the project identified by
70
- # the `parent` parameter (see [Data Catalog Resource Project]
71
- # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
72
- # more information).
77
+ # You must enable the Data Catalog API in the project identified by
78
+ # the `parent` parameter. For more information, see [Data Catalog resource
79
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
73
80
  rpc :CreateEntryGroup, ::Google::Cloud::DataCatalog::V1::CreateEntryGroupRequest, ::Google::Cloud::DataCatalog::V1::EntryGroup
74
- # Gets an EntryGroup.
81
+ # Gets an entry group.
75
82
  rpc :GetEntryGroup, ::Google::Cloud::DataCatalog::V1::GetEntryGroupRequest, ::Google::Cloud::DataCatalog::V1::EntryGroup
76
- # Updates an EntryGroup. The user should enable the Data Catalog API in the
77
- # project identified by the `entry_group.name` parameter (see [Data Catalog
78
- # Resource Project]
79
- # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
80
- # more information).
83
+ # Updates an entry group.
84
+ #
85
+ # You must enable the Data Catalog API in the project identified by
86
+ # the `entry_group.name` parameter. For more information, see [Data Catalog
87
+ # resource
88
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
81
89
  rpc :UpdateEntryGroup, ::Google::Cloud::DataCatalog::V1::UpdateEntryGroupRequest, ::Google::Cloud::DataCatalog::V1::EntryGroup
82
- # Deletes an EntryGroup. Only entry groups that do not contain entries can be
83
- # deleted. Users should enable the Data Catalog API in the project
84
- # identified by the `name` parameter (see [Data Catalog Resource Project]
85
- # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
86
- # more information).
90
+ # Deletes an entry group.
91
+ #
92
+ # You must enable the Data Catalog API in the project
93
+ # identified by the `name` parameter. For more information, see [Data Catalog
94
+ # resource
95
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
87
96
  rpc :DeleteEntryGroup, ::Google::Cloud::DataCatalog::V1::DeleteEntryGroupRequest, ::Google::Protobuf::Empty
88
97
  # Lists entry groups.
89
98
  rpc :ListEntryGroups, ::Google::Cloud::DataCatalog::V1::ListEntryGroupsRequest, ::Google::Cloud::DataCatalog::V1::ListEntryGroupsResponse
90
- # Creates an entry. Only entries of types 'FILESET', 'CLUSTER', 'DATA_STREAM'
91
- # or with a user-specified type can be created.
99
+ # Creates an entry.
92
100
  #
93
- # Users should enable the Data Catalog API in the project identified by
94
- # the `parent` parameter (see [Data Catalog Resource Project]
95
- # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
96
- # more information).
101
+ # You can create entries only with 'FILESET', 'CLUSTER', 'DATA_STREAM',
102
+ # or custom types. Data Catalog automatically creates entries with other
103
+ # types during metadata ingestion from integrated systems.
97
104
  #
98
- # A maximum of 100,000 entries may be created per entry group.
105
+ # You must enable the Data Catalog API in the project identified by
106
+ # the `parent` parameter. For more information, see [Data Catalog resource
107
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
108
+ #
109
+ # An entry group can have a maximum of 100,000 entries.
99
110
  rpc :CreateEntry, ::Google::Cloud::DataCatalog::V1::CreateEntryRequest, ::Google::Cloud::DataCatalog::V1::Entry
100
111
  # Updates an existing entry.
101
- # Users should enable the Data Catalog API in the project identified by
102
- # the `entry.name` parameter (see [Data Catalog Resource Project]
103
- # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
104
- # more information).
112
+ #
113
+ # You must enable the Data Catalog API in the project identified by
114
+ # the `entry.name` parameter. For more information, see [Data Catalog
115
+ # resource
116
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
105
117
  rpc :UpdateEntry, ::Google::Cloud::DataCatalog::V1::UpdateEntryRequest, ::Google::Cloud::DataCatalog::V1::Entry
106
- # Deletes an existing entry. Only entries created through
118
+ # Deletes an existing entry.
119
+ #
120
+ # You can delete only the entries created by the
107
121
  # [CreateEntry][google.cloud.datacatalog.v1.DataCatalog.CreateEntry]
108
- # method can be deleted.
109
- # Users should enable the Data Catalog API in the project identified by
110
- # the `name` parameter (see [Data Catalog Resource Project]
111
- # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
112
- # more information).
122
+ # method.
123
+ #
124
+ # You must enable the Data Catalog API in the project identified by
125
+ # the `name` parameter. For more information, see [Data Catalog
126
+ # resource
127
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
113
128
  rpc :DeleteEntry, ::Google::Cloud::DataCatalog::V1::DeleteEntryRequest, ::Google::Protobuf::Empty
114
129
  # Gets an entry.
115
130
  rpc :GetEntry, ::Google::Cloud::DataCatalog::V1::GetEntryRequest, ::Google::Cloud::DataCatalog::V1::Entry
116
- # Get an entry by target resource name. This method allows clients to use
117
- # the resource name from the source Google Cloud Platform service to get the
118
- # Data Catalog Entry.
131
+ # Gets an entry by its target resource name.
132
+ #
133
+ # The resource name comes from the source Google Cloud Platform service.
119
134
  rpc :LookupEntry, ::Google::Cloud::DataCatalog::V1::LookupEntryRequest, ::Google::Cloud::DataCatalog::V1::Entry
120
135
  # Lists entries.
121
136
  rpc :ListEntries, ::Google::Cloud::DataCatalog::V1::ListEntriesRequest, ::Google::Cloud::DataCatalog::V1::ListEntriesResponse
122
- # Creates a tag template. The user should enable the Data Catalog API in
123
- # the project identified by the `parent` parameter (see [Data Catalog
124
- # Resource
125
- # Project](https://cloud.google.com/data-catalog/docs/concepts/resource-project)
126
- # for more information).
137
+ # Creates a tag template.
138
+ #
139
+ # You must enable the Data Catalog API in the project identified by the
140
+ # `parent` parameter.
141
+ # For more information, see [Data Catalog resource project]
142
+ # (https://cloud.google.com/data-catalog/docs/concepts/resource-project).
127
143
  rpc :CreateTagTemplate, ::Google::Cloud::DataCatalog::V1::CreateTagTemplateRequest, ::Google::Cloud::DataCatalog::V1::TagTemplate
128
144
  # Gets a tag template.
129
145
  rpc :GetTagTemplate, ::Google::Cloud::DataCatalog::V1::GetTagTemplateRequest, ::Google::Cloud::DataCatalog::V1::TagTemplate
130
- # Updates a tag template. This method cannot be used to update the fields of
131
- # a template. The tag template fields are represented as separate resources
132
- # and should be updated using their own create/update/delete methods.
133
- # Users should enable the Data Catalog API in the project identified by
134
- # the `tag_template.name` parameter (see [Data Catalog Resource Project]
135
- # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
136
- # more information).
146
+ # Updates a tag template.
147
+ #
148
+ # You can't update template fields with this method. These fields are
149
+ # separate resources with their own create, update, and delete methods.
150
+ #
151
+ # You must enable the Data Catalog API in the project identified by
152
+ # the `tag_template.name` parameter. For more information, see [Data Catalog
153
+ # resource
154
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
137
155
  rpc :UpdateTagTemplate, ::Google::Cloud::DataCatalog::V1::UpdateTagTemplateRequest, ::Google::Cloud::DataCatalog::V1::TagTemplate
138
- # Deletes a tag template and all tags using the template.
139
- # Users should enable the Data Catalog API in the project identified by
140
- # the `name` parameter (see [Data Catalog Resource Project]
141
- # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
142
- # more information).
156
+ # Deletes a tag template and all tags that use it.
157
+ #
158
+ # You must enable the Data Catalog API in the project identified by
159
+ # the `name` parameter. For more information, see [Data Catalog resource
160
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
143
161
  rpc :DeleteTagTemplate, ::Google::Cloud::DataCatalog::V1::DeleteTagTemplateRequest, ::Google::Protobuf::Empty
144
- # Creates a field in a tag template. The user should enable the Data Catalog
145
- # API in the project identified by the `parent` parameter (see
146
- # [Data Catalog Resource
147
- # Project](https://cloud.google.com/data-catalog/docs/concepts/resource-project)
148
- # for more information).
162
+ # Creates a field in a tag template.
163
+ #
164
+ # You must enable the Data Catalog API in the project identified by
165
+ # the `parent` parameter. For more information, see [Data Catalog resource
166
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
149
167
  rpc :CreateTagTemplateField, ::Google::Cloud::DataCatalog::V1::CreateTagTemplateFieldRequest, ::Google::Cloud::DataCatalog::V1::TagTemplateField
150
- # Updates a field in a tag template. This method cannot be used to update the
151
- # field type. Users should enable the Data Catalog API in the project
152
- # identified by the `name` parameter (see [Data Catalog Resource Project]
153
- # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
154
- # more information).
168
+ # Updates a field in a tag template.
169
+ #
170
+ # You can't update the field type with this method.
171
+ #
172
+ # You must enable the Data Catalog API in the project
173
+ # identified by the `name` parameter. For more information, see [Data Catalog
174
+ # resource
175
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
155
176
  rpc :UpdateTagTemplateField, ::Google::Cloud::DataCatalog::V1::UpdateTagTemplateFieldRequest, ::Google::Cloud::DataCatalog::V1::TagTemplateField
156
- # Renames a field in a tag template. The user should enable the Data Catalog
157
- # API in the project identified by the `name` parameter (see [Data Catalog
158
- # Resource
159
- # Project](https://cloud.google.com/data-catalog/docs/concepts/resource-project)
160
- # for more information).
177
+ # Renames a field in a tag template.
178
+ #
179
+ # You must enable the Data Catalog API in the project identified by the
180
+ # `name` parameter. For more information, see [Data Catalog resource project]
181
+ # (https://cloud.google.com/data-catalog/docs/concepts/resource-project).
161
182
  rpc :RenameTagTemplateField, ::Google::Cloud::DataCatalog::V1::RenameTagTemplateFieldRequest, ::Google::Cloud::DataCatalog::V1::TagTemplateField
162
- # Renames an enum value in a tag template. The enum values have to be unique
163
- # within one enum field.
183
+ # Renames an enum value in a tag template.
184
+ #
185
+ # Within a single enum field, enum values must be unique.
164
186
  rpc :RenameTagTemplateFieldEnumValue, ::Google::Cloud::DataCatalog::V1::RenameTagTemplateFieldEnumValueRequest, ::Google::Cloud::DataCatalog::V1::TagTemplateField
165
- # Deletes a field in a tag template and all uses of that field.
166
- # Users should enable the Data Catalog API in the project identified by
167
- # the `name` parameter (see [Data Catalog Resource Project]
168
- # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
169
- # more information).
187
+ # Deletes a field in a tag template and all uses of this field from the tags
188
+ # based on this template.
189
+ #
190
+ # You must enable the Data Catalog API in the project identified by
191
+ # the `name` parameter. For more information, see [Data Catalog resource
192
+ # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
170
193
  rpc :DeleteTagTemplateField, ::Google::Cloud::DataCatalog::V1::DeleteTagTemplateFieldRequest, ::Google::Protobuf::Empty
171
- # Creates a tag on an [Entry][google.cloud.datacatalog.v1.Entry].
172
- # Note: The project identified by the `parent` parameter for the
173
- # [tag](https://cloud.google.com/data-catalog/docs/reference/rest/v1/projects.locations.entryGroups.entries.tags/create#path-parameters)
174
- # and the
175
- # [tag
176
- # template](https://cloud.google.com/data-catalog/docs/reference/rest/v1/projects.locations.tagTemplates/create#path-parameters)
177
- # used to create the tag must be from the same organization.
194
+ # Creates a tag and assigns it to:
195
+ #
196
+ # * An [Entry][google.cloud.datacatalog.v1.Entry] if the method name is
197
+ # ``projects.locations.entryGroups.entries.tags.create``.
198
+ # * Or [EntryGroup][google.cloud.datacatalog.v1.EntryGroup]if the method
199
+ # name is ``projects.locations.entryGroups.tags.create``.
200
+ #
201
+ # Note: The project identified by the `parent` parameter for the [tag]
202
+ # (https://cloud.google.com/data-catalog/docs/reference/rest/v1/projects.locations.entryGroups.entries.tags/create#path-parameters)
203
+ # and the [tag template]
204
+ # (https://cloud.google.com/data-catalog/docs/reference/rest/v1/projects.locations.tagTemplates/create#path-parameters)
205
+ # used to create the tag must be in the same organization.
178
206
  rpc :CreateTag, ::Google::Cloud::DataCatalog::V1::CreateTagRequest, ::Google::Cloud::DataCatalog::V1::Tag
179
207
  # Updates an existing tag.
180
208
  rpc :UpdateTag, ::Google::Cloud::DataCatalog::V1::UpdateTagRequest, ::Google::Cloud::DataCatalog::V1::Tag
181
209
  # Deletes a tag.
182
210
  rpc :DeleteTag, ::Google::Cloud::DataCatalog::V1::DeleteTagRequest, ::Google::Protobuf::Empty
183
- # Lists the tags on an [Entry][google.cloud.datacatalog.v1.Entry].
211
+ # Lists tags assigned to an [Entry][google.cloud.datacatalog.v1.Entry].
184
212
  rpc :ListTags, ::Google::Cloud::DataCatalog::V1::ListTagsRequest, ::Google::Cloud::DataCatalog::V1::ListTagsResponse
185
- # Sets the access control policy for a resource. Replaces any existing
213
+ # Sets an access control policy for a resource. Replaces any existing
186
214
  # policy.
215
+ #
187
216
  # Supported resources are:
188
- # - Tag templates.
189
- # - Entries.
190
- # - Entry groups.
191
- # Note, this method cannot be used to manage policies for BigQuery, Pub/Sub
192
- # and any external Google Cloud Platform resources synced to Data Catalog.
193
- #
194
- # Callers must have following Google IAM permission
195
- # - `datacatalog.tagTemplates.setIamPolicy` to set policies on tag
196
- # templates.
197
- # - `datacatalog.entries.setIamPolicy` to set policies on entries.
198
- # - `datacatalog.entryGroups.setIamPolicy` to set policies on entry groups.
217
+ #
218
+ # - Tag templates
219
+ # - Entry groups
220
+ #
221
+ # Note: This method sets policies only within Data Catalog and can't be
222
+ # used to manage policies in BigQuery, Pub/Sub, Dataproc Metastore, and any
223
+ # external Google Cloud Platform resources synced with the Data Catalog.
224
+ #
225
+ # To call this method, you must have the following Google IAM permissions:
226
+ #
227
+ # - `datacatalog.tagTemplates.setIamPolicy` to set policies on tag
228
+ # templates.
229
+ # - `datacatalog.entryGroups.setIamPolicy` to set policies on entry groups.
199
230
  rpc :SetIamPolicy, ::Google::Iam::V1::SetIamPolicyRequest, ::Google::Iam::V1::Policy
200
- # Gets the access control policy for a resource. A `NOT_FOUND` error
201
- # is returned if the resource does not exist. An empty policy is returned
202
- # if the resource exists but does not have a policy set on it.
231
+ # Gets the access control policy for a resource.
232
+ #
233
+ # May return:
234
+ #
235
+ # * A`NOT_FOUND` error if the resource doesn't exist or you don't have the
236
+ # permission to view it.
237
+ # * An empty policy if the resource exists but doesn't have a set policy.
203
238
  #
204
239
  # Supported resources are:
205
- # - Tag templates.
206
- # - Entries.
207
- # - Entry groups.
208
- # Note, this method cannot be used to manage policies for BigQuery, Pub/Sub
209
- # and any external Google Cloud Platform resources synced to Data Catalog.
210
- #
211
- # Callers must have following Google IAM permission
212
- # - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag
213
- # templates.
214
- # - `datacatalog.entries.getIamPolicy` to get policies on entries.
215
- # - `datacatalog.entryGroups.getIamPolicy` to get policies on entry groups.
240
+ #
241
+ # - Tag templates
242
+ # - Entry groups
243
+ #
244
+ # Note: This method doesn't get policies from Google Cloud Platform
245
+ # resources ingested into Data Catalog.
246
+ #
247
+ # To call this method, you must have the following Google IAM permissions:
248
+ #
249
+ # - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag
250
+ # templates.
251
+ # - `datacatalog.entryGroups.getIamPolicy` to get policies on entry groups.
216
252
  rpc :GetIamPolicy, ::Google::Iam::V1::GetIamPolicyRequest, ::Google::Iam::V1::Policy
217
- # Returns the caller's permissions on a resource.
218
- # If the resource does not exist, an empty set of permissions is returned
219
- # (We don't return a `NOT_FOUND` error).
253
+ # Gets your permissions on a resource.
254
+ #
255
+ # Returns an empty set of permissions if the resource doesn't exist.
220
256
  #
221
257
  # Supported resources are:
222
- # - Tag templates.
223
- # - Entries.
224
- # - Entry groups.
225
- # Note, this method cannot be used to manage policies for BigQuery, Pub/Sub
226
- # and any external Google Cloud Platform resources synced to Data Catalog.
227
- #
228
- # A caller is not required to have Google IAM permission to make this
229
- # request.
258
+ #
259
+ # - Tag templates
260
+ # - Entry groups
261
+ #
262
+ # Note: This method gets policies only within Data Catalog and can't be
263
+ # used to get policies from BigQuery, Pub/Sub, Dataproc Metastore, and any
264
+ # external Google Cloud Platform resources ingested into Data Catalog.
265
+ #
266
+ # No Google IAM permissions are required to call this method.
230
267
  rpc :TestIamPermissions, ::Google::Iam::V1::TestIamPermissionsRequest, ::Google::Iam::V1::TestIamPermissionsResponse
231
268
  end
232
269
 
@@ -24,7 +24,7 @@ module Google
24
24
  module DataCatalog
25
25
  module V1
26
26
  module PolicyTagManager
27
- # Policy Tag Manager API service allows clients to manage their policy tags and
27
+ # Policy Tag Manager API service allows you to manage your policy tags and
28
28
  # taxonomies.
29
29
  #
30
30
  # Policy tags are used to tag BigQuery columns and apply additional access
@@ -38,31 +38,32 @@ module Google
38
38
  self.unmarshal_class_method = :decode
39
39
  self.service_name = 'google.cloud.datacatalog.v1.PolicyTagManager'
40
40
 
41
- # Creates a taxonomy in a specified project. The taxonomy is initially empty,
42
- # i.e., does not contain policy tags.
41
+ # Creates a taxonomy in a specified project.
42
+ #
43
+ # The taxonomy is initially empty, that is, it doesn't contain policy tags.
43
44
  rpc :CreateTaxonomy, ::Google::Cloud::DataCatalog::V1::CreateTaxonomyRequest, ::Google::Cloud::DataCatalog::V1::Taxonomy
44
- # Deletes a taxonomy. This method will also delete all policy tags in this
45
+ # Deletes a taxonomy, including all policy tags in this
45
46
  # taxonomy, their associated policies, and the policy tags references from
46
47
  # BigQuery columns.
47
48
  rpc :DeleteTaxonomy, ::Google::Cloud::DataCatalog::V1::DeleteTaxonomyRequest, ::Google::Protobuf::Empty
48
- # Updates a taxonomy. This method can update the taxonomy's display name,
49
+ # Updates a taxonomy, including its display name,
49
50
  # description, and activated policy types.
50
51
  rpc :UpdateTaxonomy, ::Google::Cloud::DataCatalog::V1::UpdateTaxonomyRequest, ::Google::Cloud::DataCatalog::V1::Taxonomy
51
- # Lists all taxonomies in a project in a particular location that the caller
52
- # has permission to view.
52
+ # Lists all taxonomies in a project in a particular location that you
53
+ # have a permission to view.
53
54
  rpc :ListTaxonomies, ::Google::Cloud::DataCatalog::V1::ListTaxonomiesRequest, ::Google::Cloud::DataCatalog::V1::ListTaxonomiesResponse
54
55
  # Gets a taxonomy.
55
56
  rpc :GetTaxonomy, ::Google::Cloud::DataCatalog::V1::GetTaxonomyRequest, ::Google::Cloud::DataCatalog::V1::Taxonomy
56
57
  # Creates a policy tag in a taxonomy.
57
58
  rpc :CreatePolicyTag, ::Google::Cloud::DataCatalog::V1::CreatePolicyTagRequest, ::Google::Cloud::DataCatalog::V1::PolicyTag
58
- # Deletes a policy tag. This method also deletes:
59
+ # Deletes a policy tag together with the following:
59
60
  #
60
- # * all of its descendant policy tags, if any
61
- # * the policies associated with the policy tag and its descendants
62
- # * references from BigQuery table schema of the policy tag and its
63
- # descendants.
61
+ # * All of its descendant policy tags, if any
62
+ # * Policies associated with the policy tag and its descendants
63
+ # * References from BigQuery table schema of the policy tag and its
64
+ # descendants
64
65
  rpc :DeletePolicyTag, ::Google::Cloud::DataCatalog::V1::DeletePolicyTagRequest, ::Google::Protobuf::Empty
65
- # Updates a policy tag. This method can update the policy tag's display
66
+ # Updates a policy tag, including its display
66
67
  # name, description, and parent policy tag.
67
68
  rpc :UpdatePolicyTag, ::Google::Cloud::DataCatalog::V1::UpdatePolicyTagRequest, ::Google::Cloud::DataCatalog::V1::PolicyTag
68
69
  # Lists all policy tags in a taxonomy.
@@ -73,7 +74,7 @@ module Google
73
74
  rpc :GetIamPolicy, ::Google::Iam::V1::GetIamPolicyRequest, ::Google::Iam::V1::Policy
74
75
  # Sets the IAM policy for a policy tag or a taxonomy.
75
76
  rpc :SetIamPolicy, ::Google::Iam::V1::SetIamPolicyRequest, ::Google::Iam::V1::Policy
76
- # Returns the permissions that a caller has on a specified policy tag or
77
+ # Returns your permissions on a specified policy tag or
77
78
  # taxonomy.
78
79
  rpc :TestIamPermissions, ::Google::Iam::V1::TestIamPermissionsRequest, ::Google::Iam::V1::TestIamPermissionsResponse
79
80
  end
@@ -23,6 +23,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
23
23
  optional :description, :string, 3
24
24
  repeated :child_policy_tags, :message, 4, "google.cloud.datacatalog.v1.SerializedPolicyTag"
25
25
  end
26
+ add_message "google.cloud.datacatalog.v1.ReplaceTaxonomyRequest" do
27
+ optional :name, :string, 1
28
+ optional :serialized_taxonomy, :message, 2, "google.cloud.datacatalog.v1.SerializedTaxonomy"
29
+ end
26
30
  add_message "google.cloud.datacatalog.v1.ImportTaxonomiesRequest" do
27
31
  optional :parent, :string, 1
28
32
  oneof :source do
@@ -58,6 +62,7 @@ module Google
58
62
  module V1
59
63
  SerializedTaxonomy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.SerializedTaxonomy").msgclass
60
64
  SerializedPolicyTag = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.SerializedPolicyTag").msgclass
65
+ ReplaceTaxonomyRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.ReplaceTaxonomyRequest").msgclass
61
66
  ImportTaxonomiesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.ImportTaxonomiesRequest").msgclass
62
67
  InlineSource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.InlineSource").msgclass
63
68
  CrossRegionalSource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.CrossRegionalSource").msgclass