From d8a363969e1d19e36f6a5c57ec2d439300c95082 Mon Sep 17 00:00:00 2001 From: "gcf-owl-bot[bot]" <78513119+gcf-owl-bot[bot]@users.noreply.github.com> Date: Wed, 13 Sep 2023 14:04:26 -0700 Subject: [PATCH] docs: Minor formatting (#520) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs: Minor formatting chore: Update gapic-generator-python to v1.11.5 build: Update rules_python to 0.24.0 PiperOrigin-RevId: 563436317 Source-Link: https://github.com/googleapis/googleapis/commit/42fd37b18d706f6f51f52f209973b3b2c28f509a Source-Link: https://github.com/googleapis/googleapis-gen/commit/280264ca02fb9316b4237a96d0af1a2343a81a56 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMjgwMjY0Y2EwMmZiOTMxNmI0MjM3YTk2ZDBhZjFhMjM0M2E4MWE1NiJ9 * 🦉 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 --- google/cloud/dlp_v2/services/dlp_service/async_client.py | 5 +++++ google/cloud/dlp_v2/services/dlp_service/client.py | 5 +++++ .../cloud/dlp_v2/services/dlp_service/transports/grpc.py | 4 ++++ .../dlp_v2/services/dlp_service/transports/grpc_asyncio.py | 4 ++++ .../cloud/dlp_v2/services/dlp_service/transports/rest.py | 1 + google/cloud/dlp_v2/types/dlp.py | 7 +++++++ google/cloud/dlp_v2/types/storage.py | 2 ++ 7 files changed, 28 insertions(+) diff --git a/google/cloud/dlp_v2/services/dlp_service/async_client.py b/google/cloud/dlp_v2/services/dlp_service/async_client.py index 3a8997e..d9e3930 100644 --- a/google/cloud/dlp_v2/services/dlp_service/async_client.py +++ b/google/cloud/dlp_v2/services/dlp_service/async_client.py @@ -63,6 +63,7 @@ class DlpServiceAsyncClient: The service also includes methods for sensitive data redaction and scheduling of data scans on Google Cloud Platform based data sets. + To learn more about concepts and find how-to guides see https://cloud.google.com/dlp/docs/. """ @@ -251,10 +252,12 @@ async def inspect_content( r"""Finds potentially sensitive info in content. This method has limits on input size, processing time, and output size. + When no InfoTypes or CustomInfoTypes are specified in this request, the system will automatically choose what detectors to run. By default this may be all types, but may change over time as detectors are updated. + For how to guides, see https://cloud.google.com/dlp/docs/inspecting-images and https://cloud.google.com/dlp/docs/inspecting-text, @@ -2582,6 +2585,7 @@ async def sample_list_job_triggers(): Returns: google.cloud.dlp_v2.services.dlp_service.pagers.ListJobTriggersAsyncPager: Response message for ListJobTriggers. + Iterating over this object will yield results and resolve additional pages automatically. @@ -2849,6 +2853,7 @@ async def create_dlp_job( https://cloud.google.com/dlp/docs/inspecting-storage and https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. + When no InfoTypes or CustomInfoTypes are specified in inspect jobs, the system will automatically choose what detectors to run. By default this may be all types, but diff --git a/google/cloud/dlp_v2/services/dlp_service/client.py b/google/cloud/dlp_v2/services/dlp_service/client.py index 3c0311a..80b10cb 100644 --- a/google/cloud/dlp_v2/services/dlp_service/client.py +++ b/google/cloud/dlp_v2/services/dlp_service/client.py @@ -103,6 +103,7 @@ class DlpServiceClient(metaclass=DlpServiceClientMeta): The service also includes methods for sensitive data redaction and scheduling of data scans on Google Cloud Platform based data sets. + To learn more about concepts and find how-to guides see https://cloud.google.com/dlp/docs/. """ @@ -579,10 +580,12 @@ def inspect_content( r"""Finds potentially sensitive info in content. This method has limits on input size, processing time, and output size. + When no InfoTypes or CustomInfoTypes are specified in this request, the system will automatically choose what detectors to run. By default this may be all types, but may change over time as detectors are updated. + For how to guides, see https://cloud.google.com/dlp/docs/inspecting-images and https://cloud.google.com/dlp/docs/inspecting-text, @@ -2804,6 +2807,7 @@ def sample_list_job_triggers(): Returns: google.cloud.dlp_v2.services.dlp_service.pagers.ListJobTriggersPager: Response message for ListJobTriggers. + Iterating over this object will yield results and resolve additional pages automatically. @@ -3052,6 +3056,7 @@ def create_dlp_job( https://cloud.google.com/dlp/docs/inspecting-storage and https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. + When no InfoTypes or CustomInfoTypes are specified in inspect jobs, the system will automatically choose what detectors to run. By default this may be all types, but diff --git a/google/cloud/dlp_v2/services/dlp_service/transports/grpc.py b/google/cloud/dlp_v2/services/dlp_service/transports/grpc.py index ddc699e..ad86d1a 100644 --- a/google/cloud/dlp_v2/services/dlp_service/transports/grpc.py +++ b/google/cloud/dlp_v2/services/dlp_service/transports/grpc.py @@ -40,6 +40,7 @@ class DlpServiceGrpcTransport(DlpServiceTransport): The service also includes methods for sensitive data redaction and scheduling of data scans on Google Cloud Platform based data sets. + To learn more about concepts and find how-to guides see https://cloud.google.com/dlp/docs/. @@ -248,10 +249,12 @@ def inspect_content( Finds potentially sensitive info in content. This method has limits on input size, processing time, and output size. + When no InfoTypes or CustomInfoTypes are specified in this request, the system will automatically choose what detectors to run. By default this may be all types, but may change over time as detectors are updated. + For how to guides, see https://cloud.google.com/dlp/docs/inspecting-images and https://cloud.google.com/dlp/docs/inspecting-text, @@ -901,6 +904,7 @@ def create_dlp_job(self) -> Callable[[dlp.CreateDlpJobRequest], dlp.DlpJob]: https://cloud.google.com/dlp/docs/inspecting-storage and https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. + When no InfoTypes or CustomInfoTypes are specified in inspect jobs, the system will automatically choose what detectors to run. By default this may be all types, but diff --git a/google/cloud/dlp_v2/services/dlp_service/transports/grpc_asyncio.py b/google/cloud/dlp_v2/services/dlp_service/transports/grpc_asyncio.py index 3832e40..3bc3182 100644 --- a/google/cloud/dlp_v2/services/dlp_service/transports/grpc_asyncio.py +++ b/google/cloud/dlp_v2/services/dlp_service/transports/grpc_asyncio.py @@ -41,6 +41,7 @@ class DlpServiceGrpcAsyncIOTransport(DlpServiceTransport): The service also includes methods for sensitive data redaction and scheduling of data scans on Google Cloud Platform based data sets. + To learn more about concepts and find how-to guides see https://cloud.google.com/dlp/docs/. @@ -251,10 +252,12 @@ def inspect_content( Finds potentially sensitive info in content. This method has limits on input size, processing time, and output size. + When no InfoTypes or CustomInfoTypes are specified in this request, the system will automatically choose what detectors to run. By default this may be all types, but may change over time as detectors are updated. + For how to guides, see https://cloud.google.com/dlp/docs/inspecting-images and https://cloud.google.com/dlp/docs/inspecting-text, @@ -923,6 +926,7 @@ def create_dlp_job( https://cloud.google.com/dlp/docs/inspecting-storage and https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. + When no InfoTypes or CustomInfoTypes are specified in inspect jobs, the system will automatically choose what detectors to run. By default this may be all types, but diff --git a/google/cloud/dlp_v2/services/dlp_service/transports/rest.py b/google/cloud/dlp_v2/services/dlp_service/transports/rest.py index 12d0f18..17c18c5 100644 --- a/google/cloud/dlp_v2/services/dlp_service/transports/rest.py +++ b/google/cloud/dlp_v2/services/dlp_service/transports/rest.py @@ -994,6 +994,7 @@ class DlpServiceRestTransport(DlpServiceTransport): The service also includes methods for sensitive data redaction and scheduling of data scans on Google Cloud Platform based data sets. + To learn more about concepts and find how-to guides see https://cloud.google.com/dlp/docs/. diff --git a/google/cloud/dlp_v2/types/dlp.py b/google/cloud/dlp_v2/types/dlp.py index bf261ce..c5a3745 100644 --- a/google/cloud/dlp_v2/types/dlp.py +++ b/google/cloud/dlp_v2/types/dlp.py @@ -345,6 +345,7 @@ class MatchingType(proto.Enum): Invalid. MATCHING_TYPE_FULL_MATCH (1): Full match. + - Dictionary: join of Dictionary results matched complete finding quote - Regex: all regex matches fill a finding quote @@ -353,6 +354,7 @@ class MatchingType(proto.Enum): info types findings MATCHING_TYPE_PARTIAL_MATCH (2): Partial match. + - Dictionary: at least one of the tokens in the finding matches - Regex: substring of the finding matches @@ -360,6 +362,7 @@ class MatchingType(proto.Enum): info types findings MATCHING_TYPE_INVERSE_MATCH (3): Inverse match. + - Dictionary: no tokens in the finding match the dictionary - Regex: finding doesn't match the regex @@ -5035,6 +5038,7 @@ class DateShiftConfig(proto.Message): range (inclusive ends). Negative means shift to earlier in time. Must not be more than 365250 days (1000 years) each direction. + For example, 3 means shift date to at most 3 days into the future. lower_bound_days (int): @@ -5737,9 +5741,11 @@ class Schedule(proto.Message): With this option a job is started on a regular periodic basis. For example: every day (86400 seconds). + A scheduled start time will be skipped if the previous execution has not ended when its scheduled time occurs. + This value must be set to a time duration greater than or equal to 1 day and can be no longer than 60 days. @@ -6224,6 +6230,7 @@ class Deidentify(proto.Message): bucket must be different from the input bucket. De-identified files will overwrite files in the output path. + Form of: gs://bucket/folder/ or gs://bucket This field is a member of `oneof`_ ``output``. diff --git a/google/cloud/dlp_v2/types/storage.py b/google/cloud/dlp_v2/types/storage.py index ad668ae..c844d07 100644 --- a/google/cloud/dlp_v2/types/storage.py +++ b/google/cloud/dlp_v2/types/storage.py @@ -633,6 +633,7 @@ class PartitionId(proto.Message): A partition ID identifies a grouping of entities. The grouping is always by project and namespace, however the namespace ID may be empty. + A partition ID contains several dimensions: project ID and namespace ID. @@ -1290,6 +1291,7 @@ class Key(proto.Message): class PathElement(proto.Message): r"""A (kind, ID/name) pair used to construct a key path. + If either name or ID is set, the element is complete. If neither is set, the element is incomplete.