1- // Copyright 2018 Google LLC.
1+ // Copyright 2019 Google LLC.
22//
33// Licensed under the Apache License, Version 2.0 (the "License");
44// you may not use this file except in compliance with the License.
@@ -18,7 +18,7 @@ syntax = "proto3";
1818package google.cloud.dataproc.v1 ;
1919
2020import "google/api/annotations.proto" ;
21- import "google/cloud/dataproc/v1/operations .proto" ;
21+ import "google/cloud/dataproc/v1/shared .proto" ;
2222import "google/longrunning/operations.proto" ;
2323import "google/protobuf/duration.proto" ;
2424import "google/protobuf/field_mask.proto" ;
@@ -33,26 +33,23 @@ option java_package = "com.google.cloud.dataproc.v1";
3333// of Compute Engine instances.
3434service ClusterController {
3535 // Creates a cluster in a project.
36- rpc CreateCluster (CreateClusterRequest )
37- returns (google.longrunning.Operation ) {
36+ rpc CreateCluster (CreateClusterRequest ) returns (google.longrunning.Operation ) {
3837 option (google.api.http ) = {
3938 post : "/v1/projects/{project_id}/regions/{region}/clusters"
4039 body : "cluster"
4140 };
4241 }
4342
4443 // Updates a cluster in a project.
45- rpc UpdateCluster (UpdateClusterRequest )
46- returns (google.longrunning.Operation ) {
44+ rpc UpdateCluster (UpdateClusterRequest ) returns (google.longrunning.Operation ) {
4745 option (google.api.http ) = {
4846 patch : "/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}"
4947 body : "cluster"
5048 };
5149 }
5250
5351 // Deletes a cluster in a project.
54- rpc DeleteCluster (DeleteClusterRequest )
55- returns (google.longrunning.Operation ) {
52+ rpc DeleteCluster (DeleteClusterRequest ) returns (google.longrunning.Operation ) {
5653 option (google.api.http ) = {
5754 delete : "/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}"
5855 };
@@ -75,8 +72,7 @@ service ClusterController {
7572 // Gets cluster diagnostic information.
7673 // After the operation completes, the Operation.response field
7774 // contains `DiagnoseClusterOutputLocation`.
78- rpc DiagnoseCluster (DiagnoseClusterRequest )
79- returns (google.longrunning.Operation ) {
75+ rpc DiagnoseCluster (DiagnoseClusterRequest ) returns (google.longrunning.Operation ) {
8076 option (google.api.http ) = {
8177 post : "/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}:diagnose"
8278 body : "*"
@@ -126,15 +122,18 @@ message Cluster {
126122
127123// The cluster config.
128124message ClusterConfig {
129- // Optional. A Cloud Storage staging bucket used for sharing generated
130- // SSH keys and config. If you do not specify a staging bucket, Cloud
131- // Dataproc will determine an appropriate Cloud Storage location (US,
125+ // Optional. A Google Cloud Storage bucket used to stage job
126+ // dependencies, config files, and job driver console output.
127+ // If you do not specify a staging bucket, Cloud
128+ // Dataproc will determine a Cloud Storage location (US,
132129 // ASIA, or EU) for your cluster's staging bucket according to the Google
133- // Compute Engine zone where your cluster is deployed, and then it will create
134- // and manage this project-level, per-location bucket for you.
130+ // Compute Engine zone where your cluster is deployed, and then create
131+ // and manage this project-level, per-location bucket (see
132+ // [Cloud Dataproc staging
133+ // bucket](/dataproc/docs/concepts/configuring-clusters/staging-bucket)).
135134 string config_bucket = 1 ;
136135
137- // Required . The shared Compute Engine config settings for
136+ // Optional . The shared Compute Engine config settings for
138137 // all instances in a cluster.
139138 GceClusterConfig gce_cluster_config = 8 ;
140139
@@ -213,8 +212,8 @@ message GceClusterConfig {
213212 //
214213 // A full URL, partial URI, or short name are valid. Examples:
215214 //
216- // * `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/sub0`
217- // * `projects/[project_id]/regions/us-east1/sub0`
215+ // * `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/subnetworks/ sub0`
216+ // * `projects/[project_id]/regions/us-east1/subnetworks/ sub0`
218217 // * `sub0`
219218 string subnetwork_uri = 6 ;
220219
@@ -447,13 +446,13 @@ message SoftwareConfig {
447446 // such as "1.2" (including a subminor version, such as "1.2.29"), or the
448447 // ["preview"
449448 // version](/dataproc/docs/concepts/versioning/dataproc-versions#other_versions).
450- // If unspecified, it defaults to the latest version.
449+ // If unspecified, it defaults to the latest Debian version.
451450 string image_version = 1 ;
452451
453452 // Optional. The properties to set on daemon config files.
454453 //
455- // Property keys are specified in `prefix:property` format, such as
456- // `core:fs.defaultFS `. The following are supported prefixes
454+ // Property keys are specified in `prefix:property` format, for example
455+ // `core:hadoop.tmp.dir `. The following are supported prefixes
457456 // and their mappings:
458457 //
459458 // * capacity-scheduler: `capacity-scheduler.xml`
@@ -469,6 +468,9 @@ message SoftwareConfig {
469468 // For more information, see
470469 // [Cluster properties](/dataproc/docs/concepts/cluster-properties).
471470 map <string , string > properties = 2 ;
471+
472+ // The set of optional components to activate on the cluster.
473+ repeated Component optional_components = 3 ;
472474}
473475
474476// Contains cluster daemon metrics, such as HDFS and YARN stats.
@@ -496,11 +498,10 @@ message CreateClusterRequest {
496498 Cluster cluster = 2 ;
497499
498500 // Optional. A unique id used to identify the request. If the server
499- // receives two
500- // [CreateClusterRequest][google.cloud.dataproc.v1.CreateClusterRequest]
501- // requests with the same id, then the second request will be ignored and the
502- // first [google.longrunning.Operation][google.longrunning.Operation] created
503- // and stored in the backend is returned.
501+ // receives two [CreateClusterRequest][google.cloud.dataproc.v1.CreateClusterRequest] requests with the same
502+ // id, then the second request will be ignored and the
503+ // first [google.longrunning.Operation][google.longrunning.Operation] created and stored in the backend
504+ // is returned.
504505 //
505506 // It is recommended to always set this value to a
506507 // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
@@ -585,11 +586,10 @@ message UpdateClusterRequest {
585586 google.protobuf.FieldMask update_mask = 4 ;
586587
587588 // Optional. A unique id used to identify the request. If the server
588- // receives two
589- // [UpdateClusterRequest][google.cloud.dataproc.v1.UpdateClusterRequest]
590- // requests with the same id, then the second request will be ignored and the
591- // first [google.longrunning.Operation][google.longrunning.Operation] created
592- // and stored in the backend is returned.
589+ // receives two [UpdateClusterRequest][google.cloud.dataproc.v1.UpdateClusterRequest] requests with the same
590+ // id, then the second request will be ignored and the
591+ // first [google.longrunning.Operation][google.longrunning.Operation] created and stored in the
592+ // backend is returned.
593593 //
594594 // It is recommended to always set this value to a
595595 // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
@@ -616,11 +616,10 @@ message DeleteClusterRequest {
616616 string cluster_uuid = 4 ;
617617
618618 // Optional. A unique id used to identify the request. If the server
619- // receives two
620- // [DeleteClusterRequest][google.cloud.dataproc.v1.DeleteClusterRequest]
621- // requests with the same id, then the second request will be ignored and the
622- // first [google.longrunning.Operation][google.longrunning.Operation] created
623- // and stored in the backend is returned.
619+ // receives two [DeleteClusterRequest][google.cloud.dataproc.v1.DeleteClusterRequest] requests with the same
620+ // id, then the second request will be ignored and the
621+ // first [google.longrunning.Operation][google.longrunning.Operation] created and stored in the
622+ // backend is returned.
624623 //
625624 // It is recommended to always set this value to a
626625 // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
0 commit comments