🦉 Updates from OwlBot post-processor

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

AiPlatform/samples/V1/TensorboardServiceClient/batch_create_tensorboard_runs.php

@@ -50,7 +50,7 @@
  *                                                  component of the Tensorboard run's resource name.
  *
  *                                                  This value should be 1-128 characters, and valid characters
- *                                                  are /[a-z][0-9]-/.
+ *                                                  are `/[a-z][0-9]-/`.
  */
 function batch_create_tensorboard_runs_sample(
     string $formattedParent,

AiPlatform/samples/V1/TensorboardServiceClient/create_tensorboard_experiment.php

@@ -39,7 +39,7 @@
  *                                        final component of the Tensorboard experiment's resource name.
  *
  *                                        This value should be 1-128 characters, and valid characters
- *                                        are /[a-z][0-9]-/.
+ *                                        are `/[a-z][0-9]-/`.
  */
 function create_tensorboard_experiment_sample(
     string $formattedParent,

AiPlatform/samples/V1/TensorboardServiceClient/create_tensorboard_run.php

@@ -42,7 +42,7 @@
  *                                          component of the Tensorboard run's resource name.
  *
  *                                          This value should be 1-128 characters, and valid characters
- *                                          are /[a-z][0-9]-/.
+ *                                          are `/[a-z][0-9]-/`.
  */
 function create_tensorboard_run_sample(
     string $formattedParent,

AiPlatform/src/V1/Client/BaseClient/DatasetServiceBaseClient.php

@@ -37,17 +37,23 @@
 use Google\Auth\FetchAuthTokenInterface;
 use Google\Cloud\AIPlatform\V1\AnnotationSpec;
 use Google\Cloud\AIPlatform\V1\CreateDatasetRequest;
+use Google\Cloud\AIPlatform\V1\CreateDatasetVersionRequest;
 use Google\Cloud\AIPlatform\V1\Dataset;
+use Google\Cloud\AIPlatform\V1\DatasetVersion;
 use Google\Cloud\AIPlatform\V1\DeleteDatasetRequest;
+use Google\Cloud\AIPlatform\V1\DeleteDatasetVersionRequest;
 use Google\Cloud\AIPlatform\V1\DeleteSavedQueryRequest;
 use Google\Cloud\AIPlatform\V1\ExportDataRequest;
 use Google\Cloud\AIPlatform\V1\GetAnnotationSpecRequest;
 use Google\Cloud\AIPlatform\V1\GetDatasetRequest;
+use Google\Cloud\AIPlatform\V1\GetDatasetVersionRequest;
 use Google\Cloud\AIPlatform\V1\ImportDataRequest;
 use Google\Cloud\AIPlatform\V1\ListAnnotationsRequest;
 use Google\Cloud\AIPlatform\V1\ListDataItemsRequest;
+use Google\Cloud\AIPlatform\V1\ListDatasetVersionsRequest;
 use Google\Cloud\AIPlatform\V1\ListDatasetsRequest;
 use Google\Cloud\AIPlatform\V1\ListSavedQueriesRequest;
+use Google\Cloud\AIPlatform\V1\RestoreDatasetVersionRequest;
 use Google\Cloud\AIPlatform\V1\SearchDataItemsRequest;
 use Google\Cloud\AIPlatform\V1\UpdateDatasetRequest;
 use Google\Cloud\Iam\V1\GetIamPolicyRequest;
@@ -80,16 +86,21 @@
  * @internal
  *
  * @method PromiseInterface createDatasetAsync(CreateDatasetRequest $request, array $optionalArgs = [])
+ * @method PromiseInterface createDatasetVersionAsync(CreateDatasetVersionRequest $request, array $optionalArgs = [])
  * @method PromiseInterface deleteDatasetAsync(DeleteDatasetRequest $request, array $optionalArgs = [])
+ * @method PromiseInterface deleteDatasetVersionAsync(DeleteDatasetVersionRequest $request, array $optionalArgs = [])
  * @method PromiseInterface deleteSavedQueryAsync(DeleteSavedQueryRequest $request, array $optionalArgs = [])
  * @method PromiseInterface exportDataAsync(ExportDataRequest $request, array $optionalArgs = [])
  * @method PromiseInterface getAnnotationSpecAsync(GetAnnotationSpecRequest $request, array $optionalArgs = [])
  * @method PromiseInterface getDatasetAsync(GetDatasetRequest $request, array $optionalArgs = [])
+ * @method PromiseInterface getDatasetVersionAsync(GetDatasetVersionRequest $request, array $optionalArgs = [])
  * @method PromiseInterface importDataAsync(ImportDataRequest $request, array $optionalArgs = [])
  * @method PromiseInterface listAnnotationsAsync(ListAnnotationsRequest $request, array $optionalArgs = [])
  * @method PromiseInterface listDataItemsAsync(ListDataItemsRequest $request, array $optionalArgs = [])
+ * @method PromiseInterface listDatasetVersionsAsync(ListDatasetVersionsRequest $request, array $optionalArgs = [])
  * @method PromiseInterface listDatasetsAsync(ListDatasetsRequest $request, array $optionalArgs = [])
  * @method PromiseInterface listSavedQueriesAsync(ListSavedQueriesRequest $request, array $optionalArgs = [])
+ * @method PromiseInterface restoreDatasetVersionAsync(RestoreDatasetVersionRequest $request, array $optionalArgs = [])
  * @method PromiseInterface searchDataItemsAsync(SearchDataItemsRequest $request, array $optionalArgs = [])
  * @method PromiseInterface updateDatasetAsync(UpdateDatasetRequest $request, array $optionalArgs = [])
  * @method PromiseInterface getLocationAsync(GetLocationRequest $request, array $optionalArgs = [])
@@ -231,6 +242,27 @@ public static function datasetName(string $project, string $location, string $da
         ]);
     }
 
+    /**
+     * Formats a string containing the fully-qualified path to represent a
+     * dataset_version resource.
+     *
+     * @param string $project
+     * @param string $location
+     * @param string $dataset
+     * @param string $datasetVersion
+     *
+     * @return string The formatted dataset_version resource.
+     */
+    public static function datasetVersionName(string $project, string $location, string $dataset, string $datasetVersion): string
+    {
+        return self::getPathTemplate('datasetVersion')->render([
+            'project' => $project,
+            'location' => $location,
+            'dataset' => $dataset,
+            'dataset_version' => $datasetVersion,
+        ]);
+    }
+
     /**
      * Formats a string containing the fully-qualified path to represent a location
      * resource.
@@ -276,6 +308,7 @@ public static function savedQueryName(string $project, string $location, string
      * - annotationSpec: projects/{project}/locations/{location}/datasets/{dataset}/annotationSpecs/{annotation_spec}
      * - dataItem: projects/{project}/locations/{location}/datasets/{dataset}/dataItems/{data_item}
      * - dataset: projects/{project}/locations/{location}/datasets/{dataset}
+     * - datasetVersion: projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}
      * - location: projects/{project}/locations/{location}
      * - savedQuery: projects/{project}/locations/{location}/datasets/{dataset}/savedQueries/{saved_query}
      *
@@ -395,6 +428,32 @@ public function createDataset(CreateDatasetRequest $request, array $callOptions
         return $this->startApiCall('CreateDataset', $request, $callOptions)->wait();
     }
 
+    /**
+     * Create a version from a Dataset.
+     *
+     * The async variant is {@see self::createDatasetVersionAsync()} .
+     *
+     * @example samples/V1/DatasetServiceClient/create_dataset_version.php
+     *
+     * @param CreateDatasetVersionRequest $request     A request to house fields associated with the call.
+     * @param array                       $callOptions {
+     *     Optional.
+     *
+     *     @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
+     *           {@see RetrySettings} for example usage.
+     * }
+     *
+     * @return OperationResponse
+     *
+     * @throws ApiException Thrown if the API call fails.
+     */
+    public function createDatasetVersion(CreateDatasetVersionRequest $request, array $callOptions = []): OperationResponse
+    {
+        return $this->startApiCall('CreateDatasetVersion', $request, $callOptions)->wait();
+    }
+
     /**
      * Deletes a Dataset.
      *
@@ -421,6 +480,32 @@ public function deleteDataset(DeleteDatasetRequest $request, array $callOptions
         return $this->startApiCall('DeleteDataset', $request, $callOptions)->wait();
     }
 
+    /**
+     * Deletes a Dataset version.
+     *
+     * The async variant is {@see self::deleteDatasetVersionAsync()} .
+     *
+     * @example samples/V1/DatasetServiceClient/delete_dataset_version.php
+     *
+     * @param DeleteDatasetVersionRequest $request     A request to house fields associated with the call.
+     * @param array                       $callOptions {
+     *     Optional.
+     *
+     *     @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
+     *           {@see RetrySettings} for example usage.
+     * }
+     *
+     * @return OperationResponse
+     *
+     * @throws ApiException Thrown if the API call fails.
+     */
+    public function deleteDatasetVersion(DeleteDatasetVersionRequest $request, array $callOptions = []): OperationResponse
+    {
+        return $this->startApiCall('DeleteDatasetVersion', $request, $callOptions)->wait();
+    }
+
     /**
      * Deletes a SavedQuery.
      *
@@ -525,6 +610,32 @@ public function getDataset(GetDatasetRequest $request, array $callOptions = []):
         return $this->startApiCall('GetDataset', $request, $callOptions)->wait();
     }
 
+    /**
+     * Gets a Dataset version.
+     *
+     * The async variant is {@see self::getDatasetVersionAsync()} .
+     *
+     * @example samples/V1/DatasetServiceClient/get_dataset_version.php
+     *
+     * @param GetDatasetVersionRequest $request     A request to house fields associated with the call.
+     * @param array                    $callOptions {
+     *     Optional.
+     *
+     *     @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
+     *           {@see RetrySettings} for example usage.
+     * }
+     *
+     * @return DatasetVersion
+     *
+     * @throws ApiException Thrown if the API call fails.
+     */
+    public function getDatasetVersion(GetDatasetVersionRequest $request, array $callOptions = []): DatasetVersion
+    {
+        return $this->startApiCall('GetDatasetVersion', $request, $callOptions)->wait();
+    }
+
     /**
      * Imports data into a Dataset.
      *
@@ -603,6 +714,32 @@ public function listDataItems(ListDataItemsRequest $request, array $callOptions
         return $this->startApiCall('ListDataItems', $request, $callOptions);
     }
 
+    /**
+     * Lists DatasetVersions in a Dataset.
+     *
+     * The async variant is {@see self::listDatasetVersionsAsync()} .
+     *
+     * @example samples/V1/DatasetServiceClient/list_dataset_versions.php
+     *
+     * @param ListDatasetVersionsRequest $request     A request to house fields associated with the call.
+     * @param array                      $callOptions {
+     *     Optional.
+     *
+     *     @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
+     *           {@see RetrySettings} for example usage.
+     * }
+     *
+     * @return PagedListResponse
+     *
+     * @throws ApiException Thrown if the API call fails.
+     */
+    public function listDatasetVersions(ListDatasetVersionsRequest $request, array $callOptions = []): PagedListResponse
+    {
+        return $this->startApiCall('ListDatasetVersions', $request, $callOptions);
+    }
+
     /**
      * Lists Datasets in a Location.
      *
@@ -655,6 +792,32 @@ public function listSavedQueries(ListSavedQueriesRequest $request, array $callOp
         return $this->startApiCall('ListSavedQueries', $request, $callOptions);
     }
 
+    /**
+     * Restores a dataset version.
+     *
+     * The async variant is {@see self::restoreDatasetVersionAsync()} .
+     *
+     * @example samples/V1/DatasetServiceClient/restore_dataset_version.php
+     *
+     * @param RestoreDatasetVersionRequest $request     A request to house fields associated with the call.
+     * @param array                        $callOptions {
+     *     Optional.
+     *
+     *     @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
+     *           {@see RetrySettings} for example usage.
+     * }
+     *
+     * @return OperationResponse
+     *
+     * @throws ApiException Thrown if the API call fails.
+     */
+    public function restoreDatasetVersion(RestoreDatasetVersionRequest $request, array $callOptions = []): OperationResponse
+    {
+        return $this->startApiCall('RestoreDatasetVersion', $request, $callOptions)->wait();
+    }
+
     /**
      * Searches DataItems in a Dataset.
      *

AiPlatform/src/V1/Client/BaseClient/JobServiceBaseClient.php

@@ -467,6 +467,23 @@ public static function networkName(string $project, string $network): string
         ]);
     }
 
+    /**
+     * Formats a string containing the fully-qualified path to represent a
+     * notification_channel resource.
+     *
+     * @param string $project
+     * @param string $notificationChannel
+     *
+     * @return string The formatted notification_channel resource.
+     */
+    public static function notificationChannelName(string $project, string $notificationChannel): string
+    {
+        return self::getPathTemplate('notificationChannel')->render([
+            'project' => $project,
+            'notification_channel' => $notificationChannel,
+        ]);
+    }
+
     /**
      * Formats a string containing the fully-qualified path to represent a
      * project_location_endpoint resource.
@@ -564,6 +581,7 @@ public static function trialName(string $project, string $location, string $stud
      * - nasJob: projects/{project}/locations/{location}/nasJobs/{nas_job}
      * - nasTrialDetail: projects/{project}/locations/{location}/nasJobs/{nas_job}/nasTrialDetails/{nas_trial_detail}
      * - network: projects/{project}/global/networks/{network}
+     * - notificationChannel: projects/{project}/notificationChannels/{notification_channel}
      * - projectLocationEndpoint: projects/{project}/locations/{location}/endpoints/{endpoint}
      * - projectLocationPublisherModel: projects/{project}/locations/{location}/publishers/{publisher}/models/{model}
      * - tensorboard: projects/{project}/locations/{location}/tensorboards/{tensorboard}