google-apis-datacatalog_v1 0.7.0 → 0.11.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: cf3ac9dba0ff4883a11c2a9cdf53dfa06a2af6bcdad322187428043c0d3039ca
4
- data.tar.gz: efefb6370388e4af8aaa30ab7c64a142a2ef352366615c533df8695fbaa75c2b
3
+ metadata.gz: '09a9eb97d51162943ecf6b8bca6b37353af87ef1f3abbff5dd188f0424eb34eb'
4
+ data.tar.gz: a60f09a1da0be99968641cd8fba498f4e8c6bea0dfdb5fd51cb1f4f9db813120
5
5
  SHA512:
6
- metadata.gz: bf9738194d8f8c29aa45f586cbf4990c96b2a9cc85a4e28555abc4c0c36986e6a2aadc3ccd83a084d222d0c4b2d40b440860a0ddc034403d7480d88ea3b64971
7
- data.tar.gz: c62b85272b12dafe2556c416175bdbfee6a555f5578bda4c77f37d588b41c0892a0e43dcf114680fe573d483a72bff60e3886be490039ce517a90c7f53e0c0bc
6
+ metadata.gz: 7e9a73ec21b05174d8fc5962c96f69fa47597e1d57dd9a76df7185b655c89ec4cd2557734600d37c220b27c3cb7331e754c94d5e9a4dca8c711b4359669c0c01
7
+ data.tar.gz: a95cc59c843eeeba8ca28ca3b224f60f06315ca0233b78d9f83ed0a3aa3a984c76745393130f1d6009ae36514f2046659813ae81c78c486e1ea693edf7080ec4
data/CHANGELOG.md CHANGED
@@ -1,5 +1,21 @@
1
1
  # Release history for google-apis-datacatalog_v1
2
2
 
3
+ ### v0.11.0 (2021-12-07)
4
+
5
+ * Regenerated from discovery document revision 20211201
6
+
7
+ ### v0.10.0 (2021-11-12)
8
+
9
+ * Regenerated from discovery document revision 20211110
10
+
11
+ ### v0.9.0 (2021-10-20)
12
+
13
+ * Regenerated from discovery document revision 20211014
14
+
15
+ ### v0.8.0 (2021-09-30)
16
+
17
+ * Regenerated from discovery document revision 20210920
18
+
3
19
  ### v0.7.0 (2021-09-01)
4
20
 
5
21
  * Regenerated from discovery document revision 20210827
data/OVERVIEW.md CHANGED
@@ -60,8 +60,8 @@ See the class reference docs for information on the methods you can call from a
60
60
 
61
61
  More detailed descriptions of the Google simple REST clients are available in two documents.
62
62
 
63
- * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
64
- * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
63
+ * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
64
+ * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
65
65
 
66
66
  (Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Datacatalog service in particular.)
67
67
 
@@ -22,7 +22,7 @@ module Google
22
22
  module Apis
23
23
  module DatacatalogV1
24
24
 
25
- # Associates `members` with a `role`.
25
+ # Associates `members`, or principals, with a `role`.
26
26
  class Binding
27
27
  include Google::Apis::Core::Hashable
28
28
 
@@ -45,7 +45,7 @@ module Google
45
45
  # @return [Google::Apis::DatacatalogV1::Expr]
46
46
  attr_accessor :condition
47
47
 
48
- # Specifies the identities requesting access for a Cloud Platform resource. `
48
+ # Specifies the principals requesting access for a Cloud Platform resource. `
49
49
  # members` can have the following values: * `allUsers`: A special identifier
50
50
  # that represents anyone who is on the internet; with or without a Google
51
51
  # account. * `allAuthenticatedUsers`: A special identifier that represents
@@ -75,8 +75,8 @@ module Google
75
75
  # @return [Array<String>]
76
76
  attr_accessor :members
77
77
 
78
- # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
79
- # , or `roles/owner`.
78
+ # Role that is assigned to the list of `members`, or principals. For example, `
79
+ # roles/viewer`, `roles/editor`, or `roles/owner`.
80
80
  # Corresponds to the JSON property `role`
81
81
  # @return [String]
82
82
  attr_accessor :role
@@ -187,13 +187,16 @@ module Google
187
187
  class GetPolicyOptions
188
188
  include Google::Apis::Core::Hashable
189
189
 
190
- # Optional. The policy format version to be returned. Valid values are 0, 1, and
191
- # 3. Requests specifying an invalid value will be rejected. Requests for
192
- # policies with any conditional bindings must specify version 3. Policies
193
- # without any conditional bindings may specify any valid value or leave the
194
- # field unset. To learn which resources support conditions in their IAM policies,
195
- # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
196
- # resource-policies).
190
+ # Optional. The maximum policy version that will be used to format the policy.
191
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
192
+ # rejected. Requests for policies with any conditional role bindings must
193
+ # specify version 3. Policies with no conditional role bindings may specify any
194
+ # valid value or leave the field unset. The policy in the response might use the
195
+ # policy version that you specified, or it might use a lower policy version. For
196
+ # example, if you specify version 3, but the policy has no conditional role
197
+ # bindings, the response uses version 1. To learn which resources support
198
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
199
+ # google.com/iam/help/conditions/resource-policies).
197
200
  # Corresponds to the JSON property `requestedPolicyVersion`
198
201
  # @return [Fixnum]
199
202
  attr_accessor :requested_policy_version
@@ -255,6 +258,11 @@ module Google
255
258
  # @return [String]
256
259
  attr_accessor :dataset
257
260
 
261
+ # Output only. BigQuery resource name of the latest shard.
262
+ # Corresponds to the JSON property `latestShardResource`
263
+ # @return [String]
264
+ attr_accessor :latest_shard_resource
265
+
258
266
  # Output only. Total number of shards.
259
267
  # Corresponds to the JSON property `shardCount`
260
268
  # @return [Fixnum]
@@ -274,6 +282,7 @@ module Google
274
282
  # Update properties of this object
275
283
  def update!(**args)
276
284
  @dataset = args[:dataset] if args.key?(:dataset)
285
+ @latest_shard_resource = args[:latest_shard_resource] if args.key?(:latest_shard_resource)
277
286
  @shard_count = args[:shard_count] if args.key?(:shard_count)
278
287
  @table_prefix = args[:table_prefix] if args.key?(:table_prefix)
279
288
  end
@@ -602,6 +611,11 @@ module Google
602
611
  # @return [String]
603
612
  attr_accessor :name
604
613
 
614
+ # Entry metadata relevant only to the user and private to them.
615
+ # Corresponds to the JSON property `personalDetails`
616
+ # @return [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1PersonalDetails]
617
+ attr_accessor :personal_details
618
+
605
619
  # Specification that applies to a routine. Valid only for entries with the `
606
620
  # ROUTINE` type.
607
621
  # Corresponds to the JSON property `routineSpec`
@@ -672,6 +686,7 @@ module Google
672
686
  @labels = args[:labels] if args.key?(:labels)
673
687
  @linked_resource = args[:linked_resource] if args.key?(:linked_resource)
674
688
  @name = args[:name] if args.key?(:name)
689
+ @personal_details = args[:personal_details] if args.key?(:personal_details)
675
690
  @routine_spec = args[:routine_spec] if args.key?(:routine_spec)
676
691
  @schema = args[:schema] if args.key?(:schema)
677
692
  @source_system_timestamps = args[:source_system_timestamps] if args.key?(:source_system_timestamps)
@@ -1080,6 +1095,32 @@ module Google
1080
1095
  end
1081
1096
  end
1082
1097
 
1098
+ # Entry metadata relevant only to the user and private to them.
1099
+ class GoogleCloudDatacatalogV1PersonalDetails
1100
+ include Google::Apis::Core::Hashable
1101
+
1102
+ # Set if the entry is starred; unset otherwise.
1103
+ # Corresponds to the JSON property `starTime`
1104
+ # @return [String]
1105
+ attr_accessor :star_time
1106
+
1107
+ # True if the entry is starred by the user; false otherwise.
1108
+ # Corresponds to the JSON property `starred`
1109
+ # @return [Boolean]
1110
+ attr_accessor :starred
1111
+ alias_method :starred?, :starred
1112
+
1113
+ def initialize(**args)
1114
+ update!(**args)
1115
+ end
1116
+
1117
+ # Update properties of this object
1118
+ def update!(**args)
1119
+ @star_time = args[:star_time] if args.key?(:star_time)
1120
+ @starred = args[:starred] if args.key?(:starred)
1121
+ end
1122
+ end
1123
+
1083
1124
  # Denotes one policy tag in a taxonomy, for example, SSN. Policy tags can be
1084
1125
  # defined in a hierarchy. For example: ``` + Geolocation + LatLong + City +
1085
1126
  # ZipCode ``` Where the "Geolocation" policy tag contains three children.
@@ -1305,8 +1346,8 @@ module Google
1305
1346
 
1306
1347
  # Specifies the order of results. Currently supported case-sensitive values are:
1307
1348
  # * `relevance` that can only be descending * `last_modified_timestamp [asc|desc]
1308
- # ` with descending (`desc`) as default If this parameter is omitted, it
1309
- # defaults to the descending `relevance`.
1349
+ # ` with descending (`desc`) as default * `default` that can only be descending
1350
+ # If this parameter is omitted, it defaults to the descending `relevance`.
1310
1351
  # Corresponds to the JSON property `orderBy`
1311
1352
  # @return [String]
1312
1353
  attr_accessor :order_by
@@ -1327,10 +1368,11 @@ module Google
1327
1368
  attr_accessor :page_token
1328
1369
 
1329
1370
  # Optional. The query string with a minimum of 3 characters and specific syntax.
1330
- # For more information, see [Data Catalog search syntax](/data-catalog/docs/how-
1331
- # to/search-reference). An empty query string returns all data assets (in the
1332
- # specified scope) that you have access to. A query string can be a simple `xyz`
1333
- # or qualified by predicates: * `name:x` * `column:y` * `description:z`
1371
+ # For more information, see [Data Catalog search syntax](https://cloud.google.
1372
+ # com/data-catalog/docs/how-to/search-reference). An empty query string returns
1373
+ # all data assets (in the specified scope) that you have access to. A query
1374
+ # string can be a simple `xyz` or qualified by predicates: * `name:x` * `column:
1375
+ # y` * `description:z`
1334
1376
  # Corresponds to the JSON property `query`
1335
1377
  # @return [String]
1336
1378
  attr_accessor :query
@@ -1383,7 +1425,7 @@ module Google
1383
1425
  # Optional. If `true`, include public tag templates in the search results. By
1384
1426
  # default, they are included only if you have explicit permissions on them to
1385
1427
  # view them. For example, if you are the owner. Other scope fields, for example,
1386
- # ``include_org_ids``, still restrict the returned public tag templates and at
1428
+ # `include_org_ids`, still restrict the returned public tag templates and at
1387
1429
  # least one of them is required.
1388
1430
  # Corresponds to the JSON property `includePublicTagTemplates`
1389
1431
  # @return [Boolean]
@@ -1401,6 +1443,13 @@ module Google
1401
1443
  # @return [Array<String>]
1402
1444
  attr_accessor :restricted_locations
1403
1445
 
1446
+ # Optional. If `true`, search only among starred entries. By default, all
1447
+ # results are returned, starred or not.
1448
+ # Corresponds to the JSON property `starredOnly`
1449
+ # @return [Boolean]
1450
+ attr_accessor :starred_only
1451
+ alias_method :starred_only?, :starred_only
1452
+
1404
1453
  def initialize(**args)
1405
1454
  update!(**args)
1406
1455
  end
@@ -1412,6 +1461,7 @@ module Google
1412
1461
  @include_project_ids = args[:include_project_ids] if args.key?(:include_project_ids)
1413
1462
  @include_public_tag_templates = args[:include_public_tag_templates] if args.key?(:include_public_tag_templates)
1414
1463
  @restricted_locations = args[:restricted_locations] if args.key?(:restricted_locations)
1464
+ @starred_only = args[:starred_only] if args.key?(:starred_only)
1415
1465
  end
1416
1466
  end
1417
1467
 
@@ -1455,6 +1505,17 @@ module Google
1455
1505
  class GoogleCloudDatacatalogV1SearchCatalogResult
1456
1506
  include Google::Apis::Core::Hashable
1457
1507
 
1508
+ # Entry description that can consist of several sentences or paragraphs that
1509
+ # describe entry contents.
1510
+ # Corresponds to the JSON property `description`
1511
+ # @return [String]
1512
+ attr_accessor :description
1513
+
1514
+ # The display name of the result.
1515
+ # Corresponds to the JSON property `displayName`
1516
+ # @return [String]
1517
+ attr_accessor :display_name
1518
+
1458
1519
  # Fully qualified name (FQN) of the resource. FQNs take two forms: * For non-
1459
1520
  # regionalized resources: ``SYSTEM`:`PROJECT`.`
1460
1521
  # PATH_TO_RESOURCE_SEPARATED_WITH_DOTS`` * For regionalized resources: ``SYSTEM`:
@@ -1515,6 +1576,8 @@ module Google
1515
1576
 
1516
1577
  # Update properties of this object
1517
1578
  def update!(**args)
1579
+ @description = args[:description] if args.key?(:description)
1580
+ @display_name = args[:display_name] if args.key?(:display_name)
1518
1581
  @fully_qualified_name = args[:fully_qualified_name] if args.key?(:fully_qualified_name)
1519
1582
  @integrated_system = args[:integrated_system] if args.key?(:integrated_system)
1520
1583
  @linked_resource = args[:linked_resource] if args.key?(:linked_resource)
@@ -1606,6 +1669,32 @@ module Google
1606
1669
  end
1607
1670
  end
1608
1671
 
1672
+ # Request message for StarEntry.
1673
+ class GoogleCloudDatacatalogV1StarEntryRequest
1674
+ include Google::Apis::Core::Hashable
1675
+
1676
+ def initialize(**args)
1677
+ update!(**args)
1678
+ end
1679
+
1680
+ # Update properties of this object
1681
+ def update!(**args)
1682
+ end
1683
+ end
1684
+
1685
+ # Response message for StarEntry. Empty for now
1686
+ class GoogleCloudDatacatalogV1StarEntryResponse
1687
+ include Google::Apis::Core::Hashable
1688
+
1689
+ def initialize(**args)
1690
+ update!(**args)
1691
+ end
1692
+
1693
+ # Update properties of this object
1694
+ def update!(**args)
1695
+ end
1696
+ end
1697
+
1609
1698
  # Timestamps associated with this resource in a particular system.
1610
1699
  class GoogleCloudDatacatalogV1SystemTimestamps
1611
1700
  include Google::Apis::Core::Hashable
@@ -1996,6 +2085,32 @@ module Google
1996
2085
  end
1997
2086
  end
1998
2087
 
2088
+ # Request message for UnstarEntry.
2089
+ class GoogleCloudDatacatalogV1UnstarEntryRequest
2090
+ include Google::Apis::Core::Hashable
2091
+
2092
+ def initialize(**args)
2093
+ update!(**args)
2094
+ end
2095
+
2096
+ # Update properties of this object
2097
+ def update!(**args)
2098
+ end
2099
+ end
2100
+
2101
+ # Response message for UnstarEntry. Empty for now
2102
+ class GoogleCloudDatacatalogV1UnstarEntryResponse
2103
+ include Google::Apis::Core::Hashable
2104
+
2105
+ def initialize(**args)
2106
+ update!(**args)
2107
+ end
2108
+
2109
+ # Update properties of this object
2110
+ def update!(**args)
2111
+ end
2112
+ end
2113
+
1999
2114
  # The set of all usage signals that Data Catalog stores. Note: Usually, these
2000
2115
  # signals are updated daily. In rare cases, an update may fail but will be
2001
2116
  # performed again on the next day.
@@ -2087,37 +2202,42 @@ module Google
2087
2202
 
2088
2203
  # An Identity and Access Management (IAM) policy, which specifies access
2089
2204
  # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
2090
- # A `binding` binds one or more `members` to a single `role`. Members can be
2091
- # user accounts, service accounts, Google groups, and domains (such as G Suite).
2092
- # A `role` is a named list of permissions; each `role` can be an IAM predefined
2093
- # role or a user-created custom role. For some types of Google Cloud resources,
2094
- # a `binding` can also specify a `condition`, which is a logical expression that
2095
- # allows access to a resource only if the expression evaluates to `true`. A
2096
- # condition can add constraints based on attributes of the request, the resource,
2097
- # or both. To learn which resources support conditions in their IAM policies,
2098
- # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
2099
- # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
2100
- # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
2101
- # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
2102
- # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
2103
- # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
2104
- # title": "expirable access", "description": "Does not grant access after Sep
2105
- # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
2106
- # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
2107
- # members: - user:mike@example.com - group:admins@example.com - domain:google.
2108
- # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
2109
- # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
2110
- # roles/resourcemanager.organizationViewer condition: title: expirable access
2111
- # description: Does not grant access after Sep 2020 expression: request.time <
2112
- # timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For a
2113
- # description of IAM and its features, see the [IAM documentation](https://cloud.
2114
- # google.com/iam/docs/).
2205
+ # A `binding` binds one or more `members`, or principals, to a single `role`.
2206
+ # Principals can be user accounts, service accounts, Google groups, and domains (
2207
+ # such as G Suite). A `role` is a named list of permissions; each `role` can be
2208
+ # an IAM predefined role or a user-created custom role. For some types of Google
2209
+ # Cloud resources, a `binding` can also specify a `condition`, which is a
2210
+ # logical expression that allows access to a resource only if the expression
2211
+ # evaluates to `true`. A condition can add constraints based on attributes of
2212
+ # the request, the resource, or both. To learn which resources support
2213
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
2214
+ # google.com/iam/help/conditions/resource-policies). **JSON example:** ` "
2215
+ # bindings": [ ` "role": "roles/resourcemanager.organizationAdmin", "members": [
2216
+ # "user:mike@example.com", "group:admins@example.com", "domain:google.com", "
2217
+ # serviceAccount:my-project-id@appspot.gserviceaccount.com" ] `, ` "role": "
2218
+ # roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com"
2219
+ # ], "condition": ` "title": "expirable access", "description": "Does not grant
2220
+ # access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:
2221
+ # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:**
2222
+ # bindings: - members: - user:mike@example.com - group:admins@example.com -
2223
+ # domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com
2224
+ # role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.
2225
+ # com role: roles/resourcemanager.organizationViewer condition: title: expirable
2226
+ # access description: Does not grant access after Sep 2020 expression: request.
2227
+ # time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For
2228
+ # a description of IAM and its features, see the [IAM documentation](https://
2229
+ # cloud.google.com/iam/docs/).
2115
2230
  class Policy
2116
2231
  include Google::Apis::Core::Hashable
2117
2232
 
2118
- # Associates a list of `members` to a `role`. Optionally, may specify a `
2119
- # condition` that determines how and when the `bindings` are applied. Each of
2120
- # the `bindings` must contain at least one member.
2233
+ # Associates a list of `members`, or principals, with a `role`. Optionally, may
2234
+ # specify a `condition` that determines how and when the `bindings` are applied.
2235
+ # Each of the `bindings` must contain at least one principal. The `bindings` in
2236
+ # a `Policy` can refer to up to 1,500 principals; up to 250 of these principals
2237
+ # can be Google groups. Each occurrence of a principal counts towards these
2238
+ # limits. For example, if the `bindings` grant 50 different roles to `user:alice@
2239
+ # example.com`, and not to any other principal, then you can add another 1,450
2240
+ # principals to the `bindings` in the `Policy`.
2121
2241
  # Corresponds to the JSON property `bindings`
2122
2242
  # @return [Array<Google::Apis::DatacatalogV1::Binding>]
2123
2243
  attr_accessor :bindings
@@ -2175,31 +2295,31 @@ module Google
2175
2295
 
2176
2296
  # An Identity and Access Management (IAM) policy, which specifies access
2177
2297
  # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
2178
- # A `binding` binds one or more `members` to a single `role`. Members can be
2179
- # user accounts, service accounts, Google groups, and domains (such as G Suite).
2180
- # A `role` is a named list of permissions; each `role` can be an IAM predefined
2181
- # role or a user-created custom role. For some types of Google Cloud resources,
2182
- # a `binding` can also specify a `condition`, which is a logical expression that
2183
- # allows access to a resource only if the expression evaluates to `true`. A
2184
- # condition can add constraints based on attributes of the request, the resource,
2185
- # or both. To learn which resources support conditions in their IAM policies,
2186
- # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
2187
- # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
2188
- # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
2189
- # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
2190
- # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
2191
- # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
2192
- # title": "expirable access", "description": "Does not grant access after Sep
2193
- # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
2194
- # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
2195
- # members: - user:mike@example.com - group:admins@example.com - domain:google.
2196
- # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
2197
- # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
2198
- # roles/resourcemanager.organizationViewer condition: title: expirable access
2199
- # description: Does not grant access after Sep 2020 expression: request.time <
2200
- # timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For a
2201
- # description of IAM and its features, see the [IAM documentation](https://cloud.
2202
- # google.com/iam/docs/).
2298
+ # A `binding` binds one or more `members`, or principals, to a single `role`.
2299
+ # Principals can be user accounts, service accounts, Google groups, and domains (
2300
+ # such as G Suite). A `role` is a named list of permissions; each `role` can be
2301
+ # an IAM predefined role or a user-created custom role. For some types of Google
2302
+ # Cloud resources, a `binding` can also specify a `condition`, which is a
2303
+ # logical expression that allows access to a resource only if the expression
2304
+ # evaluates to `true`. A condition can add constraints based on attributes of
2305
+ # the request, the resource, or both. To learn which resources support
2306
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
2307
+ # google.com/iam/help/conditions/resource-policies). **JSON example:** ` "
2308
+ # bindings": [ ` "role": "roles/resourcemanager.organizationAdmin", "members": [
2309
+ # "user:mike@example.com", "group:admins@example.com", "domain:google.com", "
2310
+ # serviceAccount:my-project-id@appspot.gserviceaccount.com" ] `, ` "role": "
2311
+ # roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com"
2312
+ # ], "condition": ` "title": "expirable access", "description": "Does not grant
2313
+ # access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:
2314
+ # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:**
2315
+ # bindings: - members: - user:mike@example.com - group:admins@example.com -
2316
+ # domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com
2317
+ # role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.
2318
+ # com role: roles/resourcemanager.organizationViewer condition: title: expirable
2319
+ # access description: Does not grant access after Sep 2020 expression: request.
2320
+ # time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For
2321
+ # a description of IAM and its features, see the [IAM documentation](https://
2322
+ # cloud.google.com/iam/docs/).
2203
2323
  # Corresponds to the JSON property `policy`
2204
2324
  # @return [Google::Apis::DatacatalogV1::Policy]
2205
2325
  attr_accessor :policy
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module DatacatalogV1
18
18
  # Version of the google-apis-datacatalog_v1 gem
19
- GEM_VERSION = "0.7.0"
19
+ GEM_VERSION = "0.11.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.4.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20210827"
25
+ REVISION = "20211201"
26
26
  end
27
27
  end
28
28
  end
@@ -208,6 +208,12 @@ module Google
208
208
  include Google::Apis::Core::JsonObjectSupport
209
209
  end
210
210
 
211
+ class GoogleCloudDatacatalogV1PersonalDetails
212
+ class Representation < Google::Apis::Core::JsonRepresentation; end
213
+
214
+ include Google::Apis::Core::JsonObjectSupport
215
+ end
216
+
211
217
  class GoogleCloudDatacatalogV1PolicyTag
212
218
  class Representation < Google::Apis::Core::JsonRepresentation; end
213
219
 
@@ -286,6 +292,18 @@ module Google
286
292
  include Google::Apis::Core::JsonObjectSupport
287
293
  end
288
294
 
295
+ class GoogleCloudDatacatalogV1StarEntryRequest
296
+ class Representation < Google::Apis::Core::JsonRepresentation; end
297
+
298
+ include Google::Apis::Core::JsonObjectSupport
299
+ end
300
+
301
+ class GoogleCloudDatacatalogV1StarEntryResponse
302
+ class Representation < Google::Apis::Core::JsonRepresentation; end
303
+
304
+ include Google::Apis::Core::JsonObjectSupport
305
+ end
306
+
289
307
  class GoogleCloudDatacatalogV1SystemTimestamps
290
308
  class Representation < Google::Apis::Core::JsonRepresentation; end
291
309
 
@@ -334,6 +352,18 @@ module Google
334
352
  include Google::Apis::Core::JsonObjectSupport
335
353
  end
336
354
 
355
+ class GoogleCloudDatacatalogV1UnstarEntryRequest
356
+ class Representation < Google::Apis::Core::JsonRepresentation; end
357
+
358
+ include Google::Apis::Core::JsonObjectSupport
359
+ end
360
+
361
+ class GoogleCloudDatacatalogV1UnstarEntryResponse
362
+ class Representation < Google::Apis::Core::JsonRepresentation; end
363
+
364
+ include Google::Apis::Core::JsonObjectSupport
365
+ end
366
+
337
367
  class GoogleCloudDatacatalogV1UsageSignal
338
368
  class Representation < Google::Apis::Core::JsonRepresentation; end
339
369
 
@@ -431,6 +461,7 @@ module Google
431
461
  # @private
432
462
  class Representation < Google::Apis::Core::JsonRepresentation
433
463
  property :dataset, as: 'dataset'
464
+ property :latest_shard_resource, as: 'latestShardResource'
434
465
  property :shard_count, :numeric_string => true, as: 'shardCount'
435
466
  property :table_prefix, as: 'tablePrefix'
436
467
  end
@@ -527,6 +558,8 @@ module Google
527
558
  hash :labels, as: 'labels'
528
559
  property :linked_resource, as: 'linkedResource'
529
560
  property :name, as: 'name'
561
+ property :personal_details, as: 'personalDetails', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1PersonalDetails, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1PersonalDetails::Representation
562
+
530
563
  property :routine_spec, as: 'routineSpec', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1RoutineSpec, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1RoutineSpec::Representation
531
564
 
532
565
  property :schema, as: 'schema', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Schema, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Schema::Representation
@@ -674,6 +707,14 @@ module Google
674
707
  end
675
708
  end
676
709
 
710
+ class GoogleCloudDatacatalogV1PersonalDetails
711
+ # @private
712
+ class Representation < Google::Apis::Core::JsonRepresentation
713
+ property :star_time, as: 'starTime'
714
+ property :starred, as: 'starred'
715
+ end
716
+ end
717
+
677
718
  class GoogleCloudDatacatalogV1PolicyTag
678
719
  # @private
679
720
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -758,6 +799,7 @@ module Google
758
799
  collection :include_project_ids, as: 'includeProjectIds'
759
800
  property :include_public_tag_templates, as: 'includePublicTagTemplates'
760
801
  collection :restricted_locations, as: 'restrictedLocations'
802
+ property :starred_only, as: 'starredOnly'
761
803
  end
762
804
  end
763
805
 
@@ -774,6 +816,8 @@ module Google
774
816
  class GoogleCloudDatacatalogV1SearchCatalogResult
775
817
  # @private
776
818
  class Representation < Google::Apis::Core::JsonRepresentation
819
+ property :description, as: 'description'
820
+ property :display_name, as: 'displayName'
777
821
  property :fully_qualified_name, as: 'fullyQualifiedName'
778
822
  property :integrated_system, as: 'integratedSystem'
779
823
  property :linked_resource, as: 'linkedResource'
@@ -807,6 +851,18 @@ module Google
807
851
  end
808
852
  end
809
853
 
854
+ class GoogleCloudDatacatalogV1StarEntryRequest
855
+ # @private
856
+ class Representation < Google::Apis::Core::JsonRepresentation
857
+ end
858
+ end
859
+
860
+ class GoogleCloudDatacatalogV1StarEntryResponse
861
+ # @private
862
+ class Representation < Google::Apis::Core::JsonRepresentation
863
+ end
864
+ end
865
+
810
866
  class GoogleCloudDatacatalogV1SystemTimestamps
811
867
  # @private
812
868
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -894,6 +950,18 @@ module Google
894
950
  end
895
951
  end
896
952
 
953
+ class GoogleCloudDatacatalogV1UnstarEntryRequest
954
+ # @private
955
+ class Representation < Google::Apis::Core::JsonRepresentation
956
+ end
957
+ end
958
+
959
+ class GoogleCloudDatacatalogV1UnstarEntryResponse
960
+ # @private
961
+ class Representation < Google::Apis::Core::JsonRepresentation
962
+ end
963
+ end
964
+
897
965
  class GoogleCloudDatacatalogV1UsageSignal
898
966
  # @private
899
967
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -621,7 +621,8 @@ module Google
621
621
  execute_or_queue_command(command, &block)
622
622
  end
623
623
 
624
- # Lists entries.
624
+ # Lists entries. Note: Currently, this method can list only custom entries. To
625
+ # get a list of both custom and automatically created entries, use SearchCatalog.
625
626
  # @param [String] parent
626
627
  # Required. The name of the entry group that contains the entries to list. Can
627
628
  # be provided in URL format.
@@ -714,6 +715,40 @@ module Google
714
715
  execute_or_queue_command(command, &block)
715
716
  end
716
717
 
718
+ # Marks an Entry as starred by the current user. Starring information is private
719
+ # to each user.
720
+ # @param [String] name
721
+ # Required. The name of the entry to mark as starred.
722
+ # @param [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1StarEntryRequest] google_cloud_datacatalog_v1_star_entry_request_object
723
+ # @param [String] fields
724
+ # Selector specifying which fields to include in a partial response.
725
+ # @param [String] quota_user
726
+ # Available to use for quota purposes for server-side applications. Can be any
727
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
728
+ # @param [Google::Apis::RequestOptions] options
729
+ # Request-specific options
730
+ #
731
+ # @yield [result, err] Result & error if block supplied
732
+ # @yieldparam result [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1StarEntryResponse] parsed result object
733
+ # @yieldparam err [StandardError] error object if request failed
734
+ #
735
+ # @return [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1StarEntryResponse]
736
+ #
737
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
738
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
739
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
740
+ def star_project_location_entry_group_entry(name, google_cloud_datacatalog_v1_star_entry_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
741
+ command = make_simple_command(:post, 'v1/{+name}:star', options)
742
+ command.request_representation = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1StarEntryRequest::Representation
743
+ command.request_object = google_cloud_datacatalog_v1_star_entry_request_object
744
+ command.response_representation = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1StarEntryResponse::Representation
745
+ command.response_class = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1StarEntryResponse
746
+ command.params['name'] = name unless name.nil?
747
+ command.query['fields'] = fields unless fields.nil?
748
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
749
+ execute_or_queue_command(command, &block)
750
+ end
751
+
717
752
  # Gets your permissions on a resource. Returns an empty set of permissions if
718
753
  # the resource doesn't exist. Supported resources are: - Tag templates - Entry
719
754
  # groups Note: This method gets policies only within Data Catalog and can't be
@@ -753,14 +788,48 @@ module Google
753
788
  execute_or_queue_command(command, &block)
754
789
  end
755
790
 
756
- # Creates a tag and assigns it to: * An Entry if the method name is ``projects.
757
- # locations.entryGroups.entries.tags.create``. * Or EntryGroupif the method name
758
- # is ``projects.locations.entryGroups.tags.create``. Note: The project
759
- # identified by the `parent` parameter for the [tag] (https://cloud.google.com/
760
- # data-catalog/docs/reference/rest/v1/projects.locations.entryGroups.entries.
761
- # tags/create#path-parameters) and the [tag template] (https://cloud.google.com/
762
- # data-catalog/docs/reference/rest/v1/projects.locations.tagTemplates/create#
763
- # path-parameters) used to create the tag must be in the same organization.
791
+ # Marks an Entry as NOT starred by the current user. Starring information is
792
+ # private to each user.
793
+ # @param [String] name
794
+ # Required. The name of the entry to mark as **not** starred.
795
+ # @param [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1UnstarEntryRequest] google_cloud_datacatalog_v1_unstar_entry_request_object
796
+ # @param [String] fields
797
+ # Selector specifying which fields to include in a partial response.
798
+ # @param [String] quota_user
799
+ # Available to use for quota purposes for server-side applications. Can be any
800
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
801
+ # @param [Google::Apis::RequestOptions] options
802
+ # Request-specific options
803
+ #
804
+ # @yield [result, err] Result & error if block supplied
805
+ # @yieldparam result [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1UnstarEntryResponse] parsed result object
806
+ # @yieldparam err [StandardError] error object if request failed
807
+ #
808
+ # @return [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1UnstarEntryResponse]
809
+ #
810
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
811
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
812
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
813
+ def unstar_project_location_entry_group_entry(name, google_cloud_datacatalog_v1_unstar_entry_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
814
+ command = make_simple_command(:post, 'v1/{+name}:unstar', options)
815
+ command.request_representation = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1UnstarEntryRequest::Representation
816
+ command.request_object = google_cloud_datacatalog_v1_unstar_entry_request_object
817
+ command.response_representation = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1UnstarEntryResponse::Representation
818
+ command.response_class = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1UnstarEntryResponse
819
+ command.params['name'] = name unless name.nil?
820
+ command.query['fields'] = fields unless fields.nil?
821
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
822
+ execute_or_queue_command(command, &block)
823
+ end
824
+
825
+ # Creates a tag and assigns it to: * An Entry if the method name is `projects.
826
+ # locations.entryGroups.entries.tags.create`. * Or EntryGroupif the method name
827
+ # is `projects.locations.entryGroups.tags.create`. Note: The project identified
828
+ # by the `parent` parameter for the [tag] (https://cloud.google.com/data-catalog/
829
+ # docs/reference/rest/v1/projects.locations.entryGroups.entries.tags/create#path-
830
+ # parameters) and the [tag template] (https://cloud.google.com/data-catalog/docs/
831
+ # reference/rest/v1/projects.locations.tagTemplates/create#path-parameters) used
832
+ # to create the tag must be in the same organization.
764
833
  # @param [String] parent
765
834
  # Required. The name of the resource to attach this tag to. Tags can be attached
766
835
  # to entries or entry groups. An entry can have up to 1000 attached tags. Note:
@@ -906,14 +975,14 @@ module Google
906
975
  execute_or_queue_command(command, &block)
907
976
  end
908
977
 
909
- # Creates a tag and assigns it to: * An Entry if the method name is ``projects.
910
- # locations.entryGroups.entries.tags.create``. * Or EntryGroupif the method name
911
- # is ``projects.locations.entryGroups.tags.create``. Note: The project
912
- # identified by the `parent` parameter for the [tag] (https://cloud.google.com/
913
- # data-catalog/docs/reference/rest/v1/projects.locations.entryGroups.entries.
914
- # tags/create#path-parameters) and the [tag template] (https://cloud.google.com/
915
- # data-catalog/docs/reference/rest/v1/projects.locations.tagTemplates/create#
916
- # path-parameters) used to create the tag must be in the same organization.
978
+ # Creates a tag and assigns it to: * An Entry if the method name is `projects.
979
+ # locations.entryGroups.entries.tags.create`. * Or EntryGroupif the method name
980
+ # is `projects.locations.entryGroups.tags.create`. Note: The project identified
981
+ # by the `parent` parameter for the [tag] (https://cloud.google.com/data-catalog/
982
+ # docs/reference/rest/v1/projects.locations.entryGroups.entries.tags/create#path-
983
+ # parameters) and the [tag template] (https://cloud.google.com/data-catalog/docs/
984
+ # reference/rest/v1/projects.locations.tagTemplates/create#path-parameters) used
985
+ # to create the tag must be in the same organization.
917
986
  # @param [String] parent
918
987
  # Required. The name of the resource to attach this tag to. Tags can be attached
919
988
  # to entries or entry groups. An entry can have up to 1000 attached tags. Note:
@@ -1224,9 +1293,12 @@ module Google
1224
1293
  # @param [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1TagTemplate] google_cloud_datacatalog_v1_tag_template_object
1225
1294
  # @param [String] update_mask
1226
1295
  # Names of fields whose values to overwrite on a tag template. Currently, only `
1227
- # display_name` can be overwritten. If this parameter is absent or empty, all
1228
- # modifiable fields are overwritten. If such fields are non-required and omitted
1229
- # in the request body, their values are emptied.
1296
+ # display_name` and `is_publicly_readable` can be overwritten. If this parameter
1297
+ # is absent or empty, all modifiable fields are overwritten. If such fields are
1298
+ # non-required and omitted in the request body, their values are emptied. Note:
1299
+ # Updating the `is_publicly_readable` field may require up to 12 hours to take
1300
+ # effect in search results. Additionally, it also requires the `tagTemplates.
1301
+ # getIamPolicy` and `tagTemplates.setIamPolicy` permissions.
1230
1302
  # @param [String] fields
1231
1303
  # Selector specifying which fields to include in a partial response.
1232
1304
  # @param [String] quota_user
@@ -1471,7 +1543,7 @@ module Google
1471
1543
  # Catalog resource project] (https://cloud.google.com/data-catalog/docs/concepts/
1472
1544
  # resource-project).
1473
1545
  # @param [String] name
1474
- # Required. The name of the tag template.
1546
+ # Required. The name of the tag template field.
1475
1547
  # @param [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1RenameTagTemplateFieldRequest] google_cloud_datacatalog_v1_rename_tag_template_field_request_object
1476
1548
  # @param [String] fields
1477
1549
  # Selector specifying which fields to include in a partial response.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-datacatalog_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.7.0
4
+ version: 0.11.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-09-06 00:00:00.000000000 Z
11
+ date: 2021-12-13 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -57,9 +57,9 @@ licenses:
57
57
  - Apache-2.0
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
- changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-datacatalog_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-datacatalog_v1/v0.7.0
62
- source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-datacatalog_v1
60
+ changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datacatalog_v1/CHANGELOG.md
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-datacatalog_v1/v0.11.0
62
+ source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datacatalog_v1
63
63
  post_install_message:
64
64
  rdoc_options: []
65
65
  require_paths: