google-api-client 0.39.5 → 0.41.1

data/generated/google/apis/serviceusage_v1beta1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/service-usage/
     module ServiceusageV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200516'
+      REVISION = '20200617'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -22,6 +22,76 @@ module Google
   module Apis
     module ServiceusageV1beta1
       
+      # Quota policy created by quota administrator.
+      class AdminQuotaPolicy
+        include Google::Apis::Core::Hashable
+      
+        # The cloud resource container at which the quota policy is created. The
+        # format is `container_type`/`container_number`
+        # Corresponds to the JSON property `container`
+        # @return [String]
+        attr_accessor :container
+      
+        # If this map is nonempty, then this policy applies only to specific values
+        # for dimensions defined in the limit unit.
+        # For example, an policy on a limit with the unit 1/`project`/`region`
+        # could contain an entry with the key "region" and the value "us-east-1";
+        # the policy is only applied to quota consumed in that region.
+        # This map has the following restrictions:
+        # *   If "region" appears as a key, its value must be a valid Cloud region.
+        # *   If "zone" appears as a key, its value must be a valid Cloud zone.
+        # *   Keys other than "region" or "zone" are not valid.
+        # Corresponds to the JSON property `dimensions`
+        # @return [Hash<String,String>]
+        attr_accessor :dimensions
+      
+        # The name of the metric to which this policy applies.
+        # An example name would be:
+        # `compute.googleapis.com/cpus`
+        # Corresponds to the JSON property `metric`
+        # @return [String]
+        attr_accessor :metric
+      
+        # The resource name of the policy.
+        # This name is generated by the server when the policy is created.
+        # Example names would be:
+        # `organizations/123/services/compute.googleapis.com/consumerQuotaMetrics/
+        # compute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/adminQuotaPolicies/
+        # 4a3f2c1d`
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The quota policy value.
+        # Can be any nonnegative integer, or -1 (unlimited quota).
+        # Corresponds to the JSON property `policyValue`
+        # @return [Fixnum]
+        attr_accessor :policy_value
+      
+        # The limit unit of the limit to which this policy applies.
+        # An example unit would be:
+        # `1/`project`/`region``
+        # Note that ``project`` and ``region`` are not placeholders in this example;
+        # the literal characters ``` and ``` occur in the string.
+        # Corresponds to the JSON property `unit`
+        # @return [String]
+        attr_accessor :unit
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @container = args[:container] if args.key?(:container)
+          @dimensions = args[:dimensions] if args.key?(:dimensions)
+          @metric = args[:metric] if args.key?(:metric)
+          @name = args[:name] if args.key?(:name)
+          @policy_value = args[:policy_value] if args.key?(:policy_value)
+          @unit = args[:unit] if args.key?(:unit)
+        end
+      end
+      
       # Api is a light-weight descriptor for an API Interface.
       # Interfaces are also described as "protocol buffer services" in some contexts,
       # such as by the "service" keyword in a .proto file, but they are different
@@ -734,6 +804,11 @@ module Google
         # @return [String]
         attr_accessor :name
       
+        # The units in which the metric value is reported.
+        # Corresponds to the JSON property `unit`
+        # @return [String]
+        attr_accessor :unit
+      
         def initialize(**args)
            update!(**args)
         end
@@ -744,6 +819,7 @@ module Google
           @display_name = args[:display_name] if args.key?(:display_name)
           @metric = args[:metric] if args.key?(:metric)
           @name = args[:name] if args.key?(:name)
+          @unit = args[:unit] if args.key?(:unit)
         end
       end
       
@@ -1249,11 +1325,6 @@ module Google
         attr_accessor :allow_cors
         alias_method :allow_cors?, :allow_cors
       
-        # The list of features enabled on this endpoint.
-        # Corresponds to the JSON property `features`
-        # @return [Array<String>]
-        attr_accessor :features
-      
         # The canonical name of this endpoint.
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -1276,7 +1347,6 @@ module Google
         def update!(**args)
           @aliases = args[:aliases] if args.key?(:aliases)
           @allow_cors = args[:allow_cors] if args.key?(:allow_cors)
-          @features = args[:features] if args.key?(:features)
           @name = args[:name] if args.key?(:name)
           @target = args[:target] if args.key?(:target)
         end
@@ -1743,36 +1813,51 @@ module Google
         # for monitoring. In the example, a monitored resource and two metrics are
         # defined. The `library.googleapis.com/book/returned_count` metric is sent
         # to both producer and consumer projects, whereas the
-        # `library.googleapis.com/book/overdue_count` metric is only sent to the
+        # `library.googleapis.com/book/num_overdue` metric is only sent to the
         # consumer project.
         # monitored_resources:
-        # - type: library.googleapis.com/branch
+        # - type: library.googleapis.com/Branch
+        # display_name: "Library Branch"
+        # description: "A branch of a library."
+        # launch_stage: GA
         # labels:
-        # - key: /city
-        # description: The city where the library branch is located in.
-        # - key: /name
-        # description: The name of the branch.
+        # - key: resource_container
+        # description: "The Cloud container (ie. project id) for the Branch."
+        # - key: location
+        # description: "The location of the library branch."
+        # - key: branch_id
+        # description: "The id of the branch."
         # metrics:
         # - name: library.googleapis.com/book/returned_count
+        # display_name: "Books Returned"
+        # description: "The count of books that have been returned."
+        # launch_stage: GA
         # metric_kind: DELTA
         # value_type: INT64
+        # unit: "1"
         # labels:
-        # - key: /customer_id
-        # - name: library.googleapis.com/book/overdue_count
+        # - key: customer_id
+        # description: "The id of the customer."
+        # - name: library.googleapis.com/book/num_overdue
+        # display_name: "Books Overdue"
+        # description: "The current number of overdue books."
+        # launch_stage: GA
         # metric_kind: GAUGE
         # value_type: INT64
+        # unit: "1"
         # labels:
-        # - key: /customer_id
+        # - key: customer_id
+        # description: "The id of the customer."
         # monitoring:
         # producer_destinations:
-        # - monitored_resource: library.googleapis.com/branch
+        # - monitored_resource: library.googleapis.com/Branch
         # metrics:
         # - library.googleapis.com/book/returned_count
         # consumer_destinations:
-        # - monitored_resource: library.googleapis.com/branch
+        # - monitored_resource: library.googleapis.com/Branch
         # metrics:
         # - library.googleapis.com/book/returned_count
-        # - library.googleapis.com/book/overdue_count
+        # - library.googleapis.com/book/num_overdue
         # Corresponds to the JSON property `monitoring`
         # @return [Google::Apis::ServiceusageV1beta1::Monitoring]
         attr_accessor :monitoring
@@ -2603,6 +2688,55 @@ module Google
         end
       end
       
+      # Response message for ImportAdminQuotaPolicies
+      class ImportAdminQuotaPoliciesResponse
+        include Google::Apis::Core::Hashable
+      
+        # The policies that were created from the imported data.
+        # Corresponds to the JSON property `policies`
+        # @return [Array<Google::Apis::ServiceusageV1beta1::AdminQuotaPolicy>]
+        attr_accessor :policies
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @policies = args[:policies] if args.key?(:policies)
+        end
+      end
+      
+      # Request message for ImportConsumerOverrides
+      class ImportConsumerOverridesRequest
+        include Google::Apis::Core::Hashable
+      
+        # Whether to force the creation of the quota overrides.
+        # If creating an override would cause the effective quota for the consumer to
+        # decrease by more than 10 percent, the call is rejected, as a safety measure
+        # to avoid accidentally decreasing quota too quickly. Setting the force
+        # parameter to true ignores this restriction.
+        # Corresponds to the JSON property `force`
+        # @return [Boolean]
+        attr_accessor :force
+        alias_method :force?, :force
+      
+        # Import data embedded in the request message
+        # Corresponds to the JSON property `inlineSource`
+        # @return [Google::Apis::ServiceusageV1beta1::OverrideInlineSource]
+        attr_accessor :inline_source
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @force = args[:force] if args.key?(:force)
+          @inline_source = args[:inline_source] if args.key?(:inline_source)
+        end
+      end
+      
       # Response message for ImportConsumerOverrides
       class ImportConsumerOverridesResponse
         include Google::Apis::Core::Hashable
@@ -3016,6 +3150,15 @@ module Google
       # Defines a metric type and its schema. Once a metric descriptor is created,
       # deleting or altering it stops data collection and makes the metric type's
       # existing data unusable.
+      # The following are specific rules for service defined Monitoring metric
+      # descriptors:
+      # * `type`, `metric_kind`, `value_type`, `description`, `display_name`,
+      # `launch_stage` fields are all required. The `unit` field must be specified
+      # if the `value_type` is any of DOUBLE, INT64, DISTRIBUTION.
+      # * Maximum of default 500 metric descriptors per service is allowed.
+      # * Maximum of default 10 labels per metric descriptor is allowed.
+      # The default maximum limit can be overridden. Please follow
+      # https://cloud.google.com/monitoring/quotas
       class MetricDescriptor
         include Google::Apis::Core::Hashable
       
@@ -3033,7 +3176,13 @@ module Google
         attr_accessor :display_name
       
         # The set of labels that can be used to describe a specific
-        # instance of this metric type. For example, the
+        # instance of this metric type.
+        # The label key name must follow:
+        # * Only upper and lower-case letters, digits and underscores (_) are
+        # allowed.
+        # * Label name must start with a letter or digit.
+        # * The maximum length of a label name is 100 characters.
+        # For example, the
         # `appengine.googleapis.com/http/server/response_latencies` metric
         # type has a label for the HTTP response code, `response_code`, so
         # you can look at latencies for successful responses or just
@@ -3073,9 +3222,19 @@ module Google
         attr_accessor :name
       
         # The metric type, including its DNS name prefix. The type is not
-        # URL-encoded.  All user-defined metric types have the DNS name
-        # `custom.googleapis.com` or `external.googleapis.com`.  Metric types should
-        # use a natural hierarchical grouping. For example:
+        # URL-encoded.
+        # All service defined metrics must be prefixed with the service name, in the
+        # format of ``service name`/`relative metric name``, such as
+        # `cloudsql.googleapis.com/database/cpu/utilization`. The relative metric
+        # name must follow:
+        # * Only upper and lower-case letters, digits, '/' and underscores '_' are
+        # allowed.
+        # * The maximum number of characters allowed for the relative_metric_name is
+        # 100.
+        # All user-defined metric types have the DNS name
+        # `custom.googleapis.com`, `external.googleapis.com`, or
+        # `logging.googleapis.com/user/`.
+        # Metric types should use a natural hierarchical grouping. For example:
         # "custom.googleapis.com/invoice/paid/amount"
         # "external.googleapis.com/prometheus/up"
         # "appengine.googleapis.com/http/server/response_latencies"
@@ -3108,6 +3267,7 @@ module Google
         # * `min`   minute
         # * `h`     hour
         # * `d`     day
+        # * `1`     dimensionless
         # **Prefixes (PREFIX)**
         # * `k`     kilo    (10^3)
         # * `M`     mega    (10^6)
@@ -3354,9 +3514,20 @@ module Google
       # descriptor for Google Compute Engine VM instances has a type of
       # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
       # `"zone"` to identify particular VM instances.
-      # Different APIs can support different monitored resource types. APIs generally
-      # provide a `list` method that returns the monitored resource descriptors used
-      # by the API.
+      # Different services can support different monitored resource types.
+      # The following are specific rules to service defined monitored resources for
+      # Monitoring and Logging:
+      # * The `type`, `display_name`, `description`, `labels` and `launch_stage`
+      # fields are all required.
+      # * The first label of the monitored resource descriptor must be
+      # `resource_container`. There are legacy monitored resource descritptors
+      # start with `project_id`.
+      # * It must include a `location` label.
+      # * Maximum of default 5 service defined monitored resource descriptors
+      # is allowed per service.
+      # * Maximum of default 10 labels per monitored resource is allowed.
+      # The default maximum limit can be overridden. Please follow
+      # https://cloud.google.com/monitoring/quotas
       class MonitoredResourceDescriptor
         include Google::Apis::Core::Hashable
       
@@ -3375,8 +3546,14 @@ module Google
         attr_accessor :display_name
       
         # Required. A set of labels used to describe instances of this monitored
-        # resource type. For example, an individual Google Cloud SQL database is
-        # identified by values for the labels `"database_id"` and `"zone"`.
+        # resource type.
+        # The label key name must follow:
+        # * Only upper and lower-case letters, digits and underscores (_) are
+        # allowed.
+        # * Label name must start with a letter or digit.
+        # * The maximum length of a label name is 100 characters.
+        # For example, an individual Google Cloud SQL database is
+        # identified by values for the labels `database_id` and `location`.
         # Corresponds to the JSON property `labels`
         # @return [Array<Google::Apis::ServiceusageV1beta1::LabelDescriptor>]
         attr_accessor :labels
@@ -3397,8 +3574,16 @@ module Google
         attr_accessor :name
       
         # Required. The monitored resource type. For example, the type
-        # `"cloudsql_database"` represents databases in Google Cloud SQL.
-        # The maximum length of this value is 256 characters.
+        # `cloudsql_database` represents databases in Google Cloud SQL.
+        # All service defined monitored resource types must be prefixed with the
+        # service name, in the format of ``service name`/`relative resource name``.
+        # The relative resource name must follow:
+        # * Only upper and lower-case letters and digits are allowed.
+        # * It must start with upper case character and is recommended to use Upper
+        # Camel Case style.
+        # * The maximum number of characters allowed for the relative_resource_name
+        # is 100.
+        # Note there are legacy service monitored resources not following this rule.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -3423,41 +3608,56 @@ module Google
       # for monitoring. In the example, a monitored resource and two metrics are
       # defined. The `library.googleapis.com/book/returned_count` metric is sent
       # to both producer and consumer projects, whereas the
-      # `library.googleapis.com/book/overdue_count` metric is only sent to the
+      # `library.googleapis.com/book/num_overdue` metric is only sent to the
       # consumer project.
       # monitored_resources:
-      # - type: library.googleapis.com/branch
+      # - type: library.googleapis.com/Branch
+      # display_name: "Library Branch"
+      # description: "A branch of a library."
+      # launch_stage: GA
       # labels:
-      # - key: /city
-      # description: The city where the library branch is located in.
-      # - key: /name
-      # description: The name of the branch.
+      # - key: resource_container
+      # description: "The Cloud container (ie. project id) for the Branch."
+      # - key: location
+      # description: "The location of the library branch."
+      # - key: branch_id
+      # description: "The id of the branch."
       # metrics:
       # - name: library.googleapis.com/book/returned_count
+      # display_name: "Books Returned"
+      # description: "The count of books that have been returned."
+      # launch_stage: GA
       # metric_kind: DELTA
       # value_type: INT64
+      # unit: "1"
       # labels:
-      # - key: /customer_id
-      # - name: library.googleapis.com/book/overdue_count
+      # - key: customer_id
+      # description: "The id of the customer."
+      # - name: library.googleapis.com/book/num_overdue
+      # display_name: "Books Overdue"
+      # description: "The current number of overdue books."
+      # launch_stage: GA
       # metric_kind: GAUGE
       # value_type: INT64
+      # unit: "1"
       # labels:
-      # - key: /customer_id
+      # - key: customer_id
+      # description: "The id of the customer."
       # monitoring:
       # producer_destinations:
-      # - monitored_resource: library.googleapis.com/branch
+      # - monitored_resource: library.googleapis.com/Branch
       # metrics:
       # - library.googleapis.com/book/returned_count
       # consumer_destinations:
-      # - monitored_resource: library.googleapis.com/branch
+      # - monitored_resource: library.googleapis.com/Branch
       # metrics:
       # - library.googleapis.com/book/returned_count
-      # - library.googleapis.com/book/overdue_count
+      # - library.googleapis.com/book/num_overdue
       class Monitoring
         include Google::Apis::Core::Hashable
       
         # Monitoring configurations for sending metrics to the consumer project.
-        # There can be multiple consumer destinations. A monitored resouce type may
+        # There can be multiple consumer destinations. A monitored resource type may
         # appear in multiple monitoring destinations if different aggregations are
         # needed for different sets of metrics associated with that monitored
         # resource type. A monitored resource and metric pair may only be used once
@@ -3467,7 +3667,7 @@ module Google
         attr_accessor :consumer_destinations
       
         # Monitoring configurations for sending metrics to the producer project.
-        # There can be multiple producer destinations. A monitored resouce type may
+        # There can be multiple producer destinations. A monitored resource type may
         # appear in multiple monitoring destinations if different aggregations are
         # needed for different sets of metrics associated with that monitored
         # resource type. A monitored resource and metric pair may only be used once
@@ -3667,6 +3867,27 @@ module Google
         end
       end
       
+      # Import data embedded in the request message
+      class OverrideInlineSource
+        include Google::Apis::Core::Hashable
+      
+        # The overrides to create.
+        # Each override must have a value for 'metric' and 'unit', to specify
+        # which metric and which limit the override should be applied to.
+        # Corresponds to the JSON property `overrides`
+        # @return [Array<Google::Apis::ServiceusageV1beta1::QuotaOverride>]
+        attr_accessor :overrides
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @overrides = args[:overrides] if args.key?(:overrides)
+        end
+      end
+      
       # Represents a documentation page. A page can contain subpages to represent
       # nested documentation set structure.
       class Page
@@ -3954,6 +4175,13 @@ module Google
       class QuotaOverride
         include Google::Apis::Core::Hashable
       
+        # The resource name of the ancestor that requested the override. For example:
+        # "organizations/12345" or "folders/67890".
+        # Used by admin overrides only.
+        # Corresponds to the JSON property `adminOverrideAncestor`
+        # @return [String]
+        attr_accessor :admin_override_ancestor
+      
         # If this map is nonempty, then this override applies only to specific values
         # for dimensions defined in the limit unit.
         # For example, an override on a limit with the unit 1/`project`/`region`
@@ -4017,6 +4245,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @admin_override_ancestor = args[:admin_override_ancestor] if args.key?(:admin_override_ancestor)
           @dimensions = args[:dimensions] if args.key?(:dimensions)
           @metric = args[:metric] if args.key?(:metric)
           @name = args[:name] if args.key?(:name)