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: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MaskPurpose
labelsUpdate labels
config.worker_config.num_instancesResize primary worker group
config.secondary_worker_config.num_instancesResize secondary worker group
+ * } + */ + public function __construct($data = NULL) { \GPBMetadata\Google\Cloud\Dataproc\V1\Clusters::initOnce(); - parent::__construct(); + parent::__construct($data); } /** diff --git a/Dataproc/src/V1/UpdateJobRequest.php b/Dataproc/src/V1/UpdateJobRequest.php index 5d5d2cbab129..64028faf5df5 100644 --- a/Dataproc/src/V1/UpdateJobRequest.php +++ b/Dataproc/src/V1/UpdateJobRequest.php @@ -52,9 +52,33 @@ class UpdateJobRequest 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 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. + * @type \Google\Cloud\Dataproc\V1\Job $job + * Required. The changes to the job. + * @type \Google\Protobuf\FieldMask $update_mask + * Required. Specifies the path, relative to 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')