feat(grafeas): add support for upgrade notes; add cpe and `last_sca…

…n_time` to `DiscoveryOccurrence`; add `source_update_time` to `VulnerabilityNote` (via synth) (#10084)

grafeas/grafeas_v1/gapic/enums.py

@@ -47,6 +47,7 @@ class NoteKind(enum.IntEnum):
       DEPLOYMENT (int): The note and occurrence track deployment events.
       DISCOVERY (int): The note and occurrence track the initial discovery status of a resource.
       ATTESTATION (int): This represents a logical "role" that can attest to artifacts.
+      UPGRADE (int): This represents an available package upgrade.
     """
 
     NOTE_KIND_UNSPECIFIED = 0
@@ -57,6 +58,7 @@ class NoteKind(enum.IntEnum):
     DEPLOYMENT = 5
     DISCOVERY = 6
     ATTESTATION = 7
+    UPGRADE = 8
 
 
 class Severity(enum.IntEnum):

grafeas/grafeas_v1/proto/common.proto

@@ -39,6 +39,8 @@ enum NoteKind {
   DISCOVERY = 6;
   // This represents a logical "role" that can attest to artifacts.
   ATTESTATION = 7;
+  // This represents an available package upgrade.
+  UPGRADE = 8;
 }
 
 // Metadata for any related URL information.

grafeas/grafeas_v1/proto/discovery.proto

@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package grafeas.v1;
 
+import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
 import "grafeas/v1/common.proto";
 
@@ -73,4 +74,10 @@ message DiscoveryOccurrence {
   // details to show to the user. The LocalizedMessage is output only and
   // populated by the API.
   google.rpc.Status analysis_status_error = 3;
+
+  // The CPE of the resource being scanned.
+  string cpe = 4;
+
+  // The last time this resource was scanned.
+  google.protobuf.Timestamp last_scan_time = 5;
 }