1// Copyright 2023 Google LLC
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15syntax = "proto3";
16
17package google.cloud.aiplatform.v1beta1;
18
19import "google/api/field_behavior.proto";
20import "google/api/resource.proto";
21import "google/protobuf/timestamp.proto";
22
23option csharp_namespace = "Google.Cloud.AIPlatform.V1Beta1";
24option go_package = "cloud.google.com/go/aiplatform/apiv1beta1/aiplatformpb;aiplatformpb";
25option java_multiple_files = true;
26option java_outer_classname = "EventProto";
27option java_package = "com.google.cloud.aiplatform.v1beta1";
28option php_namespace = "Google\\Cloud\\AIPlatform\\V1beta1";
29option ruby_package = "Google::Cloud::AIPlatform::V1beta1";
30
31// An edge describing the relationship between an Artifact and an Execution in
32// a lineage graph.
33message Event {
34  // Describes whether an Event's Artifact is the Execution's input or output.
35  enum Type {
36    // Unspecified whether input or output of the Execution.
37    TYPE_UNSPECIFIED = 0;
38
39    // An input of the Execution.
40    INPUT = 1;
41
42    // An output of the Execution.
43    OUTPUT = 2;
44  }
45
46  // Required. The relative resource name of the Artifact in the Event.
47  string artifact = 1 [
48    (google.api.field_behavior) = REQUIRED,
49    (google.api.resource_reference) = {
50      type: "aiplatform.googleapis.com/Artifact"
51    }
52  ];
53
54  // Output only. The relative resource name of the Execution in the Event.
55  string execution = 2 [
56    (google.api.field_behavior) = OUTPUT_ONLY,
57    (google.api.resource_reference) = {
58      type: "aiplatform.googleapis.com/Execution"
59    }
60  ];
61
62  // Output only. Time the Event occurred.
63  google.protobuf.Timestamp event_time = 3
64      [(google.api.field_behavior) = OUTPUT_ONLY];
65
66  // Required. The type of the Event.
67  Type type = 4 [(google.api.field_behavior) = REQUIRED];
68
69  // The labels with user-defined metadata to annotate Events.
70  //
71  // Label keys and values can be no longer than 64 characters
72  // (Unicode codepoints), can only contain lowercase letters, numeric
73  // characters, underscores and dashes. International characters are allowed.
74  // No more than 64 user labels can be associated with one Event (System
75  // labels are excluded).
76  //
77  // See https://goo.gl/xmQnxf for more information and examples of labels.
78  // System reserved label keys are prefixed with "aiplatform.googleapis.com/"
79  // and are immutable.
80  map<string, string> labels = 5;
81}
82