google-cloud-artifact_registry-v1 0.9.1 → 0.11.0

data/lib/google/cloud/artifact_registry/v1/artifact_registry/rest/client.rb

@@ -211,6 +211,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::DockerImage>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::ListDockerImagesRequest.new
+              #
+              #   # Call the list_docker_images method.
+              #   result = client.list_docker_images 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::ArtifactRegistry::V1::DockerImage.
+              #     p item
+              #   end
+              #
               def list_docker_images request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -274,6 +294,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::DockerImage]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::GetDockerImageRequest.new
+              #
+              #   # Call the get_docker_image method.
+              #   result = client.get_docker_image request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::DockerImage.
+              #   p result
+              #
               def get_docker_image request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -341,6 +377,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::MavenArtifact>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::ListMavenArtifactsRequest.new
+              #
+              #   # Call the list_maven_artifacts method.
+              #   result = client.list_maven_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::ArtifactRegistry::V1::MavenArtifact.
+              #     p item
+              #   end
+              #
               def list_maven_artifacts request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -404,6 +460,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::MavenArtifact]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::GetMavenArtifactRequest.new
+              #
+              #   # Call the get_maven_artifact method.
+              #   result = client.get_maven_artifact request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::MavenArtifact.
+              #   p result
+              #
               def get_maven_artifact request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -471,6 +543,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::NpmPackage>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::ListNpmPackagesRequest.new
+              #
+              #   # Call the list_npm_packages method.
+              #   result = client.list_npm_packages 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::ArtifactRegistry::V1::NpmPackage.
+              #     p item
+              #   end
+              #
               def list_npm_packages request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -534,6 +626,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::NpmPackage]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::GetNpmPackageRequest.new
+              #
+              #   # Call the get_npm_package method.
+              #   result = client.get_npm_package request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::NpmPackage.
+              #   p result
+              #
               def get_npm_package request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -601,6 +709,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::PythonPackage>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::ListPythonPackagesRequest.new
+              #
+              #   # Call the list_python_packages method.
+              #   result = client.list_python_packages 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::ArtifactRegistry::V1::PythonPackage.
+              #     p item
+              #   end
+              #
               def list_python_packages request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -664,6 +792,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::PythonPackage]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::GetPythonPackageRequest.new
+              #
+              #   # Call the get_python_package method.
+              #   result = client.get_python_package request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::PythonPackage.
+              #   p result
+              #
               def get_python_package request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -731,6 +875,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::ImportAptArtifactsRequest.new
+              #
+              #   # Call the import_apt_artifacts method.
+              #   result = client.import_apt_artifacts 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 import_apt_artifacts request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -799,6 +966,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::ImportYumArtifactsRequest.new
+              #
+              #   # Call the import_yum_artifacts method.
+              #   result = client.import_yum_artifacts 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 import_yum_artifacts request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -854,7 +1044,8 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param parent [::String]
-              #     Required. The name of the parent resource whose repositories will be listed.
+              #     Required. The name of the parent resource whose repositories will be
+              #     listed.
               #   @param page_size [::Integer]
               #     The maximum number of repositories to return. Maximum page size is 1,000.
               #   @param page_token [::String]
@@ -866,6 +1057,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::Repository>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::ListRepositoriesRequest.new
+              #
+              #   # Call the list_repositories method.
+              #   result = client.list_repositories 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::ArtifactRegistry::V1::Repository.
+              #     p item
+              #   end
+              #
               def list_repositories request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -929,6 +1140,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::Repository]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::GetRepositoryRequest.new
+              #
+              #   # Call the get_repository method.
+              #   result = client.get_repository request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Repository.
+              #   p result
+              #
               def get_repository request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -984,11 +1211,12 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param parent [::String]
-              #     Required. The name of the parent resource where the repository will be created.
+              #     Required. The name of the parent resource where the repository will be
+              #     created.
               #   @param repository_id [::String]
-              #     The repository id to use for this repository.
+              #     Required. The repository id to use for this repository.
               #   @param repository [::Google::Cloud::ArtifactRegistry::V1::Repository, ::Hash]
-              #     The repository to be created.
+              #     Required. The repository to be created.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Operation]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -996,6 +1224,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::CreateRepositoryRequest.new
+              #
+              #   # Call the create_repository method.
+              #   result = client.create_repository 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_repository request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1063,6 +1314,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::Repository]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::UpdateRepositoryRequest.new
+              #
+              #   # Call the update_repository method.
+              #   result = client.update_repository request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Repository.
+              #   p result
+              #
               def update_repository request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1127,6 +1394,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::DeleteRepositoryRequest.new
+              #
+              #   # Call the delete_repository method.
+              #   result = client.delete_repository 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_repository request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1194,6 +1484,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::Package>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::ListPackagesRequest.new
+              #
+              #   # Call the list_packages method.
+              #   result = client.list_packages 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::ArtifactRegistry::V1::Package.
+              #     p item
+              #   end
+              #
               def list_packages request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1257,6 +1567,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::Package]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::GetPackageRequest.new
+              #
+              #   # Call the get_package method.
+              #   result = client.get_package request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Package.
+              #   p result
+              #
               def get_package request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1320,6 +1646,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::DeletePackageRequest.new
+              #
+              #   # Call the delete_package method.
+              #   result = client.delete_package 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_package request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1391,6 +1740,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::Version>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::ListVersionsRequest.new
+              #
+              #   # Call the list_versions method.
+              #   result = client.list_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::ArtifactRegistry::V1::Version.
+              #     p item
+              #   end
+              #
               def list_versions request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1456,6 +1825,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::Version]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::GetVersionRequest.new
+              #
+              #   # Call the get_version method.
+              #   result = client.get_version request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Version.
+              #   p result
+              #
               def get_version request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1522,6 +1907,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::DeleteVersionRequest.new
+              #
+              #   # Call the delete_version method.
+              #   result = client.delete_version 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_version request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1558,6 +1966,98 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # Deletes multiple versions across a repository. The returned operation will
+              # complete once the versions have been deleted.
+              #
+              # @overload batch_delete_versions(request, options = nil)
+              #   Pass arguments to `batch_delete_versions` via a request object, either of type
+              #   {::Google::Cloud::ArtifactRegistry::V1::BatchDeleteVersionsRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::ArtifactRegistry::V1::BatchDeleteVersionsRequest, ::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 batch_delete_versions(parent: nil, names: nil, validate_only: nil)
+              #   Pass arguments to `batch_delete_versions` 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 parent [::String]
+              #     The name of the repository holding all requested versions.
+              #   @param names [::Array<::String>]
+              #     Required. The names of the versions to delete.
+              #     A maximum of 10000 versions can be deleted in a batch.
+              #   @param validate_only [::Boolean]
+              #     If true, the request is performed without deleting data, following AIP-163.
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Gapic::Operation]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Gapic::Operation]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::BatchDeleteVersionsRequest.new
+              #
+              #   # Call the batch_delete_versions method.
+              #   result = client.batch_delete_versions 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 batch_delete_versions request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::BatchDeleteVersionsRequest
+
+                # 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
+                call_metadata = @config.rpcs.batch_delete_versions.metadata.to_h
+
+                # Set x-goog-api-client and x-goog-user-project headers
+                call_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::ArtifactRegistry::V1::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.batch_delete_versions.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.batch_delete_versions.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @artifact_registry_stub.batch_delete_versions request, options do |result, operation|
+                  result = ::Gapic::Operation.new result, @operations_client, options: options
+                  yield result, operation if block_given?
+                  return result
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
               ##
               # Lists files.
               #
@@ -1605,6 +2105,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::File>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::ListFilesRequest.new
+              #
+              #   # Call the list_files method.
+              #   result = client.list_files 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::ArtifactRegistry::V1::File.
+              #     p item
+              #   end
+              #
               def list_files request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1668,6 +2188,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::File]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::GetFileRequest.new
+              #
+              #   # Call the get_file method.
+              #   result = client.get_file request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::File.
+              #   p result
+              #
               def get_file request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1722,7 +2258,9 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param parent [::String]
-              #     The name of the parent resource whose tags will be listed.
+              #     The name of the parent package whose tags will be listed.
+              #     For example:
+              #     `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1`.
               #   @param filter [::String]
               #     An expression for filtering the results of the request. Filter rules are
               #     case insensitive. The fields eligible for filtering are:
@@ -1744,6 +2282,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::Tag>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::ListTagsRequest.new
+              #
+              #   # Call the list_tags method.
+              #   result = client.list_tags 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::ArtifactRegistry::V1::Tag.
+              #     p item
+              #   end
+              #
               def list_tags request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1807,6 +2365,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::Tag]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::GetTagRequest.new
+              #
+              #   # Call the get_tag method.
+              #   result = client.get_tag request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Tag.
+              #   p result
+              #
               def get_tag request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1873,6 +2447,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::Tag]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::CreateTagRequest.new
+              #
+              #   # Call the create_tag method.
+              #   result = client.create_tag request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Tag.
+              #   p result
+              #
               def create_tag request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1939,6 +2529,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::Tag]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::UpdateTagRequest.new
+              #
+              #   # Call the update_tag method.
+              #   result = client.update_tag request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Tag.
+              #   p result
+              #
               def update_tag request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2001,6 +2607,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::DeleteTagRequest.new
+              #
+              #   # Call the delete_tag method.
+              #   result = client.delete_tag request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_tag request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2075,6 +2697,22 @@ module Google
               # @return [::Google::Iam::V1::Policy]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Iam::V1::SetIamPolicyRequest.new
+              #
+              #   # Call the set_iam_policy method.
+              #   result = client.set_iam_policy request
+              #
+              #   # The returned object is of type Google::Iam::V1::Policy.
+              #   p result
+              #
               def set_iam_policy request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2141,6 +2779,22 @@ module Google
               # @return [::Google::Iam::V1::Policy]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Iam::V1::GetIamPolicyRequest.new
+              #
+              #   # Call the get_iam_policy method.
+              #   result = client.get_iam_policy request
+              #
+              #   # The returned object is of type Google::Iam::V1::Policy.
+              #   p result
+              #
               def get_iam_policy request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2209,6 +2863,22 @@ module Google
               # @return [::Google::Iam::V1::TestIamPermissionsResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Iam::V1::TestIamPermissionsRequest.new
+              #
+              #   # Call the test_iam_permissions method.
+              #   result = client.test_iam_permissions request
+              #
+              #   # The returned object is of type Google::Iam::V1::TestIamPermissionsResponse.
+              #   p result
+              #
               def test_iam_permissions request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2271,6 +2941,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::ProjectSettings]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::GetProjectSettingsRequest.new
+              #
+              #   # Call the get_project_settings method.
+              #   result = client.get_project_settings request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::ProjectSettings.
+              #   p result
+              #
               def get_project_settings request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2335,6 +3021,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::ProjectSettings]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::UpdateProjectSettingsRequest.new
+              #
+              #   # Call the update_project_settings method.
+              #   result = client.update_project_settings request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::ProjectSettings.
+              #   p result
+              #
               def update_project_settings request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2397,6 +3099,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::VPCSCConfig]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::GetVPCSCConfigRequest.new
+              #
+              #   # Call the get_vpcsc_config method.
+              #   result = client.get_vpcsc_config request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::VPCSCConfig.
+              #   p result
+              #
               def get_vpcsc_config request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2461,6 +3179,22 @@ module Google
               # @return [::Google::Cloud::ArtifactRegistry::V1::VPCSCConfig]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/artifact_registry/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::ArtifactRegistry::V1::UpdateVPCSCConfigRequest.new
+              #
+              #   # Call the update_vpcsc_config method.
+              #   result = client.update_vpcsc_config request
+              #
+              #   # The returned object is of type Google::Cloud::ArtifactRegistry::V1::VPCSCConfig.
+              #   p result
+              #
               def update_vpcsc_config request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2734,6 +3468,11 @@ module Google
                   #
                   attr_reader :delete_version
                   ##
+                  # RPC-specific configuration for `batch_delete_versions`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :batch_delete_versions
+                  ##
                   # RPC-specific configuration for `list_files`
                   # @return [::Gapic::Config::Method]
                   #
@@ -2848,6 +3587,8 @@ module Google
                     @get_version = ::Gapic::Config::Method.new get_version_config
                     delete_version_config = parent_rpcs.delete_version if parent_rpcs.respond_to? :delete_version
                     @delete_version = ::Gapic::Config::Method.new delete_version_config
+                    batch_delete_versions_config = parent_rpcs.batch_delete_versions if parent_rpcs.respond_to? :batch_delete_versions
+                    @batch_delete_versions = ::Gapic::Config::Method.new batch_delete_versions_config
                     list_files_config = parent_rpcs.list_files if parent_rpcs.respond_to? :list_files
                     @list_files = ::Gapic::Config::Method.new list_files_config
                     get_file_config = parent_rpcs.get_file if parent_rpcs.respond_to? :get_file