Fix method doc signatures for multiline required parameters (#374)
* Fix method doc signatures for multiline required parameters.
Existing doc generator failed to recognize parameters as required when parameter descriptions
extended over more than one line. Besides presenting incorrect information, resulting
inconsistencies broke checks for automated sample generation.
* Regen docs
diff --git a/docs/dyn/dataproc_v1beta1.projects.clusters.html b/docs/dyn/dataproc_v1beta1.projects.clusters.html
index 8a4fe9e..a00b0e8 100644
--- a/docs/dyn/dataproc_v1beta1.projects.clusters.html
+++ b/docs/dyn/dataproc_v1beta1.projects.clusters.html
@@ -112,28 +112,6 @@
"substate": "A String", # Output-only Additional state information that includes status reported by the agent.
"detail": "A String", # Optional details of cluster's state.
},
- "statusHistory": [ # Output-only Previous cluster statuses.
- { # The status of a cluster and its instances.
- "state": "A String", # The cluster's state.
- "stateStartTime": "A String", # Time when this state was entered.
- "substate": "A String", # Output-only Additional state information that includes status reported by the agent.
- "detail": "A String", # Optional details of cluster's state.
- },
- ],
- "clusterUuid": "A String", # Output-only A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
- "clusterName": "A String", # Required The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
- "projectId": "A String", # Required The Google Cloud Platform project ID that the cluster belongs to.
- "labels": { # Optional The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 64 labels can be associated with a given cluster.
- "a_key": "A String",
- },
- "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
- "yarnMetrics": { # The YARN metrics.
- "a_key": "A String",
- },
- "hdfsMetrics": { # The HDFS metrics.
- "a_key": "A String",
- },
- },
"configuration": { # The cluster configuration. # Required The cluster configuration. Note that Cloud Dataproc may set default values, and values may change when clusters are updated.
"softwareConfiguration": { # Specifies the selection and configuration of software inside the cluster. # Optional The configuration settings for software inside the cluster.
"imageVersion": "A String", # Optional The version of software inside the cluster. It must match the regular expression [0-9]+\.[0-9]+. If unspecified, it defaults to the latest version (see Cloud Dataproc Versioning).
@@ -242,6 +220,28 @@
},
},
},
+ "clusterUuid": "A String", # Output-only A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
+ "clusterName": "A String", # Required The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
+ "projectId": "A String", # Required The Google Cloud Platform project ID that the cluster belongs to.
+ "labels": { # Optional The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 64 labels can be associated with a given cluster.
+ "a_key": "A String",
+ },
+ "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
+ "yarnMetrics": { # The YARN metrics.
+ "a_key": "A String",
+ },
+ "hdfsMetrics": { # The HDFS metrics.
+ "a_key": "A String",
+ },
+ },
+ "statusHistory": [ # Output-only Previous cluster statuses.
+ { # The status of a cluster and its instances.
+ "state": "A String", # The cluster's state.
+ "stateStartTime": "A String", # Time when this state was entered.
+ "substate": "A String", # Output-only Additional state information that includes status reported by the agent.
+ "detail": "A String", # Optional details of cluster's state.
+ },
+ ],
}
x__xgafv: string, V1 error format.
@@ -394,28 +394,6 @@
"substate": "A String", # Output-only Additional state information that includes status reported by the agent.
"detail": "A String", # Optional details of cluster's state.
},
- "statusHistory": [ # Output-only Previous cluster statuses.
- { # The status of a cluster and its instances.
- "state": "A String", # The cluster's state.
- "stateStartTime": "A String", # Time when this state was entered.
- "substate": "A String", # Output-only Additional state information that includes status reported by the agent.
- "detail": "A String", # Optional details of cluster's state.
- },
- ],
- "clusterUuid": "A String", # Output-only A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
- "clusterName": "A String", # Required The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
- "projectId": "A String", # Required The Google Cloud Platform project ID that the cluster belongs to.
- "labels": { # Optional The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 64 labels can be associated with a given cluster.
- "a_key": "A String",
- },
- "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
- "yarnMetrics": { # The YARN metrics.
- "a_key": "A String",
- },
- "hdfsMetrics": { # The HDFS metrics.
- "a_key": "A String",
- },
- },
"configuration": { # The cluster configuration. # Required The cluster configuration. Note that Cloud Dataproc may set default values, and values may change when clusters are updated.
"softwareConfiguration": { # Specifies the selection and configuration of software inside the cluster. # Optional The configuration settings for software inside the cluster.
"imageVersion": "A String", # Optional The version of software inside the cluster. It must match the regular expression [0-9]+\.[0-9]+. If unspecified, it defaults to the latest version (see Cloud Dataproc Versioning).
@@ -524,6 +502,28 @@
},
},
},
+ "clusterUuid": "A String", # Output-only A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
+ "clusterName": "A String", # Required The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
+ "projectId": "A String", # Required The Google Cloud Platform project ID that the cluster belongs to.
+ "labels": { # Optional The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 64 labels can be associated with a given cluster.
+ "a_key": "A String",
+ },
+ "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
+ "yarnMetrics": { # The YARN metrics.
+ "a_key": "A String",
+ },
+ "hdfsMetrics": { # The HDFS metrics.
+ "a_key": "A String",
+ },
+ },
+ "statusHistory": [ # Output-only Previous cluster statuses.
+ { # The status of a cluster and its instances.
+ "state": "A String", # The cluster's state.
+ "stateStartTime": "A String", # Time when this state was entered.
+ "substate": "A String", # Output-only Additional state information that includes status reported by the agent.
+ "detail": "A String", # Optional details of cluster's state.
+ },
+ ],
}</pre>
</div>
@@ -554,28 +554,6 @@
"substate": "A String", # Output-only Additional state information that includes status reported by the agent.
"detail": "A String", # Optional details of cluster's state.
},
- "statusHistory": [ # Output-only Previous cluster statuses.
- { # The status of a cluster and its instances.
- "state": "A String", # The cluster's state.
- "stateStartTime": "A String", # Time when this state was entered.
- "substate": "A String", # Output-only Additional state information that includes status reported by the agent.
- "detail": "A String", # Optional details of cluster's state.
- },
- ],
- "clusterUuid": "A String", # Output-only A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
- "clusterName": "A String", # Required The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
- "projectId": "A String", # Required The Google Cloud Platform project ID that the cluster belongs to.
- "labels": { # Optional The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 64 labels can be associated with a given cluster.
- "a_key": "A String",
- },
- "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
- "yarnMetrics": { # The YARN metrics.
- "a_key": "A String",
- },
- "hdfsMetrics": { # The HDFS metrics.
- "a_key": "A String",
- },
- },
"configuration": { # The cluster configuration. # Required The cluster configuration. Note that Cloud Dataproc may set default values, and values may change when clusters are updated.
"softwareConfiguration": { # Specifies the selection and configuration of software inside the cluster. # Optional The configuration settings for software inside the cluster.
"imageVersion": "A String", # Optional The version of software inside the cluster. It must match the regular expression [0-9]+\.[0-9]+. If unspecified, it defaults to the latest version (see Cloud Dataproc Versioning).
@@ -684,6 +662,28 @@
},
},
},
+ "clusterUuid": "A String", # Output-only A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
+ "clusterName": "A String", # Required The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
+ "projectId": "A String", # Required The Google Cloud Platform project ID that the cluster belongs to.
+ "labels": { # Optional The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 64 labels can be associated with a given cluster.
+ "a_key": "A String",
+ },
+ "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
+ "yarnMetrics": { # The YARN metrics.
+ "a_key": "A String",
+ },
+ "hdfsMetrics": { # The HDFS metrics.
+ "a_key": "A String",
+ },
+ },
+ "statusHistory": [ # Output-only Previous cluster statuses.
+ { # The status of a cluster and its instances.
+ "state": "A String", # The cluster's state.
+ "stateStartTime": "A String", # Time when this state was entered.
+ "substate": "A String", # Output-only Additional state information that includes status reported by the agent.
+ "detail": "A String", # Optional details of cluster's state.
+ },
+ ],
},
],
}</pre>
@@ -720,28 +720,6 @@
"substate": "A String", # Output-only Additional state information that includes status reported by the agent.
"detail": "A String", # Optional details of cluster's state.
},
- "statusHistory": [ # Output-only Previous cluster statuses.
- { # The status of a cluster and its instances.
- "state": "A String", # The cluster's state.
- "stateStartTime": "A String", # Time when this state was entered.
- "substate": "A String", # Output-only Additional state information that includes status reported by the agent.
- "detail": "A String", # Optional details of cluster's state.
- },
- ],
- "clusterUuid": "A String", # Output-only A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
- "clusterName": "A String", # Required The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
- "projectId": "A String", # Required The Google Cloud Platform project ID that the cluster belongs to.
- "labels": { # Optional The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 64 labels can be associated with a given cluster.
- "a_key": "A String",
- },
- "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
- "yarnMetrics": { # The YARN metrics.
- "a_key": "A String",
- },
- "hdfsMetrics": { # The HDFS metrics.
- "a_key": "A String",
- },
- },
"configuration": { # The cluster configuration. # Required The cluster configuration. Note that Cloud Dataproc may set default values, and values may change when clusters are updated.
"softwareConfiguration": { # Specifies the selection and configuration of software inside the cluster. # Optional The configuration settings for software inside the cluster.
"imageVersion": "A String", # Optional The version of software inside the cluster. It must match the regular expression [0-9]+\.[0-9]+. If unspecified, it defaults to the latest version (see Cloud Dataproc Versioning).
@@ -850,6 +828,28 @@
},
},
},
+ "clusterUuid": "A String", # Output-only A cluster UUID (Unique Universal Identifier). Cloud Dataproc generates this value when it creates the cluster.
+ "clusterName": "A String", # Required The cluster name. Cluster names within a project must be unique. Names from deleted clusters can be reused.
+ "projectId": "A String", # Required The Google Cloud Platform project ID that the cluster belongs to.
+ "labels": { # Optional The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 64 labels can be associated with a given cluster.
+ "a_key": "A String",
+ },
+ "metrics": { # Contains cluster daemon metrics, such as HDFS and YARN stats. # Contains cluster daemon metrics such as HDFS and YARN stats.
+ "yarnMetrics": { # The YARN metrics.
+ "a_key": "A String",
+ },
+ "hdfsMetrics": { # The HDFS metrics.
+ "a_key": "A String",
+ },
+ },
+ "statusHistory": [ # Output-only Previous cluster statuses.
+ { # The status of a cluster and its instances.
+ "state": "A String", # The cluster's state.
+ "stateStartTime": "A String", # Time when this state was entered.
+ "substate": "A String", # Output-only Additional state information that includes status reported by the agent.
+ "detail": "A String", # Optional details of cluster's state.
+ },
+ ],
}
updateMask: string, Required Specifies the path, relative to <code>Cluster</code>, of the field to update. For example, to change the number of workers in a cluster to 5, the <code>update_mask</code> parameter would be specified as <code>configuration.worker_configuration.num_instances</code>, and the PATCH request body would specify the new value, as follows: