google-cloud-asset-v1 0.27.0 → 0.28.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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.