@@ -29,28 +29,30 @@ option java_multiple_files = true;
2929option java_outer_classname = "ClustersProto" ;
3030option java_package = "com.google.cloud.dataproc.v1" ;
3131
32-
3332// The ClusterControllerService provides methods to manage clusters
3433// of Compute Engine instances.
3534service ClusterController {
3635 // Creates a cluster in a project.
37- rpc CreateCluster (CreateClusterRequest ) returns (google.longrunning.Operation ) {
36+ rpc CreateCluster (CreateClusterRequest )
37+ returns (google.longrunning.Operation ) {
3838 option (google.api.http ) = {
3939 post : "/v1/projects/{project_id}/regions/{region}/clusters"
4040 body : "cluster"
4141 };
4242 }
4343
4444 // Updates a cluster in a project.
45- rpc UpdateCluster (UpdateClusterRequest ) returns (google.longrunning.Operation ) {
45+ rpc UpdateCluster (UpdateClusterRequest )
46+ returns (google.longrunning.Operation ) {
4647 option (google.api.http ) = {
4748 patch : "/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}"
4849 body : "cluster"
4950 };
5051 }
5152
5253 // Deletes a cluster in a project.
53- rpc DeleteCluster (DeleteClusterRequest ) returns (google.longrunning.Operation ) {
54+ rpc DeleteCluster (DeleteClusterRequest )
55+ returns (google.longrunning.Operation ) {
5456 option (google.api.http ) = {
5557 delete : "/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}"
5658 };
@@ -73,7 +75,8 @@ service ClusterController {
7375 // Gets cluster diagnostic information.
7476 // After the operation completes, the Operation.response field
7577 // contains `DiagnoseClusterOutputLocation`.
76- rpc DiagnoseCluster (DiagnoseClusterRequest ) returns (google.longrunning.Operation ) {
78+ rpc DiagnoseCluster (DiagnoseClusterRequest )
79+ returns (google.longrunning.Operation ) {
7780 option (google.api.http ) = {
7881 post : "/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}:diagnose"
7982 body : "*"
@@ -99,8 +102,9 @@ message Cluster {
99102 // Label **keys** must contain 1 to 63 characters, and must conform to
100103 // [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
101104 // Label **values** may be empty, but, if present, must contain 1 to 63
102- // characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
103- // No more than 32 labels can be associated with a cluster.
105+ // characters, and must conform to [RFC
106+ // 1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be
107+ // associated with a cluster.
104108 map <string , string > labels = 8 ;
105109
106110 // Output only. Cluster status.
@@ -115,8 +119,8 @@ message Cluster {
115119
116120 // Contains cluster daemon metrics such as HDFS and YARN stats.
117121 //
118- // **Beta Feature**: This report is available for testing purposes only. It may
119- // be changed before final release.
122+ // **Beta Feature**: This report is available for testing purposes only. It
123+ // may be changed before final release.
120124 ClusterMetrics metrics = 9 ;
121125}
122126
@@ -152,9 +156,11 @@ message ClusterConfig {
152156 // Optional. Commands to execute on each node after config is
153157 // completed. By default, executables are run on master and all worker nodes.
154158 // You can test a node's `role` metadata to run an executable on
155- // a master or worker node, as shown below using `curl` (you can also use `wget`):
159+ // a master or worker node, as shown below using `curl` (you can also use
160+ // `wget`):
156161 //
157- // ROLE=$(curl -H Metadata-Flavor:Google http://metadata/computeMetadata/v1/instance/attributes/dataproc-role)
162+ // ROLE=$(curl -H Metadata-Flavor:Google
163+ // http://metadata/computeMetadata/v1/instance/attributes/dataproc-role)
158164 // if [[ "${ROLE}" == 'Master' ]]; then
159165 // ... master specific actions ...
160166 // else
@@ -213,11 +219,11 @@ message GceClusterConfig {
213219 string subnetwork_uri = 6 ;
214220
215221 // Optional. If true, all instances in the cluster will only have internal IP
216- // addresses. By default, clusters are not restricted to internal IP addresses,
217- // and will have ephemeral external IP addresses assigned to each instance.
218- // This `internal_ip_only` restriction can only be enabled for subnetwork
219- // enabled networks, and all off-cluster dependencies must be configured to be
220- // accessible without external IP addresses.
222+ // addresses. By default, clusters are not restricted to internal IP
223+ // addresses, and will have ephemeral external IP addresses assigned to each
224+ // instance. This `internal_ip_only` restriction can only be enabled for
225+ // subnetwork enabled networks, and all off-cluster dependencies must be
226+ // configured to be accessible without external IP addresses.
221227 bool internal_ip_only = 7 ;
222228
223229 // Optional. The service account of the instances. Defaults to the default
@@ -227,7 +233,8 @@ message GceClusterConfig {
227233 // * roles/logging.logWriter
228234 // * roles/storage.objectAdmin
229235 //
230- // (see https://cloud.google.com/compute/docs/access/service-accounts#custom_service_accounts
236+ // (see
237+ // https://cloud.google.com/compute/docs/access/service-accounts#custom_service_accounts
231238 // for more information).
232239 // Example: `[account_id]@[project_id].iam.gserviceaccount.com`
233240 string service_account = 8 ;
@@ -253,7 +260,8 @@ message GceClusterConfig {
253260 repeated string tags = 4 ;
254261
255262 // The Compute Engine metadata entries to add to all instances (see
256- // [Project and instance metadata](https://cloud.google.com/compute/docs/storing-retrieving-metadata#project_and_instance_metadata)).
263+ // [Project and instance
264+ // metadata](https://cloud.google.com/compute/docs/storing-retrieving-metadata#project_and_instance_metadata)).
257265 map <string , string > metadata = 5 ;
258266}
259267
@@ -282,15 +290,17 @@ message InstanceGroupConfig {
282290 // * `n1-standard-2`
283291 //
284292 // **Auto Zone Exception**: If you are using the Cloud Dataproc
285- // [Auto Zone Placement](/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement)
293+ // [Auto Zone
294+ // Placement](/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement)
286295 // feature, you must use the short name of the machine type
287296 // resource, for example, `n1-standard-2`.
288297 string machine_type_uri = 4 ;
289298
290299 // Optional. Disk option config settings.
291300 DiskConfig disk_config = 5 ;
292301
293- // Optional. Specifies that this instance group contains preemptible instances.
302+ // Optional. Specifies that this instance group contains preemptible
303+ // instances.
294304 bool is_preemptible = 6 ;
295305
296306 // Output only. The config for Compute Engine Instance Group
@@ -321,7 +331,8 @@ message ManagedGroupConfig {
321331message AcceleratorConfig {
322332 // Full URL, partial URI, or short name of the accelerator type resource to
323333 // expose to this instance. See
324- // [Compute Engine AcceleratorTypes](/compute/docs/reference/beta/acceleratorTypes).
334+ // [Compute Engine
335+ // AcceleratorTypes](/compute/docs/reference/beta/acceleratorTypes).
325336 //
326337 // Examples:
327338 //
@@ -330,7 +341,8 @@ message AcceleratorConfig {
330341 // * `nvidia-tesla-k80`
331342 //
332343 // **Auto Zone Exception**: If you are using the Cloud Dataproc
333- // [Auto Zone Placement](/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement)
344+ // [Auto Zone
345+ // Placement](/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement)
334346 // feature, you must use the short name of the accelerator type
335347 // resource, for example, `nvidia-tesla-k80`.
336348 string accelerator_type_uri = 1 ;
@@ -429,10 +441,12 @@ message ClusterStatus {
429441
430442// Specifies the selection and config of software inside the cluster.
431443message SoftwareConfig {
432- // Optional. The version of software inside the cluster. It must be one of the supported
433- // [Cloud Dataproc Versions](/dataproc/docs/concepts/versioning/dataproc-versions#supported_cloud_dataproc_versions),
444+ // Optional. The version of software inside the cluster. It must be one of the
445+ // supported [Cloud Dataproc
446+ // Versions](/dataproc/docs/concepts/versioning/dataproc-versions#supported_cloud_dataproc_versions),
434447 // such as "1.2" (including a subminor version, such as "1.2.29"), or the
435- // ["preview" version](/dataproc/docs/concepts/versioning/dataproc-versions#other_versions).
448+ // ["preview"
449+ // version](/dataproc/docs/concepts/versioning/dataproc-versions#other_versions).
436450 // If unspecified, it defaults to the latest version.
437451 string image_version = 1 ;
438452
@@ -482,10 +496,11 @@ message CreateClusterRequest {
482496 Cluster cluster = 2 ;
483497
484498 // Optional. A unique id used to identify the request. If the server
485- // receives two [CreateClusterRequest][google.cloud.dataproc.v1.CreateClusterRequest] requests with the same
486- // id, then the second request will be ignored and the
487- // first [google.longrunning.Operation][google.longrunning.Operation] created and stored in the backend
488- // is returned.
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.
489504 //
490505 // It is recommended to always set this value to a
491506 // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
@@ -570,10 +585,11 @@ message UpdateClusterRequest {
570585 google.protobuf.FieldMask update_mask = 4 ;
571586
572587 // Optional. A unique id used to identify the request. If the server
573- // receives two [UpdateClusterRequest][google.cloud.dataproc.v1.UpdateClusterRequest] requests with the same
574- // id, then the second request will be ignored and the
575- // first [google.longrunning.Operation][google.longrunning.Operation] created and stored in the
576- // backend is returned.
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.
577593 //
578594 // It is recommended to always set this value to a
579595 // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
@@ -600,10 +616,11 @@ message DeleteClusterRequest {
600616 string cluster_uuid = 4 ;
601617
602618 // Optional. A unique id used to identify the request. If the server
603- // receives two [DeleteClusterRequest][google.cloud.dataproc.v1.DeleteClusterRequest] requests with the same
604- // id, then the second request will be ignored and the
605- // first [google.longrunning.Operation][google.longrunning.Operation] created and stored in the
606- // backend is returned.
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.
607624 //
608625 // It is recommended to always set this value to a
609626 // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
0 commit comments