diff --git a/Dataproc/metadata/V1/Batches.php b/Dataproc/metadata/V1/Batches.php index 01c1f96be1f..d6cef939e95 100644 Binary files a/Dataproc/metadata/V1/Batches.php and b/Dataproc/metadata/V1/Batches.php differ diff --git a/Dataproc/metadata/V1/Clusters.php b/Dataproc/metadata/V1/Clusters.php index e3e1812c344..cbed0064a90 100644 Binary files a/Dataproc/metadata/V1/Clusters.php and b/Dataproc/metadata/V1/Clusters.php differ diff --git a/Dataproc/metadata/V1/Jobs.php b/Dataproc/metadata/V1/Jobs.php index 12835b1f32e..39f78182b82 100644 Binary files a/Dataproc/metadata/V1/Jobs.php and b/Dataproc/metadata/V1/Jobs.php differ diff --git a/Dataproc/metadata/V1/Operations.php b/Dataproc/metadata/V1/Operations.php index 6dba3a5462c..5a794a2d752 100644 Binary files a/Dataproc/metadata/V1/Operations.php and b/Dataproc/metadata/V1/Operations.php differ diff --git a/Dataproc/metadata/V1/Shared.php b/Dataproc/metadata/V1/Shared.php index e8819bb1ecf..5b0c8f6138d 100644 Binary files a/Dataproc/metadata/V1/Shared.php and b/Dataproc/metadata/V1/Shared.php differ diff --git a/Dataproc/samples/V1/AutoscalingPolicyServiceClient/create_autoscaling_policy.php b/Dataproc/samples/V1/AutoscalingPolicyServiceClient/create_autoscaling_policy.php index 16537478b88..55d576f979b 100644 --- a/Dataproc/samples/V1/AutoscalingPolicyServiceClient/create_autoscaling_policy.php +++ b/Dataproc/samples/V1/AutoscalingPolicyServiceClient/create_autoscaling_policy.php @@ -45,18 +45,18 @@ * of the location has the following format: * `projects/{project_id}/locations/{location}` * Please see {@see AutoscalingPolicyServiceClient::regionName()} for help formatting this field. - * @param float $policyBasicAlgorithmYarnConfigScaleUpFactor Fraction of average YARN pending memory in the last cooldown period - * for which to add workers. A scale-up factor of 1.0 will result in scaling - * up so that there is no pending memory remaining after the update (more - * aggressive scaling). A scale-up factor closer to 0 will result in a smaller - * magnitude of scaling up (less aggressive scaling). - * See [How autoscaling + * @param float $policyBasicAlgorithmYarnConfigScaleUpFactor Fraction of average YARN pending memory in the last cooldown + * period for which to add workers. A scale-up factor of 1.0 will result in + * scaling up so that there is no pending memory remaining after the update + * (more aggressive scaling). A scale-up factor closer to 0 will result in a + * smaller magnitude of scaling up (less aggressive scaling). See [How + * autoscaling * works](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/autoscaling#how_autoscaling_works) * for more information. * * Bounds: [0.0, 1.0]. - * @param float $policyBasicAlgorithmYarnConfigScaleDownFactor Fraction of average YARN pending memory in the last cooldown period - * for which to remove workers. A scale-down factor of 1 will result in + * @param float $policyBasicAlgorithmYarnConfigScaleDownFactor Fraction of average YARN pending memory in the last cooldown + * period for which to remove workers. A scale-down factor of 1 will result in * scaling down so that there is no available memory remaining after the * update (more aggressive scaling). A scale-down factor of 0 disables * removing workers, which can be beneficial for autoscaling a single job. diff --git a/Dataproc/samples/V1/AutoscalingPolicyServiceClient/update_autoscaling_policy.php b/Dataproc/samples/V1/AutoscalingPolicyServiceClient/update_autoscaling_policy.php index af381179f0d..f076a3ab0ba 100644 --- a/Dataproc/samples/V1/AutoscalingPolicyServiceClient/update_autoscaling_policy.php +++ b/Dataproc/samples/V1/AutoscalingPolicyServiceClient/update_autoscaling_policy.php @@ -37,18 +37,18 @@ * Disabled check for update_mask, because all updates will be full * replacements. * - * @param float $policyBasicAlgorithmYarnConfigScaleUpFactor Fraction of average YARN pending memory in the last cooldown period - * for which to add workers. A scale-up factor of 1.0 will result in scaling - * up so that there is no pending memory remaining after the update (more - * aggressive scaling). A scale-up factor closer to 0 will result in a smaller - * magnitude of scaling up (less aggressive scaling). - * See [How autoscaling + * @param float $policyBasicAlgorithmYarnConfigScaleUpFactor Fraction of average YARN pending memory in the last cooldown + * period for which to add workers. A scale-up factor of 1.0 will result in + * scaling up so that there is no pending memory remaining after the update + * (more aggressive scaling). A scale-up factor closer to 0 will result in a + * smaller magnitude of scaling up (less aggressive scaling). See [How + * autoscaling * works](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/autoscaling#how_autoscaling_works) * for more information. * * Bounds: [0.0, 1.0]. - * @param float $policyBasicAlgorithmYarnConfigScaleDownFactor Fraction of average YARN pending memory in the last cooldown period - * for which to remove workers. A scale-down factor of 1 will result in + * @param float $policyBasicAlgorithmYarnConfigScaleDownFactor Fraction of average YARN pending memory in the last cooldown + * period for which to remove workers. A scale-down factor of 1 will result in * scaling down so that there is no available memory remaining after the * update (more aggressive scaling). A scale-down factor of 0 disables * removing workers, which can be beneficial for autoscaling a single job. diff --git a/Dataproc/samples/V1/BatchControllerClient/delete_batch.php b/Dataproc/samples/V1/BatchControllerClient/delete_batch.php index 198e29c269e..940d4468125 100644 --- a/Dataproc/samples/V1/BatchControllerClient/delete_batch.php +++ b/Dataproc/samples/V1/BatchControllerClient/delete_batch.php @@ -30,8 +30,10 @@ * Deletes the batch workload resource. If the batch is not in terminal state, * the delete fails and the response returns `FAILED_PRECONDITION`. * - * @param string $formattedName The name of the batch resource to delete. Please see - * {@see BatchControllerClient::batchName()} for help formatting this field. + * @param string $formattedName The fully qualified name of the batch to retrieve + * in the format + * "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID" + * Please see {@see BatchControllerClient::batchName()} for help formatting this field. */ function delete_batch_sample(string $formattedName): void { diff --git a/Dataproc/samples/V1/BatchControllerClient/get_batch.php b/Dataproc/samples/V1/BatchControllerClient/get_batch.php index fb896530226..5bfa98f31f9 100644 --- a/Dataproc/samples/V1/BatchControllerClient/get_batch.php +++ b/Dataproc/samples/V1/BatchControllerClient/get_batch.php @@ -30,8 +30,10 @@ /** * Gets the batch workload resource representation. * - * @param string $formattedName The name of the batch to retrieve. Please see - * {@see BatchControllerClient::batchName()} for help formatting this field. + * @param string $formattedName The fully qualified name of the batch to retrieve + * in the format + * "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID" + * Please see {@see BatchControllerClient::batchName()} for help formatting this field. */ function get_batch_sample(string $formattedName): void { diff --git a/Dataproc/samples/V1/WorkflowTemplateServiceClient/create_workflow_template.php b/Dataproc/samples/V1/WorkflowTemplateServiceClient/create_workflow_template.php index cea0709fe68..7be4c3c191d 100644 --- a/Dataproc/samples/V1/WorkflowTemplateServiceClient/create_workflow_template.php +++ b/Dataproc/samples/V1/WorkflowTemplateServiceClient/create_workflow_template.php @@ -49,8 +49,8 @@ * * The step id is used as prefix for job id, as job * `goog-dataproc-workflow-step-id` label, and in - * [prerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids] field from other - * steps. + * [prerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids] + * field from other steps. * * The id must contain only letters (a-z, A-Z), numbers (0-9), * underscores (_), and hyphens (-). Cannot begin or end with underscore diff --git a/Dataproc/samples/V1/WorkflowTemplateServiceClient/instantiate_inline_workflow_template.php b/Dataproc/samples/V1/WorkflowTemplateServiceClient/instantiate_inline_workflow_template.php index 1c336daf90f..91f8b32fb1d 100644 --- a/Dataproc/samples/V1/WorkflowTemplateServiceClient/instantiate_inline_workflow_template.php +++ b/Dataproc/samples/V1/WorkflowTemplateServiceClient/instantiate_inline_workflow_template.php @@ -35,7 +35,8 @@ * Instantiates a template and begins execution. * * This method is equivalent to executing the sequence - * [CreateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.CreateWorkflowTemplate], [InstantiateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.InstantiateWorkflowTemplate], + * [CreateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.CreateWorkflowTemplate], + * [InstantiateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.InstantiateWorkflowTemplate], * [DeleteWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.DeleteWorkflowTemplate]. * * The returned Operation can be used to track execution of @@ -74,8 +75,8 @@ * * The step id is used as prefix for job id, as job * `goog-dataproc-workflow-step-id` label, and in - * [prerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids] field from other - * steps. + * [prerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids] + * field from other steps. * * The id must contain only letters (a-z, A-Z), numbers (0-9), * underscores (_), and hyphens (-). Cannot begin or end with underscore diff --git a/Dataproc/samples/V1/WorkflowTemplateServiceClient/update_workflow_template.php b/Dataproc/samples/V1/WorkflowTemplateServiceClient/update_workflow_template.php index ce22700212b..a196a0deaf6 100644 --- a/Dataproc/samples/V1/WorkflowTemplateServiceClient/update_workflow_template.php +++ b/Dataproc/samples/V1/WorkflowTemplateServiceClient/update_workflow_template.php @@ -39,8 +39,8 @@ * * The step id is used as prefix for job id, as job * `goog-dataproc-workflow-step-id` label, and in - * [prerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids] field from other - * steps. + * [prerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids] + * field from other steps. * * The id must contain only letters (a-z, A-Z), numbers (0-9), * underscores (_), and hyphens (-). Cannot begin or end with underscore diff --git a/Dataproc/src/V1/AcceleratorConfig.php b/Dataproc/src/V1/AcceleratorConfig.php index bea1b9a47d7..5c1ba607511 100644 --- a/Dataproc/src/V1/AcceleratorConfig.php +++ b/Dataproc/src/V1/AcceleratorConfig.php @@ -21,10 +21,10 @@ class AcceleratorConfig extends \Google\Protobuf\Internal\Message * Full URL, partial URI, or short name of the accelerator type resource to * expose to this instance. See * [Compute Engine - * AcceleratorTypes](https://cloud.google.com/compute/docs/reference/beta/acceleratorTypes). + * AcceleratorTypes](https://cloud.google.com/compute/docs/reference/v1/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` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]/acceleratorTypes/nvidia-tesla-k80` + * * `projects/[project_id]/zones/[zone]/acceleratorTypes/nvidia-tesla-k80` * * `nvidia-tesla-k80` * **Auto Zone Exception**: If you are using the Dataproc * [Auto Zone @@ -52,10 +52,10 @@ class AcceleratorConfig extends \Google\Protobuf\Internal\Message * Full URL, partial URI, or short name of the accelerator type resource to * expose to this instance. See * [Compute Engine - * AcceleratorTypes](https://cloud.google.com/compute/docs/reference/beta/acceleratorTypes). + * AcceleratorTypes](https://cloud.google.com/compute/docs/reference/v1/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` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]/acceleratorTypes/nvidia-tesla-k80` + * * `projects/[project_id]/zones/[zone]/acceleratorTypes/nvidia-tesla-k80` * * `nvidia-tesla-k80` * **Auto Zone Exception**: If you are using the Dataproc * [Auto Zone @@ -75,10 +75,10 @@ public function __construct($data = NULL) { * Full URL, partial URI, or short name of the accelerator type resource to * expose to this instance. See * [Compute Engine - * AcceleratorTypes](https://cloud.google.com/compute/docs/reference/beta/acceleratorTypes). + * AcceleratorTypes](https://cloud.google.com/compute/docs/reference/v1/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` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]/acceleratorTypes/nvidia-tesla-k80` + * * `projects/[project_id]/zones/[zone]/acceleratorTypes/nvidia-tesla-k80` * * `nvidia-tesla-k80` * **Auto Zone Exception**: If you are using the Dataproc * [Auto Zone @@ -98,10 +98,10 @@ public function getAcceleratorTypeUri() * Full URL, partial URI, or short name of the accelerator type resource to * expose to this instance. See * [Compute Engine - * AcceleratorTypes](https://cloud.google.com/compute/docs/reference/beta/acceleratorTypes). + * AcceleratorTypes](https://cloud.google.com/compute/docs/reference/v1/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` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]/acceleratorTypes/nvidia-tesla-k80` + * * `projects/[project_id]/zones/[zone]/acceleratorTypes/nvidia-tesla-k80` * * `nvidia-tesla-k80` * **Auto Zone Exception**: If you are using the Dataproc * [Auto Zone diff --git a/Dataproc/src/V1/BasicYarnAutoscalingConfig.php b/Dataproc/src/V1/BasicYarnAutoscalingConfig.php index 7a7d97dc1c3..ebf4ca9e4bf 100644 --- a/Dataproc/src/V1/BasicYarnAutoscalingConfig.php +++ b/Dataproc/src/V1/BasicYarnAutoscalingConfig.php @@ -26,12 +26,12 @@ class BasicYarnAutoscalingConfig extends \Google\Protobuf\Internal\Message */ private $graceful_decommission_timeout = null; /** - * Required. Fraction of average YARN pending memory in the last cooldown period - * for which to add workers. A scale-up factor of 1.0 will result in scaling - * up so that there is no pending memory remaining after the update (more - * aggressive scaling). A scale-up factor closer to 0 will result in a smaller - * magnitude of scaling up (less aggressive scaling). - * See [How autoscaling + * Required. Fraction of average YARN pending memory in the last cooldown + * period for which to add workers. A scale-up factor of 1.0 will result in + * scaling up so that there is no pending memory remaining after the update + * (more aggressive scaling). A scale-up factor closer to 0 will result in a + * smaller magnitude of scaling up (less aggressive scaling). See [How + * autoscaling * works](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/autoscaling#how_autoscaling_works) * for more information. * Bounds: [0.0, 1.0]. @@ -40,8 +40,8 @@ class BasicYarnAutoscalingConfig extends \Google\Protobuf\Internal\Message */ private $scale_up_factor = 0.0; /** - * Required. Fraction of average YARN pending memory in the last cooldown period - * for which to remove workers. A scale-down factor of 1 will result in + * Required. Fraction of average YARN pending memory in the last cooldown + * period for which to remove workers. A scale-down factor of 1 will result in * scaling down so that there is no available memory remaining after the * update (more aggressive scaling). A scale-down factor of 0 disables * removing workers, which can be beneficial for autoscaling a single job. @@ -89,18 +89,18 @@ class BasicYarnAutoscalingConfig extends \Google\Protobuf\Internal\Message * downscaling operations. * Bounds: [0s, 1d]. * @type float $scale_up_factor - * Required. Fraction of average YARN pending memory in the last cooldown period - * for which to add workers. A scale-up factor of 1.0 will result in scaling - * up so that there is no pending memory remaining after the update (more - * aggressive scaling). A scale-up factor closer to 0 will result in a smaller - * magnitude of scaling up (less aggressive scaling). - * See [How autoscaling + * Required. Fraction of average YARN pending memory in the last cooldown + * period for which to add workers. A scale-up factor of 1.0 will result in + * scaling up so that there is no pending memory remaining after the update + * (more aggressive scaling). A scale-up factor closer to 0 will result in a + * smaller magnitude of scaling up (less aggressive scaling). See [How + * autoscaling * works](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/autoscaling#how_autoscaling_works) * for more information. * Bounds: [0.0, 1.0]. * @type float $scale_down_factor - * Required. Fraction of average YARN pending memory in the last cooldown period - * for which to remove workers. A scale-down factor of 1 will result in + * Required. Fraction of average YARN pending memory in the last cooldown + * period for which to remove workers. A scale-down factor of 1 will result in * scaling down so that there is no available memory remaining after the * update (more aggressive scaling). A scale-down factor of 0 disables * removing workers, which can be beneficial for autoscaling a single job. @@ -174,12 +174,12 @@ public function setGracefulDecommissionTimeout($var) } /** - * Required. Fraction of average YARN pending memory in the last cooldown period - * for which to add workers. A scale-up factor of 1.0 will result in scaling - * up so that there is no pending memory remaining after the update (more - * aggressive scaling). A scale-up factor closer to 0 will result in a smaller - * magnitude of scaling up (less aggressive scaling). - * See [How autoscaling + * Required. Fraction of average YARN pending memory in the last cooldown + * period for which to add workers. A scale-up factor of 1.0 will result in + * scaling up so that there is no pending memory remaining after the update + * (more aggressive scaling). A scale-up factor closer to 0 will result in a + * smaller magnitude of scaling up (less aggressive scaling). See [How + * autoscaling * works](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/autoscaling#how_autoscaling_works) * for more information. * Bounds: [0.0, 1.0]. @@ -193,12 +193,12 @@ public function getScaleUpFactor() } /** - * Required. Fraction of average YARN pending memory in the last cooldown period - * for which to add workers. A scale-up factor of 1.0 will result in scaling - * up so that there is no pending memory remaining after the update (more - * aggressive scaling). A scale-up factor closer to 0 will result in a smaller - * magnitude of scaling up (less aggressive scaling). - * See [How autoscaling + * Required. Fraction of average YARN pending memory in the last cooldown + * period for which to add workers. A scale-up factor of 1.0 will result in + * scaling up so that there is no pending memory remaining after the update + * (more aggressive scaling). A scale-up factor closer to 0 will result in a + * smaller magnitude of scaling up (less aggressive scaling). See [How + * autoscaling * works](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/autoscaling#how_autoscaling_works) * for more information. * Bounds: [0.0, 1.0]. @@ -216,8 +216,8 @@ public function setScaleUpFactor($var) } /** - * Required. Fraction of average YARN pending memory in the last cooldown period - * for which to remove workers. A scale-down factor of 1 will result in + * Required. Fraction of average YARN pending memory in the last cooldown + * period for which to remove workers. A scale-down factor of 1 will result in * scaling down so that there is no available memory remaining after the * update (more aggressive scaling). A scale-down factor of 0 disables * removing workers, which can be beneficial for autoscaling a single job. @@ -235,8 +235,8 @@ public function getScaleDownFactor() } /** - * Required. Fraction of average YARN pending memory in the last cooldown period - * for which to remove workers. A scale-down factor of 1 will result in + * Required. Fraction of average YARN pending memory in the last cooldown + * period for which to remove workers. A scale-down factor of 1 will result in * scaling down so that there is no available memory remaining after the * update (more aggressive scaling). A scale-down factor of 0 disables * removing workers, which can be beneficial for autoscaling a single job. diff --git a/Dataproc/src/V1/Cluster.php b/Dataproc/src/V1/Cluster.php index c528f6a4960..0096969be89 100644 --- a/Dataproc/src/V1/Cluster.php +++ b/Dataproc/src/V1/Cluster.php @@ -35,6 +35,7 @@ class Cluster extends \Google\Protobuf\Internal\Message * Optional. The cluster config for a cluster of Compute Engine Instances. * Note that Dataproc may set default values, and values may change * when clusters are updated. + * Exactly one of ClusterConfig or VirtualClusterConfig must be specified. * * Generated from protobuf field .google.cloud.dataproc.v1.ClusterConfig config = 3 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -43,7 +44,7 @@ class Cluster extends \Google\Protobuf\Internal\Message * Optional. The virtual cluster config is used when creating a Dataproc * cluster that does not directly control the underlying compute resources, * for example, when creating a [Dataproc-on-GKE - * cluster](https://cloud.google.com/dataproc/docs/guides/dpgke/dataproc-gke). + * cluster](https://cloud.google.com/dataproc/docs/guides/dpgke/dataproc-gke-overview). * Dataproc may set default values, and values may change when * clusters are updated. Exactly one of * [config][google.cloud.dataproc.v1.Cluster.config] or @@ -110,11 +111,12 @@ class Cluster extends \Google\Protobuf\Internal\Message * Optional. The cluster config for a cluster of Compute Engine Instances. * Note that Dataproc may set default values, and values may change * when clusters are updated. + * Exactly one of ClusterConfig or VirtualClusterConfig must be specified. * @type \Google\Cloud\Dataproc\V1\VirtualClusterConfig $virtual_cluster_config * Optional. The virtual cluster config is used when creating a Dataproc * cluster that does not directly control the underlying compute resources, * for example, when creating a [Dataproc-on-GKE - * cluster](https://cloud.google.com/dataproc/docs/guides/dpgke/dataproc-gke). + * cluster](https://cloud.google.com/dataproc/docs/guides/dpgke/dataproc-gke-overview). * Dataproc may set default values, and values may change when * clusters are updated. Exactly one of * [config][google.cloud.dataproc.v1.Cluster.config] or @@ -208,6 +210,7 @@ public function setClusterName($var) * Optional. The cluster config for a cluster of Compute Engine Instances. * Note that Dataproc may set default values, and values may change * when clusters are updated. + * Exactly one of ClusterConfig or VirtualClusterConfig must be specified. * * Generated from protobuf field .google.cloud.dataproc.v1.ClusterConfig config = 3 [(.google.api.field_behavior) = OPTIONAL]; * @return \Google\Cloud\Dataproc\V1\ClusterConfig|null @@ -231,6 +234,7 @@ public function clearConfig() * Optional. The cluster config for a cluster of Compute Engine Instances. * Note that Dataproc may set default values, and values may change * when clusters are updated. + * Exactly one of ClusterConfig or VirtualClusterConfig must be specified. * * Generated from protobuf field .google.cloud.dataproc.v1.ClusterConfig config = 3 [(.google.api.field_behavior) = OPTIONAL]; * @param \Google\Cloud\Dataproc\V1\ClusterConfig $var @@ -248,7 +252,7 @@ public function setConfig($var) * Optional. The virtual cluster config is used when creating a Dataproc * cluster that does not directly control the underlying compute resources, * for example, when creating a [Dataproc-on-GKE - * cluster](https://cloud.google.com/dataproc/docs/guides/dpgke/dataproc-gke). + * cluster](https://cloud.google.com/dataproc/docs/guides/dpgke/dataproc-gke-overview). * Dataproc may set default values, and values may change when * clusters are updated. Exactly one of * [config][google.cloud.dataproc.v1.Cluster.config] or @@ -277,7 +281,7 @@ public function clearVirtualClusterConfig() * Optional. The virtual cluster config is used when creating a Dataproc * cluster that does not directly control the underlying compute resources, * for example, when creating a [Dataproc-on-GKE - * cluster](https://cloud.google.com/dataproc/docs/guides/dpgke/dataproc-gke). + * cluster](https://cloud.google.com/dataproc/docs/guides/dpgke/dataproc-gke-overview). * Dataproc may set default values, and values may change when * clusters are updated. Exactly one of * [config][google.cloud.dataproc.v1.Cluster.config] or diff --git a/Dataproc/src/V1/ClusterMetrics.php b/Dataproc/src/V1/ClusterMetrics.php index b136b18a3d5..a189db9bf52 100644 --- a/Dataproc/src/V1/ClusterMetrics.php +++ b/Dataproc/src/V1/ClusterMetrics.php @@ -24,7 +24,7 @@ class ClusterMetrics extends \Google\Protobuf\Internal\Message */ private $hdfs_metrics; /** - * The YARN metrics. + * YARN metrics. * * Generated from protobuf field map yarn_metrics = 2; */ @@ -39,7 +39,7 @@ class ClusterMetrics extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $hdfs_metrics * The HDFS metrics. * @type array|\Google\Protobuf\Internal\MapField $yarn_metrics - * The YARN metrics. + * YARN metrics. * } */ public function __construct($data = NULL) { @@ -74,7 +74,7 @@ public function setHdfsMetrics($var) } /** - * The YARN metrics. + * YARN metrics. * * Generated from protobuf field map yarn_metrics = 2; * @return \Google\Protobuf\Internal\MapField @@ -85,7 +85,7 @@ public function getYarnMetrics() } /** - * The YARN metrics. + * YARN metrics. * * Generated from protobuf field map yarn_metrics = 2; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Dataproc/src/V1/ClusterOperationMetadata.php b/Dataproc/src/V1/ClusterOperationMetadata.php index c979dbb9e34..d6f967d8ca9 100644 --- a/Dataproc/src/V1/ClusterOperationMetadata.php +++ b/Dataproc/src/V1/ClusterOperationMetadata.php @@ -63,6 +63,12 @@ class ClusterOperationMetadata extends \Google\Protobuf\Internal\Message * Generated from protobuf field repeated string warnings = 14 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ private $warnings; + /** + * Output only. Child operation ids + * + * Generated from protobuf field repeated string child_operation_ids = 15 [(.google.api.field_behavior) = OUTPUT_ONLY]; + */ + private $child_operation_ids; /** * Constructor. @@ -86,6 +92,8 @@ class ClusterOperationMetadata extends \Google\Protobuf\Internal\Message * Output only. Labels associated with the operation * @type array|\Google\Protobuf\Internal\RepeatedField $warnings * Output only. Errors encountered during operation execution. + * @type array|\Google\Protobuf\Internal\RepeatedField $child_operation_ids + * Output only. Child operation ids * } */ public function __construct($data = NULL) { @@ -311,5 +319,31 @@ public function setWarnings($var) return $this; } + /** + * Output only. Child operation ids + * + * Generated from protobuf field repeated string child_operation_ids = 15 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getChildOperationIds() + { + return $this->child_operation_ids; + } + + /** + * Output only. Child operation ids + * + * Generated from protobuf field repeated string child_operation_ids = 15 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * @param array|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setChildOperationIds($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::STRING); + $this->child_operation_ids = $arr; + + return $this; + } + } diff --git a/Dataproc/src/V1/Component.php b/Dataproc/src/V1/Component.php index dbd9df7e090..62a1a459880 100644 --- a/Dataproc/src/V1/Component.php +++ b/Dataproc/src/V1/Component.php @@ -59,6 +59,12 @@ class Component * Generated from protobuf enum HIVE_WEBHCAT = 3; */ const HIVE_WEBHCAT = 3; + /** + * Hudi. + * + * Generated from protobuf enum HUDI = 18; + */ + const HUDI = 18; /** * The Jupyter Notebook. * @@ -71,6 +77,12 @@ class Component * Generated from protobuf enum PRESTO = 6; */ const PRESTO = 6; + /** + * The Trino query engine. + * + * Generated from protobuf enum TRINO = 17; + */ + const TRINO = 17; /** * The Ranger service. * @@ -104,8 +116,10 @@ class Component self::FLINK => 'FLINK', self::HBASE => 'HBASE', self::HIVE_WEBHCAT => 'HIVE_WEBHCAT', + self::HUDI => 'HUDI', self::JUPYTER => 'JUPYTER', self::PRESTO => 'PRESTO', + self::TRINO => 'TRINO', self::RANGER => 'RANGER', self::SOLR => 'SOLR', self::ZEPPELIN => 'ZEPPELIN', diff --git a/Dataproc/src/V1/CreateBatchRequest.php b/Dataproc/src/V1/CreateBatchRequest.php index 3c38d2579ac..e2130614d09 100644 --- a/Dataproc/src/V1/CreateBatchRequest.php +++ b/Dataproc/src/V1/CreateBatchRequest.php @@ -28,8 +28,8 @@ class CreateBatchRequest extends \Google\Protobuf\Internal\Message */ private $batch = null; /** - * Optional. The ID to use for the batch, which will become the final component of - * the batch's resource name. + * Optional. The ID to use for the batch, which will become the final + * component of the batch's resource name. * This value must be 4-63 characters. Valid characters are `/[a-z][0-9]-/`. * * Generated from protobuf field string batch_id = 3 [(.google.api.field_behavior) = OPTIONAL]; @@ -62,8 +62,8 @@ class CreateBatchRequest extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\Dataproc\V1\Batch $batch * Required. The batch to create. * @type string $batch_id - * Optional. The ID to use for the batch, which will become the final component of - * the batch's resource name. + * Optional. The ID to use for the batch, which will become the final + * component of the batch's resource name. * This value must be 4-63 characters. Valid characters are `/[a-z][0-9]-/`. * @type string $request_id * Optional. A unique ID used to identify the request. If the service @@ -146,8 +146,8 @@ public function setBatch($var) } /** - * Optional. The ID to use for the batch, which will become the final component of - * the batch's resource name. + * Optional. The ID to use for the batch, which will become the final + * component of the batch's resource name. * This value must be 4-63 characters. Valid characters are `/[a-z][0-9]-/`. * * Generated from protobuf field string batch_id = 3 [(.google.api.field_behavior) = OPTIONAL]; @@ -159,8 +159,8 @@ public function getBatchId() } /** - * Optional. The ID to use for the batch, which will become the final component of - * the batch's resource name. + * Optional. The ID to use for the batch, which will become the final + * component of the batch's resource name. * This value must be 4-63 characters. Valid characters are `/[a-z][0-9]-/`. * * Generated from protobuf field string batch_id = 3 [(.google.api.field_behavior) = OPTIONAL]; diff --git a/Dataproc/src/V1/DataprocMetricConfig/MetricSource.php b/Dataproc/src/V1/DataprocMetricConfig/MetricSource.php index ecf873014f2..34e1ab52eac 100644 --- a/Dataproc/src/V1/DataprocMetricConfig/MetricSource.php +++ b/Dataproc/src/V1/DataprocMetricConfig/MetricSource.php @@ -60,6 +60,12 @@ class MetricSource * Generated from protobuf enum HIVESERVER2 = 6; */ const HIVESERVER2 = 6; + /** + * hivemetastore metric source + * + * Generated from protobuf enum HIVEMETASTORE = 7; + */ + const HIVEMETASTORE = 7; private static $valueToName = [ self::METRIC_SOURCE_UNSPECIFIED => 'METRIC_SOURCE_UNSPECIFIED', @@ -69,6 +75,7 @@ class MetricSource self::YARN => 'YARN', self::SPARK_HISTORY_SERVER => 'SPARK_HISTORY_SERVER', self::HIVESERVER2 => 'HIVESERVER2', + self::HIVEMETASTORE => 'HIVEMETASTORE', ]; public static function name($value) diff --git a/Dataproc/src/V1/DeleteBatchRequest.php b/Dataproc/src/V1/DeleteBatchRequest.php index 875e515585e..3e5d2b923e2 100644 --- a/Dataproc/src/V1/DeleteBatchRequest.php +++ b/Dataproc/src/V1/DeleteBatchRequest.php @@ -16,7 +16,9 @@ class DeleteBatchRequest extends \Google\Protobuf\Internal\Message { /** - * Required. The name of the batch resource to delete. + * Required. The fully qualified name of the batch to retrieve + * in the format + * "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID" * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -29,7 +31,9 @@ class DeleteBatchRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $name - * Required. The name of the batch resource to delete. + * Required. The fully qualified name of the batch to retrieve + * in the format + * "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID" * } */ public function __construct($data = NULL) { @@ -38,7 +42,9 @@ public function __construct($data = NULL) { } /** - * Required. The name of the batch resource to delete. + * Required. The fully qualified name of the batch to retrieve + * in the format + * "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID" * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -49,7 +55,9 @@ public function getName() } /** - * Required. The name of the batch resource to delete. + * Required. The fully qualified name of the batch to retrieve + * in the format + * "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID" * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/Dataproc/src/V1/DiskConfig.php b/Dataproc/src/V1/DiskConfig.php index f731e3be930..67a0e862014 100644 --- a/Dataproc/src/V1/DiskConfig.php +++ b/Dataproc/src/V1/DiskConfig.php @@ -38,6 +38,8 @@ class DiskConfig extends \Google\Protobuf\Internal\Message * 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. + * Note: Local SSD options may vary by machine type and number of vCPUs + * selected. * * Generated from protobuf field int32 num_local_ssds = 2 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -74,6 +76,8 @@ class DiskConfig extends \Google\Protobuf\Internal\Message * 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. + * Note: Local SSD options may vary by machine type and number of vCPUs + * selected. * @type string $local_ssd_interface * Optional. Interface type of local SSDs (default is "scsi"). * Valid values: "scsi" (Small Computer System Interface), @@ -154,6 +158,8 @@ public function setBootDiskSizeGb($var) * 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. + * Note: Local SSD options may vary by machine type and number of vCPUs + * selected. * * Generated from protobuf field int32 num_local_ssds = 2 [(.google.api.field_behavior) = OPTIONAL]; * @return int @@ -170,6 +176,8 @@ public function getNumLocalSsds() * 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. + * Note: Local SSD options may vary by machine type and number of vCPUs + * selected. * * Generated from protobuf field int32 num_local_ssds = 2 [(.google.api.field_behavior) = OPTIONAL]; * @param int $var diff --git a/Dataproc/src/V1/ExecutionConfig.php b/Dataproc/src/V1/ExecutionConfig.php index 099ec2b1a96..9d2f2e3f3fd 100644 --- a/Dataproc/src/V1/ExecutionConfig.php +++ b/Dataproc/src/V1/ExecutionConfig.php @@ -33,6 +33,34 @@ class ExecutionConfig extends \Google\Protobuf\Internal\Message * Generated from protobuf field string kms_key = 7 [(.google.api.field_behavior) = OPTIONAL]; */ private $kms_key = ''; + /** + * Optional. The duration after which the workload will be terminated. + * When the workload passes this ttl, it will be unconditionally killed + * without waiting for ongoing work to finish. + * Minimum value is 10 minutes; maximum value is 14 days (see JSON + * representation of + * [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json)). + * If both ttl and idle_ttl are specified, the conditions are treated as + * and OR: the workload will be terminated when it has been idle for idle_ttl + * or when the ttl has passed, whichever comes first. + * If ttl is not specified for a session, it defaults to 24h. + * + * Generated from protobuf field .google.protobuf.Duration ttl = 9 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $ttl = null; + /** + * Optional. A Cloud Storage bucket used to stage workload dependencies, + * config files, and store workload output and other ephemeral data, such as + * Spark history files. If you do not specify a staging bucket, Cloud Dataproc + * will determine a Cloud Storage location according to the region where your + * workload is running, and then create and manage project-level, per-location + * staging and temporary buckets. + * **This field requires a Cloud Storage bucket name, not a `gs://...` URI to + * a Cloud Storage bucket.** + * + * Generated from protobuf field string staging_bucket = 10 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $staging_bucket = ''; protected $network; /** @@ -51,6 +79,26 @@ class ExecutionConfig extends \Google\Protobuf\Internal\Message * Optional. Tags used for network traffic control. * @type string $kms_key * Optional. The Cloud KMS key to use for encryption. + * @type \Google\Protobuf\Duration $ttl + * Optional. The duration after which the workload will be terminated. + * When the workload passes this ttl, it will be unconditionally killed + * without waiting for ongoing work to finish. + * Minimum value is 10 minutes; maximum value is 14 days (see JSON + * representation of + * [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json)). + * If both ttl and idle_ttl are specified, the conditions are treated as + * and OR: the workload will be terminated when it has been idle for idle_ttl + * or when the ttl has passed, whichever comes first. + * If ttl is not specified for a session, it defaults to 24h. + * @type string $staging_bucket + * Optional. A Cloud Storage bucket used to stage workload dependencies, + * config files, and store workload output and other ephemeral data, such as + * Spark history files. If you do not specify a staging bucket, Cloud Dataproc + * will determine a Cloud Storage location according to the region where your + * workload is running, and then create and manage project-level, per-location + * staging and temporary buckets. + * **This field requires a Cloud Storage bucket name, not a `gs://...` URI to + * a Cloud Storage bucket.** * } */ public function __construct($data = NULL) { @@ -198,6 +246,100 @@ public function setKmsKey($var) return $this; } + /** + * Optional. The duration after which the workload will be terminated. + * When the workload passes this ttl, it will be unconditionally killed + * without waiting for ongoing work to finish. + * Minimum value is 10 minutes; maximum value is 14 days (see JSON + * representation of + * [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json)). + * If both ttl and idle_ttl are specified, the conditions are treated as + * and OR: the workload will be terminated when it has been idle for idle_ttl + * or when the ttl has passed, whichever comes first. + * If ttl is not specified for a session, it defaults to 24h. + * + * Generated from protobuf field .google.protobuf.Duration ttl = 9 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Protobuf\Duration|null + */ + public function getTtl() + { + return $this->ttl; + } + + public function hasTtl() + { + return isset($this->ttl); + } + + public function clearTtl() + { + unset($this->ttl); + } + + /** + * Optional. The duration after which the workload will be terminated. + * When the workload passes this ttl, it will be unconditionally killed + * without waiting for ongoing work to finish. + * Minimum value is 10 minutes; maximum value is 14 days (see JSON + * representation of + * [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json)). + * If both ttl and idle_ttl are specified, the conditions are treated as + * and OR: the workload will be terminated when it has been idle for idle_ttl + * or when the ttl has passed, whichever comes first. + * If ttl is not specified for a session, it defaults to 24h. + * + * Generated from protobuf field .google.protobuf.Duration ttl = 9 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Protobuf\Duration $var + * @return $this + */ + public function setTtl($var) + { + GPBUtil::checkMessage($var, \Google\Protobuf\Duration::class); + $this->ttl = $var; + + return $this; + } + + /** + * Optional. A Cloud Storage bucket used to stage workload dependencies, + * config files, and store workload output and other ephemeral data, such as + * Spark history files. If you do not specify a staging bucket, Cloud Dataproc + * will determine a Cloud Storage location according to the region where your + * workload is running, and then create and manage project-level, per-location + * staging and temporary buckets. + * **This field requires a Cloud Storage bucket name, not a `gs://...` URI to + * a Cloud Storage bucket.** + * + * Generated from protobuf field string staging_bucket = 10 [(.google.api.field_behavior) = OPTIONAL]; + * @return string + */ + public function getStagingBucket() + { + return $this->staging_bucket; + } + + /** + * Optional. A Cloud Storage bucket used to stage workload dependencies, + * config files, and store workload output and other ephemeral data, such as + * Spark history files. If you do not specify a staging bucket, Cloud Dataproc + * will determine a Cloud Storage location according to the region where your + * workload is running, and then create and manage project-level, per-location + * staging and temporary buckets. + * **This field requires a Cloud Storage bucket name, not a `gs://...` URI to + * a Cloud Storage bucket.** + * + * Generated from protobuf field string staging_bucket = 10 [(.google.api.field_behavior) = OPTIONAL]; + * @param string $var + * @return $this + */ + public function setStagingBucket($var) + { + GPBUtil::checkString($var, True); + $this->staging_bucket = $var; + + return $this; + } + /** * @return string */ diff --git a/Dataproc/src/V1/Gapic/BatchControllerGapicClient.php b/Dataproc/src/V1/Gapic/BatchControllerGapicClient.php index d98a7378e63..aeb933f2ea2 100644 --- a/Dataproc/src/V1/Gapic/BatchControllerGapicClient.php +++ b/Dataproc/src/V1/Gapic/BatchControllerGapicClient.php @@ -383,8 +383,8 @@ public function __construct(array $options = []) * Optional. * * @type string $batchId - * Optional. The ID to use for the batch, which will become the final component of - * the batch's resource name. + * Optional. The ID to use for the batch, which will become the final + * component of the batch's resource name. * * This value must be 4-63 characters. Valid characters are `/[a-z][0-9]-/`. * @type string $requestId @@ -445,7 +445,9 @@ public function createBatch($parent, $batch, array $optionalArgs = []) * } * ``` * - * @param string $name Required. The name of the batch resource to delete. + * @param string $name Required. The fully qualified name of the batch to retrieve + * in the format + * "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID" * @param array $optionalArgs { * Optional. * @@ -482,7 +484,9 @@ public function deleteBatch($name, array $optionalArgs = []) * } * ``` * - * @param string $name Required. The name of the batch to retrieve. + * @param string $name Required. The fully qualified name of the batch to retrieve + * in the format + * "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID" * @param array $optionalArgs { * Optional. * @@ -546,6 +550,26 @@ public function getBatch($name, array $optionalArgs = []) * If no page token is specified (the default), the first page * of values will be returned. Any page token used here must have * been generated by a previous call to the API. + * @type string $filter + * Optional. A filter for the batches to return in the response. + * + * A filter is a logical expression constraining the values of various fields + * in each batch resource. Filters are case sensitive, and may contain + * multiple clauses combined with logical operators (AND/OR). + * Supported fields are `batch_id`, `batch_uuid`, `state`, and `create_time`. + * + * e.g. `state = RUNNING and create_time < "2023-01-01T00:00:00Z"` + * filters for batches in state RUNNING that were created before 2023-01-01 + * + * See https://google.aip.dev/assets/misc/ebnf-filtering.txt for a detailed + * description of the filter syntax and a list of supported comparisons. + * @type string $orderBy + * Optional. Field(s) on which to sort the list of batches. + * + * Currently the only supported sort orders are unspecified (empty) and + * `create_time desc` to sort by most recently created batches first. + * + * See https://google.aip.dev/132#ordering for more details. * @type RetrySettings|array $retrySettings * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an * associative array of retry settings parameters. See the documentation on @@ -570,6 +594,14 @@ public function listBatches($parent, array $optionalArgs = []) $request->setPageToken($optionalArgs['pageToken']); } + if (isset($optionalArgs['filter'])) { + $request->setFilter($optionalArgs['filter']); + } + + if (isset($optionalArgs['orderBy'])) { + $request->setOrderBy($optionalArgs['orderBy']); + } + $requestParams = new RequestParamsHeaderDescriptor($requestParamHeaders); $optionalArgs['headers'] = isset($optionalArgs['headers']) ? array_merge($requestParams->getHeader(), $optionalArgs['headers']) : $requestParams->getHeader(); return $this->getPagedListResponse('ListBatches', $optionalArgs, ListBatchesResponse::class, $request); diff --git a/Dataproc/src/V1/Gapic/ClusterControllerGapicClient.php b/Dataproc/src/V1/Gapic/ClusterControllerGapicClient.php index 49f74b3fd19..306a221e2d4 100644 --- a/Dataproc/src/V1/Gapic/ClusterControllerGapicClient.php +++ b/Dataproc/src/V1/Gapic/ClusterControllerGapicClient.php @@ -947,7 +947,7 @@ public function stopCluster($projectId, $region, $clusterName, array $optionalAr * Optional. * * @type Duration $gracefulDecommissionTimeout - * Optional. Timeout for graceful YARN decomissioning. Graceful + * Optional. Timeout for graceful YARN decommissioning. Graceful * decommissioning allows removing nodes from the cluster without * interrupting jobs in progress. Timeout specifies how long to wait for jobs * in progress to finish before forcefully removing nodes (and potentially diff --git a/Dataproc/src/V1/Gapic/NodeGroupControllerGapicClient.php b/Dataproc/src/V1/Gapic/NodeGroupControllerGapicClient.php index 6d1ffe182c9..3c603dfa37c 100644 --- a/Dataproc/src/V1/Gapic/NodeGroupControllerGapicClient.php +++ b/Dataproc/src/V1/Gapic/NodeGroupControllerGapicClient.php @@ -545,7 +545,7 @@ public function getNodeGroup($name, array $optionalArgs = []) * The ID must contain only letters (a-z, A-Z), numbers (0-9), * underscores (_), and hyphens (-). The maximum length is 40 characters. * @type Duration $gracefulDecommissionTimeout - * Optional. Timeout for graceful YARN decommissioning. [Graceful + * Optional. Timeout for graceful YARN decomissioning. [Graceful * decommissioning] * (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/scaling-clusters#graceful_decommissioning) * allows the removal of nodes from the Compute Engine node group diff --git a/Dataproc/src/V1/Gapic/WorkflowTemplateServiceGapicClient.php b/Dataproc/src/V1/Gapic/WorkflowTemplateServiceGapicClient.php index bde5a0d9fd4..55d7c2528b1 100644 --- a/Dataproc/src/V1/Gapic/WorkflowTemplateServiceGapicClient.php +++ b/Dataproc/src/V1/Gapic/WorkflowTemplateServiceGapicClient.php @@ -580,7 +580,8 @@ public function getWorkflowTemplate($name, array $optionalArgs = []) * Instantiates a template and begins execution. * * This method is equivalent to executing the sequence - * [CreateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.CreateWorkflowTemplate], [InstantiateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.InstantiateWorkflowTemplate], + * [CreateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.CreateWorkflowTemplate], + * [InstantiateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.InstantiateWorkflowTemplate], * [DeleteWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.DeleteWorkflowTemplate]. * * The returned Operation can be used to track execution of diff --git a/Dataproc/src/V1/GceClusterConfig.php b/Dataproc/src/V1/GceClusterConfig.php index 0b4c912f7bd..807eb61800b 100644 --- a/Dataproc/src/V1/GceClusterConfig.php +++ b/Dataproc/src/V1/GceClusterConfig.php @@ -17,15 +17,13 @@ class GceClusterConfig extends \Google\Protobuf\Internal\Message { /** - * Optional. The zone where the Compute Engine cluster will be located. - * On a create request, it is required in the "global" region. If omitted - * in a non-global Dataproc region, the service will pick a zone in the - * corresponding Compute Engine region. On a get request, zone will - * always be present. + * Optional. The Compute Engine zone where the Dataproc cluster will be + * located. If omitted, the service will pick a zone in the cluster's 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` + * * `[zone]` * * Generated from protobuf field string zone_uri = 1 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -38,8 +36,8 @@ class GceClusterConfig extends \Google\Protobuf\Internal\Message * [Using Subnetworks](https://cloud.google.com/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` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/global/networks/default` + * * `projects/[project_id]/global/networks/default` * * `default` * * Generated from protobuf field string network_uri = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -49,8 +47,8 @@ class GceClusterConfig extends \Google\Protobuf\Internal\Message * Optional. The 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/subnetworks/sub0` - * * `projects/[project_id]/regions/us-east1/subnetworks/sub0` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/[region]/subnetworks/sub0` + * * `projects/[project_id]/regions/[region]/subnetworks/sub0` * * `sub0` * * Generated from protobuf field string subnetwork_uri = 6 [(.google.api.field_behavior) = OPTIONAL]; @@ -64,9 +62,9 @@ class GceClusterConfig extends \Google\Protobuf\Internal\Message * subnetwork enabled networks, and all off-cluster dependencies must be * configured to be accessible without external IP addresses. * - * Generated from protobuf field bool internal_ip_only = 7 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field optional bool internal_ip_only = 7 [(.google.api.field_behavior) = OPTIONAL]; */ - private $internal_ip_only = false; + private $internal_ip_only = null; /** * Optional. The type of IPv6 access for a cluster. * @@ -154,15 +152,13 @@ class GceClusterConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $zone_uri - * Optional. The zone where the Compute Engine cluster will be located. - * On a create request, it is required in the "global" region. If omitted - * in a non-global Dataproc region, the service will pick a zone in the - * corresponding Compute Engine region. On a get request, zone will - * always be present. + * Optional. The Compute Engine zone where the Dataproc cluster will be + * located. If omitted, the service will pick a zone in the cluster's 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` + * * `[zone]` * @type string $network_uri * Optional. The Compute Engine network to be used for machine * communications. Cannot be specified with subnetwork_uri. If neither @@ -171,15 +167,15 @@ class GceClusterConfig extends \Google\Protobuf\Internal\Message * [Using Subnetworks](https://cloud.google.com/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` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/global/networks/default` + * * `projects/[project_id]/global/networks/default` * * `default` * @type string $subnetwork_uri * Optional. The 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/subnetworks/sub0` - * * `projects/[project_id]/regions/us-east1/subnetworks/sub0` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/[region]/subnetworks/sub0` + * * `projects/[project_id]/regions/[region]/subnetworks/sub0` * * `sub0` * @type bool $internal_ip_only * Optional. If true, all instances in the cluster will only have internal IP @@ -239,15 +235,13 @@ public function __construct($data = NULL) { } /** - * Optional. The zone where the Compute Engine cluster will be located. - * On a create request, it is required in the "global" region. If omitted - * in a non-global Dataproc region, the service will pick a zone in the - * corresponding Compute Engine region. On a get request, zone will - * always be present. + * Optional. The Compute Engine zone where the Dataproc cluster will be + * located. If omitted, the service will pick a zone in the cluster's 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` + * * `[zone]` * * Generated from protobuf field string zone_uri = 1 [(.google.api.field_behavior) = OPTIONAL]; * @return string @@ -258,15 +252,13 @@ public function getZoneUri() } /** - * Optional. The zone where the Compute Engine cluster will be located. - * On a create request, it is required in the "global" region. If omitted - * in a non-global Dataproc region, the service will pick a zone in the - * corresponding Compute Engine region. On a get request, zone will - * always be present. + * Optional. The Compute Engine zone where the Dataproc cluster will be + * located. If omitted, the service will pick a zone in the cluster's 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` + * * `[zone]` * * Generated from protobuf field string zone_uri = 1 [(.google.api.field_behavior) = OPTIONAL]; * @param string $var @@ -288,8 +280,8 @@ public function setZoneUri($var) * [Using Subnetworks](https://cloud.google.com/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` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/global/networks/default` + * * `projects/[project_id]/global/networks/default` * * `default` * * Generated from protobuf field string network_uri = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -308,8 +300,8 @@ public function getNetworkUri() * [Using Subnetworks](https://cloud.google.com/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` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/global/networks/default` + * * `projects/[project_id]/global/networks/default` * * `default` * * Generated from protobuf field string network_uri = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -328,8 +320,8 @@ public function setNetworkUri($var) * Optional. The 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/subnetworks/sub0` - * * `projects/[project_id]/regions/us-east1/subnetworks/sub0` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/[region]/subnetworks/sub0` + * * `projects/[project_id]/regions/[region]/subnetworks/sub0` * * `sub0` * * Generated from protobuf field string subnetwork_uri = 6 [(.google.api.field_behavior) = OPTIONAL]; @@ -344,8 +336,8 @@ public function getSubnetworkUri() * Optional. The 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/subnetworks/sub0` - * * `projects/[project_id]/regions/us-east1/subnetworks/sub0` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/[region]/subnetworks/sub0` + * * `projects/[project_id]/regions/[region]/subnetworks/sub0` * * `sub0` * * Generated from protobuf field string subnetwork_uri = 6 [(.google.api.field_behavior) = OPTIONAL]; @@ -368,12 +360,22 @@ public function setSubnetworkUri($var) * subnetwork enabled networks, and all off-cluster dependencies must be * configured to be accessible without external IP addresses. * - * Generated from protobuf field bool internal_ip_only = 7 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field optional bool internal_ip_only = 7 [(.google.api.field_behavior) = OPTIONAL]; * @return bool */ public function getInternalIpOnly() { - return $this->internal_ip_only; + return isset($this->internal_ip_only) ? $this->internal_ip_only : false; + } + + public function hasInternalIpOnly() + { + return isset($this->internal_ip_only); + } + + public function clearInternalIpOnly() + { + unset($this->internal_ip_only); } /** @@ -384,7 +386,7 @@ public function getInternalIpOnly() * subnetwork enabled networks, and all off-cluster dependencies must be * configured to be accessible without external IP addresses. * - * Generated from protobuf field bool internal_ip_only = 7 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field optional bool internal_ip_only = 7 [(.google.api.field_behavior) = OPTIONAL]; * @param bool $var * @return $this */ diff --git a/Dataproc/src/V1/GetBatchRequest.php b/Dataproc/src/V1/GetBatchRequest.php index e9b8b081799..bd201ae1661 100644 --- a/Dataproc/src/V1/GetBatchRequest.php +++ b/Dataproc/src/V1/GetBatchRequest.php @@ -16,7 +16,9 @@ class GetBatchRequest extends \Google\Protobuf\Internal\Message { /** - * Required. The name of the batch to retrieve. + * Required. The fully qualified name of the batch to retrieve + * in the format + * "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID" * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -29,7 +31,9 @@ class GetBatchRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $name - * Required. The name of the batch to retrieve. + * Required. The fully qualified name of the batch to retrieve + * in the format + * "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID" * } */ public function __construct($data = NULL) { @@ -38,7 +42,9 @@ public function __construct($data = NULL) { } /** - * Required. The name of the batch to retrieve. + * Required. The fully qualified name of the batch to retrieve + * in the format + * "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID" * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -49,7 +55,9 @@ public function getName() } /** - * Required. The name of the batch to retrieve. + * Required. The fully qualified name of the batch to retrieve + * in the format + * "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID" * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/Dataproc/src/V1/GkeClusterConfig.php b/Dataproc/src/V1/GkeClusterConfig.php index d7078affb26..44336535133 100644 --- a/Dataproc/src/V1/GkeClusterConfig.php +++ b/Dataproc/src/V1/GkeClusterConfig.php @@ -16,19 +16,21 @@ class GkeClusterConfig extends \Google\Protobuf\Internal\Message { /** - * Optional. A target GKE cluster to deploy to. It must be in the same project and - * region as the Dataproc cluster (the GKE cluster can be zonal or regional). - * Format: 'projects/{project}/locations/{location}/clusters/{cluster_id}' + * Optional. A target GKE cluster to deploy to. It must be in the same project + * and region as the Dataproc cluster (the GKE cluster can be zonal or + * regional). Format: + * 'projects/{project}/locations/{location}/clusters/{cluster_id}' * - * Generated from protobuf field string gke_cluster_target = 2 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field string gke_cluster_target = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { */ private $gke_cluster_target = ''; /** - * Optional. GKE NodePools where workloads will be scheduled. At least one node pool - * must be assigned the 'default' role. Each role can be given to only a - * single NodePoolTarget. All NodePools must have the same location settings. - * If a nodePoolTarget is not specified, Dataproc constructs a default - * nodePoolTarget. + * Optional. GKE node pools where workloads will be scheduled. At least one + * node pool must be assigned the `DEFAULT` + * [GkeNodePoolTarget.Role][google.cloud.dataproc.v1.GkeNodePoolTarget.Role]. + * If a `GkeNodePoolTarget` is not specified, Dataproc constructs a `DEFAULT` + * `GkeNodePoolTarget`. Each role can be given to only one + * `GkeNodePoolTarget`. All node pools must have the same location settings. * * Generated from protobuf field repeated .google.cloud.dataproc.v1.GkeNodePoolTarget node_pool_target = 3 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -41,15 +43,17 @@ class GkeClusterConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $gke_cluster_target - * Optional. A target GKE cluster to deploy to. It must be in the same project and - * region as the Dataproc cluster (the GKE cluster can be zonal or regional). - * Format: 'projects/{project}/locations/{location}/clusters/{cluster_id}' + * Optional. A target GKE cluster to deploy to. It must be in the same project + * and region as the Dataproc cluster (the GKE cluster can be zonal or + * regional). Format: + * 'projects/{project}/locations/{location}/clusters/{cluster_id}' * @type array<\Google\Cloud\Dataproc\V1\GkeNodePoolTarget>|\Google\Protobuf\Internal\RepeatedField $node_pool_target - * Optional. GKE NodePools where workloads will be scheduled. At least one node pool - * must be assigned the 'default' role. Each role can be given to only a - * single NodePoolTarget. All NodePools must have the same location settings. - * If a nodePoolTarget is not specified, Dataproc constructs a default - * nodePoolTarget. + * Optional. GKE node pools where workloads will be scheduled. At least one + * node pool must be assigned the `DEFAULT` + * [GkeNodePoolTarget.Role][google.cloud.dataproc.v1.GkeNodePoolTarget.Role]. + * If a `GkeNodePoolTarget` is not specified, Dataproc constructs a `DEFAULT` + * `GkeNodePoolTarget`. Each role can be given to only one + * `GkeNodePoolTarget`. All node pools must have the same location settings. * } */ public function __construct($data = NULL) { @@ -58,11 +62,12 @@ public function __construct($data = NULL) { } /** - * Optional. A target GKE cluster to deploy to. It must be in the same project and - * region as the Dataproc cluster (the GKE cluster can be zonal or regional). - * Format: 'projects/{project}/locations/{location}/clusters/{cluster_id}' + * Optional. A target GKE cluster to deploy to. It must be in the same project + * and region as the Dataproc cluster (the GKE cluster can be zonal or + * regional). Format: + * 'projects/{project}/locations/{location}/clusters/{cluster_id}' * - * Generated from protobuf field string gke_cluster_target = 2 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field string gke_cluster_target = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @return string */ public function getGkeClusterTarget() @@ -71,11 +76,12 @@ public function getGkeClusterTarget() } /** - * Optional. A target GKE cluster to deploy to. It must be in the same project and - * region as the Dataproc cluster (the GKE cluster can be zonal or regional). - * Format: 'projects/{project}/locations/{location}/clusters/{cluster_id}' + * Optional. A target GKE cluster to deploy to. It must be in the same project + * and region as the Dataproc cluster (the GKE cluster can be zonal or + * regional). Format: + * 'projects/{project}/locations/{location}/clusters/{cluster_id}' * - * Generated from protobuf field string gke_cluster_target = 2 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field string gke_cluster_target = 2 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @param string $var * @return $this */ @@ -88,11 +94,12 @@ public function setGkeClusterTarget($var) } /** - * Optional. GKE NodePools where workloads will be scheduled. At least one node pool - * must be assigned the 'default' role. Each role can be given to only a - * single NodePoolTarget. All NodePools must have the same location settings. - * If a nodePoolTarget is not specified, Dataproc constructs a default - * nodePoolTarget. + * Optional. GKE node pools where workloads will be scheduled. At least one + * node pool must be assigned the `DEFAULT` + * [GkeNodePoolTarget.Role][google.cloud.dataproc.v1.GkeNodePoolTarget.Role]. + * If a `GkeNodePoolTarget` is not specified, Dataproc constructs a `DEFAULT` + * `GkeNodePoolTarget`. Each role can be given to only one + * `GkeNodePoolTarget`. All node pools must have the same location settings. * * Generated from protobuf field repeated .google.cloud.dataproc.v1.GkeNodePoolTarget node_pool_target = 3 [(.google.api.field_behavior) = OPTIONAL]; * @return \Google\Protobuf\Internal\RepeatedField @@ -103,11 +110,12 @@ public function getNodePoolTarget() } /** - * Optional. GKE NodePools where workloads will be scheduled. At least one node pool - * must be assigned the 'default' role. Each role can be given to only a - * single NodePoolTarget. All NodePools must have the same location settings. - * If a nodePoolTarget is not specified, Dataproc constructs a default - * nodePoolTarget. + * Optional. GKE node pools where workloads will be scheduled. At least one + * node pool must be assigned the `DEFAULT` + * [GkeNodePoolTarget.Role][google.cloud.dataproc.v1.GkeNodePoolTarget.Role]. + * If a `GkeNodePoolTarget` is not specified, Dataproc constructs a `DEFAULT` + * `GkeNodePoolTarget`. Each role can be given to only one + * `GkeNodePoolTarget`. All node pools must have the same location settings. * * Generated from protobuf field repeated .google.cloud.dataproc.v1.GkeNodePoolTarget node_pool_target = 3 [(.google.api.field_behavior) = OPTIONAL]; * @param array<\Google\Cloud\Dataproc\V1\GkeNodePoolTarget>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Dataproc/src/V1/GkeNodePoolConfig.php b/Dataproc/src/V1/GkeNodePoolConfig.php index 8ebadd7b9d5..108af17f3ff 100644 --- a/Dataproc/src/V1/GkeNodePoolConfig.php +++ b/Dataproc/src/V1/GkeNodePoolConfig.php @@ -9,7 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * The configuration of a GKE NodePool used by a [Dataproc-on-GKE + * The configuration of a GKE node pool used by a [Dataproc-on-GKE * cluster](https://cloud.google.com/dataproc/docs/concepts/jobs/dataproc-gke#create-a-dataproc-on-gke-cluster). * * Generated from protobuf message google.cloud.dataproc.v1.GkeNodePoolConfig @@ -25,17 +25,20 @@ class GkeNodePoolConfig extends \Google\Protobuf\Internal\Message /** * Optional. The list of Compute Engine * [zones](https://cloud.google.com/compute/docs/zones#available) where - * NodePool's nodes will be located. - * **Note:** Currently, only one zone may be specified. - * If a location is not specified during NodePool creation, Dataproc will - * choose a location. + * node pool nodes associated with a Dataproc on GKE virtual cluster + * will be located. + * **Note:** All node pools associated with a virtual cluster + * must be located in the same region as the virtual cluster, and they must + * be located in the same zone within that region. + * If a location is not specified during node pool creation, Dataproc on GKE + * will choose the zone. * * Generated from protobuf field repeated string locations = 13 [(.google.api.field_behavior) = OPTIONAL]; */ private $locations; /** - * Optional. The autoscaler configuration for this NodePool. The autoscaler is enabled - * only when a valid configuration is present. + * Optional. The autoscaler configuration for this node pool. The autoscaler + * is enabled only when a valid configuration is present. * * Generated from protobuf field .google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodePoolAutoscalingConfig autoscaling = 4 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -52,13 +55,16 @@ class GkeNodePoolConfig extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\RepeatedField $locations * Optional. The list of Compute Engine * [zones](https://cloud.google.com/compute/docs/zones#available) where - * NodePool's nodes will be located. - * **Note:** Currently, only one zone may be specified. - * If a location is not specified during NodePool creation, Dataproc will - * choose a location. + * node pool nodes associated with a Dataproc on GKE virtual cluster + * will be located. + * **Note:** All node pools associated with a virtual cluster + * must be located in the same region as the virtual cluster, and they must + * be located in the same zone within that region. + * If a location is not specified during node pool creation, Dataproc on GKE + * will choose the zone. * @type \Google\Cloud\Dataproc\V1\GkeNodePoolConfig\GkeNodePoolAutoscalingConfig $autoscaling - * Optional. The autoscaler configuration for this NodePool. The autoscaler is enabled - * only when a valid configuration is present. + * Optional. The autoscaler configuration for this node pool. The autoscaler + * is enabled only when a valid configuration is present. * } */ public function __construct($data = NULL) { @@ -105,10 +111,13 @@ public function setConfig($var) /** * Optional. The list of Compute Engine * [zones](https://cloud.google.com/compute/docs/zones#available) where - * NodePool's nodes will be located. - * **Note:** Currently, only one zone may be specified. - * If a location is not specified during NodePool creation, Dataproc will - * choose a location. + * node pool nodes associated with a Dataproc on GKE virtual cluster + * will be located. + * **Note:** All node pools associated with a virtual cluster + * must be located in the same region as the virtual cluster, and they must + * be located in the same zone within that region. + * If a location is not specified during node pool creation, Dataproc on GKE + * will choose the zone. * * Generated from protobuf field repeated string locations = 13 [(.google.api.field_behavior) = OPTIONAL]; * @return \Google\Protobuf\Internal\RepeatedField @@ -121,10 +130,13 @@ public function getLocations() /** * Optional. The list of Compute Engine * [zones](https://cloud.google.com/compute/docs/zones#available) where - * NodePool's nodes will be located. - * **Note:** Currently, only one zone may be specified. - * If a location is not specified during NodePool creation, Dataproc will - * choose a location. + * node pool nodes associated with a Dataproc on GKE virtual cluster + * will be located. + * **Note:** All node pools associated with a virtual cluster + * must be located in the same region as the virtual cluster, and they must + * be located in the same zone within that region. + * If a location is not specified during node pool creation, Dataproc on GKE + * will choose the zone. * * Generated from protobuf field repeated string locations = 13 [(.google.api.field_behavior) = OPTIONAL]; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -139,8 +151,8 @@ public function setLocations($var) } /** - * Optional. The autoscaler configuration for this NodePool. The autoscaler is enabled - * only when a valid configuration is present. + * Optional. The autoscaler configuration for this node pool. The autoscaler + * is enabled only when a valid configuration is present. * * Generated from protobuf field .google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodePoolAutoscalingConfig autoscaling = 4 [(.google.api.field_behavior) = OPTIONAL]; * @return \Google\Cloud\Dataproc\V1\GkeNodePoolConfig\GkeNodePoolAutoscalingConfig|null @@ -161,8 +173,8 @@ public function clearAutoscaling() } /** - * Optional. The autoscaler configuration for this NodePool. The autoscaler is enabled - * only when a valid configuration is present. + * Optional. The autoscaler configuration for this node pool. The autoscaler + * is enabled only when a valid configuration is present. * * Generated from protobuf field .google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodePoolAutoscalingConfig autoscaling = 4 [(.google.api.field_behavior) = OPTIONAL]; * @param \Google\Cloud\Dataproc\V1\GkeNodePoolConfig\GkeNodePoolAutoscalingConfig $var diff --git a/Dataproc/src/V1/GkeNodePoolConfig/GkeNodeConfig.php b/Dataproc/src/V1/GkeNodePoolConfig/GkeNodeConfig.php index 715e7e91514..d4b8d4bc95a 100644 --- a/Dataproc/src/V1/GkeNodePoolConfig/GkeNodeConfig.php +++ b/Dataproc/src/V1/GkeNodePoolConfig/GkeNodeConfig.php @@ -23,20 +23,28 @@ class GkeNodeConfig extends \Google\Protobuf\Internal\Message */ private $machine_type = ''; /** - * Optional. Whether the nodes are created as [preemptible VM - * instances](https://cloud.google.com/compute/docs/instances/preemptible). + * Optional. The number of local SSD disks to attach to the node, which is + * limited by the maximum number of disks allowable per zone (see [Adding + * Local SSDs](https://cloud.google.com/compute/docs/disks/local-ssd)). * - * Generated from protobuf field bool preemptible = 10 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field int32 local_ssd_count = 7 [(.google.api.field_behavior) = OPTIONAL]; */ - private $preemptible = false; + private $local_ssd_count = 0; /** - * Optional. The number of local SSD disks to attach to the node, which is limited by - * the maximum number of disks allowable per zone (see [Adding Local - * SSDs](https://cloud.google.com/compute/docs/disks/local-ssd)). + * Optional. Whether the nodes are created as legacy [preemptible VM + * instances] (https://cloud.google.com/compute/docs/instances/preemptible). + * Also see + * [Spot][google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodeConfig.spot] + * VMs, preemptible VM instances without a maximum lifetime. Legacy and Spot + * preemptible nodes cannot be used in a node pool with the `CONTROLLER` + * [role] + * (/dataproc/docs/reference/rest/v1/projects.regions.clusters#role) + * or in the DEFAULT node pool if the CONTROLLER role is not assigned (the + * DEFAULT node pool will assume the CONTROLLER role). * - * Generated from protobuf field int32 local_ssd_count = 7 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field bool preemptible = 10 [(.google.api.field_behavior) = OPTIONAL]; */ - private $local_ssd_count = 0; + private $preemptible = false; /** * Optional. A list of [hardware * accelerators](https://cloud.google.com/compute/docs/gpus) to attach to @@ -55,6 +63,31 @@ class GkeNodeConfig extends \Google\Protobuf\Internal\Message * Generated from protobuf field string min_cpu_platform = 13 [(.google.api.field_behavior) = OPTIONAL]; */ private $min_cpu_platform = ''; + /** + * Optional. The [Customer Managed Encryption Key (CMEK)] + * (https://cloud.google.com/kubernetes-engine/docs/how-to/using-cmek) + * used to encrypt the boot disk attached to each node in the node pool. + * Specify the key using the following format: + * projects/KEY_PROJECT_ID/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME. + * + * Generated from protobuf field string boot_disk_kms_key = 23 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $boot_disk_kms_key = ''; + /** + * Optional. Whether the nodes are created as [Spot VM instances] + * (https://cloud.google.com/compute/docs/instances/spot). + * Spot VMs are the latest update to legacy + * [preemptible + * VMs][google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodeConfig.preemptible]. + * Spot VMs do not have a maximum lifetime. Legacy and Spot preemptible + * nodes cannot be used in a node pool with the `CONTROLLER` + * [role](https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.clusters#role) + * or in the DEFAULT node pool if the CONTROLLER role is not assigned (the + * DEFAULT node pool will assume the CONTROLLER role). + * + * Generated from protobuf field bool spot = 32 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $spot = false; /** * Constructor. @@ -65,13 +98,21 @@ class GkeNodeConfig extends \Google\Protobuf\Internal\Message * @type string $machine_type * Optional. The name of a Compute Engine [machine * type](https://cloud.google.com/compute/docs/machine-types). - * @type bool $preemptible - * Optional. Whether the nodes are created as [preemptible VM - * instances](https://cloud.google.com/compute/docs/instances/preemptible). * @type int $local_ssd_count - * Optional. The number of local SSD disks to attach to the node, which is limited by - * the maximum number of disks allowable per zone (see [Adding Local - * SSDs](https://cloud.google.com/compute/docs/disks/local-ssd)). + * Optional. The number of local SSD disks to attach to the node, which is + * limited by the maximum number of disks allowable per zone (see [Adding + * Local SSDs](https://cloud.google.com/compute/docs/disks/local-ssd)). + * @type bool $preemptible + * Optional. Whether the nodes are created as legacy [preemptible VM + * instances] (https://cloud.google.com/compute/docs/instances/preemptible). + * Also see + * [Spot][google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodeConfig.spot] + * VMs, preemptible VM instances without a maximum lifetime. Legacy and Spot + * preemptible nodes cannot be used in a node pool with the `CONTROLLER` + * [role] + * (/dataproc/docs/reference/rest/v1/projects.regions.clusters#role) + * or in the DEFAULT node pool if the CONTROLLER role is not assigned (the + * DEFAULT node pool will assume the CONTROLLER role). * @type array<\Google\Cloud\Dataproc\V1\GkeNodePoolConfig\GkeNodePoolAcceleratorConfig>|\Google\Protobuf\Internal\RepeatedField $accelerators * Optional. A list of [hardware * accelerators](https://cloud.google.com/compute/docs/gpus) to attach to @@ -82,6 +123,23 @@ class GkeNodeConfig extends \Google\Protobuf\Internal\Message * to be used by this instance. The instance may be scheduled on the * specified or a newer CPU platform. Specify the friendly names of CPU * platforms, such as "Intel Haswell"` or Intel Sandy Bridge". + * @type string $boot_disk_kms_key + * Optional. The [Customer Managed Encryption Key (CMEK)] + * (https://cloud.google.com/kubernetes-engine/docs/how-to/using-cmek) + * used to encrypt the boot disk attached to each node in the node pool. + * Specify the key using the following format: + * projects/KEY_PROJECT_ID/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME. + * @type bool $spot + * Optional. Whether the nodes are created as [Spot VM instances] + * (https://cloud.google.com/compute/docs/instances/spot). + * Spot VMs are the latest update to legacy + * [preemptible + * VMs][google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodeConfig.preemptible]. + * Spot VMs do not have a maximum lifetime. Legacy and Spot preemptible + * nodes cannot be used in a node pool with the `CONTROLLER` + * [role](https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.clusters#role) + * or in the DEFAULT node pool if the CONTROLLER role is not assigned (the + * DEFAULT node pool will assume the CONTROLLER role). * } */ public function __construct($data = NULL) { @@ -118,59 +176,75 @@ public function setMachineType($var) } /** - * Optional. Whether the nodes are created as [preemptible VM - * instances](https://cloud.google.com/compute/docs/instances/preemptible). + * Optional. The number of local SSD disks to attach to the node, which is + * limited by the maximum number of disks allowable per zone (see [Adding + * Local SSDs](https://cloud.google.com/compute/docs/disks/local-ssd)). * - * Generated from protobuf field bool preemptible = 10 [(.google.api.field_behavior) = OPTIONAL]; - * @return bool + * Generated from protobuf field int32 local_ssd_count = 7 [(.google.api.field_behavior) = OPTIONAL]; + * @return int */ - public function getPreemptible() + public function getLocalSsdCount() { - return $this->preemptible; + return $this->local_ssd_count; } /** - * Optional. Whether the nodes are created as [preemptible VM - * instances](https://cloud.google.com/compute/docs/instances/preemptible). + * Optional. The number of local SSD disks to attach to the node, which is + * limited by the maximum number of disks allowable per zone (see [Adding + * Local SSDs](https://cloud.google.com/compute/docs/disks/local-ssd)). * - * Generated from protobuf field bool preemptible = 10 [(.google.api.field_behavior) = OPTIONAL]; - * @param bool $var + * Generated from protobuf field int32 local_ssd_count = 7 [(.google.api.field_behavior) = OPTIONAL]; + * @param int $var * @return $this */ - public function setPreemptible($var) + public function setLocalSsdCount($var) { - GPBUtil::checkBool($var); - $this->preemptible = $var; + GPBUtil::checkInt32($var); + $this->local_ssd_count = $var; return $this; } /** - * Optional. The number of local SSD disks to attach to the node, which is limited by - * the maximum number of disks allowable per zone (see [Adding Local - * SSDs](https://cloud.google.com/compute/docs/disks/local-ssd)). + * Optional. Whether the nodes are created as legacy [preemptible VM + * instances] (https://cloud.google.com/compute/docs/instances/preemptible). + * Also see + * [Spot][google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodeConfig.spot] + * VMs, preemptible VM instances without a maximum lifetime. Legacy and Spot + * preemptible nodes cannot be used in a node pool with the `CONTROLLER` + * [role] + * (/dataproc/docs/reference/rest/v1/projects.regions.clusters#role) + * or in the DEFAULT node pool if the CONTROLLER role is not assigned (the + * DEFAULT node pool will assume the CONTROLLER role). * - * Generated from protobuf field int32 local_ssd_count = 7 [(.google.api.field_behavior) = OPTIONAL]; - * @return int + * Generated from protobuf field bool preemptible = 10 [(.google.api.field_behavior) = OPTIONAL]; + * @return bool */ - public function getLocalSsdCount() + public function getPreemptible() { - return $this->local_ssd_count; + return $this->preemptible; } /** - * Optional. The number of local SSD disks to attach to the node, which is limited by - * the maximum number of disks allowable per zone (see [Adding Local - * SSDs](https://cloud.google.com/compute/docs/disks/local-ssd)). + * Optional. Whether the nodes are created as legacy [preemptible VM + * instances] (https://cloud.google.com/compute/docs/instances/preemptible). + * Also see + * [Spot][google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodeConfig.spot] + * VMs, preemptible VM instances without a maximum lifetime. Legacy and Spot + * preemptible nodes cannot be used in a node pool with the `CONTROLLER` + * [role] + * (/dataproc/docs/reference/rest/v1/projects.regions.clusters#role) + * or in the DEFAULT node pool if the CONTROLLER role is not assigned (the + * DEFAULT node pool will assume the CONTROLLER role). * - * Generated from protobuf field int32 local_ssd_count = 7 [(.google.api.field_behavior) = OPTIONAL]; - * @param int $var + * Generated from protobuf field bool preemptible = 10 [(.google.api.field_behavior) = OPTIONAL]; + * @param bool $var * @return $this */ - public function setLocalSsdCount($var) + public function setPreemptible($var) { - GPBUtil::checkInt32($var); - $this->local_ssd_count = $var; + GPBUtil::checkBool($var); + $this->preemptible = $var; return $this; } @@ -239,6 +313,84 @@ public function setMinCpuPlatform($var) return $this; } + /** + * Optional. The [Customer Managed Encryption Key (CMEK)] + * (https://cloud.google.com/kubernetes-engine/docs/how-to/using-cmek) + * used to encrypt the boot disk attached to each node in the node pool. + * Specify the key using the following format: + * projects/KEY_PROJECT_ID/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME. + * + * Generated from protobuf field string boot_disk_kms_key = 23 [(.google.api.field_behavior) = OPTIONAL]; + * @return string + */ + public function getBootDiskKmsKey() + { + return $this->boot_disk_kms_key; + } + + /** + * Optional. The [Customer Managed Encryption Key (CMEK)] + * (https://cloud.google.com/kubernetes-engine/docs/how-to/using-cmek) + * used to encrypt the boot disk attached to each node in the node pool. + * Specify the key using the following format: + * projects/KEY_PROJECT_ID/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME. + * + * Generated from protobuf field string boot_disk_kms_key = 23 [(.google.api.field_behavior) = OPTIONAL]; + * @param string $var + * @return $this + */ + public function setBootDiskKmsKey($var) + { + GPBUtil::checkString($var, True); + $this->boot_disk_kms_key = $var; + + return $this; + } + + /** + * Optional. Whether the nodes are created as [Spot VM instances] + * (https://cloud.google.com/compute/docs/instances/spot). + * Spot VMs are the latest update to legacy + * [preemptible + * VMs][google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodeConfig.preemptible]. + * Spot VMs do not have a maximum lifetime. Legacy and Spot preemptible + * nodes cannot be used in a node pool with the `CONTROLLER` + * [role](https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.clusters#role) + * or in the DEFAULT node pool if the CONTROLLER role is not assigned (the + * DEFAULT node pool will assume the CONTROLLER role). + * + * Generated from protobuf field bool spot = 32 [(.google.api.field_behavior) = OPTIONAL]; + * @return bool + */ + public function getSpot() + { + return $this->spot; + } + + /** + * Optional. Whether the nodes are created as [Spot VM instances] + * (https://cloud.google.com/compute/docs/instances/spot). + * Spot VMs are the latest update to legacy + * [preemptible + * VMs][google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodeConfig.preemptible]. + * Spot VMs do not have a maximum lifetime. Legacy and Spot preemptible + * nodes cannot be used in a node pool with the `CONTROLLER` + * [role](https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.clusters#role) + * or in the DEFAULT node pool if the CONTROLLER role is not assigned (the + * DEFAULT node pool will assume the CONTROLLER role). + * + * Generated from protobuf field bool spot = 32 [(.google.api.field_behavior) = OPTIONAL]; + * @param bool $var + * @return $this + */ + public function setSpot($var) + { + GPBUtil::checkBool($var); + $this->spot = $var; + + return $this; + } + } // Adding a class alias for backwards compatibility with the previous class name. diff --git a/Dataproc/src/V1/GkeNodePoolConfig/GkeNodePoolAcceleratorConfig.php b/Dataproc/src/V1/GkeNodePoolConfig/GkeNodePoolAcceleratorConfig.php index ccc6c8383e6..642cdacc226 100644 --- a/Dataproc/src/V1/GkeNodePoolConfig/GkeNodePoolAcceleratorConfig.php +++ b/Dataproc/src/V1/GkeNodePoolConfig/GkeNodePoolAcceleratorConfig.php @@ -10,7 +10,7 @@ /** * A GkeNodeConfigAcceleratorConfig represents a Hardware Accelerator request - * for a NodePool. + * for a node pool. * * Generated from protobuf message google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodePoolAcceleratorConfig */ @@ -28,6 +28,14 @@ class GkeNodePoolAcceleratorConfig extends \Google\Protobuf\Internal\Message * Generated from protobuf field string accelerator_type = 2; */ private $accelerator_type = ''; + /** + * Size of partitions to create on the GPU. Valid values are described in + * the NVIDIA [mig user + * guide](https://docs.nvidia.com/datacenter/tesla/mig-user-guide/#partitioning). + * + * Generated from protobuf field string gpu_partition_size = 3; + */ + private $gpu_partition_size = ''; /** * Constructor. @@ -39,6 +47,10 @@ class GkeNodePoolAcceleratorConfig extends \Google\Protobuf\Internal\Message * The number of accelerator cards exposed to an instance. * @type string $accelerator_type * The accelerator type resource namename (see GPUs on Compute Engine). + * @type string $gpu_partition_size + * Size of partitions to create on the GPU. Valid values are described in + * the NVIDIA [mig user + * guide](https://docs.nvidia.com/datacenter/tesla/mig-user-guide/#partitioning). * } */ public function __construct($data = NULL) { @@ -98,6 +110,36 @@ public function setAcceleratorType($var) return $this; } + /** + * Size of partitions to create on the GPU. Valid values are described in + * the NVIDIA [mig user + * guide](https://docs.nvidia.com/datacenter/tesla/mig-user-guide/#partitioning). + * + * Generated from protobuf field string gpu_partition_size = 3; + * @return string + */ + public function getGpuPartitionSize() + { + return $this->gpu_partition_size; + } + + /** + * Size of partitions to create on the GPU. Valid values are described in + * the NVIDIA [mig user + * guide](https://docs.nvidia.com/datacenter/tesla/mig-user-guide/#partitioning). + * + * Generated from protobuf field string gpu_partition_size = 3; + * @param string $var + * @return $this + */ + public function setGpuPartitionSize($var) + { + GPBUtil::checkString($var, True); + $this->gpu_partition_size = $var; + + return $this; + } + } // Adding a class alias for backwards compatibility with the previous class name. diff --git a/Dataproc/src/V1/GkeNodePoolConfig/GkeNodePoolAutoscalingConfig.php b/Dataproc/src/V1/GkeNodePoolConfig/GkeNodePoolAutoscalingConfig.php index 57ff9e89888..600d7a39563 100644 --- a/Dataproc/src/V1/GkeNodePoolConfig/GkeNodePoolAutoscalingConfig.php +++ b/Dataproc/src/V1/GkeNodePoolConfig/GkeNodePoolAutoscalingConfig.php @@ -17,14 +17,15 @@ class GkeNodePoolAutoscalingConfig extends \Google\Protobuf\Internal\Message { /** - * The minimum number of nodes in the NodePool. Must be >= 0 and <= + * The minimum number of nodes in the node pool. Must be >= 0 and <= * max_node_count. * * Generated from protobuf field int32 min_node_count = 2; */ private $min_node_count = 0; /** - * The maximum number of nodes in the NodePool. Must be >= min_node_count. + * The maximum number of nodes in the node pool. Must be >= min_node_count, + * and must be > 0. * **Note:** Quota must be sufficient to scale up the cluster. * * Generated from protobuf field int32 max_node_count = 3; @@ -38,10 +39,11 @@ class GkeNodePoolAutoscalingConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $min_node_count - * The minimum number of nodes in the NodePool. Must be >= 0 and <= + * The minimum number of nodes in the node pool. Must be >= 0 and <= * max_node_count. * @type int $max_node_count - * The maximum number of nodes in the NodePool. Must be >= min_node_count. + * The maximum number of nodes in the node pool. Must be >= min_node_count, + * and must be > 0. * **Note:** Quota must be sufficient to scale up the cluster. * } */ @@ -51,7 +53,7 @@ public function __construct($data = NULL) { } /** - * The minimum number of nodes in the NodePool. Must be >= 0 and <= + * The minimum number of nodes in the node pool. Must be >= 0 and <= * max_node_count. * * Generated from protobuf field int32 min_node_count = 2; @@ -63,7 +65,7 @@ public function getMinNodeCount() } /** - * The minimum number of nodes in the NodePool. Must be >= 0 and <= + * The minimum number of nodes in the node pool. Must be >= 0 and <= * max_node_count. * * Generated from protobuf field int32 min_node_count = 2; @@ -79,7 +81,8 @@ public function setMinNodeCount($var) } /** - * The maximum number of nodes in the NodePool. Must be >= min_node_count. + * The maximum number of nodes in the node pool. Must be >= min_node_count, + * and must be > 0. * **Note:** Quota must be sufficient to scale up the cluster. * * Generated from protobuf field int32 max_node_count = 3; @@ -91,7 +94,8 @@ public function getMaxNodeCount() } /** - * The maximum number of nodes in the NodePool. Must be >= min_node_count. + * The maximum number of nodes in the node pool. Must be >= min_node_count, + * and must be > 0. * **Note:** Quota must be sufficient to scale up the cluster. * * Generated from protobuf field int32 max_node_count = 3; diff --git a/Dataproc/src/V1/GkeNodePoolTarget.php b/Dataproc/src/V1/GkeNodePoolTarget.php index d9bf9a6762b..2b93f7d36b8 100644 --- a/Dataproc/src/V1/GkeNodePoolTarget.php +++ b/Dataproc/src/V1/GkeNodePoolTarget.php @@ -9,14 +9,14 @@ use Google\Protobuf\Internal\GPBUtil; /** - * GKE NodePools that Dataproc workloads run on. + * GKE node pools that Dataproc workloads run on. * * Generated from protobuf message google.cloud.dataproc.v1.GkeNodePoolTarget */ class GkeNodePoolTarget extends \Google\Protobuf\Internal\Message { /** - * Required. The target GKE NodePool. + * Required. The target GKE node pool. * Format: * 'projects/{project}/locations/{location}/clusters/{cluster}/nodePools/{node_pool}' * @@ -24,22 +24,23 @@ class GkeNodePoolTarget extends \Google\Protobuf\Internal\Message */ private $node_pool = ''; /** - * Required. The types of role for a GKE NodePool + * Required. The roles associated with the GKE node pool. * * Generated from protobuf field repeated .google.cloud.dataproc.v1.GkeNodePoolTarget.Role roles = 2 [(.google.api.field_behavior) = REQUIRED]; */ private $roles; /** - * Optional. The configuration for the GKE NodePool. - * If specified, Dataproc attempts to create a NodePool with the + * Input only. The configuration for the GKE node pool. + * If specified, Dataproc attempts to create a node pool with the * specified shape. If one with the same name already exists, it is * verified against all specified fields. If a field differs, the * virtual cluster creation will fail. - * If omitted, any NodePool with the specified name is used. If a - * NodePool with the specified name does not exist, Dataproc create a NodePool - * with default values. + * If omitted, any node pool with the specified name is used. If a + * node pool with the specified name does not exist, Dataproc create a + * node pool with default values. + * This is an input only field. It will not be returned by the API. * - * Generated from protobuf field .google.cloud.dataproc.v1.GkeNodePoolConfig node_pool_config = 3 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field .google.cloud.dataproc.v1.GkeNodePoolConfig node_pool_config = 3 [(.google.api.field_behavior) = INPUT_ONLY]; */ private $node_pool_config = null; @@ -50,20 +51,21 @@ class GkeNodePoolTarget extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $node_pool - * Required. The target GKE NodePool. + * Required. The target GKE node pool. * Format: * 'projects/{project}/locations/{location}/clusters/{cluster}/nodePools/{node_pool}' * @type array|\Google\Protobuf\Internal\RepeatedField $roles - * Required. The types of role for a GKE NodePool + * Required. The roles associated with the GKE node pool. * @type \Google\Cloud\Dataproc\V1\GkeNodePoolConfig $node_pool_config - * Optional. The configuration for the GKE NodePool. - * If specified, Dataproc attempts to create a NodePool with the + * Input only. The configuration for the GKE node pool. + * If specified, Dataproc attempts to create a node pool with the * specified shape. If one with the same name already exists, it is * verified against all specified fields. If a field differs, the * virtual cluster creation will fail. - * If omitted, any NodePool with the specified name is used. If a - * NodePool with the specified name does not exist, Dataproc create a NodePool - * with default values. + * If omitted, any node pool with the specified name is used. If a + * node pool with the specified name does not exist, Dataproc create a + * node pool with default values. + * This is an input only field. It will not be returned by the API. * } */ public function __construct($data = NULL) { @@ -72,7 +74,7 @@ public function __construct($data = NULL) { } /** - * Required. The target GKE NodePool. + * Required. The target GKE node pool. * Format: * 'projects/{project}/locations/{location}/clusters/{cluster}/nodePools/{node_pool}' * @@ -85,7 +87,7 @@ public function getNodePool() } /** - * Required. The target GKE NodePool. + * Required. The target GKE node pool. * Format: * 'projects/{project}/locations/{location}/clusters/{cluster}/nodePools/{node_pool}' * @@ -102,7 +104,7 @@ public function setNodePool($var) } /** - * Required. The types of role for a GKE NodePool + * Required. The roles associated with the GKE node pool. * * Generated from protobuf field repeated .google.cloud.dataproc.v1.GkeNodePoolTarget.Role roles = 2 [(.google.api.field_behavior) = REQUIRED]; * @return \Google\Protobuf\Internal\RepeatedField @@ -113,7 +115,7 @@ public function getRoles() } /** - * Required. The types of role for a GKE NodePool + * Required. The roles associated with the GKE node pool. * * Generated from protobuf field repeated .google.cloud.dataproc.v1.GkeNodePoolTarget.Role roles = 2 [(.google.api.field_behavior) = REQUIRED]; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -128,16 +130,17 @@ public function setRoles($var) } /** - * Optional. The configuration for the GKE NodePool. - * If specified, Dataproc attempts to create a NodePool with the + * Input only. The configuration for the GKE node pool. + * If specified, Dataproc attempts to create a node pool with the * specified shape. If one with the same name already exists, it is * verified against all specified fields. If a field differs, the * virtual cluster creation will fail. - * If omitted, any NodePool with the specified name is used. If a - * NodePool with the specified name does not exist, Dataproc create a NodePool - * with default values. + * If omitted, any node pool with the specified name is used. If a + * node pool with the specified name does not exist, Dataproc create a + * node pool with default values. + * This is an input only field. It will not be returned by the API. * - * Generated from protobuf field .google.cloud.dataproc.v1.GkeNodePoolConfig node_pool_config = 3 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field .google.cloud.dataproc.v1.GkeNodePoolConfig node_pool_config = 3 [(.google.api.field_behavior) = INPUT_ONLY]; * @return \Google\Cloud\Dataproc\V1\GkeNodePoolConfig|null */ public function getNodePoolConfig() @@ -156,16 +159,17 @@ public function clearNodePoolConfig() } /** - * Optional. The configuration for the GKE NodePool. - * If specified, Dataproc attempts to create a NodePool with the + * Input only. The configuration for the GKE node pool. + * If specified, Dataproc attempts to create a node pool with the * specified shape. If one with the same name already exists, it is * verified against all specified fields. If a field differs, the * virtual cluster creation will fail. - * If omitted, any NodePool with the specified name is used. If a - * NodePool with the specified name does not exist, Dataproc create a NodePool - * with default values. + * If omitted, any node pool with the specified name is used. If a + * node pool with the specified name does not exist, Dataproc create a + * node pool with default values. + * This is an input only field. It will not be returned by the API. * - * Generated from protobuf field .google.cloud.dataproc.v1.GkeNodePoolConfig node_pool_config = 3 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field .google.cloud.dataproc.v1.GkeNodePoolConfig node_pool_config = 3 [(.google.api.field_behavior) = INPUT_ONLY]; * @param \Google\Cloud\Dataproc\V1\GkeNodePoolConfig $var * @return $this */ diff --git a/Dataproc/src/V1/GkeNodePoolTarget/Role.php b/Dataproc/src/V1/GkeNodePoolTarget/Role.php index 086a9affe79..c6fe2d439dc 100644 --- a/Dataproc/src/V1/GkeNodePoolTarget/Role.php +++ b/Dataproc/src/V1/GkeNodePoolTarget/Role.php @@ -7,10 +7,11 @@ use UnexpectedValueException; /** - * `Role` specifies whose tasks will run on the NodePool. The roles can be - * specific to workloads. Exactly one GkeNodePoolTarget within the - * VirtualCluster must have 'default' role, which is used to run all workloads - * that are not associated with a NodePool. + * `Role` specifies the tasks that will run on the node pool. Roles can be + * specific to workloads. Exactly one + * [GkeNodePoolTarget][google.cloud.dataproc.v1.GkeNodePoolTarget] within the + * virtual cluster must have the `DEFAULT` role, which is used to run all + * workloads that are not associated with a node pool. * * Protobuf type google.cloud.dataproc.v1.GkeNodePoolTarget.Role */ @@ -23,26 +24,30 @@ class Role */ const ROLE_UNSPECIFIED = 0; /** - * Any roles that are not directly assigned to a NodePool run on the - * `default` role's NodePool. + * At least one node pool must have the `DEFAULT` role. + * Work assigned to a role that is not associated with a node pool + * is assigned to the node pool with the `DEFAULT` role. For example, + * work assigned to the `CONTROLLER` role will be assigned to the node pool + * with the `DEFAULT` role if no node pool has the `CONTROLLER` role. * * Generated from protobuf enum DEFAULT = 1; */ const PBDEFAULT = 1; /** - * Run controllers and webhooks. + * Run work associated with the Dataproc control plane (for example, + * controllers and webhooks). Very low resource requirements. * * Generated from protobuf enum CONTROLLER = 2; */ const CONTROLLER = 2; /** - * Run spark driver. + * Run work associated with a Spark driver of a job. * * Generated from protobuf enum SPARK_DRIVER = 3; */ const SPARK_DRIVER = 3; /** - * Run spark executors. + * Run work associated with a Spark executor of a job. * * Generated from protobuf enum SPARK_EXECUTOR = 4; */ diff --git a/Dataproc/src/V1/InstanceGroupConfig.php b/Dataproc/src/V1/InstanceGroupConfig.php index 78113a7a4cb..89b1468166b 100644 --- a/Dataproc/src/V1/InstanceGroupConfig.php +++ b/Dataproc/src/V1/InstanceGroupConfig.php @@ -38,12 +38,12 @@ class InstanceGroupConfig extends \Google\Protobuf\Internal\Message * Optional. The Compute Engine image resource used for cluster instances. * The URI can represent an image or image family. * Image examples: - * * `https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/[image-id]` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/global/images/[image-id]` * * `projects/[project_id]/global/images/[image-id]` * * `image-id` * Image family examples. Dataproc will use the most recent * image from the family: - * * `https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/family/[custom-image-family-name]` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/global/images/family/[custom-image-family-name]` * * `projects/[project_id]/global/images/family/[custom-image-family-name]` * If the URI is unspecified, it will be inferred from * `SoftwareConfig.image_version` or the system default. @@ -54,8 +54,8 @@ class InstanceGroupConfig extends \Google\Protobuf\Internal\Message /** * Optional. The 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` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]/machineTypes/n1-standard-2` + * * `projects/[project_id]/zones/[zone]/machineTypes/n1-standard-2` * * `n1-standard-2` * **Auto Zone Exception**: If you are using the Dataproc * [Auto Zone @@ -133,20 +133,20 @@ class InstanceGroupConfig extends \Google\Protobuf\Internal\Message * Optional. The Compute Engine image resource used for cluster instances. * The URI can represent an image or image family. * Image examples: - * * `https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/[image-id]` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/global/images/[image-id]` * * `projects/[project_id]/global/images/[image-id]` * * `image-id` * Image family examples. Dataproc will use the most recent * image from the family: - * * `https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/family/[custom-image-family-name]` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/global/images/family/[custom-image-family-name]` * * `projects/[project_id]/global/images/family/[custom-image-family-name]` * If the URI is unspecified, it will be inferred from * `SoftwareConfig.image_version` or the system default. * @type string $machine_type_uri * Optional. The 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` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]/machineTypes/n1-standard-2` + * * `projects/[project_id]/zones/[zone]/machineTypes/n1-standard-2` * * `n1-standard-2` * **Auto Zone Exception**: If you are using the Dataproc * [Auto Zone @@ -250,12 +250,12 @@ public function setInstanceNames($var) * Optional. The Compute Engine image resource used for cluster instances. * The URI can represent an image or image family. * Image examples: - * * `https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/[image-id]` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/global/images/[image-id]` * * `projects/[project_id]/global/images/[image-id]` * * `image-id` * Image family examples. Dataproc will use the most recent * image from the family: - * * `https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/family/[custom-image-family-name]` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/global/images/family/[custom-image-family-name]` * * `projects/[project_id]/global/images/family/[custom-image-family-name]` * If the URI is unspecified, it will be inferred from * `SoftwareConfig.image_version` or the system default. @@ -272,12 +272,12 @@ public function getImageUri() * Optional. The Compute Engine image resource used for cluster instances. * The URI can represent an image or image family. * Image examples: - * * `https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/[image-id]` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/global/images/[image-id]` * * `projects/[project_id]/global/images/[image-id]` * * `image-id` * Image family examples. Dataproc will use the most recent * image from the family: - * * `https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/family/[custom-image-family-name]` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/global/images/family/[custom-image-family-name]` * * `projects/[project_id]/global/images/family/[custom-image-family-name]` * If the URI is unspecified, it will be inferred from * `SoftwareConfig.image_version` or the system default. @@ -297,8 +297,8 @@ public function setImageUri($var) /** * Optional. The 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` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]/machineTypes/n1-standard-2` + * * `projects/[project_id]/zones/[zone]/machineTypes/n1-standard-2` * * `n1-standard-2` * **Auto Zone Exception**: If you are using the Dataproc * [Auto Zone @@ -317,8 +317,8 @@ public function getMachineTypeUri() /** * Optional. The 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` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]/machineTypes/n1-standard-2` + * * `projects/[project_id]/zones/[zone]/machineTypes/n1-standard-2` * * `n1-standard-2` * **Auto Zone Exception**: If you are using the Dataproc * [Auto Zone diff --git a/Dataproc/src/V1/Job.php b/Dataproc/src/V1/Job.php index f75c033914b..fd4efdbb76d 100644 --- a/Dataproc/src/V1/Job.php +++ b/Dataproc/src/V1/Job.php @@ -141,6 +141,8 @@ class Job extends \Google\Protobuf\Internal\Message * Optional. Job is a SparkSql job. * @type \Google\Cloud\Dataproc\V1\PrestoJob $presto_job * Optional. Job is a Presto job. + * @type \Google\Cloud\Dataproc\V1\TrinoJob $trino_job + * Optional. Job is a Trino 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 @@ -514,6 +516,37 @@ public function setPrestoJob($var) return $this; } + /** + * Optional. Job is a Trino job. + * + * Generated from protobuf field .google.cloud.dataproc.v1.TrinoJob trino_job = 28 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Cloud\Dataproc\V1\TrinoJob|null + */ + public function getTrinoJob() + { + return $this->readOneof(28); + } + + public function hasTrinoJob() + { + return $this->hasOneof(28); + } + + /** + * Optional. Job is a Trino job. + * + * Generated from protobuf field .google.cloud.dataproc.v1.TrinoJob trino_job = 28 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Cloud\Dataproc\V1\TrinoJob $var + * @return $this + */ + public function setTrinoJob($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Dataproc\V1\TrinoJob::class); + $this->writeOneof(28, $var); + + return $this; + } + /** * Output only. The job status. Additional application-specific * status information may be contained in the type_job diff --git a/Dataproc/src/V1/KubernetesClusterConfig.php b/Dataproc/src/V1/KubernetesClusterConfig.php index 43f827c2d36..f8905bde866 100644 --- a/Dataproc/src/V1/KubernetesClusterConfig.php +++ b/Dataproc/src/V1/KubernetesClusterConfig.php @@ -16,16 +16,17 @@ class KubernetesClusterConfig extends \Google\Protobuf\Internal\Message { /** - * Optional. A namespace within the Kubernetes cluster to deploy into. If this namespace - * does not exist, it is created. If it exists, Dataproc - * verifies that another Dataproc VirtualCluster is not installed - * into it. If not specified, the name of the Dataproc Cluster is used. + * Optional. A namespace within the Kubernetes cluster to deploy into. If this + * namespace does not exist, it is created. If it exists, Dataproc verifies + * that another Dataproc VirtualCluster is not installed into it. If not + * specified, the name of the Dataproc Cluster is used. * * Generated from protobuf field string kubernetes_namespace = 1 [(.google.api.field_behavior) = OPTIONAL]; */ private $kubernetes_namespace = ''; /** - * Optional. The software configuration for this Dataproc cluster running on Kubernetes. + * Optional. The software configuration for this Dataproc cluster running on + * Kubernetes. * * Generated from protobuf field .google.cloud.dataproc.v1.KubernetesSoftwareConfig kubernetes_software_config = 3 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -39,14 +40,15 @@ class KubernetesClusterConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $kubernetes_namespace - * Optional. A namespace within the Kubernetes cluster to deploy into. If this namespace - * does not exist, it is created. If it exists, Dataproc - * verifies that another Dataproc VirtualCluster is not installed - * into it. If not specified, the name of the Dataproc Cluster is used. + * Optional. A namespace within the Kubernetes cluster to deploy into. If this + * namespace does not exist, it is created. If it exists, Dataproc verifies + * that another Dataproc VirtualCluster is not installed into it. If not + * specified, the name of the Dataproc Cluster is used. * @type \Google\Cloud\Dataproc\V1\GkeClusterConfig $gke_cluster_config * Required. The configuration for running the Dataproc cluster on GKE. * @type \Google\Cloud\Dataproc\V1\KubernetesSoftwareConfig $kubernetes_software_config - * Optional. The software configuration for this Dataproc cluster running on Kubernetes. + * Optional. The software configuration for this Dataproc cluster running on + * Kubernetes. * } */ public function __construct($data = NULL) { @@ -55,10 +57,10 @@ public function __construct($data = NULL) { } /** - * Optional. A namespace within the Kubernetes cluster to deploy into. If this namespace - * does not exist, it is created. If it exists, Dataproc - * verifies that another Dataproc VirtualCluster is not installed - * into it. If not specified, the name of the Dataproc Cluster is used. + * Optional. A namespace within the Kubernetes cluster to deploy into. If this + * namespace does not exist, it is created. If it exists, Dataproc verifies + * that another Dataproc VirtualCluster is not installed into it. If not + * specified, the name of the Dataproc Cluster is used. * * Generated from protobuf field string kubernetes_namespace = 1 [(.google.api.field_behavior) = OPTIONAL]; * @return string @@ -69,10 +71,10 @@ public function getKubernetesNamespace() } /** - * Optional. A namespace within the Kubernetes cluster to deploy into. If this namespace - * does not exist, it is created. If it exists, Dataproc - * verifies that another Dataproc VirtualCluster is not installed - * into it. If not specified, the name of the Dataproc Cluster is used. + * Optional. A namespace within the Kubernetes cluster to deploy into. If this + * namespace does not exist, it is created. If it exists, Dataproc verifies + * that another Dataproc VirtualCluster is not installed into it. If not + * specified, the name of the Dataproc Cluster is used. * * Generated from protobuf field string kubernetes_namespace = 1 [(.google.api.field_behavior) = OPTIONAL]; * @param string $var @@ -118,7 +120,8 @@ public function setGkeClusterConfig($var) } /** - * Optional. The software configuration for this Dataproc cluster running on Kubernetes. + * Optional. The software configuration for this Dataproc cluster running on + * Kubernetes. * * Generated from protobuf field .google.cloud.dataproc.v1.KubernetesSoftwareConfig kubernetes_software_config = 3 [(.google.api.field_behavior) = OPTIONAL]; * @return \Google\Cloud\Dataproc\V1\KubernetesSoftwareConfig|null @@ -139,7 +142,8 @@ public function clearKubernetesSoftwareConfig() } /** - * Optional. The software configuration for this Dataproc cluster running on Kubernetes. + * Optional. The software configuration for this Dataproc cluster running on + * Kubernetes. * * Generated from protobuf field .google.cloud.dataproc.v1.KubernetesSoftwareConfig kubernetes_software_config = 3 [(.google.api.field_behavior) = OPTIONAL]; * @param \Google\Cloud\Dataproc\V1\KubernetesSoftwareConfig $var diff --git a/Dataproc/src/V1/ListBatchesRequest.php b/Dataproc/src/V1/ListBatchesRequest.php index 2914353dfbe..98f8fdee4f4 100644 --- a/Dataproc/src/V1/ListBatchesRequest.php +++ b/Dataproc/src/V1/ListBatchesRequest.php @@ -36,6 +36,29 @@ class ListBatchesRequest extends \Google\Protobuf\Internal\Message * Generated from protobuf field string page_token = 3 [(.google.api.field_behavior) = OPTIONAL]; */ private $page_token = ''; + /** + * Optional. A filter for the batches to return in the response. + * A filter is a logical expression constraining the values of various fields + * in each batch resource. Filters are case sensitive, and may contain + * multiple clauses combined with logical operators (AND/OR). + * Supported fields are `batch_id`, `batch_uuid`, `state`, and `create_time`. + * e.g. `state = RUNNING and create_time < "2023-01-01T00:00:00Z"` + * filters for batches in state RUNNING that were created before 2023-01-01 + * See https://google.aip.dev/assets/misc/ebnf-filtering.txt for a detailed + * description of the filter syntax and a list of supported comparisons. + * + * Generated from protobuf field string filter = 4 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $filter = ''; + /** + * Optional. Field(s) on which to sort the list of batches. + * Currently the only supported sort orders are unspecified (empty) and + * `create_time desc` to sort by most recently created batches first. + * See https://google.aip.dev/132#ordering for more details. + * + * Generated from protobuf field string order_by = 5 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $order_by = ''; /** * Constructor. @@ -52,6 +75,21 @@ class ListBatchesRequest extends \Google\Protobuf\Internal\Message * @type string $page_token * Optional. A page token received from a previous `ListBatches` call. * Provide this token to retrieve the subsequent page. + * @type string $filter + * Optional. A filter for the batches to return in the response. + * A filter is a logical expression constraining the values of various fields + * in each batch resource. Filters are case sensitive, and may contain + * multiple clauses combined with logical operators (AND/OR). + * Supported fields are `batch_id`, `batch_uuid`, `state`, and `create_time`. + * e.g. `state = RUNNING and create_time < "2023-01-01T00:00:00Z"` + * filters for batches in state RUNNING that were created before 2023-01-01 + * See https://google.aip.dev/assets/misc/ebnf-filtering.txt for a detailed + * description of the filter syntax and a list of supported comparisons. + * @type string $order_by + * Optional. Field(s) on which to sort the list of batches. + * Currently the only supported sort orders are unspecified (empty) and + * `create_time desc` to sort by most recently created batches first. + * See https://google.aip.dev/132#ordering for more details. * } */ public function __construct($data = NULL) { @@ -143,5 +181,79 @@ public function setPageToken($var) return $this; } + /** + * Optional. A filter for the batches to return in the response. + * A filter is a logical expression constraining the values of various fields + * in each batch resource. Filters are case sensitive, and may contain + * multiple clauses combined with logical operators (AND/OR). + * Supported fields are `batch_id`, `batch_uuid`, `state`, and `create_time`. + * e.g. `state = RUNNING and create_time < "2023-01-01T00:00:00Z"` + * filters for batches in state RUNNING that were created before 2023-01-01 + * See https://google.aip.dev/assets/misc/ebnf-filtering.txt for a detailed + * description of the filter syntax and a list of supported comparisons. + * + * Generated from protobuf field string filter = 4 [(.google.api.field_behavior) = OPTIONAL]; + * @return string + */ + public function getFilter() + { + return $this->filter; + } + + /** + * Optional. A filter for the batches to return in the response. + * A filter is a logical expression constraining the values of various fields + * in each batch resource. Filters are case sensitive, and may contain + * multiple clauses combined with logical operators (AND/OR). + * Supported fields are `batch_id`, `batch_uuid`, `state`, and `create_time`. + * e.g. `state = RUNNING and create_time < "2023-01-01T00:00:00Z"` + * filters for batches in state RUNNING that were created before 2023-01-01 + * See https://google.aip.dev/assets/misc/ebnf-filtering.txt for a detailed + * description of the filter syntax and a list of supported comparisons. + * + * Generated from protobuf field string filter = 4 [(.google.api.field_behavior) = OPTIONAL]; + * @param string $var + * @return $this + */ + public function setFilter($var) + { + GPBUtil::checkString($var, True); + $this->filter = $var; + + return $this; + } + + /** + * Optional. Field(s) on which to sort the list of batches. + * Currently the only supported sort orders are unspecified (empty) and + * `create_time desc` to sort by most recently created batches first. + * See https://google.aip.dev/132#ordering for more details. + * + * Generated from protobuf field string order_by = 5 [(.google.api.field_behavior) = OPTIONAL]; + * @return string + */ + public function getOrderBy() + { + return $this->order_by; + } + + /** + * Optional. Field(s) on which to sort the list of batches. + * Currently the only supported sort orders are unspecified (empty) and + * `create_time desc` to sort by most recently created batches first. + * See https://google.aip.dev/132#ordering for more details. + * + * Generated from protobuf field string order_by = 5 [(.google.api.field_behavior) = OPTIONAL]; + * @param string $var + * @return $this + */ + public function setOrderBy($var) + { + GPBUtil::checkString($var, True); + $this->order_by = $var; + + return $this; + } + } diff --git a/Dataproc/src/V1/NodeGroupAffinity.php b/Dataproc/src/V1/NodeGroupAffinity.php index 4a3a6b82f62..a3ee8d779cf 100644 --- a/Dataproc/src/V1/NodeGroupAffinity.php +++ b/Dataproc/src/V1/NodeGroupAffinity.php @@ -23,8 +23,8 @@ class NodeGroupAffinity extends \Google\Protobuf\Internal\Message * resource](https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups) * that the cluster will be created on. * A full URL, partial URI, or node group name are valid. Examples: - * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1` - * * `projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]/nodeGroups/node-group-1` + * * `projects/[project_id]/zones/[zone]/nodeGroups/node-group-1` * * `node-group-1` * * Generated from protobuf field string node_group_uri = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -43,8 +43,8 @@ class NodeGroupAffinity extends \Google\Protobuf\Internal\Message * resource](https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups) * that the cluster will be created on. * A full URL, partial URI, or node group name are valid. Examples: - * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1` - * * `projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]/nodeGroups/node-group-1` + * * `projects/[project_id]/zones/[zone]/nodeGroups/node-group-1` * * `node-group-1` * } */ @@ -59,8 +59,8 @@ public function __construct($data = NULL) { * resource](https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups) * that the cluster will be created on. * A full URL, partial URI, or node group name are valid. Examples: - * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1` - * * `projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]/nodeGroups/node-group-1` + * * `projects/[project_id]/zones/[zone]/nodeGroups/node-group-1` * * `node-group-1` * * Generated from protobuf field string node_group_uri = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -77,8 +77,8 @@ public function getNodeGroupUri() * resource](https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups) * that the cluster will be created on. * A full URL, partial URI, or node group name are valid. Examples: - * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1` - * * `projects/[project_id]/zones/us-central1-a/nodeGroups/node-group-1` + * * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]/nodeGroups/node-group-1` + * * `projects/[project_id]/zones/[zone]/nodeGroups/node-group-1` * * `node-group-1` * * Generated from protobuf field string node_group_uri = 1 [(.google.api.field_behavior) = REQUIRED]; diff --git a/Dataproc/src/V1/OrderedJob.php b/Dataproc/src/V1/OrderedJob.php index 28c727be466..c4fe2fb2996 100644 --- a/Dataproc/src/V1/OrderedJob.php +++ b/Dataproc/src/V1/OrderedJob.php @@ -20,8 +20,8 @@ class OrderedJob extends \Google\Protobuf\Internal\Message * within the template. * The step id is used as prefix for job id, as job * `goog-dataproc-workflow-step-id` label, and in - * [prerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids] field from other - * steps. + * [prerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids] + * field from other steps. * The id must contain only letters (a-z, A-Z), numbers (0-9), * underscores (_), and hyphens (-). Cannot begin or end with underscore * or hyphen. Must consist of between 3 and 50 characters. @@ -67,8 +67,8 @@ class OrderedJob extends \Google\Protobuf\Internal\Message * within the template. * The step id is used as prefix for job id, as job * `goog-dataproc-workflow-step-id` label, and in - * [prerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids] field from other - * steps. + * [prerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids] + * field from other steps. * The id must contain only letters (a-z, A-Z), numbers (0-9), * underscores (_), and hyphens (-). Cannot begin or end with underscore * or hyphen. Must consist of between 3 and 50 characters. @@ -113,8 +113,8 @@ public function __construct($data = NULL) { * within the template. * The step id is used as prefix for job id, as job * `goog-dataproc-workflow-step-id` label, and in - * [prerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids] field from other - * steps. + * [prerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids] + * field from other steps. * The id must contain only letters (a-z, A-Z), numbers (0-9), * underscores (_), and hyphens (-). Cannot begin or end with underscore * or hyphen. Must consist of between 3 and 50 characters. @@ -132,8 +132,8 @@ public function getStepId() * within the template. * The step id is used as prefix for job id, as job * `goog-dataproc-workflow-step-id` label, and in - * [prerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids] field from other - * steps. + * [prerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids] + * field from other steps. * The id must contain only letters (a-z, A-Z), numbers (0-9), * underscores (_), and hyphens (-). Cannot begin or end with underscore * or hyphen. Must consist of between 3 and 50 characters. diff --git a/Dataproc/src/V1/PeripheralsConfig.php b/Dataproc/src/V1/PeripheralsConfig.php index f4fd0b06434..e1f8f014826 100644 --- a/Dataproc/src/V1/PeripheralsConfig.php +++ b/Dataproc/src/V1/PeripheralsConfig.php @@ -20,7 +20,7 @@ class PeripheralsConfig extends \Google\Protobuf\Internal\Message * Example: * * `projects/[project_id]/locations/[region]/services/[service_id]` * - * Generated from protobuf field string metastore_service = 1 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field string metastore_service = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { */ private $metastore_service = ''; /** @@ -54,7 +54,7 @@ public function __construct($data = NULL) { * Example: * * `projects/[project_id]/locations/[region]/services/[service_id]` * - * Generated from protobuf field string metastore_service = 1 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field string metastore_service = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @return string */ public function getMetastoreService() @@ -67,7 +67,7 @@ public function getMetastoreService() * Example: * * `projects/[project_id]/locations/[region]/services/[service_id]` * - * Generated from protobuf field string metastore_service = 1 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field string metastore_service = 1 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @param string $var * @return $this */ diff --git a/Dataproc/src/V1/PySparkBatch.php b/Dataproc/src/V1/PySparkBatch.php index d7b86adb174..f2272e20e03 100644 --- a/Dataproc/src/V1/PySparkBatch.php +++ b/Dataproc/src/V1/PySparkBatch.php @@ -19,8 +19,8 @@ class PySparkBatch extends \Google\Protobuf\Internal\Message { /** - * Required. The HCFS URI of the main Python file to use as the Spark driver. Must - * be a .py file. + * Required. The HCFS URI of the main Python file to use as the Spark driver. + * Must be a .py file. * * Generated from protobuf field string main_python_file_uri = 1 [(.google.api.field_behavior) = REQUIRED]; */ @@ -70,8 +70,8 @@ class PySparkBatch extends \Google\Protobuf\Internal\Message * 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 Spark driver. Must - * be a .py file. + * Required. The HCFS URI of the main Python file to use as the Spark driver. + * Must be a .py file. * @type array|\Google\Protobuf\Internal\RepeatedField $args * Optional. The arguments to pass to the driver. Do not include arguments * that can be set as batch properties, such as `--conf`, since a collision @@ -97,8 +97,8 @@ public function __construct($data = NULL) { } /** - * Required. The HCFS URI of the main Python file to use as the Spark driver. Must - * be a .py file. + * Required. The HCFS URI of the main Python file to use as the Spark driver. + * Must be a .py file. * * Generated from protobuf field string main_python_file_uri = 1 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -109,8 +109,8 @@ public function getMainPythonFileUri() } /** - * Required. The HCFS URI of the main Python file to use as the Spark driver. Must - * be a .py file. + * Required. The HCFS URI of the main Python file to use as the Spark driver. + * Must be a .py file. * * Generated from protobuf field string main_python_file_uri = 1 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Dataproc/src/V1/ResizeNodeGroupRequest.php b/Dataproc/src/V1/ResizeNodeGroupRequest.php index e5dfd6e4d2e..f0cdd6752e5 100644 --- a/Dataproc/src/V1/ResizeNodeGroupRequest.php +++ b/Dataproc/src/V1/ResizeNodeGroupRequest.php @@ -47,7 +47,7 @@ class ResizeNodeGroupRequest extends \Google\Protobuf\Internal\Message */ private $request_id = ''; /** - * Optional. Timeout for graceful YARN decommissioning. [Graceful + * Optional. Timeout for graceful YARN decomissioning. [Graceful * decommissioning] * (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/scaling-clusters#graceful_decommissioning) * allows the removal of nodes from the Compute Engine node group @@ -89,7 +89,7 @@ class ResizeNodeGroupRequest extends \Google\Protobuf\Internal\Message * The ID must contain only letters (a-z, A-Z), numbers (0-9), * underscores (_), and hyphens (-). The maximum length is 40 characters. * @type \Google\Protobuf\Duration $graceful_decommission_timeout - * Optional. Timeout for graceful YARN decommissioning. [Graceful + * Optional. Timeout for graceful YARN decomissioning. [Graceful * decommissioning] * (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/scaling-clusters#graceful_decommissioning) * allows the removal of nodes from the Compute Engine node group @@ -212,7 +212,7 @@ public function setRequestId($var) } /** - * Optional. Timeout for graceful YARN decommissioning. [Graceful + * Optional. Timeout for graceful YARN decomissioning. [Graceful * decommissioning] * (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/scaling-clusters#graceful_decommissioning) * allows the removal of nodes from the Compute Engine node group @@ -243,7 +243,7 @@ public function clearGracefulDecommissionTimeout() } /** - * Optional. Timeout for graceful YARN decommissioning. [Graceful + * Optional. Timeout for graceful YARN decomissioning. [Graceful * decommissioning] * (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/scaling-clusters#graceful_decommissioning) * allows the removal of nodes from the Compute Engine node group diff --git a/Dataproc/src/V1/RuntimeConfig.php b/Dataproc/src/V1/RuntimeConfig.php index 28b34e5ad66..73adc05de97 100644 --- a/Dataproc/src/V1/RuntimeConfig.php +++ b/Dataproc/src/V1/RuntimeConfig.php @@ -22,15 +22,15 @@ class RuntimeConfig extends \Google\Protobuf\Internal\Message */ private $version = ''; /** - * Optional. Optional custom container image for the job runtime environment. If - * not specified, a default container image will be used. + * Optional. Optional custom container image for the job runtime environment. + * If not specified, a default container image will be used. * * Generated from protobuf field string container_image = 2 [(.google.api.field_behavior) = OPTIONAL]; */ private $container_image = ''; /** - * Optional. A mapping of property names to values, which are used to configure workload - * execution. + * Optional. A mapping of property names to values, which are used to + * configure workload execution. * * Generated from protobuf field map properties = 3 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -45,11 +45,11 @@ class RuntimeConfig extends \Google\Protobuf\Internal\Message * @type string $version * Optional. Version of the batch runtime. * @type string $container_image - * Optional. Optional custom container image for the job runtime environment. If - * not specified, a default container image will be used. + * Optional. Optional custom container image for the job runtime environment. + * If not specified, a default container image will be used. * @type array|\Google\Protobuf\Internal\MapField $properties - * Optional. A mapping of property names to values, which are used to configure workload - * execution. + * Optional. A mapping of property names to values, which are used to + * configure workload execution. * } */ public function __construct($data = NULL) { @@ -84,8 +84,8 @@ public function setVersion($var) } /** - * Optional. Optional custom container image for the job runtime environment. If - * not specified, a default container image will be used. + * Optional. Optional custom container image for the job runtime environment. + * If not specified, a default container image will be used. * * Generated from protobuf field string container_image = 2 [(.google.api.field_behavior) = OPTIONAL]; * @return string @@ -96,8 +96,8 @@ public function getContainerImage() } /** - * Optional. Optional custom container image for the job runtime environment. If - * not specified, a default container image will be used. + * Optional. Optional custom container image for the job runtime environment. + * If not specified, a default container image will be used. * * Generated from protobuf field string container_image = 2 [(.google.api.field_behavior) = OPTIONAL]; * @param string $var @@ -112,8 +112,8 @@ public function setContainerImage($var) } /** - * Optional. A mapping of property names to values, which are used to configure workload - * execution. + * Optional. A mapping of property names to values, which are used to + * configure workload execution. * * Generated from protobuf field map properties = 3 [(.google.api.field_behavior) = OPTIONAL]; * @return \Google\Protobuf\Internal\MapField @@ -124,8 +124,8 @@ public function getProperties() } /** - * Optional. A mapping of property names to values, which are used to configure workload - * execution. + * Optional. A mapping of property names to values, which are used to + * configure workload execution. * * Generated from protobuf field map properties = 3 [(.google.api.field_behavior) = OPTIONAL]; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/Dataproc/src/V1/RuntimeInfo.php b/Dataproc/src/V1/RuntimeInfo.php index 5f1b4282bd1..298248837ef 100644 --- a/Dataproc/src/V1/RuntimeInfo.php +++ b/Dataproc/src/V1/RuntimeInfo.php @@ -16,14 +16,15 @@ class RuntimeInfo extends \Google\Protobuf\Internal\Message { /** - * Output only. Map of remote access endpoints (such as web interfaces and APIs) to their - * URIs. + * Output only. Map of remote access endpoints (such as web interfaces and + * APIs) to their URIs. * * Generated from protobuf field map endpoints = 1 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ private $endpoints; /** - * Output only. A URI pointing to the location of the stdout and stderr of the workload. + * Output only. A URI pointing to the location of the stdout and stderr of the + * workload. * * Generated from protobuf field string output_uri = 2 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ @@ -34,6 +35,20 @@ class RuntimeInfo extends \Google\Protobuf\Internal\Message * Generated from protobuf field string diagnostic_output_uri = 3 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ private $diagnostic_output_uri = ''; + /** + * Output only. Approximate workload resource usage calculated after workload + * finishes (see [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * + * Generated from protobuf field .google.cloud.dataproc.v1.UsageMetrics approximate_usage = 6 [(.google.api.field_behavior) = OUTPUT_ONLY]; + */ + private $approximate_usage = null; + /** + * Output only. Snapshot of current workload resource usage. + * + * Generated from protobuf field .google.cloud.dataproc.v1.UsageSnapshot current_usage = 7 [(.google.api.field_behavior) = OUTPUT_ONLY]; + */ + private $current_usage = null; /** * Constructor. @@ -42,12 +57,19 @@ class RuntimeInfo extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array|\Google\Protobuf\Internal\MapField $endpoints - * Output only. Map of remote access endpoints (such as web interfaces and APIs) to their - * URIs. + * Output only. Map of remote access endpoints (such as web interfaces and + * APIs) to their URIs. * @type string $output_uri - * Output only. A URI pointing to the location of the stdout and stderr of the workload. + * Output only. A URI pointing to the location of the stdout and stderr of the + * workload. * @type string $diagnostic_output_uri * Output only. A URI pointing to the location of the diagnostics tarball. + * @type \Google\Cloud\Dataproc\V1\UsageMetrics $approximate_usage + * Output only. Approximate workload resource usage calculated after workload + * finishes (see [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * @type \Google\Cloud\Dataproc\V1\UsageSnapshot $current_usage + * Output only. Snapshot of current workload resource usage. * } */ public function __construct($data = NULL) { @@ -56,8 +78,8 @@ public function __construct($data = NULL) { } /** - * Output only. Map of remote access endpoints (such as web interfaces and APIs) to their - * URIs. + * Output only. Map of remote access endpoints (such as web interfaces and + * APIs) to their URIs. * * Generated from protobuf field map endpoints = 1 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @return \Google\Protobuf\Internal\MapField @@ -68,8 +90,8 @@ public function getEndpoints() } /** - * Output only. Map of remote access endpoints (such as web interfaces and APIs) to their - * URIs. + * Output only. Map of remote access endpoints (such as web interfaces and + * APIs) to their URIs. * * Generated from protobuf field map endpoints = 1 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @param array|\Google\Protobuf\Internal\MapField $var @@ -84,7 +106,8 @@ public function setEndpoints($var) } /** - * Output only. A URI pointing to the location of the stdout and stderr of the workload. + * Output only. A URI pointing to the location of the stdout and stderr of the + * workload. * * Generated from protobuf field string output_uri = 2 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @return string @@ -95,7 +118,8 @@ public function getOutputUri() } /** - * Output only. A URI pointing to the location of the stdout and stderr of the workload. + * Output only. A URI pointing to the location of the stdout and stderr of the + * workload. * * Generated from protobuf field string output_uri = 2 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @param string $var @@ -135,5 +159,81 @@ public function setDiagnosticOutputUri($var) return $this; } + /** + * Output only. Approximate workload resource usage calculated after workload + * finishes (see [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * + * Generated from protobuf field .google.cloud.dataproc.v1.UsageMetrics approximate_usage = 6 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * @return \Google\Cloud\Dataproc\V1\UsageMetrics|null + */ + public function getApproximateUsage() + { + return $this->approximate_usage; + } + + public function hasApproximateUsage() + { + return isset($this->approximate_usage); + } + + public function clearApproximateUsage() + { + unset($this->approximate_usage); + } + + /** + * Output only. Approximate workload resource usage calculated after workload + * finishes (see [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * + * Generated from protobuf field .google.cloud.dataproc.v1.UsageMetrics approximate_usage = 6 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * @param \Google\Cloud\Dataproc\V1\UsageMetrics $var + * @return $this + */ + public function setApproximateUsage($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Dataproc\V1\UsageMetrics::class); + $this->approximate_usage = $var; + + return $this; + } + + /** + * Output only. Snapshot of current workload resource usage. + * + * Generated from protobuf field .google.cloud.dataproc.v1.UsageSnapshot current_usage = 7 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * @return \Google\Cloud\Dataproc\V1\UsageSnapshot|null + */ + public function getCurrentUsage() + { + return $this->current_usage; + } + + public function hasCurrentUsage() + { + return isset($this->current_usage); + } + + public function clearCurrentUsage() + { + unset($this->current_usage); + } + + /** + * Output only. Snapshot of current workload resource usage. + * + * Generated from protobuf field .google.cloud.dataproc.v1.UsageSnapshot current_usage = 7 [(.google.api.field_behavior) = OUTPUT_ONLY]; + * @param \Google\Cloud\Dataproc\V1\UsageSnapshot $var + * @return $this + */ + public function setCurrentUsage($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Dataproc\V1\UsageSnapshot::class); + $this->current_usage = $var; + + return $this; + } + } diff --git a/Dataproc/src/V1/ShieldedInstanceConfig.php b/Dataproc/src/V1/ShieldedInstanceConfig.php index a7192730201..8da9b29aa00 100644 --- a/Dataproc/src/V1/ShieldedInstanceConfig.php +++ b/Dataproc/src/V1/ShieldedInstanceConfig.php @@ -19,21 +19,21 @@ class ShieldedInstanceConfig extends \Google\Protobuf\Internal\Message /** * Optional. Defines whether instances have Secure Boot enabled. * - * Generated from protobuf field bool enable_secure_boot = 1 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field optional bool enable_secure_boot = 1 [(.google.api.field_behavior) = OPTIONAL]; */ - private $enable_secure_boot = false; + private $enable_secure_boot = null; /** * Optional. Defines whether instances have the vTPM enabled. * - * Generated from protobuf field bool enable_vtpm = 2 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field optional bool enable_vtpm = 2 [(.google.api.field_behavior) = OPTIONAL]; */ - private $enable_vtpm = false; + private $enable_vtpm = null; /** * Optional. Defines whether instances have integrity monitoring enabled. * - * Generated from protobuf field bool enable_integrity_monitoring = 3 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field optional bool enable_integrity_monitoring = 3 [(.google.api.field_behavior) = OPTIONAL]; */ - private $enable_integrity_monitoring = false; + private $enable_integrity_monitoring = null; /** * Constructor. @@ -57,18 +57,28 @@ public function __construct($data = NULL) { /** * Optional. Defines whether instances have Secure Boot enabled. * - * Generated from protobuf field bool enable_secure_boot = 1 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field optional bool enable_secure_boot = 1 [(.google.api.field_behavior) = OPTIONAL]; * @return bool */ public function getEnableSecureBoot() { - return $this->enable_secure_boot; + return isset($this->enable_secure_boot) ? $this->enable_secure_boot : false; + } + + public function hasEnableSecureBoot() + { + return isset($this->enable_secure_boot); + } + + public function clearEnableSecureBoot() + { + unset($this->enable_secure_boot); } /** * Optional. Defines whether instances have Secure Boot enabled. * - * Generated from protobuf field bool enable_secure_boot = 1 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field optional bool enable_secure_boot = 1 [(.google.api.field_behavior) = OPTIONAL]; * @param bool $var * @return $this */ @@ -83,18 +93,28 @@ public function setEnableSecureBoot($var) /** * Optional. Defines whether instances have the vTPM enabled. * - * Generated from protobuf field bool enable_vtpm = 2 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field optional bool enable_vtpm = 2 [(.google.api.field_behavior) = OPTIONAL]; * @return bool */ public function getEnableVtpm() { - return $this->enable_vtpm; + return isset($this->enable_vtpm) ? $this->enable_vtpm : false; + } + + public function hasEnableVtpm() + { + return isset($this->enable_vtpm); + } + + public function clearEnableVtpm() + { + unset($this->enable_vtpm); } /** * Optional. Defines whether instances have the vTPM enabled. * - * Generated from protobuf field bool enable_vtpm = 2 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field optional bool enable_vtpm = 2 [(.google.api.field_behavior) = OPTIONAL]; * @param bool $var * @return $this */ @@ -109,18 +129,28 @@ public function setEnableVtpm($var) /** * Optional. Defines whether instances have integrity monitoring enabled. * - * Generated from protobuf field bool enable_integrity_monitoring = 3 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field optional bool enable_integrity_monitoring = 3 [(.google.api.field_behavior) = OPTIONAL]; * @return bool */ public function getEnableIntegrityMonitoring() { - return $this->enable_integrity_monitoring; + return isset($this->enable_integrity_monitoring) ? $this->enable_integrity_monitoring : false; + } + + public function hasEnableIntegrityMonitoring() + { + return isset($this->enable_integrity_monitoring); + } + + public function clearEnableIntegrityMonitoring() + { + unset($this->enable_integrity_monitoring); } /** * Optional. Defines whether instances have integrity monitoring enabled. * - * Generated from protobuf field bool enable_integrity_monitoring = 3 [(.google.api.field_behavior) = OPTIONAL]; + * Generated from protobuf field optional bool enable_integrity_monitoring = 3 [(.google.api.field_behavior) = OPTIONAL]; * @param bool $var * @return $this */ diff --git a/Dataproc/src/V1/SparkBatch.php b/Dataproc/src/V1/SparkBatch.php index f24fc05aa2d..e39b43d191b 100644 --- a/Dataproc/src/V1/SparkBatch.php +++ b/Dataproc/src/V1/SparkBatch.php @@ -9,7 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * A configuration for running an [Apache Spark](http://spark.apache.org/) + * A configuration for running an [Apache Spark](https://spark.apache.org/) * batch workload. * * Generated from protobuf message google.cloud.dataproc.v1.SparkBatch @@ -57,8 +57,8 @@ class SparkBatch extends \Google\Protobuf\Internal\Message * @type string $main_jar_file_uri * Optional. The HCFS URI of the jar file that contains the main class. * @type string $main_class - * Optional. The name of the driver main class. The jar file that contains the class - * must be in the classpath or specified in `jar_file_uris`. + * Optional. The name of the driver main class. The jar file that contains + * the class must be in the classpath or specified in `jar_file_uris`. * @type array|\Google\Protobuf\Internal\RepeatedField $args * Optional. The arguments to pass to the driver. Do not include arguments * that can be set as batch properties, such as `--conf`, since a collision @@ -112,8 +112,8 @@ public function setMainJarFileUri($var) } /** - * Optional. The name of the driver main class. The jar file that contains the class - * must be in the classpath or specified in `jar_file_uris`. + * Optional. The name of the driver main class. The jar file that contains + * the class must be in the classpath or specified in `jar_file_uris`. * * Generated from protobuf field string main_class = 2 [(.google.api.field_behavior) = OPTIONAL]; * @return string @@ -129,8 +129,8 @@ public function hasMainClass() } /** - * Optional. The name of the driver main class. The jar file that contains the class - * must be in the classpath or specified in `jar_file_uris`. + * Optional. The name of the driver main class. The jar file that contains + * the class must be in the classpath or specified in `jar_file_uris`. * * Generated from protobuf field string main_class = 2 [(.google.api.field_behavior) = OPTIONAL]; * @param string $var diff --git a/Dataproc/src/V1/SparkHistoryServerConfig.php b/Dataproc/src/V1/SparkHistoryServerConfig.php index d8dc331abd2..7fdc588ea21 100644 --- a/Dataproc/src/V1/SparkHistoryServerConfig.php +++ b/Dataproc/src/V1/SparkHistoryServerConfig.php @@ -16,8 +16,8 @@ class SparkHistoryServerConfig extends \Google\Protobuf\Internal\Message { /** - * Optional. Resource name of an existing Dataproc Cluster to act as a Spark History - * Server for the workload. + * Optional. Resource name of an existing Dataproc Cluster to act as a Spark + * History Server for the workload. * Example: * * `projects/[project_id]/regions/[region]/clusters/[cluster_name]` * @@ -32,8 +32,8 @@ class SparkHistoryServerConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $dataproc_cluster - * Optional. Resource name of an existing Dataproc Cluster to act as a Spark History - * Server for the workload. + * Optional. Resource name of an existing Dataproc Cluster to act as a Spark + * History Server for the workload. * Example: * * `projects/[project_id]/regions/[region]/clusters/[cluster_name]` * } @@ -44,8 +44,8 @@ public function __construct($data = NULL) { } /** - * Optional. Resource name of an existing Dataproc Cluster to act as a Spark History - * Server for the workload. + * Optional. Resource name of an existing Dataproc Cluster to act as a Spark + * History Server for the workload. * Example: * * `projects/[project_id]/regions/[region]/clusters/[cluster_name]` * @@ -58,8 +58,8 @@ public function getDataprocCluster() } /** - * Optional. Resource name of an existing Dataproc Cluster to act as a Spark History - * Server for the workload. + * Optional. Resource name of an existing Dataproc Cluster to act as a Spark + * History Server for the workload. * Example: * * `projects/[project_id]/regions/[region]/clusters/[cluster_name]` * diff --git a/Dataproc/src/V1/SparkRBatch.php b/Dataproc/src/V1/SparkRBatch.php index 968bcff901f..e90922e63e9 100644 --- a/Dataproc/src/V1/SparkRBatch.php +++ b/Dataproc/src/V1/SparkRBatch.php @@ -25,9 +25,9 @@ class SparkRBatch extends \Google\Protobuf\Internal\Message */ private $main_r_file_uri = ''; /** - * Optional. The arguments to pass to the Spark driver. Do not include arguments - * that can be set as batch properties, such as `--conf`, since a collision - * can occur that causes an incorrect batch submission. + * Optional. The arguments to pass to the Spark driver. Do not include + * arguments that can be set as batch properties, such as `--conf`, since a + * collision can occur that causes an incorrect batch submission. * * Generated from protobuf field repeated string args = 2 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -58,9 +58,9 @@ class SparkRBatch extends \Google\Protobuf\Internal\Message * Required. The HCFS URI of the main R file to use as the driver. * Must be a `.R` or `.r` file. * @type array|\Google\Protobuf\Internal\RepeatedField $args - * Optional. The arguments to pass to the Spark driver. Do not include arguments - * that can be set as batch properties, such as `--conf`, since a collision - * can occur that causes an incorrect batch submission. + * Optional. The arguments to pass to the Spark driver. Do not include + * arguments that can be set as batch properties, such as `--conf`, since a + * collision can occur that causes an incorrect batch submission. * @type array|\Google\Protobuf\Internal\RepeatedField $file_uris * Optional. HCFS URIs of files to be placed in the working directory of * each executor. @@ -104,9 +104,9 @@ public function setMainRFileUri($var) } /** - * Optional. The arguments to pass to the Spark driver. Do not include arguments - * that can be set as batch properties, such as `--conf`, since a collision - * can occur that causes an incorrect batch submission. + * Optional. The arguments to pass to the Spark driver. Do not include + * arguments that can be set as batch properties, such as `--conf`, since a + * collision can occur that causes an incorrect batch submission. * * Generated from protobuf field repeated string args = 2 [(.google.api.field_behavior) = OPTIONAL]; * @return \Google\Protobuf\Internal\RepeatedField @@ -117,9 +117,9 @@ public function getArgs() } /** - * Optional. The arguments to pass to the Spark driver. Do not include arguments - * that can be set as batch properties, such as `--conf`, since a collision - * can occur that causes an incorrect batch submission. + * Optional. The arguments to pass to the Spark driver. Do not include + * arguments that can be set as batch properties, such as `--conf`, since a + * collision can occur that causes an incorrect batch submission. * * Generated from protobuf field repeated string args = 2 [(.google.api.field_behavior) = OPTIONAL]; * @param array|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Dataproc/src/V1/SparkSqlBatch.php b/Dataproc/src/V1/SparkSqlBatch.php index 70f0def06a3..4a21c12bb17 100644 --- a/Dataproc/src/V1/SparkSqlBatch.php +++ b/Dataproc/src/V1/SparkSqlBatch.php @@ -10,14 +10,16 @@ /** * A configuration for running - * [Apache Spark SQL](http://spark.apache.org/sql/) queries as a batch workload. + * [Apache Spark SQL](https://spark.apache.org/sql/) queries as a batch + * workload. * * Generated from protobuf message google.cloud.dataproc.v1.SparkSqlBatch */ class SparkSqlBatch extends \Google\Protobuf\Internal\Message { /** - * Required. The HCFS URI of the script that contains Spark SQL queries to execute. + * Required. The HCFS URI of the script that contains Spark SQL queries to + * execute. * * Generated from protobuf field string query_file_uri = 1 [(.google.api.field_behavior) = REQUIRED]; */ @@ -43,7 +45,8 @@ class SparkSqlBatch extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $query_file_uri - * Required. The HCFS URI of the script that contains Spark SQL queries to execute. + * Required. The HCFS URI of the script that contains Spark SQL queries to + * execute. * @type array|\Google\Protobuf\Internal\MapField $query_variables * Optional. Mapping of query variable names to values (equivalent to the * Spark SQL command: `SET name="value";`). @@ -57,7 +60,8 @@ public function __construct($data = NULL) { } /** - * Required. The HCFS URI of the script that contains Spark SQL queries to execute. + * Required. The HCFS URI of the script that contains Spark SQL queries to + * execute. * * Generated from protobuf field string query_file_uri = 1 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -68,7 +72,8 @@ public function getQueryFileUri() } /** - * Required. The HCFS URI of the script that contains Spark SQL queries to execute. + * Required. The HCFS URI of the script that contains Spark SQL queries to + * execute. * * Generated from protobuf field string query_file_uri = 1 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Dataproc/src/V1/TemplateParameter.php b/Dataproc/src/V1/TemplateParameter.php index 7a08fa91995..7b6a8ca0fd9 100644 --- a/Dataproc/src/V1/TemplateParameter.php +++ b/Dataproc/src/V1/TemplateParameter.php @@ -39,10 +39,10 @@ class TemplateParameter extends \Google\Protobuf\Internal\Message * Required. Paths to all fields that the parameter replaces. * A field is allowed to appear in at most one parameter's list of field * paths. - * A field path is similar in syntax to a [google.protobuf.FieldMask][google.protobuf.FieldMask]. - * For example, a field path that references the zone field of a workflow - * template's cluster selector would be specified as - * `placement.clusterSelector.zone`. + * A field path is similar in syntax to a + * [google.protobuf.FieldMask][google.protobuf.FieldMask]. For example, a + * field path that references the zone field of a workflow template's cluster + * selector would be specified as `placement.clusterSelector.zone`. * Also, field paths can reference fields using the following syntax: * * Values in maps can be referenced by key: * * labels['key'] @@ -108,10 +108,10 @@ class TemplateParameter extends \Google\Protobuf\Internal\Message * Required. Paths to all fields that the parameter replaces. * A field is allowed to appear in at most one parameter's list of field * paths. - * A field path is similar in syntax to a [google.protobuf.FieldMask][google.protobuf.FieldMask]. - * For example, a field path that references the zone field of a workflow - * template's cluster selector would be specified as - * `placement.clusterSelector.zone`. + * A field path is similar in syntax to a + * [google.protobuf.FieldMask][google.protobuf.FieldMask]. For example, a + * field path that references the zone field of a workflow template's cluster + * selector would be specified as `placement.clusterSelector.zone`. * Also, field paths can reference fields using the following syntax: * * Values in maps can be referenced by key: * * labels['key'] @@ -195,10 +195,10 @@ public function setName($var) * Required. Paths to all fields that the parameter replaces. * A field is allowed to appear in at most one parameter's list of field * paths. - * A field path is similar in syntax to a [google.protobuf.FieldMask][google.protobuf.FieldMask]. - * For example, a field path that references the zone field of a workflow - * template's cluster selector would be specified as - * `placement.clusterSelector.zone`. + * A field path is similar in syntax to a + * [google.protobuf.FieldMask][google.protobuf.FieldMask]. For example, a + * field path that references the zone field of a workflow template's cluster + * selector would be specified as `placement.clusterSelector.zone`. * Also, field paths can reference fields using the following syntax: * * Values in maps can be referenced by key: * * labels['key'] @@ -241,10 +241,10 @@ public function getFields() * Required. Paths to all fields that the parameter replaces. * A field is allowed to appear in at most one parameter's list of field * paths. - * A field path is similar in syntax to a [google.protobuf.FieldMask][google.protobuf.FieldMask]. - * For example, a field path that references the zone field of a workflow - * template's cluster selector would be specified as - * `placement.clusterSelector.zone`. + * A field path is similar in syntax to a + * [google.protobuf.FieldMask][google.protobuf.FieldMask]. For example, a + * field path that references the zone field of a workflow template's cluster + * selector would be specified as `placement.clusterSelector.zone`. * Also, field paths can reference fields using the following syntax: * * Values in maps can be referenced by key: * * labels['key'] diff --git a/Dataproc/src/V1/TrinoJob.php b/Dataproc/src/V1/TrinoJob.php new file mode 100644 index 00000000000..8c87a41bfd2 --- /dev/null +++ b/Dataproc/src/V1/TrinoJob.php @@ -0,0 +1,312 @@ +google.cloud.dataproc.v1.TrinoJob + */ +class TrinoJob extends \Google\Protobuf\Internal\Message +{ + /** + * 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. + * + * Generated from protobuf field bool continue_on_failure = 3 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $continue_on_failure = false; + /** + * Optional. The format in which query output will be displayed. See the + * Trino documentation for supported output formats + * + * Generated from protobuf field string output_format = 4 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $output_format = ''; + /** + * Optional. Trino client tags to attach to this query + * + * Generated from protobuf field repeated string client_tags = 5 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $client_tags; + /** + * Optional. A mapping of property names to values. Used to set Trino + * [session properties](https://trino.io/docs/current/sql/set-session.html) + * Equivalent to using the --session flag in the Trino CLI + * + * Generated from protobuf field map properties = 6 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $properties; + /** + * Optional. The runtime log config for job execution. + * + * Generated from protobuf field .google.cloud.dataproc.v1.LoggingConfig logging_config = 7 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $logging_config = null; + protected $queries; + + /** + * 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 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 string $output_format + * Optional. The format in which query output will be displayed. See the + * Trino documentation for supported output formats + * @type array|\Google\Protobuf\Internal\RepeatedField $client_tags + * Optional. Trino client tags to attach to this query + * @type array|\Google\Protobuf\Internal\MapField $properties + * Optional. A mapping of property names to values. Used to set Trino + * [session properties](https://trino.io/docs/current/sql/set-session.html) + * Equivalent to using the --session flag in the Trino CLI + * @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($data); + } + + /** + * The HCFS URI of the script that contains SQL queries. + * + * Generated from protobuf field string query_file_uri = 1; + * @return string + */ + public function getQueryFileUri() + { + return $this->readOneof(1); + } + + public function hasQueryFileUri() + { + return $this->hasOneof(1); + } + + /** + * The HCFS URI of the script that contains SQL queries. + * + * Generated from protobuf field string query_file_uri = 1; + * @param string $var + * @return $this + */ + public function setQueryFileUri($var) + { + GPBUtil::checkString($var, True); + $this->writeOneof(1, $var); + + return $this; + } + + /** + * A list of queries. + * + * Generated from protobuf field .google.cloud.dataproc.v1.QueryList query_list = 2; + * @return \Google\Cloud\Dataproc\V1\QueryList|null + */ + public function getQueryList() + { + return $this->readOneof(2); + } + + public function hasQueryList() + { + return $this->hasOneof(2); + } + + /** + * A list of queries. + * + * Generated from protobuf field .google.cloud.dataproc.v1.QueryList query_list = 2; + * @param \Google\Cloud\Dataproc\V1\QueryList $var + * @return $this + */ + public function setQueryList($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Dataproc\V1\QueryList::class); + $this->writeOneof(2, $var); + + return $this; + } + + /** + * 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. + * + * Generated from protobuf field bool continue_on_failure = 3 [(.google.api.field_behavior) = OPTIONAL]; + * @return bool + */ + public function getContinueOnFailure() + { + return $this->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. + * + * Generated from protobuf field bool continue_on_failure = 3 [(.google.api.field_behavior) = OPTIONAL]; + * @param bool $var + * @return $this + */ + public function setContinueOnFailure($var) + { + GPBUtil::checkBool($var); + $this->continue_on_failure = $var; + + return $this; + } + + /** + * Optional. The format in which query output will be displayed. See the + * Trino documentation for supported output formats + * + * Generated from protobuf field string output_format = 4 [(.google.api.field_behavior) = OPTIONAL]; + * @return string + */ + public function getOutputFormat() + { + return $this->output_format; + } + + /** + * Optional. The format in which query output will be displayed. See the + * Trino documentation for supported output formats + * + * Generated from protobuf field string output_format = 4 [(.google.api.field_behavior) = OPTIONAL]; + * @param string $var + * @return $this + */ + public function setOutputFormat($var) + { + GPBUtil::checkString($var, True); + $this->output_format = $var; + + return $this; + } + + /** + * Optional. Trino client tags to attach to this query + * + * Generated from protobuf field repeated string client_tags = 5 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Protobuf\Internal\RepeatedField + */ + public function getClientTags() + { + return $this->client_tags; + } + + /** + * Optional. Trino client tags to attach to this query + * + * Generated from protobuf field repeated string client_tags = 5 [(.google.api.field_behavior) = OPTIONAL]; + * @param array|\Google\Protobuf\Internal\RepeatedField $var + * @return $this + */ + public function setClientTags($var) + { + $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::STRING); + $this->client_tags = $arr; + + return $this; + } + + /** + * Optional. A mapping of property names to values. Used to set Trino + * [session properties](https://trino.io/docs/current/sql/set-session.html) + * Equivalent to using the --session flag in the Trino CLI + * + * Generated from protobuf field map properties = 6 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Protobuf\Internal\MapField + */ + public function getProperties() + { + return $this->properties; + } + + /** + * Optional. A mapping of property names to values. Used to set Trino + * [session properties](https://trino.io/docs/current/sql/set-session.html) + * Equivalent to using the --session flag in the Trino CLI + * + * Generated from protobuf field map properties = 6 [(.google.api.field_behavior) = OPTIONAL]; + * @param array|\Google\Protobuf\Internal\MapField $var + * @return $this + */ + public function setProperties($var) + { + $arr = GPBUtil::checkMapField($var, \Google\Protobuf\Internal\GPBType::STRING, \Google\Protobuf\Internal\GPBType::STRING); + $this->properties = $arr; + + return $this; + } + + /** + * Optional. The runtime log config for job execution. + * + * Generated from protobuf field .google.cloud.dataproc.v1.LoggingConfig logging_config = 7 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Cloud\Dataproc\V1\LoggingConfig|null + */ + public function getLoggingConfig() + { + return $this->logging_config; + } + + public function hasLoggingConfig() + { + return isset($this->logging_config); + } + + public function clearLoggingConfig() + { + unset($this->logging_config); + } + + /** + * Optional. The runtime log config for job execution. + * + * Generated from protobuf field .google.cloud.dataproc.v1.LoggingConfig logging_config = 7 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Cloud\Dataproc\V1\LoggingConfig $var + * @return $this + */ + public function setLoggingConfig($var) + { + GPBUtil::checkMessage($var, \Google\Cloud\Dataproc\V1\LoggingConfig::class); + $this->logging_config = $var; + + return $this; + } + + /** + * @return string + */ + public function getQueries() + { + return $this->whichOneof("queries"); + } + +} + diff --git a/Dataproc/src/V1/UpdateClusterRequest.php b/Dataproc/src/V1/UpdateClusterRequest.php index dead9997167..522db526103 100644 --- a/Dataproc/src/V1/UpdateClusterRequest.php +++ b/Dataproc/src/V1/UpdateClusterRequest.php @@ -41,7 +41,7 @@ class UpdateClusterRequest extends \Google\Protobuf\Internal\Message */ private $cluster = null; /** - * Optional. Timeout for graceful YARN decomissioning. Graceful + * Optional. Timeout for graceful YARN decommissioning. Graceful * decommissioning allows removing nodes from the cluster without * interrupting jobs in progress. Timeout specifies how long to wait for jobs * in progress to finish before forcefully removing nodes (and potentially @@ -138,7 +138,7 @@ class UpdateClusterRequest extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\Dataproc\V1\Cluster $cluster * Required. The changes to the cluster. * @type \Google\Protobuf\Duration $graceful_decommission_timeout - * Optional. Timeout for graceful YARN decomissioning. Graceful + * Optional. Timeout for graceful YARN decommissioning. Graceful * decommissioning allows removing nodes from the cluster without * interrupting jobs in progress. Timeout specifies how long to wait for jobs * in progress to finish before forcefully removing nodes (and potentially @@ -330,7 +330,7 @@ public function setCluster($var) } /** - * Optional. Timeout for graceful YARN decomissioning. Graceful + * Optional. Timeout for graceful YARN decommissioning. Graceful * decommissioning allows removing nodes from the cluster without * interrupting jobs in progress. Timeout specifies how long to wait for jobs * in progress to finish before forcefully removing nodes (and potentially @@ -358,7 +358,7 @@ public function clearGracefulDecommissionTimeout() } /** - * Optional. Timeout for graceful YARN decomissioning. Graceful + * Optional. Timeout for graceful YARN decommissioning. Graceful * decommissioning allows removing nodes from the cluster without * interrupting jobs in progress. Timeout specifies how long to wait for jobs * in progress to finish before forcefully removing nodes (and potentially diff --git a/Dataproc/src/V1/UsageMetrics.php b/Dataproc/src/V1/UsageMetrics.php new file mode 100644 index 00000000000..3216d2f3247 --- /dev/null +++ b/Dataproc/src/V1/UsageMetrics.php @@ -0,0 +1,117 @@ +google.cloud.dataproc.v1.UsageMetrics + */ +class UsageMetrics extends \Google\Protobuf\Internal\Message +{ + /** + * Optional. DCU (Dataproc Compute Units) usage in (`milliDCU` x `seconds`) + * (see [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * + * Generated from protobuf field int64 milli_dcu_seconds = 1 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $milli_dcu_seconds = 0; + /** + * Optional. Shuffle storage usage in (`GB` x `seconds`) (see + * [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * + * Generated from protobuf field int64 shuffle_storage_gb_seconds = 2 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $shuffle_storage_gb_seconds = 0; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type int|string $milli_dcu_seconds + * Optional. DCU (Dataproc Compute Units) usage in (`milliDCU` x `seconds`) + * (see [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * @type int|string $shuffle_storage_gb_seconds + * Optional. Shuffle storage usage in (`GB` x `seconds`) (see + * [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Dataproc\V1\Shared::initOnce(); + parent::__construct($data); + } + + /** + * Optional. DCU (Dataproc Compute Units) usage in (`milliDCU` x `seconds`) + * (see [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * + * Generated from protobuf field int64 milli_dcu_seconds = 1 [(.google.api.field_behavior) = OPTIONAL]; + * @return int|string + */ + public function getMilliDcuSeconds() + { + return $this->milli_dcu_seconds; + } + + /** + * Optional. DCU (Dataproc Compute Units) usage in (`milliDCU` x `seconds`) + * (see [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * + * Generated from protobuf field int64 milli_dcu_seconds = 1 [(.google.api.field_behavior) = OPTIONAL]; + * @param int|string $var + * @return $this + */ + public function setMilliDcuSeconds($var) + { + GPBUtil::checkInt64($var); + $this->milli_dcu_seconds = $var; + + return $this; + } + + /** + * Optional. Shuffle storage usage in (`GB` x `seconds`) (see + * [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * + * Generated from protobuf field int64 shuffle_storage_gb_seconds = 2 [(.google.api.field_behavior) = OPTIONAL]; + * @return int|string + */ + public function getShuffleStorageGbSeconds() + { + return $this->shuffle_storage_gb_seconds; + } + + /** + * Optional. Shuffle storage usage in (`GB` x `seconds`) (see + * [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * + * Generated from protobuf field int64 shuffle_storage_gb_seconds = 2 [(.google.api.field_behavior) = OPTIONAL]; + * @param int|string $var + * @return $this + */ + public function setShuffleStorageGbSeconds($var) + { + GPBUtil::checkInt64($var); + $this->shuffle_storage_gb_seconds = $var; + + return $this; + } + +} + diff --git a/Dataproc/src/V1/UsageSnapshot.php b/Dataproc/src/V1/UsageSnapshot.php new file mode 100644 index 00000000000..18ec8efe834 --- /dev/null +++ b/Dataproc/src/V1/UsageSnapshot.php @@ -0,0 +1,158 @@ +google.cloud.dataproc.v1.UsageSnapshot + */ +class UsageSnapshot extends \Google\Protobuf\Internal\Message +{ + /** + * Optional. Milli (one-thousandth) Dataproc Compute Units (DCUs) (see + * [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * + * Generated from protobuf field int64 milli_dcu = 1 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $milli_dcu = 0; + /** + * Optional. Shuffle Storage in gigabytes (GB). (see [Dataproc Serverless + * pricing] (https://cloud.google.com/dataproc-serverless/pricing)) + * + * Generated from protobuf field int64 shuffle_storage_gb = 2 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $shuffle_storage_gb = 0; + /** + * Optional. The timestamp of the usage snapshot. + * + * Generated from protobuf field .google.protobuf.Timestamp snapshot_time = 3 [(.google.api.field_behavior) = OPTIONAL]; + */ + private $snapshot_time = null; + + /** + * Constructor. + * + * @param array $data { + * Optional. Data for populating the Message object. + * + * @type int|string $milli_dcu + * Optional. Milli (one-thousandth) Dataproc Compute Units (DCUs) (see + * [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * @type int|string $shuffle_storage_gb + * Optional. Shuffle Storage in gigabytes (GB). (see [Dataproc Serverless + * pricing] (https://cloud.google.com/dataproc-serverless/pricing)) + * @type \Google\Protobuf\Timestamp $snapshot_time + * Optional. The timestamp of the usage snapshot. + * } + */ + public function __construct($data = NULL) { + \GPBMetadata\Google\Cloud\Dataproc\V1\Shared::initOnce(); + parent::__construct($data); + } + + /** + * Optional. Milli (one-thousandth) Dataproc Compute Units (DCUs) (see + * [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * + * Generated from protobuf field int64 milli_dcu = 1 [(.google.api.field_behavior) = OPTIONAL]; + * @return int|string + */ + public function getMilliDcu() + { + return $this->milli_dcu; + } + + /** + * Optional. Milli (one-thousandth) Dataproc Compute Units (DCUs) (see + * [Dataproc Serverless pricing] + * (https://cloud.google.com/dataproc-serverless/pricing)). + * + * Generated from protobuf field int64 milli_dcu = 1 [(.google.api.field_behavior) = OPTIONAL]; + * @param int|string $var + * @return $this + */ + public function setMilliDcu($var) + { + GPBUtil::checkInt64($var); + $this->milli_dcu = $var; + + return $this; + } + + /** + * Optional. Shuffle Storage in gigabytes (GB). (see [Dataproc Serverless + * pricing] (https://cloud.google.com/dataproc-serverless/pricing)) + * + * Generated from protobuf field int64 shuffle_storage_gb = 2 [(.google.api.field_behavior) = OPTIONAL]; + * @return int|string + */ + public function getShuffleStorageGb() + { + return $this->shuffle_storage_gb; + } + + /** + * Optional. Shuffle Storage in gigabytes (GB). (see [Dataproc Serverless + * pricing] (https://cloud.google.com/dataproc-serverless/pricing)) + * + * Generated from protobuf field int64 shuffle_storage_gb = 2 [(.google.api.field_behavior) = OPTIONAL]; + * @param int|string $var + * @return $this + */ + public function setShuffleStorageGb($var) + { + GPBUtil::checkInt64($var); + $this->shuffle_storage_gb = $var; + + return $this; + } + + /** + * Optional. The timestamp of the usage snapshot. + * + * Generated from protobuf field .google.protobuf.Timestamp snapshot_time = 3 [(.google.api.field_behavior) = OPTIONAL]; + * @return \Google\Protobuf\Timestamp|null + */ + public function getSnapshotTime() + { + return $this->snapshot_time; + } + + public function hasSnapshotTime() + { + return isset($this->snapshot_time); + } + + public function clearSnapshotTime() + { + unset($this->snapshot_time); + } + + /** + * Optional. The timestamp of the usage snapshot. + * + * Generated from protobuf field .google.protobuf.Timestamp snapshot_time = 3 [(.google.api.field_behavior) = OPTIONAL]; + * @param \Google\Protobuf\Timestamp $var + * @return $this + */ + public function setSnapshotTime($var) + { + GPBUtil::checkMessage($var, \Google\Protobuf\Timestamp::class); + $this->snapshot_time = $var; + + return $this; + } + +} + diff --git a/Dataproc/src/V1/VirtualClusterConfig.php b/Dataproc/src/V1/VirtualClusterConfig.php index a30cabffe58..9bee1fc71eb 100644 --- a/Dataproc/src/V1/VirtualClusterConfig.php +++ b/Dataproc/src/V1/VirtualClusterConfig.php @@ -11,7 +11,7 @@ /** * The Dataproc cluster config for a cluster that does not directly control the * underlying compute resources, such as a [Dataproc-on-GKE - * cluster](https://cloud.google.com/dataproc/docs/guides/dpgke/dataproc-gke). + * cluster](https://cloud.google.com/dataproc/docs/guides/dpgke/dataproc-gke-overview). * * Generated from protobuf message google.cloud.dataproc.v1.VirtualClusterConfig */ diff --git a/Dataproc/src/V1/WorkflowMetadata.php b/Dataproc/src/V1/WorkflowMetadata.php index b0f5eb63e84..1e357793910 100644 --- a/Dataproc/src/V1/WorkflowMetadata.php +++ b/Dataproc/src/V1/WorkflowMetadata.php @@ -90,22 +90,25 @@ class WorkflowMetadata extends \Google\Protobuf\Internal\Message */ private $cluster_uuid = ''; /** - * Output only. The timeout duration for the DAG of jobs, expressed in seconds (see - * [JSON representation of + * Output only. The timeout duration for the DAG of jobs, expressed in seconds + * (see [JSON representation of * duration](https://developers.google.com/protocol-buffers/docs/proto3#json)). * * Generated from protobuf field .google.protobuf.Duration dag_timeout = 12 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ private $dag_timeout = null; /** - * Output only. DAG start time, only set for workflows with [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when DAG - * begins. + * Output only. DAG start time, only set for workflows with + * [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when + * DAG begins. * * Generated from protobuf field .google.protobuf.Timestamp dag_start_time = 13 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ private $dag_start_time = null; /** - * Output only. DAG end time, only set for workflows with [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when DAG ends. + * Output only. DAG end time, only set for workflows with + * [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when + * DAG ends. * * Generated from protobuf field .google.protobuf.Timestamp dag_end_time = 14 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ @@ -148,14 +151,17 @@ class WorkflowMetadata extends \Google\Protobuf\Internal\Message * @type string $cluster_uuid * Output only. The UUID of target cluster. * @type \Google\Protobuf\Duration $dag_timeout - * Output only. The timeout duration for the DAG of jobs, expressed in seconds (see - * [JSON representation of + * Output only. The timeout duration for the DAG of jobs, expressed in seconds + * (see [JSON representation of * duration](https://developers.google.com/protocol-buffers/docs/proto3#json)). * @type \Google\Protobuf\Timestamp $dag_start_time - * Output only. DAG start time, only set for workflows with [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when DAG - * begins. + * Output only. DAG start time, only set for workflows with + * [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when + * DAG begins. * @type \Google\Protobuf\Timestamp $dag_end_time - * Output only. DAG end time, only set for workflows with [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when DAG ends. + * Output only. DAG end time, only set for workflows with + * [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when + * DAG ends. * } */ public function __construct($data = NULL) { @@ -516,8 +522,8 @@ public function setClusterUuid($var) } /** - * Output only. The timeout duration for the DAG of jobs, expressed in seconds (see - * [JSON representation of + * Output only. The timeout duration for the DAG of jobs, expressed in seconds + * (see [JSON representation of * duration](https://developers.google.com/protocol-buffers/docs/proto3#json)). * * Generated from protobuf field .google.protobuf.Duration dag_timeout = 12 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -539,8 +545,8 @@ public function clearDagTimeout() } /** - * Output only. The timeout duration for the DAG of jobs, expressed in seconds (see - * [JSON representation of + * Output only. The timeout duration for the DAG of jobs, expressed in seconds + * (see [JSON representation of * duration](https://developers.google.com/protocol-buffers/docs/proto3#json)). * * Generated from protobuf field .google.protobuf.Duration dag_timeout = 12 [(.google.api.field_behavior) = OUTPUT_ONLY]; @@ -556,8 +562,9 @@ public function setDagTimeout($var) } /** - * Output only. DAG start time, only set for workflows with [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when DAG - * begins. + * Output only. DAG start time, only set for workflows with + * [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when + * DAG begins. * * Generated from protobuf field .google.protobuf.Timestamp dag_start_time = 13 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @return \Google\Protobuf\Timestamp|null @@ -578,8 +585,9 @@ public function clearDagStartTime() } /** - * Output only. DAG start time, only set for workflows with [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when DAG - * begins. + * Output only. DAG start time, only set for workflows with + * [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when + * DAG begins. * * Generated from protobuf field .google.protobuf.Timestamp dag_start_time = 13 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @param \Google\Protobuf\Timestamp $var @@ -594,7 +602,9 @@ public function setDagStartTime($var) } /** - * Output only. DAG end time, only set for workflows with [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when DAG ends. + * Output only. DAG end time, only set for workflows with + * [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when + * DAG ends. * * Generated from protobuf field .google.protobuf.Timestamp dag_end_time = 14 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @return \Google\Protobuf\Timestamp|null @@ -615,7 +625,9 @@ public function clearDagEndTime() } /** - * Output only. DAG end time, only set for workflows with [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when DAG ends. + * Output only. DAG end time, only set for workflows with + * [dag_timeout][google.cloud.dataproc.v1.WorkflowMetadata.dag_timeout] when + * DAG ends. * * Generated from protobuf field .google.protobuf.Timestamp dag_end_time = 14 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @param \Google\Protobuf\Timestamp $var diff --git a/Dataproc/src/V1/WorkflowTemplateServiceGrpcClient.php b/Dataproc/src/V1/WorkflowTemplateServiceGrpcClient.php index 6b2d714d63c..8a9e6ef111a 100644 --- a/Dataproc/src/V1/WorkflowTemplateServiceGrpcClient.php +++ b/Dataproc/src/V1/WorkflowTemplateServiceGrpcClient.php @@ -104,7 +104,8 @@ public function InstantiateWorkflowTemplate(\Google\Cloud\Dataproc\V1\Instantiat * Instantiates a template and begins execution. * * This method is equivalent to executing the sequence - * [CreateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.CreateWorkflowTemplate], [InstantiateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.InstantiateWorkflowTemplate], + * [CreateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.CreateWorkflowTemplate], + * [InstantiateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.InstantiateWorkflowTemplate], * [DeleteWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.DeleteWorkflowTemplate]. * * The returned Operation can be used to track execution of diff --git a/Dataproc/src/V1/gapic_metadata.json b/Dataproc/src/V1/gapic_metadata.json index ae71cfb4a8c..3302303030b 100644 --- a/Dataproc/src/V1/gapic_metadata.json +++ b/Dataproc/src/V1/gapic_metadata.json @@ -161,6 +161,30 @@ } } }, + "NodeGroupController": { + "clients": { + "grpc": { + "libraryClient": "NodeGroupControllerGapicClient", + "rpcs": { + "CreateNodeGroup": { + "methods": [ + "createNodeGroup" + ] + }, + "GetNodeGroup": { + "methods": [ + "getNodeGroup" + ] + }, + "ResizeNodeGroup": { + "methods": [ + "resizeNodeGroup" + ] + } + } + } + } + }, "WorkflowTemplateService": { "clients": { "grpc": { @@ -204,30 +228,6 @@ } } } - }, - "NodeGroupController": { - "clients": { - "grpc": { - "libraryClient": "NodeGroupControllerGapicClient", - "rpcs": { - "CreateNodeGroup": { - "methods": [ - "createNodeGroup" - ] - }, - "GetNodeGroup": { - "methods": [ - "getNodeGroup" - ] - }, - "ResizeNodeGroup": { - "methods": [ - "resizeNodeGroup" - ] - } - } - } - } } } } \ No newline at end of file diff --git a/Dataproc/src/V1/resources/autoscaling_policy_service_rest_client_config.php b/Dataproc/src/V1/resources/autoscaling_policy_service_rest_client_config.php index 8d156fa73bb..802871a91d8 100644 --- a/Dataproc/src/V1/resources/autoscaling_policy_service_rest_client_config.php +++ b/Dataproc/src/V1/resources/autoscaling_policy_service_rest_client_config.php @@ -232,6 +232,12 @@ 'CancelOperation' => [ 'method' => 'post', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}:cancel', + 'additionalBindings' => [ + [ + 'method' => 'post', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}:cancel', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -243,6 +249,12 @@ 'DeleteOperation' => [ 'method' => 'delete', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}', + 'additionalBindings' => [ + [ + 'method' => 'delete', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -254,6 +266,12 @@ 'GetOperation' => [ 'method' => 'get', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}', + 'additionalBindings' => [ + [ + 'method' => 'get', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -265,6 +283,12 @@ 'ListOperations' => [ 'method' => 'get', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations}', + 'additionalBindings' => [ + [ + 'method' => 'get', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ diff --git a/Dataproc/src/V1/resources/batch_controller_rest_client_config.php b/Dataproc/src/V1/resources/batch_controller_rest_client_config.php index 927814206ad..15194bea6ec 100644 --- a/Dataproc/src/V1/resources/batch_controller_rest_client_config.php +++ b/Dataproc/src/V1/resources/batch_controller_rest_client_config.php @@ -187,6 +187,12 @@ 'CancelOperation' => [ 'method' => 'post', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}:cancel', + 'additionalBindings' => [ + [ + 'method' => 'post', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}:cancel', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -198,6 +204,12 @@ 'DeleteOperation' => [ 'method' => 'delete', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}', + 'additionalBindings' => [ + [ + 'method' => 'delete', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -209,6 +221,12 @@ 'GetOperation' => [ 'method' => 'get', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}', + 'additionalBindings' => [ + [ + 'method' => 'get', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -220,6 +238,12 @@ 'ListOperations' => [ 'method' => 'get', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations}', + 'additionalBindings' => [ + [ + 'method' => 'get', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ diff --git a/Dataproc/src/V1/resources/cluster_controller_rest_client_config.php b/Dataproc/src/V1/resources/cluster_controller_rest_client_config.php index 9e03e928f98..87a6911ceeb 100644 --- a/Dataproc/src/V1/resources/cluster_controller_rest_client_config.php +++ b/Dataproc/src/V1/resources/cluster_controller_rest_client_config.php @@ -308,6 +308,12 @@ 'CancelOperation' => [ 'method' => 'post', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}:cancel', + 'additionalBindings' => [ + [ + 'method' => 'post', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}:cancel', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -319,6 +325,12 @@ 'DeleteOperation' => [ 'method' => 'delete', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}', + 'additionalBindings' => [ + [ + 'method' => 'delete', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -330,6 +342,12 @@ 'GetOperation' => [ 'method' => 'get', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}', + 'additionalBindings' => [ + [ + 'method' => 'get', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -341,6 +359,12 @@ 'ListOperations' => [ 'method' => 'get', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations}', + 'additionalBindings' => [ + [ + 'method' => 'get', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ diff --git a/Dataproc/src/V1/resources/job_controller_rest_client_config.php b/Dataproc/src/V1/resources/job_controller_rest_client_config.php index b387c75fb54..7523816ab8b 100644 --- a/Dataproc/src/V1/resources/job_controller_rest_client_config.php +++ b/Dataproc/src/V1/resources/job_controller_rest_client_config.php @@ -281,6 +281,12 @@ 'CancelOperation' => [ 'method' => 'post', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}:cancel', + 'additionalBindings' => [ + [ + 'method' => 'post', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}:cancel', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -292,6 +298,12 @@ 'DeleteOperation' => [ 'method' => 'delete', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}', + 'additionalBindings' => [ + [ + 'method' => 'delete', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -303,6 +315,12 @@ 'GetOperation' => [ 'method' => 'get', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}', + 'additionalBindings' => [ + [ + 'method' => 'get', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -314,6 +332,12 @@ 'ListOperations' => [ 'method' => 'get', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations}', + 'additionalBindings' => [ + [ + 'method' => 'get', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ diff --git a/Dataproc/src/V1/resources/node_group_controller_rest_client_config.php b/Dataproc/src/V1/resources/node_group_controller_rest_client_config.php index 9c62ffcd328..d0ef71ea59c 100644 --- a/Dataproc/src/V1/resources/node_group_controller_rest_client_config.php +++ b/Dataproc/src/V1/resources/node_group_controller_rest_client_config.php @@ -177,6 +177,12 @@ 'CancelOperation' => [ 'method' => 'post', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}:cancel', + 'additionalBindings' => [ + [ + 'method' => 'post', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}:cancel', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -188,6 +194,12 @@ 'DeleteOperation' => [ 'method' => 'delete', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}', + 'additionalBindings' => [ + [ + 'method' => 'delete', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -199,6 +211,12 @@ 'GetOperation' => [ 'method' => 'get', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}', + 'additionalBindings' => [ + [ + 'method' => 'get', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -210,6 +228,12 @@ 'ListOperations' => [ 'method' => 'get', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations}', + 'additionalBindings' => [ + [ + 'method' => 'get', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ diff --git a/Dataproc/src/V1/resources/workflow_template_service_rest_client_config.php b/Dataproc/src/V1/resources/workflow_template_service_rest_client_config.php index 51d2124913a..695430e9a49 100644 --- a/Dataproc/src/V1/resources/workflow_template_service_rest_client_config.php +++ b/Dataproc/src/V1/resources/workflow_template_service_rest_client_config.php @@ -270,6 +270,12 @@ 'CancelOperation' => [ 'method' => 'post', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}:cancel', + 'additionalBindings' => [ + [ + 'method' => 'post', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}:cancel', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -281,6 +287,12 @@ 'DeleteOperation' => [ 'method' => 'delete', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}', + 'additionalBindings' => [ + [ + 'method' => 'delete', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -292,6 +304,12 @@ 'GetOperation' => [ 'method' => 'get', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations/*}', + 'additionalBindings' => [ + [ + 'method' => 'get', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations/*}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [ @@ -303,6 +321,12 @@ 'ListOperations' => [ 'method' => 'get', 'uriTemplate' => '/v1/{name=projects/*/regions/*/operations}', + 'additionalBindings' => [ + [ + 'method' => 'get', + 'uriTemplate' => '/v1/{name=projects/*/locations/*/operations}', + ], + ], 'placeholders' => [ 'name' => [ 'getters' => [