google-cloud-service_management-v1 0.1.1 → 0.3.3

data/proto_docs/google/api/monitored_resource.rb

@@ -40,7 +40,6 @@ module Google
     #   @return [::String]
     #     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.
     # @!attribute [rw] display_name
     #   @return [::String]
     #     Optional. A concise name for the monitored resource type that might be
@@ -56,6 +55,9 @@ module Google
     #     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"`.
+    # @!attribute [rw] launch_stage
+    #   @return [::Google::Api::LaunchStage]
+    #     Optional. The launch stage of the monitored resource definition.
     class MonitoredResourceDescriptor
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -101,15 +103,14 @@ module Google
     # Auxiliary metadata for a {::Google::Api::MonitoredResource MonitoredResource} object.
     # {::Google::Api::MonitoredResource MonitoredResource} objects contain the minimum set of information to
     # uniquely identify a monitored resource instance. There is some other useful
-    # auxiliary metadata. Google Stackdriver Monitoring & Logging uses an ingestion
-    # pipeline to extract metadata for cloud resources of all types , and stores
+    # auxiliary metadata. Monitoring and Logging use an ingestion
+    # pipeline to extract metadata for cloud resources of all types, and store
     # the metadata in this message.
     # @!attribute [rw] system_labels
     #   @return [::Google::Protobuf::Struct]
     #     Output only. Values for predefined system metadata labels.
-    #     System labels are a kind of metadata extracted by Google Stackdriver.
-    #     Stackdriver determines what system labels are useful and how to obtain
-    #     their values. Some examples: "machine_image", "vpc", "subnet_id",
+    #     System labels are a kind of metadata extracted by Google, including
+    #     "machine_image", "vpc", "subnet_id",
     #     "security_group", "name", etc.
     #     System label values can be only strings, Boolean values, or a list of
     #     strings. For example:

data/proto_docs/google/api/monitoring.rb

@@ -25,49 +25,68 @@ 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
     # @!attribute [rw] producer_destinations
     #   @return [::Array<::Google::Api::Monitoring::MonitoringDestination>]
     #     Monitoring configurations for sending metrics to the producer project.
-    #     There can be multiple producer destinations, each one must have a
-    #     different monitored resource type. A metric can be used in at most
-    #     one producer destination.
+    #     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
+    #     in the Monitoring configuration.
     # @!attribute [rw] consumer_destinations
     #   @return [::Array<::Google::Api::Monitoring::MonitoringDestination>]
     #     Monitoring configurations for sending metrics to the consumer project.
-    #     There can be multiple consumer destinations, each one must have a
-    #     different monitored resource type. A metric can be used in at most
-    #     one consumer destination.
+    #     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
+    #     in the Monitoring configuration.
     class Monitoring
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -80,8 +99,8 @@ module Google
       #     {::Google::Api::Service#monitored_resources Service.monitored_resources} section.
       # @!attribute [rw] metrics
       #   @return [::Array<::String>]
-      #     Names of the metrics to report to this monitoring destination.
-      #     Each name must be defined in {::Google::Api::Service#metrics Service.metrics} section.
+      #     Types of the metrics to report to this monitoring destination.
+      #     Each type must be defined in {::Google::Api::Service#metrics Service.metrics} section.
       class MonitoringDestination
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/api/quota.rb

@@ -22,7 +22,7 @@ module Google
     # Quota configuration helps to achieve fairness and budgeting in service
     # usage.
     #
-    # The quota configuration works this way:
+    # The metric based quota configuration works this way:
     # - The service configuration defines a set of metrics.
     # - For API calls, the quota.metric_rules maps methods to metrics with
     #   corresponding costs.
@@ -40,6 +40,7 @@ module Google
     #        values:
     #          STANDARD: 10000
     #
+    #
     #      # The metric rules bind all methods to the read_calls metric,
     #      # except for the UpdateBook and DeleteBook methods. These two methods
     #      # are mapped to the write_calls metric, with the UpdateBook method
@@ -70,24 +71,17 @@ module Google
     # @!attribute [rw] limits
     #   @return [::Array<::Google::Api::QuotaLimit>]
     #     List of `QuotaLimit` definitions for the service.
-    #
-    #     Used by metric-based quotas only.
     # @!attribute [rw] metric_rules
     #   @return [::Array<::Google::Api::MetricRule>]
     #     List of `MetricRule` definitions, each one mapping a selected method to one
     #     or more metrics.
-    #
-    #     Used by metric-based quotas only.
     class Quota
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
     # Bind API methods to metrics. Binding a method to a metric causes that
-    # metric's configured quota, billing, and monitoring behaviors to apply to the
-    # method call.
-    #
-    # Used by metric-based quotas only.
+    # metric's configured quota behaviors to apply to the method call.
     # @!attribute [rw] selector
     #   @return [::String]
     #     Selects the methods to which this rule applies.
@@ -120,24 +114,12 @@ module Google
     # type combination defined within a `QuotaGroup`.
     # @!attribute [rw] name
     #   @return [::String]
-    #     Name of the quota limit. The name is used to refer to the limit when
-    #     overriding the default limit on per-consumer basis.
+    #     Name of the quota limit.
     #
-    #     For group-based quota limits, the name must be unique within the quota
-    #     group. If a name is not provided, it will be generated from the limit_by
-    #     and duration fields.
-    #
-    #     For metric-based quota limits, the name must be provided, and it must be
-    #     unique within the service. The name can only include alphanumeric
-    #     characters as well as '-'.
+    #     The name must be provided, and it must be unique within the service. The
+    #     name can only include alphanumeric characters as well as '-'.
     #
     #     The maximum length of the limit name is 64 characters.
-    #
-    #     The name of a limit is used as a unique identifier for this limit.
-    #     Therefore, once a limit has been put into use, its name should be
-    #     immutable. You can use the display_name field to provide a user-friendly
-    #     name for the limit. The display name can be evolved over time without
-    #     affecting the identity of the limit.
     # @!attribute [rw] description
     #   @return [::String]
     #     Optional. User-visible, extended description for this quota limit.
@@ -178,10 +160,7 @@ module Google
     #     Used by group-based quotas only.
     # @!attribute [rw] duration
     #   @return [::String]
-    #     Duration of this limit in textual notation. Example: "100s", "24h", "1d".
-    #     For duration longer than a day, only multiple of days is supported. We
-    #     support only "100s" and "1d" for now. Additional support will be added in
-    #     the future. "0" indicates indefinite duration.
+    #     Duration of this limit in textual notation. Must be "100s" or "1d".
     #
     #     Used by group-based quotas only.
     # @!attribute [rw] metric
@@ -189,75 +168,22 @@ module Google
     #     The name of the metric this quota limit applies to. The quota limits with
     #     the same metric will be checked together during runtime. The metric must be
     #     defined within the service config.
-    #
-    #     Used by metric-based quotas only.
     # @!attribute [rw] unit
     #   @return [::String]
     #     Specify the unit of the quota limit. It uses the same syntax as
     #     [Metric.unit][]. The supported unit kinds are determined by the quota
     #     backend system.
     #
-    #     The [Google Service Control](https://cloud.google.com/service-control)
-    #     supports the following unit components:
-    #     * One of the time intevals:
-    #       * "/min"  for quota every minute.
-    #       * "/d"  for quota every 24 hours, starting 00:00 US Pacific Time.
-    #       * Otherwise the quota won't be reset by time, such as storage limit.
-    #     * One and only one of the granted containers:
-    #       * "/\\{organization}" quota for an organization.
-    #       * "/\\{project}" quota for a project.
-    #       * "/\\{folder}" quota for a folder.
-    #       * "/\\{resource}" quota for a universal resource.
-    #     * Zero or more quota segmentation dimension. Not all combos are valid.
-    #       * "/\\{region}" quota for every region. Not to be used with time intervals.
-    #       * Otherwise the resources granted on the target is not segmented.
-    #       * "/\\{zone}" quota for every zone. Not to be used with time intervals.
-    #       * Otherwise the resources granted on the target is not segmented.
-    #       * "/\\{resource}" quota for a resource associated with a project or org.
-    #
     #     Here are some examples:
     #     * "1/min/\\{project}" for quota per minute per project.
-    #     * "1/min/\\{user}" for quota per minute per user.
-    #     * "1/min/\\{organization}" for quota per minute per organization.
     #
     #     Note: the order of unit components is insignificant.
     #     The "1" at the beginning is required to follow the metric unit syntax.
-    #
-    #     Used by metric-based quotas only.
     # @!attribute [rw] values
     #   @return [::Google::Protobuf::Map{::String => ::Integer}]
-    #     Tiered limit values. Also allows for regional or zone overrides for these
-    #     values if "/\\{region}" or "/\\{zone}" is specified in the unit field.
-    #
-    #     Currently supported tiers from low to high:
-    #     VERY_LOW, LOW, STANDARD, HIGH, VERY_HIGH
-    #
-    #     To apply different limit values for users according to their tiers, specify
-    #     the values for the tiers you want to differentiate. For example:
-    #     \\{LOW:100, STANDARD:500, HIGH:1000, VERY_HIGH:5000}
-    #
-    #     The limit value for each tier is optional except for the tier STANDARD.
-    #     The limit value for an unspecified tier falls to the value of its next
-    #     tier towards tier STANDARD. For the above example, the limit value for tier
-    #     STANDARD is 500.
-    #
-    #     To apply the same limit value for all users, just specify limit value for
-    #     tier STANDARD. For example: \\{STANDARD:500}.
-    #
-    #     To apply a regional overide for a tier, add a map entry with key
-    #     "<TIER>/<region>", where <region> is a region name. Similarly, for a zone
-    #     override, add a map entry with key "<TIER>/\\{zone}".
-    #     Further, a wildcard can be used at the end of a zone name in order to
-    #     specify zone level overrides. For example:
-    #     LOW: 10, STANDARD: 50, HIGH: 100,
-    #     LOW/us-central1: 20, STANDARD/us-central1: 60, HIGH/us-central1: 200,
-    #     LOW/us-central1-*: 10, STANDARD/us-central1-*: 20, HIGH/us-central1-*: 80
-    #
-    #     The regional overrides tier set for each region must be the same as
-    #     the tier set for default limit values. Same rule applies for zone overrides
-    #     tier as well.
-    #
-    #     Used by metric-based quotas only.
+    #     Tiered limit values. You must specify this as a key:value pair, with an
+    #     integer value that is the maximum number of requests allowed for the
+    #     specified unit. Currently only STANDARD is supported.
     # @!attribute [rw] display_name
     #   @return [::String]
     #     User-visible display name for this limit.

data/proto_docs/google/api/service.rb

@@ -28,7 +28,6 @@ module Google
     # Example:
     #
     #     type: google.api.Service
-    #     config_version: 3
     #     name: calendar.googleapis.com
     #     title: Google Calendar API
     #     apis:
@@ -42,27 +41,24 @@ module Google
     #       - selector: "*"
     #         requirements:
     #           provider_id: google_calendar_auth
-    # @!attribute [rw] config_version
-    #   @return [::Google::Protobuf::UInt32Value]
-    #     The semantic version of the service configuration. The config version
-    #     affects the interpretation of the service configuration. For example,
-    #     certain features are enabled by default for certain config versions.
-    #     The latest config version is `3`.
     # @!attribute [rw] name
     #   @return [::String]
-    #     The DNS address at which this service is available,
-    #     e.g. `calendar.googleapis.com`.
-    # @!attribute [rw] id
-    #   @return [::String]
-    #     A unique ID for a specific instance of this message, typically assigned
-    #     by the client for tracking purpose. If empty, the server may choose to
-    #     generate one instead.
+    #     The service name, which is a DNS-like logical identifier for the
+    #     service, such as `calendar.googleapis.com`. The service name
+    #     typically goes through DNS verification to make sure the owner
+    #     of the service also owns the DNS name.
     # @!attribute [rw] title
     #   @return [::String]
     #     The product title for this service.
     # @!attribute [rw] producer_project_id
     #   @return [::String]
     #     The Google project that owns this service.
+    # @!attribute [rw] id
+    #   @return [::String]
+    #     A unique ID for a specific instance of this message, typically assigned
+    #     by the client for tracking purpose. Must be no longer than 63 characters
+    #     and only lower case letters, digits, '.', '_' and '-' are allowed. If
+    #     empty, the server may choose to generate one instead.
     # @!attribute [rw] apis
     #   @return [::Array<::Google::Protobuf::Api>]
     #     A list of API interfaces exported by this service. Only the `name` field
@@ -143,6 +139,12 @@ module Google
     # @!attribute [rw] source_info
     #   @return [::Google::Api::SourceInfo]
     #     Output only. The source information for this configuration if available.
+    # @!attribute [rw] config_version
+    #   @return [::Google::Protobuf::UInt32Value]
+    #     Obsolete. Do not use.
+    #
+    #     This field has no semantic meaning. The service config compiler always
+    #     sets this field to `3`.
     class Service
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/api/servicemanagement/v1/resources.rb

@@ -25,7 +25,7 @@ module Google
         # Google Service Management.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     The name of the service. See the [overview](/service-management/overview)
+        #     The name of the service. See the [overview](https://cloud.google.com/service-management/overview)
         #     for naming requirements.
         # @!attribute [rw] producer_project_id
         #   @return [::String]

data/proto_docs/google/api/servicemanagement/v1/servicemanager.rb

@@ -79,7 +79,7 @@ module Google
         # Request message for DeleteService method.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](/service-management/overview)
+        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
         #     for naming requirements.  For example: `example.googleapis.com`.
         class DeleteServiceRequest
           include ::Google::Protobuf::MessageExts
@@ -89,7 +89,7 @@ module Google
         # Request message for UndeleteService method.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service. See the [overview](/service-management/overview)
+        #     Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview)
         #     for naming requirements. For example: `example.googleapis.com`.
         class UndeleteServiceRequest
           include ::Google::Protobuf::MessageExts
@@ -108,7 +108,7 @@ module Google
         # Request message for GetServiceConfig method.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](/service-management/overview)
+        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
         #     for naming requirements.  For example: `example.googleapis.com`.
         # @!attribute [rw] config_id
         #   @return [::String]
@@ -139,7 +139,7 @@ module Google
         # Request message for ListServiceConfigs method.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](/service-management/overview)
+        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
         #     for naming requirements.  For example: `example.googleapis.com`.
         # @!attribute [rw] page_token
         #   @return [::String]
@@ -168,7 +168,7 @@ module Google
         # Request message for CreateServiceConfig method.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](/service-management/overview)
+        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
         #     for naming requirements.  For example: `example.googleapis.com`.
         # @!attribute [rw] service_config
         #   @return [::Google::Api::Service]
@@ -181,7 +181,7 @@ module Google
         # Request message for SubmitConfigSource method.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](/service-management/overview)
+        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
         #     for naming requirements.  For example: `example.googleapis.com`.
         # @!attribute [rw] config_source
         #   @return [::Google::Cloud::ServiceManagement::V1::ConfigSource]
@@ -208,7 +208,7 @@ module Google
         # Request message for 'CreateServiceRollout'
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](/service-management/overview)
+        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
         #     for naming requirements.  For example: `example.googleapis.com`.
         # @!attribute [rw] rollout
         #   @return [::Google::Cloud::ServiceManagement::V1::Rollout]
@@ -221,7 +221,7 @@ module Google
         # Request message for 'ListServiceRollouts'
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](/service-management/overview)
+        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
         #     for naming requirements.  For example: `example.googleapis.com`.
         # @!attribute [rw] page_token
         #   @return [::String]
@@ -235,10 +235,10 @@ module Google
         #     Required. Use `filter` to return subset of rollouts.
         #     The following filters are supported:
         #       -- To limit the results to only those in
-        #          [status](google.api.servicemanagement.v1.RolloutStatus) 'SUCCESS',
+        #          status (google.api.servicemanagement.v1.RolloutStatus) 'SUCCESS',
         #          use filter='status=SUCCESS'
         #       -- To limit the results to those in
-        #          [status](google.api.servicemanagement.v1.RolloutStatus) 'CANCELLED'
+        #          status (google.api.servicemanagement.v1.RolloutStatus) 'CANCELLED'
         #          or 'FAILED', use filter='status=CANCELLED OR status=FAILED'
         class ListServiceRolloutsRequest
           include ::Google::Protobuf::MessageExts
@@ -260,7 +260,7 @@ module Google
         # Request message for GetServiceRollout method.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](/service-management/overview)
+        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
         #     for naming requirements.  For example: `example.googleapis.com`.
         # @!attribute [rw] rollout_id
         #   @return [::String]