google-cloud-asset-v1 0.5.3 → 0.9.0

data/proto_docs/google/cloud/asset/v1/asset_service.rb

@@ -37,9 +37,22 @@ module Google
         #     running the same query may get different results.
         # @!attribute [rw] asset_types
         #   @return [::Array<::String>]
-        #     A list of asset types of which to take a snapshot for. Example:
-        #     "compute.googleapis.com/Disk". If specified, only matching assets will be
-        #     returned. See [Introduction to Cloud Asset
+        #     A list of asset types to take a snapshot for. For example:
+        #     "compute.googleapis.com/Disk".
+        #
+        #     Regular expressions are also supported. For example:
+        #
+        #     * "compute.googleapis.com.*" snapshots resources whose asset type starts
+        #     with "compute.googleapis.com".
+        #     * ".*Instance" snapshots resources whose asset type ends with "Instance".
+        #     * ".*Instance.*" snapshots resources whose asset type contains "Instance".
+        #
+        #     See [RE2](https://github.com/google/re2/wiki/Syntax) for all supported
+        #     regular expression syntax. If the regular expression does not match any
+        #     supported asset type, an INVALID_ARGUMENT error will be returned.
+        #
+        #     If specified, only matching assets will be returned, otherwise, it will
+        #     snapshot all asset types. See [Introduction to Cloud Asset
         #     Inventory](https://cloud.google.com/asset-inventory/docs/overview)
         #     for all supported asset types.
         # @!attribute [rw] content_type
@@ -48,24 +61,28 @@ module Google
         #     returned.
         # @!attribute [rw] output_config
         #   @return [::Google::Cloud::Asset::V1::OutputConfig]
-        #     Required. Output configuration indicating where the results will be output
-        #     to.
+        #     Required. Output configuration indicating where the results will be output to.
         class ExportAssetsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
         # The export asset response. This message is returned by the
-        # google.longrunning.Operations.GetOperation
-        # method in the returned
-        # {::Google::Longrunning::Operation#response google.longrunning.Operation.response}
-        # field.
+        # google.longrunning.Operations.GetOperation method in the returned
+        # {::Google::Longrunning::Operation#response google.longrunning.Operation.response} field.
         # @!attribute [rw] read_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Time the snapshot was taken.
         # @!attribute [rw] output_config
         #   @return [::Google::Cloud::Asset::V1::OutputConfig]
         #     Output configuration indicating where the results were output to.
+        # @!attribute [rw] output_result
+        #   @return [::Google::Cloud::Asset::V1::OutputResult]
+        #     Output result indicating where the assets were exported to. For example, a
+        #     set of actual Google Cloud Storage object uris where the assets are
+        #     exported to. The uris can be different from what [output_config] has
+        #     specified, as the service will split the output object into multiple ones
+        #     once it exceeds a single Google Cloud Storage object limit.
         class ExportAssetsResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -126,8 +143,9 @@ module Google
         #     be unique under a specific parent project/folder/organization.
         # @!attribute [rw] feed
         #   @return [::Google::Cloud::Asset::V1::Feed]
-        #     Required. The feed details. The field `name` must be empty and it will be
-        #     generated in the format of: projects/project_number/feeds/feed_id
+        #     Required. The feed details. The field `name` must be empty and it will be generated
+        #     in the format of:
+        #     projects/project_number/feeds/feed_id
         #     folders/folder_number/feeds/feed_id
         #     organizations/organization_number/feeds/feed_id
         class CreateFeedRequest
@@ -169,8 +187,8 @@ module Google
         # Update asset feed request.
         # @!attribute [rw] feed
         #   @return [::Google::Cloud::Asset::V1::Feed]
-        #     Required. The new values of feed details. It must match an existing feed
-        #     and the field `name` must be in the format of:
+        #     Required. The new values of feed details. It must match an existing feed and the
+        #     field `name` must be in the format of:
         #     projects/project_number/feeds/feed_id or
         #     folders/folder_number/feeds/feed_id or
         #     organizations/organization_number/feeds/feed_id.
@@ -208,6 +226,25 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Output result of export assets.
+        # @!attribute [rw] gcs_result
+        #   @return [::Google::Cloud::Asset::V1::GcsOutputResult]
+        #     Export result on Cloud Storage.
+        class OutputResult
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A Cloud Storage output result.
+        # @!attribute [rw] uris
+        #   @return [::Array<::String>]
+        #     List of uris of the Cloud Storage objects. Example:
+        #     "gs://bucket_name/object_name".
+        class GcsOutputResult
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # A Cloud Storage location.
         # @!attribute [rw] uri
         #   @return [::String]
@@ -250,11 +287,91 @@ module Google
         #     table will be overwritten by the contents of assets snapshot. If the flag
         #     is `FALSE` or unset and the destination table already exists, the export
         #     call returns an INVALID_ARGUMEMT error.
+        # @!attribute [rw] partition_spec
+        #   @return [::Google::Cloud::Asset::V1::PartitionSpec]
+        #     [partition_spec] determines whether to export to partitioned table(s) and
+        #     how to partition the data.
+        #
+        #     If [partition_spec] is unset or [partition_spec.partition_key] is unset or
+        #     `PARTITION_KEY_UNSPECIFIED`, the snapshot results will be exported to
+        #     non-partitioned table(s). [force] will decide whether to overwrite existing
+        #     table(s).
+        #
+        #     If [partition_spec] is specified. First, the snapshot results will be
+        #     written to partitioned table(s) with two additional timestamp columns,
+        #     readTime and requestTime, one of which will be the partition key. Secondly,
+        #     in the case when any destination table already exists, it will first try to
+        #     update existing table's schema as necessary by appending additional
+        #     columns. Then, if [force] is `TRUE`, the corresponding partition will be
+        #     overwritten by the snapshot results (data in different partitions will
+        #     remain intact); if [force] is unset or `FALSE`, it will append the data. An
+        #     error will be returned if the schema update or data appension fails.
+        # @!attribute [rw] separate_tables_per_asset_type
+        #   @return [::Boolean]
+        #     If this flag is `TRUE`, the snapshot results will be written to one or
+        #     multiple tables, each of which contains results of one asset type. The
+        #     [force] and [partition_spec] fields will apply to each of them.
+        #
+        #     Field [table] will be concatenated with "_" and the asset type names (see
+        #     https://cloud.google.com/asset-inventory/docs/supported-asset-types for
+        #     supported asset types) to construct per-asset-type table names, in which
+        #     all non-alphanumeric characters like "." and "/" will be substituted by
+        #     "_". Example: if field [table] is "mytable" and snapshot results
+        #     contain "storage.googleapis.com/Bucket" assets, the corresponding table
+        #     name will be "mytable_storage_googleapis_com_Bucket". If any of these
+        #     tables does not exist, a new table with the concatenated name will be
+        #     created.
+        #
+        #     When [content_type] in the ExportAssetsRequest is `RESOURCE`, the schema of
+        #     each table will include RECORD-type columns mapped to the nested fields in
+        #     the Asset.resource.data field of that asset type (up to the 15 nested level
+        #     BigQuery supports
+        #     (https://cloud.google.com/bigquery/docs/nested-repeated#limitations)). The
+        #     fields in >15 nested levels will be stored in JSON format string as a child
+        #     column of its parent RECORD column.
+        #
+        #     If error occurs when exporting to any table, the whole export call will
+        #     return an error but the export results that already succeed will persist.
+        #     Example: if exporting to table_type_A succeeds when exporting to
+        #     table_type_B fails during one export call, the results in table_type_A will
+        #     persist and there will not be partial results persisting in a table.
         class BigQueryDestination
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Specifications of BigQuery partitioned table as export destination.
+        # @!attribute [rw] partition_key
+        #   @return [::Google::Cloud::Asset::V1::PartitionSpec::PartitionKey]
+        #     The partition key for BigQuery partitioned table.
+        class PartitionSpec
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # This enum is used to determine the partition key column when exporting
+          # assets to BigQuery partitioned table(s). Note that, if the partition key is
+          # a timestamp column, the actual partition is based on its date value
+          # (expressed in UTC. see details in
+          # https://cloud.google.com/bigquery/docs/partitioned-tables#date_timestamp_partitioned_tables).
+          module PartitionKey
+            # Unspecified partition key. If used, it means using non-partitioned table.
+            PARTITION_KEY_UNSPECIFIED = 0
+
+            # The time when the snapshot is taken. If specified as partition key, the
+            # result table(s) is partitoned by the additional timestamp column,
+            # readTime. If [read_time] in ExportAssetsRequest is specified, the
+            # readTime column's value will be the same as it. Otherwise, its value will
+            # be the current time that is used to take the snapshot.
+            READ_TIME = 1
+
+            # The time when the request is received and started to be processed. If
+            # specified as partition key, the result table(s) is partitoned by the
+            # requestTime column, an additional timestamp column representing when the
+            # request was received.
+            REQUEST_TIME = 2
+          end
+        end
+
         # A Pub/Sub destination.
         # @!attribute [rw] topic
         #   @return [::String]
@@ -324,8 +441,12 @@ module Google
         #     When set, `expression` field in the `Expr` must be a valid [CEL expression]
         #     (https://github.com/google/cel-spec) on a TemporalAsset with name
         #     `temporal_asset`. Example: a Feed with expression ("temporal_asset.deleted
-        #     == true") will only publish Asset deletions. Other fields in `Expr` are
+        #     == true") will only publish Asset deletions. Other fields of `Expr` are
         #     optional.
+        #
+        #     See our [user
+        #     guide](https://cloud.google.com/asset-inventory/docs/monitoring-asset-changes#feed_with_condition)
+        #     for detailed instructions.
         class Feed
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -334,75 +455,81 @@ module Google
         # Search all resources request.
         # @!attribute [rw] scope
         #   @return [::String]
-        #     Required. A scope can be a project, a folder or an organization. The search
-        #     is limited to the resources within the `scope`.
+        #     Required. A scope can be a project, a folder, or an organization. The search is
+        #     limited to the resources within the `scope`. The caller must be granted the
+        #     [`cloudasset.assets.searchAllResources`](http://cloud.google.com/asset-inventory/docs/access-control#required_permissions)
+        #     permission on the desired scope.
         #
         #     The allowed values are:
         #
-        #     * projects/\\{PROJECT_ID}
-        #     * projects/\\{PROJECT_NUMBER}
-        #     * folders/\\{FOLDER_NUMBER}
-        #     * organizations/\\{ORGANIZATION_NUMBER}
+        #     * projects/\\{PROJECT_ID} (e.g., "projects/foo-bar")
+        #     * projects/\\{PROJECT_NUMBER} (e.g., "projects/12345678")
+        #     * folders/\\{FOLDER_NUMBER} (e.g., "folders/1234567")
+        #     * organizations/\\{ORGANIZATION_NUMBER} (e.g., "organizations/123456")
         # @!attribute [rw] query
         #   @return [::String]
-        #     Optional. The query statement. An empty query can be specified to search
-        #     all the resources of certain `asset_types` within the given `scope`.
+        #     Optional. The query statement. See [how to construct a
+        #     query](http://cloud.google.com/asset-inventory/docs/searching-resources#how_to_construct_a_query)
+        #     for more information. If not specified or empty, it will search all the
+        #     resources within the specified `scope`. Note that the query string is
+        #     compared against each Cloud IAM policy binding, including its members,
+        #     roles, and Cloud IAM conditions. The returned Cloud IAM policies will only
+        #     contain the bindings that match your query. To learn more about the IAM
+        #     policy structure, see [IAM policy
+        #     doc](https://cloud.google.com/iam/docs/policies#structure).
         #
         #     Examples:
         #
-        #     * `name : "Important"` to find Cloud resources whose name contains
+        #     * `name:Important` to find Cloud resources whose name contains
         #       "Important" as a word.
-        #     * `displayName : "Impor*"` to find Cloud resources whose display name
-        #       contains "Impor" as a word prefix.
-        #     * `description : "*por*"` to find Cloud resources whose description
+        #     * `displayName:Impor*` to find Cloud resources whose display name
+        #       contains "Impor" as a prefix.
+        #     * `description:*por*` to find Cloud resources whose description
         #       contains "por" as a substring.
-        #     * `location : "us-west*"` to find Cloud resources whose location is
+        #     * `location:us-west*` to find Cloud resources whose location is
         #       prefixed with "us-west".
-        #     * `labels : "prod"` to find Cloud resources whose labels contain "prod" as
+        #     * `labels:prod` to find Cloud resources whose labels contain "prod" as
         #       a key or value.
-        #     * `labels.env : "prod"` to find Cloud resources which have a label "env"
+        #     * `labels.env:prod` to find Cloud resources that have a label "env"
         #       and its value is "prod".
-        #     * `labels.env : *` to find Cloud resources which have a label "env".
-        #     * `"Important"` to find Cloud resources which contain "Important" as a word
+        #     * `labels.env:*` to find Cloud resources that have a label "env".
+        #     * `Important` to find Cloud resources that contain "Important" as a word
         #       in any of the searchable fields.
-        #     * `"Impor*"` to find Cloud resources which contain "Impor" as a word prefix
+        #     * `Impor*` to find Cloud resources that contain "Impor" as a prefix
         #       in any of the searchable fields.
-        #     * `"*por*"` to find Cloud resources which contain "por" as a substring in
+        #     * `*por*` to find Cloud resources that contain "por" as a substring in
         #       any of the searchable fields.
-        #     * `("Important" AND location : ("us-west1" OR "global"))` to find Cloud
-        #       resources which contain "Important" as a word in any of the searchable
+        #     * `Important location:(us-west1 OR global)` to find Cloud
+        #       resources that contain "Important" as a word in any of the searchable
         #       fields and are also located in the "us-west1" region or the "global"
         #       location.
-        #
-        #     See [how to construct a
-        #     query](https://cloud.google.com/asset-inventory/docs/searching-resources#how_to_construct_a_query)
-        #     for more details.
         # @!attribute [rw] asset_types
         #   @return [::Array<::String>]
-        #     Optional. A list of asset types that this request searches for. If empty,
-        #     it will search all the [searchable asset
+        #     Optional. A list of asset types that this request searches for. If empty, it will
+        #     search all the [searchable asset
         #     types](https://cloud.google.com/asset-inventory/docs/supported-asset-types#searchable_asset_types).
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     Optional. The page size for search result pagination. Page size is capped
-        #     at 500 even if a larger value is given. If set to zero, server will pick an
-        #     appropriate default. Returned results may be fewer than requested. When
-        #     this happens, there could be more results as long as `next_page_token` is
-        #     returned.
+        #     Optional. The page size for search result pagination. Page size is capped at 500 even
+        #     if a larger value is given. If set to zero, server will pick an appropriate
+        #     default. Returned results may be fewer than requested. When this happens,
+        #     there could be more results as long as `next_page_token` is returned.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. If present, then retrieve the next batch of results from the
-        #     preceding call to this method. `page_token` must be the value of
-        #     `next_page_token` from the previous response. The values of all other
-        #     method parameters, must be identical to those in the previous call.
+        #     Optional. If present, then retrieve the next batch of results from the preceding call
+        #     to this method. `page_token` must be the value of `next_page_token` from
+        #     the previous response. The values of all other method parameters, must be
+        #     identical to those in the previous call.
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Optional. A comma separated list of fields specifying the sorting order of
-        #     the results. The default order is ascending. Add " DESC" after the field
-        #     name to indicate descending order. Redundant space characters are ignored.
-        #     Example: "location DESC, name". See [supported resource metadata
-        #     fields](https://cloud.google.com/asset-inventory/docs/searching-resources#query_on_resource_metadata_fields)
-        #     for more details.
+        #     Optional. A comma separated list of fields specifying the sorting order of the
+        #     results. The default order is ascending. Add " DESC" after the field name
+        #     to indicate descending order. Redundant space characters are ignored.
+        #     Example: "location DESC, name". Only string fields in the response are
+        #     sortable, including `name`, `displayName`, `description`, `location`. All
+        #     the other fields such as repeated fields (e.g., `networkTags`), map
+        #     fields (e.g., `labels`) and struct fields (e.g., `additionalAttributes`)
+        #     are not supported.
         class SearchAllResourcesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -426,51 +553,58 @@ module Google
         # Search all IAM policies request.
         # @!attribute [rw] scope
         #   @return [::String]
-        #     Required. A scope can be a project, a folder or an organization. The search
-        #     is limited to the IAM policies within the `scope`.
+        #     Required. A scope can be a project, a folder, or an organization. The search is
+        #     limited to the IAM policies within the `scope`. The caller must be granted
+        #     the
+        #     [`cloudasset.assets.searchAllIamPolicies`](http://cloud.google.com/asset-inventory/docs/access-control#required_permissions)
+        #     permission on the desired scope.
         #
         #     The allowed values are:
         #
-        #     * projects/\\{PROJECT_ID}
-        #     * projects/\\{PROJECT_NUMBER}
-        #     * folders/\\{FOLDER_NUMBER}
-        #     * organizations/\\{ORGANIZATION_NUMBER}
+        #     * projects/\\{PROJECT_ID} (e.g., "projects/foo-bar")
+        #     * projects/\\{PROJECT_NUMBER} (e.g., "projects/12345678")
+        #     * folders/\\{FOLDER_NUMBER} (e.g., "folders/1234567")
+        #     * organizations/\\{ORGANIZATION_NUMBER} (e.g., "organizations/123456")
         # @!attribute [rw] query
         #   @return [::String]
-        #     Optional. The query statement. An empty query can be specified to search
-        #     all the IAM policies within the given `scope`.
+        #     Optional. The query statement. See [how to construct a
+        #     query](https://cloud.google.com/asset-inventory/docs/searching-iam-policies#how_to_construct_a_query)
+        #     for more information. If not specified or empty, it will search all the
+        #     IAM policies within the specified `scope`.
         #
         #     Examples:
         #
-        #     * `policy : "amy@gmail.com"` to find Cloud IAM policy bindings that
-        #       specify user "amy@gmail.com".
-        #     * `policy : "roles/compute.admin"` to find Cloud IAM policy bindings that
-        #       specify the Compute Admin role.
-        #     * `policy.role.permissions : "storage.buckets.update"` to find Cloud IAM
-        #       policy bindings that specify a role containing "storage.buckets.update"
-        #       permission.
-        #     * `resource : "organizations/123"` to find Cloud IAM policy bindings that
-        #       are set on "organizations/123".
-        #     * `(resource : ("organizations/123" OR "folders/1234") AND policy : "amy")`
-        #       to find Cloud IAM policy bindings that are set on "organizations/123" or
-        #       "folders/1234", and also specify user "amy".
-        #
-        #     See [how to construct a
-        #     query](https://cloud.google.com/asset-inventory/docs/searching-iam-policies#how_to_construct_a_query)
-        #     for more details.
+        #     * `policy:amy@gmail.com` to find IAM policy bindings that specify user
+        #       "amy@gmail.com".
+        #     * `policy:roles/compute.admin` to find IAM policy bindings that specify
+        #       the Compute Admin role.
+        #     * `policy.role.permissions:storage.buckets.update` to find IAM policy
+        #       bindings that specify a role containing "storage.buckets.update"
+        #       permission. Note that if callers don't have `iam.roles.get` access to a
+        #       role's included permissions, policy bindings that specify this role will
+        #       be dropped from the search results.
+        #     * `resource:organizations/123456` to find IAM policy bindings
+        #       that are set on "organizations/123456".
+        #     * `Important` to find IAM policy bindings that contain "Important" as a
+        #       word in any of the searchable fields (except for the included
+        #       permissions).
+        #     * `*por*` to find IAM policy bindings that contain "por" as a substring
+        #       in any of the searchable fields (except for the included permissions).
+        #     * `resource:(instance1 OR instance2) policy:amy` to find
+        #       IAM policy bindings that are set on resources "instance1" or
+        #       "instance2" and also specify user "amy".
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     Optional. The page size for search result pagination. Page size is capped
-        #     at 500 even if a larger value is given. If set to zero, server will pick an
-        #     appropriate default. Returned results may be fewer than requested. When
-        #     this happens, there could be more results as long as `next_page_token` is
-        #     returned.
+        #     Optional. The page size for search result pagination. Page size is capped at 500 even
+        #     if a larger value is given. If set to zero, server will pick an appropriate
+        #     default. Returned results may be fewer than requested. When this happens,
+        #     there could be more results as long as `next_page_token` is returned.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. If present, retrieve the next batch of results from the preceding
-        #     call to this method. `page_token` must be the value of `next_page_token`
-        #     from the previous response. The values of all other method parameters must
-        #     be identical to those in the previous call.
+        #     Optional. If present, retrieve the next batch of results from the preceding call to
+        #     this method. `page_token` must be the value of `next_page_token` from the
+        #     previous response. The values of all other method parameters must be
+        #     identical to those in the previous call.
         class SearchAllIamPoliciesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -491,6 +625,329 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # IAM policy analysis query message.
+        # @!attribute [rw] scope
+        #   @return [::String]
+        #     Required. The relative name of the root asset. Only resources and IAM policies within
+        #     the scope will be analyzed.
+        #
+        #     This can only be an organization number (such as "organizations/123"), a
+        #     folder number (such as "folders/123"), a project ID (such as
+        #     "projects/my-project-id"), or a project number (such as "projects/12345").
+        #
+        #     To know how to get organization id, visit [here
+        #     ](https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id).
+        #
+        #     To know how to get folder or project id, visit [here
+        #     ](https://cloud.google.com/resource-manager/docs/creating-managing-folders#viewing_or_listing_folders_and_projects).
+        # @!attribute [rw] resource_selector
+        #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery::ResourceSelector]
+        #     Optional. Specifies a resource for analysis.
+        # @!attribute [rw] identity_selector
+        #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery::IdentitySelector]
+        #     Optional. Specifies an identity for analysis.
+        # @!attribute [rw] access_selector
+        #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery::AccessSelector]
+        #     Optional. Specifies roles or permissions for analysis. This is optional.
+        # @!attribute [rw] options
+        #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery::Options]
+        #     Optional. The query options.
+        class IamPolicyAnalysisQuery
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Specifies the resource to analyze for access policies, which may be set
+          # directly on the resource, or on ancestors such as organizations, folders or
+          # projects.
+          # @!attribute [rw] full_resource_name
+          #   @return [::String]
+          #     Required. The [full resource name]
+          #     (https://cloud.google.com/asset-inventory/docs/resource-name-format)
+          #     of a resource of [supported resource
+          #     types](https://cloud.google.com/asset-inventory/docs/supported-asset-types#analyzable_asset_types).
+          class ResourceSelector
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Specifies an identity for which to determine resource access, based on
+          # roles assigned either directly to them or to the groups they belong to,
+          # directly or indirectly.
+          # @!attribute [rw] identity
+          #   @return [::String]
+          #     Required. The identity appear in the form of members in
+          #     [IAM policy
+          #     binding](https://cloud.google.com/iam/reference/rest/v1/Binding).
+          #
+          #     The examples of supported forms are:
+          #     "user:mike@example.com",
+          #     "group:admins@example.com",
+          #     "domain:google.com",
+          #     "serviceAccount:my-project-id@appspot.gserviceaccount.com".
+          #
+          #     Notice that wildcard characters (such as * and ?) are not supported.
+          #     You must give a specific identity.
+          class IdentitySelector
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Specifies roles and/or permissions to analyze, to determine both the
+          # identities possessing them and the resources they control. If multiple
+          # values are specified, results will include roles or permissions matching
+          # any of them. The total number of roles and permissions should be equal or
+          # less than 10.
+          # @!attribute [rw] roles
+          #   @return [::Array<::String>]
+          #     Optional. The roles to appear in result.
+          # @!attribute [rw] permissions
+          #   @return [::Array<::String>]
+          #     Optional. The permissions to appear in result.
+          class AccessSelector
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Contains query options.
+          # @!attribute [rw] expand_groups
+          #   @return [::Boolean]
+          #     Optional. If true, the identities section of the result will expand any
+          #     Google groups appearing in an IAM policy binding.
+          #
+          #     If {::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery#identity_selector IamPolicyAnalysisQuery.identity_selector} is specified, the
+          #     identity in the result will be determined by the selector, and this flag
+          #     is not allowed to set.
+          #
+          #     Default is false.
+          # @!attribute [rw] expand_roles
+          #   @return [::Boolean]
+          #     Optional. If true, the access section of result will expand any roles
+          #     appearing in IAM policy bindings to include their permissions.
+          #
+          #     If {::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery#access_selector IamPolicyAnalysisQuery.access_selector} is specified, the access
+          #     section of the result will be determined by the selector, and this flag
+          #     is not allowed to set.
+          #
+          #     Default is false.
+          # @!attribute [rw] expand_resources
+          #   @return [::Boolean]
+          #     Optional. If true and {::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery#resource_selector IamPolicyAnalysisQuery.resource_selector} is not
+          #     specified, the resource section of the result will expand any resource
+          #     attached to an IAM policy to include resources lower in the resource
+          #     hierarchy.
+          #
+          #     For example, if the request analyzes for which resources user A has
+          #     permission P, and the results include an IAM policy with P on a GCP
+          #     folder, the results will also include resources in that folder with
+          #     permission P.
+          #
+          #     If true and {::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery#resource_selector IamPolicyAnalysisQuery.resource_selector} is specified,
+          #     the resource section of the result will expand the specified resource to
+          #     include resources lower in the resource hierarchy. Only project or
+          #     lower resources are supported. Folder and organization resource cannot be
+          #     used together with this option.
+          #
+          #     For example, if the request analyzes for which users have permission P on
+          #     a GCP project with this option enabled, the results will include all
+          #     users who have permission P on that project or any lower resource.
+          #
+          #     Default is false.
+          # @!attribute [rw] output_resource_edges
+          #   @return [::Boolean]
+          #     Optional. If true, the result will output resource edges, starting
+          #     from the policy attached resource, to any expanded resources.
+          #     Default is false.
+          # @!attribute [rw] output_group_edges
+          #   @return [::Boolean]
+          #     Optional. If true, the result will output group identity edges, starting
+          #     from the binding's group members, to any expanded identities.
+          #     Default is false.
+          # @!attribute [rw] analyze_service_account_impersonation
+          #   @return [::Boolean]
+          #     Optional. If true, the response will include access analysis from identities to
+          #     resources via service account impersonation. This is a very expensive
+          #     operation, because many derived queries will be executed. We highly
+          #     recommend you use {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy_longrunning AssetService.AnalyzeIamPolicyLongrunning} rpc
+          #     instead.
+          #
+          #     For example, if the request analyzes for which resources user A has
+          #     permission P, and there's an IAM policy states user A has
+          #     iam.serviceAccounts.getAccessToken permission to a service account SA,
+          #     and there's another IAM policy states service account SA has permission P
+          #     to a GCP folder F, then user A potentially has access to the GCP folder
+          #     F. And those advanced analysis results will be included in
+          #     {::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse#service_account_impersonation_analysis AnalyzeIamPolicyResponse.service_account_impersonation_analysis}.
+          #
+          #     Another example, if the request analyzes for who has
+          #     permission P to a GCP folder F, and there's an IAM policy states user A
+          #     has iam.serviceAccounts.actAs permission to a service account SA, and
+          #     there's another IAM policy states service account SA has permission P to
+          #     the GCP folder F, then user A potentially has access to the GCP folder
+          #     F. And those advanced analysis results will be included in
+          #     {::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse#service_account_impersonation_analysis AnalyzeIamPolicyResponse.service_account_impersonation_analysis}.
+          #
+          #     Default is false.
+          class Options
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # A request message for {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy AssetService.AnalyzeIamPolicy}.
+        # @!attribute [rw] analysis_query
+        #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery]
+        #     Required. The request query.
+        # @!attribute [rw] execution_timeout
+        #   @return [::Google::Protobuf::Duration]
+        #     Optional. Amount of time executable has to complete.  See JSON representation of
+        #     [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json).
+        #
+        #     If this field is set with a value less than the RPC deadline, and the
+        #     execution of your query hasn't finished in the specified
+        #     execution timeout,  you will get a response with partial result.
+        #     Otherwise, your query's execution will continue until the RPC deadline.
+        #     If it's not finished until then, you will get a  DEADLINE_EXCEEDED error.
+        #
+        #     Default is empty.
+        class AnalyzeIamPolicyRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A response message for {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy AssetService.AnalyzeIamPolicy}.
+        # @!attribute [rw] main_analysis
+        #   @return [::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse::IamPolicyAnalysis]
+        #     The main analysis that matches the original request.
+        # @!attribute [rw] service_account_impersonation_analysis
+        #   @return [::Array<::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse::IamPolicyAnalysis>]
+        #     The service account impersonation analysis if
+        #     [AnalyzeIamPolicyRequest.analyze_service_account_impersonation][] is
+        #     enabled.
+        # @!attribute [rw] fully_explored
+        #   @return [::Boolean]
+        #     Represents whether all entries in the {::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse#main_analysis main_analysis} and
+        #     {::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse#service_account_impersonation_analysis service_account_impersonation_analysis} have been fully explored to
+        #     answer the query in the request.
+        class AnalyzeIamPolicyResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # An analysis message to group the query and results.
+          # @!attribute [rw] analysis_query
+          #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery]
+          #     The analysis query.
+          # @!attribute [rw] analysis_results
+          #   @return [::Array<::Google::Cloud::Asset::V1::IamPolicyAnalysisResult>]
+          #     A list of {::Google::Cloud::Asset::V1::IamPolicyAnalysisResult IamPolicyAnalysisResult} that matches the analysis query, or
+          #     empty if no result is found.
+          # @!attribute [rw] fully_explored
+          #   @return [::Boolean]
+          #     Represents whether all entries in the {::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse::IamPolicyAnalysis#analysis_results analysis_results} have been
+          #     fully explored to answer the query.
+          # @!attribute [rw] non_critical_errors
+          #   @return [::Array<::Google::Cloud::Asset::V1::IamPolicyAnalysisState>]
+          #     A list of non-critical errors happened during the query handling.
+          class IamPolicyAnalysis
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Output configuration for export IAM policy analysis destination.
+        # @!attribute [rw] gcs_destination
+        #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisOutputConfig::GcsDestination]
+        #     Destination on Cloud Storage.
+        # @!attribute [rw] bigquery_destination
+        #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisOutputConfig::BigQueryDestination]
+        #     Destination on BigQuery.
+        class IamPolicyAnalysisOutputConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # A Cloud Storage location.
+          # @!attribute [rw] uri
+          #   @return [::String]
+          #     Required. The uri of the Cloud Storage object. It's the same uri that is used by
+          #     gsutil. For example: "gs://bucket_name/object_name". See
+          #     [Quickstart: Using the gsutil tool]
+          #     (https://cloud.google.com/storage/docs/quickstart-gsutil) for examples.
+          class GcsDestination
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # A BigQuery destination.
+          # @!attribute [rw] dataset
+          #   @return [::String]
+          #     Required. The BigQuery dataset in format "projects/projectId/datasets/datasetId",
+          #     to which the analysis results should be exported. If this dataset does
+          #     not exist, the export call will return an INVALID_ARGUMENT error.
+          # @!attribute [rw] table_prefix
+          #   @return [::String]
+          #     Required. The prefix of the BigQuery tables to which the analysis results will be
+          #     written. Tables will be created based on this table_prefix if not exist:
+          #     * <table_prefix>_analysis table will contain export operation's metadata.
+          #     * <table_prefix>_analysis_result will contain all the
+          #       {::Google::Cloud::Asset::V1::IamPolicyAnalysisResult IamPolicyAnalysisResult}.
+          #     When [partition_key] is specified, both tables will be partitioned based
+          #     on the [partition_key].
+          # @!attribute [rw] partition_key
+          #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisOutputConfig::BigQueryDestination::PartitionKey]
+          #     The partition key for BigQuery partitioned table.
+          # @!attribute [rw] write_disposition
+          #   @return [::String]
+          #     Optional. Specifies the action that occurs if the destination table or partition
+          #     already exists. The following values are supported:
+          #
+          #     * WRITE_TRUNCATE: If the table or partition already exists, BigQuery
+          #     overwrites the entire table or all the partitions data.
+          #     * WRITE_APPEND: If the table or partition already exists, BigQuery
+          #     appends the data to the table or the latest partition.
+          #     * WRITE_EMPTY: If the table already exists and contains data, an error is
+          #     returned.
+          #
+          #     The default value is WRITE_APPEND. Each action is atomic and only occurs
+          #     if BigQuery is able to complete the job successfully. Details are at
+          #     https://cloud.google.com/bigquery/docs/loading-data-local#appending_to_or_overwriting_a_table_using_a_local_file.
+          class BigQueryDestination
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # This enum determines the partition key column for the bigquery tables.
+            # Partitioning can improve query performance and reduce query cost by
+            # filtering partitions. Refer to
+            # https://cloud.google.com/bigquery/docs/partitioned-tables for details.
+            module PartitionKey
+              # Unspecified partition key. Tables won't be partitioned using this
+              # option.
+              PARTITION_KEY_UNSPECIFIED = 0
+
+              # The time when the request is received. If specified as partition key,
+              # the result table(s) is partitoned by the RequestTime column, an
+              # additional timestamp column representing when the request was received.
+              REQUEST_TIME = 1
+            end
+          end
+        end
+
+        # A request message for {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy_longrunning AssetService.AnalyzeIamPolicyLongrunning}.
+        # @!attribute [rw] analysis_query
+        #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisQuery]
+        #     Required. The request query.
+        # @!attribute [rw] output_config
+        #   @return [::Google::Cloud::Asset::V1::IamPolicyAnalysisOutputConfig]
+        #     Required. Output configuration indicating where the results will be output to.
+        class AnalyzeIamPolicyLongrunningRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A response message for {::Google::Cloud::Asset::V1::AssetService::Client#analyze_iam_policy_longrunning AssetService.AnalyzeIamPolicyLongrunning}.
+        class AnalyzeIamPolicyLongrunningResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Asset content type.
         module ContentType
           # Unspecified content type.
@@ -505,8 +962,11 @@ module Google
           # The Cloud Organization Policy set on an asset.
           ORG_POLICY = 4
 
-          # The Cloud Access context mananger Policy set on an asset.
+          # The Cloud Access context manager Policy set on an asset.
           ACCESS_POLICY = 5
+
+          # The runtime OS Inventory information.
+          OS_INVENTORY = 6
         end
       end
     end