google-api-client 0.39.0 → 0.40.0

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

@@ -80,34 +80,36 @@ module Google
         
         # Looks up assignments for a specified resource for a particular region.
         # If the request is about a project:
-        # 1) Assignments created on the project will be returned if they exist.
-        # 2) Otherwise assignments created on the closest ancestor will be
-        # returned. 3) Assignments for different JobTypes will all be returned.
-        # Same logic applies if the request is about a folder.
+        # 1. Assignments created on the project will be returned if they exist.
+        # 2. Otherwise assignments created on the closest ancestor will be
+        # returned.
+        # 3. Assignments for different JobTypes will all be returned.
+        # The same logic applies if the request is about a folder.
         # If the request is about an organization, then assignments created on the
         # organization will be returned (organization doesn't have ancestors).
         # Comparing to ListAssignments, there are some behavior
         # differences:
-        # 1) permission on the assignee will be verified in this API.
-        # 2) Hierarchy lookup (project->folder->organization) happens in this API.
-        # 3) Parent here is projects/*/locations/*, instead of
-        # projects/*/locations/*reservations/*.
-        # Note "-" cannot be used for projects
+        # 1. permission on the assignee will be verified in this API.
+        # 2. Hierarchy lookup (project->folder->organization) happens in this API.
+        # 3. Parent here is `projects/*/locations/*`, instead of
+        # `projects/*/locations/*reservations/*`.
+        # **Note** "-" cannot be used for projects
         # nor locations.
         # @param [String] parent
         #   Required. The resource name of the admin project(containing project and
         #   location),
         #   e.g.:
-        #   "projects/myproject/locations/US".
+        #   `projects/myproject/locations/US`.
         # @param [Fixnum] page_size
         #   The maximum number of items to return.
         # @param [String] page_token
         #   The next_page_token value returned from a previous List request, if any.
         # @param [String] query
         #   Please specify resource name as assignee in the query.
-        #   e.g., "assignee=projects/myproject"
-        #   "assignee=folders/123"
-        #   "assignee=organizations/456"
+        #   Examples:
+        #   * `assignee=projects/myproject`
+        #   * `assignee=folders/123`
+        #   * `assignee=organizations/456`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -139,8 +141,8 @@ module Google
         end
         
         # Updates a BI reservation.
-        # Only fields specified in the field_mask are updated.
-        # Singleton BI reservation always exists with default size 0.
+        # Only fields specified in the `field_mask` are updated.
+        # A singleton BI reservation always exists with default size 0.
         # In order to reserve BI capacity it needs to be updated to an amount
         # greater than 0. In order to release BI capacity reservation size
         # must be set to 0.
@@ -184,7 +186,7 @@ module Google
         # Creates a new capacity commitment resource.
         # @param [String] parent
         #   Required. Resource name of the parent reservation. E.g.,
-        #   projects/myproject/locations/US
+        #   `projects/myproject/locations/US`
         # @param [Google::Apis::BigqueryreservationV1beta1::CapacityCommitment] capacity_commitment_object
         # @param [Boolean] enforce_single_admin_project_per_org
         #   If true, fail the request if another project in the organization has a
@@ -224,7 +226,7 @@ module Google
         # `google.rpc.Code.FAILED_PRECONDITION`.
         # @param [String] name
         #   Required. Resource name of the capacity commitment to delete. E.g.,
-        #   projects/myproject/locations/US/capacityCommitments/123
+        #   `projects/myproject/locations/US/capacityCommitments/123`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -255,7 +257,7 @@ module Google
         # Returns information about the capacity commitment.
         # @param [String] name
         #   Required. Resource name of the capacity commitment to retrieve. E.g.,
-        #   projects/myproject/locations/US/capacityCommitments/123
+        #   `projects/myproject/locations/US/capacityCommitments/123`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -286,7 +288,7 @@ module Google
         # Lists all the capacity commitments for the admin project.
         # @param [String] parent
         #   Required. Resource name of the parent reservation. E.g.,
-        #   projects/myproject/locations/US
+        #   `projects/myproject/locations/US`
         # @param [Fixnum] page_size
         #   The maximum number of items to return.
         # @param [String] page_token
@@ -320,13 +322,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Merges capacity commitments of the same plan into one. Resulting capacity
-        # commitment has the longer commitment_end_time out of the two. Attempting to
-        # merge capacity commitments of different plan will fail with the error code
-        # `google.rpc.Code.FAILED_PRECONDITION`.
+        # Merges capacity commitments of the same plan into a single commitment.
+        # The resulting capacity commitment has the greater commitment_end_time
+        # out of the to-be-merged capacity commitments.
+        # Attempting to merge capacity commitments of different plan will fail
+        # with the error code `google.rpc.Code.FAILED_PRECONDITION`.
         # @param [String] parent
         #   Parent resource that identifies admin project and location e.g.,
-        #   projects/myproject/locations/us
+        #   `projects/myproject/locations/us`
         # @param [Google::Apis::BigqueryreservationV1beta1::MergeCapacityCommitmentsRequest] merge_capacity_commitments_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -358,13 +361,13 @@ module Google
         end
         
         # Updates an existing capacity commitment.
-        # Only plan and renewal_plan fields can be updated.
+        # Only `plan` and `renewal_plan` fields can be updated.
         # Plan can only be changed to a plan of a longer commitment period.
         # Attempting to change to a plan with shorter commitment period will fail
         # with the error code `google.rpc.Code.FAILED_PRECONDITION`.
         # @param [String] name
         #   Output only. The resource name of the capacity commitment, e.g.,
-        #   projects/myproject/locations/US/capacityCommitments/123
+        #   `projects/myproject/locations/US/capacityCommitments/123`
         # @param [Google::Apis::BigqueryreservationV1beta1::CapacityCommitment] capacity_commitment_object
         # @param [String] update_mask
         #   Standard field mask for the set of fields to be updated.
@@ -399,13 +402,14 @@ module Google
         end
         
         # Splits capacity commitment to two commitments of the same plan and
-        # commitment_end_time. A common use case to do that is to perform a downgrade
-        # e.g., in order to downgrade from 10000 slots to 8000, one might split 10000
-        # capacity commitment to 2000 and 8000, change the plan of the first one to
-        # flex and then delete it.
+        # `commitment_end_time`.
+        # A common use case is to enable downgrading commitments.
+        # For example, in order to downgrade from 10000 slots to 8000, you might
+        # split a 10000 capacity commitment into commitments of 2000 and 8000. Then,
+        # you would change the plan of the first one to `FLEX` and then delete it.
         # @param [String] name
         #   Required. The resource name e.g.,:
-        #   projects/myproject/locations/US/capacityCommitments/123
+        #   `projects/myproject/locations/US/capacityCommitments/123`
         # @param [Google::Apis::BigqueryreservationV1beta1::SplitCapacityCommitmentRequest] split_capacity_commitment_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -439,7 +443,7 @@ module Google
         # Creates a new reservation resource.
         # @param [String] parent
         #   Required. Project, location. E.g.,
-        #   projects/myproject/locations/US
+        #   `projects/myproject/locations/US`
         # @param [Google::Apis::BigqueryreservationV1beta1::Reservation] reservation_object
         # @param [String] reservation_id
         #   The reservation ID. This field must only contain lower case alphanumeric
@@ -479,7 +483,7 @@ module Google
         # assignments.
         # @param [String] name
         #   Required. Resource name of the reservation to retrieve. E.g.,
-        #   projects/myproject/locations/US/reservations/team1-prod
+        #   `projects/myproject/locations/US/reservations/team1-prod`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -510,7 +514,7 @@ module Google
         # Returns information about the reservation.
         # @param [String] name
         #   Required. Resource name of the reservation to retrieve. E.g.,
-        #   projects/myproject/locations/US/reservations/team1-prod
+        #   `projects/myproject/locations/US/reservations/team1-prod`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -541,7 +545,7 @@ module Google
         # Lists all the reservations for the project in the specified location.
         # @param [String] parent
         #   Required. The parent resource name containing project and location, e.g.:
-        #   "projects/myproject/locations/US"
+        #   `projects/myproject/locations/US`
         # @param [String] filter
         #   Can be used to filter out reservations based on names, capacity, etc, e.g.:
         #   filter="reservation.slot_capacity > 200"
@@ -585,7 +589,7 @@ module Google
         # Updates an existing reservation resource.
         # @param [String] name
         #   The resource name of the reservation, e.g.,
-        #   "projects/*/locations/*/reservations/team1-prod".
+        #   `projects/*/locations/*/reservations/team1-prod`.
         # @param [Google::Apis::BigqueryreservationV1beta1::Reservation] reservation_object
         # @param [String] update_mask
         #   Standard field mask for the set of fields to be updated.
@@ -619,6 +623,24 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates an assignment object which allows the given project to submit jobs
+        # of a certain type using slots from the specified reservation.
+        # Currently a
+        # resource (project, folder, organization) can only have one assignment per
+        # each (job_type, location) combination, and that reservation will be used
+        # for all jobs of the matching type.
+        # Different assignments can be created on different levels of the
+        # projects, folders or organization hierarchy.  During query execution,
+        # the assignment is looked up at the project, folder and organization levels
+        # in that order. The first assignment found is applied to the query.
+        # When creating assignments, it does not matter if other assignments exist at
+        # higher levels.
+        # Example:
+        # * The organization `organizationA` contains two projects, `project1`
+        # and `project2`.
+        # * Assignments for all three entities (`organizationA`, `project1`, and
+        # `project2`) could all be created and mapped to the same or different
+        # reservations.
         # Returns `google.rpc.Code.PERMISSION_DENIED` if user does not have
         # 'bigquery.admin' permissions on the project using the reservation
         # and the project that owns this reservation.
@@ -626,7 +648,7 @@ module Google
         # does not match location of the reservation.
         # @param [String] parent
         #   Required. The parent resource name of the assignment
-        #   E.g.: projects/myproject/locations/US/reservations/team1-prod
+        #   E.g. `projects/myproject/locations/US/reservations/team1-prod`
         # @param [Google::Apis::BigqueryreservationV1beta1::Assignment] assignment_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -658,18 +680,20 @@ module Google
         end
         
         # Deletes a assignment. No expansion will happen.
-        # E.g:
-        # organizationA contains project1 and project2. Reservation res1 exists.
-        # CreateAssignment was invoked previously and following assignments were
-        # created explicitly:
-        # <organizationA, res1>
-        # <project1, res1>
-        # Then deletion of <organizationA, res1> won't affect <project1, res1>. After
-        # deletion of <organizationA, res1>, queries from project1 will still use
-        # res1, while queries from project2 will use on-demand mode.
+        # Example:
+        # * Organization `organizationA` contains two projects, `project1` and
+        # `project2`.
+        # * Reservation `res1` exists and was created previously.
+        # * CreateAssignment was used previously to define the following
+        # associations between entities and reservations: `<organizationA, res1>`
+        # and `<project1, res1>`
+        # In this example, deletion of the `<organizationA, res1>` assignment won't
+        # affect the other assignment `<project1, res1>`. After said deletion,
+        # queries from `project1` will still use `res1` while queries from
+        # `project2` will switch to use on-demand mode.
         # @param [String] name
-        #   Required. Name of the resource, e.g.:
-        #   projects/myproject/locations/US/reservations/team1-prod/assignments/123
+        #   Required. Name of the resource, e.g.
+        #   `projects/myproject/locations/US/reservations/team1-prod/assignments/123`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -698,22 +722,25 @@ module Google
         end
         
         # Lists assignments.
-        # Only explicitly created assignments will be returned. E.g:
-        # organizationA contains project1 and project2. Reservation res1 exists.
-        # CreateAssignment was invoked previously and following assignments were
-        # created explicitly:
-        # <organizationA, res1>
-        # <project1, res1>
-        # Then this API will just return the above two assignments for reservation
-        # res1, and no expansion/merge will happen. Wildcard "-" can be used for
+        # Only explicitly created assignments will be returned.
+        # Example:
+        # * Organization `organizationA` contains two projects, `project1` and
+        # `project2`.
+        # * Reservation `res1` exists and was created previously.
+        # * CreateAssignment was used previously to define the following
+        # associations between entities and reservations: `<organizationA, res1>`
+        # and `<project1, res1>`
+        # In this example, ListAssignments will just return the above two assignments
+        # for reservation `res1`, and no expansion/merge will happen.
+        # The wildcard "-" can be used for
         # reservations in the request. In that case all assignments belongs to the
-        # specified project and location will be listed. Note
-        # "-" cannot be used for projects nor locations.
+        # specified project and location will be listed.
+        # **Note** "-" cannot be used for projects nor locations.
         # @param [String] parent
         #   Required. The parent resource name e.g.:
-        #   projects/myproject/locations/US/reservations/team1-prod
+        #   `projects/myproject/locations/US/reservations/team1-prod`
         #   Or:
-        #   projects/myproject/locations/US/reservations/-
+        #   `projects/myproject/locations/US/reservations/-`
         # @param [Fixnum] page_size
         #   The maximum number of items to return.
         # @param [String] page_token
@@ -747,16 +774,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Moves a assignment under a new reservation. Customers can do this by
-        # deleting the existing assignment followed by creating another assignment
-        # under the new reservation, but this method provides a transactional way to
-        # do so, to make sure the assignee always has an associated reservation.
-        # Without the method customers might see some queries run on-demand which
-        # might be unexpected.
+        # Moves an assignment under a new reservation.
+        # This differs from removing an existing assignment and recreating a new one
+        # by providing a transactional change that ensures an assignee always has an
+        # associated reservation.
         # @param [String] name
         #   Required. The resource name of the assignment,
-        #   e.g.:
-        #   projects/myproject/locations/US/reservations/team1-prod/assignments/123
+        #   e.g.
+        #   `projects/myproject/locations/US/reservations/team1-prod/assignments/123`
         # @param [Google::Apis::BigqueryreservationV1beta1::MoveAssignmentRequest] move_assignment_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/bigqueryreservation_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/bigquery/
     module BigqueryreservationV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200410'
+      REVISION = '20200519'
 
       # View and manage your data in Google BigQuery
       AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery'

data/generated/google/apis/bigtableadmin_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/bigtable/
     module BigtableadminV1
       VERSION = 'V1'
-      REVISION = '20200211'
+      REVISION = '20200424'
     end
   end
 end

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

@@ -883,7 +883,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a Table or Backup resource.
+        # Gets the access control policy for a Table resource.
         # Returns an empty policy if the resource exists but does not have a policy
         # set.
         # @param [String] resource
@@ -919,7 +919,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the access control policy on a Table or Backup resource.
+        # Sets the access control policy on a Table resource.
         # Replaces any existing policy.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified.
@@ -1205,7 +1205,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a Table or Backup resource.
+        # Gets the access control policy for a Table resource.
         # Returns an empty policy if the resource exists but does not have a policy
         # set.
         # @param [String] resource
@@ -1326,7 +1326,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the access control policy on a Table or Backup resource.
+        # Sets the access control policy on a Table resource.
         # Replaces any existing policy.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified.

data/generated/google/apis/bigtableadmin_v2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/bigtable/
     module BigtableadminV2
       VERSION = 'V2'
-      REVISION = '20200211'
+      REVISION = '20200424'
 
       # Administer your Cloud Bigtable tables and clusters
       AUTH_BIGTABLE_ADMIN = 'https://www.googleapis.com/auth/bigtable.admin'

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

@@ -190,6 +190,15 @@ module Google
         # @return [String]
         attr_accessor :credit_types_treatment
       
+        # Optional. A single label and value pair specifying that usage from only this
+        # set of
+        # labeled resources should be included in the budget. Currently, multiple
+        # entries or multiple values per entry are not allowed. If omitted, the
+        # report will include all labeled and unlabeled usage.
+        # Corresponds to the JSON property `labels`
+        # @return [Hash<String,Array<Object>>]
+        attr_accessor :labels
+      
         # Optional. A set of projects of the form `projects/`project``,
         # specifying that usage from only this set of projects should be
         # included in the budget. If omitted, the report will include all usage for
@@ -209,6 +218,16 @@ module Google
         # @return [Array<String>]
         attr_accessor :services
       
+        # Optional. A set of subaccounts of the form `billingAccounts/`account_id``,
+        # specifying
+        # that usage from only this set of subaccounts should be included in the
+        # budget. If a subaccount is set to the name of the master account, usage
+        # from the master account will be included. If omitted, the report will
+        # include usage from the master account and all subaccounts, if they exist.
+        # Corresponds to the JSON property `subaccounts`
+        # @return [Array<String>]
+        attr_accessor :subaccounts
+      
         def initialize(**args)
            update!(**args)
         end
@@ -216,8 +235,10 @@ module Google
         # Update properties of this object
         def update!(**args)
           @credit_types_treatment = args[:credit_types_treatment] if args.key?(:credit_types_treatment)
+          @labels = args[:labels] if args.key?(:labels)
           @projects = args[:projects] if args.key?(:projects)
           @services = args[:services] if args.key?(:services)
+          @subaccounts = args[:subaccounts] if args.key?(:subaccounts)
         end
       end
       

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

@@ -135,8 +135,14 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :credit_types_treatment, as: 'creditTypesTreatment'
+          hash :labels, as: 'labels', :class => Array do
+        include Representable::JSON::Collection
+        items
+      end
+      
           collection :projects, as: 'projects'
           collection :services, as: 'services'
+          collection :subaccounts, as: 'subaccounts'
         end
       end
       

data/generated/google/apis/billingbudgets_v1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/billing/docs/how-to/budget-api-overview
     module BillingbudgetsV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200315'
+      REVISION = '20200522'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -540,7 +540,8 @@ module Google
         # @return [Array<Google::Apis::BinaryauthorizationV1::AdmissionWhitelistPattern>]
         attr_accessor :admission_whitelist_patterns
       
-        # Optional. Per-cluster admission rules. Cluster spec format:
+        # Optional. LINT.IfChange(cluster_regex)
+        # Per-cluster admission rules. Cluster spec format:
         # `location.clusterId`. There can be at most one admission rule per cluster
         # spec.
         # A `location` is either a compute zone (e.g. us-central1-a) or a region
@@ -548,6 +549,8 @@ module Google
         # For `clusterId` syntax restrictions see
         # https://cloud.google.com/container-engine/reference/rest/v1/projects.zones.
         # clusters.
+        # LINT.ThenChange(//depot/google3/cloud/console/web/binary_authorization/api/
+        # models/admission_rule_type.ts:cluster_regex)
         # Corresponds to the JSON property `clusterAdmissionRules`
         # @return [Hash<String,Google::Apis::BinaryauthorizationV1::AdmissionRule>]
         attr_accessor :cluster_admission_rules

data/generated/google/apis/binaryauthorization_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/binary-authorization/
     module BinaryauthorizationV1
       VERSION = 'V1'
-      REVISION = '20200501'
+      REVISION = '20200515'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'