service.proto 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596
  1. // Copyright 2021 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. syntax = "proto3";
  15. package google.cloud.gkehub.v1;
  16. import "google/api/annotations.proto";
  17. import "google/api/client.proto";
  18. import "google/api/field_behavior.proto";
  19. import "google/api/resource.proto";
  20. import "google/cloud/gkehub/v1/feature.proto";
  21. import "google/cloud/gkehub/v1/membership.proto";
  22. import "google/longrunning/operations.proto";
  23. import "google/protobuf/field_mask.proto";
  24. import "google/protobuf/timestamp.proto";
  25. option csharp_namespace = "Google.Cloud.GkeHub.V1";
  26. option go_package = "google.golang.org/genproto/googleapis/cloud/gkehub/v1;gkehub";
  27. option java_multiple_files = true;
  28. option java_outer_classname = "ServiceProto";
  29. option java_package = "com.google.cloud.gkehub.v1";
  30. option php_namespace = "Google\\Cloud\\GkeHub\\V1";
  31. option ruby_package = "Google::Cloud::GkeHub::V1";
  32. // The GKE Hub service handles the registration of many Kubernetes clusters to
  33. // Google Cloud, and the management of multi-cluster features over those
  34. // clusters.
  35. //
  36. // The GKE Hub service operates on the following resources:
  37. //
  38. // * [Membership][google.cloud.gkehub.v1.Membership]
  39. // * [Feature][google.cloud.gkehub.v1.Feature]
  40. //
  41. // GKE Hub is currently only available in the global region.
  42. //
  43. // **Membership management may be non-trivial:** it is recommended to use one
  44. // of the Google-provided client libraries or tools where possible when working
  45. // with Membership resources.
  46. service GkeHub {
  47. option (google.api.default_host) = "gkehub.googleapis.com";
  48. option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
  49. // Lists Memberships in a given project and location.
  50. rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse) {
  51. option (google.api.http) = {
  52. get: "/v1/{parent=projects/*/locations/*}/memberships"
  53. };
  54. option (google.api.method_signature) = "parent";
  55. }
  56. // Lists Features in a given project and location.
  57. rpc ListFeatures(ListFeaturesRequest) returns (ListFeaturesResponse) {
  58. option (google.api.http) = {
  59. get: "/v1/{parent=projects/*/locations/*}/features"
  60. };
  61. option (google.api.method_signature) = "parent";
  62. }
  63. // Gets the details of a Membership.
  64. rpc GetMembership(GetMembershipRequest) returns (Membership) {
  65. option (google.api.http) = {
  66. get: "/v1/{name=projects/*/locations/*/memberships/*}"
  67. };
  68. option (google.api.method_signature) = "name";
  69. }
  70. // Gets details of a single Feature.
  71. rpc GetFeature(GetFeatureRequest) returns (Feature) {
  72. option (google.api.http) = {
  73. get: "/v1/{name=projects/*/locations/*/features/*}"
  74. };
  75. option (google.api.method_signature) = "name";
  76. }
  77. // Creates a new Membership.
  78. //
  79. // **This is currently only supported for GKE clusters on Google Cloud**.
  80. // To register other clusters, follow the instructions at
  81. // https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster.
  82. rpc CreateMembership(CreateMembershipRequest) returns (google.longrunning.Operation) {
  83. option (google.api.http) = {
  84. post: "/v1/{parent=projects/*/locations/*}/memberships"
  85. body: "resource"
  86. };
  87. option (google.api.method_signature) = "parent,resource,membership_id";
  88. option (google.longrunning.operation_info) = {
  89. response_type: "Membership"
  90. metadata_type: "OperationMetadata"
  91. };
  92. }
  93. // Adds a new Feature.
  94. rpc CreateFeature(CreateFeatureRequest) returns (google.longrunning.Operation) {
  95. option (google.api.http) = {
  96. post: "/v1/{parent=projects/*/locations/*}/features"
  97. body: "resource"
  98. };
  99. option (google.api.method_signature) = "parent,resource,feature_id";
  100. option (google.longrunning.operation_info) = {
  101. response_type: "Feature"
  102. metadata_type: "OperationMetadata"
  103. };
  104. }
  105. // Removes a Membership.
  106. //
  107. // **This is currently only supported for GKE clusters on Google Cloud**.
  108. // To unregister other clusters, follow the instructions at
  109. // https://cloud.google.com/anthos/multicluster-management/connect/unregistering-a-cluster.
  110. rpc DeleteMembership(DeleteMembershipRequest) returns (google.longrunning.Operation) {
  111. option (google.api.http) = {
  112. delete: "/v1/{name=projects/*/locations/*/memberships/*}"
  113. };
  114. option (google.api.method_signature) = "name";
  115. option (google.longrunning.operation_info) = {
  116. response_type: "google.protobuf.Empty"
  117. metadata_type: "OperationMetadata"
  118. };
  119. }
  120. // Removes a Feature.
  121. rpc DeleteFeature(DeleteFeatureRequest) returns (google.longrunning.Operation) {
  122. option (google.api.http) = {
  123. delete: "/v1/{name=projects/*/locations/*/features/*}"
  124. };
  125. option (google.api.method_signature) = "name";
  126. option (google.longrunning.operation_info) = {
  127. response_type: "google.protobuf.Empty"
  128. metadata_type: "OperationMetadata"
  129. };
  130. }
  131. // Updates an existing Membership.
  132. rpc UpdateMembership(UpdateMembershipRequest) returns (google.longrunning.Operation) {
  133. option (google.api.http) = {
  134. patch: "/v1/{name=projects/*/locations/*/memberships/*}"
  135. body: "resource"
  136. };
  137. option (google.api.method_signature) = "name,resource,update_mask";
  138. option (google.longrunning.operation_info) = {
  139. response_type: "Membership"
  140. metadata_type: "OperationMetadata"
  141. };
  142. }
  143. // Updates an existing Feature.
  144. rpc UpdateFeature(UpdateFeatureRequest) returns (google.longrunning.Operation) {
  145. option (google.api.http) = {
  146. patch: "/v1/{name=projects/*/locations/*/features/*}"
  147. body: "resource"
  148. };
  149. option (google.api.method_signature) = "name,resource,update_mask";
  150. option (google.longrunning.operation_info) = {
  151. response_type: "Feature"
  152. metadata_type: "OperationMetadata"
  153. };
  154. }
  155. // Generates the manifest for deployment of the GKE connect agent.
  156. //
  157. // **This method is used internally by Google-provided libraries.**
  158. // Most clients should not need to call this method directly.
  159. rpc GenerateConnectManifest(GenerateConnectManifestRequest) returns (GenerateConnectManifestResponse) {
  160. option (google.api.http) = {
  161. get: "/v1/{name=projects/*/locations/*/memberships/*}:generateConnectManifest"
  162. };
  163. }
  164. }
  165. // Request message for `GkeHub.ListMemberships` method.
  166. message ListMembershipsRequest {
  167. // Required. The parent (project and location) where the Memberships will be listed.
  168. // Specified in the format `projects/*/locations/*`.
  169. string parent = 1 [
  170. (google.api.field_behavior) = REQUIRED,
  171. (google.api.resource_reference) = {
  172. child_type: "gkehub.googleapis.com/Membership"
  173. }
  174. ];
  175. // Optional. When requesting a 'page' of resources, `page_size` specifies number of
  176. // resources to return. If unspecified or set to 0, all resources will
  177. // be returned.
  178. int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
  179. // Optional. Token returned by previous call to `ListMemberships` which
  180. // specifies the position in the list from where to continue listing the
  181. // resources.
  182. string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
  183. // Optional. Lists Memberships that match the filter expression, following the syntax
  184. // outlined in https://google.aip.dev/160.
  185. //
  186. // Examples:
  187. //
  188. // - Name is `bar` in project `foo-proj` and location `global`:
  189. //
  190. // name = "projects/foo-proj/locations/global/membership/bar"
  191. //
  192. // - Memberships that have a label called `foo`:
  193. //
  194. // labels.foo:*
  195. //
  196. // - Memberships that have a label called `foo` whose value is `bar`:
  197. //
  198. // labels.foo = bar
  199. //
  200. // - Memberships in the CREATING state:
  201. //
  202. // state = CREATING
  203. string filter = 4 [(google.api.field_behavior) = OPTIONAL];
  204. // Optional. One or more fields to compare and use to sort the output.
  205. // See https://google.aip.dev/132#ordering.
  206. string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
  207. }
  208. // Response message for the `GkeHub.ListMemberships` method.
  209. message ListMembershipsResponse {
  210. // The list of matching Memberships.
  211. repeated Membership resources = 1;
  212. // A token to request the next page of resources from the
  213. // `ListMemberships` method. The value of an empty string means that
  214. // there are no more resources to return.
  215. string next_page_token = 2;
  216. // List of locations that could not be reached while fetching this list.
  217. repeated string unreachable = 3;
  218. }
  219. // Request message for `GkeHub.GetMembership` method.
  220. message GetMembershipRequest {
  221. // Required. The Membership resource name in the format
  222. // `projects/*/locations/*/memberships/*`.
  223. string name = 1 [
  224. (google.api.field_behavior) = REQUIRED,
  225. (google.api.resource_reference) = {
  226. type: "gkehub.googleapis.com/Membership"
  227. }
  228. ];
  229. }
  230. // Request message for the `GkeHub.CreateMembership` method.
  231. message CreateMembershipRequest {
  232. // Required. The parent (project and location) where the Memberships will be created.
  233. // Specified in the format `projects/*/locations/*`.
  234. string parent = 1 [
  235. (google.api.field_behavior) = REQUIRED,
  236. (google.api.resource_reference) = {
  237. child_type: "gkehub.googleapis.com/Membership"
  238. }
  239. ];
  240. // Required. Client chosen ID for the membership. `membership_id` must be a valid RFC
  241. // 1123 compliant DNS label:
  242. //
  243. // 1. At most 63 characters in length
  244. // 2. It must consist of lower case alphanumeric characters or `-`
  245. // 3. It must start and end with an alphanumeric character
  246. //
  247. // Which can be expressed as the regex: `[a-z0-9]([-a-z0-9]*[a-z0-9])?`,
  248. // with a maximum length of 63 characters.
  249. string membership_id = 2 [(google.api.field_behavior) = REQUIRED];
  250. // Required. The membership to create.
  251. Membership resource = 3 [(google.api.field_behavior) = REQUIRED];
  252. // Optional. A request ID to identify requests. Specify a unique request ID
  253. // so that if you must retry your request, the server will know to ignore
  254. // the request if it has already been completed. The server will guarantee
  255. // that for at least 60 minutes after the first request.
  256. //
  257. // For example, consider a situation where you make an initial request and
  258. // the request times out. If you make the request again with the same request
  259. // ID, the server can check if original operation with the same request ID
  260. // was received, and if so, will ignore the second request. This prevents
  261. // clients from accidentally creating duplicate commitments.
  262. //
  263. // The request ID must be a valid UUID with the exception that zero UUID is
  264. // not supported (00000000-0000-0000-0000-000000000000).
  265. string request_id = 4 [(google.api.field_behavior) = OPTIONAL];
  266. }
  267. // Request message for `GkeHub.DeleteMembership` method.
  268. message DeleteMembershipRequest {
  269. // Required. The Membership resource name in the format
  270. // `projects/*/locations/*/memberships/*`.
  271. string name = 1 [
  272. (google.api.field_behavior) = REQUIRED,
  273. (google.api.resource_reference) = {
  274. type: "gkehub.googleapis.com/Membership"
  275. }
  276. ];
  277. // Optional. A request ID to identify requests. Specify a unique request ID
  278. // so that if you must retry your request, the server will know to ignore
  279. // the request if it has already been completed. The server will guarantee
  280. // that for at least 60 minutes after the first request.
  281. //
  282. // For example, consider a situation where you make an initial request and
  283. // the request times out. If you make the request again with the same request
  284. // ID, the server can check if original operation with the same request ID
  285. // was received, and if so, will ignore the second request. This prevents
  286. // clients from accidentally creating duplicate commitments.
  287. //
  288. // The request ID must be a valid UUID with the exception that zero UUID is
  289. // not supported (00000000-0000-0000-0000-000000000000).
  290. string request_id = 2 [(google.api.field_behavior) = OPTIONAL];
  291. }
  292. // Request message for `GkeHub.UpdateMembership` method.
  293. message UpdateMembershipRequest {
  294. // Required. The Membership resource name in the format
  295. // `projects/*/locations/*/memberships/*`.
  296. string name = 1 [(google.api.field_behavior) = REQUIRED];
  297. // Required. Mask of fields to update.
  298. google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
  299. // Required. Only fields specified in update_mask are updated.
  300. // If you specify a field in the update_mask but don't specify its value here
  301. // that field will be deleted.
  302. // If you are updating a map field, set the value of a key to null or empty
  303. // string to delete the key from the map. It's not possible to update a key's
  304. // value to the empty string.
  305. // If you specify the update_mask to be a special path "*", fully replaces all
  306. // user-modifiable fields to match `resource`.
  307. Membership resource = 3 [(google.api.field_behavior) = REQUIRED];
  308. // Optional. A request ID to identify requests. Specify a unique request ID
  309. // so that if you must retry your request, the server will know to ignore
  310. // the request if it has already been completed. The server will guarantee
  311. // that for at least 60 minutes after the first request.
  312. //
  313. // For example, consider a situation where you make an initial request and
  314. // the request times out. If you make the request again with the same request
  315. // ID, the server can check if original operation with the same request ID
  316. // was received, and if so, will ignore the second request. This prevents
  317. // clients from accidentally creating duplicate commitments.
  318. //
  319. // The request ID must be a valid UUID with the exception that zero UUID is
  320. // not supported (00000000-0000-0000-0000-000000000000).
  321. string request_id = 4 [(google.api.field_behavior) = OPTIONAL];
  322. }
  323. // Request message for `GkeHub.GenerateConnectManifest`
  324. // method.
  325. // .
  326. message GenerateConnectManifestRequest {
  327. // Required. The Membership resource name the Agent will associate with, in the format
  328. // `projects/*/locations/*/memberships/*`.
  329. string name = 1 [(google.api.field_behavior) = REQUIRED];
  330. // Optional. Namespace for GKE Connect agent resources. Defaults to `gke-connect`.
  331. //
  332. // The Connect Agent is authorized automatically when run in the default
  333. // namespace. Otherwise, explicit authorization must be granted with an
  334. // additional IAM binding.
  335. string namespace = 2 [(google.api.field_behavior) = OPTIONAL];
  336. // Optional. URI of a proxy if connectivity from the agent to gkeconnect.googleapis.com
  337. // requires the use of a proxy. Format must be in the form
  338. // `http(s)://{proxy_address}`, depending on the HTTP/HTTPS protocol
  339. // supported by the proxy. This will direct the connect agent's outbound
  340. // traffic through a HTTP(S) proxy.
  341. bytes proxy = 3 [(google.api.field_behavior) = OPTIONAL];
  342. // Optional. The Connect agent version to use. Defaults to the most current version.
  343. string version = 4 [(google.api.field_behavior) = OPTIONAL];
  344. // Optional. If true, generate the resources for upgrade only. Some resources
  345. // generated only for installation (e.g. secrets) will be excluded.
  346. bool is_upgrade = 5 [(google.api.field_behavior) = OPTIONAL];
  347. // Optional. The registry to fetch the connect agent image from. Defaults to
  348. // gcr.io/gkeconnect.
  349. string registry = 6 [(google.api.field_behavior) = OPTIONAL];
  350. // Optional. The image pull secret content for the registry, if not public.
  351. bytes image_pull_secret_content = 7 [(google.api.field_behavior) = OPTIONAL];
  352. }
  353. // GenerateConnectManifestResponse contains manifest information for
  354. // installing/upgrading a Connect agent.
  355. message GenerateConnectManifestResponse {
  356. // The ordered list of Kubernetes resources that need to be applied to the
  357. // cluster for GKE Connect agent installation/upgrade.
  358. repeated ConnectAgentResource manifest = 1;
  359. }
  360. // ConnectAgentResource represents a Kubernetes resource manifest for Connect
  361. // Agent deployment.
  362. message ConnectAgentResource {
  363. // Kubernetes type of the resource.
  364. TypeMeta type = 1;
  365. // YAML manifest of the resource.
  366. string manifest = 2;
  367. }
  368. // TypeMeta is the type information needed for content unmarshalling of
  369. // Kubernetes resources in the manifest.
  370. message TypeMeta {
  371. // Kind of the resource (e.g. Deployment).
  372. string kind = 1;
  373. // APIVersion of the resource (e.g. v1).
  374. string api_version = 2;
  375. }
  376. // Request message for `GkeHub.ListFeatures` method.
  377. message ListFeaturesRequest {
  378. // The parent (project and location) where the Features will be listed.
  379. // Specified in the format `projects/*/locations/*`.
  380. string parent = 1;
  381. // When requesting a 'page' of resources, `page_size` specifies number of
  382. // resources to return. If unspecified or set to 0, all resources will
  383. // be returned.
  384. int32 page_size = 2;
  385. // Token returned by previous call to `ListFeatures` which
  386. // specifies the position in the list from where to continue listing the
  387. // resources.
  388. string page_token = 3;
  389. // Lists Features that match the filter expression, following the syntax
  390. // outlined in https://google.aip.dev/160.
  391. //
  392. // Examples:
  393. //
  394. // - Feature with the name "servicemesh" in project "foo-proj":
  395. //
  396. // name = "projects/foo-proj/locations/global/features/servicemesh"
  397. //
  398. // - Features that have a label called `foo`:
  399. //
  400. // labels.foo:*
  401. //
  402. // - Features that have a label called `foo` whose value is `bar`:
  403. //
  404. // labels.foo = bar
  405. string filter = 4;
  406. // One or more fields to compare and use to sort the output.
  407. // See https://google.aip.dev/132#ordering.
  408. string order_by = 5;
  409. }
  410. // Response message for the `GkeHub.ListFeatures` method.
  411. message ListFeaturesResponse {
  412. // The list of matching Features
  413. repeated Feature resources = 1;
  414. // A token to request the next page of resources from the
  415. // `ListFeatures` method. The value of an empty string means
  416. // that there are no more resources to return.
  417. string next_page_token = 2;
  418. }
  419. // Request message for `GkeHub.GetFeature` method.
  420. message GetFeatureRequest {
  421. // The Feature resource name in the format
  422. // `projects/*/locations/*/features/*`
  423. string name = 1;
  424. }
  425. // Request message for the `GkeHub.CreateFeature` method.
  426. message CreateFeatureRequest {
  427. // The parent (project and location) where the Feature will be created.
  428. // Specified in the format `projects/*/locations/*`.
  429. string parent = 1;
  430. // The ID of the feature to create.
  431. string feature_id = 2;
  432. // The Feature resource to create.
  433. Feature resource = 3;
  434. // Optional. A request ID to identify requests. Specify a unique request ID
  435. // so that if you must retry your request, the server will know to ignore
  436. // the request if it has already been completed. The server will guarantee
  437. // that for at least 60 minutes after the first request.
  438. //
  439. // For example, consider a situation where you make an initial request and
  440. // the request times out. If you make the request again with the same request
  441. // ID, the server can check if original operation with the same request ID
  442. // was received, and if so, will ignore the second request. This prevents
  443. // clients from accidentally creating duplicate commitments.
  444. //
  445. // The request ID must be a valid UUID with the exception that zero UUID is
  446. // not supported (00000000-0000-0000-0000-000000000000).
  447. string request_id = 4 [(google.api.field_behavior) = OPTIONAL];
  448. }
  449. // Request message for `GkeHub.DeleteFeature` method.
  450. message DeleteFeatureRequest {
  451. // The Feature resource name in the format
  452. // `projects/*/locations/*/features/*`.
  453. string name = 1;
  454. // If set to true, the delete will ignore any outstanding resources for
  455. // this Feature (that is, `FeatureState.has_resources` is set to true). These
  456. // resources will NOT be cleaned up or modified in any way.
  457. bool force = 2;
  458. // Optional. A request ID to identify requests. Specify a unique request ID
  459. // so that if you must retry your request, the server will know to ignore
  460. // the request if it has already been completed. The server will guarantee
  461. // that for at least 60 minutes after the first request.
  462. //
  463. // For example, consider a situation where you make an initial request and
  464. // the request times out. If you make the request again with the same request
  465. // ID, the server can check if original operation with the same request ID
  466. // was received, and if so, will ignore the second request. This prevents
  467. // clients from accidentally creating duplicate commitments.
  468. //
  469. // The request ID must be a valid UUID with the exception that zero UUID is
  470. // not supported (00000000-0000-0000-0000-000000000000).
  471. string request_id = 3 [(google.api.field_behavior) = OPTIONAL];
  472. }
  473. // Request message for `GkeHub.UpdateFeature` method.
  474. message UpdateFeatureRequest {
  475. // The Feature resource name in the format
  476. // `projects/*/locations/*/features/*`.
  477. string name = 1;
  478. // Mask of fields to update.
  479. google.protobuf.FieldMask update_mask = 2;
  480. // Only fields specified in update_mask are updated.
  481. // If you specify a field in the update_mask but don't specify its value here
  482. // that field will be deleted.
  483. // If you are updating a map field, set the value of a key to null or empty
  484. // string to delete the key from the map. It's not possible to update a key's
  485. // value to the empty string.
  486. // If you specify the update_mask to be a special path "*", fully replaces all
  487. // user-modifiable fields to match `resource`.
  488. Feature resource = 3;
  489. // Optional. A request ID to identify requests. Specify a unique request ID
  490. // so that if you must retry your request, the server will know to ignore
  491. // the request if it has already been completed. The server will guarantee
  492. // that for at least 60 minutes after the first request.
  493. //
  494. // For example, consider a situation where you make an initial request and
  495. // the request times out. If you make the request again with the same request
  496. // ID, the server can check if original operation with the same request ID
  497. // was received, and if so, will ignore the second request. This prevents
  498. // clients from accidentally creating duplicate commitments.
  499. //
  500. // The request ID must be a valid UUID with the exception that zero UUID is
  501. // not supported (00000000-0000-0000-0000-000000000000).
  502. string request_id = 4 [(google.api.field_behavior) = OPTIONAL];
  503. }
  504. // Represents the metadata of the long-running operation.
  505. message OperationMetadata {
  506. // Output only. The time the operation was created.
  507. google.protobuf.Timestamp create_time = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
  508. // Output only. The time the operation finished running.
  509. google.protobuf.Timestamp end_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
  510. // Output only. Server-defined resource path for the target of the operation.
  511. string target = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
  512. // Output only. Name of the verb executed by the operation.
  513. string verb = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
  514. // Output only. Human-readable status of the operation, if any.
  515. string status_detail = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
  516. // Output only. Identifies whether the user has requested cancellation
  517. // of the operation. Operations that have successfully been cancelled
  518. // have [Operation.error][] value with a [google.rpc.Status.code][google.rpc.Status.code] of 1,
  519. // corresponding to `Code.CANCELLED`.
  520. bool cancel_requested = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
  521. // Output only. API version used to start the operation.
  522. string api_version = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
  523. }