@google-cloud/dlp 3.2.0 → 3.4.0

package/build/protos/google/privacy/dlp/v2/storage.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// 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.
@@ -18,7 +18,6 @@ package google.privacy.dlp.v2;
 
 import "google/api/resource.proto";
 import "google/protobuf/timestamp.proto";
-import "google/api/annotations.proto";
 
 option csharp_namespace = "Google.Cloud.Dlp.V2";
 option go_package = "google.golang.org/genproto/googleapis/privacy/dlp/v2;dlp";
@@ -36,18 +35,9 @@ message InfoType {
   // a built-in type.  When sending Cloud DLP results to Data Catalog, infoType
   // names should conform to the pattern `[A-Za-z0-9$-_]{1,64}`.
   string name = 1;
-}
-
-// A reference to a StoredInfoType to use with scanning.
-message StoredType {
-  // Resource name of the requested `StoredInfoType`, for example
-  // `organizations/433245324/storedInfoTypes/432452342` or
-  // `projects/project-id/storedInfoTypes/432452342`.
-  string name = 1;
 
-  // Timestamp indicating when the version of the `StoredInfoType` used for
-  // inspection was created. Output-only field, populated by the system.
-  google.protobuf.Timestamp create_time = 2;
+  // Optional version name for this InfoType.
+  string version = 2;
 }
 
 // Categorization of results based on how likely they are to represent a match,
@@ -70,6 +60,18 @@ enum Likelihood {
   VERY_LIKELY = 5;
 }
 
+// A reference to a StoredInfoType to use with scanning.
+message StoredType {
+  // Resource name of the requested `StoredInfoType`, for example
+  // `organizations/433245324/storedInfoTypes/432452342` or
+  // `projects/project-id/storedInfoTypes/432452342`.
+  string name = 1;
+
+  // Timestamp indicating when the version of the `StoredInfoType` used for
+  // inspection was created. Output-only field, populated by the system.
+  google.protobuf.Timestamp create_time = 2;
+}
+
 // Custom information type provided by the user. Used to find domain-specific
 // sensitive information configurable to the data in question.
 message CustomInfoType {
@@ -283,6 +285,67 @@ message DatastoreOptions {
   KindExpression kind = 2;
 }
 
+// Definitions of file type groups to scan. New types will be added to this
+// list.
+enum FileType {
+  // Includes all files.
+  FILE_TYPE_UNSPECIFIED = 0;
+
+  // Includes all file extensions not covered by another entry. Binary
+  // scanning attempts to convert the content of the file to utf_8 to scan
+  // the file.
+  // If you wish to avoid this fall back, specify one or more of the other
+  // FileType's in your storage scan.
+  BINARY_FILE = 1;
+
+  // Included file extensions:
+  //   asc,asp, aspx, brf, c, cc,cfm, cgi, cpp, csv, cxx, c++, cs, css, dart,
+  //   dat, dot, eml,, epbub, ged, go, h, hh, hpp, hxx, h++, hs, html, htm,
+  //   mkd, markdown, m, ml, mli, perl, pl, plist, pm, php, phtml, pht,
+  //   properties, py, pyw, rb, rbw, rs, rss,  rc, scala, sh, sql, swift, tex,
+  //   shtml, shtm, xhtml, lhs, ics, ini, java, js, json, kix, kml, ocaml, md,
+  //   txt, text, tsv, vb, vcard, vcs, wml, xcodeproj, xml, xsl, xsd, yml, yaml.
+  TEXT_FILE = 2;
+
+  // Included file extensions:
+  //   bmp, gif, jpg, jpeg, jpe, png.
+  // bytes_limit_per_file has no effect on image files.
+  // Image inspection is restricted to 'global', 'us', 'asia', and 'europe'.
+  IMAGE = 3;
+
+  // Word files >30 MB will be scanned as binary files.
+  // Included file extensions:
+  //   docx, dotx, docm, dotm
+  WORD = 5;
+
+  // PDF files >30 MB will be scanned as binary files.
+  // Included file extensions:
+  //   pdf
+  PDF = 6;
+
+  // Included file extensions:
+  //   avro
+  AVRO = 7;
+
+  // Included file extensions:
+  //   csv
+  CSV = 8;
+
+  // Included file extensions:
+  //   tsv
+  TSV = 9;
+
+  // Powerpoint files >30 MB will be scanned as binary files.
+  // Included file extensions:
+  //   pptx, pptm, potx, potm, pot
+  POWERPOINT = 11;
+
+  // Excel files >30 MB will be scanned as binary files.
+  // Included file extensions:
+  //   xlsx, xlsm, xltx, xltm
+  EXCEL = 12;
+}
+
 // Message representing a set of files in a Cloud Storage bucket. Regular
 // expressions are used to allow fine-grained control over which files in the
 // bucket to include.
@@ -382,12 +445,14 @@ message CloudStorageOptions {
   // Max number of bytes to scan from a file. If a scanned file's size is bigger
   // than this value then the rest of the bytes are omitted. Only one
   // of bytes_limit_per_file and bytes_limit_per_file_percent can be specified.
+  // Cannot be set if de-identification is requested.
   int64 bytes_limit_per_file = 4;
 
   // Max percentage of bytes to scan from a file. The rest are omitted. The
   // number of bytes scanned is rounded down. Must be between 0 and 100,
   // inclusively. Both 0 and 100 means no limit. Defaults to 0. Only one
   // of bytes_limit_per_file and bytes_limit_per_file_percent can be specified.
+  // Cannot be set if de-identification is requested.
   int32 bytes_limit_per_file_percent = 8;
 
   // List of file type groups to include in the scan.
@@ -466,6 +531,9 @@ message BigQueryOptions {
   // References to fields excluded from scanning. This allows you to skip
   // inspection of entire columns which you know have no findings.
   repeated FieldId excluded_fields = 5;
+
+  // Limit scanning only to these fields.
+  repeated FieldId included_fields = 7;
 }
 
 // Shared message indicating Cloud storage type.
@@ -518,65 +586,12 @@ message StorageConfig {
     BigQueryOptions big_query_options = 4;
 
     // Hybrid inspection options.
-    // Early access feature is in a pre-release state and might change or have
-    // limited support. For more information, see
-    // https://cloud.google.com/products#product-launch-stages.
     HybridOptions hybrid_options = 9;
   }
 
   TimespanConfig timespan_config = 6;
 }
 
-// Definitions of file type groups to scan. New types will be added to this
-// list.
-enum FileType {
-  // Includes all files.
-  FILE_TYPE_UNSPECIFIED = 0;
-
-  // Includes all file extensions not covered by another entry. Binary
-  // scanning attempts to convert the content of the file to utf_8 to scan
-  // the file.
-  // If you wish to avoid this fall back, specify one or more of the other
-  // FileType's in your storage scan.
-  BINARY_FILE = 1;
-
-  // Included file extensions:
-  //   asc, brf, c, cc, cpp, csv, cxx, c++, cs, css, dart, eml, go, h, hh, hpp,
-  //   hxx, h++, hs, html, htm, shtml, shtm, xhtml, lhs, ini, java, js, json,
-  //   ocaml, md, mkd, markdown, m, ml, mli, pl, pm, php, phtml, pht, py, pyw,
-  //   rb, rbw, rs, rc, scala, sh, sql, tex, txt, text, tsv, vcard, vcs, wml,
-  //   xml, xsl, xsd, yml, yaml.
-  TEXT_FILE = 2;
-
-  // Included file extensions:
-  //   bmp, gif, jpg, jpeg, jpe, png.
-  // bytes_limit_per_file has no effect on image files.
-  // Image inspection is restricted to 'global', 'us', 'asia', and 'europe'.
-  IMAGE = 3;
-
-  // Word files >30 MB will be scanned as binary files.
-  // Included file extensions:
-  //   docx, dotx, docm, dotm
-  WORD = 5;
-
-  // PDF files >30 MB will be scanned as binary files.
-  // Included file extensions:
-  //   pdf
-  PDF = 6;
-
-  // Included file extensions:
-  //   avro
-  AVRO = 7;
-
-  // Included file extensions:
-  //   csv
-  CSV = 8;
-
-  // Included file extensions:
-  //   tsv
-  TSV = 9;
-}
-
 // Configuration to control jobs where the content being inspected is outside
 // of Google Cloud Platform.
 message HybridOptions {