google-cloud-binary_authorization-v1beta1 0.3.5 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4268729806a969f86092e8f77a4f6c55184cafd6ff11c0394ceffbb431a27c7
-  data.tar.gz: 42f9772ebc6c51edebc9f1f8cc1f8a9d04958979fb5241fc01fd6d702215a1d2
+  metadata.gz: 7148ca7069deee5a3e40cddb609a9bbabaab15332746a023fcf31faa2fbff139
+  data.tar.gz: 30023037c857b13d326b9616678f02780e5fd39a77227c766a2aa0d4a298aefe
 SHA512:
-  metadata.gz: 486886c2dbc55d981bd34a92224671967e1c00ef0d6fe87d9cd55b1f287939e1f233d70df746e1c29d11804535463f7bd63cc93476454862d3e68c40a83cf9e5
-  data.tar.gz: d1691b4c6a13cd6b2fbff7948b5919aa14caa20885471932f1bb687b17fe4609d4c59cc00573802536e6a4ded185fa4d8459438edf73d020957d75baf373e8a5
+  metadata.gz: c8297b403d9bb70586542d462342002a5887d0e76c17ec0da5715f31d2c4ce7c78892d9a7bbc6878aa6fc5d37e23996a154f1cf960d15258e439eae5af5d4d3b
+  data.tar.gz: 3f81eeb430dddbe465382abc82116babf1b559c0a26d4d1397b04d2fcf13a07858f0dd1ded577136a8f0d569d3d61544deba104e8d0e9bae839aa85768b9986d

data/.yardopts

@@ -1,5 +1,5 @@
 --no-private
---title=Binary Authorization V1beta1 API
+--title="Binary Authorization V1beta1 API"
 --exclude _pb\.rb$
 --markup markdown
 --markup-provider redcarpet

data/AUTHENTICATION.md

@@ -120,15 +120,6 @@ To configure your system for this, simply:
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
 *should* only be used during development.
 
-[gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
-[dev-console]: https://console.cloud.google.com/project
-
-[enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
-
-[create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
-[create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
-[reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
-
 ## Creating a Service Account
 
 Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
 [Google Cloud Platform environments](#google-cloud-platform-environments), you
 need a Google Developers service account.
 
-1. Visit the [Google Developers Console][dev-console].
+1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
 2. Create a new project or click on an existing project.
-3. Activate the slide-out navigation tray and select **API Manager**. From
+3. Activate the menu in the upper left and select **APIs & Services**. From
    here, you will enable the APIs that your application requires.
 
-   ![Enable the APIs that your application requires][enable-apis]
-
    *Note: You may need to enable billing in order to use these services.*
 
 4. Select **Credentials** from the side navigation.
 
-   You should see a screen like one of the following.
-
-   ![Create a new service account][create-new-service-account]
-
-   ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
-
-   Find the "Add credentials" drop down and select "Service account" to be
-   guided through downloading a new JSON key file.
+   Find the "Create credentials" drop down near the top of the page, and select
+   "Service account" to be guided through downloading a new JSON key file.
 
    If you want to re-use an existing service account, you can easily generate a
-   new key file. Just select the account you wish to re-use, and click "Generate
-   new JSON key":
-
-   ![Re-use an existing service account][reuse-service-account]
+   new key file. Just select the account you wish to re-use, click the pencil
+   tool on the right side to edit the service account, select the **Keys** tab,
+   and then select **Add Key**.
 
    The key file you download will be used by this library to authenticate API
    requests and should be stored in a secure location.

data/README.md

@@ -37,7 +37,7 @@ request = ::Google::Cloud::BinaryAuthorization::V1beta1::GetPolicyRequest.new #
 response = client.get_policy request
 ```
 
-View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-binary_authorization-v1beta1/latest)
+View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-binary_authorization-v1beta1/latest)
 for class and method documentation.
 
 See also the [Product Documentation](https://cloud.google.com/binary-authorization/)
@@ -69,6 +69,11 @@ module GRPC
 end
 ```
 
+
+## Google Cloud Samples
+
+To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
+
 ## Supported Ruby Versions
 
 This library is supported on Ruby 2.5+.

data/lib/google/cloud/binary_authorization/v1beta1/binauthz_management_service/client.rb

@@ -183,16 +183,13 @@ module Google
             # Service calls
 
             ##
-            # A {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} specifies the
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors} that must
-            # attest to a container image, before the project is allowed to deploy that
+            # A {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} specifies the {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors} that must attest to
+            # a container image, before the project is allowed to deploy that
             # image. There is at most one policy per project. All image admission
             # requests are permitted if a project has no policy.
             #
-            # Gets the {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} for this
-            # project. Returns a default
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} if the project
-            # does not have one.
+            # Gets the {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} for this project. Returns a default
+            # {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} if the project does not have one.
             #
             # @overload get_policy(request, options = nil)
             #   Pass arguments to `get_policy` via a request object, either of type
@@ -210,9 +207,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The resource name of the
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} to retrieve, in
-            #     the format `projects/*/policy`.
+            #     Required. The resource name of the {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} to retrieve,
+            #     in the format `projects/*/policy`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::BinaryAuthorization::V1beta1::Policy]
@@ -279,13 +275,11 @@ module Google
             end
 
             ##
-            # Creates or updates a project's
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy}, and returns a
-            # copy of the new {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy}.
-            # A policy is always updated as a whole, to avoid race conditions with
-            # concurrent policy enforcement (or management!) requests. Returns NOT_FOUND
-            # if the project does not exist, INVALID_ARGUMENT if the request is
-            # malformed.
+            # Creates or updates a project's {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy}, and returns a copy of the
+            # new {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy}. A policy is always updated as a whole, to avoid race
+            # conditions with concurrent policy enforcement (or management!)
+            # requests. Returns NOT_FOUND if the project does not exist, INVALID_ARGUMENT
+            # if the request is malformed.
             #
             # @overload update_policy(request, options = nil)
             #   Pass arguments to `update_policy` via a request object, either of type
@@ -303,11 +297,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param policy [::Google::Cloud::BinaryAuthorization::V1beta1::Policy, ::Hash]
-            #     Required. A new or updated
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} value. The
-            #     service will overwrite the [policy
-            #     name][google.cloud.binaryauthorization.v1beta1.Policy.name] field with the
-            #     resource name in the request URL, in the format `projects/*/policy`.
+            #     Required. A new or updated {::Google::Cloud::BinaryAuthorization::V1beta1::Policy policy} value. The service will
+            #     overwrite the {::Google::Cloud::BinaryAuthorization::V1beta1::Policy#name policy name} field with the resource name in
+            #     the request URL, in the format `projects/*/policy`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::BinaryAuthorization::V1beta1::Policy]
@@ -374,13 +366,10 @@ module Google
             end
 
             ##
-            # Creates an {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor},
-            # and returns a copy of the new
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}. Returns
-            # NOT_FOUND if the project does not exist, INVALID_ARGUMENT if the request is
-            # malformed, ALREADY_EXISTS if the
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} already
-            # exists.
+            # Creates an {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}, and returns a copy of the new
+            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}. Returns NOT_FOUND if the project does not exist,
+            # INVALID_ARGUMENT if the request is malformed, ALREADY_EXISTS if the
+            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} already exists.
             #
             # @overload create_attestor(request, options = nil)
             #   Pass arguments to `create_attestor` via a request object, either of type
@@ -398,17 +387,13 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent of this
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}.
+            #     Required. The parent of this {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}.
             #   @param attestor_id [::String]
-            #     Required. The
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors} ID.
+            #     Required. The {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors} ID.
             #   @param attestor [::Google::Cloud::BinaryAuthorization::V1beta1::Attestor, ::Hash]
-            #     Required. The initial
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} value. The
-            #     service will overwrite the [attestor
-            #     name][google.cloud.binaryauthorization.v1beta1.Attestor.name] field with
-            #     the resource name, in the format `projects/*/attestors/*`.
+            #     Required. The initial {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} value. The service will
+            #     overwrite the {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor#name attestor name} field with the resource name,
+            #     in the format `projects/*/attestors/*`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::BinaryAuthorization::V1beta1::Attestor]
@@ -476,9 +461,7 @@ module Google
 
             ##
             # Gets an {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}.
-            # Returns NOT_FOUND if the
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} does not
-            # exist.
+            # Returns NOT_FOUND if the {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} does not exist.
             #
             # @overload get_attestor(request, options = nil)
             #   Pass arguments to `get_attestor` via a request object, either of type
@@ -496,9 +479,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} to retrieve,
-            #     in the format `projects/*/attestors/*`.
+            #     Required. The name of the {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} to retrieve, in the format
+            #     `projects/*/attestors/*`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::BinaryAuthorization::V1beta1::Attestor]
@@ -566,9 +548,7 @@ module Google
 
             ##
             # Updates an {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}.
-            # Returns NOT_FOUND if the
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} does not
-            # exist.
+            # Returns NOT_FOUND if the {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} does not exist.
             #
             # @overload update_attestor(request, options = nil)
             #   Pass arguments to `update_attestor` via a request object, either of type
@@ -586,12 +566,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param attestor [::Google::Cloud::BinaryAuthorization::V1beta1::Attestor, ::Hash]
-            #     Required. The updated
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} value. The
-            #     service will overwrite the [attestor
-            #     name][google.cloud.binaryauthorization.v1beta1.Attestor.name] field with
-            #     the resource name in the request URL, in the format
-            #     `projects/*/attestors/*`.
+            #     Required. The updated {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} value. The service will
+            #     overwrite the {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor#name attestor name} field with the resource name
+            #     in the request URL, in the format `projects/*/attestors/*`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::BinaryAuthorization::V1beta1::Attestor]
@@ -678,16 +655,14 @@ module Google
             #
             #   @param parent [::String]
             #     Required. The resource name of the project associated with the
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors}, in the
-            #     format `projects/*`.
+            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors}, in the format `projects/*`.
             #   @param page_size [::Integer]
             #     Requested page size. The server may return fewer results than requested. If
             #     unspecified, the server will pick an appropriate default.
             #   @param page_token [::String]
             #     A token identifying a page of results the server should return. Typically,
-            #     this is the value of
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::ListAttestorsResponse#next_page_token ListAttestorsResponse.next_page_token}
-            #     returned from the previous call to the `ListAttestors` method.
+            #     this is the value of {::Google::Cloud::BinaryAuthorization::V1beta1::ListAttestorsResponse#next_page_token ListAttestorsResponse.next_page_token} returned
+            #     from the previous call to the `ListAttestors` method.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::BinaryAuthorization::V1beta1::Attestor>]
@@ -761,10 +736,8 @@ module Google
             end
 
             ##
-            # Deletes an {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}.
-            # Returns NOT_FOUND if the
-            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} does not
-            # exist.
+            # Deletes an {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor}. Returns NOT_FOUND if the
+            # {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestor} does not exist.
             #
             # @overload delete_attestor(request, options = nil)
             #   Pass arguments to `delete_attestor` via a request object, either of type
@@ -782,9 +755,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the
-            #     {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors} to delete,
-            #     in the format `projects/*/attestors/*`.
+            #     Required. The name of the {::Google::Cloud::BinaryAuthorization::V1beta1::Attestor attestors} to delete, in the format
+            #     `projects/*/attestors/*`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]

data/lib/google/cloud/binary_authorization/v1beta1/binauthz_management_service/paths.rb

@@ -44,15 +44,34 @@ module Google
             ##
             # Create a fully-qualified Policy resource string.
             #
-            # The resource will be in the following format:
+            # @overload policy_path(project:)
+            #   The resource will be in the following format:
             #
-            # `projects/{project}/policy`
+            #   `projects/{project}/policy`
             #
-            # @param project [String]
+            #   @param project [String]
+            #
+            # @overload policy_path(location:)
+            #   The resource will be in the following format:
+            #
+            #   `locations/{location}/policy`
+            #
+            #   @param location [String]
             #
             # @return [::String]
-            def policy_path project:
-              "projects/#{project}/policy"
+            def policy_path **args
+              resources = {
+                "project" => (proc do |project:|
+                  "projects/#{project}/policy"
+                end),
+                "location" => (proc do |location:|
+                  "locations/#{location}/policy"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
             end
 
             ##