xref: /aosp_15_r20/external/googleapis/google/actions/sdk/v2/version.proto (revision d5c09012810ac0c9f33fe448fb6da8260d444cc9) 
1// Copyright 2020 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.actions.sdk.v2;
18
19import "google/api/resource.proto";
20import "google/protobuf/timestamp.proto";
21
22option go_package = "google.golang.org/genproto/googleapis/actions/sdk/v2;sdk";
23option java_multiple_files = true;
24option java_outer_classname = "VersionProto";
25option java_package = "com.google.actions.sdk.v2";
26
27// Definition of version resource.
28message Version {
29  option (google.api.resource) = {
30    type: "actions.googleapis.com/Version"
31    pattern: "projects/{project}/versions/{version}"
32  };
33
34  // Represents the current state of the version.
35  message VersionState {
36    // Enum indicating the states that a Version can take. This enum is not yet
37    // frozen and values maybe added later.
38    enum State {
39      // Default value of State.
40      STATE_UNSPECIFIED = 0;
41
42      // The version creation is in progress.
43      CREATION_IN_PROGRESS = 1;
44
45      // The version creation failed.
46      CREATION_FAILED = 2;
47
48      // The version has been successfully created.
49      CREATED = 3;
50
51      // The version is under policy review (aka Approval).
52      REVIEW_IN_PROGRESS = 4;
53
54      // The version has been approved for policy review and can be deployed.
55      APPROVED = 5;
56
57      // The version has been conditionally approved but is pending final
58      // review. It may be rolled back if final review is denied.
59      CONDITIONALLY_APPROVED = 6;
60
61      // The version has been denied for policy review.
62      DENIED = 7;
63
64      // The version is taken down as entire agent and all versions are taken
65      // down.
66      UNDER_TAKEDOWN = 8;
67
68      // The version has been deleted.
69      DELETED = 9;
70    }
71
72    // The current state of the version.
73    State state = 1;
74
75    // User-friendly message for the current state of the version.
76    string message = 2;
77  }
78
79  // The unique identifier of the version in the following format.
80  // `projects/{project}/versions/{version}`.
81  string name = 1;
82
83  // The current state of the version.
84  VersionState version_state = 2;
85
86  // Email of the user who created this version.
87  string creator = 3;
88
89  // Timestamp of the last change to this version.
90  google.protobuf.Timestamp update_time = 4;
91}
92