google-cloud-monitoring-v3 0.4.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 82d58ea887dc8fd5c201c2609b6506d9c8ff121563487f6d61bc71ffe9261d92
-  data.tar.gz: 21cc2aed83e4cf23ce294977a7cd07628039fe21327f7a12b69135c74574b921
+  metadata.gz: 5e2adcdd895a09b496d0690535f9e8b610ebf955a5826ece302aab758ac9e4e4
+  data.tar.gz: 02dd20945c0b716859a9cb5be7c8898a368e469afe92d78e45246933fe36929d
 SHA512:
-  metadata.gz: 141173d2a28529db926cab02554643b1c4981849f9e4c9bddc7e714e5538976705fd0b5b2bbc60300e924c85307b18d789e8fc72974eefbd1e89ed3b232b6b75
-  data.tar.gz: 7ffdf57253c7676d844a07cb16889c73eceb0e118159243822033ff192aeed8fd9b9741a4481742c4ee3585f081ca86f0d3402d113c090c7e0013372636b0420
+  metadata.gz: c09357f07ce077d4c8249eac7277e4cb7ab801a170108502b00fcfc906e99b2c8e2df25469c270157fb663e367569fc5f8340ee9da5f2b825a7136ece5c7a983
+  data.tar.gz: 340f1e694260e5ed7996812d68afb121536a5e9ae1fa97788a6fd61fc20a4aadac7a484a7be1a0f9b79be769c700e7fbec1dff4804fbcae6787453a588666ae7

data/AUTHENTICATION.md

@@ -66,11 +66,11 @@ The environment variables that google-cloud-monitoring-v3
 checks for credentials are configured on the service Credentials class (such as
 {::Google::Cloud::Monitoring::V3::AlertPolicyService::Credentials}):
 
-1. `MONITORING_CREDENTIALS` - Path to JSON file, or JSON contents
-2. `MONITORING_KEYFILE` - Path to JSON file, or JSON contents
-3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
-4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
-5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
+* `MONITORING_CREDENTIALS` - Path to JSON file, or JSON contents
+* `MONITORING_KEYFILE` - Path to JSON file, or JSON contents
+* `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
+* `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
+* `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
 
 ```ruby
 require "google/cloud/monitoring/v3"
@@ -82,8 +82,8 @@ client = ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.new
 
 ### Configuration
 
-The **Credentials JSON** can be configured instead of placing them in
-environment variables. Either on an individual client initialization:
+The path to the **Credentials JSON** file can be configured instead of storing
+it in an environment variable. Either on an individual client initialization:
 
 ```ruby
 require "google/cloud/monitoring/v3"
@@ -93,7 +93,7 @@ client = ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.new do |con
 end
 ```
 
-Or configured globally for all clients:
+Or globally for all clients:
 
 ```ruby
 require "google/cloud/monitoring/v3"

data/README.md

@@ -33,7 +33,7 @@ In order to use this library, you first need to go through the following steps:
 require "google/cloud/monitoring/v3"
 
 client = ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.new
-request = my_create_request
+request = ::Google::Cloud::Monitoring::V3::ListAlertPoliciesRequest.new # (request fields as keyword arguments...)
 response = client.list_alert_policies request
 ```
 

data/lib/google/cloud/monitoring/v3/alert_policy_service/client.rb

@@ -49,13 +49,12 @@ module Google
             # See {::Google::Cloud::Monitoring::V3::AlertPolicyService::Client::Configuration}
             # for a description of the configuration fields.
             #
-            # ## Example
+            # @example
             #
-            # To modify the configuration for all AlertPolicyService clients:
-            #
-            #     ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Modify the configuration for all AlertPolicyService clients
+            #   ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Client client.
             # @yieldparam config [Client::Configuration]
@@ -75,28 +74,19 @@ module Google
 
                 default_config.rpcs.list_alert_policies.timeout = 30.0
                 default_config.rpcs.list_alert_policies.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 30.0,
-              multiplier: 1.3,
-              retry_codes: [4, 14]
+                  initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config.rpcs.get_alert_policy.timeout = 30.0
                 default_config.rpcs.get_alert_policy.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 30.0,
-              multiplier: 1.3,
-              retry_codes: [4, 14]
+                  initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config.rpcs.create_alert_policy.timeout = 30.0
 
                 default_config.rpcs.delete_alert_policy.timeout = 30.0
                 default_config.rpcs.delete_alert_policy.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 30.0,
-              multiplier: 1.3,
-              retry_codes: [4, 14]
+                  initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config.rpcs.update_alert_policy.timeout = 30.0
@@ -130,19 +120,15 @@ module Google
             ##
             # Create a new AlertPolicyService client object.
             #
-            # ## Examples
-            #
-            # To create a new AlertPolicyService client with the default
-            # configuration:
-            #
-            #     client = ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.new
+            # @example
             #
-            # To create a new AlertPolicyService client with a custom
-            # configuration:
+            #   # Create a client using the default configuration
+            #   client = ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.new
             #
-            #     client = ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.new do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Create a client using a custom configuration
+            #   client = ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.new do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the AlertPolicyService client.
             # @yieldparam config [Client::Configuration]
@@ -162,14 +148,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # Use self-signed JWT if the endpoint is unchanged from default,
               # but only if the default endpoint does not have a region prefix.
-              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
-                                       @config.endpoint == Client.configure.endpoint &&
+              enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
-              if credentials.is_a?(String) || credentials.is_a?(Hash)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -205,7 +190,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The project whose alert policies are to be listed. The format is:
+            #     Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name)
+            #     whose alert policies are to be listed. The format is:
             #
             #         projects/[PROJECT_ID_OR_NUMBER]
             #
@@ -268,7 +254,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.list_alert_policies.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_alert_policies.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @alert_policy_service_stub.call_rpc :list_alert_policies, request, options: options do |response, operation|
@@ -337,7 +325,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.get_alert_policy.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_alert_policy.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @alert_policy_service_stub.call_rpc :get_alert_policy, request, options: options do |response, operation|
@@ -367,7 +357,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The project in which to create the alerting policy. The format is:
+            #     Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name) in
+            #     which to create the alerting policy. The format is:
             #
             #         projects/[PROJECT_ID_OR_NUMBER]
             #
@@ -417,7 +408,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.create_alert_policy.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_alert_policy.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @alert_policy_service_stub.call_rpc :create_alert_policy, request, options: options do |response, operation|
@@ -487,7 +480,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.delete_alert_policy.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_alert_policy.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @alert_policy_service_stub.call_rpc :delete_alert_policy, request, options: options do |response, operation|
@@ -581,7 +576,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.update_alert_policy.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_alert_policy.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @alert_policy_service_stub.call_rpc :update_alert_policy, request, options: options do |response, operation|
@@ -605,22 +602,21 @@ module Google
             # Configuration can be applied globally to all clients, or to a single client
             # on construction.
             #
-            # # Examples
-            #
-            # To modify the global config, setting the timeout for list_alert_policies
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_alert_policies.timeout = 20.0
-            #     end
-            #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_alert_policies.timeout = 20.0
-            #     end
+            # @example
+            #
+            #   # Modify the global config, setting the timeout for
+            #   # list_alert_policies to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_alert_policies.timeout = 20.0
+            #   end
+            #
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_alert_policies.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.

data/lib/google/cloud/monitoring/v3/alert_policy_service/paths.rb

@@ -162,6 +162,20 @@ module Google
               "organizations/#{organization}"
             end
 
+            ##
+            # Create a fully-qualified Project resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}`
+            #
+            # @param project [String]
+            #
+            # @return [::String]
+            def project_path project:
+              "projects/#{project}"
+            end
+
             ##
             # Create a fully-qualified Workspace resource string.
             #

data/lib/google/cloud/monitoring/v3/group_service/client.rb

@@ -52,13 +52,12 @@ module Google
             # See {::Google::Cloud::Monitoring::V3::GroupService::Client::Configuration}
             # for a description of the configuration fields.
             #
-            # ## Example
+            # @example
             #
-            # To modify the configuration for all GroupService clients:
-            #
-            #     ::Google::Cloud::Monitoring::V3::GroupService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Modify the configuration for all GroupService clients
+            #   ::Google::Cloud::Monitoring::V3::GroupService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Client client.
             # @yieldparam config [Client::Configuration]
@@ -78,44 +77,29 @@ module Google
 
                 default_config.rpcs.list_groups.timeout = 30.0
                 default_config.rpcs.list_groups.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 30.0,
-              multiplier: 1.3,
-              retry_codes: [4, 14]
+                  initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config.rpcs.get_group.timeout = 30.0
                 default_config.rpcs.get_group.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 30.0,
-              multiplier: 1.3,
-              retry_codes: [4, 14]
+                  initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config.rpcs.create_group.timeout = 30.0
 
-                default_config.rpcs.update_group.timeout = 30.0
+                default_config.rpcs.update_group.timeout = 180.0
                 default_config.rpcs.update_group.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 30.0,
-              multiplier: 1.3,
-              retry_codes: [4, 14]
+                  initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config.rpcs.delete_group.timeout = 30.0
                 default_config.rpcs.delete_group.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 30.0,
-              multiplier: 1.3,
-              retry_codes: [4, 14]
+                  initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config.rpcs.list_group_members.timeout = 30.0
                 default_config.rpcs.list_group_members.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 30.0,
-              multiplier: 1.3,
-              retry_codes: [4, 14]
+                  initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config
@@ -147,19 +131,15 @@ module Google
             ##
             # Create a new GroupService client object.
             #
-            # ## Examples
-            #
-            # To create a new GroupService client with the default
-            # configuration:
+            # @example
             #
-            #     client = ::Google::Cloud::Monitoring::V3::GroupService::Client.new
+            #   # Create a client using the default configuration
+            #   client = ::Google::Cloud::Monitoring::V3::GroupService::Client.new
             #
-            # To create a new GroupService client with a custom
-            # configuration:
-            #
-            #     client = ::Google::Cloud::Monitoring::V3::GroupService::Client.new do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Create a client using a custom configuration
+            #   client = ::Google::Cloud::Monitoring::V3::GroupService::Client.new do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the GroupService client.
             # @yieldparam config [Client::Configuration]
@@ -179,14 +159,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # Use self-signed JWT if the endpoint is unchanged from default,
               # but only if the default endpoint does not have a region prefix.
-              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
-                                       @config.endpoint == Client.configure.endpoint &&
+              enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
-              if credentials.is_a?(String) || credentials.is_a?(Hash)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -222,7 +201,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The project whose groups are to be listed. The format is:
+            #     Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name)
+            #     whose groups are to be listed. The format is:
             #
             #         projects/[PROJECT_ID_OR_NUMBER]
             #   @param children_of_group [::String]
@@ -290,7 +270,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.list_groups.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_groups.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @group_service_stub.call_rpc :list_groups, request, options: options do |response, operation|
@@ -359,7 +341,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.get_group.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_group.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @group_service_stub.call_rpc :get_group, request, options: options do |response, operation|
@@ -389,7 +373,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The project in which to create the group. The format is:
+            #     Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name) in
+            #     which to create the group. The format is:
             #
             #         projects/[PROJECT_ID_OR_NUMBER]
             #   @param group [::Google::Cloud::Monitoring::V3::Group, ::Hash]
@@ -432,7 +417,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.create_group.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_group.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @group_service_stub.call_rpc :create_group, request, options: options do |response, operation|
@@ -502,7 +489,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.update_group.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_group.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @group_service_stub.call_rpc :update_group, request, options: options do |response, operation|
@@ -574,7 +563,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.delete_group.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_group.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @group_service_stub.call_rpc :delete_group, request, options: options do |response, operation|
@@ -662,7 +653,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.list_group_members.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_group_members.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @group_service_stub.call_rpc :list_group_members, request, options: options do |response, operation|
@@ -687,22 +680,21 @@ module Google
             # Configuration can be applied globally to all clients, or to a single client
             # on construction.
             #
-            # # Examples
-            #
-            # To modify the global config, setting the timeout for list_groups
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Cloud::Monitoring::V3::GroupService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_groups.timeout = 20.0
-            #     end
-            #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Cloud::Monitoring::V3::GroupService::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_groups.timeout = 20.0
-            #     end
+            # @example
+            #
+            #   # Modify the global config, setting the timeout for
+            #   # list_groups to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Cloud::Monitoring::V3::GroupService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_groups.timeout = 20.0
+            #   end
+            #
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Cloud::Monitoring::V3::GroupService::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_groups.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.

data/lib/google/cloud/monitoring/v3/group_service/paths.rb

@@ -104,6 +104,20 @@ module Google
               "organizations/#{organization}"
             end
 
+            ##
+            # Create a fully-qualified Project resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}`
+            #
+            # @param project [String]
+            #
+            # @return [::String]
+            def project_path project:
+              "projects/#{project}"
+            end
+
             ##
             # Create a fully-qualified Workspace resource string.
             #