feat: [google-cloud-dataplex] A new field force is added to message .google.cloud.dataplex.v1.DeleteDataScanRequest (googleapis#13387)

- [ ] Regenerate this pull request now.

BEGIN_COMMIT_OVERRIDE
feat: A new field `force` is added to message
`.google.cloud.dataplex.v1.DeleteDataScanRequest`
docs: miscellaneous doc updates
END_COMMIT_OVERRIDE



PiperOrigin-RevId: 709139776

Source-Link:
googleapis/googleapis@9e96614

Source-Link:
https://github.com/googleapis/googleapis-gen/commit/ef1103d3dc3d293694e12fc83d9aa116196160d4
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRhdGFwbGV4Ly5Pd2xCb3QueWFtbCIsImgiOiJlZjExMDNkM2RjM2QyOTM2OTRlMTJmYzgzZDlhYTExNjE5NjE2MGQ0In0=

---------

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

Author: gcf-owl-bot[bot]

packages/google-cloud-dataplex/google/cloud/dataplex/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "2.5.0"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-cloud-dataplex/google/cloud/dataplex_v1/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "2.5.0"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-cloud-dataplex/google/cloud/dataplex_v1/services/catalog_service/async_client.py

@@ -2976,8 +2976,10 @@ async def sample_search_entries():
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
             query (:class:`str`):
-                Required. The query against which
-                entries in scope should be matched.
+                Required. The query against which entries in scope
+                should be matched. The query syntax is defined in
+                `Search syntax for Dataplex
+                Catalog <https://cloud.google.com/dataplex/docs/search-syntax>`__.
 
                 This corresponds to the ``query`` field
                 on the ``request`` instance; if ``request`` is provided, this

packages/google-cloud-dataplex/google/cloud/dataplex_v1/services/catalog_service/client.py

@@ -3394,8 +3394,10 @@ def sample_search_entries():
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
             query (str):
-                Required. The query against which
-                entries in scope should be matched.
+                Required. The query against which entries in scope
+                should be matched. The query syntax is defined in
+                `Search syntax for Dataplex
+                Catalog <https://cloud.google.com/dataplex/docs/search-syntax>`__.
 
                 This corresponds to the ``query`` field
                 on the ``request`` instance; if ``request`` is provided, this

packages/google-cloud-dataplex/google/cloud/dataplex_v1/services/data_scan_service/async_client.py

@@ -542,7 +542,7 @@ async def sample_update_data_scan():
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
             update_mask (:class:`google.protobuf.field_mask_pb2.FieldMask`):
-                Required. Mask of fields to update.
+                Optional. Mask of fields to update.
                 This corresponds to the ``update_mask`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.

packages/google-cloud-dataplex/google/cloud/dataplex_v1/services/data_scan_service/client.py

@@ -1012,7 +1012,7 @@ def sample_update_data_scan():
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
             update_mask (google.protobuf.field_mask_pb2.FieldMask):
-                Required. Mask of fields to update.
+                Optional. Mask of fields to update.
                 This corresponds to the ``update_mask`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.

packages/google-cloud-dataplex/google/cloud/dataplex_v1/types/catalog.py

@@ -1625,7 +1625,7 @@ class UpdateEntryRequest(proto.Message):
                an aspect to a field that is specified by the ``schema``
                aspect, the path should have the format
                ``Schema.<field_name>``.
-            -  ``<aspect_type_reference>*`` - matches aspects of the
+            -  ``<aspect_type_reference>@*`` - matches aspects of the
                given type for all paths.
             -  ``*@path`` - matches aspects of all types on the given
                path.
@@ -1860,8 +1860,10 @@ class SearchEntriesRequest(proto.Message):
             attributed in the following form:
             ``projects/{project}/locations/{location}``.
         query (str):
-            Required. The query against which entries in
-            scope should be matched.
+            Required. The query against which entries in scope should be
+            matched. The query syntax is defined in `Search syntax for
+            Dataplex
+            Catalog <https://cloud.google.com/dataplex/docs/search-syntax>`__.
         page_size (int):
             Optional. Number of results in the search page. If <=0, then
             defaults to 10. Max limit for page_size is 1000. Throws an
@@ -1871,7 +1873,12 @@ class SearchEntriesRequest(proto.Message):
             ``SearchEntries`` call. Provide this to retrieve the
             subsequent page.
         order_by (str):
-            Optional. Specifies the ordering of results.
+            Optional. Specifies the ordering of results. Supported
+            values are:
+
+            -  ``relevance`` (default)
+            -  ``last_modified_timestamp``
+            -  ``last_modified_timestamp asc``
         scope (str):
             Optional. The scope under which the search should be
             operating. It must either be ``organizations/<org_id>`` or
@@ -2035,12 +2042,12 @@ class ImportItem(proto.Message):
                the entry.
             -  ``{aspect_type_reference}@{path}``: matches aspects that
                belong to the specified aspect type and path.
-            -  ``{aspect_type_reference}@*``: matches aspects that
-               belong to the specified aspect type for all paths.
-
-            Replace ``{aspect_type_reference}`` with a reference to the
-            aspect type, in the format
-            ``{project_id_or_number}.{location_id}.{aspect_type_id}``.
+            -  ``<aspect_type_reference>@*`` : matches aspects of the
+               given type for all paths.
+            -  ``*@path`` : matches aspects of all types on the given
+               path. Replace ``{aspect_type_reference}`` with a
+               reference to the aspect type, in the format
+               ``{project_id_or_number}.{location_id}.{aspect_type_id}``.
 
             If you leave this field empty, it is treated as specifying
             exactly those aspects that are present within the specified

packages/google-cloud-dataplex/google/cloud/dataplex_v1/types/datascans.py

@@ -123,7 +123,7 @@ class UpdateDataScanRequest(proto.Message):
 
             Only fields specified in ``update_mask`` are updated.
         update_mask (google.protobuf.field_mask_pb2.FieldMask):
-            Required. Mask of fields to update.
+            Optional. Mask of fields to update.
         validate_only (bool):
             Optional. Only validate the request, but do not perform
             mutations. The default is ``false``.
@@ -154,12 +154,21 @@ class DeleteDataScanRequest(proto.Message):
             ``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.
+        force (bool):
+            Optional. If set to true, any child resources
+            of this data scan will also be deleted.
+            (Otherwise, the request will only work if the
+            data scan has no child resources.)
     """
 
     name: str = proto.Field(
         proto.STRING,
         number=1,
     )
+    force: bool = proto.Field(
+        proto.BOOL,
+        number=2,
+    )
 
 
 class GetDataScanRequest(proto.Message):
@@ -506,8 +515,8 @@ class DataScan(proto.Message):
 
     Attributes:
         name (str):
-            Output only. The relative resource name of the scan, of the
-            form:
+            Output only. Identifier. The relative resource name of the
+            scan, of the form:
             ``projects/{project}/locations/{location_id}/dataScans/{datascan_id}``,
             where ``project`` refers to a *project_id* or
             *project_number* and ``location_id`` refers to a GCP region.
@@ -615,9 +624,11 @@ class ExecutionStatus(proto.Message):
 
         Attributes:
             latest_job_start_time (google.protobuf.timestamp_pb2.Timestamp):
-                The time when the latest DataScanJob started.
+                Optional. The time when the latest
+                DataScanJob started.
             latest_job_end_time (google.protobuf.timestamp_pb2.Timestamp):
-                The time when the latest DataScanJob ended.
+                Optional. The time when the latest
+                DataScanJob ended.
             latest_job_create_time (google.protobuf.timestamp_pb2.Timestamp):
                 Optional. The time when the DataScanJob
                 execution was created.
@@ -745,8 +756,8 @@ class DataScanJob(proto.Message):
 
     Attributes:
         name (str):
-            Output only. The relative resource name of the DataScanJob,
-            of the form:
+            Output only. Identifier. The relative resource name of the
+            DataScanJob, of the form:
             ``projects/{project}/locations/{location_id}/dataScans/{datascan_id}/jobs/{job_id}``,
             where ``project`` refers to a *project_id* or
             *project_number* and ``location_id`` refers to a GCP region.

packages/google-cloud-dataplex/samples/generated_samples/snippet_metadata_google.cloud.dataplex.v1.json

@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-dataplex",
-    "version": "2.5.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {

packages/google-cloud-dataplex/scripts/fixup_dataplex_v1_keywords.py

@@ -63,7 +63,7 @@ class dataplexCallTransformer(cst.CSTTransformer):
         'delete_content': ('name', ),
         'delete_data_attribute': ('name', 'etag', ),
         'delete_data_attribute_binding': ('name', 'etag', ),
-        'delete_data_scan': ('name', ),
+        'delete_data_scan': ('name', 'force', ),
         'delete_data_taxonomy': ('name', 'etag', ),
         'delete_entity': ('name', 'etag', ),
         'delete_entry': ('name', ),