google-cloud-asset-v1 0.27.0 → 0.28.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: ce8dc4fea3414af0a84ee4b12cf7c991b4a6bd44dc1a86339cc70ffb514bad35
4
- data.tar.gz: 3798fd9b888bb17b535f979a31e982b70a95c8111ab979961e8b044eced9b95d
3
+ metadata.gz: 01243b2f7e69373b2cfbd53589a2a22992428f3cd31eecdd121a6fa07f9d77b8
4
+ data.tar.gz: bc8c8cb91bb50b4a4c3517e515c696933f9c45e6afb068ced6f5579f5cf19d1e
5
5
  SHA512:
6
- metadata.gz: e8f68cbe594e330ae2029da80fafe4a049ec88709ca9de00d38100b8c574c0f722be312914d8f0e50c541d77d3e9e1bf8f5e130b8ccc6b2345d7f186c857f2fb
7
- data.tar.gz: 8457d1254fb5b7bc87c4b2f379de5bcc56c88838a8956bd3980525e7f34d05b00c929ad2f2aefc2e64fc63d8c13a675a057474a5d630e6db4afd829a8d1555fd
6
+ metadata.gz: 8fa655567ef6f712b3c58f8aaf7b3b24e5bc4c78d2348c2695b1f1471dbf650ebb2e2e2f258432de9c52e2a5110cde54d6fb4ff51d14922e150b5b007ca4528a
7
+ data.tar.gz: 76e6fe824da276ba998685fea9f7bfb187116c40d0b44ea2d05697a9c6354060115d7c8e470a3fc71200c3fe32b0bd5e7d5bb6e6b023a95285c01a7908203930
@@ -1174,49 +1174,73 @@ module Google
1174
1174
  # Examples:
1175
1175
  #
1176
1176
  # * `name:Important` to find Google Cloud resources whose name contains
1177
- # "Important" as a word.
1177
+ # `Important` as a word.
1178
1178
  # * `name=Important` to find the Google Cloud resource whose name is exactly
1179
- # "Important".
1179
+ # `Important`.
1180
1180
  # * `displayName:Impor*` to find Google Cloud resources whose display name
1181
- # contains "Impor" as a prefix of any word in the field.
1181
+ # contains `Impor` as a prefix of any word in the field.
1182
1182
  # * `location:us-west*` to find Google Cloud resources whose location
1183
- # contains both "us" and "west" as prefixes.
1184
- # * `labels:prod` to find Google Cloud resources whose labels contain "prod"
1183
+ # contains both `us` and `west` as prefixes.
1184
+ # * `labels:prod` to find Google Cloud resources whose labels contain `prod`
1185
1185
  # as a key or value.
1186
- # * `labels.env:prod` to find Google Cloud resources that have a label "env"
1187
- # and its value is "prod".
1188
- # * `labels.env:*` to find Google Cloud resources that have a label "env".
1186
+ # * `labels.env:prod` to find Google Cloud resources that have a label `env`
1187
+ # and its value is `prod`.
1188
+ # * `labels.env:*` to find Google Cloud resources that have a label `env`.
1189
+ # * `tagKeys:env` to find Google Cloud resources that have directly
1190
+ # attached tags where the
1191
+ # [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey)
1192
+ # .`namespacedName` contains `env`.
1193
+ # * `tagValues:prod*` to find Google Cloud resources that have directly
1194
+ # attached tags where the
1195
+ # [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
1196
+ # .`namespacedName` contains a word prefixed by `prod`.
1197
+ # * `tagValueIds=tagValues/123` to find Google Cloud resources that have
1198
+ # directly attached tags where the
1199
+ # [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
1200
+ # .`name` is exactly `tagValues/123`.
1201
+ # * `effectiveTagKeys:env` to find Google Cloud resources that have
1202
+ # directly attached or inherited tags where the
1203
+ # [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey)
1204
+ # .`namespacedName` contains `env`.
1205
+ # * `effectiveTagValues:prod*` to find Google Cloud resources that have
1206
+ # directly attached or inherited tags where the
1207
+ # [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
1208
+ # .`namespacedName` contains a word prefixed by `prod`.
1209
+ # * `effectiveTagValueIds=tagValues/123` to find Google Cloud resources that
1210
+ # have directly attached or inherited tags where the
1211
+ # [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
1212
+ # .`name` is exactly `tagValues/123`.
1189
1213
  # * `kmsKey:key` to find Google Cloud resources encrypted with a
1190
- # customer-managed encryption key whose name contains "key" as a word. This
1214
+ # customer-managed encryption key whose name contains `key` as a word. This
1191
1215
  # field is deprecated. Please use the `kmsKeys` field to retrieve Cloud KMS
1192
1216
  # key information.
1193
1217
  # * `kmsKeys:key` to find Google Cloud resources encrypted with
1194
- # customer-managed encryption keys whose name contains the word "key".
1218
+ # customer-managed encryption keys whose name contains the word `key`.
1195
1219
  # * `relationships:instance-group-1` to find Google Cloud resources that have
1196
- # relationships with "instance-group-1" in the related resource name.
1220
+ # relationships with `instance-group-1` in the related resource name.
1197
1221
  # * `relationships:INSTANCE_TO_INSTANCEGROUP` to find Compute Engine
1198
- # instances that have relationships of type "INSTANCE_TO_INSTANCEGROUP".
1222
+ # instances that have relationships of type `INSTANCE_TO_INSTANCEGROUP`.
1199
1223
  # * `relationships.INSTANCE_TO_INSTANCEGROUP:instance-group-1` to find
1200
- # Compute Engine instances that have relationships with "instance-group-1"
1224
+ # Compute Engine instances that have relationships with `instance-group-1`
1201
1225
  # in the Compute Engine instance group resource name, for relationship type
1202
- # "INSTANCE_TO_INSTANCEGROUP".
1226
+ # `INSTANCE_TO_INSTANCEGROUP`.
1203
1227
  # * `state:ACTIVE` to find Google Cloud resources whose state contains
1204
- # "ACTIVE" as a word.
1228
+ # `ACTIVE` as a word.
1205
1229
  # * `NOT state:ACTIVE` to find Google Cloud resources whose state doesn't
1206
- # contain "ACTIVE" as a word.
1230
+ # contain `ACTIVE` as a word.
1207
1231
  # * `createTime<1609459200` to find Google Cloud resources that were created
1208
- # before "2021-01-01 00:00:00 UTC". 1609459200 is the epoch timestamp of
1209
- # "2021-01-01 00:00:00 UTC" in seconds.
1232
+ # before `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of
1233
+ # `2021-01-01 00:00:00 UTC` in seconds.
1210
1234
  # * `updateTime>1609459200` to find Google Cloud resources that were updated
1211
- # after "2021-01-01 00:00:00 UTC". 1609459200 is the epoch timestamp of
1212
- # "2021-01-01 00:00:00 UTC" in seconds.
1213
- # * `Important` to find Google Cloud resources that contain "Important" as a
1235
+ # after `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of
1236
+ # `2021-01-01 00:00:00 UTC` in seconds.
1237
+ # * `Important` to find Google Cloud resources that contain `Important` as a
1214
1238
  # word in any of the searchable fields.
1215
- # * `Impor*` to find Google Cloud resources that contain "Impor" as a prefix
1239
+ # * `Impor*` to find Google Cloud resources that contain `Impor` as a prefix
1216
1240
  # of any word in any of the searchable fields.
1217
1241
  # * `Important location:(us-west1 OR global)` to find Google Cloud
1218
- # resources that contain "Important" as a word in any of the searchable
1219
- # fields and are also located in the "us-west1" region or the "global"
1242
+ # resources that contain `Important` as a word in any of the searchable
1243
+ # fields and are also located in the `us-west1` region or the `global`
1220
1244
  # location.
1221
1245
  # @param asset_types [::Array<::String>]
1222
1246
  # Optional. A list of asset types that this request searches for. If empty,
@@ -1235,10 +1259,10 @@ module Google
1235
1259
  # supported asset type, an INVALID_ARGUMENT error will be returned.
1236
1260
  # @param page_size [::Integer]
1237
1261
  # Optional. The page size for search result pagination. Page size is capped
1238
- # at 500 even if a larger value is given. If set to zero, server will pick an
1239
- # appropriate default. Returned results may be fewer than requested. When
1240
- # this happens, there could be more results as long as `next_page_token` is
1241
- # returned.
1262
+ # at 500 even if a larger value is given. If set to zero or a negative value,
1263
+ # server will pick an appropriate default. Returned results may be fewer than
1264
+ # requested. When this happens, there could be more results as long as
1265
+ # `next_page_token` is returned.
1242
1266
  # @param page_token [::String]
1243
1267
  # Optional. If present, then retrieve the next batch of results from the
1244
1268
  # preceding call to this method. `page_token` must be the value of
@@ -1249,7 +1273,7 @@ module Google
1249
1273
  # the results. The default order is ascending. Add " DESC" after the field
1250
1274
  # name to indicate descending order. Redundant space characters are ignored.
1251
1275
  # Example: "location DESC, name".
1252
- # Only singular primitive fields in the response are sortable:
1276
+ # Only the following fields in the response are sortable:
1253
1277
  #
1254
1278
  # * name
1255
1279
  # * assetType
@@ -1262,43 +1286,37 @@ module Google
1262
1286
  # * state
1263
1287
  # * parentFullResourceName
1264
1288
  # * parentAssetType
1265
- #
1266
- # All the other fields such as repeated fields (e.g., `networkTags`,
1267
- # `kmsKeys`), map fields (e.g., `labels`) and struct fields (e.g.,
1268
- # `additionalAttributes`) are not supported.
1269
1289
  # @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
1270
- # Optional. A comma-separated list of fields specifying which fields to be
1271
- # returned in ResourceSearchResult. Only '*' or combination of top level
1272
- # fields can be specified. Field names of both snake_case and camelCase are
1273
- # supported. Examples: `"*"`, `"name,location"`, `"name,versionedResources"`.
1274
- #
1275
- # The read_mask paths must be valid field paths listed but not limited to
1276
- # (both snake_case and camelCase are supported):
1277
- #
1278
- # * name
1279
- # * assetType
1280
- # * project
1281
- # * displayName
1282
- # * description
1283
- # * location
1284
- # * tagKeys
1285
- # * tagValues
1286
- # * tagValueIds
1287
- # * labels
1288
- # * networkTags
1289
- # * kmsKey (This field is deprecated. Please use the `kmsKeys` field to
1290
- # retrieve Cloud KMS key information.)
1291
- # * kmsKeys
1292
- # * createTime
1293
- # * updateTime
1294
- # * state
1295
- # * additionalAttributes
1296
- # * versionedResources
1297
- #
1298
- # If read_mask is not specified, all fields except versionedResources will
1299
- # be returned.
1300
- # If only '*' is specified, all fields including versionedResources will be
1301
- # returned.
1290
+ # Optional. A comma-separated list of fields that you want returned in the
1291
+ # results. The following fields are returned by default if not specified:
1292
+ #
1293
+ # * `name`
1294
+ # * `assetType`
1295
+ # * `project`
1296
+ # * `folders`
1297
+ # * `organization`
1298
+ # * `displayName`
1299
+ # * `description`
1300
+ # * `location`
1301
+ # * `labels`
1302
+ # * `tags`
1303
+ # * `effectiveTags`
1304
+ # * `networkTags`
1305
+ # * `kmsKeys`
1306
+ # * `createTime`
1307
+ # * `updateTime`
1308
+ # * `state`
1309
+ # * `additionalAttributes`
1310
+ # * `parentFullResourceName`
1311
+ # * `parentAssetType`
1312
+ #
1313
+ # Some fields of large size, such as `versionedResources`,
1314
+ # `attachedResources`, `effectiveTags` etc., are not returned by default, but
1315
+ # you can specify them in the `read_mask` parameter if you want to include
1316
+ # them. If `"*"` is specified, all [available
1317
+ # fields](https://cloud.google.com/asset-inventory/docs/reference/rest/v1/TopLevel/searchAllResources#resourcesearchresult)
1318
+ # are returned.
1319
+ # Examples: `"name,location"`, `"name,versionedResources"`, `"*"`.
1302
1320
  # Any invalid field path will trigger INVALID_ARGUMENT error.
1303
1321
  #
1304
1322
  # @yield [response, operation] Access the result along with the RPC operation
@@ -1449,10 +1467,10 @@ module Google
1449
1467
  # principal type "user".
1450
1468
  # @param page_size [::Integer]
1451
1469
  # Optional. The page size for search result pagination. Page size is capped
1452
- # at 500 even if a larger value is given. If set to zero, server will pick an
1453
- # appropriate default. Returned results may be fewer than requested. When
1454
- # this happens, there could be more results as long as `next_page_token` is
1455
- # returned.
1470
+ # at 500 even if a larger value is given. If set to zero or a negative value,
1471
+ # server will pick an appropriate default. Returned results may be fewer than
1472
+ # requested. When this happens, there could be more results as long as
1473
+ # `next_page_token` is returned.
1456
1474
  # @param page_token [::String]
1457
1475
  # Optional. If present, retrieve the next batch of results from the preceding
1458
1476
  # call to this method. `page_token` must be the value of `next_page_token`
@@ -1897,8 +1915,7 @@ module Google
1897
1915
 
1898
1916
  ##
1899
1917
  # Issue a job that queries assets using a SQL statement compatible with
1900
- # [BigQuery Standard
1901
- # SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
1918
+ # [BigQuery SQL](https://cloud.google.com/bigquery/docs/introduction-sql).
1902
1919
  #
1903
1920
  # If the query execution finishes within timeout and there's no pagination,
1904
1921
  # the full query results will be returned in the `QueryAssetsResponse`.
@@ -1907,9 +1924,8 @@ module Google
1907
1924
  # with the `job_reference` from the a previous `QueryAssets` call.
1908
1925
  #
1909
1926
  # Note, the query result has approximately 10 GB limitation enforced by
1910
- # BigQuery
1911
- # https://cloud.google.com/bigquery/docs/best-practices-performance-output,
1912
- # queries return larger results will result in errors.
1927
+ # [BigQuery](https://cloud.google.com/bigquery/docs/best-practices-performance-output).
1928
+ # Queries return larger results will result in errors.
1913
1929
  #
1914
1930
  # @overload query_assets(request, options = nil)
1915
1931
  # Pass arguments to `query_assets` via a request object, either of type
@@ -1934,8 +1950,8 @@ module Google
1934
1950
  #
1935
1951
  # Only assets belonging to the `parent` will be returned.
1936
1952
  # @param statement [::String]
1937
- # Optional. A SQL statement that's compatible with [BigQuery Standard
1938
- # SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
1953
+ # Optional. A SQL statement that's compatible with [BigQuery
1954
+ # SQL](https://cloud.google.com/bigquery/docs/introduction-sql).
1939
1955
  # @param job_reference [::String]
1940
1956
  # Optional. Reference to the query job, which is from the
1941
1957
  # `QueryAssetsResponse` of previous `QueryAssets` call.
@@ -1108,49 +1108,73 @@ module Google
1108
1108
  # Examples:
1109
1109
  #
1110
1110
  # * `name:Important` to find Google Cloud resources whose name contains
1111
- # "Important" as a word.
1111
+ # `Important` as a word.
1112
1112
  # * `name=Important` to find the Google Cloud resource whose name is exactly
1113
- # "Important".
1113
+ # `Important`.
1114
1114
  # * `displayName:Impor*` to find Google Cloud resources whose display name
1115
- # contains "Impor" as a prefix of any word in the field.
1115
+ # contains `Impor` as a prefix of any word in the field.
1116
1116
  # * `location:us-west*` to find Google Cloud resources whose location
1117
- # contains both "us" and "west" as prefixes.
1118
- # * `labels:prod` to find Google Cloud resources whose labels contain "prod"
1117
+ # contains both `us` and `west` as prefixes.
1118
+ # * `labels:prod` to find Google Cloud resources whose labels contain `prod`
1119
1119
  # as a key or value.
1120
- # * `labels.env:prod` to find Google Cloud resources that have a label "env"
1121
- # and its value is "prod".
1122
- # * `labels.env:*` to find Google Cloud resources that have a label "env".
1120
+ # * `labels.env:prod` to find Google Cloud resources that have a label `env`
1121
+ # and its value is `prod`.
1122
+ # * `labels.env:*` to find Google Cloud resources that have a label `env`.
1123
+ # * `tagKeys:env` to find Google Cloud resources that have directly
1124
+ # attached tags where the
1125
+ # [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey)
1126
+ # .`namespacedName` contains `env`.
1127
+ # * `tagValues:prod*` to find Google Cloud resources that have directly
1128
+ # attached tags where the
1129
+ # [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
1130
+ # .`namespacedName` contains a word prefixed by `prod`.
1131
+ # * `tagValueIds=tagValues/123` to find Google Cloud resources that have
1132
+ # directly attached tags where the
1133
+ # [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
1134
+ # .`name` is exactly `tagValues/123`.
1135
+ # * `effectiveTagKeys:env` to find Google Cloud resources that have
1136
+ # directly attached or inherited tags where the
1137
+ # [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey)
1138
+ # .`namespacedName` contains `env`.
1139
+ # * `effectiveTagValues:prod*` to find Google Cloud resources that have
1140
+ # directly attached or inherited tags where the
1141
+ # [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
1142
+ # .`namespacedName` contains a word prefixed by `prod`.
1143
+ # * `effectiveTagValueIds=tagValues/123` to find Google Cloud resources that
1144
+ # have directly attached or inherited tags where the
1145
+ # [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
1146
+ # .`name` is exactly `tagValues/123`.
1123
1147
  # * `kmsKey:key` to find Google Cloud resources encrypted with a
1124
- # customer-managed encryption key whose name contains "key" as a word. This
1148
+ # customer-managed encryption key whose name contains `key` as a word. This
1125
1149
  # field is deprecated. Please use the `kmsKeys` field to retrieve Cloud KMS
1126
1150
  # key information.
1127
1151
  # * `kmsKeys:key` to find Google Cloud resources encrypted with
1128
- # customer-managed encryption keys whose name contains the word "key".
1152
+ # customer-managed encryption keys whose name contains the word `key`.
1129
1153
  # * `relationships:instance-group-1` to find Google Cloud resources that have
1130
- # relationships with "instance-group-1" in the related resource name.
1154
+ # relationships with `instance-group-1` in the related resource name.
1131
1155
  # * `relationships:INSTANCE_TO_INSTANCEGROUP` to find Compute Engine
1132
- # instances that have relationships of type "INSTANCE_TO_INSTANCEGROUP".
1156
+ # instances that have relationships of type `INSTANCE_TO_INSTANCEGROUP`.
1133
1157
  # * `relationships.INSTANCE_TO_INSTANCEGROUP:instance-group-1` to find
1134
- # Compute Engine instances that have relationships with "instance-group-1"
1158
+ # Compute Engine instances that have relationships with `instance-group-1`
1135
1159
  # in the Compute Engine instance group resource name, for relationship type
1136
- # "INSTANCE_TO_INSTANCEGROUP".
1160
+ # `INSTANCE_TO_INSTANCEGROUP`.
1137
1161
  # * `state:ACTIVE` to find Google Cloud resources whose state contains
1138
- # "ACTIVE" as a word.
1162
+ # `ACTIVE` as a word.
1139
1163
  # * `NOT state:ACTIVE` to find Google Cloud resources whose state doesn't
1140
- # contain "ACTIVE" as a word.
1164
+ # contain `ACTIVE` as a word.
1141
1165
  # * `createTime<1609459200` to find Google Cloud resources that were created
1142
- # before "2021-01-01 00:00:00 UTC". 1609459200 is the epoch timestamp of
1143
- # "2021-01-01 00:00:00 UTC" in seconds.
1166
+ # before `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of
1167
+ # `2021-01-01 00:00:00 UTC` in seconds.
1144
1168
  # * `updateTime>1609459200` to find Google Cloud resources that were updated
1145
- # after "2021-01-01 00:00:00 UTC". 1609459200 is the epoch timestamp of
1146
- # "2021-01-01 00:00:00 UTC" in seconds.
1147
- # * `Important` to find Google Cloud resources that contain "Important" as a
1169
+ # after `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of
1170
+ # `2021-01-01 00:00:00 UTC` in seconds.
1171
+ # * `Important` to find Google Cloud resources that contain `Important` as a
1148
1172
  # word in any of the searchable fields.
1149
- # * `Impor*` to find Google Cloud resources that contain "Impor" as a prefix
1173
+ # * `Impor*` to find Google Cloud resources that contain `Impor` as a prefix
1150
1174
  # of any word in any of the searchable fields.
1151
1175
  # * `Important location:(us-west1 OR global)` to find Google Cloud
1152
- # resources that contain "Important" as a word in any of the searchable
1153
- # fields and are also located in the "us-west1" region or the "global"
1176
+ # resources that contain `Important` as a word in any of the searchable
1177
+ # fields and are also located in the `us-west1` region or the `global`
1154
1178
  # location.
1155
1179
  # @param asset_types [::Array<::String>]
1156
1180
  # Optional. A list of asset types that this request searches for. If empty,
@@ -1169,10 +1193,10 @@ module Google
1169
1193
  # supported asset type, an INVALID_ARGUMENT error will be returned.
1170
1194
  # @param page_size [::Integer]
1171
1195
  # Optional. The page size for search result pagination. Page size is capped
1172
- # at 500 even if a larger value is given. If set to zero, server will pick an
1173
- # appropriate default. Returned results may be fewer than requested. When
1174
- # this happens, there could be more results as long as `next_page_token` is
1175
- # returned.
1196
+ # at 500 even if a larger value is given. If set to zero or a negative value,
1197
+ # server will pick an appropriate default. Returned results may be fewer than
1198
+ # requested. When this happens, there could be more results as long as
1199
+ # `next_page_token` is returned.
1176
1200
  # @param page_token [::String]
1177
1201
  # Optional. If present, then retrieve the next batch of results from the
1178
1202
  # preceding call to this method. `page_token` must be the value of
@@ -1183,7 +1207,7 @@ module Google
1183
1207
  # the results. The default order is ascending. Add " DESC" after the field
1184
1208
  # name to indicate descending order. Redundant space characters are ignored.
1185
1209
  # Example: "location DESC, name".
1186
- # Only singular primitive fields in the response are sortable:
1210
+ # Only the following fields in the response are sortable:
1187
1211
  #
1188
1212
  # * name
1189
1213
  # * assetType
@@ -1196,43 +1220,37 @@ module Google
1196
1220
  # * state
1197
1221
  # * parentFullResourceName
1198
1222
  # * parentAssetType
1199
- #
1200
- # All the other fields such as repeated fields (e.g., `networkTags`,
1201
- # `kmsKeys`), map fields (e.g., `labels`) and struct fields (e.g.,
1202
- # `additionalAttributes`) are not supported.
1203
1223
  # @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
1204
- # Optional. A comma-separated list of fields specifying which fields to be
1205
- # returned in ResourceSearchResult. Only '*' or combination of top level
1206
- # fields can be specified. Field names of both snake_case and camelCase are
1207
- # supported. Examples: `"*"`, `"name,location"`, `"name,versionedResources"`.
1208
- #
1209
- # The read_mask paths must be valid field paths listed but not limited to
1210
- # (both snake_case and camelCase are supported):
1211
- #
1212
- # * name
1213
- # * assetType
1214
- # * project
1215
- # * displayName
1216
- # * description
1217
- # * location
1218
- # * tagKeys
1219
- # * tagValues
1220
- # * tagValueIds
1221
- # * labels
1222
- # * networkTags
1223
- # * kmsKey (This field is deprecated. Please use the `kmsKeys` field to
1224
- # retrieve Cloud KMS key information.)
1225
- # * kmsKeys
1226
- # * createTime
1227
- # * updateTime
1228
- # * state
1229
- # * additionalAttributes
1230
- # * versionedResources
1231
- #
1232
- # If read_mask is not specified, all fields except versionedResources will
1233
- # be returned.
1234
- # If only '*' is specified, all fields including versionedResources will be
1235
- # returned.
1224
+ # Optional. A comma-separated list of fields that you want returned in the
1225
+ # results. The following fields are returned by default if not specified:
1226
+ #
1227
+ # * `name`
1228
+ # * `assetType`
1229
+ # * `project`
1230
+ # * `folders`
1231
+ # * `organization`
1232
+ # * `displayName`
1233
+ # * `description`
1234
+ # * `location`
1235
+ # * `labels`
1236
+ # * `tags`
1237
+ # * `effectiveTags`
1238
+ # * `networkTags`
1239
+ # * `kmsKeys`
1240
+ # * `createTime`
1241
+ # * `updateTime`
1242
+ # * `state`
1243
+ # * `additionalAttributes`
1244
+ # * `parentFullResourceName`
1245
+ # * `parentAssetType`
1246
+ #
1247
+ # Some fields of large size, such as `versionedResources`,
1248
+ # `attachedResources`, `effectiveTags` etc., are not returned by default, but
1249
+ # you can specify them in the `read_mask` parameter if you want to include
1250
+ # them. If `"*"` is specified, all [available
1251
+ # fields](https://cloud.google.com/asset-inventory/docs/reference/rest/v1/TopLevel/searchAllResources#resourcesearchresult)
1252
+ # are returned.
1253
+ # Examples: `"name,location"`, `"name,versionedResources"`, `"*"`.
1236
1254
  # Any invalid field path will trigger INVALID_ARGUMENT error.
1237
1255
  # @yield [result, operation] Access the result along with the TransportOperation object
1238
1256
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::ResourceSearchResult>]
@@ -1376,10 +1394,10 @@ module Google
1376
1394
  # principal type "user".
1377
1395
  # @param page_size [::Integer]
1378
1396
  # Optional. The page size for search result pagination. Page size is capped
1379
- # at 500 even if a larger value is given. If set to zero, server will pick an
1380
- # appropriate default. Returned results may be fewer than requested. When
1381
- # this happens, there could be more results as long as `next_page_token` is
1382
- # returned.
1397
+ # at 500 even if a larger value is given. If set to zero or a negative value,
1398
+ # server will pick an appropriate default. Returned results may be fewer than
1399
+ # requested. When this happens, there could be more results as long as
1400
+ # `next_page_token` is returned.
1383
1401
  # @param page_token [::String]
1384
1402
  # Optional. If present, retrieve the next batch of results from the preceding
1385
1403
  # call to this method. `page_token` must be the value of `next_page_token`
@@ -1796,8 +1814,7 @@ module Google
1796
1814
 
1797
1815
  ##
1798
1816
  # Issue a job that queries assets using a SQL statement compatible with
1799
- # [BigQuery Standard
1800
- # SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
1817
+ # [BigQuery SQL](https://cloud.google.com/bigquery/docs/introduction-sql).
1801
1818
  #
1802
1819
  # If the query execution finishes within timeout and there's no pagination,
1803
1820
  # the full query results will be returned in the `QueryAssetsResponse`.
@@ -1806,9 +1823,8 @@ module Google
1806
1823
  # with the `job_reference` from the a previous `QueryAssets` call.
1807
1824
  #
1808
1825
  # Note, the query result has approximately 10 GB limitation enforced by
1809
- # BigQuery
1810
- # https://cloud.google.com/bigquery/docs/best-practices-performance-output,
1811
- # queries return larger results will result in errors.
1826
+ # [BigQuery](https://cloud.google.com/bigquery/docs/best-practices-performance-output).
1827
+ # Queries return larger results will result in errors.
1812
1828
  #
1813
1829
  # @overload query_assets(request, options = nil)
1814
1830
  # Pass arguments to `query_assets` via a request object, either of type
@@ -1833,8 +1849,8 @@ module Google
1833
1849
  #
1834
1850
  # Only assets belonging to the `parent` will be returned.
1835
1851
  # @param statement [::String]
1836
- # Optional. A SQL statement that's compatible with [BigQuery Standard
1837
- # SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
1852
+ # Optional. A SQL statement that's compatible with [BigQuery
1853
+ # SQL](https://cloud.google.com/bigquery/docs/introduction-sql).
1838
1854
  # @param job_reference [::String]
1839
1855
  # Optional. Reference to the query job, which is from the
1840
1856
  # `QueryAssetsResponse` of previous `QueryAssets` call.
@@ -98,8 +98,7 @@ module Google
98
98
  # resource migration takes place.
99
99
  rpc :AnalyzeMove, ::Google::Cloud::Asset::V1::AnalyzeMoveRequest, ::Google::Cloud::Asset::V1::AnalyzeMoveResponse
100
100
  # Issue a job that queries assets using a SQL statement compatible with
101
- # [BigQuery Standard
102
- # SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
101
+ # [BigQuery SQL](https://cloud.google.com/bigquery/docs/introduction-sql).
103
102
  #
104
103
  # If the query execution finishes within timeout and there's no pagination,
105
104
  # the full query results will be returned in the `QueryAssetsResponse`.
@@ -108,9 +107,8 @@ module Google
108
107
  # with the `job_reference` from the a previous `QueryAssets` call.
109
108
  #
110
109
  # Note, the query result has approximately 10 GB limitation enforced by
111
- # BigQuery
112
- # https://cloud.google.com/bigquery/docs/best-practices-performance-output,
113
- # queries return larger results will result in errors.
110
+ # [BigQuery](https://cloud.google.com/bigquery/docs/best-practices-performance-output).
111
+ # Queries return larger results will result in errors.
114
112
  rpc :QueryAssets, ::Google::Cloud::Asset::V1::QueryAssetsRequest, ::Google::Cloud::Asset::V1::QueryAssetsResponse
115
113
  # Creates a saved query in a parent project/folder/organization.
116
114
  rpc :CreateSavedQuery, ::Google::Cloud::Asset::V1::CreateSavedQueryRequest, ::Google::Cloud::Asset::V1::SavedQuery
@@ -17,7 +17,7 @@ require 'google/protobuf/timestamp_pb'
17
17
  require 'google/rpc/code_pb'
18
18
 
19
19
 
20
- descriptor_data = "\n\"google/cloud/asset/v1/assets.proto\x12\x15google.cloud.asset.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a)google/cloud/orgpolicy/v1/orgpolicy.proto\x1a(google/cloud/osconfig/v1/inventory.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a:google/identity/accesscontextmanager/v1/access_level.proto\x1a;google/identity/accesscontextmanager/v1/access_policy.proto\x1a?google/identity/accesscontextmanager/v1/service_perimeter.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x15google/rpc/code.proto\"\xf5\x02\n\rTemporalAsset\x12\x31\n\x06window\x18\x01 \x01(\x0b\x32!.google.cloud.asset.v1.TimeWindow\x12\x0f\n\x07\x64\x65leted\x18\x02 \x01(\x08\x12+\n\x05\x61sset\x18\x03 \x01(\x0b\x32\x1c.google.cloud.asset.v1.Asset\x12O\n\x11prior_asset_state\x18\x04 \x01(\x0e\x32\x34.google.cloud.asset.v1.TemporalAsset.PriorAssetState\x12\x31\n\x0bprior_asset\x18\x05 \x01(\x0b\x32\x1c.google.cloud.asset.v1.Asset\"o\n\x0fPriorAssetState\x12!\n\x1dPRIOR_ASSET_STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07PRESENT\x10\x01\x12\x0b\n\x07INVALID\x10\x02\x12\x12\n\x0e\x44OES_NOT_EXIST\x10\x03\x12\x0b\n\x07\x44\x45LETED\x10\x04\"j\n\nTimeWindow\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xf3\x05\n\x05\x41sset\x12/\n\x0bupdate_time\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nasset_type\x18\x02 \x01(\t\x12\x31\n\x08resource\x18\x03 \x01(\x0b\x32\x1f.google.cloud.asset.v1.Resource\x12)\n\niam_policy\x18\x04 \x01(\x0b\x32\x15.google.iam.v1.Policy\x12\x35\n\norg_policy\x18\x06 \x03(\x0b\x32!.google.cloud.orgpolicy.v1.Policy\x12N\n\raccess_policy\x18\x07 \x01(\x0b\x32\x35.google.identity.accesscontextmanager.v1.AccessPolicyH\x00\x12L\n\x0c\x61\x63\x63\x65ss_level\x18\x08 \x01(\x0b\x32\x34.google.identity.accesscontextmanager.v1.AccessLevelH\x00\x12V\n\x11service_perimeter\x18\t \x01(\x0b\x32\x39.google.identity.accesscontextmanager.v1.ServicePerimeterH\x00\x12\x39\n\x0cos_inventory\x18\x0c \x01(\x0b\x32#.google.cloud.osconfig.v1.Inventory\x12@\n\x0erelated_assets\x18\r \x01(\x0b\x32$.google.cloud.asset.v1.RelatedAssetsB\x02\x18\x01\x12:\n\rrelated_asset\x18\x0f \x01(\x0b\x32#.google.cloud.asset.v1.RelatedAsset\x12\x11\n\tancestors\x18\n \x03(\t:\'\xea\x41$\n\x1f\x63loudasset.googleapis.com/Asset\x12\x01*B\x17\n\x15\x61\x63\x63\x65ss_context_policy\"\xb2\x01\n\x08Resource\x12\x0f\n\x07version\x18\x01 \x01(\t\x12\x1e\n\x16\x64iscovery_document_uri\x18\x02 \x01(\t\x12\x16\n\x0e\x64iscovery_name\x18\x03 \x01(\t\x12\x14\n\x0cresource_url\x18\x04 \x01(\t\x12\x0e\n\x06parent\x18\x05 \x01(\t\x12%\n\x04\x64\x61ta\x18\x06 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x10\n\x08location\x18\x08 \x01(\t\"\x98\x01\n\rRelatedAssets\x12N\n\x17relationship_attributes\x18\x01 \x01(\x0b\x32-.google.cloud.asset.v1.RelationshipAttributes\x12\x33\n\x06\x61ssets\x18\x02 \x03(\x0b\x32#.google.cloud.asset.v1.RelatedAsset:\x02\x18\x01\"v\n\x16RelationshipAttributes\x12\x0c\n\x04type\x18\x04 \x01(\t\x12\x1c\n\x14source_resource_type\x18\x01 \x01(\t\x12\x1c\n\x14target_resource_type\x18\x02 \x01(\t\x12\x0e\n\x06\x61\x63tion\x18\x03 \x01(\t:\x02\x18\x01\"\x85\x01\n\x0cRelatedAsset\x12\x33\n\x05\x61sset\x18\x01 \x01(\tB$\xfa\x41!\n\x1f\x63loudasset.googleapis.com/Asset\x12\x12\n\nasset_type\x18\x02 \x01(\t\x12\x11\n\tancestors\x18\x03 \x03(\t\x12\x19\n\x11relationship_type\x18\x04 \x01(\t\"\xc8\x07\n\x14ResourceSearchResult\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nasset_type\x18\x02 \x01(\t\x12\x0f\n\x07project\x18\x03 \x01(\t\x12\x0f\n\x07\x66olders\x18\x11 \x03(\t\x12\x14\n\x0corganization\x18\x12 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x04 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x05 \x01(\t\x12\x10\n\x08location\x18\x06 \x01(\t\x12G\n\x06labels\x18\x07 \x03(\x0b\x32\x37.google.cloud.asset.v1.ResourceSearchResult.LabelsEntry\x12\x14\n\x0cnetwork_tags\x18\x08 \x03(\t\x12\x13\n\x07kms_key\x18\n \x01(\tB\x02\x18\x01\x12\x10\n\x08kms_keys\x18\x1c \x03(\t\x12/\n\x0b\x63reate_time\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\r\n\x05state\x18\r \x01(\t\x12\x36\n\x15\x61\x64\x64itional_attributes\x18\t \x01(\x0b\x32\x17.google.protobuf.Struct\x12!\n\x19parent_full_resource_name\x18\x13 \x01(\t\x12\x45\n\x13versioned_resources\x18\x10 \x03(\x0b\x32(.google.cloud.asset.v1.VersionedResource\x12\x43\n\x12\x61ttached_resources\x18\x14 \x03(\x0b\x32\'.google.cloud.asset.v1.AttachedResource\x12U\n\rrelationships\x18\x15 \x03(\x0b\x32>.google.cloud.asset.v1.ResourceSearchResult.RelationshipsEntry\x12\x10\n\x08tag_keys\x18\x17 \x03(\t\x12\x12\n\ntag_values\x18\x19 \x03(\t\x12\x15\n\rtag_value_ids\x18\x1a \x03(\t\x12\x19\n\x11parent_asset_type\x18g \x01(\t\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a]\n\x12RelationshipsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x36\n\x05value\x18\x02 \x01(\x0b\x32\'.google.cloud.asset.v1.RelatedResources:\x02\x38\x01\"O\n\x11VersionedResource\x12\x0f\n\x07version\x18\x01 \x01(\t\x12)\n\x08resource\x18\x02 \x01(\x0b\x32\x17.google.protobuf.Struct\"m\n\x10\x41ttachedResource\x12\x12\n\nasset_type\x18\x01 \x01(\t\x12\x45\n\x13versioned_resources\x18\x03 \x03(\x0b\x32(.google.cloud.asset.v1.VersionedResource\"U\n\x10RelatedResources\x12\x41\n\x11related_resources\x18\x01 \x03(\x0b\x32&.google.cloud.asset.v1.RelatedResource\"A\n\x0fRelatedResource\x12\x12\n\nasset_type\x18\x01 \x01(\t\x12\x1a\n\x12\x66ull_resource_name\x18\x02 \x01(\t\"\x8f\x04\n\x15IamPolicySearchResult\x12\x10\n\x08resource\x18\x01 \x01(\t\x12\x12\n\nasset_type\x18\x05 \x01(\t\x12\x0f\n\x07project\x18\x02 \x01(\t\x12\x0f\n\x07\x66olders\x18\x06 \x03(\t\x12\x14\n\x0corganization\x18\x07 \x01(\t\x12%\n\x06policy\x18\x03 \x01(\x0b\x32\x15.google.iam.v1.Policy\x12M\n\x0b\x65xplanation\x18\x04 \x01(\x0b\x32\x38.google.cloud.asset.v1.IamPolicySearchResult.Explanation\x1a\xa1\x02\n\x0b\x45xplanation\x12m\n\x13matched_permissions\x18\x01 \x03(\x0b\x32P.google.cloud.asset.v1.IamPolicySearchResult.Explanation.MatchedPermissionsEntry\x1a\"\n\x0bPermissions\x12\x13\n\x0bpermissions\x18\x01 \x03(\t\x1a\x7f\n\x17MatchedPermissionsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12S\n\x05value\x18\x02 \x01(\x0b\x32\x44.google.cloud.asset.v1.IamPolicySearchResult.Explanation.Permissions:\x02\x38\x01\"G\n\x16IamPolicyAnalysisState\x12\x1e\n\x04\x63ode\x18\x01 \x01(\x0e\x32\x10.google.rpc.Code\x12\r\n\x05\x63\x61use\x18\x02 \x01(\t\"\xc6\x01\n\x13\x43onditionEvaluation\x12T\n\x10\x65valuation_value\x18\x01 \x01(\x0e\x32:.google.cloud.asset.v1.ConditionEvaluation.EvaluationValue\"Y\n\x0f\x45valuationValue\x12 \n\x1c\x45VALUATION_VALUE_UNSPECIFIED\x10\x00\x12\x08\n\x04TRUE\x10\x01\x12\t\n\x05\x46\x41LSE\x10\x02\x12\x0f\n\x0b\x43ONDITIONAL\x10\x03\"\xab\t\n\x17IamPolicyAnalysisResult\x12#\n\x1b\x61ttached_resource_full_name\x18\x01 \x01(\t\x12+\n\x0biam_binding\x18\x02 \x01(\x0b\x32\x16.google.iam.v1.Binding\x12^\n\x14\x61\x63\x63\x65ss_control_lists\x18\x03 \x03(\x0b\x32@.google.cloud.asset.v1.IamPolicyAnalysisResult.AccessControlList\x12R\n\ridentity_list\x18\x04 \x01(\x0b\x32;.google.cloud.asset.v1.IamPolicyAnalysisResult.IdentityList\x12\x16\n\x0e\x66ully_explored\x18\x05 \x01(\x08\x1am\n\x08Resource\x12\x1a\n\x12\x66ull_resource_name\x18\x01 \x01(\t\x12\x45\n\x0e\x61nalysis_state\x18\x02 \x01(\x0b\x32-.google.cloud.asset.v1.IamPolicyAnalysisState\x1a\x85\x01\n\x06\x41\x63\x63\x65ss\x12\x0e\n\x04role\x18\x01 \x01(\tH\x00\x12\x14\n\npermission\x18\x02 \x01(\tH\x00\x12\x45\n\x0e\x61nalysis_state\x18\x03 \x01(\x0b\x32-.google.cloud.asset.v1.IamPolicyAnalysisStateB\x0e\n\x0coneof_access\x1a_\n\x08Identity\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x45\n\x0e\x61nalysis_state\x18\x02 \x01(\x0b\x32-.google.cloud.asset.v1.IamPolicyAnalysisState\x1a\x30\n\x04\x45\x64ge\x12\x13\n\x0bsource_node\x18\x01 \x01(\t\x12\x13\n\x0btarget_node\x18\x02 \x01(\t\x1a\xbf\x02\n\x11\x41\x63\x63\x65ssControlList\x12J\n\tresources\x18\x01 \x03(\x0b\x32\x37.google.cloud.asset.v1.IamPolicyAnalysisResult.Resource\x12G\n\x08\x61\x63\x63\x65sses\x18\x02 \x03(\x0b\x32\x35.google.cloud.asset.v1.IamPolicyAnalysisResult.Access\x12K\n\x0eresource_edges\x18\x03 \x03(\x0b\x32\x33.google.cloud.asset.v1.IamPolicyAnalysisResult.Edge\x12H\n\x14\x63ondition_evaluation\x18\x04 \x01(\x0b\x32*.google.cloud.asset.v1.ConditionEvaluation\x1a\xa5\x01\n\x0cIdentityList\x12K\n\nidentities\x18\x01 \x03(\x0b\x32\x37.google.cloud.asset.v1.IamPolicyAnalysisResult.Identity\x12H\n\x0bgroup_edges\x18\x02 \x03(\x0b\x32\x33.google.cloud.asset.v1.IamPolicyAnalysisResult.EdgeB\x8d\x01\n\x19\x63om.google.cloud.asset.v1B\nAssetProtoP\x01Z/cloud.google.com/go/asset/apiv1/assetpb;assetpb\xf8\x01\x01\xaa\x02\x15Google.Cloud.Asset.V1\xca\x02\x15Google\\Cloud\\Asset\\V1b\x06proto3"
20
+ descriptor_data = "\n\"google/cloud/asset/v1/assets.proto\x12\x15google.cloud.asset.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a)google/cloud/orgpolicy/v1/orgpolicy.proto\x1a(google/cloud/osconfig/v1/inventory.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a:google/identity/accesscontextmanager/v1/access_level.proto\x1a;google/identity/accesscontextmanager/v1/access_policy.proto\x1a?google/identity/accesscontextmanager/v1/service_perimeter.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x15google/rpc/code.proto\"\xf5\x02\n\rTemporalAsset\x12\x31\n\x06window\x18\x01 \x01(\x0b\x32!.google.cloud.asset.v1.TimeWindow\x12\x0f\n\x07\x64\x65leted\x18\x02 \x01(\x08\x12+\n\x05\x61sset\x18\x03 \x01(\x0b\x32\x1c.google.cloud.asset.v1.Asset\x12O\n\x11prior_asset_state\x18\x04 \x01(\x0e\x32\x34.google.cloud.asset.v1.TemporalAsset.PriorAssetState\x12\x31\n\x0bprior_asset\x18\x05 \x01(\x0b\x32\x1c.google.cloud.asset.v1.Asset\"o\n\x0fPriorAssetState\x12!\n\x1dPRIOR_ASSET_STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07PRESENT\x10\x01\x12\x0b\n\x07INVALID\x10\x02\x12\x12\n\x0e\x44OES_NOT_EXIST\x10\x03\x12\x0b\n\x07\x44\x45LETED\x10\x04\"j\n\nTimeWindow\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xf3\x05\n\x05\x41sset\x12/\n\x0bupdate_time\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nasset_type\x18\x02 \x01(\t\x12\x31\n\x08resource\x18\x03 \x01(\x0b\x32\x1f.google.cloud.asset.v1.Resource\x12)\n\niam_policy\x18\x04 \x01(\x0b\x32\x15.google.iam.v1.Policy\x12\x35\n\norg_policy\x18\x06 \x03(\x0b\x32!.google.cloud.orgpolicy.v1.Policy\x12N\n\raccess_policy\x18\x07 \x01(\x0b\x32\x35.google.identity.accesscontextmanager.v1.AccessPolicyH\x00\x12L\n\x0c\x61\x63\x63\x65ss_level\x18\x08 \x01(\x0b\x32\x34.google.identity.accesscontextmanager.v1.AccessLevelH\x00\x12V\n\x11service_perimeter\x18\t \x01(\x0b\x32\x39.google.identity.accesscontextmanager.v1.ServicePerimeterH\x00\x12\x39\n\x0cos_inventory\x18\x0c \x01(\x0b\x32#.google.cloud.osconfig.v1.Inventory\x12@\n\x0erelated_assets\x18\r \x01(\x0b\x32$.google.cloud.asset.v1.RelatedAssetsB\x02\x18\x01\x12:\n\rrelated_asset\x18\x0f \x01(\x0b\x32#.google.cloud.asset.v1.RelatedAsset\x12\x11\n\tancestors\x18\n \x03(\t:\'\xea\x41$\n\x1f\x63loudasset.googleapis.com/Asset\x12\x01*B\x17\n\x15\x61\x63\x63\x65ss_context_policy\"\xb2\x01\n\x08Resource\x12\x0f\n\x07version\x18\x01 \x01(\t\x12\x1e\n\x16\x64iscovery_document_uri\x18\x02 \x01(\t\x12\x16\n\x0e\x64iscovery_name\x18\x03 \x01(\t\x12\x14\n\x0cresource_url\x18\x04 \x01(\t\x12\x0e\n\x06parent\x18\x05 \x01(\t\x12%\n\x04\x64\x61ta\x18\x06 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x10\n\x08location\x18\x08 \x01(\t\"\x98\x01\n\rRelatedAssets\x12N\n\x17relationship_attributes\x18\x01 \x01(\x0b\x32-.google.cloud.asset.v1.RelationshipAttributes\x12\x33\n\x06\x61ssets\x18\x02 \x03(\x0b\x32#.google.cloud.asset.v1.RelatedAsset:\x02\x18\x01\"v\n\x16RelationshipAttributes\x12\x0c\n\x04type\x18\x04 \x01(\t\x12\x1c\n\x14source_resource_type\x18\x01 \x01(\t\x12\x1c\n\x14target_resource_type\x18\x02 \x01(\t\x12\x0e\n\x06\x61\x63tion\x18\x03 \x01(\t:\x02\x18\x01\"\x85\x01\n\x0cRelatedAsset\x12\x33\n\x05\x61sset\x18\x01 \x01(\tB$\xfa\x41!\n\x1f\x63loudasset.googleapis.com/Asset\x12\x12\n\nasset_type\x18\x02 \x01(\t\x12\x11\n\tancestors\x18\x03 \x03(\t\x12\x19\n\x11relationship_type\x18\x04 \x01(\t\"y\n\x03Tag\x12\x14\n\x07tag_key\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x16\n\ttag_value\x18\x03 \x01(\tH\x01\x88\x01\x01\x12\x19\n\x0ctag_value_id\x18\x04 \x01(\tH\x02\x88\x01\x01\x42\n\n\x08_tag_keyB\x0c\n\n_tag_valueB\x0f\n\r_tag_value_id\"\x7f\n\x13\x45\x66\x66\x65\x63tiveTagDetails\x12\x1e\n\x11\x61ttached_resource\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x32\n\x0e\x65\x66\x66\x65\x63tive_tags\x18\x02 \x03(\x0b\x32\x1a.google.cloud.asset.v1.TagB\x14\n\x12_attached_resource\"\xda\t\n\x14ResourceSearchResult\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nasset_type\x18\x02 \x01(\t\x12\x0f\n\x07project\x18\x03 \x01(\t\x12\x0f\n\x07\x66olders\x18\x11 \x03(\t\x12\x14\n\x0corganization\x18\x12 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x04 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x05 \x01(\t\x12\x10\n\x08location\x18\x06 \x01(\t\x12G\n\x06labels\x18\x07 \x03(\x0b\x32\x37.google.cloud.asset.v1.ResourceSearchResult.LabelsEntry\x12\x14\n\x0cnetwork_tags\x18\x08 \x03(\t\x12\x13\n\x07kms_key\x18\n \x01(\tB\x02\x18\x01\x12\x10\n\x08kms_keys\x18\x1c \x03(\t\x12/\n\x0b\x63reate_time\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\r\n\x05state\x18\r \x01(\t\x12\x36\n\x15\x61\x64\x64itional_attributes\x18\t \x01(\x0b\x32\x17.google.protobuf.Struct\x12!\n\x19parent_full_resource_name\x18\x13 \x01(\t\x12\x45\n\x13versioned_resources\x18\x10 \x03(\x0b\x32(.google.cloud.asset.v1.VersionedResource\x12\x43\n\x12\x61ttached_resources\x18\x14 \x03(\x0b\x32\'.google.cloud.asset.v1.AttachedResource\x12U\n\rrelationships\x18\x15 \x03(\x0b\x32>.google.cloud.asset.v1.ResourceSearchResult.RelationshipsEntry\x12\x14\n\x08tag_keys\x18\x17 \x03(\tB\x02\x18\x01\x12\x16\n\ntag_values\x18\x19 \x03(\tB\x02\x18\x01\x12\x19\n\rtag_value_ids\x18\x1a \x03(\tB\x02\x18\x01\x12(\n\x04tags\x18\x1d \x03(\x0b\x32\x1a.google.cloud.asset.v1.Tag\x12\x42\n\x0e\x65\x66\x66\x65\x63tive_tags\x18\x1e \x03(\x0b\x32*.google.cloud.asset.v1.EffectiveTagDetails\x12\x19\n\x11parent_asset_type\x18g \x01(\t\x12]\n\x12scc_security_marks\x18 \x03(\x0b\x32\x41.google.cloud.asset.v1.ResourceSearchResult.SccSecurityMarksEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a]\n\x12RelationshipsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x36\n\x05value\x18\x02 \x01(\x0b\x32\'.google.cloud.asset.v1.RelatedResources:\x02\x38\x01\x1a\x37\n\x15SccSecurityMarksEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"O\n\x11VersionedResource\x12\x0f\n\x07version\x18\x01 \x01(\t\x12)\n\x08resource\x18\x02 \x01(\x0b\x32\x17.google.protobuf.Struct\"m\n\x10\x41ttachedResource\x12\x12\n\nasset_type\x18\x01 \x01(\t\x12\x45\n\x13versioned_resources\x18\x03 \x03(\x0b\x32(.google.cloud.asset.v1.VersionedResource\"U\n\x10RelatedResources\x12\x41\n\x11related_resources\x18\x01 \x03(\x0b\x32&.google.cloud.asset.v1.RelatedResource\"A\n\x0fRelatedResource\x12\x12\n\nasset_type\x18\x01 \x01(\t\x12\x1a\n\x12\x66ull_resource_name\x18\x02 \x01(\t\"\x8f\x04\n\x15IamPolicySearchResult\x12\x10\n\x08resource\x18\x01 \x01(\t\x12\x12\n\nasset_type\x18\x05 \x01(\t\x12\x0f\n\x07project\x18\x02 \x01(\t\x12\x0f\n\x07\x66olders\x18\x06 \x03(\t\x12\x14\n\x0corganization\x18\x07 \x01(\t\x12%\n\x06policy\x18\x03 \x01(\x0b\x32\x15.google.iam.v1.Policy\x12M\n\x0b\x65xplanation\x18\x04 \x01(\x0b\x32\x38.google.cloud.asset.v1.IamPolicySearchResult.Explanation\x1a\xa1\x02\n\x0b\x45xplanation\x12m\n\x13matched_permissions\x18\x01 \x03(\x0b\x32P.google.cloud.asset.v1.IamPolicySearchResult.Explanation.MatchedPermissionsEntry\x1a\"\n\x0bPermissions\x12\x13\n\x0bpermissions\x18\x01 \x03(\t\x1a\x7f\n\x17MatchedPermissionsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12S\n\x05value\x18\x02 \x01(\x0b\x32\x44.google.cloud.asset.v1.IamPolicySearchResult.Explanation.Permissions:\x02\x38\x01\"G\n\x16IamPolicyAnalysisState\x12\x1e\n\x04\x63ode\x18\x01 \x01(\x0e\x32\x10.google.rpc.Code\x12\r\n\x05\x63\x61use\x18\x02 \x01(\t\"\xc6\x01\n\x13\x43onditionEvaluation\x12T\n\x10\x65valuation_value\x18\x01 \x01(\x0e\x32:.google.cloud.asset.v1.ConditionEvaluation.EvaluationValue\"Y\n\x0f\x45valuationValue\x12 \n\x1c\x45VALUATION_VALUE_UNSPECIFIED\x10\x00\x12\x08\n\x04TRUE\x10\x01\x12\t\n\x05\x46\x41LSE\x10\x02\x12\x0f\n\x0b\x43ONDITIONAL\x10\x03\"\xab\t\n\x17IamPolicyAnalysisResult\x12#\n\x1b\x61ttached_resource_full_name\x18\x01 \x01(\t\x12+\n\x0biam_binding\x18\x02 \x01(\x0b\x32\x16.google.iam.v1.Binding\x12^\n\x14\x61\x63\x63\x65ss_control_lists\x18\x03 \x03(\x0b\x32@.google.cloud.asset.v1.IamPolicyAnalysisResult.AccessControlList\x12R\n\ridentity_list\x18\x04 \x01(\x0b\x32;.google.cloud.asset.v1.IamPolicyAnalysisResult.IdentityList\x12\x16\n\x0e\x66ully_explored\x18\x05 \x01(\x08\x1am\n\x08Resource\x12\x1a\n\x12\x66ull_resource_name\x18\x01 \x01(\t\x12\x45\n\x0e\x61nalysis_state\x18\x02 \x01(\x0b\x32-.google.cloud.asset.v1.IamPolicyAnalysisState\x1a\x85\x01\n\x06\x41\x63\x63\x65ss\x12\x0e\n\x04role\x18\x01 \x01(\tH\x00\x12\x14\n\npermission\x18\x02 \x01(\tH\x00\x12\x45\n\x0e\x61nalysis_state\x18\x03 \x01(\x0b\x32-.google.cloud.asset.v1.IamPolicyAnalysisStateB\x0e\n\x0coneof_access\x1a_\n\x08Identity\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x45\n\x0e\x61nalysis_state\x18\x02 \x01(\x0b\x32-.google.cloud.asset.v1.IamPolicyAnalysisState\x1a\x30\n\x04\x45\x64ge\x12\x13\n\x0bsource_node\x18\x01 \x01(\t\x12\x13\n\x0btarget_node\x18\x02 \x01(\t\x1a\xbf\x02\n\x11\x41\x63\x63\x65ssControlList\x12J\n\tresources\x18\x01 \x03(\x0b\x32\x37.google.cloud.asset.v1.IamPolicyAnalysisResult.Resource\x12G\n\x08\x61\x63\x63\x65sses\x18\x02 \x03(\x0b\x32\x35.google.cloud.asset.v1.IamPolicyAnalysisResult.Access\x12K\n\x0eresource_edges\x18\x03 \x03(\x0b\x32\x33.google.cloud.asset.v1.IamPolicyAnalysisResult.Edge\x12H\n\x14\x63ondition_evaluation\x18\x04 \x01(\x0b\x32*.google.cloud.asset.v1.ConditionEvaluation\x1a\xa5\x01\n\x0cIdentityList\x12K\n\nidentities\x18\x01 \x03(\x0b\x32\x37.google.cloud.asset.v1.IamPolicyAnalysisResult.Identity\x12H\n\x0bgroup_edges\x18\x02 \x03(\x0b\x32\x33.google.cloud.asset.v1.IamPolicyAnalysisResult.EdgeB\x8d\x01\n\x19\x63om.google.cloud.asset.v1B\nAssetProtoP\x01Z/cloud.google.com/go/asset/apiv1/assetpb;assetpb\xf8\x01\x01\xaa\x02\x15Google.Cloud.Asset.V1\xca\x02\x15Google\\Cloud\\Asset\\V1b\x06proto3"
21
21
 
22
22
  pool = Google::Protobuf::DescriptorPool.generated_pool
23
23
 
@@ -63,6 +63,8 @@ module Google
63
63
  RelatedAssets = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.RelatedAssets").msgclass
64
64
  RelationshipAttributes = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.RelationshipAttributes").msgclass
65
65
  RelatedAsset = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.RelatedAsset").msgclass
66
+ Tag = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.Tag").msgclass
67
+ EffectiveTagDetails = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.EffectiveTagDetails").msgclass
66
68
  ResourceSearchResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.ResourceSearchResult").msgclass
67
69
  VersionedResource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.VersionedResource").msgclass
68
70
  AttachedResource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.AttachedResource").msgclass
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Asset
23
23
  module V1
24
- VERSION = "0.27.0"
24
+ VERSION = "0.28.0"
25
25
  end
26
26
  end
27
27
  end
@@ -304,6 +304,19 @@ module Google
304
304
  # seconds: 360 # 6 minutes
305
305
  # total_poll_timeout:
306
306
  # seconds: 54000 # 90 minutes
307
+ # @!attribute [rw] auto_populated_fields
308
+ # @return [::Array<::String>]
309
+ # List of top-level fields of the request message, that should be
310
+ # automatically populated by the client libraries based on their
311
+ # (google.api.field_info).format. Currently supported format: UUID4.
312
+ #
313
+ # Example of a YAML configuration:
314
+ #
315
+ # publishing:
316
+ # method_settings:
317
+ # - selector: google.example.v1.ExampleService.CreateExample
318
+ # auto_populated_fields:
319
+ # - request_id
307
320
  class MethodSettings
308
321
  include ::Google::Protobuf::MessageExts
309
322
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -635,49 +635,73 @@ module Google
635
635
  # Examples:
636
636
  #
637
637
  # * `name:Important` to find Google Cloud resources whose name contains
638
- # "Important" as a word.
638
+ # `Important` as a word.
639
639
  # * `name=Important` to find the Google Cloud resource whose name is exactly
640
- # "Important".
640
+ # `Important`.
641
641
  # * `displayName:Impor*` to find Google Cloud resources whose display name
642
- # contains "Impor" as a prefix of any word in the field.
642
+ # contains `Impor` as a prefix of any word in the field.
643
643
  # * `location:us-west*` to find Google Cloud resources whose location
644
- # contains both "us" and "west" as prefixes.
645
- # * `labels:prod` to find Google Cloud resources whose labels contain "prod"
644
+ # contains both `us` and `west` as prefixes.
645
+ # * `labels:prod` to find Google Cloud resources whose labels contain `prod`
646
646
  # as a key or value.
647
- # * `labels.env:prod` to find Google Cloud resources that have a label "env"
648
- # and its value is "prod".
649
- # * `labels.env:*` to find Google Cloud resources that have a label "env".
647
+ # * `labels.env:prod` to find Google Cloud resources that have a label `env`
648
+ # and its value is `prod`.
649
+ # * `labels.env:*` to find Google Cloud resources that have a label `env`.
650
+ # * `tagKeys:env` to find Google Cloud resources that have directly
651
+ # attached tags where the
652
+ # [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey)
653
+ # .`namespacedName` contains `env`.
654
+ # * `tagValues:prod*` to find Google Cloud resources that have directly
655
+ # attached tags where the
656
+ # [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
657
+ # .`namespacedName` contains a word prefixed by `prod`.
658
+ # * `tagValueIds=tagValues/123` to find Google Cloud resources that have
659
+ # directly attached tags where the
660
+ # [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
661
+ # .`name` is exactly `tagValues/123`.
662
+ # * `effectiveTagKeys:env` to find Google Cloud resources that have
663
+ # directly attached or inherited tags where the
664
+ # [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey)
665
+ # .`namespacedName` contains `env`.
666
+ # * `effectiveTagValues:prod*` to find Google Cloud resources that have
667
+ # directly attached or inherited tags where the
668
+ # [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
669
+ # .`namespacedName` contains a word prefixed by `prod`.
670
+ # * `effectiveTagValueIds=tagValues/123` to find Google Cloud resources that
671
+ # have directly attached or inherited tags where the
672
+ # [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
673
+ # .`name` is exactly `tagValues/123`.
650
674
  # * `kmsKey:key` to find Google Cloud resources encrypted with a
651
- # customer-managed encryption key whose name contains "key" as a word. This
675
+ # customer-managed encryption key whose name contains `key` as a word. This
652
676
  # field is deprecated. Please use the `kmsKeys` field to retrieve Cloud KMS
653
677
  # key information.
654
678
  # * `kmsKeys:key` to find Google Cloud resources encrypted with
655
- # customer-managed encryption keys whose name contains the word "key".
679
+ # customer-managed encryption keys whose name contains the word `key`.
656
680
  # * `relationships:instance-group-1` to find Google Cloud resources that have
657
- # relationships with "instance-group-1" in the related resource name.
681
+ # relationships with `instance-group-1` in the related resource name.
658
682
  # * `relationships:INSTANCE_TO_INSTANCEGROUP` to find Compute Engine
659
- # instances that have relationships of type "INSTANCE_TO_INSTANCEGROUP".
683
+ # instances that have relationships of type `INSTANCE_TO_INSTANCEGROUP`.
660
684
  # * `relationships.INSTANCE_TO_INSTANCEGROUP:instance-group-1` to find
661
- # Compute Engine instances that have relationships with "instance-group-1"
685
+ # Compute Engine instances that have relationships with `instance-group-1`
662
686
  # in the Compute Engine instance group resource name, for relationship type
663
- # "INSTANCE_TO_INSTANCEGROUP".
687
+ # `INSTANCE_TO_INSTANCEGROUP`.
664
688
  # * `state:ACTIVE` to find Google Cloud resources whose state contains
665
- # "ACTIVE" as a word.
689
+ # `ACTIVE` as a word.
666
690
  # * `NOT state:ACTIVE` to find Google Cloud resources whose state doesn't
667
- # contain "ACTIVE" as a word.
691
+ # contain `ACTIVE` as a word.
668
692
  # * `createTime<1609459200` to find Google Cloud resources that were created
669
- # before "2021-01-01 00:00:00 UTC". 1609459200 is the epoch timestamp of
670
- # "2021-01-01 00:00:00 UTC" in seconds.
693
+ # before `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of
694
+ # `2021-01-01 00:00:00 UTC` in seconds.
671
695
  # * `updateTime>1609459200` to find Google Cloud resources that were updated
672
- # after "2021-01-01 00:00:00 UTC". 1609459200 is the epoch timestamp of
673
- # "2021-01-01 00:00:00 UTC" in seconds.
674
- # * `Important` to find Google Cloud resources that contain "Important" as a
696
+ # after `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of
697
+ # `2021-01-01 00:00:00 UTC` in seconds.
698
+ # * `Important` to find Google Cloud resources that contain `Important` as a
675
699
  # word in any of the searchable fields.
676
- # * `Impor*` to find Google Cloud resources that contain "Impor" as a prefix
700
+ # * `Impor*` to find Google Cloud resources that contain `Impor` as a prefix
677
701
  # of any word in any of the searchable fields.
678
702
  # * `Important location:(us-west1 OR global)` to find Google Cloud
679
- # resources that contain "Important" as a word in any of the searchable
680
- # fields and are also located in the "us-west1" region or the "global"
703
+ # resources that contain `Important` as a word in any of the searchable
704
+ # fields and are also located in the `us-west1` region or the `global`
681
705
  # location.
682
706
  # @!attribute [rw] asset_types
683
707
  # @return [::Array<::String>]
@@ -698,10 +722,10 @@ module Google
698
722
  # @!attribute [rw] page_size
699
723
  # @return [::Integer]
700
724
  # Optional. The page size for search result pagination. Page size is capped
701
- # at 500 even if a larger value is given. If set to zero, server will pick an
702
- # appropriate default. Returned results may be fewer than requested. When
703
- # this happens, there could be more results as long as `next_page_token` is
704
- # returned.
725
+ # at 500 even if a larger value is given. If set to zero or a negative value,
726
+ # server will pick an appropriate default. Returned results may be fewer than
727
+ # requested. When this happens, there could be more results as long as
728
+ # `next_page_token` is returned.
705
729
  # @!attribute [rw] page_token
706
730
  # @return [::String]
707
731
  # Optional. If present, then retrieve the next batch of results from the
@@ -714,7 +738,7 @@ module Google
714
738
  # the results. The default order is ascending. Add " DESC" after the field
715
739
  # name to indicate descending order. Redundant space characters are ignored.
716
740
  # Example: "location DESC, name".
717
- # Only singular primitive fields in the response are sortable:
741
+ # Only the following fields in the response are sortable:
718
742
  #
719
743
  # * name
720
744
  # * assetType
@@ -727,44 +751,38 @@ module Google
727
751
  # * state
728
752
  # * parentFullResourceName
729
753
  # * parentAssetType
730
- #
731
- # All the other fields such as repeated fields (e.g., `networkTags`,
732
- # `kmsKeys`), map fields (e.g., `labels`) and struct fields (e.g.,
733
- # `additionalAttributes`) are not supported.
734
754
  # @!attribute [rw] read_mask
735
755
  # @return [::Google::Protobuf::FieldMask]
736
- # Optional. A comma-separated list of fields specifying which fields to be
737
- # returned in ResourceSearchResult. Only '*' or combination of top level
738
- # fields can be specified. Field names of both snake_case and camelCase are
739
- # supported. Examples: `"*"`, `"name,location"`, `"name,versionedResources"`.
740
- #
741
- # The read_mask paths must be valid field paths listed but not limited to
742
- # (both snake_case and camelCase are supported):
743
- #
744
- # * name
745
- # * assetType
746
- # * project
747
- # * displayName
748
- # * description
749
- # * location
750
- # * tagKeys
751
- # * tagValues
752
- # * tagValueIds
753
- # * labels
754
- # * networkTags
755
- # * kmsKey (This field is deprecated. Please use the `kmsKeys` field to
756
- # retrieve Cloud KMS key information.)
757
- # * kmsKeys
758
- # * createTime
759
- # * updateTime
760
- # * state
761
- # * additionalAttributes
762
- # * versionedResources
763
- #
764
- # If read_mask is not specified, all fields except versionedResources will
765
- # be returned.
766
- # If only '*' is specified, all fields including versionedResources will be
767
- # returned.
756
+ # Optional. A comma-separated list of fields that you want returned in the
757
+ # results. The following fields are returned by default if not specified:
758
+ #
759
+ # * `name`
760
+ # * `assetType`
761
+ # * `project`
762
+ # * `folders`
763
+ # * `organization`
764
+ # * `displayName`
765
+ # * `description`
766
+ # * `location`
767
+ # * `labels`
768
+ # * `tags`
769
+ # * `effectiveTags`
770
+ # * `networkTags`
771
+ # * `kmsKeys`
772
+ # * `createTime`
773
+ # * `updateTime`
774
+ # * `state`
775
+ # * `additionalAttributes`
776
+ # * `parentFullResourceName`
777
+ # * `parentAssetType`
778
+ #
779
+ # Some fields of large size, such as `versionedResources`,
780
+ # `attachedResources`, `effectiveTags` etc., are not returned by default, but
781
+ # you can specify them in the `read_mask` parameter if you want to include
782
+ # them. If `"*"` is specified, all [available
783
+ # fields](https://cloud.google.com/asset-inventory/docs/reference/rest/v1/TopLevel/searchAllResources#resourcesearchresult)
784
+ # are returned.
785
+ # Examples: `"name,location"`, `"name,versionedResources"`, `"*"`.
768
786
  # Any invalid field path will trigger INVALID_ARGUMENT error.
769
787
  class SearchAllResourcesRequest
770
788
  include ::Google::Protobuf::MessageExts
@@ -848,10 +866,10 @@ module Google
848
866
  # @!attribute [rw] page_size
849
867
  # @return [::Integer]
850
868
  # Optional. The page size for search result pagination. Page size is capped
851
- # at 500 even if a larger value is given. If set to zero, server will pick an
852
- # appropriate default. Returned results may be fewer than requested. When
853
- # this happens, there could be more results as long as `next_page_token` is
854
- # returned.
869
+ # at 500 even if a larger value is given. If set to zero or a negative value,
870
+ # server will pick an appropriate default. Returned results may be fewer than
871
+ # requested. When this happens, there could be more results as long as
872
+ # `next_page_token` is returned.
855
873
  # @!attribute [rw] page_token
856
874
  # @return [::String]
857
875
  # Optional. If present, retrieve the next batch of results from the preceding
@@ -1638,8 +1656,8 @@ module Google
1638
1656
  # Only assets belonging to the `parent` will be returned.
1639
1657
  # @!attribute [rw] statement
1640
1658
  # @return [::String]
1641
- # Optional. A SQL statement that's compatible with [BigQuery Standard
1642
- # SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
1659
+ # Optional. A SQL statement that's compatible with [BigQuery
1660
+ # SQL](https://cloud.google.com/bigquery/docs/introduction-sql).
1643
1661
  # @!attribute [rw] job_reference
1644
1662
  # @return [::String]
1645
1663
  # Optional. Reference to the query job, which is from the
@@ -1929,7 +1947,10 @@ module Google
1929
1947
  include ::Google::Protobuf::MessageExts
1930
1948
  extend ::Google::Protobuf::MessageExts::ClassMethods
1931
1949
 
1932
- # Represents a rule defined in an organization policy
1950
+ # This rule message is a customized version of the one defined in the
1951
+ # Organization Policy system. In addition to the fields defined in the
1952
+ # original organization policy, it contains additional field(s) under
1953
+ # specific circumstances to support analysis results.
1933
1954
  # @!attribute [rw] values
1934
1955
  # @return [::Google::Cloud::Asset::V1::AnalyzerOrgPolicy::Rule::StringValues]
1935
1956
  # List of values to be used for this PolicyRule. This field can be set
@@ -2378,7 +2399,7 @@ module Google
2378
2399
  # {::Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedAssetsRequest#constraint AnalyzeOrgPolicyGovernedAssetsRequest.constraint}.
2379
2400
  # @!attribute [rw] attached_resource
2380
2401
  # @return [::String]
2381
- # The full resource name of the resource associated with this IAM policy.
2402
+ # The full resource name of the resource on which this IAM policy is set.
2382
2403
  # Example:
2383
2404
  # `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
2384
2405
  # See [Cloud Asset Inventory Resource Name
@@ -296,8 +296,48 @@ module Google
296
296
  extend ::Google::Protobuf::MessageExts::ClassMethods
297
297
  end
298
298
 
299
+ # The key and value for a
300
+ # [tag](https://cloud.google.com/resource-manager/docs/tags/tags-overview),
301
+ # @!attribute [rw] tag_key
302
+ # @return [::String]
303
+ # TagKey namespaced name, in the format of \\{ORG_ID}/\\{TAG_KEY_SHORT_NAME}.
304
+ # @!attribute [rw] tag_value
305
+ # @return [::String]
306
+ # TagValue namespaced name, in the format of
307
+ # \\{ORG_ID}/\\{TAG_KEY_SHORT_NAME}/\\{TAG_VALUE_SHORT_NAME}.
308
+ # @!attribute [rw] tag_value_id
309
+ # @return [::String]
310
+ # TagValue ID, in the format of tagValues/\\{TAG_VALUE_ID}.
311
+ class Tag
312
+ include ::Google::Protobuf::MessageExts
313
+ extend ::Google::Protobuf::MessageExts::ClassMethods
314
+ end
315
+
316
+ # The effective tags and the ancestor resources from which they were inherited.
317
+ # @!attribute [rw] attached_resource
318
+ # @return [::String]
319
+ # The [full resource
320
+ # name](https://cloud.google.com/asset-inventory/docs/resource-name-format)
321
+ # of the ancestor from which an [effective_tag][] is inherited, according to
322
+ # [tag
323
+ # inheritance](https://cloud.google.com/resource-manager/docs/tags/tags-overview#inheritance).
324
+ # @!attribute [rw] effective_tags
325
+ # @return [::Array<::Google::Cloud::Asset::V1::Tag>]
326
+ # The effective tags inherited from the
327
+ # {::Google::Cloud::Asset::V1::EffectiveTagDetails#attached_resource attached_resource}.
328
+ # Note that tags with the same key but different values may attach to
329
+ # resources at a different hierarchy levels. The lower hierarchy tag value
330
+ # will overwrite the higher hierarchy tag value of the same tag key. In this
331
+ # case, the tag value at the higher hierarchy level will be removed. For more
332
+ # information, see [tag
333
+ # inheritance](https://cloud.google.com/resource-manager/docs/tags/tags-overview#inheritance).
334
+ class EffectiveTagDetails
335
+ include ::Google::Protobuf::MessageExts
336
+ extend ::Google::Protobuf::MessageExts::ClassMethods
337
+ end
338
+
299
339
  # A result of Resource Search, containing information of a cloud resource.
300
- # Next ID: 32
340
+ # Next ID: 34
301
341
  # @!attribute [rw] name
302
342
  # @return [::String]
303
343
  # The full resource name of this resource. Example:
@@ -546,6 +586,9 @@ module Google
546
586
  # types](https://cloud.google.com/asset-inventory/docs/supported-asset-types#supported_relationship_types).
547
587
  # @!attribute [rw] tag_keys
548
588
  # @return [::Array<::String>]
589
+ # This field is only present for the purpose of backward compatibility.
590
+ # Please use the `tags` field instead.
591
+ #
549
592
  # TagKey namespaced names, in the format of \\{ORG_ID}/\\{TAG_KEY_SHORT_NAME}.
550
593
  # To search against the `tagKeys`:
551
594
  #
@@ -558,6 +601,9 @@ module Google
558
601
  # - `env`
559
602
  # @!attribute [rw] tag_values
560
603
  # @return [::Array<::String>]
604
+ # This field is only present for the purpose of backward compatibility.
605
+ # Please use the `tags` field instead.
606
+ #
561
607
  # TagValue namespaced names, in the format of
562
608
  # \\{ORG_ID}/\\{TAG_KEY_SHORT_NAME}/\\{TAG_VALUE_SHORT_NAME}.
563
609
  # To search against the `tagValues`:
@@ -572,15 +618,53 @@ module Google
572
618
  # - `prod`
573
619
  # @!attribute [rw] tag_value_ids
574
620
  # @return [::Array<::String>]
621
+ # This field is only present for the purpose of backward compatibility.
622
+ # Please use the `tags` field instead.
623
+ #
575
624
  # TagValue IDs, in the format of tagValues/\\{TAG_VALUE_ID}.
576
625
  # To search against the `tagValueIds`:
577
626
  #
578
627
  # * Use a field query. Example:
579
- # - `tagValueIds:"456"`
580
628
  # - `tagValueIds="tagValues/456"`
581
629
  #
582
630
  # * Use a free text query. Example:
583
631
  # - `456`
632
+ # @!attribute [rw] tags
633
+ # @return [::Array<::Google::Cloud::Asset::V1::Tag>]
634
+ # The tags directly attached to this resource.
635
+ #
636
+ # To search against the `tags`:
637
+ #
638
+ # * Use a field query. Example:
639
+ # - `tagKeys:"123456789/env*"`
640
+ # - `tagKeys="123456789/env"`
641
+ # - `tagKeys:"env"`
642
+ # - `tagValues:"env"`
643
+ # - `tagValues:"env/prod"`
644
+ # - `tagValues:"123456789/env/prod*"`
645
+ # - `tagValues="123456789/env/prod"`
646
+ # - `tagValueIds="tagValues/456"`
647
+ #
648
+ # * Use a free text query. Example:
649
+ # - `env/prod`
650
+ # @!attribute [rw] effective_tags
651
+ # @return [::Array<::Google::Cloud::Asset::V1::EffectiveTagDetails>]
652
+ # The effective tags on this resource. All of the tags that are both attached
653
+ # to and inherited by a resource are collectively called the effective
654
+ # tags. For more information, see [tag
655
+ # inheritance](https://cloud.google.com/resource-manager/docs/tags/tags-overview#inheritance).
656
+ #
657
+ # To search against the `effective_tags`:
658
+ #
659
+ # * Use a field query. Example:
660
+ # - `effectiveTagKeys:"123456789/env*"`
661
+ # - `effectiveTagKeys="123456789/env"`
662
+ # - `effectiveTagKeys:"env"`
663
+ # - `effectiveTagValues:"env"`
664
+ # - `effectiveTagValues:"env/prod"`
665
+ # - `effectiveTagValues:"123456789/env/prod*"`
666
+ # - `effectiveTagValues="123456789/env/prod"`
667
+ # - `effectiveTagValueIds="tagValues/456"`
584
668
  # @!attribute [rw] parent_asset_type
585
669
  # @return [::String]
586
670
  # The type of this resource's immediate parent, if there is one.
@@ -591,6 +675,21 @@ module Google
591
675
  # `parentAssetType:"cloudresourcemanager.googleapis.com/Project"`
592
676
  # * Use a free text query. Example:
593
677
  # `cloudresourcemanager.googleapis.com/Project`
678
+ # @!attribute [rw] scc_security_marks
679
+ # @return [::Google::Protobuf::Map{::String => ::String}]
680
+ # The actual content of Security Command Center security marks associated
681
+ # with the asset.
682
+ #
683
+ #
684
+ # Note that both staging & prod SecurityMarks are attached on prod resources.
685
+ # In CAS preprod/prod, both staging & prod SecurityMarks are ingested and
686
+ # returned in the following `security_marks` map. In that case, the prefix
687
+ # "staging." will be added to the keys of all the staging marks.
688
+ # To search against SCC SecurityMarks field:
689
+ #
690
+ # * Use a field query:
691
+ # - query by a given key value pair. Example: `sccSecurityMarks.foo=bar`
692
+ # - query by a given key's existence. Example: `sccSecurityMarks.foo:*`
594
693
  class ResourceSearchResult
595
694
  include ::Google::Protobuf::MessageExts
596
695
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -612,6 +711,15 @@ module Google
612
711
  include ::Google::Protobuf::MessageExts
613
712
  extend ::Google::Protobuf::MessageExts::ClassMethods
614
713
  end
714
+
715
+ # @!attribute [rw] key
716
+ # @return [::String]
717
+ # @!attribute [rw] value
718
+ # @return [::String]
719
+ class SccSecurityMarksEntry
720
+ include ::Google::Protobuf::MessageExts
721
+ extend ::Google::Protobuf::MessageExts::ClassMethods
722
+ end
615
723
  end
616
724
 
617
725
  # Resource representation as defined by the corresponding service providing the
@@ -905,17 +1013,17 @@ module Google
905
1013
  # An identity under analysis.
906
1014
  # @!attribute [rw] name
907
1015
  # @return [::String]
908
- # The identity name in any form of members appear in
1016
+ # The identity of members, formatted as appear in an
909
1017
  # [IAM policy
910
- # binding](https://cloud.google.com/iam/reference/rest/v1/Binding), such
911
- # as:
1018
+ # binding](https://cloud.google.com/iam/reference/rest/v1/Binding). For
1019
+ # example, they might be formatted like the following:
1020
+ #
912
1021
  # - user:foo@google.com
913
1022
  # - group:group1@google.com
914
1023
  # - serviceAccount:s1@prj1.iam.gserviceaccount.com
915
1024
  # - projectOwner:some_project_id
916
1025
  # - domain:google.com
917
1026
  # - allUsers
918
- # - etc.
919
1027
  # @!attribute [rw] analysis_state
920
1028
  # @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisState]
921
1029
  # The analysis state of this identity.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-asset-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.27.0
4
+ version: 0.28.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: 2023-09-12 00:00:00.000000000 Z
11
+ date: 2024-01-04 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -285,7 +285,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
285
285
  - !ruby/object:Gem::Version
286
286
  version: '0'
287
287
  requirements: []
288
- rubygems_version: 3.4.19
288
+ rubygems_version: 3.5.3
289
289
  signing_key:
290
290
  specification_version: 4
291
291
  summary: The Cloud Asset API manages the history and inventory of Google Cloud resources.