diff --git a/Dataproc/src/V1/AcceleratorConfig.php b/Dataproc/src/V1/AcceleratorConfig.php
index 909b612fdd68..80c11f12c531 100644
--- a/Dataproc/src/V1/AcceleratorConfig.php
+++ b/Dataproc/src/V1/AcceleratorConfig.php
@@ -35,9 +35,27 @@ class AcceleratorConfig extends \Google\Protobuf\Internal\Message
*/
private $accelerator_count = 0;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $accelerator_type_uri
+ * Full URL, partial URI, or short name of the accelerator type resource to
+ * expose to this instance. See [Google Compute Engine AcceleratorTypes](
+ * /compute/docs/reference/beta/acceleratorTypes)
+ * Examples
+ * * `https://www.googleapis.com/compute/beta/projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k80`
+ * * `projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k80`
+ * * `nvidia-tesla-k80`
+ * @type int $accelerator_count
+ * The number of the accelerator cards of this type exposed to this instance.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/CancelJobRequest.php b/Dataproc/src/V1/CancelJobRequest.php
index 872af9fcf11b..b1441fa9228f 100644
--- a/Dataproc/src/V1/CancelJobRequest.php
+++ b/Dataproc/src/V1/CancelJobRequest.php
@@ -35,9 +35,24 @@ class CancelJobRequest extends \Google\Protobuf\Internal\Message
*/
private $job_id = '';
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $project_id
+ * Required. The ID of the Google Cloud Platform project that the job
+ * belongs to.
+ * @type string $region
+ * Required. The Cloud Dataproc region in which to handle the request.
+ * @type string $job_id
+ * Required. The job ID.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/Cluster.php b/Dataproc/src/V1/Cluster.php
index d999a7dae912..8446655c26dc 100644
--- a/Dataproc/src/V1/Cluster.php
+++ b/Dataproc/src/V1/Cluster.php
@@ -75,9 +75,43 @@ class Cluster extends \Google\Protobuf\Internal\Message
*/
private $metrics = null;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $project_id
+ * Required. The Google Cloud Platform project ID that the cluster belongs to.
+ * @type string $cluster_name
+ * Required. The cluster name. Cluster names within a project must be
+ * unique. Names of deleted clusters can be reused.
+ * @type \Google\Cloud\Dataproc\V1\ClusterConfig $config
+ * Required. The cluster config. Note that Cloud Dataproc may set
+ * default values, and values may change when clusters are updated.
+ * @type array|\Google\Protobuf\Internal\MapField $labels
+ * Optional. The labels to associate with this cluster.
+ * Label **keys** must contain 1 to 63 characters, and must conform to
+ * [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
+ * Label **values** may be empty, but, if present, must contain 1 to 63
+ * characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
+ * No more than 32 labels can be associated with a cluster.
+ * @type \Google\Cloud\Dataproc\V1\ClusterStatus $status
+ * Output-only. Cluster status.
+ * @type \Google\Cloud\Dataproc\V1\ClusterStatus[]|\Google\Protobuf\Internal\RepeatedField $status_history
+ * Output-only. The previous cluster status.
+ * @type string $cluster_uuid
+ * Output-only. A cluster UUID (Unique Universal Identifier). Cloud Dataproc
+ * generates this value when it creates the cluster.
+ * @type \Google\Cloud\Dataproc\V1\ClusterMetrics $metrics
+ * Contains cluster daemon metrics such as HDFS and YARN stats.
+ * **Beta Feature**: This report is available for testing purposes only. It may
+ * be changed before final release.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/ClusterConfig.php b/Dataproc/src/V1/ClusterConfig.php
index 9f1a34eb2ea2..5cf478916149 100644
--- a/Dataproc/src/V1/ClusterConfig.php
+++ b/Dataproc/src/V1/ClusterConfig.php
@@ -76,9 +76,49 @@ class ClusterConfig extends \Google\Protobuf\Internal\Message
*/
private $initialization_actions;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $config_bucket
+ * Optional. A Google Cloud Storage staging bucket used for sharing generated
+ * SSH keys and config. If you do not specify a staging bucket, Cloud
+ * Dataproc will determine an appropriate Cloud Storage location (US,
+ * ASIA, or EU) for your cluster's staging bucket according to the Google
+ * Compute Engine zone where your cluster is deployed, and then it will create
+ * and manage this project-level, per-location bucket for you.
+ * @type \Google\Cloud\Dataproc\V1\GceClusterConfig $gce_cluster_config
+ * Required. The shared Google Compute Engine config settings for
+ * all instances in a cluster.
+ * @type \Google\Cloud\Dataproc\V1\InstanceGroupConfig $master_config
+ * Optional. The Google Compute Engine config settings for
+ * the master instance in a cluster.
+ * @type \Google\Cloud\Dataproc\V1\InstanceGroupConfig $worker_config
+ * Optional. The Google Compute Engine config settings for
+ * worker instances in a cluster.
+ * @type \Google\Cloud\Dataproc\V1\InstanceGroupConfig $secondary_worker_config
+ * Optional. The Google Compute Engine config settings for
+ * additional worker instances in a cluster.
+ * @type \Google\Cloud\Dataproc\V1\SoftwareConfig $software_config
+ * Optional. The config settings for software inside the cluster.
+ * @type \Google\Cloud\Dataproc\V1\NodeInitializationAction[]|\Google\Protobuf\Internal\RepeatedField $initialization_actions
+ * Optional. Commands to execute on each node after config is
+ * completed. By default, executables are run on master and all worker nodes.
+ * You can test a node's `role` metadata to run an executable on
+ * a master or worker node, as shown below using `curl` (you can also use `wget`):
+ * ROLE=$(curl -H Metadata-Flavor:Google http://metadata/computeMetadata/v1/instance/attributes/dataproc-role)
+ * if [[ "${ROLE}" == 'Master' ]]; then
+ * ... master specific actions ...
+ * else
+ * ... worker specific actions ...
+ * fi
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/ClusterMetrics.php b/Dataproc/src/V1/ClusterMetrics.php
index 1b684a11343e..b136b18a3d56 100644
--- a/Dataproc/src/V1/ClusterMetrics.php
+++ b/Dataproc/src/V1/ClusterMetrics.php
@@ -30,9 +30,21 @@ class ClusterMetrics extends \Google\Protobuf\Internal\Message
*/
private $yarn_metrics;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type array|\Google\Protobuf\Internal\MapField $hdfs_metrics
+ * The HDFS metrics.
+ * @type array|\Google\Protobuf\Internal\MapField $yarn_metrics
+ * The YARN metrics.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/ClusterOperationMetadata.php b/Dataproc/src/V1/ClusterOperationMetadata.php
index 8fe1edbff5fe..0143584651cb 100644
--- a/Dataproc/src/V1/ClusterOperationMetadata.php
+++ b/Dataproc/src/V1/ClusterOperationMetadata.php
@@ -64,9 +64,33 @@ class ClusterOperationMetadata extends \Google\Protobuf\Internal\Message
*/
private $warnings;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $cluster_name
+ * Output-only. Name of the cluster for the operation.
+ * @type string $cluster_uuid
+ * Output-only. Cluster UUID for the operation.
+ * @type \Google\Cloud\Dataproc\V1\ClusterOperationStatus $status
+ * Output-only. Current operation status.
+ * @type \Google\Cloud\Dataproc\V1\ClusterOperationStatus[]|\Google\Protobuf\Internal\RepeatedField $status_history
+ * Output-only. The previous operation status.
+ * @type string $operation_type
+ * Output-only. The operation type.
+ * @type string $description
+ * Output-only. Short description of operation.
+ * @type array|\Google\Protobuf\Internal\MapField $labels
+ * Output-only. Labels associated with the operation
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $warnings
+ * Output-only. Errors encountered during operation execution.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Operations::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/ClusterOperationStatus.php b/Dataproc/src/V1/ClusterOperationStatus.php
index 76dd1566ebf5..c74d9f4b9b50 100644
--- a/Dataproc/src/V1/ClusterOperationStatus.php
+++ b/Dataproc/src/V1/ClusterOperationStatus.php
@@ -40,9 +40,25 @@ class ClusterOperationStatus extends \Google\Protobuf\Internal\Message
*/
private $state_start_time = null;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type int $state
+ * Output-only. A message containing the operation state.
+ * @type string $inner_state
+ * Output-only. A message containing the detailed operation state.
+ * @type string $details
+ * Output-only.A message containing any operation metadata details.
+ * @type \Google\Protobuf\Timestamp $state_start_time
+ * Output-only. The time this state was entered.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Operations::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/ClusterOperationStatus_State.php b/Dataproc/src/V1/ClusterOperationStatus_State.php
index 7bbb6149bda6..9cd399752065 100644
--- a/Dataproc/src/V1/ClusterOperationStatus_State.php
+++ b/Dataproc/src/V1/ClusterOperationStatus_State.php
@@ -4,36 +4,13 @@
namespace Google\Cloud\Dataproc\V1;
-/**
- * The operation state.
- *
- * Protobuf enum Google\Cloud\Dataproc\V1\ClusterOperationStatus\State
- */
-class ClusterOperationStatus_State
-{
+if (false) {
/**
- * Unused.
- *
- * Generated from protobuf enum UNKNOWN = 0;
+ * This class is deprecated. Use Google\Cloud\Dataproc\V1\ClusterOperationStatus\State instead.
+ * @deprecated
*/
- const UNKNOWN = 0;
- /**
- * The operation has been created.
- *
- * Generated from protobuf enum PENDING = 1;
- */
- const PENDING = 1;
- /**
- * The operation is running.
- *
- * Generated from protobuf enum RUNNING = 2;
- */
- const RUNNING = 2;
- /**
- * The operation is done; either cancelled or completed.
- *
- * Generated from protobuf enum DONE = 3;
- */
- const DONE = 3;
+ class ClusterOperationStatus_State {}
}
+class_exists(ClusterOperationStatus\State::class);
+@trigger_error('Google\Cloud\Dataproc\V1\ClusterOperationStatus_State is deprecated and will be removed in the next major release. Use Google\Cloud\Dataproc\V1\ClusterOperationStatus\State instead', E_USER_DEPRECATED);
diff --git a/Dataproc/src/V1/ClusterStatus.php b/Dataproc/src/V1/ClusterStatus.php
index 661e06e0bd26..8332ee1e0b18 100644
--- a/Dataproc/src/V1/ClusterStatus.php
+++ b/Dataproc/src/V1/ClusterStatus.php
@@ -41,9 +41,26 @@ class ClusterStatus extends \Google\Protobuf\Internal\Message
*/
private $substate = 0;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type int $state
+ * Output-only. The cluster's state.
+ * @type string $detail
+ * Output-only. Optional details of cluster's state.
+ * @type \Google\Protobuf\Timestamp $state_start_time
+ * Output-only. Time when this state was entered.
+ * @type int $substate
+ * Output-only. Additional state information that includes
+ * status reported by the agent.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/ClusterStatus_State.php b/Dataproc/src/V1/ClusterStatus_State.php
index 28e1dd88b18c..b3bb415e4843 100644
--- a/Dataproc/src/V1/ClusterStatus_State.php
+++ b/Dataproc/src/V1/ClusterStatus_State.php
@@ -4,48 +4,13 @@
namespace Google\Cloud\Dataproc\V1;
-/**
- * The cluster state.
- *
- * Protobuf enum Google\Cloud\Dataproc\V1\ClusterStatus\State
- */
-class ClusterStatus_State
-{
+if (false) {
/**
- * The cluster state is unknown.
- *
- * Generated from protobuf enum UNKNOWN = 0;
+ * This class is deprecated. Use Google\Cloud\Dataproc\V1\ClusterStatus\State instead.
+ * @deprecated
*/
- const UNKNOWN = 0;
- /**
- * The cluster is being created and set up. It is not ready for use.
- *
- * Generated from protobuf enum CREATING = 1;
- */
- const CREATING = 1;
- /**
- * The cluster is currently running and healthy. It is ready for use.
- *
- * Generated from protobuf enum RUNNING = 2;
- */
- const RUNNING = 2;
- /**
- * The cluster encountered an error. It is not ready for use.
- *
- * Generated from protobuf enum ERROR = 3;
- */
- const ERROR = 3;
- /**
- * The cluster is being deleted. It cannot be used.
- *
- * Generated from protobuf enum DELETING = 4;
- */
- const DELETING = 4;
- /**
- * The cluster is being updated. It continues to accept and process jobs.
- *
- * Generated from protobuf enum UPDATING = 5;
- */
- const UPDATING = 5;
+ class ClusterStatus_State {}
}
+class_exists(ClusterStatus\State::class);
+@trigger_error('Google\Cloud\Dataproc\V1\ClusterStatus_State is deprecated and will be removed in the next major release. Use Google\Cloud\Dataproc\V1\ClusterStatus\State instead', E_USER_DEPRECATED);
diff --git a/Dataproc/src/V1/ClusterStatus_Substate.php b/Dataproc/src/V1/ClusterStatus_Substate.php
index 4efc6e243da5..4cdaad7f3c5c 100644
--- a/Dataproc/src/V1/ClusterStatus_Substate.php
+++ b/Dataproc/src/V1/ClusterStatus_Substate.php
@@ -4,31 +4,13 @@
namespace Google\Cloud\Dataproc\V1;
-/**
- * Protobuf enum Google\Cloud\Dataproc\V1\ClusterStatus\Substate
- */
-class ClusterStatus_Substate
-{
+if (false) {
/**
- * Generated from protobuf enum UNSPECIFIED = 0;
+ * This class is deprecated. Use Google\Cloud\Dataproc\V1\ClusterStatus\Substate instead.
+ * @deprecated
*/
- const UNSPECIFIED = 0;
- /**
- * The cluster is known to be in an unhealthy state
- * (for example, critical daemons are not running or HDFS capacity is
- * exhausted).
- * Applies to RUNNING state.
- *
- * Generated from protobuf enum UNHEALTHY = 1;
- */
- const UNHEALTHY = 1;
- /**
- * The agent-reported status is out of date (may occur if
- * Cloud Dataproc loses communication with Agent).
- * Applies to RUNNING state.
- *
- * Generated from protobuf enum STALE_STATUS = 2;
- */
- const STALE_STATUS = 2;
+ class ClusterStatus_Substate {}
}
+class_exists(ClusterStatus\Substate::class);
+@trigger_error('Google\Cloud\Dataproc\V1\ClusterStatus_Substate is deprecated and will be removed in the next major release. Use Google\Cloud\Dataproc\V1\ClusterStatus\Substate instead', E_USER_DEPRECATED);
diff --git a/Dataproc/src/V1/CreateClusterRequest.php b/Dataproc/src/V1/CreateClusterRequest.php
index b428657f7f10..f5154a4566db 100644
--- a/Dataproc/src/V1/CreateClusterRequest.php
+++ b/Dataproc/src/V1/CreateClusterRequest.php
@@ -35,9 +35,24 @@ class CreateClusterRequest extends \Google\Protobuf\Internal\Message
*/
private $cluster = null;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $project_id
+ * Required. The ID of the Google Cloud Platform project that the cluster
+ * belongs to.
+ * @type string $region
+ * Required. The Cloud Dataproc region in which to handle the request.
+ * @type \Google\Cloud\Dataproc\V1\Cluster $cluster
+ * Required. The cluster to create.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/DeleteClusterRequest.php b/Dataproc/src/V1/DeleteClusterRequest.php
index 0babcb323ab5..c386f9291059 100644
--- a/Dataproc/src/V1/DeleteClusterRequest.php
+++ b/Dataproc/src/V1/DeleteClusterRequest.php
@@ -35,9 +35,24 @@ class DeleteClusterRequest extends \Google\Protobuf\Internal\Message
*/
private $cluster_name = '';
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $project_id
+ * Required. The ID of the Google Cloud Platform project that the cluster
+ * belongs to.
+ * @type string $region
+ * Required. The Cloud Dataproc region in which to handle the request.
+ * @type string $cluster_name
+ * Required. The cluster name.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/DeleteJobRequest.php b/Dataproc/src/V1/DeleteJobRequest.php
index d6665a23965a..47f21a145858 100644
--- a/Dataproc/src/V1/DeleteJobRequest.php
+++ b/Dataproc/src/V1/DeleteJobRequest.php
@@ -35,9 +35,24 @@ class DeleteJobRequest extends \Google\Protobuf\Internal\Message
*/
private $job_id = '';
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $project_id
+ * Required. The ID of the Google Cloud Platform project that the job
+ * belongs to.
+ * @type string $region
+ * Required. The Cloud Dataproc region in which to handle the request.
+ * @type string $job_id
+ * Required. The job ID.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/DiagnoseClusterRequest.php b/Dataproc/src/V1/DiagnoseClusterRequest.php
index 7e04c38abc1c..e900d60b077a 100644
--- a/Dataproc/src/V1/DiagnoseClusterRequest.php
+++ b/Dataproc/src/V1/DiagnoseClusterRequest.php
@@ -35,9 +35,24 @@ class DiagnoseClusterRequest extends \Google\Protobuf\Internal\Message
*/
private $cluster_name = '';
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $project_id
+ * Required. The ID of the Google Cloud Platform project that the cluster
+ * belongs to.
+ * @type string $region
+ * Required. The Cloud Dataproc region in which to handle the request.
+ * @type string $cluster_name
+ * Required. The cluster name.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/DiagnoseClusterResults.php b/Dataproc/src/V1/DiagnoseClusterResults.php
index b5c3f45cd58d..8f0ec2a24208 100644
--- a/Dataproc/src/V1/DiagnoseClusterResults.php
+++ b/Dataproc/src/V1/DiagnoseClusterResults.php
@@ -24,9 +24,21 @@ class DiagnoseClusterResults extends \Google\Protobuf\Internal\Message
*/
private $output_uri = '';
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $output_uri
+ * Output-only. The Google Cloud Storage URI of the diagnostic output.
+ * The output report is a plain text file with a summary of collected
+ * diagnostics.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/DiskConfig.php b/Dataproc/src/V1/DiskConfig.php
index b17f44be5ee0..6f5a30e6c04b 100644
--- a/Dataproc/src/V1/DiskConfig.php
+++ b/Dataproc/src/V1/DiskConfig.php
@@ -33,9 +33,26 @@ class DiskConfig extends \Google\Protobuf\Internal\Message
*/
private $num_local_ssds = 0;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type int $boot_disk_size_gb
+ * Optional. Size in GB of the boot disk (default is 500GB).
+ * @type int $num_local_ssds
+ * Optional. Number of attached SSDs, from 0 to 4 (default is 0).
+ * If SSDs are not attached, the boot disk is used to store runtime logs and
+ * [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data.
+ * If one or more SSDs are attached, this runtime bulk
+ * data is spread across them, and the boot disk contains only basic
+ * config and installed binaries.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/Gapic/JobControllerGapicClient.php b/Dataproc/src/V1/Gapic/JobControllerGapicClient.php
index c078d9c31029..6111c0e7dd9e 100644
--- a/Dataproc/src/V1/Gapic/JobControllerGapicClient.php
+++ b/Dataproc/src/V1/Gapic/JobControllerGapicClient.php
@@ -321,7 +321,7 @@ public function getJob($projectId, $region, $jobId, array $optionalArgs = [])
* (default = match ALL jobs).
*
* If `filter` is provided, `jobStateMatcher` will be ignored.
- * For allowed values, use constants defined on {@see \Google\Cloud\Dataproc\V1\ListJobsRequest_JobStateMatcher}
+ * For allowed values, use constants defined on {@see \Google\Cloud\Dataproc\V1\ListJobsRequest\JobStateMatcher}
* @type string $filter
* Optional. A filter constraining the jobs to list. Filters are
* case-sensitive and have the following syntax:
diff --git a/Dataproc/src/V1/GceClusterConfig.php b/Dataproc/src/V1/GceClusterConfig.php
index 43423195fabf..8f9044c85069 100644
--- a/Dataproc/src/V1/GceClusterConfig.php
+++ b/Dataproc/src/V1/GceClusterConfig.php
@@ -110,9 +110,78 @@ class GceClusterConfig extends \Google\Protobuf\Internal\Message
*/
private $metadata;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $zone_uri
+ * Optional. The zone where the Google Compute Engine cluster will be located.
+ * On a create request, it is required in the "global" region. If omitted
+ * in a non-global Cloud Dataproc region, the service will pick a zone in the
+ * corresponding Compute Engine region. On a get request, zone will
+ * always be present.
+ * A full URL, partial URI, or short name are valid. Examples:
+ * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]`
+ * * `projects/[project_id]/zones/[zone]`
+ * * `us-central1-f`
+ * @type string $network_uri
+ * Optional. The Google Compute Engine network to be used for machine
+ * communications. Cannot be specified with subnetwork_uri. If neither
+ * `network_uri` nor `subnetwork_uri` is specified, the "default" network of
+ * the project is used, if it exists. Cannot be a "Custom Subnet Network" (see
+ * [Using Subnetworks](/compute/docs/subnetworks) for more information).
+ * A full URL, partial URI, or short name are valid. Examples:
+ * * `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default`
+ * * `projects/[project_id]/regions/global/default`
+ * * `default`
+ * @type string $subnetwork_uri
+ * Optional. The Google Compute Engine subnetwork to be used for machine
+ * communications. Cannot be specified with network_uri.
+ * A full URL, partial URI, or short name are valid. Examples:
+ * * `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/sub0`
+ * * `projects/[project_id]/regions/us-east1/sub0`
+ * * `sub0`
+ * @type bool $internal_ip_only
+ * Optional. If true, all instances in the cluster will only have internal IP
+ * addresses. By default, clusters are not restricted to internal IP addresses,
+ * and will have ephemeral external IP addresses assigned to each instance.
+ * This `internal_ip_only` restriction can only be enabled for subnetwork
+ * enabled networks, and all off-cluster dependencies must be configured to be
+ * accessible without external IP addresses.
+ * @type string $service_account
+ * Optional. The service account of the instances. Defaults to the default
+ * Google Compute Engine service account. Custom service accounts need
+ * permissions equivalent to the folloing IAM roles:
+ * * roles/logging.logWriter
+ * * roles/storage.objectAdmin
+ * (see https://cloud.google.com/compute/docs/access/service-accounts#custom_service_accounts
+ * for more information).
+ * Example: `[account_id]@[project_id].iam.gserviceaccount.com`
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $service_account_scopes
+ * Optional. The URIs of service account scopes to be included in Google
+ * Compute Engine instances. The following base set of scopes is always
+ * included:
+ * * https://www.googleapis.com/auth/cloud.useraccounts.readonly
+ * * https://www.googleapis.com/auth/devstorage.read_write
+ * * https://www.googleapis.com/auth/logging.write
+ * If no scopes are specified, the following defaults are also provided:
+ * * https://www.googleapis.com/auth/bigquery
+ * * https://www.googleapis.com/auth/bigtable.admin.table
+ * * https://www.googleapis.com/auth/bigtable.data
+ * * https://www.googleapis.com/auth/devstorage.full_control
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $tags
+ * The Google Compute Engine tags to add to all instances (see
+ * [Tagging instances](/compute/docs/label-or-tag-resources#tags)).
+ * @type array|\Google\Protobuf\Internal\MapField $metadata
+ * The Google Compute Engine metadata entries to add to all instances (see
+ * [Project and instance metadata](https://cloud.google.com/compute/docs/storing-retrieving-metadata#project_and_instance_metadata)).
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/GetClusterRequest.php b/Dataproc/src/V1/GetClusterRequest.php
index be8dd6fcc83f..f265114193a9 100644
--- a/Dataproc/src/V1/GetClusterRequest.php
+++ b/Dataproc/src/V1/GetClusterRequest.php
@@ -35,9 +35,24 @@ class GetClusterRequest extends \Google\Protobuf\Internal\Message
*/
private $cluster_name = '';
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $project_id
+ * Required. The ID of the Google Cloud Platform project that the cluster
+ * belongs to.
+ * @type string $region
+ * Required. The Cloud Dataproc region in which to handle the request.
+ * @type string $cluster_name
+ * Required. The cluster name.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/GetJobRequest.php b/Dataproc/src/V1/GetJobRequest.php
index 066b58ad9448..25bbf3db2453 100644
--- a/Dataproc/src/V1/GetJobRequest.php
+++ b/Dataproc/src/V1/GetJobRequest.php
@@ -35,9 +35,24 @@ class GetJobRequest extends \Google\Protobuf\Internal\Message
*/
private $job_id = '';
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $project_id
+ * Required. The ID of the Google Cloud Platform project that the job
+ * belongs to.
+ * @type string $region
+ * Required. The Cloud Dataproc region in which to handle the request.
+ * @type string $job_id
+ * Required. The job ID.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/HadoopJob.php b/Dataproc/src/V1/HadoopJob.php
index 3e522136a16d..305837e27e2d 100644
--- a/Dataproc/src/V1/HadoopJob.php
+++ b/Dataproc/src/V1/HadoopJob.php
@@ -66,9 +66,49 @@ class HadoopJob extends \Google\Protobuf\Internal\Message
private $logging_config = null;
protected $driver;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $main_jar_file_uri
+ * The HCFS URI of the jar file containing the main class.
+ * Examples:
+ * 'gs://foo-bucket/analytics-binaries/extract-useful-metrics-mr.jar'
+ * 'hdfs:/tmp/test-samples/custom-wordcount.jar'
+ * 'file:///home/usr/lib/hadoop-mapreduce/hadoop-mapreduce-examples.jar'
+ * @type string $main_class
+ * The name of the driver's main class. The jar file containing the class
+ * must be in the default CLASSPATH or specified in `jar_file_uris`.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $args
+ * Optional. The arguments to pass to the driver. Do not
+ * include arguments, such as `-libjars` or `-Dfoo=bar`, that can be set as job
+ * properties, since a collision may occur that causes an incorrect job
+ * submission.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $jar_file_uris
+ * Optional. Jar file URIs to add to the CLASSPATHs of the
+ * Hadoop driver and tasks.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $file_uris
+ * Optional. HCFS (Hadoop Compatible Filesystem) URIs of files to be copied
+ * to the working directory of Hadoop drivers and distributed tasks. Useful
+ * for naively parallel tasks.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $archive_uris
+ * Optional. HCFS URIs of archives to be extracted in the working directory of
+ * Hadoop drivers and tasks. Supported file types:
+ * .jar, .tar, .tar.gz, .tgz, or .zip.
+ * @type array|\Google\Protobuf\Internal\MapField $properties
+ * Optional. A mapping of property names to values, used to configure Hadoop.
+ * Properties that conflict with values set by the Cloud Dataproc API may be
+ * overwritten. Can include properties set in /etc/hadoop/conf/*-site and
+ * classes in user code.
+ * @type \Google\Cloud\Dataproc\V1\LoggingConfig $logging_config
+ * Optional. The runtime log config for job execution.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/HiveJob.php b/Dataproc/src/V1/HiveJob.php
index 6466bfd9227b..43c32d6cc38a 100644
--- a/Dataproc/src/V1/HiveJob.php
+++ b/Dataproc/src/V1/HiveJob.php
@@ -50,9 +50,37 @@ class HiveJob extends \Google\Protobuf\Internal\Message
private $jar_file_uris;
protected $queries;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $query_file_uri
+ * The HCFS URI of the script that contains Hive queries.
+ * @type \Google\Cloud\Dataproc\V1\QueryList $query_list
+ * A list of queries.
+ * @type bool $continue_on_failure
+ * Optional. Whether to continue executing queries if a query fails.
+ * The default value is `false`. Setting to `true` can be useful when executing
+ * independent parallel queries.
+ * @type array|\Google\Protobuf\Internal\MapField $script_variables
+ * Optional. Mapping of query variable names to values (equivalent to the
+ * Hive command: `SET name="value";`).
+ * @type array|\Google\Protobuf\Internal\MapField $properties
+ * Optional. A mapping of property names and values, used to configure Hive.
+ * Properties that conflict with values set by the Cloud Dataproc API may be
+ * overwritten. Can include properties set in /etc/hadoop/conf/*-site.xml,
+ * /etc/hive/conf/hive-site.xml, and classes in user code.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $jar_file_uris
+ * Optional. HCFS URIs of jar files to add to the CLASSPATH of the
+ * Hive server and Hadoop MapReduce (MR) tasks. Can contain Hive SerDes
+ * and UDFs.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/InstanceGroupConfig.php b/Dataproc/src/V1/InstanceGroupConfig.php
index caa7178b6ba3..e6d61adba6ec 100644
--- a/Dataproc/src/V1/InstanceGroupConfig.php
+++ b/Dataproc/src/V1/InstanceGroupConfig.php
@@ -78,9 +78,46 @@ class InstanceGroupConfig extends \Google\Protobuf\Internal\Message
*/
private $accelerators;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type int $num_instances
+ * Optional. The number of VM instances in the instance group.
+ * For master instance groups, must be set to 1.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $instance_names
+ * Optional. The list of instance names. Cloud Dataproc derives the names from
+ * `cluster_name`, `num_instances`, and the instance group if not set by user
+ * (recommended practice is to let Cloud Dataproc derive the name).
+ * @type string $image_uri
+ * Output-only. The Google Compute Engine image resource used for cluster
+ * instances. Inferred from `SoftwareConfig.image_version`.
+ * @type string $machine_type_uri
+ * Optional. The Google Compute Engine machine type used for cluster instances.
+ * A full URL, partial URI, or short name are valid. Examples:
+ * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`
+ * * `projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`
+ * * `n1-standard-2`
+ * @type \Google\Cloud\Dataproc\V1\DiskConfig $disk_config
+ * Optional. Disk option config settings.
+ * @type bool $is_preemptible
+ * Optional. Specifies that this instance group contains preemptible instances.
+ * @type \Google\Cloud\Dataproc\V1\ManagedGroupConfig $managed_group_config
+ * Output-only. The config for Google Compute Engine Instance Group
+ * Manager that manages this group.
+ * This is only used for preemptible instance groups.
+ * @type \Google\Cloud\Dataproc\V1\AcceleratorConfig[]|\Google\Protobuf\Internal\RepeatedField $accelerators
+ * Optional. The Google Compute Engine accelerator configuration for these
+ * instances.
+ * **Beta Feature**: This feature is still under development. It may be
+ * changed before final release.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/Job.php b/Dataproc/src/V1/Job.php
index a8b57f43bf89..896e9f1c7e41 100644
--- a/Dataproc/src/V1/Job.php
+++ b/Dataproc/src/V1/Job.php
@@ -87,9 +87,63 @@ class Job extends \Google\Protobuf\Internal\Message
private $scheduling = null;
protected $type_job;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type \Google\Cloud\Dataproc\V1\JobReference $reference
+ * Optional. The fully qualified reference to the job, which can be used to
+ * obtain the equivalent REST path of the job resource. If this property
+ * is not specified when a job is created, the server generates a
+ * job_id
.
+ * @type \Google\Cloud\Dataproc\V1\JobPlacement $placement
+ * Required. Job information, including how, when, and where to
+ * run the job.
+ * @type \Google\Cloud\Dataproc\V1\HadoopJob $hadoop_job
+ * Job is a Hadoop job.
+ * @type \Google\Cloud\Dataproc\V1\SparkJob $spark_job
+ * Job is a Spark job.
+ * @type \Google\Cloud\Dataproc\V1\PySparkJob $pyspark_job
+ * Job is a Pyspark job.
+ * @type \Google\Cloud\Dataproc\V1\HiveJob $hive_job
+ * Job is a Hive job.
+ * @type \Google\Cloud\Dataproc\V1\PigJob $pig_job
+ * Job is a Pig job.
+ * @type \Google\Cloud\Dataproc\V1\SparkSqlJob $spark_sql_job
+ * Job is a SparkSql job.
+ * @type \Google\Cloud\Dataproc\V1\JobStatus $status
+ * Output-only. The job status. Additional application-specific
+ * status information may be contained in the type_job
+ * and yarn_applications
fields.
+ * @type \Google\Cloud\Dataproc\V1\JobStatus[]|\Google\Protobuf\Internal\RepeatedField $status_history
+ * Output-only. The previous job status.
+ * @type \Google\Cloud\Dataproc\V1\YarnApplication[]|\Google\Protobuf\Internal\RepeatedField $yarn_applications
+ * Output-only. The collection of YARN applications spun up by this job.
+ * **Beta** Feature: This report is available for testing purposes only. It may
+ * be changed before final release.
+ * @type string $driver_output_resource_uri
+ * Output-only. A URI pointing to the location of the stdout of the job's
+ * driver program.
+ * @type string $driver_control_files_uri
+ * Output-only. If present, the location of miscellaneous control files
+ * which may be used as part of job setup and handling. If not present,
+ * control files may be placed in the same location as `driver_output_uri`.
+ * @type array|\Google\Protobuf\Internal\MapField $labels
+ * Optional. The labels to associate with this job.
+ * Label **keys** must contain 1 to 63 characters, and must conform to
+ * [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
+ * Label **values** may be empty, but, if present, must contain 1 to 63
+ * characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
+ * No more than 32 labels can be associated with a job.
+ * @type \Google\Cloud\Dataproc\V1\JobScheduling $scheduling
+ * Optional. Job scheduling configuration.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/JobPlacement.php b/Dataproc/src/V1/JobPlacement.php
index 85fce66a21b7..702396870ceb 100644
--- a/Dataproc/src/V1/JobPlacement.php
+++ b/Dataproc/src/V1/JobPlacement.php
@@ -29,9 +29,22 @@ class JobPlacement extends \Google\Protobuf\Internal\Message
*/
private $cluster_uuid = '';
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $cluster_name
+ * Required. The name of the cluster where the job will be submitted.
+ * @type string $cluster_uuid
+ * Output-only. A cluster UUID generated by the Cloud Dataproc service when
+ * the job is submitted.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/JobReference.php b/Dataproc/src/V1/JobReference.php
index ff422d1a1b71..fd97a62a65cd 100644
--- a/Dataproc/src/V1/JobReference.php
+++ b/Dataproc/src/V1/JobReference.php
@@ -33,9 +33,26 @@ class JobReference extends \Google\Protobuf\Internal\Message
*/
private $job_id = '';
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $project_id
+ * Required. The ID of the Google Cloud Platform project that the job
+ * belongs to.
+ * @type string $job_id
+ * Optional. The job ID, which must be unique within the project. The job ID
+ * is generated by the server upon job submission or provided by the user as a
+ * means to perform retries without creating duplicate jobs. The ID must
+ * contain only letters (a-z, A-Z), numbers (0-9), underscores (_), or
+ * hyphens (-). The maximum length is 100 characters.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/JobScheduling.php b/Dataproc/src/V1/JobScheduling.php
index 53d4eb10d929..c8b967b55804 100644
--- a/Dataproc/src/V1/JobScheduling.php
+++ b/Dataproc/src/V1/JobScheduling.php
@@ -29,9 +29,24 @@ class JobScheduling extends \Google\Protobuf\Internal\Message
*/
private $max_failures_per_hour = 0;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type int $max_failures_per_hour
+ * Optional. Maximum number of times per hour a driver may be restarted as
+ * a result of driver terminating with non-zero code before job is
+ * reported failed.
+ * A job may be reported as thrashing if driver exits with non-zero code
+ * 4 times within 10 minute window.
+ * Maximum value is 10.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/JobStatus.php b/Dataproc/src/V1/JobStatus.php
index 374c2019d97d..bea4357fda09 100644
--- a/Dataproc/src/V1/JobStatus.php
+++ b/Dataproc/src/V1/JobStatus.php
@@ -42,9 +42,27 @@ class JobStatus extends \Google\Protobuf\Internal\Message
*/
private $substate = 0;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type int $state
+ * Output-only. A state message specifying the overall job state.
+ * @type string $details
+ * Output-only. Optional job state details, such as an error
+ * description if the state is ERROR
.
+ * @type \Google\Protobuf\Timestamp $state_start_time
+ * Output-only. The time when this state was entered.
+ * @type int $substate
+ * Output-only. Additional state information, which includes
+ * status reported by the agent.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/JobStatus_State.php b/Dataproc/src/V1/JobStatus_State.php
index 6582f7046cea..eaa65a96f5dc 100644
--- a/Dataproc/src/V1/JobStatus_State.php
+++ b/Dataproc/src/V1/JobStatus_State.php
@@ -4,76 +4,13 @@
namespace Google\Cloud\Dataproc\V1;
-/**
- * The job state.
- *
- * Protobuf enum Google\Cloud\Dataproc\V1\JobStatus\State
- */
-class JobStatus_State
-{
+if (false) {
/**
- * The job state is unknown.
- *
- * Generated from protobuf enum STATE_UNSPECIFIED = 0;
+ * This class is deprecated. Use Google\Cloud\Dataproc\V1\JobStatus\State instead.
+ * @deprecated
*/
- const STATE_UNSPECIFIED = 0;
- /**
- * The job is pending; it has been submitted, but is not yet running.
- *
- * Generated from protobuf enum PENDING = 1;
- */
- const PENDING = 1;
- /**
- * Job has been received by the service and completed initial setup;
- * it will soon be submitted to the cluster.
- *
- * Generated from protobuf enum SETUP_DONE = 8;
- */
- const SETUP_DONE = 8;
- /**
- * The job is running on the cluster.
- *
- * Generated from protobuf enum RUNNING = 2;
- */
- const RUNNING = 2;
- /**
- * A CancelJob request has been received, but is pending.
- *
- * Generated from protobuf enum CANCEL_PENDING = 3;
- */
- const CANCEL_PENDING = 3;
- /**
- * Transient in-flight resources have been canceled, and the request to
- * cancel the running job has been issued to the cluster.
- *
- * Generated from protobuf enum CANCEL_STARTED = 7;
- */
- const CANCEL_STARTED = 7;
- /**
- * The job cancellation was successful.
- *
- * Generated from protobuf enum CANCELLED = 4;
- */
- const CANCELLED = 4;
- /**
- * The job has completed successfully.
- *
- * Generated from protobuf enum DONE = 5;
- */
- const DONE = 5;
- /**
- * The job has completed, but encountered an error.
- *
- * Generated from protobuf enum ERROR = 6;
- */
- const ERROR = 6;
- /**
- * Job attempt has failed. The detail field contains failure details for
- * this attempt.
- * Applies to restartable jobs only.
- *
- * Generated from protobuf enum ATTEMPT_FAILURE = 9;
- */
- const ATTEMPT_FAILURE = 9;
+ class JobStatus_State {}
}
+class_exists(JobStatus\State::class);
+@trigger_error('Google\Cloud\Dataproc\V1\JobStatus_State is deprecated and will be removed in the next major release. Use Google\Cloud\Dataproc\V1\JobStatus\State instead', E_USER_DEPRECATED);
diff --git a/Dataproc/src/V1/JobStatus_Substate.php b/Dataproc/src/V1/JobStatus_Substate.php
index 171934409f01..ef398f1bbc10 100644
--- a/Dataproc/src/V1/JobStatus_Substate.php
+++ b/Dataproc/src/V1/JobStatus_Substate.php
@@ -4,39 +4,13 @@
namespace Google\Cloud\Dataproc\V1;
-/**
- * Protobuf enum Google\Cloud\Dataproc\V1\JobStatus\Substate
- */
-class JobStatus_Substate
-{
+if (false) {
/**
- * Generated from protobuf enum UNSPECIFIED = 0;
+ * This class is deprecated. Use Google\Cloud\Dataproc\V1\JobStatus\Substate instead.
+ * @deprecated
*/
- const UNSPECIFIED = 0;
- /**
- * The Job is submitted to the agent.
- * Applies to RUNNING state.
- *
- * Generated from protobuf enum SUBMITTED = 1;
- */
- const SUBMITTED = 1;
- /**
- * The Job has been received and is awaiting execution (it may be waiting
- * for a condition to be met). See the "details" field for the reason for
- * the delay.
- * Applies to RUNNING state.
- *
- * Generated from protobuf enum QUEUED = 2;
- */
- const QUEUED = 2;
- /**
- * The agent-reported status is out of date, which may be caused by a
- * loss of communication between the agent and Cloud Dataproc. If the
- * agent does not send a timely update, the job will fail.
- * Applies to RUNNING state.
- *
- * Generated from protobuf enum STALE_STATUS = 3;
- */
- const STALE_STATUS = 3;
+ class JobStatus_Substate {}
}
+class_exists(JobStatus\Substate::class);
+@trigger_error('Google\Cloud\Dataproc\V1\JobStatus_Substate is deprecated and will be removed in the next major release. Use Google\Cloud\Dataproc\V1\JobStatus\Substate instead', E_USER_DEPRECATED);
diff --git a/Dataproc/src/V1/ListClustersRequest.php b/Dataproc/src/V1/ListClustersRequest.php
index 9608dadaa908..b2a2889709c9 100644
--- a/Dataproc/src/V1/ListClustersRequest.php
+++ b/Dataproc/src/V1/ListClustersRequest.php
@@ -61,9 +61,42 @@ class ListClustersRequest extends \Google\Protobuf\Internal\Message
*/
private $page_token = '';
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $project_id
+ * Required. The ID of the Google Cloud Platform project that the cluster
+ * belongs to.
+ * @type string $region
+ * Required. The Cloud Dataproc region in which to handle the request.
+ * @type string $filter
+ * Optional. A filter constraining the clusters to list. Filters are
+ * case-sensitive and have the following syntax:
+ * field = value [AND [field = value]] ...
+ * where **field** is one of `status.state`, `clusterName`, or `labels.[KEY]`,
+ * and `[KEY]` is a label key. **value** can be `*` to match all values.
+ * `status.state` can be one of the following: `ACTIVE`, `INACTIVE`,
+ * `CREATING`, `RUNNING`, `ERROR`, `DELETING`, or `UPDATING`. `ACTIVE`
+ * contains the `CREATING`, `UPDATING`, and `RUNNING` states. `INACTIVE`
+ * contains the `DELETING` and `ERROR` states.
+ * `clusterName` is the name of the cluster provided at creation time.
+ * Only the logical `AND` operator is supported; space-separated items are
+ * treated as having an implicit `AND` operator.
+ * Example filter:
+ * status.state = ACTIVE AND clusterName = mycluster
+ * AND labels.env = staging AND labels.starred = *
+ * @type int $page_size
+ * Optional. The standard List page size.
+ * @type string $page_token
+ * Optional. The standard List page token.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/ListClustersResponse.php b/Dataproc/src/V1/ListClustersResponse.php
index c306d9a96a6c..d850ac1f5390 100644
--- a/Dataproc/src/V1/ListClustersResponse.php
+++ b/Dataproc/src/V1/ListClustersResponse.php
@@ -30,9 +30,23 @@ class ListClustersResponse extends \Google\Protobuf\Internal\Message
*/
private $next_page_token = '';
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type \Google\Cloud\Dataproc\V1\Cluster[]|\Google\Protobuf\Internal\RepeatedField $clusters
+ * Output-only. The clusters in the project.
+ * @type string $next_page_token
+ * Output-only. This token is included in the response if there are more
+ * results to fetch. To fetch additional results, provide this value as the
+ * `page_token` in a subsequent `ListClustersRequest`.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/ListJobsRequest.php b/Dataproc/src/V1/ListJobsRequest.php
index 0cdb9aeb5961..0ea40f7e1c8f 100644
--- a/Dataproc/src/V1/ListJobsRequest.php
+++ b/Dataproc/src/V1/ListJobsRequest.php
@@ -72,9 +72,45 @@ class ListJobsRequest extends \Google\Protobuf\Internal\Message
*/
private $filter = '';
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $project_id
+ * Required. The ID of the Google Cloud Platform project that the job
+ * belongs to.
+ * @type string $region
+ * Required. The Cloud Dataproc region in which to handle the request.
+ * @type int $page_size
+ * Optional. The number of results to return in each response.
+ * @type string $page_token
+ * Optional. The page token, returned by a previous call, to request the
+ * next page of results.
+ * @type string $cluster_name
+ * Optional. If set, the returned jobs list includes only jobs that were
+ * submitted to the named cluster.
+ * @type int $job_state_matcher
+ * Optional. Specifies enumerated categories of jobs to list.
+ * (default = match ALL jobs).
+ * If `filter` is provided, `jobStateMatcher` will be ignored.
+ * @type string $filter
+ * Optional. A filter constraining the jobs to list. Filters are
+ * case-sensitive and have the following syntax:
+ * [field = value] AND [field [= value]] ...
+ * where **field** is `status.state` or `labels.[KEY]`, and `[KEY]` is a label
+ * key. **value** can be `*` to match all values.
+ * `status.state` can be either `ACTIVE` or `NON_ACTIVE`.
+ * Only the logical `AND` operator is supported; space-separated items are
+ * treated as having an implicit `AND` operator.
+ * Example filter:
+ * status.state = ACTIVE AND labels.env = staging AND labels.starred = *
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/ListJobsRequest_JobStateMatcher.php b/Dataproc/src/V1/ListJobsRequest_JobStateMatcher.php
index 19798c1d21c1..ab43f4d892da 100644
--- a/Dataproc/src/V1/ListJobsRequest_JobStateMatcher.php
+++ b/Dataproc/src/V1/ListJobsRequest_JobStateMatcher.php
@@ -4,31 +4,13 @@
namespace Google\Cloud\Dataproc\V1;
-/**
- * A matcher that specifies categories of job states.
- *
- * Protobuf enum Google\Cloud\Dataproc\V1\ListJobsRequest\JobStateMatcher
- */
-class ListJobsRequest_JobStateMatcher
-{
+if (false) {
/**
- * Match all jobs, regardless of state.
- *
- * Generated from protobuf enum ALL = 0;
+ * This class is deprecated. Use Google\Cloud\Dataproc\V1\ListJobsRequest\JobStateMatcher instead.
+ * @deprecated
*/
- const ALL = 0;
- /**
- * Only match jobs in non-terminal states: PENDING, RUNNING, or
- * CANCEL_PENDING.
- *
- * Generated from protobuf enum ACTIVE = 1;
- */
- const ACTIVE = 1;
- /**
- * Only match jobs in terminal states: CANCELLED, DONE, or ERROR.
- *
- * Generated from protobuf enum NON_ACTIVE = 2;
- */
- const NON_ACTIVE = 2;
+ class ListJobsRequest_JobStateMatcher {}
}
+class_exists(ListJobsRequest\JobStateMatcher::class);
+@trigger_error('Google\Cloud\Dataproc\V1\ListJobsRequest_JobStateMatcher is deprecated and will be removed in the next major release. Use Google\Cloud\Dataproc\V1\ListJobsRequest\JobStateMatcher instead', E_USER_DEPRECATED);
diff --git a/Dataproc/src/V1/ListJobsResponse.php b/Dataproc/src/V1/ListJobsResponse.php
index e7295272a34c..e2b105a94508 100644
--- a/Dataproc/src/V1/ListJobsResponse.php
+++ b/Dataproc/src/V1/ListJobsResponse.php
@@ -30,9 +30,23 @@ class ListJobsResponse extends \Google\Protobuf\Internal\Message
*/
private $next_page_token = '';
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type \Google\Cloud\Dataproc\V1\Job[]|\Google\Protobuf\Internal\RepeatedField $jobs
+ * Output-only. Jobs list.
+ * @type string $next_page_token
+ * Optional. This token is included in the response if there are more results
+ * to fetch. To fetch additional results, provide this value as the
+ * `page_token` in a subsequent ListJobsRequest
.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/LoggingConfig.php b/Dataproc/src/V1/LoggingConfig.php
index f67904982cc5..7ccdf43a9660 100644
--- a/Dataproc/src/V1/LoggingConfig.php
+++ b/Dataproc/src/V1/LoggingConfig.php
@@ -25,9 +25,22 @@ class LoggingConfig extends \Google\Protobuf\Internal\Message
*/
private $driver_log_levels;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type array|\Google\Protobuf\Internal\MapField $driver_log_levels
+ * The per-package log levels for the driver. This may include
+ * "root" package name to configure rootLogger.
+ * Examples:
+ * 'com.google = FATAL', 'root = INFO', 'org.apache = DEBUG'
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
@@ -56,7 +69,7 @@ public function getDriverLogLevels()
*/
public function setDriverLogLevels($var)
{
- $arr = GPBUtil::checkMapField($var, \Google\Protobuf\Internal\GPBType::STRING, \Google\Protobuf\Internal\GPBType::ENUM, \Google\Cloud\Dataproc\V1\LoggingConfig_Level::class);
+ $arr = GPBUtil::checkMapField($var, \Google\Protobuf\Internal\GPBType::STRING, \Google\Protobuf\Internal\GPBType::ENUM, \Google\Cloud\Dataproc\V1\LoggingConfig\Level::class);
$this->driver_log_levels = $arr;
return $this;
diff --git a/Dataproc/src/V1/LoggingConfig_Level.php b/Dataproc/src/V1/LoggingConfig_Level.php
index 4937ba11817c..3870455439fc 100644
--- a/Dataproc/src/V1/LoggingConfig_Level.php
+++ b/Dataproc/src/V1/LoggingConfig_Level.php
@@ -4,68 +4,13 @@
namespace Google\Cloud\Dataproc\V1;
-/**
- * The Log4j level for job execution. When running an
- * [Apache Hive](http://hive.apache.org/) job, Cloud
- * Dataproc configures the Hive client to an equivalent verbosity level.
- *
- * Protobuf enum Google\Cloud\Dataproc\V1\LoggingConfig\Level
- */
-class LoggingConfig_Level
-{
+if (false) {
/**
- * Level is unspecified. Use default level for log4j.
- *
- * Generated from protobuf enum LEVEL_UNSPECIFIED = 0;
+ * This class is deprecated. Use Google\Cloud\Dataproc\V1\LoggingConfig\Level instead.
+ * @deprecated
*/
- const LEVEL_UNSPECIFIED = 0;
- /**
- * Use ALL level for log4j.
- *
- * Generated from protobuf enum ALL = 1;
- */
- const ALL = 1;
- /**
- * Use TRACE level for log4j.
- *
- * Generated from protobuf enum TRACE = 2;
- */
- const TRACE = 2;
- /**
- * Use DEBUG level for log4j.
- *
- * Generated from protobuf enum DEBUG = 3;
- */
- const DEBUG = 3;
- /**
- * Use INFO level for log4j.
- *
- * Generated from protobuf enum INFO = 4;
- */
- const INFO = 4;
- /**
- * Use WARN level for log4j.
- *
- * Generated from protobuf enum WARN = 5;
- */
- const WARN = 5;
- /**
- * Use ERROR level for log4j.
- *
- * Generated from protobuf enum ERROR = 6;
- */
- const ERROR = 6;
- /**
- * Use FATAL level for log4j.
- *
- * Generated from protobuf enum FATAL = 7;
- */
- const FATAL = 7;
- /**
- * Turn off log4j.
- *
- * Generated from protobuf enum OFF = 8;
- */
- const OFF = 8;
+ class LoggingConfig_Level {}
}
+class_exists(LoggingConfig\Level::class);
+@trigger_error('Google\Cloud\Dataproc\V1\LoggingConfig_Level is deprecated and will be removed in the next major release. Use Google\Cloud\Dataproc\V1\LoggingConfig\Level instead', E_USER_DEPRECATED);
diff --git a/Dataproc/src/V1/ManagedGroupConfig.php b/Dataproc/src/V1/ManagedGroupConfig.php
index 833b8c34b6d1..2668e9790318 100644
--- a/Dataproc/src/V1/ManagedGroupConfig.php
+++ b/Dataproc/src/V1/ManagedGroupConfig.php
@@ -29,9 +29,22 @@ class ManagedGroupConfig extends \Google\Protobuf\Internal\Message
*/
private $instance_group_manager_name = '';
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $instance_template_name
+ * Output-only. The name of the Instance Template used for the Managed
+ * Instance Group.
+ * @type string $instance_group_manager_name
+ * Output-only. The name of the Instance Group Manager for this group.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/NodeInitializationAction.php b/Dataproc/src/V1/NodeInitializationAction.php
index 54ffca58abf5..283d2ba9ccb7 100644
--- a/Dataproc/src/V1/NodeInitializationAction.php
+++ b/Dataproc/src/V1/NodeInitializationAction.php
@@ -32,9 +32,24 @@ class NodeInitializationAction extends \Google\Protobuf\Internal\Message
*/
private $execution_timeout = null;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $executable_file
+ * Required. Google Cloud Storage URI of executable file.
+ * @type \Google\Protobuf\Duration $execution_timeout
+ * Optional. Amount of time executable has to complete. Default is
+ * 10 minutes. Cluster creation fails with an explanatory error message (the
+ * name of the executable that caused the error and the exceeded timeout
+ * period) if the executable is not completed at end of the timeout period.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/PigJob.php b/Dataproc/src/V1/PigJob.php
index 723656dc3192..d730aa60f6d8 100644
--- a/Dataproc/src/V1/PigJob.php
+++ b/Dataproc/src/V1/PigJob.php
@@ -55,9 +55,38 @@ class PigJob extends \Google\Protobuf\Internal\Message
private $logging_config = null;
protected $queries;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $query_file_uri
+ * The HCFS URI of the script that contains the Pig queries.
+ * @type \Google\Cloud\Dataproc\V1\QueryList $query_list
+ * A list of queries.
+ * @type bool $continue_on_failure
+ * Optional. Whether to continue executing queries if a query fails.
+ * The default value is `false`. Setting to `true` can be useful when executing
+ * independent parallel queries.
+ * @type array|\Google\Protobuf\Internal\MapField $script_variables
+ * Optional. Mapping of query variable names to values (equivalent to the Pig
+ * command: `name=[value]`).
+ * @type array|\Google\Protobuf\Internal\MapField $properties
+ * Optional. A mapping of property names to values, used to configure Pig.
+ * Properties that conflict with values set by the Cloud Dataproc API may be
+ * overwritten. Can include properties set in /etc/hadoop/conf/*-site.xml,
+ * /etc/pig/conf/pig.properties, and classes in user code.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $jar_file_uris
+ * Optional. HCFS URIs of jar files to add to the CLASSPATH of
+ * the Pig Client and Hadoop MapReduce (MR) tasks. Can contain Pig UDFs.
+ * @type \Google\Cloud\Dataproc\V1\LoggingConfig $logging_config
+ * Optional. The runtime log config for job execution.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/PySparkJob.php b/Dataproc/src/V1/PySparkJob.php
index ea74c2986c48..79ca0d99b52a 100644
--- a/Dataproc/src/V1/PySparkJob.php
+++ b/Dataproc/src/V1/PySparkJob.php
@@ -76,9 +76,43 @@ class PySparkJob extends \Google\Protobuf\Internal\Message
*/
private $logging_config = null;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $main_python_file_uri
+ * Required. The HCFS URI of the main Python file to use as the driver. Must
+ * be a .py file.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $args
+ * Optional. The arguments to pass to the driver. Do not include arguments,
+ * such as `--conf`, that can be set as job properties, since a collision may
+ * occur that causes an incorrect job submission.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $python_file_uris
+ * Optional. HCFS file URIs of Python files to pass to the PySpark
+ * framework. Supported file types: .py, .egg, and .zip.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $jar_file_uris
+ * Optional. HCFS URIs of jar files to add to the CLASSPATHs of the
+ * Python driver and tasks.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $file_uris
+ * Optional. HCFS URIs of files to be copied to the working directory of
+ * Python drivers and distributed tasks. Useful for naively parallel tasks.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $archive_uris
+ * Optional. HCFS URIs of archives to be extracted in the working directory of
+ * .jar, .tar, .tar.gz, .tgz, and .zip.
+ * @type array|\Google\Protobuf\Internal\MapField $properties
+ * Optional. A mapping of property names to values, used to configure PySpark.
+ * Properties that conflict with values set by the Cloud Dataproc API may be
+ * overwritten. Can include properties set in
+ * /etc/spark/conf/spark-defaults.conf and classes in user code.
+ * @type \Google\Cloud\Dataproc\V1\LoggingConfig $logging_config
+ * Optional. The runtime log config for job execution.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/QueryList.php b/Dataproc/src/V1/QueryList.php
index c7532e0d3c24..bc1753bbfd6e 100644
--- a/Dataproc/src/V1/QueryList.php
+++ b/Dataproc/src/V1/QueryList.php
@@ -34,9 +34,31 @@ class QueryList extends \Google\Protobuf\Internal\Message
*/
private $queries;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $queries
+ * Required. The queries to execute. You do not need to terminate a query
+ * with a semicolon. Multiple queries can be specified in one string
+ * by separating each with a semicolon. Here is an example of an Cloud
+ * Dataproc API snippet that uses a QueryList to specify a HiveJob:
+ * "hiveJob": {
+ * "queryList": {
+ * "queries": [
+ * "query1",
+ * "query2",
+ * "query3;query4",
+ * ]
+ * }
+ * }
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/SoftwareConfig.php b/Dataproc/src/V1/SoftwareConfig.php
index 4f9ec5d90f37..aa35b36222e1 100644
--- a/Dataproc/src/V1/SoftwareConfig.php
+++ b/Dataproc/src/V1/SoftwareConfig.php
@@ -44,9 +44,37 @@ class SoftwareConfig extends \Google\Protobuf\Internal\Message
*/
private $properties;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $image_version
+ * 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](/dataproc/versioning)).
+ * @type array|\Google\Protobuf\Internal\MapField $properties
+ * Optional. The properties to set on daemon config files.
+ * Property keys are specified in `prefix:property` format, such as
+ * `core:fs.defaultFS`. The following are supported prefixes
+ * and their mappings:
+ * * capacity-scheduler: `capacity-scheduler.xml`
+ * * core: `core-site.xml`
+ * * distcp: `distcp-default.xml`
+ * * hdfs: `hdfs-site.xml`
+ * * hive: `hive-site.xml`
+ * * mapred: `mapred-site.xml`
+ * * pig: `pig.properties`
+ * * spark: `spark-defaults.conf`
+ * * yarn: `yarn-site.xml`
+ * For more information, see
+ * [Cluster properties](/dataproc/docs/concepts/cluster-properties).
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/SparkJob.php b/Dataproc/src/V1/SparkJob.php
index c19abb300300..2ea51566ff34 100644
--- a/Dataproc/src/V1/SparkJob.php
+++ b/Dataproc/src/V1/SparkJob.php
@@ -63,9 +63,43 @@ class SparkJob extends \Google\Protobuf\Internal\Message
private $logging_config = null;
protected $driver;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $main_jar_file_uri
+ * The HCFS URI of the jar file that contains the main class.
+ * @type string $main_class
+ * The name of the driver's main class. The jar file that contains the class
+ * must be in the default CLASSPATH or specified in `jar_file_uris`.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $args
+ * Optional. The arguments to pass to the driver. Do not include arguments,
+ * such as `--conf`, that can be set as job properties, since a collision may
+ * occur that causes an incorrect job submission.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $jar_file_uris
+ * Optional. HCFS URIs of jar files to add to the CLASSPATHs of the
+ * Spark driver and tasks.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $file_uris
+ * Optional. HCFS URIs of files to be copied to the working directory of
+ * Spark drivers and distributed tasks. Useful for naively parallel tasks.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $archive_uris
+ * Optional. HCFS URIs of archives to be extracted in the working directory
+ * of Spark drivers and tasks. Supported file types:
+ * .jar, .tar, .tar.gz, .tgz, and .zip.
+ * @type array|\Google\Protobuf\Internal\MapField $properties
+ * Optional. A mapping of property names to values, used to configure Spark.
+ * Properties that conflict with values set by the Cloud Dataproc API may be
+ * overwritten. Can include properties set in
+ * /etc/spark/conf/spark-defaults.conf and classes in user code.
+ * @type \Google\Cloud\Dataproc\V1\LoggingConfig $logging_config
+ * Optional. The runtime log config for job execution.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/SparkSqlJob.php b/Dataproc/src/V1/SparkSqlJob.php
index ace3d5aabf3f..0f531e084513 100644
--- a/Dataproc/src/V1/SparkSqlJob.php
+++ b/Dataproc/src/V1/SparkSqlJob.php
@@ -45,9 +45,32 @@ class SparkSqlJob extends \Google\Protobuf\Internal\Message
private $logging_config = null;
protected $queries;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $query_file_uri
+ * The HCFS URI of the script that contains SQL queries.
+ * @type \Google\Cloud\Dataproc\V1\QueryList $query_list
+ * A list of queries.
+ * @type array|\Google\Protobuf\Internal\MapField $script_variables
+ * Optional. Mapping of query variable names to values (equivalent to the
+ * Spark SQL command: SET `name="value";`).
+ * @type array|\Google\Protobuf\Internal\MapField $properties
+ * Optional. A mapping of property names to values, used to configure
+ * Spark SQL's SparkConf. Properties that conflict with values set by the
+ * Cloud Dataproc API may be overwritten.
+ * @type string[]|\Google\Protobuf\Internal\RepeatedField $jar_file_uris
+ * Optional. HCFS URIs of jar files to be added to the Spark CLASSPATH.
+ * @type \Google\Cloud\Dataproc\V1\LoggingConfig $logging_config
+ * Optional. The runtime log config for job execution.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/SubmitJobRequest.php b/Dataproc/src/V1/SubmitJobRequest.php
index 81aebefe78d1..f042e5968fae 100644
--- a/Dataproc/src/V1/SubmitJobRequest.php
+++ b/Dataproc/src/V1/SubmitJobRequest.php
@@ -35,9 +35,24 @@ class SubmitJobRequest extends \Google\Protobuf\Internal\Message
*/
private $job = null;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $project_id
+ * Required. The ID of the Google Cloud Platform project that the job
+ * belongs to.
+ * @type string $region
+ * Required. The Cloud Dataproc region in which to handle the request.
+ * @type \Google\Cloud\Dataproc\V1\Job $job
+ * Required. The job resource.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/UpdateClusterRequest.php b/Dataproc/src/V1/UpdateClusterRequest.php
index 9465ea7fa911..d3b36880d43f 100644
--- a/Dataproc/src/V1/UpdateClusterRequest.php
+++ b/Dataproc/src/V1/UpdateClusterRequest.php
@@ -90,9 +90,71 @@ class UpdateClusterRequest extends \Google\Protobuf\Internal\Message
*/
private $update_mask = null;
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $project_id
+ * Required. The ID of the Google Cloud Platform project the
+ * cluster belongs to.
+ * @type string $region
+ * Required. The Cloud Dataproc region in which to handle the request.
+ * @type string $cluster_name
+ * Required. The cluster name.
+ * @type \Google\Cloud\Dataproc\V1\Cluster $cluster
+ * Required. The changes to the cluster.
+ * @type \Google\Protobuf\FieldMask $update_mask
+ * Required. Specifies the path, relative to `Cluster`, of
+ * the field to update. For example, to change the number of workers
+ * in a cluster to 5, the `update_mask` parameter would be
+ * specified as `config.worker_config.num_instances`,
+ * and the `PATCH` request body would specify the new value, as follows:
+ * {
+ * "config":{
+ * "workerConfig":{
+ * "numInstances":"5"
+ * }
+ * }
+ * }
+ * Similarly, to change the number of preemptible workers in a cluster to 5,
+ * the `update_mask` parameter would be
+ * `config.secondary_worker_config.num_instances`, and the `PATCH` request
+ * body would be set as follows:
+ * {
+ * "config":{
+ * "secondaryWorkerConfig":{
+ * "numInstances":"5"
+ * }
+ * }
+ * }
+ * Note: Currently, only the following fields can be updated:
+ *
Mask | + *Purpose | + *
labels | + *Update labels | + *
config.worker_config.num_instances | + *Resize primary worker group | + *
config.secondary_worker_config.num_instances | + *Resize secondary worker group | + *
Job
, of
+ * the field to update. For example, to update the labels of a Job the
+ * update_mask
parameter would be specified as
+ * labels
, and the `PATCH` request body would specify the new
+ * value. Note: Currently, labels
is the only
+ * field that can be updated.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/YarnApplication.php b/Dataproc/src/V1/YarnApplication.php
index 55db2a6dee56..da537eb827c0 100644
--- a/Dataproc/src/V1/YarnApplication.php
+++ b/Dataproc/src/V1/YarnApplication.php
@@ -46,9 +46,28 @@ class YarnApplication extends \Google\Protobuf\Internal\Message
*/
private $tracking_url = '';
- public function __construct() {
+ /**
+ * Constructor.
+ *
+ * @param array $data {
+ * Optional. Data for populating the Message object.
+ *
+ * @type string $name
+ * Required. The application name.
+ * @type int $state
+ * Required. The application state.
+ * @type float $progress
+ * Required. The numerical progress of the application, from 1 to 100.
+ * @type string $tracking_url
+ * Optional. The HTTP URL of the ApplicationMaster, HistoryServer, or
+ * TimelineServer that provides application-specific information. The URL uses
+ * the internal hostname, and requires a proxy server for resolution and,
+ * possibly, access.
+ * }
+ */
+ public function __construct($data = NULL) {
\GPBMetadata\Google\Cloud\Dataproc\V1\Jobs::initOnce();
- parent::__construct();
+ parent::__construct($data);
}
/**
diff --git a/Dataproc/src/V1/YarnApplication_State.php b/Dataproc/src/V1/YarnApplication_State.php
index f98c5bc0f2be..5f6ffa0b784d 100644
--- a/Dataproc/src/V1/YarnApplication_State.php
+++ b/Dataproc/src/V1/YarnApplication_State.php
@@ -4,67 +4,13 @@
namespace Google\Cloud\Dataproc\V1;
-/**
- * The application state, corresponding to
- * YarnProtos.YarnApplicationStateProto
.
- *
- * Protobuf enum Google\Cloud\Dataproc\V1\YarnApplication\State
- */
-class YarnApplication_State
-{
+if (false) {
/**
- * Status is unspecified.
- *
- * Generated from protobuf enum STATE_UNSPECIFIED = 0;
+ * This class is deprecated. Use Google\Cloud\Dataproc\V1\YarnApplication\State instead.
+ * @deprecated
*/
- const STATE_UNSPECIFIED = 0;
- /**
- * Status is NEW.
- *
- * Generated from protobuf enum NEW = 1;
- */
- const PBNEW = 1;
- /**
- * Status is NEW_SAVING.
- *
- * Generated from protobuf enum NEW_SAVING = 2;
- */
- const NEW_SAVING = 2;
- /**
- * Status is SUBMITTED.
- *
- * Generated from protobuf enum SUBMITTED = 3;
- */
- const SUBMITTED = 3;
- /**
- * Status is ACCEPTED.
- *
- * Generated from protobuf enum ACCEPTED = 4;
- */
- const ACCEPTED = 4;
- /**
- * Status is RUNNING.
- *
- * Generated from protobuf enum RUNNING = 5;
- */
- const RUNNING = 5;
- /**
- * Status is FINISHED.
- *
- * Generated from protobuf enum FINISHED = 6;
- */
- const FINISHED = 6;
- /**
- * Status is FAILED.
- *
- * Generated from protobuf enum FAILED = 7;
- */
- const FAILED = 7;
- /**
- * Status is KILLED.
- *
- * Generated from protobuf enum KILLED = 8;
- */
- const KILLED = 8;
+ class YarnApplication_State {}
}
+class_exists(YarnApplication\State::class);
+@trigger_error('Google\Cloud\Dataproc\V1\YarnApplication_State is deprecated and will be removed in the next major release. Use Google\Cloud\Dataproc\V1\YarnApplication\State instead', E_USER_DEPRECATED);
diff --git a/Dataproc/synth.py b/Dataproc/synth.py
index 31cd82046383..45a43e718220 100644
--- a/Dataproc/synth.py
+++ b/Dataproc/synth.py
@@ -55,3 +55,9 @@
'tests/**/V1/*Test.php',
r'Copyright \d{4}',
'Copyright 2018')
+
+# Use new namespaces
+s.replace(
+ 'src/V1/Gapic/JobControllerGapicClient.php',
+ r'ListJobsRequest_JobStateMatcher',
+ 'ListJobsRequest\\JobStateMatcher')