google-api-client 0.40.0 → 0.41.2

data/generated/google/apis/cloudasset_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/asset-inventory/docs/quickstart
     module CloudassetV1
       VERSION = 'V1'
-      REVISION = '20200515'
+      REVISION = '20200619'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudasset_v1/classes.rb

@@ -27,7 +27,10 @@ module Google
       # hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platform-
       # resource-hierarchy),
       # a resource outside the Google Cloud resource hierarchy (such as Google
-      # Kubernetes Engine clusters and objects), or a Cloud IAM policy.
+      # Kubernetes Engine clusters and objects), or a policy (e.g. Cloud IAM policy).
+      # See [Supported asset
+      # types](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
+      # for more information.
       class Asset
         include Google::Apis::Core::Hashable
       
@@ -59,7 +62,7 @@ module Google
         # @return [Array<String>]
         attr_accessor :ancestors
       
-        # The type of the asset. Example: "compute.googleapis.com/Disk"
+        # The type of the asset. Example: `compute.googleapis.com/Disk`
         # See [Supported asset
         # types](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
         # for more information.
@@ -133,8 +136,8 @@ module Google
         attr_accessor :iam_policy
       
         # The full name of the asset. Example:
-        # "//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/
-        # instance1"
+        # `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/
+        # instance1`
         # See [Resource
         # names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
         # for more information.
@@ -170,6 +173,12 @@ module Google
         # @return [Google::Apis::CloudassetV1::GoogleIdentityAccesscontextmanagerV1ServicePerimeter]
         attr_accessor :service_perimeter
       
+        # The last update timestamp of an asset. update_time is updated when
+        # create/update/delete operation is performed.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
         def initialize(**args)
            update!(**args)
         end
@@ -185,6 +194,7 @@ module Google
           @org_policy = args[:org_policy] if args.key?(:org_policy)
           @resource = args[:resource] if args.key?(:resource)
           @service_perimeter = args[:service_perimeter] if args.key?(:service_perimeter)
+          @update_time = args[:update_time] if args.key?(:update_time)
         end
       end
       
@@ -200,7 +210,7 @@ module Google
       # `
       # "audit_configs": [
       # `
-      # "service": "allServices"
+      # "service": "allServices",
       # "audit_log_configs": [
       # `
       # "log_type": "DATA_READ",
@@ -209,18 +219,18 @@ module Google
       # ]
       # `,
       # `
-      # "log_type": "DATA_WRITE",
+      # "log_type": "DATA_WRITE"
       # `,
       # `
-      # "log_type": "ADMIN_READ",
+      # "log_type": "ADMIN_READ"
       # `
       # ]
       # `,
       # `
-      # "service": "sampleservice.googleapis.com"
+      # "service": "sampleservice.googleapis.com",
       # "audit_log_configs": [
       # `
-      # "log_type": "DATA_READ",
+      # "log_type": "DATA_READ"
       # `,
       # `
       # "log_type": "DATA_WRITE",
@@ -272,7 +282,7 @@ module Google
       # ]
       # `,
       # `
-      # "log_type": "DATA_WRITE",
+      # "log_type": "DATA_WRITE"
       # `
       # ]
       # `
@@ -323,7 +333,7 @@ module Google
         end
       end
       
-      # A BigQuery destination.
+      # A BigQuery destination for exporting assets to.
       class BigQueryDestination
         include Google::Apis::Core::Hashable
       
@@ -503,7 +513,7 @@ module Google
         # permission query (i.e., a query containing `policy.role.permissions:`).
         # Example: if query `policy.role.permissions : "compute.disk.get"`
         # matches a policy binding that contains owner role, the
-        # matched_permissions will be `"roles/owner": ["compute.disk.get"]`. The
+        # matched_permissions will be ``"roles/owner": ["compute.disk.get"]``. The
         # roles can also be found in the returned `policy` bindings. Note that the
         # map is populated only for requests with permission queries.
         # Corresponds to the JSON property `matchedPermissions`
@@ -524,9 +534,18 @@ module Google
       class ExportAssetsRequest
         include Google::Apis::Core::Hashable
       
-        # 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.
         # Corresponds to the JSON property `assetTypes`
@@ -661,6 +680,32 @@ module Google
         # @return [Array<String>]
         attr_accessor :asset_types
       
+        # Represents a textual expression in the Common Expression Language (CEL)
+        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # are documented at https://github.com/google/cel-spec.
+        # Example (Comparison):
+        # title: "Summary size limit"
+        # description: "Determines if a summary is less than 100 chars"
+        # expression: "document.summary.size() < 100"
+        # Example (Equality):
+        # title: "Requestor is owner"
+        # description: "Determines if requestor is the document owner"
+        # expression: "document.owner == request.auth.claims.email"
+        # Example (Logic):
+        # title: "Public documents"
+        # description: "Determine whether the document should be publicly visible"
+        # expression: "document.type != 'private' && document.type != 'internal'"
+        # Example (Data Manipulation):
+        # title: "Notification string"
+        # description: "Create a notification string with a timestamp."
+        # expression: "'New message received at ' + string(document.create_time)"
+        # The exact variables and functions that may be referenced within an expression
+        # are determined by the service that evaluates it. See the service
+        # documentation for additional information.
+        # Corresponds to the JSON property `condition`
+        # @return [Google::Apis::CloudassetV1::Expr]
+        attr_accessor :condition
+      
         # Asset content type. If not specified, no content but the asset name and
         # type will be returned.
         # Corresponds to the JSON property `contentType`
@@ -690,6 +735,7 @@ module Google
         def update!(**args)
           @asset_names = args[:asset_names] if args.key?(:asset_names)
           @asset_types = args[:asset_types] if args.key?(:asset_types)
+          @condition = args[:condition] if args.key?(:condition)
           @content_type = args[:content_type] if args.key?(:content_type)
           @feed_output_config = args[:feed_output_config] if args.key?(:feed_output_config)
           @name = args[:name] if args.key?(:name)
@@ -852,7 +898,7 @@ module Google
         attr_accessor :denied_values
       
         # Determines the inheritance behavior for this `Policy`.
-        # By default, a `ListPolicy` set at a resource supercedes any `Policy` set
+        # By default, a `ListPolicy` set at a resource supersedes any `Policy` set
         # anywhere up the resource hierarchy. However, if `inherit_from_parent` is
         # set to `true`, then the values from the effective `Policy` of the parent
         # resource are inherited, meaning the values set in this `Policy` are
@@ -976,6 +1022,9 @@ module Google
       
         # The name of the `Constraint` the `Policy` is configuring, for example,
         # `constraints/serviceuser.services`.
+        # A [list of available
+        # constraints](/resource-manager/docs/organization-policy/org-policy-constraints)
+        # is available.
         # Immutable after creation.
         # Corresponds to the JSON property `constraint`
         # @return [String]
@@ -1687,8 +1736,8 @@ module Google
       
         # The full resource name of the resource associated with this IAM policy.
         # Example:
-        # "//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/
-        # instance1".
+        # `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/
+        # instance1`.
         # See [Cloud Asset Inventory Resource Name
         # Format](https://cloud.google.com/asset-inventory/docs/resource-name-format)
         # for more information.
@@ -1798,7 +1847,7 @@ module Google
       class OutputConfig
         include Google::Apis::Core::Hashable
       
-        # A BigQuery destination.
+        # A BigQuery destination for exporting assets to.
         # Corresponds to the JSON property `bigqueryDestination`
         # @return [Google::Apis::CloudassetV1::BigQueryDestination]
         attr_accessor :bigquery_destination
@@ -1823,7 +1872,7 @@ module Google
       class Permissions
         include Google::Apis::Core::Hashable
       
-        # A list of permissions. A sample permission string: "compute.disk.get".
+        # A list of permissions. A sample permission string: `compute.disk.get`.
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -1998,7 +2047,7 @@ module Google
       
         # The URL of the discovery document containing the resource's JSON schema.
         # Example:
-        # "https://www.googleapis.com/discovery/v1/apis/compute/v1/rest"
+        # `https://www.googleapis.com/discovery/v1/apis/compute/v1/rest`
         # This value is unspecified for resources that do not have an API based on a
         # discovery document, such as Cloud Bigtable.
         # Corresponds to the JSON property `discoveryDocumentUri`
@@ -2006,7 +2055,7 @@ module Google
         attr_accessor :discovery_document_uri
       
         # The JSON schema name listed in the discovery document. Example:
-        # "Project"
+        # `Project`
         # This value is unspecified for resources that do not have an API based on a
         # discovery document, such as Cloud Bigtable.
         # Corresponds to the JSON property `discoveryName`
@@ -2027,7 +2076,7 @@ module Google
         # [Cloud IAM policy
         # hierarchy](https://cloud.google.com/iam/docs/overview#policy_hierarchy).
         # Example:
-        # "//cloudresourcemanager.googleapis.com/projects/my_project_123"
+        # `//cloudresourcemanager.googleapis.com/projects/my_project_123`
         # For third-party assets, this field may be set differently.
         # Corresponds to the JSON property `parent`
         # @return [String]
@@ -2035,13 +2084,13 @@ module Google
       
         # The REST URL for accessing the resource. An HTTP `GET` request using this
         # URL returns the resource itself. Example:
-        # "https://cloudresourcemanager.googleapis.com/v1/projects/my-project-123"
+        # `https://cloudresourcemanager.googleapis.com/v1/projects/my-project-123`
         # This value is unspecified for resources without a REST API.
         # Corresponds to the JSON property `resourceUrl`
         # @return [String]
         attr_accessor :resource_url
       
-        # The API version. Example: "v1"
+        # The API version. Example: `v1`
         # Corresponds to the JSON property `version`
         # @return [String]
         attr_accessor :version
@@ -2067,17 +2116,25 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The additional attributes of this resource. The attributes may vary from
-        # one resource type to another. Examples: "projectId" for Project,
-        # "dnsName" for DNS ManagedZone.
+        # one resource type to another. Examples: `projectId` for Project,
+        # `dnsName` for DNS ManagedZone. This field contains a subset of the resource
+        # metadata fields that are returned by the List or Get APIs provided by the
+        # corresponding GCP service (e.g., Compute Engine). see [API
+        # references](https://cloud.google.com/asset-inventory/docs/supported-asset-
+        # types#supported_resource_types)
+        # of CAIS supported resource types. You can search values of these fields
+        # through free text search. However, you should not consume the field
+        # programically as the field names and values may change as the GCP service
+        # (e.g., Compute Engine) updates to a new incompatible API version.
         # To search against the `additional_attributes`:
         # * use a free text query to match the attributes values. Example: to search
-        # additional_attributes = ` dnsName: "foobar" `, you can issue a query
+        # `additional_attributes = ` dnsName: "foobar" ``, you can issue a query
         # `"foobar"`.
         # Corresponds to the JSON property `additionalAttributes`
         # @return [Hash<String,Object>]
         attr_accessor :additional_attributes
       
-        # The type of this resource. Example: "compute.googleapis.com/Disk".
+        # The type of this resource. Example: `compute.googleapis.com/Disk`.
         # To search against the `asset_type`:
         # * specify the `asset_type` field in your search request.
         # Corresponds to the JSON property `assetType`
@@ -2115,8 +2172,8 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Location can be "global", regional like "us-east1", or zonal like
-        # "us-west1-b".
+        # Location can be `global`, regional like `us-east1`, or zonal like
+        # `us-west1-b`.
         # To search against the `location`:
         # * use a field query. Example: `location : "us-west*"`
         # * use a free text query. Example: `"us-west*"`
@@ -2125,8 +2182,8 @@ module Google
         attr_accessor :location
       
         # The full resource name of this resource. Example:
-        # "//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/
-        # instance1".
+        # `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/
+        # instance1`.
         # See [Cloud Asset Inventory Resource Name
         # Format](https://cloud.google.com/asset-inventory/docs/resource-name-format)
         # for more information.
@@ -2280,7 +2337,10 @@ module Google
         # hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platform-
         # resource-hierarchy),
         # a resource outside the Google Cloud resource hierarchy (such as Google
-        # Kubernetes Engine clusters and objects), or a Cloud IAM policy.
+        # Kubernetes Engine clusters and objects), or a policy (e.g. Cloud IAM policy).
+        # See [Supported asset
+        # types](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
+        # for more information.
         # Corresponds to the JSON property `asset`
         # @return [Google::Apis::CloudassetV1::Asset]
         attr_accessor :asset
@@ -2291,7 +2351,25 @@ module Google
         attr_accessor :deleted
         alias_method :deleted?, :deleted
       
-        # A time window specified by its "start_time" and "end_time".
+        # An asset in Google Cloud. An asset can be any resource in the Google Cloud
+        # [resource
+        # hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platform-
+        # resource-hierarchy),
+        # a resource outside the Google Cloud resource hierarchy (such as Google
+        # Kubernetes Engine clusters and objects), or a policy (e.g. Cloud IAM policy).
+        # See [Supported asset
+        # types](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
+        # for more information.
+        # Corresponds to the JSON property `priorAsset`
+        # @return [Google::Apis::CloudassetV1::Asset]
+        attr_accessor :prior_asset
+      
+        # State of prior_asset.
+        # Corresponds to the JSON property `priorAssetState`
+        # @return [String]
+        attr_accessor :prior_asset_state
+      
+        # A time window specified by its `start_time` and `end_time`.
         # Corresponds to the JSON property `window`
         # @return [Google::Apis::CloudassetV1::TimeWindow]
         attr_accessor :window
@@ -2304,11 +2382,13 @@ module Google
         def update!(**args)
           @asset = args[:asset] if args.key?(:asset)
           @deleted = args[:deleted] if args.key?(:deleted)
+          @prior_asset = args[:prior_asset] if args.key?(:prior_asset)
+          @prior_asset_state = args[:prior_asset_state] if args.key?(:prior_asset_state)
           @window = args[:window] if args.key?(:window)
         end
       end
       
-      # A time window specified by its "start_time" and "end_time".
+      # A time window specified by its `start_time` and `end_time`.
       class TimeWindow
         include Google::Apis::Core::Hashable
       

data/generated/google/apis/cloudasset_v1/representations.rb

@@ -298,6 +298,7 @@ module Google
       
           property :service_perimeter, as: 'servicePerimeter', class: Google::Apis::CloudassetV1::GoogleIdentityAccesscontextmanagerV1ServicePerimeter, decorator: Google::Apis::CloudassetV1::GoogleIdentityAccesscontextmanagerV1ServicePerimeter::Representation
       
+          property :update_time, as: 'updateTime'
         end
       end
       
@@ -394,6 +395,8 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           collection :asset_names, as: 'assetNames'
           collection :asset_types, as: 'assetTypes'
+          property :condition, as: 'condition', class: Google::Apis::CloudassetV1::Expr, decorator: Google::Apis::CloudassetV1::Expr::Representation
+      
           property :content_type, as: 'contentType'
           property :feed_output_config, as: 'feedOutputConfig', class: Google::Apis::CloudassetV1::FeedOutputConfig, decorator: Google::Apis::CloudassetV1::FeedOutputConfig::Representation
       
@@ -695,6 +698,9 @@ module Google
           property :asset, as: 'asset', class: Google::Apis::CloudassetV1::Asset, decorator: Google::Apis::CloudassetV1::Asset::Representation
       
           property :deleted, as: 'deleted'
+          property :prior_asset, as: 'priorAsset', class: Google::Apis::CloudassetV1::Asset, decorator: Google::Apis::CloudassetV1::Asset::Representation
+      
+          property :prior_asset_state, as: 'priorAssetState'
           property :window, as: 'window', class: Google::Apis::CloudassetV1::TimeWindow, decorator: Google::Apis::CloudassetV1::TimeWindow::Representation
       
         end

data/generated/google/apis/cloudasset_v1/service.rb

@@ -254,10 +254,10 @@ module Google
         end
         
         # Batch gets the update history of assets that overlap a time window.
-        # For RESOURCE content, this API outputs history with asset in both
-        # non-delete or deleted status.
         # For IAM_POLICY content, this API outputs history when the asset and its
         # attached IAM POLICY both exist. This can create gaps in the output history.
+        # Otherwise, this API outputs history with asset in both non-delete or
+        # deleted status.
         # If a specified asset does not exist, this API returns an INVALID_ARGUMENT
         # error.
         # @param [String] parent
@@ -311,13 +311,15 @@ module Google
         end
         
         # Exports assets with time and resource types to a given Cloud Storage
-        # location. The output format is newline-delimited JSON. Each line represents
-        # a google.cloud.asset.v1.Asset in the JSON format.
-        # This API implements the google.longrunning.Operation API allowing you
-        # to keep track of the export. We recommend intervals of at least 2 seconds
-        # with exponential retry to poll the export operation result. For
-        # regular-size resource parent, the export operation usually finishes within
-        # 5 minutes.
+        # location/BigQuery table. For Cloud Storage location destinations, the
+        # output format is newline-delimited JSON. Each line represents a
+        # google.cloud.asset.v1.Asset in the JSON format; for BigQuery table
+        # destinations, the output table stores the fields in asset proto as columns.
+        # This API implements the google.longrunning.Operation API
+        # , which allows you to keep track of the export. We recommend intervals of
+        # at least 2 seconds with exponential retry to poll the export operation
+        # result. For regular-size resource parent, the export operation usually
+        # finishes within 5 minutes.
         # @param [String] parent
         #   Required. The relative name of the root asset. This can only be an
         #   organization number (such as "organizations/123"), a project ID (such as
@@ -355,7 +357,7 @@ module Google
         
         # Searches all the IAM policies within the given accessible scope (e.g., a
         # project, a folder or an organization). Callers should have
-        # cloud.assets.SearchAllIamPolicies permission upon the requested scope,
+        # `cloud.assets.SearchAllIamPolicies` permission upon the requested scope,
         # otherwise the request will be rejected.
         # @param [String] scope
         #   Required. A scope can be a project, a folder or an organization. The search is
@@ -430,7 +432,7 @@ module Google
         
         # Searches all the resources within the given accessible scope (e.g., a
         # project, a folder or an organization). Callers should have
-        # cloud.assets.SearchAllResources permission upon the requested scope,
+        # `cloud.assets.SearchAllResources` permission upon the requested scope,
         # otherwise the request will be rejected.
         # @param [String] scope
         #   Required. A scope can be a project, a folder or an organization. The search is
@@ -450,10 +452,11 @@ module Google
         #   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.
+        #   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.
         # @param [Fixnum] page_size
         #   Optional. The page size for search result pagination. Page size is capped at
         #   500 even