Built motion from commit 6a09e18b.|2.6.11

[motion2.git] / legacy-libs / google-proto-files / google / cloud / talent / v4beta1 / tenant_service.proto

diff --git a/legacy-libs/google-proto-files/google/cloud/talent/v4beta1/tenant_service.proto b/legacy-libs/google-proto-files/google/cloud/talent/v4beta1/tenant_service.proto
new file mode 100644 (file)
index 0000000..18de6cd
--- /dev/null
+++ b/legacy-libs/google-proto-files/google/cloud/talent/v4beta1/tenant_service.proto
@@ -0,0 +1,167 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.talent.v4beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/talent/v4beta1/common.proto";
+import "google/cloud/talent/v4beta1/tenant.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
+option java_multiple_files = true;
+option java_outer_classname = "TenantServiceProto";
+option java_package = "com.google.cloud.talent.v4beta1";
+option objc_class_prefix = "CTS";
+
+// A service that handles tenant management, including CRUD and enumeration.
+service TenantService {
+  // Creates a new tenant entity.
+  rpc CreateTenant(CreateTenantRequest) returns (Tenant) {
+    option (google.api.http) = {
+      post: "/v4beta1/{parent=projects/*}/tenants"
+      body: "*"
+    };
+  }
+
+  // Retrieves specified tenant.
+  rpc GetTenant(GetTenantRequest) returns (Tenant) {
+    option (google.api.http) = {
+      get: "/v4beta1/{name=projects/*/tenants/*}"
+    };
+  }
+
+  // Updates specified tenant.
+  rpc UpdateTenant(UpdateTenantRequest) returns (Tenant) {
+    option (google.api.http) = {
+      patch: "/v4beta1/{tenant.name=projects/*/tenants/*}"
+      body: "*"
+    };
+  }
+
+  // Deletes specified tenant.
+  rpc DeleteTenant(DeleteTenantRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v4beta1/{name=projects/*/tenants/*}"
+    };
+  }
+
+  // Lists all tenants associated with the project.
+  rpc ListTenants(ListTenantsRequest) returns (ListTenantsResponse) {
+    option (google.api.http) = {
+      get: "/v4beta1/{parent=projects/*}/tenants"
+    };
+  }
+}
+
+// The Request of the CreateTenant method.
+message CreateTenantRequest {
+  // Required.
+  //
+  // Resource name of the project under which the tenant is created.
+  //
+  // The format is "projects/{project_id}", for example,
+  // "projects/api-test-project".
+  string parent = 1;
+
+  // Required.
+  //
+  // The tenant to be created.
+  Tenant tenant = 2;
+}
+
+// Request for getting a tenant by name.
+message GetTenantRequest {
+  // Required.
+  //
+  // The resource name of the tenant to be retrieved.
+  //
+  // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
+  // "projects/api-test-project/tenants/foo".
+  string name = 1;
+}
+
+// Request for updating a specified tenant.
+message UpdateTenantRequest {
+  // Required.
+  //
+  // The tenant resource to replace the current resource in the system.
+  Tenant tenant = 1;
+
+  // Optional but strongly recommended for the best service
+  // experience.
+  //
+  // If
+  // [update_mask][google.cloud.talent.v4beta1.UpdateTenantRequest.update_mask]
+  // is provided, only the specified fields in
+  // [tenant][google.cloud.talent.v4beta1.UpdateTenantRequest.tenant] are
+  // updated. Otherwise all the fields are updated.
+  //
+  // A field mask to specify the tenant fields to be updated. Only
+  // top level fields of [Tenant][google.cloud.talent.v4beta1.Tenant] are
+  // supported.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request to delete a tenant.
+message DeleteTenantRequest {
+  // Required.
+  //
+  // The resource name of the tenant to be deleted.
+  //
+  // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
+  // "projects/api-test-project/tenants/foo".
+  string name = 1;
+}
+
+// List tenants for which the client has ACL visibility.
+message ListTenantsRequest {
+  // Required.
+  //
+  // Resource name of the project under which the tenant is created.
+  //
+  // The format is "projects/{project_id}", for example,
+  // "projects/api-test-project".
+  string parent = 1;
+
+  // Optional.
+  //
+  // The starting indicator from which to return results.
+  string page_token = 2;
+
+  // Optional.
+  //
+  // The maximum number of tenants to be returned, at most 100.
+  // Default is 100 if a non-positive number is provided.
+  int32 page_size = 3;
+}
+
+// Output only.
+//
+// The List tenants response object.
+message ListTenantsResponse {
+  // Tenants for the current client.
+  repeated Tenant tenants = 1;
+
+  // A token to retrieve the next page of results.
+  string next_page_token = 2;
+
+  // Additional information for the API invocation, such as the request
+  // tracking id.
+  ResponseMetadata metadata = 3;
+}