google-cloud-apigee_registry-v1 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e6f2c4a34c0ee9eba5893c611a6527c57f339d32315d14a7906a023d67c0a7fb
-  data.tar.gz: a047a1439e60e34efcd319e0877e879edfc8374135053ae219b2aa98e183b40c
+  metadata.gz: 57b135728d5a751ca1319356039d3f3c94a242b0cceea6a8d379072d1c72a3f9
+  data.tar.gz: c4dfe2a02c722dcc956503118910268ca401090779e2784d1d897dac6a6315cd
 SHA512:
-  metadata.gz: 3596852957e73a12a3a9245eef2782b70658cb061e7c68db26a56778028edf61574c45de7baf88d298b22887954dbd5707d9139a2733f40eaa8fc4c207f6e7e4
-  data.tar.gz: 6ae1386aceb73c392e99e4fa6f9c2688ff2672b92c15c143fd6e80875ce4f72f3ccbf811baae4013e19726f9d03f430ae2c5d87398598f9ca13324261e04a582
+  metadata.gz: bd1fd5d204afcdca577219c1abe1d87567240c25f8e3f8da91359fccf106df7e7231c8c1d2b20adf29f5991b374dbe4ab48d945c4c79985823f668385619bae2
+  data.tar.gz: 61e1ec53d163f48da849a054250cfb365f360480c84d0625d26de64f8b30d2e1af746b6c40a8c20e622feb9130855743dc79643938d895b423afab5cdaef654c

data/lib/google/cloud/apigee_registry/v1/provisioning/client.rb

@@ -159,7 +159,8 @@ module Google
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
-                interceptors: @config.interceptors
+                interceptors: @config.interceptors,
+                channel_pool_config: @config.channel_pool
               )
             end
 
@@ -583,6 +584,14 @@ module Google
                 end
               end
 
+              ##
+              # Configuration for the channel pool
+              # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+              #
+              def channel_pool
+                @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+              end
+
               ##
               # Configuration RPC class for the Provisioning API.
               #

data/lib/google/cloud/apigee_registry/v1/provisioning/operations.rb

@@ -93,7 +93,8 @@ module Google
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
-                interceptors: @config.interceptors
+                interceptors: @config.interceptors,
+                channel_pool_config: @config.channel_pool
               )
 
               # Used by an LRO wrapper for some methods of this service
@@ -701,6 +702,14 @@ module Google
                 end
               end
 
+              ##
+              # Configuration for the channel pool
+              # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+              #
+              def channel_pool
+                @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+              end
+
               ##
               # Configuration RPC class for the Operations API.
               #

data/lib/google/cloud/apigee_registry/v1/provisioning/rest/client.rb

@@ -211,6 +211,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Provisioning::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::CreateInstanceRequest.new
+              #
+              #   # Call the create_instance method.
+              #   result = client.create_instance request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def create_instance request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -275,6 +298,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Provisioning::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::DeleteInstanceRequest.new
+              #
+              #   # Call the delete_instance method.
+              #   result = client.delete_instance request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def delete_instance request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -339,6 +385,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::Instance]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Provisioning::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::GetInstanceRequest.new
+              #
+              #   # Call the get_instance method.
+              #   result = client.get_instance request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::Instance.
+              #   p result
+              #
               def get_instance request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/apigee_registry/v1/provisioning/rest/operations.rb

@@ -136,6 +136,26 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::ListOperationsRequest.new
+              #
+              #   # Call the list_operations method.
+              #   result = client.list_operations request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Longrunning::Operation.
+              #     p item
+              #   end
+              #
               def list_operations request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -201,6 +221,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::GetOperationRequest.new
+              #
+              #   # Call the get_operation method.
+              #   result = client.get_operation request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def get_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -267,6 +310,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::DeleteOperationRequest.new
+              #
+              #   # Call the delete_operation method.
+              #   result = client.delete_operation request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -338,6 +397,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::CancelOperationRequest.new
+              #
+              #   # Call the cancel_operation method.
+              #   result = client.cancel_operation request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def cancel_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/apigee_registry/v1/registry/client.rb

@@ -321,7 +321,8 @@ module Google
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
-                interceptors: @config.interceptors
+                interceptors: @config.interceptors,
+                channel_pool_config: @config.channel_pool
               )
             end
 
@@ -3720,6 +3721,14 @@ module Google
                 end
               end
 
+              ##
+              # Configuration for the channel pool
+              # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+              #
+              def channel_pool
+                @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+              end
+
               ##
               # Configuration RPC class for the Registry API.
               #

data/lib/google/cloud/apigee_registry/v1/registry/rest/client.rb

@@ -376,6 +376,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ApigeeRegistry::V1::Api>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::ListApisRequest.new
+              #
+              #   # Call the list_apis method.
+              #   result = client.list_apis request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::ApigeeRegistry::V1::Api.
+              #     p item
+              #   end
+              #
               def list_apis request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -440,6 +460,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::Api]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::GetApiRequest.new
+              #
+              #   # Call the get_api method.
+              #   result = client.get_api request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::Api.
+              #   p result
+              #
               def get_api request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -513,6 +549,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::Api]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::CreateApiRequest.new
+              #
+              #   # Call the create_api method.
+              #   result = client.create_api request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::Api.
+              #   p result
+              #
               def create_api request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -586,6 +638,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::Api]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::UpdateApiRequest.new
+              #
+              #   # Call the update_api method.
+              #   result = client.update_api request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::Api.
+              #   p result
+              #
               def update_api request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -653,6 +721,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::DeleteApiRequest.new
+              #
+              #   # Call the delete_api method.
+              #   result = client.delete_api request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_api request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -730,6 +814,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ApigeeRegistry::V1::ApiVersion>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::ListApiVersionsRequest.new
+              #
+              #   # Call the list_api_versions method.
+              #   result = client.list_api_versions request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::ApigeeRegistry::V1::ApiVersion.
+              #     p item
+              #   end
+              #
               def list_api_versions request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -794,6 +898,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::ApiVersion]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::GetApiVersionRequest.new
+              #
+              #   # Call the get_api_version method.
+              #   result = client.get_api_version request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::ApiVersion.
+              #   p result
+              #
               def get_api_version request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -867,6 +987,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::ApiVersion]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::CreateApiVersionRequest.new
+              #
+              #   # Call the create_api_version method.
+              #   result = client.create_api_version request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::ApiVersion.
+              #   p result
+              #
               def create_api_version request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -940,6 +1076,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::ApiVersion]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::UpdateApiVersionRequest.new
+              #
+              #   # Call the update_api_version method.
+              #   result = client.update_api_version request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::ApiVersion.
+              #   p result
+              #
               def update_api_version request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1007,6 +1159,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::DeleteApiVersionRequest.new
+              #
+              #   # Call the delete_api_version method.
+              #   result = client.delete_api_version request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_api_version request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1084,6 +1252,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ApigeeRegistry::V1::ApiSpec>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::ListApiSpecsRequest.new
+              #
+              #   # Call the list_api_specs method.
+              #   result = client.list_api_specs request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::ApigeeRegistry::V1::ApiSpec.
+              #     p item
+              #   end
+              #
               def list_api_specs request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1148,6 +1336,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::ApiSpec]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::GetApiSpecRequest.new
+              #
+              #   # Call the get_api_spec method.
+              #   result = client.get_api_spec request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::ApiSpec.
+              #   p result
+              #
               def get_api_spec request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1214,6 +1418,22 @@ module Google
               # @return [::Google::Api::HttpBody]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::GetApiSpecContentsRequest.new
+              #
+              #   # Call the get_api_spec_contents method.
+              #   result = client.get_api_spec_contents request
+              #
+              #   # The returned object is of type Google::Api::HttpBody.
+              #   p result
+              #
               def get_api_spec_contents request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1287,6 +1507,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::ApiSpec]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::CreateApiSpecRequest.new
+              #
+              #   # Call the create_api_spec method.
+              #   result = client.create_api_spec request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::ApiSpec.
+              #   p result
+              #
               def create_api_spec request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1360,6 +1596,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::ApiSpec]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::UpdateApiSpecRequest.new
+              #
+              #   # Call the update_api_spec method.
+              #   result = client.update_api_spec request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::ApiSpec.
+              #   p result
+              #
               def update_api_spec request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1427,6 +1679,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::DeleteApiSpecRequest.new
+              #
+              #   # Call the delete_api_spec method.
+              #   result = client.delete_api_spec request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_api_spec request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1492,6 +1760,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::ApiSpec]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::TagApiSpecRevisionRequest.new
+              #
+              #   # Call the tag_api_spec_revision method.
+              #   result = client.tag_api_spec_revision request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::ApiSpec.
+              #   p result
+              #
               def tag_api_spec_revision request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1560,6 +1844,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ApigeeRegistry::V1::ApiSpec>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::ListApiSpecRevisionsRequest.new
+              #
+              #   # Call the list_api_spec_revisions method.
+              #   result = client.list_api_spec_revisions request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::ApigeeRegistry::V1::ApiSpec.
+              #     p item
+              #   end
+              #
               def list_api_spec_revisions request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1629,6 +1933,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::ApiSpec]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::RollbackApiSpecRequest.new
+              #
+              #   # Call the rollback_api_spec method.
+              #   result = client.rollback_api_spec request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::ApiSpec.
+              #   p result
+              #
               def rollback_api_spec request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1695,6 +2015,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::ApiSpec]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::DeleteApiSpecRevisionRequest.new
+              #
+              #   # Call the delete_api_spec_revision method.
+              #   result = client.delete_api_spec_revision request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::ApiSpec.
+              #   p result
+              #
               def delete_api_spec_revision request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1772,6 +2108,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ApigeeRegistry::V1::ApiDeployment>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::ListApiDeploymentsRequest.new
+              #
+              #   # Call the list_api_deployments method.
+              #   result = client.list_api_deployments request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::ApigeeRegistry::V1::ApiDeployment.
+              #     p item
+              #   end
+              #
               def list_api_deployments request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1836,6 +2192,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::ApiDeployment]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::GetApiDeploymentRequest.new
+              #
+              #   # Call the get_api_deployment method.
+              #   result = client.get_api_deployment request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::ApiDeployment.
+              #   p result
+              #
               def get_api_deployment request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1909,6 +2281,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::ApiDeployment]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::CreateApiDeploymentRequest.new
+              #
+              #   # Call the create_api_deployment method.
+              #   result = client.create_api_deployment request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::ApiDeployment.
+              #   p result
+              #
               def create_api_deployment request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1982,6 +2370,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::ApiDeployment]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::UpdateApiDeploymentRequest.new
+              #
+              #   # Call the update_api_deployment method.
+              #   result = client.update_api_deployment request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::ApiDeployment.
+              #   p result
+              #
               def update_api_deployment request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2049,6 +2453,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::DeleteApiDeploymentRequest.new
+              #
+              #   # Call the delete_api_deployment method.
+              #   result = client.delete_api_deployment request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_api_deployment request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2115,6 +2535,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::ApiDeployment]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::TagApiDeploymentRevisionRequest.new
+              #
+              #   # Call the tag_api_deployment_revision method.
+              #   result = client.tag_api_deployment_revision request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::ApiDeployment.
+              #   p result
+              #
               def tag_api_deployment_revision request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2183,6 +2619,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ApigeeRegistry::V1::ApiDeployment>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::ListApiDeploymentRevisionsRequest.new
+              #
+              #   # Call the list_api_deployment_revisions method.
+              #   result = client.list_api_deployment_revisions request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::ApigeeRegistry::V1::ApiDeployment.
+              #     p item
+              #   end
+              #
               def list_api_deployment_revisions request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2252,6 +2708,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::ApiDeployment]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::RollbackApiDeploymentRequest.new
+              #
+              #   # Call the rollback_api_deployment method.
+              #   result = client.rollback_api_deployment request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::ApiDeployment.
+              #   p result
+              #
               def rollback_api_deployment request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2318,6 +2790,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::ApiDeployment]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::DeleteApiDeploymentRevisionRequest.new
+              #
+              #   # Call the delete_api_deployment_revision method.
+              #   result = client.delete_api_deployment_revision request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::ApiDeployment.
+              #   p result
+              #
               def delete_api_deployment_revision request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2395,6 +2883,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ApigeeRegistry::V1::Artifact>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::ListArtifactsRequest.new
+              #
+              #   # Call the list_artifacts method.
+              #   result = client.list_artifacts request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::ApigeeRegistry::V1::Artifact.
+              #     p item
+              #   end
+              #
               def list_artifacts request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2459,6 +2967,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::Artifact]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::GetArtifactRequest.new
+              #
+              #   # Call the get_artifact method.
+              #   result = client.get_artifact request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::Artifact.
+              #   p result
+              #
               def get_artifact request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2525,6 +3049,22 @@ module Google
               # @return [::Google::Api::HttpBody]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::GetArtifactContentsRequest.new
+              #
+              #   # Call the get_artifact_contents method.
+              #   result = client.get_artifact_contents request
+              #
+              #   # The returned object is of type Google::Api::HttpBody.
+              #   p result
+              #
               def get_artifact_contents request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2598,6 +3138,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::Artifact]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::CreateArtifactRequest.new
+              #
+              #   # Call the create_artifact method.
+              #   result = client.create_artifact request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::Artifact.
+              #   p result
+              #
               def create_artifact request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2663,6 +3219,22 @@ module Google
               # @return [::Google::Cloud::ApigeeRegistry::V1::Artifact]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::ReplaceArtifactRequest.new
+              #
+              #   # Call the replace_artifact method.
+              #   result = client.replace_artifact request
+              #
+              #   # The returned object is of type Google::Cloud::ApigeeRegistry::V1::Artifact.
+              #   p result
+              #
               def replace_artifact request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2726,6 +3298,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/apigee_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ApigeeRegistry::V1::Registry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ApigeeRegistry::V1::DeleteArtifactRequest.new
+              #
+              #   # Call the delete_artifact method.
+              #   result = client.delete_artifact request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_artifact request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/apigee_registry/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module ApigeeRegistry
       module V1
-        VERSION = "0.5.0"
+        VERSION = "0.6.0"
       end
     end
   end

data/proto_docs/google/api/field_behavior.rb

@@ -66,6 +66,20 @@ module Google
       # a non-empty value will be returned. The user will not be aware of what
       # non-empty value to expect.
       NON_EMPTY_DEFAULT = 7
+
+      # Denotes that the field in a resource (a message annotated with
+      # google.api.resource) is used in the resource name to uniquely identify the
+      # resource. For AIP-compliant APIs, this should only be applied to the
+      # `name` field on the resource.
+      #
+      # This behavior should not be applied to references to other resources within
+      # the message.
+      #
+      # The identifier field of resources often have different field behavior
+      # depending on the request it is embedded in (e.g. for Create methods name
+      # is optional and unused, while for Update methods it is required). Instead
+      # of method-specific annotations, only `IDENTIFIER` is required.
+      IDENTIFIER = 8
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-apigee_registry-v1
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-06 00:00:00.000000000 Z
+date: 2023-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -277,7 +277,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.2
+rubygems_version: 3.4.19
 signing_key: 
 specification_version: 4
 summary: API Client library for the Apigee Registry V1 API