google-cloud-container_analysis-v1 0.4.4 → 0.4.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1f8afc0d3be6b4284eabb7b63b62e0ae10c18894b71d4d731b495146c269134
-  data.tar.gz: ef5cead8f55549b4950de7b3b8b0bc5a43c7118bad3df6df0bc3964901f4f601
+  metadata.gz: be9ac413a65fb2d2902d17aa3d7fb3b79252e886a04f1922297bdf1305f4c937
+  data.tar.gz: f9b4ee77ddf95ec53cc4502e049c74b1e2cc8ddc47880f452a23c533b2fca683
 SHA512:
-  metadata.gz: e1b7ab826422575e41651cd3bec6aa03761e2ef3ff8f2e532472df3aadcf435c0f9d2d052f52105450cf99f7c5066e73cc03ce5abf96b787b69022381b8c7d70
-  data.tar.gz: 0ce4d300be9bfb5f8f7c845c01dcb0e319b55f18cedbadaa61c5016298e62dbb9371d407064c66b39d8b8c954288781aa670adee55e238e9c009397f0b9460e7
+  metadata.gz: 59de44caff6a18ddac82540215a170eec07eda61360af7f9df94f5a341439e78bced9e8397b79a8bf46bff6df0e885257505e1cef7d85d66590251804cf5c4cf
+  data.tar.gz: 59999236822cb8b9b34358f0c3c244690d3c4dc59d22fa99eb4799ef01c673875cbf4205b8c4d060eb22fb4a1db384e489f29958c31915f384ba689f0d378896

data/lib/google/cloud/container_analysis/v1/container_analysis/client.rb

@@ -204,6 +204,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/container_analysis/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ContainerAnalysis::V1::ContainerAnalysis::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?
 
@@ -221,9 +236,11 @@ module Google
                 gapic_version: ::Google::Cloud::ContainerAnalysis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "resource" => request.resource
-              }
+              header_params = {}
+              if request.resource
+                header_params["resource"] = request.resource
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -283,6 +300,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/container_analysis/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ContainerAnalysis::V1::ContainerAnalysis::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?
 
@@ -300,9 +332,11 @@ module Google
                 gapic_version: ::Google::Cloud::ContainerAnalysis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "resource" => request.resource
-              }
+              header_params = {}
+              if request.resource
+                header_params["resource"] = request.resource
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -363,6 +397,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/container_analysis/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ContainerAnalysis::V1::ContainerAnalysis::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?
 
@@ -380,9 +429,11 @@ module Google
                 gapic_version: ::Google::Cloud::ContainerAnalysis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "resource" => request.resource
-              }
+              header_params = {}
+              if request.resource
+                header_params["resource"] = request.resource
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -434,6 +485,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/container_analysis/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::ContainerAnalysis::V1::ContainerAnalysis::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::ContainerAnalysis::V1::GetVulnerabilityOccurrencesSummaryRequest.new
+            #
+            #   # Call the get_vulnerability_occurrences_summary method.
+            #   result = client.get_vulnerability_occurrences_summary request
+            #
+            #   # The returned object is of type Google::Cloud::ContainerAnalysis::V1::VulnerabilityOccurrencesSummary.
+            #   p result
+            #
             def get_vulnerability_occurrences_summary request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -451,9 +517,11 @@ module Google
                 gapic_version: ::Google::Cloud::ContainerAnalysis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module ContainerAnalysis
       module V1
-        VERSION = "0.4.4"
+        VERSION = "0.4.5"
       end
     end
   end

data/lib/google/devtools/containeranalysis/v1/containeranalysis_pb.rb

@@ -1,8 +1,6 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/devtools/containeranalysis/v1/containeranalysis.proto
 
-require 'google/protobuf'
-
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
@@ -11,6 +9,8 @@ require 'google/iam/v1/iam_policy_pb'
 require 'google/iam/v1/policy_pb'
 require 'google/protobuf/timestamp_pb'
 require 'grafeas/v1/vulnerability_pb'
+require 'google/protobuf'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/devtools/containeranalysis/v1/containeranalysis.proto", :syntax => :proto3) do
     add_message "google.devtools.containeranalysis.v1.GetVulnerabilityOccurrencesSummaryRequest" do

data/proto_docs/grafeas/v1/common.rb

@@ -65,7 +65,7 @@ module Grafeas
     #   @return [::String]
     #     The identifier for the public key that verifies this signature.
     #       * The `public_key_id` is required.
-    #       * The `public_key_id` MUST be an RFC3986 conformant URI.
+    #       * The `public_key_id` SHOULD be an RFC3986 conformant URI.
     #       * When possible, the `public_key_id` SHOULD be an immutable reference,
     #         such as a cryptographic digest.
     #
@@ -85,9 +85,32 @@ module Grafeas
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
+    # MUST match
+    # https://github.com/secure-systems-lab/dsse/blob/master/envelope.proto. An
+    # authenticated message of arbitrary type.
+    # @!attribute [rw] payload
+    #   @return [::String]
+    # @!attribute [rw] payload_type
+    #   @return [::String]
+    # @!attribute [rw] signatures
+    #   @return [::Array<::Grafeas::V1::EnvelopeSignature>]
+    class Envelope
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # @!attribute [rw] sig
+    #   @return [::String]
+    # @!attribute [rw] keyid
+    #   @return [::String]
+    class EnvelopeSignature
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
     # Kind represents the kinds of notes supported.
     module NoteKind
-      # Unknown.
+      # Default value. This value is unused.
       NOTE_KIND_UNSPECIFIED = 0
 
       # The note and occurrence represent a package vulnerability.
@@ -113,6 +136,12 @@ module Grafeas
 
       # This represents an available package upgrade.
       UPGRADE = 8
+
+      # This represents a Compliance Note
+      COMPLIANCE = 9
+
+      # This represents a DSSE attestation Note
+      DSSE_ATTESTATION = 10
     end
   end
 end

data/proto_docs/grafeas/v1/package.rb

@@ -101,6 +101,14 @@ module Grafeas
     # @!attribute [rw] revision
     #   @return [::String]
     #     The iteration of the package build from the above version.
+    # @!attribute [rw] inclusive
+    #   @return [::Boolean]
+    #     Whether this version is specifying part of an inclusive range. Grafeas
+    #     does not have the capability to specify version ranges; instead we have
+    #     fields that specify start version and end versions. At times this is
+    #     insufficient - we also need to specify whether the version is included in
+    #     the range or is excluded from the range. This boolean is expected to be set
+    #     to true when the version is included in a range.
     # @!attribute [rw] kind
     #   @return [::Grafeas::V1::Version::VersionKind]
     #     Required. Distinguishes between sentinel MIN/MAX versions and normal

data/proto_docs/grafeas/v1/vulnerability.rb

@@ -109,6 +109,12 @@ module Grafeas
       #     The time this information was last changed at the source. This is an
       #     upstream timestamp from the underlying information source - e.g. Ubuntu
       #     security tracker.
+      # @!attribute [rw] source
+      #   @return [::String]
+      #     The source from which the information in this Detail was obtained.
+      # @!attribute [rw] vendor
+      #   @return [::String]
+      #     The name of the vendor of the product.
       class Detail
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -161,6 +167,9 @@ module Grafeas
     #     Output only. The CVSS score of this vulnerability. CVSS score is on a
     #     scale of 0 - 10 where 0 indicates low severity and 10 indicates high
     #     severity.
+    # @!attribute [rw] cvssv3
+    #   @return [::Grafeas::V1::VulnerabilityOccurrence::CVSSV3]
+    #     The cvss v3 score for the vulnerability.
     # @!attribute [rw] package_issue
     #   @return [::Array<::Grafeas::V1::VulnerabilityOccurrence::PackageIssue>]
     #     Required. The set of affected locations and their fixes (if available)
@@ -178,6 +187,14 @@ module Grafeas
     #   @return [::Grafeas::V1::Severity]
     #     The distro assigned severity for this vulnerability when it is available,
     #     otherwise this is the note provider assigned severity.
+    #
+    #     When there are multiple PackageIssues for this vulnerability, they can have
+    #     different effective severities because some might be provided by the distro
+    #     while others are provided by the language ecosystem for a language pack.
+    #     For this reason, it is advised to use the effective severity on the
+    #     PackageIssue level. In the case where multiple PackageIssues have differing
+    #     effective severities, this field should be the highest severity for any of
+    #     the PackageIssues.
     # @!attribute [rw] fix_available
     #   @return [::Boolean]
     #     Output only. Whether at least one of the affected packages has a fix
@@ -186,6 +203,19 @@ module Grafeas
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
 
+      # The CVSS v3 score for this vulnerability.
+      # @!attribute [rw] base_score
+      #   @return [::Float]
+      #     The base score for for this vulnerability according to cvss v3.
+      # @!attribute [rw] severity
+      #   @return [::Grafeas::V1::Severity]
+      #     The severity rating assigned to this vulnerability by vulnerability
+      #     provider.
+      class CVSSV3
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
       # A detail for a distro and package this vulnerability occurrence was found
       # in and its associated fix (if one is available).
       # @!attribute [rw] affected_cpe_uri
@@ -215,6 +245,14 @@ module Grafeas
       # @!attribute [rw] fix_available
       #   @return [::Boolean]
       #     Output only. Whether a fix is available for this package.
+      # @!attribute [rw] package_type
+      #   @return [::String]
+      #     The type of package (e.g. OS, MAVEN, GO).
+      # @!attribute [r] effective_severity
+      #   @return [::Grafeas::V1::Severity]
+      #     The distro or language system assigned severity for this vulnerability
+      #     when that is available and note provider assigned severity when it is not
+      #     available.
       class PackageIssue
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-container_analysis-v1
 version: !ruby/object:Gem::Version
-  version: 0.4.4
+  version: 0.4.5
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-22 00:00:00.000000000 Z
+date: 2021-11-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common