docs: Clarified that event_time can also be considered as the "update time" for a Finding. It also captures when a Finding was updated. The previous wording could've been interpreted as only the creation time.

PiperOrigin-RevId: 327292977
This commit is contained in:
Google APIs 2020-08-18 13:17:43 -07:00 committed by Copybara-Service
parent 6ee9393284
commit 623a1aa03a
3 changed files with 18 additions and 11 deletions

View File

@ -101,9 +101,11 @@ message Finding {
// to the finding.
SecurityMarks security_marks = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
// The time at which the event took place. For example, if the finding
// represents an open firewall it would capture the time the detector believes
// the firewall became open. The accuracy is determined by the detector.
// The time at which the event took place, or when an update to the finding
// occurred. For example, if the finding represents an open firewall it would
// capture the time the detector believes the firewall became open. The
// accuracy is determined by the detector. If the finding were to be resolved
// afterward, this time would reflect when the finding was resolved.
google.protobuf.Timestamp event_time = 9;
// The time at which the finding was created in Security Command Center.

View File

@ -16,12 +16,12 @@ syntax = "proto3";
package google.cloud.securitycenter.v1beta1;
import "google/api/annotations.proto";
import "google/api/field_behavior.proto";
import "google/api/resource.proto";
import "google/cloud/securitycenter/v1beta1/security_marks.proto";
import "google/protobuf/struct.proto";
import "google/protobuf/timestamp.proto";
import "google/api/annotations.proto";
option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenter";
option java_multiple_files = true;
@ -58,7 +58,8 @@ message Finding {
// "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
string name = 1;
// Immutable. The relative resource name of the source the finding belongs to. See:
// Immutable. The relative resource name of the source the finding belongs to.
// See:
// https://cloud.google.com/apis/design/resource_names#relative_resource_name
// This field is immutable after creation time.
// For example:
@ -97,9 +98,11 @@ message Finding {
// to the finding.
SecurityMarks security_marks = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
// The time at which the event took place. For example, if the finding
// represents an open firewall it would capture the time the detector believes
// the firewall became open. The accuracy is determined by the detector.
// The time at which the event took place, or when an update to the finding
// occurred. For example, if the finding represents an open firewall it would
// capture the time the detector believes the firewall became open. The
// accuracy is determined by the detector. If the finding were to be resolved
// afterward, this time would reflect when the finding was resolved.
google.protobuf.Timestamp event_time = 9;
// The time at which the finding was created in Security Command Center.

View File

@ -118,9 +118,11 @@ message Finding {
// to the finding.
SecurityMarks security_marks = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
// The time at which the event took place. For example, if the finding
// represents an open firewall it would capture the time the detector believes
// the firewall became open. The accuracy is determined by the detector.
// The time at which the event took place, or when an update to the finding
// occurred. For example, if the finding represents an open firewall it would
// capture the time the detector believes the firewall became open. The
// accuracy is determined by the detector. If the finding were to be resolved
// afterward, this time would reflect when the finding was resolved.
google.protobuf.Timestamp event_time = 9;
// The time at which the finding was created in Security Command Center.