docs: update generated docs (#981)
diff --git a/docs/dyn/dlp_v2.projects.image.html b/docs/dyn/dlp_v2.projects.image.html
index 204df0f..0e86263 100644
--- a/docs/dyn/dlp_v2.projects.image.html
+++ b/docs/dyn/dlp_v2.projects.image.html
@@ -90,158 +90,25 @@
be all types, but may change over time as detectors are updated.
Args:
- parent: string, The parent resource name, for example projects/my-project-id. (required)
+ parent: string, The parent resource name.
+- Format:projects/[PROJECT-ID]
+- Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] (required)
body: object, The request body.
The object takes the form of:
{ # Request to search for potentially sensitive info in an image and redact it
# by covering it with a colored rectangle.
- "imageRedactionConfigs": [ # The configuration for specifying what content to redact from images.
- { # Configuration for determining how redaction of images should occur.
- "infoType": { # Type of information detected by the API. # Only one per info_type should be provided per request. If not
- # specified, and redact_all_text is false, the DLP API will redact all
- # text that it matches against all info_types that are found, but not
- # specified in another ImageRedactionConfig.
- "name": "A String", # Name of the information type. Either a name of your choosing when
- # creating a CustomInfoType, or one of the names listed
- # at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
- # a built-in type. InfoType names should conform to the pattern
- # `[a-zA-Z0-9_]{1,64}`.
- },
- "redactionColor": { # Represents a color in the RGB color space. # The color to use when redacting content from an image. If not specified,
- # the default is black.
- "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
- "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
- "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
- },
- "redactAllText": True or False, # If true, all text found in the image, regardless whether it matches an
- # info_type, is redacted. Only one should be provided.
- },
- ],
- "locationId": "A String", # The geographic location to process the request. Reserved for future
- # extensions.
- # Location is restricted to 'global', 'us', 'asia', and 'europe'.
"byteItem": { # Container for bytes to inspect or redact. # The content must be PNG, JPEG, SVG or BMP.
"data": "A String", # Content data to inspect or redact.
"type": "A String", # The type of data stored in the bytes string. Default will be TEXT_UTF8.
},
- "includeFindings": True or False, # Whether the response should include findings along with the redacted
- # image.
"inspectConfig": { # Configuration description of the scanning process. # Configuration for the inspector.
# When used with redactContent only info_types and min_likelihood are currently
# used.
- "minLikelihood": "A String", # Only returns findings equal or above this threshold. The default is
- # POSSIBLE.
- # See https://cloud.google.com/dlp/docs/likelihood to learn more.
- "contentOptions": [ # List of options defining data content to scan.
- # If empty, text, images, and other content will be included.
- "A String",
- ],
- "infoTypes": [ # Restricts what info_types to look for. The values must correspond to
- # InfoType values returned by ListInfoTypes or listed at
- # https://cloud.google.com/dlp/docs/infotypes-reference.
- #
- # When no InfoTypes or CustomInfoTypes are specified in a request, the
- # system may automatically choose what detectors to run. By default this may
- # be all types, but may change over time as detectors are updated.
- #
- # If you need precise control and predictability as to what detectors are
- # run you should specify specific InfoTypes listed in the reference,
- # otherwise a default list will be used, which may change over time.
- { # Type of information detected by the API.
- "name": "A String", # Name of the information type. Either a name of your choosing when
- # creating a CustomInfoType, or one of the names listed
- # at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
- # a built-in type. InfoType names should conform to the pattern
- # `[a-zA-Z0-9_]{1,64}`.
- },
- ],
- "excludeInfoTypes": True or False, # When true, excludes type information of the findings.
"customInfoTypes": [ # CustomInfoTypes provided by the user. See
# https://cloud.google.com/dlp/docs/creating-custom-infotypes to learn more.
{ # Custom information type provided by the user. Used to find domain-specific
# sensitive information configurable to the data in question.
- "surrogateType": { # Message for detecting output from deidentification transformations # Message for detecting output from deidentification transformations that
- # support reversing.
- # such as
- # [`CryptoReplaceFfxFpeConfig`](/dlp/docs/reference/rest/v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig).
- # These types of transformations are
- # those that perform pseudonymization, thereby producing a "surrogate" as
- # output. This should be used in conjunction with a field on the
- # transformation such as `surrogate_info_type`. This CustomInfoType does
- # not support the use of `detection_rules`.
- },
- "likelihood": "A String", # Likelihood to return for this CustomInfoType. This base value can be
- # altered by a detection rule if the finding meets the criteria specified by
- # the rule. Defaults to `VERY_LIKELY` if not specified.
- "infoType": { # Type of information detected by the API. # CustomInfoType can either be a new infoType, or an extension of built-in
- # infoType, when the name matches one of existing infoTypes and that infoType
- # is specified in `InspectContent.info_types` field. Specifying the latter
- # adds findings to the one detected by the system. If built-in info type is
- # not specified in `InspectContent.info_types` list then the name is treated
- # as a custom info type.
- "name": "A String", # Name of the information type. Either a name of your choosing when
- # creating a CustomInfoType, or one of the names listed
- # at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
- # a built-in type. InfoType names should conform to the pattern
- # `[a-zA-Z0-9_]{1,64}`.
- },
- "regex": { # Message defining a custom regular expression. # Regular expression based CustomInfoType.
- "groupIndexes": [ # The index of the submatch to extract as findings. When not
- # specified, the entire match is returned. No more than 3 may be included.
- 42,
- ],
- "pattern": "A String", # Pattern defining the regular expression. Its syntax
- # (https://github.com/google/re2/wiki/Syntax) can be found under the
- # google/re2 repository on GitHub.
- },
- "detectionRules": [ # Set of detection rules to apply to all findings of this CustomInfoType.
- # Rules are applied in order that they are specified. Not supported for the
- # `surrogate_type` CustomInfoType.
- { # Deprecated; use `InspectionRuleSet` instead. Rule for modifying a
- # `CustomInfoType` to alter behavior under certain circumstances, depending
- # on the specific details of the rule. Not supported for the `surrogate_type`
- # custom infoType.
- "hotwordRule": { # The rule that adjusts the likelihood of findings within a certain # Hotword-based detection rule.
- # proximity of hotwords.
- "likelihoodAdjustment": { # Message for specifying an adjustment to the likelihood of a finding as # Likelihood adjustment to apply to all matching findings.
- # part of a detection rule.
- "relativeLikelihood": 42, # Increase or decrease the likelihood by the specified number of
- # levels. For example, if a finding would be `POSSIBLE` without the
- # detection rule and `relative_likelihood` is 1, then it is upgraded to
- # `LIKELY`, while a value of -1 would downgrade it to `UNLIKELY`.
- # Likelihood may never drop below `VERY_UNLIKELY` or exceed
- # `VERY_LIKELY`, so applying an adjustment of 1 followed by an
- # adjustment of -1 when base likelihood is `VERY_LIKELY` will result in
- # a final likelihood of `LIKELY`.
- "fixedLikelihood": "A String", # Set the likelihood of a finding to a fixed value.
- },
- "hotwordRegex": { # Message defining a custom regular expression. # Regular expression pattern defining what qualifies as a hotword.
- "groupIndexes": [ # The index of the submatch to extract as findings. When not
- # specified, the entire match is returned. No more than 3 may be included.
- 42,
- ],
- "pattern": "A String", # Pattern defining the regular expression. Its syntax
- # (https://github.com/google/re2/wiki/Syntax) can be found under the
- # google/re2 repository on GitHub.
- },
- "proximity": { # Message for specifying a window around a finding to apply a detection # Proximity of the finding within which the entire hotword must reside.
- # The total length of the window cannot exceed 1000 characters. Note that
- # the finding itself will be included in the window, so that hotwords may
- # be used to match substrings of the finding itself. For example, the
- # certainty of a phone number regex "\(\d{3}\) \d{3}-\d{4}" could be
- # adjusted upwards if the area code is known to be the local area code of
- # a company office using the hotword regex "\(xxx\)", where "xxx"
- # is the area code in question.
- # rule.
- "windowBefore": 42, # Number of characters before the finding to consider.
- "windowAfter": 42, # Number of characters after the finding to consider.
- },
- },
- },
- ],
- "exclusionType": "A String", # If set to EXCLUSION_TYPE_EXCLUDE this infoType will not cause a finding
- # to be returned. It still can be used for rules matching.
"dictionary": { # Custom information type based on a dictionary of words or phrases. This can # A list of phrases to detect as a CustomInfoType.
# be used to match sensitive information specific to the data, such as a list
# of employee IDs or job titles.
@@ -265,6 +132,11 @@
# the size limits of dictionaries. For dictionaries that do not fit within
# these constraints, consider using `LargeCustomDictionaryConfig` in the
# `StoredInfoType` API.
+ "cloudStoragePath": { # Message representing a single file or path in Cloud Storage. # Newline-delimited file of words in Cloud Storage. Only a single file
+ # is accepted.
+ "path": "A String", # A url representing a file or path (no wildcards) in Cloud Storage.
+ # Example: gs://[BUCKET_NAME]/dictionary.txt
+ },
"wordList": { # Message defining a list of words or phrases to search for in the data. # List of words or phrases to search for.
"words": [ # Words or phrases defining the dictionary. The dictionary must contain
# at least one phrase and every phrase must contain at least 2 characters
@@ -272,11 +144,85 @@
"A String",
],
},
- "cloudStoragePath": { # Message representing a single file or path in Cloud Storage. # Newline-delimited file of words in Cloud Storage. Only a single file
- # is accepted.
- "path": "A String", # A url representing a file or path (no wildcards) in Cloud Storage.
- # Example: gs://[BUCKET_NAME]/dictionary.txt
+ },
+ "infoType": { # Type of information detected by the API. # CustomInfoType can either be a new infoType, or an extension of built-in
+ # infoType, when the name matches one of existing infoTypes and that infoType
+ # is specified in `InspectContent.info_types` field. Specifying the latter
+ # adds findings to the one detected by the system. If built-in info type is
+ # not specified in `InspectContent.info_types` list then the name is treated
+ # as a custom info type.
+ "name": "A String", # Name of the information type. Either a name of your choosing when
+ # creating a CustomInfoType, or one of the names listed
+ # at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
+ # 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}`.
+ },
+ "likelihood": "A String", # Likelihood to return for this CustomInfoType. This base value can be
+ # altered by a detection rule if the finding meets the criteria specified by
+ # the rule. Defaults to `VERY_LIKELY` if not specified.
+ "detectionRules": [ # Set of detection rules to apply to all findings of this CustomInfoType.
+ # Rules are applied in order that they are specified. Not supported for the
+ # `surrogate_type` CustomInfoType.
+ { # Deprecated; use `InspectionRuleSet` instead. Rule for modifying a
+ # `CustomInfoType` to alter behavior under certain circumstances, depending
+ # on the specific details of the rule. Not supported for the `surrogate_type`
+ # custom infoType.
+ "hotwordRule": { # The rule that adjusts the likelihood of findings within a certain # Hotword-based detection rule.
+ # proximity of hotwords.
+ "proximity": { # Message for specifying a window around a finding to apply a detection # Proximity of the finding within which the entire hotword must reside.
+ # The total length of the window cannot exceed 1000 characters. Note that
+ # the finding itself will be included in the window, so that hotwords may
+ # be used to match substrings of the finding itself. For example, the
+ # certainty of a phone number regex "\(\d{3}\) \d{3}-\d{4}" could be
+ # adjusted upwards if the area code is known to be the local area code of
+ # a company office using the hotword regex "\(xxx\)", where "xxx"
+ # is the area code in question.
+ # rule.
+ "windowAfter": 42, # Number of characters after the finding to consider.
+ "windowBefore": 42, # Number of characters before the finding to consider.
+ },
+ "likelihoodAdjustment": { # Message for specifying an adjustment to the likelihood of a finding as # Likelihood adjustment to apply to all matching findings.
+ # part of a detection rule.
+ "fixedLikelihood": "A String", # Set the likelihood of a finding to a fixed value.
+ "relativeLikelihood": 42, # Increase or decrease the likelihood by the specified number of
+ # levels. For example, if a finding would be `POSSIBLE` without the
+ # detection rule and `relative_likelihood` is 1, then it is upgraded to
+ # `LIKELY`, while a value of -1 would downgrade it to `UNLIKELY`.
+ # Likelihood may never drop below `VERY_UNLIKELY` or exceed
+ # `VERY_LIKELY`, so applying an adjustment of 1 followed by an
+ # adjustment of -1 when base likelihood is `VERY_LIKELY` will result in
+ # a final likelihood of `LIKELY`.
+ },
+ "hotwordRegex": { # Message defining a custom regular expression. # Regular expression pattern defining what qualifies as a hotword.
+ "groupIndexes": [ # The index of the submatch to extract as findings. When not
+ # specified, the entire match is returned. No more than 3 may be included.
+ 42,
+ ],
+ "pattern": "A String", # Pattern defining the regular expression. Its syntax
+ # (https://github.com/google/re2/wiki/Syntax) can be found under the
+ # google/re2 repository on GitHub.
+ },
+ },
},
+ ],
+ "surrogateType": { # Message for detecting output from deidentification transformations # Message for detecting output from deidentification transformations that
+ # support reversing.
+ # such as
+ # [`CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/reference/rest/v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig).
+ # These types of transformations are
+ # those that perform pseudonymization, thereby producing a "surrogate" as
+ # output. This should be used in conjunction with a field on the
+ # transformation such as `surrogate_info_type`. This CustomInfoType does
+ # not support the use of `detection_rules`.
+ },
+ "regex": { # Message defining a custom regular expression. # Regular expression based CustomInfoType.
+ "groupIndexes": [ # The index of the submatch to extract as findings. When not
+ # specified, the entire match is returned. No more than 3 may be included.
+ 42,
+ ],
+ "pattern": "A String", # Pattern defining the regular expression. Its syntax
+ # (https://github.com/google/re2/wiki/Syntax) can be found under the
+ # google/re2 repository on GitHub.
},
"storedType": { # A reference to a StoredInfoType to use with scanning. # Load an existing `StoredInfoType` resource for use in
# `InspectDataSource`. Not currently supported in `InspectContent`.
@@ -286,8 +232,39 @@
"createTime": "A String", # Timestamp indicating when the version of the `StoredInfoType` used for
# inspection was created. Output-only field, populated by the system.
},
+ "exclusionType": "A String", # If set to EXCLUSION_TYPE_EXCLUDE this infoType will not cause a finding
+ # to be returned. It still can be used for rules matching.
},
],
+ "minLikelihood": "A String", # Only returns findings equal or above this threshold. The default is
+ # POSSIBLE.
+ # See https://cloud.google.com/dlp/docs/likelihood to learn more.
+ "limits": { # Configuration to control the number of findings returned. # Configuration to control the number of findings returned.
+ "maxFindingsPerRequest": 42, # Max number of findings that will be returned per request/job.
+ # When set within `InspectContentRequest`, the maximum returned is 2000
+ # regardless if this is set higher.
+ "maxFindingsPerInfoType": [ # Configuration of findings limit given for specified infoTypes.
+ { # Max findings configuration per infoType, per content item or long
+ # running DlpJob.
+ "infoType": { # Type of information detected by the API. # Type of information the findings limit applies to. Only one limit per
+ # info_type should be provided. If InfoTypeLimit does not have an
+ # info_type, the DLP API applies the limit against all info_types that
+ # are found but not specified in another InfoTypeLimit.
+ "name": "A String", # Name of the information type. Either a name of your choosing when
+ # creating a CustomInfoType, or one of the names listed
+ # at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
+ # 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}`.
+ },
+ "maxFindings": 42, # Max findings limit for the given infoType.
+ },
+ ],
+ "maxFindingsPerItem": 42, # Max number of findings that will be returned for each item scanned.
+ # When set within `InspectJobConfig`,
+ # the maximum returned is 2000 regardless if this is set higher.
+ # When set within `InspectContentRequest`, this field is ignored.
+ },
+ "excludeInfoTypes": True or False, # When true, excludes type information of the findings.
"includeQuote": True or False, # When true, a contextual quote from the data that triggered a finding is
# included in the response; see Finding.quote.
"ruleSet": [ # Set of rules to apply to the findings for this InspectConfig.
@@ -300,8 +277,8 @@
"name": "A String", # Name of the information type. Either a name of your choosing when
# creating a CustomInfoType, or one of the names listed
# at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
- # a built-in type. InfoType names should conform to the pattern
- # `[a-zA-Z0-9_]{1,64}`.
+ # 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}`.
},
],
"rules": [ # Set of rules to be applied to infoTypes. The rules are applied in order.
@@ -309,8 +286,21 @@
# `InspectionRuleSet`.
"hotwordRule": { # The rule that adjusts the likelihood of findings within a certain # Hotword-based detection rule.
# proximity of hotwords.
+ "proximity": { # Message for specifying a window around a finding to apply a detection # Proximity of the finding within which the entire hotword must reside.
+ # The total length of the window cannot exceed 1000 characters. Note that
+ # the finding itself will be included in the window, so that hotwords may
+ # be used to match substrings of the finding itself. For example, the
+ # certainty of a phone number regex "\(\d{3}\) \d{3}-\d{4}" could be
+ # adjusted upwards if the area code is known to be the local area code of
+ # a company office using the hotword regex "\(xxx\)", where "xxx"
+ # is the area code in question.
+ # rule.
+ "windowAfter": 42, # Number of characters after the finding to consider.
+ "windowBefore": 42, # Number of characters before the finding to consider.
+ },
"likelihoodAdjustment": { # Message for specifying an adjustment to the likelihood of a finding as # Likelihood adjustment to apply to all matching findings.
# part of a detection rule.
+ "fixedLikelihood": "A String", # Set the likelihood of a finding to a fixed value.
"relativeLikelihood": 42, # Increase or decrease the likelihood by the specified number of
# levels. For example, if a finding would be `POSSIBLE` without the
# detection rule and `relative_likelihood` is 1, then it is upgraded to
@@ -319,7 +309,6 @@
# `VERY_LIKELY`, so applying an adjustment of 1 followed by an
# adjustment of -1 when base likelihood is `VERY_LIKELY` will result in
# a final likelihood of `LIKELY`.
- "fixedLikelihood": "A String", # Set the likelihood of a finding to a fixed value.
},
"hotwordRegex": { # Message defining a custom regular expression. # Regular expression pattern defining what qualifies as a hotword.
"groupIndexes": [ # The index of the submatch to extract as findings. When not
@@ -330,21 +319,10 @@
# (https://github.com/google/re2/wiki/Syntax) can be found under the
# google/re2 repository on GitHub.
},
- "proximity": { # Message for specifying a window around a finding to apply a detection # Proximity of the finding within which the entire hotword must reside.
- # The total length of the window cannot exceed 1000 characters. Note that
- # the finding itself will be included in the window, so that hotwords may
- # be used to match substrings of the finding itself. For example, the
- # certainty of a phone number regex "\(\d{3}\) \d{3}-\d{4}" could be
- # adjusted upwards if the area code is known to be the local area code of
- # a company office using the hotword regex "\(xxx\)", where "xxx"
- # is the area code in question.
- # rule.
- "windowBefore": 42, # Number of characters before the finding to consider.
- "windowAfter": 42, # Number of characters after the finding to consider.
- },
},
"exclusionRule": { # The rule that specifies conditions when findings of infoTypes specified in # Exclusion rule.
# `InspectionRuleSet` are removed from results.
+ "matchingType": "A String", # How the rule is applied, see MatchingType documentation for details.
"dictionary": { # Custom information type based on a dictionary of words or phrases. This can # Dictionary which defines the rule.
# be used to match sensitive information specific to the data, such as a list
# of employee IDs or job titles.
@@ -368,6 +346,11 @@
# the size limits of dictionaries. For dictionaries that do not fit within
# these constraints, consider using `LargeCustomDictionaryConfig` in the
# `StoredInfoType` API.
+ "cloudStoragePath": { # Message representing a single file or path in Cloud Storage. # Newline-delimited file of words in Cloud Storage. Only a single file
+ # is accepted.
+ "path": "A String", # A url representing a file or path (no wildcards) in Cloud Storage.
+ # Example: gs://[BUCKET_NAME]/dictionary.txt
+ },
"wordList": { # Message defining a list of words or phrases to search for in the data. # List of words or phrases to search for.
"words": [ # Words or phrases defining the dictionary. The dictionary must contain
# at least one phrase and every phrase must contain at least 2 characters
@@ -375,20 +358,6 @@
"A String",
],
},
- "cloudStoragePath": { # Message representing a single file or path in Cloud Storage. # Newline-delimited file of words in Cloud Storage. Only a single file
- # is accepted.
- "path": "A String", # A url representing a file or path (no wildcards) in Cloud Storage.
- # Example: gs://[BUCKET_NAME]/dictionary.txt
- },
- },
- "regex": { # Message defining a custom regular expression. # Regular expression which defines the rule.
- "groupIndexes": [ # The index of the submatch to extract as findings. When not
- # specified, the entire match is returned. No more than 3 may be included.
- 42,
- ],
- "pattern": "A String", # Pattern defining the regular expression. Its syntax
- # (https://github.com/google/re2/wiki/Syntax) can be found under the
- # google/re2 repository on GitHub.
},
"excludeInfoTypes": { # List of exclude infoTypes. # Set of infoTypes for which findings would affect this rule.
"infoTypes": [ # InfoType list in ExclusionRule rule drops a finding when it overlaps or
@@ -403,43 +372,74 @@
"name": "A String", # Name of the information type. Either a name of your choosing when
# creating a CustomInfoType, or one of the names listed
# at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
- # a built-in type. InfoType names should conform to the pattern
- # `[a-zA-Z0-9_]{1,64}`.
+ # 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}`.
},
],
},
- "matchingType": "A String", # How the rule is applied, see MatchingType documentation for details.
+ "regex": { # Message defining a custom regular expression. # Regular expression which defines the rule.
+ "groupIndexes": [ # The index of the submatch to extract as findings. When not
+ # specified, the entire match is returned. No more than 3 may be included.
+ 42,
+ ],
+ "pattern": "A String", # Pattern defining the regular expression. Its syntax
+ # (https://github.com/google/re2/wiki/Syntax) can be found under the
+ # google/re2 repository on GitHub.
+ },
},
},
],
},
],
- "limits": { # Configuration to control the number of findings returned. # Configuration to control the number of findings returned.
- "maxFindingsPerItem": 42, # Max number of findings that will be returned for each item scanned.
- # When set within `InspectJobConfig`,
- # the maximum returned is 2000 regardless if this is set higher.
- # When set within `InspectContentRequest`, this field is ignored.
- "maxFindingsPerInfoType": [ # Configuration of findings limit given for specified infoTypes.
- { # Max findings configuration per infoType, per content item or long
- # running DlpJob.
- "maxFindings": 42, # Max findings limit for the given infoType.
- "infoType": { # Type of information detected by the API. # Type of information the findings limit applies to. Only one limit per
- # info_type should be provided. If InfoTypeLimit does not have an
- # info_type, the DLP API applies the limit against all info_types that
- # are found but not specified in another InfoTypeLimit.
- "name": "A String", # Name of the information type. Either a name of your choosing when
- # creating a CustomInfoType, or one of the names listed
- # at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
- # a built-in type. InfoType names should conform to the pattern
- # `[a-zA-Z0-9_]{1,64}`.
- },
- },
- ],
- "maxFindingsPerRequest": 42, # Max number of findings that will be returned per request/job.
- # When set within `InspectContentRequest`, the maximum returned is 2000
- # regardless if this is set higher.
- },
+ "contentOptions": [ # List of options defining data content to scan.
+ # If empty, text, images, and other content will be included.
+ "A String",
+ ],
+ "infoTypes": [ # Restricts what info_types to look for. The values must correspond to
+ # InfoType values returned by ListInfoTypes or listed at
+ # https://cloud.google.com/dlp/docs/infotypes-reference.
+ #
+ # When no InfoTypes or CustomInfoTypes are specified in a request, the
+ # system may automatically choose what detectors to run. By default this may
+ # be all types, but may change over time as detectors are updated.
+ #
+ # If you need precise control and predictability as to what detectors are
+ # run you should specify specific InfoTypes listed in the reference,
+ # otherwise a default list will be used, which may change over time.
+ { # Type of information detected by the API.
+ "name": "A String", # Name of the information type. Either a name of your choosing when
+ # creating a CustomInfoType, or one of the names listed
+ # at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
+ # 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}`.
+ },
+ ],
},
+ "imageRedactionConfigs": [ # The configuration for specifying what content to redact from images.
+ { # Configuration for determining how redaction of images should occur.
+ "redactAllText": True or False, # If true, all text found in the image, regardless whether it matches an
+ # info_type, is redacted. Only one should be provided.
+ "redactionColor": { # Represents a color in the RGB color space. # The color to use when redacting content from an image. If not specified,
+ # the default is black.
+ "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].
+ "green": 3.14, # The amount of green in the color as a value in the interval [0, 1].
+ "red": 3.14, # The amount of red in the color as a value in the interval [0, 1].
+ },
+ "infoType": { # Type of information detected by the API. # Only one per info_type should be provided per request. If not
+ # specified, and redact_all_text is false, the DLP API will redact all
+ # text that it matches against all info_types that are found, but not
+ # specified in another ImageRedactionConfig.
+ "name": "A String", # Name of the information type. Either a name of your choosing when
+ # creating a CustomInfoType, or one of the names listed
+ # at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
+ # 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}`.
+ },
+ },
+ ],
+ "includeFindings": True or False, # Whether the response should include findings along with the redacted
+ # image.
+ "locationId": "A String", # Deprecated. This field has no effect.
}
x__xgafv: string, V1 error format.
@@ -451,59 +451,13 @@
An object of the form:
{ # Results of redacting an image.
+ "extractedText": "A String", # If an image was being inspected and the InspectConfig's include_quote was
+ # set to true, then this field will include all text, if any, that was found
+ # in the image.
"redactedImage": "A String", # The redacted image. The type will be the same as the original image.
"inspectResult": { # All the findings for a single scanned item. # The findings. Populated when include_findings in the request is true.
"findings": [ # List of findings for an item.
{ # Represents a piece of potentially sensitive content.
- "quoteInfo": { # Message for infoType-dependent details parsed from quote. # Contains data parsed from quotes. Only populated if include_quote was set
- # to true and a supported infoType was requested. Currently supported
- # infoTypes: DATE, DATE_OF_BIRTH and TIME.
- "dateTime": { # Message for a date time object. # The date time indicated by the quote.
- # e.g. 2018-01-01, 5th August.
- "date": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # One or more of the following must be set.
- # Must be a valid date or time value.
- # and time zone are either specified elsewhere or are not significant. The date
- # is relative to the Proleptic Gregorian Calendar. This can represent:
- #
- # * A full date, with non-zero year, month and day values
- # * A month and day value, with a zero year, e.g. an anniversary
- # * A year on its own, with zero month and day values
- # * A year and month value, with a zero day, e.g. a credit card expiration date
- #
- # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
- "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
- # a year.
- "month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
- # month and day.
- "day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
- # if specifying a year by itself or a year and month where the day is not
- # significant.
- },
- "timeZone": { # Time zone of the date time object. # Time zone
- "offsetMinutes": 42, # Set only if the offset can be determined. Positive for time ahead of UTC.
- # E.g. For "UTC-9", this value is -540.
- },
- "dayOfWeek": "A String", # Day of week
- "time": { # Represents a time of day. The date and time zone are either not significant # Time of day
- # or are specified elsewhere. An API may choose to allow leap seconds. Related
- # types are google.type.Date and `google.protobuf.Timestamp`.
- "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
- # to allow the value "24:00:00" for scenarios like business closing time.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may
- # allow the value 60 if it allows leap-seconds.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- },
- },
- },
- "infoType": { # Type of information detected by the API. # The type of content that might have been found.
- # Provided if `excluded_types` is false.
- "name": "A String", # Name of the information type. Either a name of your choosing when
- # creating a CustomInfoType, or one of the names listed
- # at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
- # a built-in type. InfoType names should conform to the pattern
- # `[a-zA-Z0-9_]{1,64}`.
- },
"labels": { # The labels associated with this `Finding`.
#
# Label keys must be between 1 and 63 characters long and must conform
@@ -519,130 +473,92 @@
# * `"pipeline" : "etl"`
"a_key": "A String",
},
+ "triggerName": "A String", # Job trigger name, if applicable, for this finding.
+ "resourceName": "A String", # The job that stored the finding.
+ "jobCreateTime": "A String", # Time the job started that produced this finding.
"likelihood": "A String", # Confidence of how likely it is that the `info_type` is correct.
- "name": "A String", # Resource name in format
- # projects/{project}/locations/{location}/findings/{finding} Populated only
- # when viewing persisted findings.
+ "quoteInfo": { # Message for infoType-dependent details parsed from quote. # Contains data parsed from quotes. Only populated if include_quote was set
+ # to true and a supported infoType was requested. Currently supported
+ # infoTypes: DATE, DATE_OF_BIRTH and TIME.
+ "dateTime": { # Message for a date time object. # The date time indicated by the quote.
+ # e.g. 2018-01-01, 5th August.
+ "timeZone": { # Time zone of the date time object. # Time zone
+ "offsetMinutes": 42, # Set only if the offset can be determined. Positive for time ahead of UTC.
+ # E.g. For "UTC-9", this value is -540.
+ },
+ "date": { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # One or more of the following must be set.
+ # Must be a valid date or time value.
+ # and time zone are either specified elsewhere or are not significant. The date
+ # is relative to the Proleptic Gregorian Calendar. This can represent:
+ #
+ # * A full date, with non-zero year, month and day values
+ # * A month and day value, with a zero year, e.g. an anniversary
+ # * A year on its own, with zero month and day values
+ # * A year and month value, with a zero day, e.g. a credit card expiration date
+ #
+ # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
+ "month": 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
+ # month and day.
+ "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
+ # a year.
+ "day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
+ # if specifying a year by itself or a year and month where the day is not
+ # significant.
+ },
+ "dayOfWeek": "A String", # Day of week
+ "time": { # Represents a time of day. The date and time zone are either not significant # Time of day
+ # or are specified elsewhere. An API may choose to allow leap seconds. Related
+ # types are google.type.Date and `google.protobuf.Timestamp`.
+ "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may
+ # allow the value 60 if it allows leap-seconds.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
+ "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
+ # to allow the value "24:00:00" for scenarios like business closing time.
+ },
+ },
+ },
+ "infoType": { # Type of information detected by the API. # The type of content that might have been found.
+ # Provided if `excluded_types` is false.
+ "name": "A String", # Name of the information type. Either a name of your choosing when
+ # creating a CustomInfoType, or one of the names listed
+ # at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
+ # 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}`.
+ },
+ "quote": "A String", # The content that was found. Even if the content is not textual, it
+ # may be converted to a textual representation here.
+ # Provided if `include_quote` is true and the finding is
+ # less than or equal to 4096 bytes long. If the finding exceeds 4096 bytes
+ # in length, the quote may be omitted.
+ "jobName": "A String", # The job that stored the finding.
"location": { # Specifies the location of the finding. # Where the content was found.
- "codepointRange": { # Generic half-open interval [start, end) # Unicode character offsets delimiting the finding.
- # These are relative to the finding's containing element.
- # Provided when the content is text.
- "start": "A String", # Index of the first character of the range (inclusive).
- "end": "A String", # Index of the last character of the range (exclusive).
- },
- "byteRange": { # Generic half-open interval [start, end) # Zero-based byte offsets delimiting the finding.
- # These are relative to the finding's containing element.
- # Note that when the content is not textual, this references
- # the UTF-8 encoded textual representation of the content.
- # Omitted if content is an image.
- "start": "A String", # Index of the first character of the range (inclusive).
- "end": "A String", # Index of the last character of the range (exclusive).
- },
- "container": { # Represents a container that may contain DLP findings. # Information about the container where this finding occurred, if available.
- # Examples of a container include a file, table, or database record.
- "updateTime": "A String", # Findings container modification timestamp, if applicable.
- # For Google Cloud Storage contains last file modification timestamp.
- # For BigQuery table contains last_modified_time property.
- # For Datastore - not populated.
- "rootPath": "A String", # The root of the container.
- # Examples:
- # - For BigQuery table `project_id:dataset_id.table_id`, the root is
- # `dataset_id`
- # - For Google Cloud Storage file `gs://bucket/folder/filename.txt`, the root
- # is `gs://bucket`
- "projectId": "A String", # Project where the finding was found.
- # Can be different from the project that owns the finding.
- "version": "A String", # Findings container version, if available
- # ("generation" for Google Cloud Storage).
- "relativePath": "A String", # The rest of the path after the root.
- # Examples:
- # - For BigQuery table `project_id:dataset_id.table_id`, the relative path is
- # `table_id`
- # - Google Cloud Storage file `gs://bucket/folder/filename.txt`, the relative
- # path is `folder/filename.txt`
- "fullPath": "A String", # A string representation of the full container name.
- # Examples:
- # - BigQuery: 'Project:DataSetId.TableId'
- # - Google Cloud Storage: 'gs://Bucket/folders/filename.txt'
- "type": "A String", # Container type, for example BigQuery or Google Cloud Storage.
- },
"contentLocations": [ # List of nested objects pointing to the precise location of the finding
# within the file or record.
{ # Precise location of the finding within a document, record, image, or metadata
# container.
- "containerVersion": "A String", # Findings container version, if available
- # ("generation" for Google Cloud Storage).
- "containerName": "A String", # Name of the container where the finding is located.
- # The top level name is the source file name or table name. Names of some
- # common storage containers are formatted as follows:
- #
- # * BigQuery tables: `{project_id}:{dataset_id}.{table_id}`
- # * Cloud Storage files: `gs://{bucket}/{path}`
- # * Datastore namespace: {namespace}
- #
- # Nested names could be absent if the embedded object has no string
- # identifier (for an example an image contained within a document).
- "documentLocation": { # Location of a finding within a document. # Location data for document files.
- "fileOffset": "A String", # Offset of the line, from the beginning of the file, where the finding
- # is located.
+ "containerTimestamp": "A String", # Findings container modification timestamp, if applicable.
+ # For Google Cloud Storage contains last file modification timestamp.
+ # For BigQuery table contains last_modified_time property.
+ # For Datastore - not populated.
+ "imageLocation": { # Location of the finding within an image. # Location within an image's pixels.
+ "boundingBoxes": [ # Bounding boxes locating the pixels within the image containing the finding.
+ { # Bounding box encompassing detected text within an image.
+ "left": 42, # Left coordinate of the bounding box. (0,0) is upper left.
+ "top": 42, # Top coordinate of the bounding box. (0,0) is upper left.
+ "width": 42, # Width of the bounding box in pixels.
+ "height": 42, # Height of the bounding box in pixels.
+ },
+ ],
+ },
+ "metadataLocation": { # Metadata Location # Location within the metadata for inspected content.
+ "type": "A String", # Type of metadata containing the finding.
+ "storageLabel": { # Storage metadata label to indicate which metadata entry contains findings. # Storage metadata.
+ "key": "A String",
+ },
},
"recordLocation": { # Location of a finding within a row or record. # Location within a row or record of a database table.
- "fieldId": { # General identifier of a data field in a storage service. # Field id of the field containing the finding.
- "name": "A String", # Name describing the field.
- },
- "tableLocation": { # Location of a finding within a table. # Location within a `ContentItem.Table`.
- "rowIndex": "A String", # The zero-based index of the row where the finding is located. Only
- # populated for resources that have a natural ordering, not BigQuery. In
- # BigQuery, to identify the row a finding came from, populate
- # BigQueryOptions.identifying_fields with your primary key column names and
- # when you store the findings the value of those columns will be stored
- # inside of Finding.
- },
"recordKey": { # Message for a unique key indicating a record that contains a finding. # Key of the finding.
- "datastoreKey": { # Record key for a finding in Cloud Datastore.
- "entityKey": { # A unique identifier for a Datastore entity. # Datastore entity key.
- # If a key's partition ID or any of its path kinds or names are
- # reserved/read-only, the key is reserved/read-only.
- # A reserved/read-only key is forbidden in certain documented contexts.
- "partitionId": { # Datastore partition ID. # Entities are partitioned into subsets, currently identified by a project
- # ID and namespace ID.
- # Queries are scoped to a single partition.
- # 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.
- "projectId": "A String", # The ID of the project to which the entities belong.
- "namespaceId": "A String", # If not empty, the ID of the namespace to which the entities belong.
- },
- "path": [ # The entity path.
- # An entity path consists of one or more elements composed of a kind and a
- # string or numerical identifier, which identify entities. The first
- # element identifies a _root entity_, the second element identifies
- # a _child_ of the root entity, the third element identifies a child of the
- # second entity, and so forth. The entities identified by all prefixes of
- # the path are called the element's _ancestors_.
- #
- # A path can never be empty, and a path can have at most 100 elements.
- { # 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.
- "kind": "A String", # The kind of the entity.
- # A kind matching regex `__.*__` is reserved/read-only.
- # A kind must not contain more than 1500 bytes when UTF-8 encoded.
- # Cannot be `""`.
- "id": "A String", # The auto-allocated ID of the entity.
- # Never equal to zero. Values less than zero are discouraged and may not
- # be supported in the future.
- "name": "A String", # The name of the entity.
- # A name matching regex `__.*__` is reserved/read-only.
- # A name must not be more than 1500 bytes when UTF-8 encoded.
- # Cannot be `""`.
- },
- ],
- },
- },
"bigQueryKey": { # Row key for identifying a record in BigQuery table.
"rowNumber": "A String", # Row number inferred at the time the table was scanned. This value is
# nondeterministic, cannot be queried, and may be null for inspection
@@ -664,41 +580,128 @@
# the order of `identifying_fields` specified in the scanning request.
"A String",
],
- },
- },
- "containerTimestamp": "A String", # Findings container modification timestamp, if applicable.
- # For Google Cloud Storage contains last file modification timestamp.
- # For BigQuery table contains last_modified_time property.
- # For Datastore - not populated.
- "metadataLocation": { # Metadata Location # Location within the metadata for inspected content.
- "type": "A String", # Type of metadata containing the finding.
- "storageLabel": { # Storage metadata label to indicate which metadata entry contains findings. # Storage metadata.
- "key": "A String",
- },
- },
- "imageLocation": { # Location of the finding within an image. # Location within an image's pixels.
- "boundingBoxes": [ # Bounding boxes locating the pixels within the image containing the finding.
- { # Bounding box encompassing detected text within an image.
- "top": 42, # Top coordinate of the bounding box. (0,0) is upper left.
- "width": 42, # Width of the bounding box in pixels.
- "height": 42, # Height of the bounding box in pixels.
- "left": 42, # Left coordinate of the bounding box. (0,0) is upper left.
+ "datastoreKey": { # Record key for a finding in Cloud Datastore.
+ "entityKey": { # A unique identifier for a Datastore entity. # Datastore entity key.
+ # If a key's partition ID or any of its path kinds or names are
+ # reserved/read-only, the key is reserved/read-only.
+ # A reserved/read-only key is forbidden in certain documented contexts.
+ "path": [ # The entity path.
+ # An entity path consists of one or more elements composed of a kind and a
+ # string or numerical identifier, which identify entities. The first
+ # element identifies a _root entity_, the second element identifies
+ # a _child_ of the root entity, the third element identifies a child of the
+ # second entity, and so forth. The entities identified by all prefixes of
+ # the path are called the element's _ancestors_.
+ #
+ # A path can never be empty, and a path can have at most 100 elements.
+ { # 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.
+ "kind": "A String", # The kind of the entity.
+ # A kind matching regex `__.*__` is reserved/read-only.
+ # A kind must not contain more than 1500 bytes when UTF-8 encoded.
+ # Cannot be `""`.
+ "name": "A String", # The name of the entity.
+ # A name matching regex `__.*__` is reserved/read-only.
+ # A name must not be more than 1500 bytes when UTF-8 encoded.
+ # Cannot be `""`.
+ "id": "A String", # The auto-allocated ID of the entity.
+ # Never equal to zero. Values less than zero are discouraged and may not
+ # be supported in the future.
+ },
+ ],
+ "partitionId": { # Datastore partition ID. # Entities are partitioned into subsets, currently identified by a project
+ # ID and namespace ID.
+ # Queries are scoped to a single partition.
+ # 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.
+ "namespaceId": "A String", # If not empty, the ID of the namespace to which the entities belong.
+ "projectId": "A String", # The ID of the project to which the entities belong.
+ },
+ },
},
- ],
+ },
+ "tableLocation": { # Location of a finding within a table. # Location within a `ContentItem.Table`.
+ "rowIndex": "A String", # The zero-based index of the row where the finding is located. Only
+ # populated for resources that have a natural ordering, not BigQuery. In
+ # BigQuery, to identify the row a finding came from, populate
+ # BigQueryOptions.identifying_fields with your primary key column names and
+ # when you store the findings the value of those columns will be stored
+ # inside of Finding.
+ },
+ "fieldId": { # General identifier of a data field in a storage service. # Field id of the field containing the finding.
+ "name": "A String", # Name describing the field.
+ },
},
+ "containerName": "A String", # Name of the container where the finding is located.
+ # The top level name is the source file name or table name. Names of some
+ # common storage containers are formatted as follows:
+ #
+ # * BigQuery tables: `{project_id}:{dataset_id}.{table_id}`
+ # * Cloud Storage files: `gs://{bucket}/{path}`
+ # * Datastore namespace: {namespace}
+ #
+ # Nested names could be absent if the embedded object has no string
+ # identifier (for an example an image contained within a document).
+ "documentLocation": { # Location of a finding within a document. # Location data for document files.
+ "fileOffset": "A String", # Offset of the line, from the beginning of the file, where the finding
+ # is located.
+ },
+ "containerVersion": "A String", # Findings container version, if available
+ # ("generation" for Google Cloud Storage).
},
],
+ "container": { # Represents a container that may contain DLP findings. # Information about the container where this finding occurred, if available.
+ # Examples of a container include a file, table, or database record.
+ "updateTime": "A String", # Findings container modification timestamp, if applicable.
+ # For Google Cloud Storage contains last file modification timestamp.
+ # For BigQuery table contains last_modified_time property.
+ # For Datastore - not populated.
+ "projectId": "A String", # Project where the finding was found.
+ # Can be different from the project that owns the finding.
+ "rootPath": "A String", # The root of the container.
+ # Examples:
+ # - For BigQuery table `project_id:dataset_id.table_id`, the root is
+ # `dataset_id`
+ # - For Google Cloud Storage file `gs://bucket/folder/filename.txt`, the root
+ # is `gs://bucket`
+ "version": "A String", # Findings container version, if available
+ # ("generation" for Google Cloud Storage).
+ "fullPath": "A String", # A string representation of the full container name.
+ # Examples:
+ # - BigQuery: 'Project:DataSetId.TableId'
+ # - Google Cloud Storage: 'gs://Bucket/folders/filename.txt'
+ "type": "A String", # Container type, for example BigQuery or Google Cloud Storage.
+ "relativePath": "A String", # The rest of the path after the root.
+ # Examples:
+ # - For BigQuery table `project_id:dataset_id.table_id`, the relative path is
+ # `table_id`
+ # - Google Cloud Storage file `gs://bucket/folder/filename.txt`, the relative
+ # path is `folder/filename.txt`
+ },
+ "codepointRange": { # Generic half-open interval [start, end) # Unicode character offsets delimiting the finding.
+ # These are relative to the finding's containing element.
+ # Provided when the content is text.
+ "end": "A String", # Index of the last character of the range (exclusive).
+ "start": "A String", # Index of the first character of the range (inclusive).
+ },
+ "byteRange": { # Generic half-open interval [start, end) # Zero-based byte offsets delimiting the finding.
+ # These are relative to the finding's containing element.
+ # Note that when the content is not textual, this references
+ # the UTF-8 encoded textual representation of the content.
+ # Omitted if content is an image.
+ "end": "A String", # Index of the last character of the range (exclusive).
+ "start": "A String", # Index of the first character of the range (inclusive).
+ },
},
- "quote": "A String", # The content that was found. Even if the content is not textual, it
- # may be converted to a textual representation here.
- # Provided if `include_quote` is true and the finding is
- # less than or equal to 4096 bytes long. If the finding exceeds 4096 bytes
- # in length, the quote may be omitted.
+ "name": "A String", # Resource name in format
+ # projects/{project}/locations/{location}/findings/{finding} Populated only
+ # when viewing persisted findings.
"createTime": "A String", # Timestamp when finding was detected.
- "jobName": "A String", # The job that stored the finding.
- "jobCreateTime": "A String", # Time the job started that produced this finding.
- "triggerName": "A String", # Job trigger name, if applicable, for this finding.
- "resourceName": "A String", # The job that stored the finding.
},
],
"findingsTruncated": True or False, # If true, then this item might have more findings than were returned,
@@ -708,9 +711,6 @@
# allowed for a single API call. For best results, divide the input into
# smaller batches.
},
- "extractedText": "A String", # If an image was being inspected and the InspectConfig's include_quote was
- # set to true, then this field will include all text, if any, that was found
- # in the image.
}</pre>
</div>