module Google::Cloud::PrivateCatalog

Constants

VERSION

Public Class Methods

configure() { |configure.private_catalog| ... } click to toggle source

Configure the google-cloud-private_catalog library.

The following configuration parameters are supported:

  • `credentials` (type: `String, Hash, Google::Auth::Credentials`) - The path to the keyfile as a String, the contents of the keyfile as a Hash, or a Google::Auth::Credentials object.

  • `lib_name` (type: `String`) - The library name as recorded in instrumentation and logging.

  • `lib_version` (type: `String`) - The library version as recorded in instrumentation and logging.

  • `interceptors` (type: `Array<GRPC::ClientInterceptor>`) - An array of interceptors that are run before calls are executed.

  • `timeout` (type: `Numeric`) - Default timeout in seconds.

  • `metadata` (type: `Hash{Symbol=>String}`) - Additional gRPC headers to be sent with the call.

  • `retry_policy` (type: `Hash`) - The retry policy. The value is a hash with the following keys:

    * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
    * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
    * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
    * `:retry_codes` (*type:* `Array<String>`) -
      The error codes that should trigger a retry.

@return [::Google::Cloud::Config] The default configuration used by this library

# File lib/google/cloud/private_catalog.rb, line 125
def self.configure
  yield ::Google::Cloud.configure.private_catalog if block_given?

  ::Google::Cloud.configure.private_catalog
end
private_catalog(version: :v1beta1, &block) click to toggle source

Create a new client object for PrivateCatalog.

By default, this returns an instance of [Google::Cloud::PrivateCatalog::V1beta1::PrivateCatalog::Client](googleapis.dev/ruby/google-cloud-private_catalog-v1beta1/latest/Google/Cloud/PrivateCatalog/V1beta1/PrivateCatalog/Client.html) for version V1beta1 of the API. However, you can specify specify a different API version by passing it in the `version` parameter. If the PrivateCatalog service is supported by that API version, and the corresponding gem is available, the appropriate versioned client will be returned.

## About PrivateCatalog

`PrivateCatalog` allows catalog consumers to retrieve `Catalog`, `Product` and `Version` resources under a target resource context.

`Catalog` is computed based on the [Association][]s linked to the target resource and its ancestors. Each association's

google.cloud.privatecatalogproducer.v1beta.Catalog][

is transformed into a

`Catalog`. If multiple associations have the same parent [google.cloud.privatecatalogproducer.v1beta.Catalog][], they are de-duplicated into one `Catalog`. Users must have `cloudprivatecatalog.catalogTargets.get` IAM permission on the resource context in order to access catalogs. `Catalog` contains the resource name and a subset of data of the original [google.cloud.privatecatalogproducer.v1beta.Catalog][].

`Product` is child resource of the catalog. A `Product` contains the resource name and a subset of the data of the original [google.cloud.privatecatalogproducer.v1beta.Product][].

`Version` is child resource of the product. A `Version` contains the resource name and a subset of the data of the original [google.cloud.privatecatalogproducer.v1beta.Version][].

@param version [::String, ::Symbol] The API version to connect to. Optional.

Defaults to `:v1beta1`.

@return [PrivateCatalog::Client] A client object for the specified version.

# File lib/google/cloud/private_catalog.rb, line 86
def self.private_catalog version: :v1beta1, &block
  require "google/cloud/private_catalog/#{version.to_s.downcase}"

  package_name = Google::Cloud::PrivateCatalog
                 .constants
                 .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                 .first
  package_module = Google::Cloud::PrivateCatalog.const_get package_name
  package_module.const_get(:PrivateCatalog).const_get(:Client).new(&block)
end