google-cloud-service_management-v1 0.3.3 → 0.3.7

data/lib/google/cloud/service_management/v1/service_manager/client.rb

@@ -27,7 +27,7 @@ module Google
           ##
           # Client for the ServiceManager service.
           #
-          # [Google Service Management API](https://cloud.google.com/service-management/overview)
+          # [Google Service Management API](/service-management/overview)
           #
           class Client
             # @private
@@ -39,13 +39,12 @@ module Google
             # See {::Google::Cloud::ServiceManagement::V1::ServiceManager::Client::Configuration}
             # for a description of the configuration fields.
             #
-            # ## Example
+            # @example
             #
-            # To modify the configuration for all ServiceManager clients:
-            #
-            #     ::Google::Cloud::ServiceManagement::V1::ServiceManager::Client.configure do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Modify the configuration for all ServiceManager clients
+            #   ::Google::Cloud::ServiceManagement::V1::ServiceManager::Client.configure do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Client client.
             # @yieldparam config [Client::Configuration]
@@ -63,6 +62,8 @@ module Google
                                 end
                 default_config = Client::Configuration.new parent_config
 
+                default_config.timeout = 10.0
+
                 default_config
               end
               yield @configure if block_given?
@@ -92,19 +93,15 @@ module Google
             ##
             # Create a new ServiceManager client object.
             #
-            # ## Examples
-            #
-            # To create a new ServiceManager client with the default
-            # configuration:
-            #
-            #     client = ::Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
+            # @example
             #
-            # To create a new ServiceManager client with a custom
-            # configuration:
+            #   # Create a client using the default configuration
+            #   client = ::Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
             #
-            #     client = ::Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Create a client using a custom configuration
+            #   client = ::Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the ServiceManager client.
             # @yieldparam config [Client::Configuration]
@@ -124,10 +121,9 @@ 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
@@ -139,6 +135,7 @@ module Google
 
               @operations_client = Operations.new do |config|
                 config.credentials = credentials
+                config.quota_project = @quota_project_id
                 config.endpoint = @config.endpoint
               end
 
@@ -167,10 +164,6 @@ module Google
             # services the calling user has "servicemanagement.services.get" permission
             # for.
             #
-            # **BETA:** If the caller specifies the `consumer_id`, it returns only the
-            # services enabled on the consumer. The `consumer_id` must have the format
-            # of "project:\\{PROJECT-ID}".
-            #
             # @overload list_services(request, options = nil)
             #   Pass arguments to `list_services` via a request object, either of type
             #   {::Google::Cloud::ServiceManagement::V1::ListServicesRequest} or an equivalent Hash.
@@ -209,6 +202,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/service_management/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::ServiceManagement::V1::ListServicesRequest.new
+            #
+            #   # Call the list_services method.
+            #   result = client.list_services request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::ServiceManagement::V1::ManagedService.
+            #     p response
+            #   end
+            #
             def list_services request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -229,7 +243,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.list_services.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_services.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @service_manager_stub.call_rpc :list_services, request, options: options do |response, operation|
@@ -272,6 +288,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/service_management/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::ServiceManagement::V1::GetServiceRequest.new
+            #
+            #   # Call the get_service method.
+            #   result = client.get_service request
+            #
+            #   # The returned object is of type Google::Cloud::ServiceManagement::V1::ManagedService.
+            #   p result
+            #
             def get_service request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -289,16 +320,20 @@ module Google
                 gapic_version: ::Google::Cloud::ServiceManagement::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "service_name" => request.service_name
-              }
+              header_params = {}
+              if request.service_name
+                header_params["service_name"] = request.service_name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.get_service.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_service.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @service_manager_stub.call_rpc :get_service, request, options: options do |response, operation|
@@ -311,7 +346,14 @@ module Google
 
             ##
             # Creates a new managed service.
-            # Please note one producer project can own no more than 20 services.
+            #
+            # A managed service is immutable, and is subject to mandatory 30-day
+            # data retention. You cannot move a service or recreate it within 30 days
+            # after deletion.
+            #
+            # One producer project can own no more than 500 services. For security and
+            # reliability purposes, a production service should be hosted in a
+            # dedicated producer project.
             #
             # Operation<response: ManagedService>
             #
@@ -341,6 +383,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/service_management/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::ServiceManagement::V1::CreateServiceRequest.new
+            #
+            #   # Call the create_service method.
+            #   result = client.create_service request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def create_service request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -361,7 +425,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.create_service.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_service.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @service_manager_stub.call_rpc :create_service, request, options: options do |response, operation|
@@ -397,7 +463,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
+            #     Required. The name of the service.  See the [overview](/service-management/overview)
             #     for naming requirements.  For example: `example.googleapis.com`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -408,6 +474,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/service_management/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::ServiceManagement::V1::DeleteServiceRequest.new
+            #
+            #   # Call the delete_service method.
+            #   result = client.delete_service request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def delete_service request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -425,16 +513,20 @@ module Google
                 gapic_version: ::Google::Cloud::ServiceManagement::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "service_name" => request.service_name
-              }
+              header_params = {}
+              if request.service_name
+                header_params["service_name"] = request.service_name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.delete_service.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_service.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @service_manager_stub.call_rpc :delete_service, request, options: options do |response, operation|
@@ -470,7 +562,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview)
+            #     Required. The name of the service. See the [overview](/service-management/overview)
             #     for naming requirements. For example: `example.googleapis.com`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -481,6 +573,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/service_management/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::ServiceManagement::V1::UndeleteServiceRequest.new
+            #
+            #   # Call the undelete_service method.
+            #   result = client.undelete_service request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def undelete_service request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -498,16 +612,20 @@ module Google
                 gapic_version: ::Google::Cloud::ServiceManagement::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "service_name" => request.service_name
-              }
+              header_params = {}
+              if request.service_name
+                header_params["service_name"] = request.service_name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.undelete_service.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.undelete_service.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @service_manager_stub.call_rpc :undelete_service, request, options: options do |response, operation|
@@ -539,7 +657,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
+            #     Required. The name of the service.  See the [overview](/service-management/overview)
             #     for naming requirements.  For example: `example.googleapis.com`.
             #   @param page_token [::String]
             #     The token of the page to retrieve.
@@ -555,6 +673,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/service_management/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::ServiceManagement::V1::ListServiceConfigsRequest.new
+            #
+            #   # Call the list_service_configs method.
+            #   result = client.list_service_configs request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Api::Service.
+            #     p response
+            #   end
+            #
             def list_service_configs request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -572,16 +711,20 @@ module Google
                 gapic_version: ::Google::Cloud::ServiceManagement::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "service_name" => request.service_name
-              }
+              header_params = {}
+              if request.service_name
+                header_params["service_name"] = request.service_name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.list_service_configs.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_service_configs.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @service_manager_stub.call_rpc :list_service_configs, request, options: options do |response, operation|
@@ -612,7 +755,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
+            #     Required. The name of the service.  See the [overview](/service-management/overview)
             #     for naming requirements.  For example: `example.googleapis.com`.
             #   @param config_id [::String]
             #     Required. The id of the service configuration resource.
@@ -631,6 +774,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/service_management/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::ServiceManagement::V1::GetServiceConfigRequest.new
+            #
+            #   # Call the get_service_config method.
+            #   result = client.get_service_config request
+            #
+            #   # The returned object is of type Google::Api::Service.
+            #   p result
+            #
             def get_service_config request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -648,17 +806,23 @@ module Google
                 gapic_version: ::Google::Cloud::ServiceManagement::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "service_name" => request.service_name,
-                "config_id" => request.config_id
-              }
+              header_params = {}
+              if request.service_name
+                header_params["service_name"] = request.service_name
+              end
+              if request.config_id
+                header_params["config_id"] = request.config_id
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.get_service_config.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_service_config.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @service_manager_stub.call_rpc :get_service_config, request, options: options do |response, operation|
@@ -695,7 +859,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
+            #     Required. The name of the service.  See the [overview](/service-management/overview)
             #     for naming requirements.  For example: `example.googleapis.com`.
             #   @param service_config [::Google::Api::Service, ::Hash]
             #     Required. The service configuration resource.
@@ -708,6 +872,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/service_management/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::ServiceManagement::V1::CreateServiceConfigRequest.new
+            #
+            #   # Call the create_service_config method.
+            #   result = client.create_service_config request
+            #
+            #   # The returned object is of type Google::Api::Service.
+            #   p result
+            #
             def create_service_config request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -725,16 +904,20 @@ module Google
                 gapic_version: ::Google::Cloud::ServiceManagement::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "service_name" => request.service_name
-              }
+              header_params = {}
+              if request.service_name
+                header_params["service_name"] = request.service_name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.create_service_config.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_service_config.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @service_manager_stub.call_rpc :create_service_config, request, options: options do |response, operation|
@@ -776,7 +959,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
+            #     Required. The name of the service.  See the [overview](/service-management/overview)
             #     for naming requirements.  For example: `example.googleapis.com`.
             #   @param config_source [::Google::Cloud::ServiceManagement::V1::ConfigSource, ::Hash]
             #     Required. The source configuration for the service.
@@ -793,6 +976,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/service_management/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::ServiceManagement::V1::SubmitConfigSourceRequest.new
+            #
+            #   # Call the submit_config_source method.
+            #   result = client.submit_config_source request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def submit_config_source request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -810,16 +1015,20 @@ module Google
                 gapic_version: ::Google::Cloud::ServiceManagement::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "service_name" => request.service_name
-              }
+              header_params = {}
+              if request.service_name
+                header_params["service_name"] = request.service_name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.submit_config_source.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.submit_config_source.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @service_manager_stub.call_rpc :submit_config_source, request, options: options do |response, operation|
@@ -851,7 +1060,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
+            #     Required. The name of the service.  See the [overview](/service-management/overview)
             #     for naming requirements.  For example: `example.googleapis.com`.
             #   @param page_token [::String]
             #     The token of the page to retrieve.
@@ -862,10 +1071,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'
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -876,6 +1085,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/service_management/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::ServiceManagement::V1::ListServiceRolloutsRequest.new
+            #
+            #   # Call the list_service_rollouts method.
+            #   result = client.list_service_rollouts request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::ServiceManagement::V1::Rollout.
+            #     p response
+            #   end
+            #
             def list_service_rollouts request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -893,16 +1123,20 @@ module Google
                 gapic_version: ::Google::Cloud::ServiceManagement::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "service_name" => request.service_name
-              }
+              header_params = {}
+              if request.service_name
+                header_params["service_name"] = request.service_name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.list_service_rollouts.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_service_rollouts.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @service_manager_stub.call_rpc :list_service_rollouts, request, options: options do |response, operation|
@@ -933,7 +1167,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
+            #     Required. The name of the service.  See the [overview](/service-management/overview)
             #     for naming requirements.  For example: `example.googleapis.com`.
             #   @param rollout_id [::String]
             #     Required. The id of the rollout resource.
@@ -946,6 +1180,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/service_management/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::ServiceManagement::V1::GetServiceRolloutRequest.new
+            #
+            #   # Call the get_service_rollout method.
+            #   result = client.get_service_rollout request
+            #
+            #   # The returned object is of type Google::Cloud::ServiceManagement::V1::Rollout.
+            #   p result
+            #
             def get_service_rollout request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -963,17 +1212,23 @@ module Google
                 gapic_version: ::Google::Cloud::ServiceManagement::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "service_name" => request.service_name,
-                "rollout_id" => request.rollout_id
-              }
+              header_params = {}
+              if request.service_name
+                header_params["service_name"] = request.service_name
+              end
+              if request.rollout_id
+                header_params["rollout_id"] = request.rollout_id
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.get_service_rollout.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_service_rollout.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @service_manager_stub.call_rpc :get_service_rollout, request, options: options do |response, operation|
@@ -1016,7 +1271,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
+            #     Required. The name of the service.  See the [overview](/service-management/overview)
             #     for naming requirements.  For example: `example.googleapis.com`.
             #   @param rollout [::Google::Cloud::ServiceManagement::V1::Rollout, ::Hash]
             #     Required. The rollout resource. The `service_name` field is output only.
@@ -1029,6 +1284,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/service_management/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::ServiceManagement::V1::CreateServiceRolloutRequest.new
+            #
+            #   # Call the create_service_rollout method.
+            #   result = client.create_service_rollout request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def create_service_rollout request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1046,16 +1323,20 @@ module Google
                 gapic_version: ::Google::Cloud::ServiceManagement::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "service_name" => request.service_name
-              }
+              header_params = {}
+              if request.service_name
+                header_params["service_name"] = request.service_name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.create_service_rollout.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_service_rollout.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @service_manager_stub.call_rpc :create_service_rollout, request, options: options do |response, operation|
@@ -1116,92 +1397,31 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
-            def generate_config_report request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ServiceManagement::V1::GenerateConfigReportRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.generate_config_report.metadata.to_h
-
-              # Set x-goog-api-client and x-goog-user-project headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ServiceManagement::V1::VERSION
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              options.apply_defaults timeout:      @config.rpcs.generate_config_report.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.generate_config_report.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @service_manager_stub.call_rpc :generate_config_report, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Enables a {::Google::Cloud::ServiceManagement::V1::ManagedService service} for a project, so it can be used
-            # for the project. See
-            # [Cloud Auth Guide](https://cloud.google.com/docs/authentication) for
-            # more information.
-            #
-            # Operation<response: EnableServiceResponse>
-            #
-            # @overload enable_service(request, options = nil)
-            #   Pass arguments to `enable_service` via a request object, either of type
-            #   {::Google::Cloud::ServiceManagement::V1::EnableServiceRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ServiceManagement::V1::EnableServiceRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload enable_service(service_name: nil, consumer_id: nil)
-            #   Pass arguments to `enable_service` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param service_name [::String]
-            #     Required. Name of the service to enable. Specifying an unknown service name will
-            #     cause the request to fail.
-            #   @param consumer_id [::String]
-            #     Required. The identity of consumer resource which service enablement will be
-            #     applied to.
-            #
-            #     The Google Service Management implementation accepts the following
-            #     forms:
-            #     - "project:<project_id>"
+            # @example Basic example
+            #   require "google/cloud/service_management/v1"
             #
-            #     Note: this is made compatible with
-            #     google.api.servicecontrol.v1.Operation.consumer_id.
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
             #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Gapic::Operation]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::ServiceManagement::V1::GenerateConfigReportRequest.new
             #
-            # @return [::Gapic::Operation]
+            #   # Call the generate_config_report method.
+            #   result = client.generate_config_report request
             #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #   # The returned object is of type Google::Cloud::ServiceManagement::V1::GenerateConfigReportResponse.
+            #   p result
             #
-            def enable_service request, options = nil
+            def generate_config_report request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ServiceManagement::V1::EnableServiceRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ServiceManagement::V1::GenerateConfigReportRequest
 
               # Converts hash and nil to an options object
               options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
-              metadata = @config.rpcs.enable_service.metadata.to_h
+              metadata = @config.rpcs.generate_config_report.metadata.to_h
 
               # Set x-goog-api-client and x-goog-user-project headers
               metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
@@ -1209,102 +1429,15 @@ module Google
                 gapic_version: ::Google::Cloud::ServiceManagement::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "service_name" => request.service_name
-              }
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.enable_service.timeout,
+              options.apply_defaults timeout:      @config.rpcs.generate_config_report.timeout,
                                      metadata:     metadata,
-                                     retry_policy: @config.rpcs.enable_service.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @service_manager_stub.call_rpc :enable_service, request, options: options do |response, operation|
-                response = ::Gapic::Operation.new response, @operations_client, options: options
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Disables a {::Google::Cloud::ServiceManagement::V1::ManagedService service} for a project, so it can no longer be
-            # be used for the project. It prevents accidental usage that may cause
-            # unexpected billing charges or security leaks.
-            #
-            # Operation<response: DisableServiceResponse>
-            #
-            # @overload disable_service(request, options = nil)
-            #   Pass arguments to `disable_service` via a request object, either of type
-            #   {::Google::Cloud::ServiceManagement::V1::DisableServiceRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ServiceManagement::V1::DisableServiceRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload disable_service(service_name: nil, consumer_id: nil)
-            #   Pass arguments to `disable_service` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param service_name [::String]
-            #     Required. Name of the service to disable. Specifying an unknown service name
-            #     will cause the request to fail.
-            #   @param consumer_id [::String]
-            #     Required. The identity of consumer resource which service disablement will be
-            #     applied to.
-            #
-            #     The Google Service Management implementation accepts the following
-            #     forms:
-            #     - "project:<project_id>"
-            #
-            #     Note: this is made compatible with
-            #     google.api.servicecontrol.v1.Operation.consumer_id.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Gapic::Operation]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Gapic::Operation]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            def disable_service request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ServiceManagement::V1::DisableServiceRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.disable_service.metadata.to_h
-
-              # Set x-goog-api-client and x-goog-user-project headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ServiceManagement::V1::VERSION
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {
-                "service_name" => request.service_name
-              }
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
+                                     retry_policy: @config.rpcs.generate_config_report.retry_policy
 
-              options.apply_defaults timeout:      @config.rpcs.disable_service.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.disable_service.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
-              @service_manager_stub.call_rpc :disable_service, request, options: options do |response, operation|
-                response = ::Gapic::Operation.new response, @operations_client, options: options
+              @service_manager_stub.call_rpc :generate_config_report, request, options: options do |response, operation|
                 yield response, operation if block_given?
                 return response
               end
@@ -1325,22 +1458,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_services
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
+            # @example
             #
-            #     ::Google::Cloud::ServiceManagement::V1::ServiceManager::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_services.timeout = 20.0
-            #     end
+            #   # Modify the global config, setting the timeout for
+            #   # list_services to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Cloud::ServiceManagement::V1::ServiceManager::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_services.timeout = 20.0
+            #   end
             #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.list_services.timeout = 20.0
-            #     end
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.list_services.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.
@@ -1513,16 +1645,6 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :generate_config_report
-                ##
-                # RPC-specific configuration for `enable_service`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :enable_service
-                ##
-                # RPC-specific configuration for `disable_service`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :disable_service
 
                 # @private
                 def initialize parent_rpcs = nil
@@ -1552,10 +1674,6 @@ module Google
                   @create_service_rollout = ::Gapic::Config::Method.new create_service_rollout_config
                   generate_config_report_config = parent_rpcs.generate_config_report if parent_rpcs.respond_to? :generate_config_report
                   @generate_config_report = ::Gapic::Config::Method.new generate_config_report_config
-                  enable_service_config = parent_rpcs.enable_service if parent_rpcs.respond_to? :enable_service
-                  @enable_service = ::Gapic::Config::Method.new enable_service_config
-                  disable_service_config = parent_rpcs.disable_service if parent_rpcs.respond_to? :disable_service
-                  @disable_service = ::Gapic::Config::Method.new disable_service_config
 
                   yield self if block_given?
                 end