xref: /aosp_15_r20/external/googleapis/google/cloud/gkeconnect/gateway/v1beta1/gateway.proto (revision d5c09012810ac0c9f33fe448fb6da8260d444cc9)
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
15syntax = "proto3";
16
17package google.cloud.gkeconnect.gateway.v1beta1;
18
19import "google/api/annotations.proto";
20import "google/api/client.proto";
21import "google/api/httpbody.proto";
22
23option csharp_namespace = "Google.Cloud.GkeConnect.Gateway.V1Beta1";
24option go_package = "cloud.google.com/go/gkeconnect/gateway/apiv1beta1/gatewaypb;gatewaypb";
25option java_multiple_files = true;
26option java_outer_classname = "GatewayProto";
27option java_package = "com.google.cloud.gkeconnect.gateway.v1beta1";
28option php_namespace = "Google\\Cloud\\GkeConnect\\Gateway\\V1beta1";
29option ruby_package = "Google::Cloud::GkeConnect::Gateway::V1beta1";
30
31// Gateway service is a public API which works as a Kubernetes resource model
32// proxy between end users and registered Kubernetes clusters. Each RPC in this
33// service matches with an HTTP verb. End user will initiate kubectl commands
34// against the Gateway service, and Gateway service will forward user requests
35// to clusters.
36service GatewayService {
37  option (google.api.default_host) = "connectgateway.googleapis.com";
38  option (google.api.oauth_scopes) =
39      "https://www.googleapis.com/auth/cloud-platform";
40
41  // GetResource performs an HTTP GET request on the Kubernetes API Server.
42  rpc GetResource(google.api.HttpBody) returns (google.api.HttpBody) {
43    option (google.api.http) = {
44      get: "/v1beta1/**"
45    };
46  }
47
48  // PostResource performs an HTTP POST on the Kubernetes API Server.
49  rpc PostResource(google.api.HttpBody) returns (google.api.HttpBody) {
50    option (google.api.http) = {
51      post: "/v1beta1/**"
52    };
53  }
54
55  // DeleteResource performs an HTTP DELETE on the Kubernetes API Server.
56  rpc DeleteResource(google.api.HttpBody) returns (google.api.HttpBody) {
57    option (google.api.http) = {
58      delete: "/v1beta1/**"
59    };
60  }
61
62  // PutResource performs an HTTP PUT on the Kubernetes API Server.
63  rpc PutResource(google.api.HttpBody) returns (google.api.HttpBody) {
64    option (google.api.http) = {
65      put: "/v1beta1/**"
66    };
67  }
68
69  // PatchResource performs an HTTP PATCH on the Kubernetes API Server.
70  rpc PatchResource(google.api.HttpBody) returns (google.api.HttpBody) {
71    option (google.api.http) = {
72      patch: "/v1beta1/**"
73    };
74  }
75}
76