chore(Dataplex): update gapic-generator-php v1.6.7 (#5839)

PiperOrigin-RevId: 515149688 Source-Link: googleapis/googleapis@b0251f4 Source-Link: googleapis/googleapis-gen@fa1bb76 Copy-Tag: eyJwIjoiRGF0YXBsZXgvLk93bEJvdC55YW1sIiwiaCI6ImZhMWJiNzY0YTM0ZjQ0YjVlNzRlNmNkNmQxYWYzZjNkMTQwMTE2MjUifQ== docs: Improvements to DataScan API documentation PiperOrigin-RevId: 506348044 Source-Link: googleapis/googleapis@4eb6d9e Source-Link: googleapis/googleapis-gen@830a4ab Copy-Tag: eyJwIjoiRGF0YXBsZXgvLk93bEJvdC55YW1sIiwiaCI6IjgzMGE0YWI4Yzk4MzZiMzc3ZDQzZmY5NWI2OGQ4MzcyODkwZTkzYzMifQ== chore: update import paths for Go targets to match open source location chore: update go_package in protos to match open source location chore: add explicit release levels to Go gapic targets PiperOrigin-RevId: 506711567 Source-Link: googleapis/googleapis@d02e582 Source-Link: googleapis/googleapis-gen@7f1c541 Copy-Tag: eyJwIjoiRGF0YXBsZXgvLk93bEJvdC55YW1sIiwiaCI6IjdmMWM1NDE1MzEyNWViNWFiZDYwYTMyZGU1OGNmZGE2YTc5OGE3MGEifQ==
googleapis · Mar 9, 2023 · 5f60837 · 5f60837
1 parent 0429b0a
commit 5f60837
Show file tree

Hide file tree

Showing 41 changed files with 232 additions and 216 deletions.
diff --git a/Dataplex/metadata/V1/Analyze.php b/Dataplex/metadata/V1/Analyze.php
diff --git a/Dataplex/metadata/V1/Content.php b/Dataplex/metadata/V1/Content.php
diff --git a/Dataplex/metadata/V1/DataProfile.php b/Dataplex/metadata/V1/DataProfile.php
diff --git a/Dataplex/metadata/V1/DataQuality.php b/Dataplex/metadata/V1/DataQuality.php
diff --git a/Dataplex/metadata/V1/Datascans.php b/Dataplex/metadata/V1/Datascans.php
diff --git a/Dataplex/metadata/V1/Logs.php b/Dataplex/metadata/V1/Logs.php
diff --git a/Dataplex/metadata/V1/Metadata.php b/Dataplex/metadata/V1/Metadata.php
diff --git a/Dataplex/metadata/V1/Processing.php b/Dataplex/metadata/V1/Processing.php
diff --git a/Dataplex/metadata/V1/Resources.php b/Dataplex/metadata/V1/Resources.php
diff --git a/Dataplex/metadata/V1/Service.php b/Dataplex/metadata/V1/Service.php
diff --git a/Dataplex/metadata/V1/Tasks.php b/Dataplex/metadata/V1/Tasks.php
diff --git a/Dataplex/samples/V1/ContentServiceClient/get_iam_policy.php b/Dataplex/samples/V1/ContentServiceClient/get_iam_policy.php
@@ -28,8 +28,12 @@
 use Google\Cloud\Iam\V1\Policy;
 
 /**
- * Gets the access control policy for a resource. Returns an empty policy
-if the resource exists and does not have a policy set.
+ * Gets the access control policy for a contentitem resource. A `NOT_FOUND`
+ * error is returned if the resource does not exist. An empty policy is
+ * returned if the resource exists but does not have a policy set on it.
+ *
+ * Caller must have Google IAM `dataplex.content.getIamPolicy` permission
+ * on the resource.
  *
  * @param string $resource REQUIRED: The resource for which the policy is being requested.
  *                         See the operation documentation for the appropriate value for this field.

diff --git a/Dataplex/samples/V1/ContentServiceClient/set_iam_policy.php b/Dataplex/samples/V1/ContentServiceClient/set_iam_policy.php
@@ -28,11 +28,11 @@
 use Google\Cloud\Iam\V1\Policy;
 
 /**
- * Sets the access control policy on the specified resource. Replaces
-any existing policy.
-
-Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`
-errors.
+ * Sets the access control policy on the specified contentitem resource.
+ * Replaces any existing policy.
+ *
+ * Caller must have Google IAM `dataplex.content.setIamPolicy` permission
+ * on the resource.
  *
  * @param string $resource REQUIRED: The resource for which the policy is being specified.
  *                         See the operation documentation for the appropriate value for this field.

diff --git a/Dataplex/samples/V1/ContentServiceClient/test_iam_permissions.php b/Dataplex/samples/V1/ContentServiceClient/test_iam_permissions.php
@@ -28,13 +28,16 @@
 use Google\Cloud\Iam\V1\TestIamPermissionsResponse;
 
 /**
- * Returns permissions that a caller has on the specified resource. If the
-resource does not exist, this will return an empty set of
-permissions, not a `NOT_FOUND` error.
-
-Note: This operation is designed to be used for building
-permission-aware UIs and command-line tools, not for authorization
-checking. This operation may "fail open" without warning.
+ * Returns the caller's permissions on a resource.
+ * If the resource does not exist, an empty set of
+ * permissions is returned (a `NOT_FOUND` error is not returned).
+ *
+ * A caller is not required to have Google IAM permission to make this
+ * request.
+ *
+ * Note: This operation is designed to be used for building permission-aware
+ * UIs and command-line tools, not for authorization checking. This operation
+ * may "fail open" without warning.
  *
  * @param string $resource           REQUIRED: The resource for which the policy detail is being requested.
  *                                   See the operation documentation for the appropriate value for this field.

diff --git a/Dataplex/samples/V1/DataScanServiceClient/create_data_scan.php b/Dataplex/samples/V1/DataScanServiceClient/create_data_scan.php
@@ -31,14 +31,15 @@
 use Google\Rpc\Status;
 
 /**
- * Creates a dataScan resource.
+ * Creates a DataScan resource.
  *
  * @param string $formattedParent The resource name of the parent location:
- *                                projects/{project}/locations/{location_id}
- *                                where `{project}` refers to a project_id or project_number and
+ *                                `projects/{project}/locations/{location_id}`
+ *                                where `project` refers to a *project_id* or *project_number* and
  *                                `location_id` refers to a GCP region. Please see
  *                                {@see DataScanServiceClient::locationName()} for help formatting this field.
  * @param string $dataScanId      DataScan identifier.
+ *
  *                                * Must contain only lowercase letters, numbers and hyphens.
  *                                * Must start with a letter.
  *                                * Must end with a number or a letter.

diff --git a/Dataplex/samples/V1/DataScanServiceClient/delete_data_scan.php b/Dataplex/samples/V1/DataScanServiceClient/delete_data_scan.php
@@ -29,11 +29,11 @@
 use Google\Rpc\Status;
 
 /**
- * Delete the dataScan resource.
+ * Deletes a DataScan resource.
  *
  * @param string $formattedName The resource name of the dataScan:
- *                              projects/{project}/locations/{location_id}/dataScans/{data_scan_id}
- *                              where `{project}` refers to a project_id or project_number and
+ *                              `projects/{project}/locations/{location_id}/dataScans/{data_scan_id}`
+ *                              where `project` refers to a *project_id* or *project_number* and
  *                              `location_id` refers to a GCP region. Please see
  *                              {@see DataScanServiceClient::dataScanName()} for help formatting this field.
  */

diff --git a/Dataplex/samples/V1/DataScanServiceClient/get_data_scan.php b/Dataplex/samples/V1/DataScanServiceClient/get_data_scan.php
@@ -28,11 +28,11 @@
 use Google\Cloud\Dataplex\V1\DataScanServiceClient;
 
 /**
- * Get dataScan resource.
+ * Gets a DataScan resource.
  *
  * @param string $formattedName The resource name of the dataScan:
- *                              projects/{project}/locations/{location_id}/dataScans/{data_scan_id}
- *                              where `{project}` refers to a project_id or project_number and
+ *                              `projects/{project}/locations/{location_id}/dataScans/{data_scan_id}`
+ *                              where `project` refers to a *project_id* or *project_number* and
  *                              `location_id` refers to a GCP region. Please see
  *                              {@see DataScanServiceClient::dataScanName()} for help formatting this field.
  */

diff --git a/Dataplex/samples/V1/DataScanServiceClient/get_data_scan_job.php b/Dataplex/samples/V1/DataScanServiceClient/get_data_scan_job.php
@@ -28,11 +28,11 @@
 use Google\Cloud\Dataplex\V1\DataScanServiceClient;
 
 /**
- * Get DataScanJob resource.
+ * Gets a DataScanJob resource.
  *
  * @param string $formattedName The resource name of the DataScanJob:
- *                              projects/{project}/locations/{location_id}/dataScans/{data_scan_id}/dataScanJobs/{data_scan_job_id}
- *                              where `{project}` refers to a project_id or project_number and
+ *                              `projects/{project}/locations/{location_id}/dataScans/{data_scan_id}/dataScanJobs/{data_scan_job_id}`
+ *                              where `project` refers to a *project_id* or *project_number* and
  *                              `location_id` refers to a GCP region. Please see
  *                              {@see DataScanServiceClient::dataScanJobName()} for help formatting this field.
  */

diff --git a/Dataplex/samples/V1/DataScanServiceClient/list_data_scan_jobs.php b/Dataplex/samples/V1/DataScanServiceClient/list_data_scan_jobs.php
@@ -29,11 +29,11 @@
 use Google\Cloud\Dataplex\V1\DataScanServiceClient;
 
 /**
- * Lists DataScanJobs under the given dataScan.
+ * Lists DataScanJobs under the given DataScan.
  *
  * @param string $formattedParent The resource name of the parent environment:
- *                                projects/{project}/locations/{location_id}/dataScans/{data_scan_id}
- *                                where `{project}` refers to a project_id or project_number and
+ *                                `projects/{project}/locations/{location_id}/dataScans/{data_scan_id}`
+ *                                where `project` refers to a *project_id* or *project_number* and
  *                                `location_id` refers to a GCP region. Please see
  *                                {@see DataScanServiceClient::dataScanName()} for help formatting this field.
  */

diff --git a/Dataplex/samples/V1/DataScanServiceClient/list_data_scans.php b/Dataplex/samples/V1/DataScanServiceClient/list_data_scans.php
@@ -29,10 +29,11 @@
 use Google\Cloud\Dataplex\V1\DataScanServiceClient;
 
 /**
- * Lists dataScans.
+ * Lists DataScans.
  *
- * @param string $formattedParent projects/{project}/locations/{location_id}
- *                                where `{project}` refers to a project_id or project_number and
+ * @param string $formattedParent The resource name of the parent location:
+ *                                `projects/{project}/locations/{location_id}`
+ *                                where `project` refers to a *project_id* or *project_number* and
  *                                `location_id` refers to a GCP region. Please see
  *                                {@see DataScanServiceClient::locationName()} for help formatting this field.
  */

diff --git a/Dataplex/samples/V1/DataScanServiceClient/run_data_scan.php b/Dataplex/samples/V1/DataScanServiceClient/run_data_scan.php
@@ -28,13 +28,14 @@
 use Google\Cloud\Dataplex\V1\RunDataScanResponse;
 
 /**
- * Run an on demand execution of a DataScan.
+ * Runs an on-demand execution of a DataScan
  *
  * @param string $formattedName The resource name of the DataScan:
- *                              projects/{project}/locations/{location_id}/dataScans/{data_scan_id}.
- *                              where `{project}` refers to a project_id or project_number and
+ *                              `projects/{project}/locations/{location_id}/dataScans/{data_scan_id}`.
+ *                              where `project` refers to a *project_id* or *project_number* and
  *                              `location_id` refers to a GCP region.
- *                              Only on-demand DataScans are allowed. Please see
+ *
+ *                              Only **OnDemand** data scans are allowed. Please see
  *                              {@see DataScanServiceClient::dataScanName()} for help formatting this field.
  */
 function run_data_scan_sample(string $formattedName): void

diff --git a/Dataplex/samples/V1/DataScanServiceClient/update_data_scan.php b/Dataplex/samples/V1/DataScanServiceClient/update_data_scan.php
@@ -32,7 +32,7 @@
 use Google\Rpc\Status;
 
 /**
- * Update the dataScan resource.
+ * Updates a DataScan resource.
  *
  * This sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work:

diff --git a/Dataplex/src/V1/CreateDataScanRequest.php b/Dataplex/src/V1/CreateDataScanRequest.php
diff --git a/Dataplex/src/V1/DataScan.php b/Dataplex/src/V1/DataScan.php