Patch
|
|||||
|
|
Updates the InspectTemplate. See https://cloud.google.com/dlp/docs/creating-templates to learn more
Authorization
To use this building block you will have to grant access to at least one of the following scopes:
- View and manage your data across Google Cloud Platform services
Input
This building block consumes 22 input parameters
Name | Format | Description |
---|---|---|
name Required |
STRING |
Resource name of organization and inspectTemplate to be updated, for
example |
updateMask |
ANY |
Mask to control which fields get updated |
inspectTemplate |
OBJECT |
The inspectTemplate contains a configuration (set of types of sensitive data to be detected) to be used anywhere you otherwise would normally specify InspectConfig. See https://cloud.google.com/dlp/docs/concepts-templates to learn more |
inspectTemplate.createTime |
ANY |
The creation timestamp of a inspectTemplate, output only field |
inspectTemplate.updateTime |
ANY |
The last update timestamp of a inspectTemplate, output only field |
inspectTemplate.name |
STRING |
The template name. Output only. The template will have one of the following formats:
|
inspectTemplate.inspectConfig |
OBJECT |
Configuration description of the scanning process. When used with redactContent only info_types and min_likelihood are currently used |
inspectTemplate.inspectConfig.contentOptions[] |
ENUMERATION |
|
inspectTemplate.inspectConfig.limits |
OBJECT |
|
inspectTemplate.inspectConfig.limits.maxFindingsPerItem |
INTEGER |
Max number of findings that will be returned for each item scanned.
When set within |
inspectTemplate.inspectConfig.limits.maxFindingsPerRequest |
INTEGER |
Max number of findings that will be returned per request/job.
When set within |
inspectTemplate.inspectConfig.excludeInfoTypes |
BOOLEAN |
When true, excludes type information of the findings |
inspectTemplate.inspectConfig.minLikelihood |
ENUMERATION |
Only returns findings equal or above this threshold. The default is POSSIBLE. See https://cloud.google.com/dlp/docs/likelihood to learn more |
inspectTemplate.inspectConfig.ruleSet[] |
OBJECT |
Rule set for modifying a set of infoTypes to alter behavior under certain circumstances, depending on the specific details of the rules within the set |
inspectTemplate.inspectConfig.infoTypes[] |
OBJECT |
Type of information detected by the API |
inspectTemplate.inspectConfig.infoTypes[].name |
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} |
inspectTemplate.inspectConfig.includeQuote |
BOOLEAN |
When true, a contextual quote from the data that triggered a finding is included in the response; see Finding.quote |
inspectTemplate.inspectConfig.customInfoTypes[] |
OBJECT |
Custom information type provided by the user. Used to find domain-specific sensitive information configurable to the data in question |
inspectTemplate.inspectConfig.customInfoTypes[].likelihood |
ENUMERATION |
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 |
inspectTemplate.inspectConfig.customInfoTypes[].exclusionType |
ENUMERATION |
If set to EXCLUSION_TYPE_EXCLUDE this infoType will not cause a finding to be returned. It still can be used for rules matching |
inspectTemplate.displayName |
STRING |
Display name (max 256 chars) |
inspectTemplate.description |
STRING |
Short description (max 256 chars) |
= Parameter name
= Format
name STRING Required Resource name of organization and inspectTemplate to be updated, for
example |
updateMask ANY Mask to control which fields get updated |
inspectTemplate OBJECT The inspectTemplate contains a configuration (set of types of sensitive data to be detected) to be used anywhere you otherwise would normally specify InspectConfig. See https://cloud.google.com/dlp/docs/concepts-templates to learn more |
inspectTemplate.createTime ANY The creation timestamp of a inspectTemplate, output only field |
inspectTemplate.updateTime ANY The last update timestamp of a inspectTemplate, output only field |
inspectTemplate.name STRING The template name. Output only. The template will have one of the following formats:
|
inspectTemplate.inspectConfig OBJECT Configuration description of the scanning process. When used with redactContent only info_types and min_likelihood are currently used |
inspectTemplate.inspectConfig.contentOptions[] ENUMERATION |
inspectTemplate.inspectConfig.limits OBJECT |
inspectTemplate.inspectConfig.limits.maxFindingsPerItem INTEGER Max number of findings that will be returned for each item scanned.
When set within |
inspectTemplate.inspectConfig.limits.maxFindingsPerRequest INTEGER Max number of findings that will be returned per request/job.
When set within |
inspectTemplate.inspectConfig.excludeInfoTypes BOOLEAN When true, excludes type information of the findings |
inspectTemplate.inspectConfig.minLikelihood ENUMERATION Only returns findings equal or above this threshold. The default is POSSIBLE. See https://cloud.google.com/dlp/docs/likelihood to learn more |
inspectTemplate.inspectConfig.ruleSet[] OBJECT Rule set for modifying a set of infoTypes to alter behavior under certain circumstances, depending on the specific details of the rules within the set |
inspectTemplate.inspectConfig.infoTypes[] OBJECT Type of information detected by the API |
inspectTemplate.inspectConfig.infoTypes[].name 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} |
inspectTemplate.inspectConfig.includeQuote BOOLEAN When true, a contextual quote from the data that triggered a finding is included in the response; see Finding.quote |
inspectTemplate.inspectConfig.customInfoTypes[] OBJECT Custom information type provided by the user. Used to find domain-specific sensitive information configurable to the data in question |
inspectTemplate.inspectConfig.customInfoTypes[].likelihood ENUMERATION 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 |
inspectTemplate.inspectConfig.customInfoTypes[].exclusionType ENUMERATION If set to EXCLUSION_TYPE_EXCLUDE this infoType will not cause a finding to be returned. It still can be used for rules matching |
inspectTemplate.displayName STRING Display name (max 256 chars) |
inspectTemplate.description STRING Short description (max 256 chars) |
Output
This building block provides 34 output parameters
Name | Format | Description |
---|---|---|
createTime |
ANY |
The creation timestamp of a inspectTemplate, output only field |
updateTime |
ANY |
The last update timestamp of a inspectTemplate, output only field |
name |
STRING |
The template name. Output only. The template will have one of the following formats:
|
inspectConfig |
OBJECT |
Configuration description of the scanning process. When used with redactContent only info_types and min_likelihood are currently used |
inspectConfig.contentOptions[] |
ENUMERATION |
|
inspectConfig.limits |
OBJECT |
|
inspectConfig.limits.maxFindingsPerInfoType[] |
OBJECT |
Max findings configuration per infoType, per content item or long running DlpJob |
inspectConfig.limits.maxFindingsPerInfoType[].maxFindings |
INTEGER |
Max findings limit for the given infoType |
inspectConfig.limits.maxFindingsPerItem |
INTEGER |
Max number of findings that will be returned for each item scanned.
When set within |
inspectConfig.limits.maxFindingsPerRequest |
INTEGER |
Max number of findings that will be returned per request/job.
When set within |
inspectConfig.excludeInfoTypes |
BOOLEAN |
When true, excludes type information of the findings |
inspectConfig.minLikelihood |
ENUMERATION |
Only returns findings equal or above this threshold. The default is POSSIBLE. See https://cloud.google.com/dlp/docs/likelihood to learn more |
inspectConfig.ruleSet[] |
OBJECT |
Rule set for modifying a set of infoTypes to alter behavior under certain circumstances, depending on the specific details of the rules within the set |
inspectConfig.ruleSet[].rules[] |
OBJECT |
A single inspection rule to be applied to infoTypes, specified in
|
inspectConfig.ruleSet[].infoTypes[] |
OBJECT |
Type of information detected by the API |
inspectConfig.infoTypes[] |
OBJECT |
Type of information detected by the API |
inspectConfig.infoTypes[].name |
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} |
inspectConfig.includeQuote |
BOOLEAN |
When true, a contextual quote from the data that triggered a finding is included in the response; see Finding.quote |
inspectConfig.customInfoTypes[] |
OBJECT |
Custom information type provided by the user. Used to find domain-specific sensitive information configurable to the data in question |
inspectConfig.customInfoTypes[].storedType |
OBJECT |
A reference to a StoredInfoType to use with scanning |
inspectConfig.customInfoTypes[].storedType.name |
STRING |
Resource name of the requested |
inspectConfig.customInfoTypes[].storedType.createTime |
ANY |
Timestamp indicating when the version of the |
inspectConfig.customInfoTypes[].infoType |
OBJECT |
Type of information detected by the API |
inspectConfig.customInfoTypes[].infoType.name |
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} |
inspectConfig.customInfoTypes[].dictionary |
OBJECT |
Custom information type based on a dictionary of words or phrases. This can be used to match sensitive information specific to the data, such as a list of employee IDs or job titles. Dictionary words are case-insensitive and all characters other than letters and digits in the unicode Basic Multilingual Plane will be replaced with whitespace when scanning for matches, so the dictionary phrase "Sam Johnson" will match all three phrases "sam johnson", "Sam, Johnson", and "Sam (Johnson)". Additionally, the characters surrounding any match must be of a different type than the adjacent characters within the word, so letters must be next to non-letters and digits next to non-digits. For example, the dictionary word "jen" will match the first three letters of the text "jen123" but will return no matches for "jennifer". Dictionary words containing a large number of characters that are not
letters or digits may result in unexpected findings because such characters
are treated as whitespace. The
limits page contains details about
the size limits of dictionaries. For dictionaries that do not fit within
these constraints, consider using |
inspectConfig.customInfoTypes[].regex |
OBJECT |
Message defining a custom regular expression |
inspectConfig.customInfoTypes[].regex.groupIndexes[] |
INTEGER |
|
inspectConfig.customInfoTypes[].regex.pattern |
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 |
inspectConfig.customInfoTypes[].surrogateType |
OBJECT |
Message for detecting output from deidentification transformations
such as
|
inspectConfig.customInfoTypes[].likelihood |
ENUMERATION |
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 |
inspectConfig.customInfoTypes[].exclusionType |
ENUMERATION |
If set to EXCLUSION_TYPE_EXCLUDE this infoType will not cause a finding to be returned. It still can be used for rules matching |
inspectConfig.customInfoTypes[].detectionRules[] |
OBJECT |
Deprecated; use |
displayName |
STRING |
Display name (max 256 chars) |
description |
STRING |
Short description (max 256 chars) |
= Parameter name
= Format
createTime ANY The creation timestamp of a inspectTemplate, output only field |
updateTime ANY The last update timestamp of a inspectTemplate, output only field |
name STRING The template name. Output only. The template will have one of the following formats:
|
inspectConfig OBJECT Configuration description of the scanning process. When used with redactContent only info_types and min_likelihood are currently used |
inspectConfig.contentOptions[] ENUMERATION |
inspectConfig.limits OBJECT |
inspectConfig.limits.maxFindingsPerInfoType[] OBJECT Max findings configuration per infoType, per content item or long running DlpJob |
inspectConfig.limits.maxFindingsPerInfoType[].maxFindings INTEGER Max findings limit for the given infoType |
inspectConfig.limits.maxFindingsPerItem INTEGER Max number of findings that will be returned for each item scanned.
When set within |
inspectConfig.limits.maxFindingsPerRequest INTEGER Max number of findings that will be returned per request/job.
When set within |
inspectConfig.excludeInfoTypes BOOLEAN When true, excludes type information of the findings |
inspectConfig.minLikelihood ENUMERATION Only returns findings equal or above this threshold. The default is POSSIBLE. See https://cloud.google.com/dlp/docs/likelihood to learn more |
inspectConfig.ruleSet[] OBJECT Rule set for modifying a set of infoTypes to alter behavior under certain circumstances, depending on the specific details of the rules within the set |
inspectConfig.ruleSet[].rules[] OBJECT A single inspection rule to be applied to infoTypes, specified in
|
inspectConfig.ruleSet[].infoTypes[] OBJECT Type of information detected by the API |
inspectConfig.infoTypes[] OBJECT Type of information detected by the API |
inspectConfig.infoTypes[].name 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} |
inspectConfig.includeQuote BOOLEAN When true, a contextual quote from the data that triggered a finding is included in the response; see Finding.quote |
inspectConfig.customInfoTypes[] OBJECT Custom information type provided by the user. Used to find domain-specific sensitive information configurable to the data in question |
inspectConfig.customInfoTypes[].storedType OBJECT A reference to a StoredInfoType to use with scanning |
inspectConfig.customInfoTypes[].storedType.name STRING Resource name of the requested |
inspectConfig.customInfoTypes[].storedType.createTime ANY Timestamp indicating when the version of the |
inspectConfig.customInfoTypes[].infoType OBJECT Type of information detected by the API |
inspectConfig.customInfoTypes[].infoType.name 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} |
inspectConfig.customInfoTypes[].dictionary OBJECT Custom information type based on a dictionary of words or phrases. This can be used to match sensitive information specific to the data, such as a list of employee IDs or job titles. Dictionary words are case-insensitive and all characters other than letters and digits in the unicode Basic Multilingual Plane will be replaced with whitespace when scanning for matches, so the dictionary phrase "Sam Johnson" will match all three phrases "sam johnson", "Sam, Johnson", and "Sam (Johnson)". Additionally, the characters surrounding any match must be of a different type than the adjacent characters within the word, so letters must be next to non-letters and digits next to non-digits. For example, the dictionary word "jen" will match the first three letters of the text "jen123" but will return no matches for "jennifer". Dictionary words containing a large number of characters that are not
letters or digits may result in unexpected findings because such characters
are treated as whitespace. The
limits page contains details about
the size limits of dictionaries. For dictionaries that do not fit within
these constraints, consider using |
inspectConfig.customInfoTypes[].regex OBJECT Message defining a custom regular expression |
inspectConfig.customInfoTypes[].regex.groupIndexes[] INTEGER |
inspectConfig.customInfoTypes[].regex.pattern 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 |
inspectConfig.customInfoTypes[].surrogateType OBJECT Message for detecting output from deidentification transformations
such as
|
inspectConfig.customInfoTypes[].likelihood ENUMERATION 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 |
inspectConfig.customInfoTypes[].exclusionType ENUMERATION If set to EXCLUSION_TYPE_EXCLUDE this infoType will not cause a finding to be returned. It still can be used for rules matching |
inspectConfig.customInfoTypes[].detectionRules[] OBJECT Deprecated; use |
displayName STRING Display name (max 256 chars) |
description STRING Short description (max 256 chars) |