feat: [Scheduler] add location RPCs / legacy_app_engine_cron option (#…

…5705)

* feat: Updated Client Libraries for Cloud Scheduler

PiperOrigin-RevId: 495092454

Source-Link: googleapis/googleapis@3fbdb93

Source-Link: googleapis/googleapis-gen@ecf0b6c
Copy-Tag: eyJwIjoiU2NoZWR1bGVyLy5Pd2xCb3QueWFtbCIsImgiOiJlY2YwYjZjOTBlZTc2ZTUzZTM4Y2I4ZWE1ZjYwNDc1ZjJiNGUzMjBjIn0=

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Scheduler/samples/V1beta1/CloudSchedulerClient/get_location.php

@@ -0,0 +1,53 @@
+<?php
+/*
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * GENERATED CODE WARNING
+ * This file was automatically generated - do not edit!
+ */
+
+require_once __DIR__ . '/../../../vendor/autoload.php';
+
+// [START cloudscheduler_v1beta1_generated_CloudScheduler_GetLocation_sync]
+use Google\ApiCore\ApiException;
+use Google\Cloud\Location\Location;
+use Google\Cloud\Scheduler\V1beta1\CloudSchedulerClient;
+
+/**
+ * Gets information about a location.
+ *
+ * This sample has been automatically generated and should be regarded as a code
+ * template only. It will require modifications to work:
+ *  - It may require correct/in-range values for request initialization.
+ *  - It may require specifying regional endpoints when creating the service client,
+ *    please see the apiEndpoint client configuration option for more details.
+ */
+function get_location_sample(): void
+{
+    // Create a client.
+    $cloudSchedulerClient = new CloudSchedulerClient();
+
+    // Call the API and handle any network failures.
+    try {
+        /** @var Location $response */
+        $response = $cloudSchedulerClient->getLocation();
+        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
+    } catch (ApiException $ex) {
+        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
+    }
+}
+// [END cloudscheduler_v1beta1_generated_CloudScheduler_GetLocation_sync]

Scheduler/samples/V1beta1/CloudSchedulerClient/list_locations.php

@@ -0,0 +1,58 @@
+<?php
+/*
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * GENERATED CODE WARNING
+ * This file was automatically generated - do not edit!
+ */
+
+require_once __DIR__ . '/../../../vendor/autoload.php';
+
+// [START cloudscheduler_v1beta1_generated_CloudScheduler_ListLocations_sync]
+use Google\ApiCore\ApiException;
+use Google\ApiCore\PagedListResponse;
+use Google\Cloud\Location\Location;
+use Google\Cloud\Scheduler\V1beta1\CloudSchedulerClient;
+
+/**
+ * Lists information about the supported locations for this service.
+ *
+ * This sample has been automatically generated and should be regarded as a code
+ * template only. It will require modifications to work:
+ *  - It may require correct/in-range values for request initialization.
+ *  - It may require specifying regional endpoints when creating the service client,
+ *    please see the apiEndpoint client configuration option for more details.
+ */
+function list_locations_sample(): void
+{
+    // Create a client.
+    $cloudSchedulerClient = new CloudSchedulerClient();
+
+    // Call the API and handle any network failures.
+    try {
+        /** @var PagedListResponse $response */
+        $response = $cloudSchedulerClient->listLocations();
+
+        /** @var Location $element */
+        foreach ($response as $element) {
+            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());
+        }
+    } catch (ApiException $ex) {
+        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
+    }
+}
+// [END cloudscheduler_v1beta1_generated_CloudScheduler_ListLocations_sync]

Scheduler/samples/V1beta1/CloudSchedulerClient/pause_job.php

@@ -31,10 +31,14 @@
  * Pauses a job.
  *
  * If a job is paused then the system will stop executing the job
- * until it is re-enabled via [ResumeJob][google.cloud.scheduler.v1beta1.CloudScheduler.ResumeJob]. The
- * state of the job is stored in [state][google.cloud.scheduler.v1beta1.Job.state]; if paused it
- * will be set to [Job.State.PAUSED][google.cloud.scheduler.v1beta1.Job.State.PAUSED]. A job must be in [Job.State.ENABLED][google.cloud.scheduler.v1beta1.Job.State.ENABLED]
- * to be paused.
+ * until it is re-enabled via
+ * [ResumeJob][google.cloud.scheduler.v1beta1.CloudScheduler.ResumeJob]. The
+ * state of the job is stored in
+ * [state][google.cloud.scheduler.v1beta1.Job.state]; if paused it will be set
+ * to [Job.State.PAUSED][google.cloud.scheduler.v1beta1.Job.State.PAUSED]. A
+ * job must be in
+ * [Job.State.ENABLED][google.cloud.scheduler.v1beta1.Job.State.ENABLED] to be
+ * paused.
  *
  * @param string $formattedName The job name. For example:
  *                              `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. Please see

Scheduler/samples/V1beta1/CloudSchedulerClient/resume_job.php

@@ -30,10 +30,15 @@
 /**
  * Resume a job.
  *
- * This method reenables a job after it has been [Job.State.PAUSED][google.cloud.scheduler.v1beta1.Job.State.PAUSED]. The
- * state of a job is stored in [Job.state][google.cloud.scheduler.v1beta1.Job.state]; after calling this method it
- * will be set to [Job.State.ENABLED][google.cloud.scheduler.v1beta1.Job.State.ENABLED]. A job must be in
- * [Job.State.PAUSED][google.cloud.scheduler.v1beta1.Job.State.PAUSED] to be resumed.
+ * This method reenables a job after it has been
+ * [Job.State.PAUSED][google.cloud.scheduler.v1beta1.Job.State.PAUSED]. The
+ * state of a job is stored in
+ * [Job.state][google.cloud.scheduler.v1beta1.Job.state]; after calling this
+ * method it will be set to
+ * [Job.State.ENABLED][google.cloud.scheduler.v1beta1.Job.State.ENABLED]. A
+ * job must be in
+ * [Job.State.PAUSED][google.cloud.scheduler.v1beta1.Job.State.PAUSED] to be
+ * resumed.
  *
  * @param string $formattedName The job name. For example:
  *                              `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. Please see

Scheduler/samples/V1beta1/CloudSchedulerClient/update_job.php

@@ -30,13 +30,14 @@
 /**
  * Updates a job.
  *
- * If successful, the updated [Job][google.cloud.scheduler.v1beta1.Job] is returned. If the job does
- * not exist, `NOT_FOUND` is returned.
+ * If successful, the updated [Job][google.cloud.scheduler.v1beta1.Job] is
+ * returned. If the job does not exist, `NOT_FOUND` is returned.
  *
  * If UpdateJob does not successfully return, it is possible for the
- * job to be in an [Job.State.UPDATE_FAILED][google.cloud.scheduler.v1beta1.Job.State.UPDATE_FAILED] state. A job in this state may
- * not be executed. If this happens, retry the UpdateJob request
- * until a successful response is received.
+ * job to be in an
+ * [Job.State.UPDATE_FAILED][google.cloud.scheduler.v1beta1.Job.State.UPDATE_FAILED]
+ * state. A job in this state may not be executed. If this happens, retry the
+ * UpdateJob request until a successful response is received.
  *
  * This sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work: