airflow.providers.google.cloud.hooks.dlp¶
This module contains a CloudDLPHook which allows you to connect to Google Cloud DLP service.
Module Contents¶
Classes¶
Hook for Google Cloud Data Loss Prevention (DLP) APIs. |
Attributes¶
- airflow.providers.google.cloud.hooks.dlp.DLP_JOB_PATH_PATTERN = ^projects/[^/]+/dlpJobs/(?P<job>.*?)$[source]¶
- class airflow.providers.google.cloud.hooks.dlp.CloudDLPHook(gcp_conn_id='google_cloud_default', delegate_to=None, impersonation_chain=None)[source]¶
Bases:
airflow.providers.google.common.hooks.base_google.GoogleBaseHookHook for Google Cloud Data Loss Prevention (DLP) APIs. Cloud DLP allows clients to detect the presence of Personally Identifiable Information (PII) and other privacy-sensitive data in user-supplied, unstructured data streams, like text blocks or images. The service also includes methods for sensitive data redaction and scheduling of data scans on Google Cloud based data sets.
- Parameters
gcp_conn_id (str) – The connection ID to use when fetching connection info.
delegate_to (Optional[str]) – The account to impersonate using domain-wide delegation of authority, if any. For this to work, the service account making the request must have domain-wide delegation enabled.
impersonation_chain (Optional[Union[str, Sequence[str]]]) – Optional service account to impersonate using short-term credentials, or chained list of accounts required to get the access_token of the last account in the list, which will be impersonated in the request. If set as a string, the account must grant the originating account the Service Account Token Creator IAM role. If set as a sequence, the identities from the list must grant Service Account Token Creator IAM role to the directly preceding identity, with first account from the list granting this role to the originating account.
- get_conn()[source]¶
Provides a client for interacting with the Cloud DLP API.
- Returns
Google Cloud DLP API Client
- Return type
google.cloud.dlp_v2.DlpServiceClient
- cancel_dlp_job(dlp_job_id, project_id=PROVIDE_PROJECT_ID, retry=DEFAULT, timeout=None, metadata=())[source]¶
Starts asynchronous cancellation on a long-running DLP job.
- Parameters
dlp_job_id (str) – ID of the DLP job resource to be cancelled.
project_id (str) – (Optional) Google Cloud project ID where the DLP Instance exists. If set to None or missing, the default project_id from the Google Cloud connection is used.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- create_deidentify_template(organization_id=None, project_id=None, deidentify_template=None, template_id=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Creates a deidentify template for re-using frequently used configuration for de-identifying content, images, and storage.
- Parameters
organization_id (Optional[str]) – (Optional) The organization ID. Required to set this field if parent resource is an organization.
project_id (Optional[str]) – (Optional) Google Cloud project ID where the DLP Instance exists. Only set this field if the parent resource is a project instead of an organization.
deidentify_template (Optional[Union[dict, google.cloud.dlp_v2.types.DeidentifyTemplate]]) – (Optional) The de-identify template to create.
template_id (Optional[str]) – (Optional) The template ID.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- create_dlp_job(project_id=PROVIDE_PROJECT_ID, inspect_job=None, risk_job=None, job_id=None, retry=DEFAULT, timeout=None, metadata=(), wait_until_finished=True, time_to_sleep_in_seconds=60)[source]¶
Creates a new job to inspect storage or calculate risk metrics.
- Parameters
project_id (str) – (Optional) Google Cloud project ID where the DLP Instance exists. If set to None or missing, the default project_id from the Google Cloud connection is used.
inspect_job (Optional[Union[dict, google.cloud.dlp_v2.types.InspectJobConfig]]) – (Optional) The configuration for the inspect job.
risk_job (Optional[Union[dict, google.cloud.dlp_v2.types.RiskAnalysisJobConfig]]) – (Optional) The configuration for the risk job.
job_id (Optional[str]) – (Optional) The job ID.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
wait_until_finished (bool) – (Optional) If true, it will keep polling the job state until it is set to DONE.
time_to_sleep_in_seconds (int) – (Optional) Time to sleep, in seconds, between active checks of the operation results. Defaults to 60.
- Return type
- create_inspect_template(organization_id=None, project_id=None, inspect_template=None, template_id=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Creates an inspect template for re-using frequently used configuration for inspecting content, images, and storage.
- Parameters
organization_id (Optional[str]) – (Optional) The organization ID. Required to set this field if parent resource is an organization.
project_id (Optional[str]) – (Optional) Google Cloud project ID where the DLP Instance exists. Only set this field if the parent resource is a project instead of an organization.
inspect_template (Optional[google.cloud.dlp_v2.types.InspectTemplate]) – (Optional) The inspect template to create.
template_id (Optional[str]) – (Optional) The template ID.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- create_job_trigger(project_id=PROVIDE_PROJECT_ID, job_trigger=None, trigger_id=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Creates a job trigger to run DLP actions such as scanning storage for sensitive information on a set schedule.
- Parameters
project_id (str) – (Optional) Google Cloud project ID where the DLP Instance exists. If set to None or missing, the default project_id from the Google Cloud connection is used.
job_trigger (Optional[Union[dict, google.cloud.dlp_v2.types.JobTrigger]]) – (Optional) The job trigger to create.
trigger_id (Optional[str]) – (Optional) The job trigger ID.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- create_stored_info_type(organization_id=None, project_id=None, config=None, stored_info_type_id=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Creates a pre-built stored info type to be used for inspection.
- Parameters
organization_id (Optional[str]) – (Optional) The organization ID. Required to set this field if parent resource is an organization.
project_id (Optional[str]) – (Optional) Google Cloud project ID where the DLP Instance exists. Only set this field if the parent resource is a project instead of an organization.
config (Optional[Union[dict, google.cloud.dlp_v2.types.StoredInfoTypeConfig]]) – (Optional) The config for the stored info type.
stored_info_type_id (Optional[str]) – (Optional) The stored info type ID.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- deidentify_content(project_id=PROVIDE_PROJECT_ID, deidentify_config=None, inspect_config=None, item=None, inspect_template_name=None, deidentify_template_name=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
De-identifies potentially sensitive info from a content item. This method has limits on input size and output size.
- Parameters
project_id (str) – (Optional) Google Cloud project ID where the DLP Instance exists. If set to None or missing, the default project_id from the Google Cloud connection is used.
deidentify_config (Optional[Union[dict, google.cloud.dlp_v2.types.DeidentifyConfig]]) – (Optional) Configuration for the de-identification of the content item. Items specified here will override the template referenced by the deidentify_template_name argument.
inspect_config (Optional[Union[dict, google.cloud.dlp_v2.types.InspectConfig]]) – (Optional) Configuration for the inspector. Items specified here will override the template referenced by the inspect_template_name argument.
item (Optional[Union[dict, google.cloud.dlp_v2.types.ContentItem]]) – (Optional) The item to de-identify. Will be treated as text.
inspect_template_name (Optional[str]) – (Optional) Optional template to use. Any configuration directly specified in inspect_config will override those set in the template.
deidentify_template_name (Optional[str]) – (Optional) Optional template to use. Any configuration directly specified in deidentify_config will override those set in the template.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- delete_deidentify_template(template_id, organization_id=None, project_id=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Deletes a deidentify template.
- Parameters
template_id – The ID of deidentify template to be deleted.
organization_id – (Optional) The organization ID. Required to set this field if parent resource is an organization.
project_id – (Optional) Google Cloud project ID where the DLP Instance exists. Only set this field if the parent resource is a project instead of an organization.
retry – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata – (Optional) Additional metadata that is provided to the method.
- delete_dlp_job(dlp_job_id, project_id, retry=DEFAULT, timeout=None, metadata=())[source]¶
Deletes a long-running DLP job. This method indicates that the client is no longer interested in the DLP job result. The job will be cancelled if possible.
- Parameters
dlp_job_id (str) – The ID of the DLP job resource to be cancelled.
project_id (str) – (Optional) Google Cloud project ID where the DLP Instance exists. If set to None or missing, the default project_id from the Google Cloud connection is used.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- delete_inspect_template(template_id, organization_id=None, project_id=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Deletes an inspect template.
- Parameters
template_id (str) – The ID of the inspect template to be deleted.
organization_id (Optional[str]) – (Optional) The organization ID. Required to set this field if parent resource is an organization.
project_id (Optional[str]) – (Optional) Google Cloud project ID where the DLP Instance exists. Only set this field if the parent resource is a project instead of an organization.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- delete_job_trigger(job_trigger_id, project_id, retry=DEFAULT, timeout=None, metadata=())[source]¶
Deletes a job trigger.
- Parameters
job_trigger_id (str) – The ID of the DLP job trigger to be deleted.
project_id (str) – (Optional) Google Cloud project ID where the DLP Instance exists. If set to None or missing, the default project_id from the Google Cloud connection is used.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- delete_stored_info_type(stored_info_type_id, organization_id=None, project_id=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Deletes a stored info type.
- Parameters
stored_info_type_id (str) – The ID of the stored info type to be deleted.
organization_id (Optional[str]) – (Optional) The organization ID. Required to set this field if parent resource is an organization.
project_id (Optional[str]) – (Optional) Google Cloud project ID where the DLP Instance exists. Only set this field if the parent resource is a project instead of an organization.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- get_deidentify_template(template_id, organization_id=None, project_id=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Gets a deidentify template.
- Parameters
template_id (str) – The ID of deidentify template to be read.
organization_id (Optional[str]) – (Optional) The organization ID. Required to set this field if parent resource is an organization.
project_id (Optional[str]) – (Optional) Google Cloud project ID where the DLP Instance exists. Only set this field if the parent resource is a project instead of an organization.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- get_dlp_job(dlp_job_id, project_id, retry=DEFAULT, timeout=None, metadata=())[source]¶
Gets the latest state of a long-running Dlp Job.
- Parameters
dlp_job_id (str) – The ID of the DLP job resource to be read.
project_id (str) – (Optional) Google Cloud project ID where the DLP Instance exists. If set to None or missing, the default project_id from the Google Cloud connection is used.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- get_inspect_template(template_id, organization_id=None, project_id=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Gets an inspect template.
- Parameters
template_id (str) – The ID of inspect template to be read.
organization_id (Optional[str]) – (Optional) The organization ID. Required to set this field if parent resource is an organization.
project_id (Optional[str]) – (Optional) Google Cloud project ID where the DLP Instance exists. Only set this field if the parent resource is a project instead of an organization.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- get_job_trigger(job_trigger_id, project_id, retry=DEFAULT, timeout=None, metadata=())[source]¶
Gets a DLP job trigger.
- Parameters
job_trigger_id (str) – The ID of the DLP job trigger to be read.
project_id (str) – (Optional) Google Cloud project ID where the DLP Instance exists. If set to None or missing, the default project_id from the Google Cloud connection is used.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- get_stored_info_type(stored_info_type_id, organization_id=None, project_id=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Gets a stored info type.
- Parameters
stored_info_type_id (str) – The ID of the stored info type to be read.
organization_id (Optional[str]) – (Optional) The organization ID. Required to set this field if parent resource is an organization.
project_id (Optional[str]) – (Optional) Google Cloud project ID where the DLP Instance exists. Only set this field if the parent resource is a project instead of an organization.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- inspect_content(project_id, inspect_config=None, item=None, inspect_template_name=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Finds potentially sensitive info in content. This method has limits on input size, processing time, and output size.
- Parameters
project_id (str) – (Optional) Google Cloud project ID where the DLP Instance exists. If set to None or missing, the default project_id from the Google Cloud connection is used.
inspect_config (Optional[Union[dict, google.cloud.dlp_v2.types.InspectConfig]]) – (Optional) Configuration for the inspector. Items specified here will override the template referenced by the inspect_template_name argument.
item (Optional[Union[dict, google.cloud.dlp_v2.types.ContentItem]]) – (Optional) The item to de-identify. Will be treated as text.
inspect_template_name (Optional[str]) – (Optional) Optional template to use. Any configuration directly specified in inspect_config will override those set in the template.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- list_deidentify_templates(organization_id=None, project_id=None, page_size=None, order_by=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Lists deidentify templates.
- Parameters
organization_id (Optional[str]) – (Optional) The organization ID. Required to set this field if parent resource is an organization.
project_id (Optional[str]) – (Optional) Google Cloud project ID where the DLP Instance exists. Only set this field if the parent resource is a project instead of an organization.
page_size (Optional[int]) – (Optional) The maximum number of resources contained in the underlying API response.
order_by (Optional[str]) – (Optional) Optional comma separated list of fields to order by, followed by asc or desc postfix.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- list_dlp_jobs(project_id, results_filter=None, page_size=None, job_type=None, order_by=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Lists DLP jobs that match the specified filter in the request.
- Parameters
project_id (str) – (Optional) Google Cloud project ID where the DLP Instance exists. If set to None or missing, the default project_id from the Google Cloud connection is used.
results_filter (Optional[str]) – (Optional) Filter used to specify a subset of results.
page_size (Optional[int]) – (Optional) The maximum number of resources contained in the underlying API response.
job_type (Optional[str]) – (Optional) The type of job.
order_by (Optional[str]) – (Optional) Optional comma separated list of fields to order by, followed by asc or desc postfix.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- list_info_types(language_code=None, results_filter=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Returns a list of the sensitive information types that the DLP API supports.
- Parameters
language_code (Optional[str]) – (Optional) Optional BCP-47 language code for localized info type friendly names. If omitted, or if localized strings are not available, en-US strings will be returned.
results_filter (Optional[str]) – (Optional) Filter used to specify a subset of results.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- list_inspect_templates(organization_id=None, project_id=None, page_size=None, order_by=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Lists inspect templates.
- Parameters
organization_id (Optional[str]) – (Optional) The organization ID. Required to set this field if parent resource is an organization.
project_id (Optional[str]) – (Optional) Google Cloud project ID where the DLP Instance exists. Only set this field if the parent resource is a project instead of an organization.
page_size (Optional[int]) – (Optional) The maximum number of resources contained in the underlying API response.
order_by (Optional[str]) – (Optional) Optional comma separated list of fields to order by, followed by asc or desc postfix.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- list_job_triggers(project_id, page_size=None, order_by=None, results_filter=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Lists job triggers.
- Parameters
project_id (str) – (Optional) Google Cloud project ID where the DLP Instance exists. If set to None or missing, the default project_id from the Google Cloud connection is used.
page_size (Optional[int]) – (Optional) The maximum number of resources contained in the underlying API response.
order_by (Optional[str]) – (Optional) Optional comma separated list of fields to order by, followed by asc or desc postfix.
results_filter (Optional[str]) – (Optional) Filter used to specify a subset of results.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- list_stored_info_types(organization_id=None, project_id=None, page_size=None, order_by=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Lists stored info types.
- Parameters
organization_id (Optional[str]) – (Optional) The organization ID. Required to set this field if parent resource is an organization.
project_id (Optional[str]) – (Optional) Google Cloud project ID where the DLP Instance exists. Only set this field if the parent resource is a project instead of an organization.
page_size (Optional[int]) – (Optional) The maximum number of resources contained in the underlying API response.
order_by (Optional[str]) – (Optional) Optional comma separated list of fields to order by, followed by asc or desc postfix.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- redact_image(project_id, inspect_config=None, image_redaction_configs=None, include_findings=None, byte_item=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Redacts potentially sensitive info from an image. This method has limits on input size, processing time, and output size.
- Parameters
project_id (str) – (Optional) Google Cloud project ID where the DLP Instance exists. If set to None or missing, the default project_id from the Google Cloud connection is used.
inspect_config (Optional[Union[dict, google.cloud.dlp_v2.types.InspectConfig]]) – (Optional) Configuration for the inspector. Items specified here will override the template referenced by the inspect_template_name argument.
image_redaction_configs (Optional[Union[List[dict], List[google.cloud.dlp_v2.types.RedactImageRequest.ImageRedactionConfig]]]) – (Optional) The configuration for specifying what content to redact from images. List[google.cloud.dlp_v2.types.RedactImageRequest.ImageRedactionConfig]
include_findings (Optional[bool]) – (Optional) Whether the response should include findings along with the redacted image.
byte_item (Optional[Union[dict, google.cloud.dlp_v2.types.ByteContentItem]]) – (Optional) The content must be PNG, JPEG, SVG or BMP.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- reidentify_content(project_id, reidentify_config=None, inspect_config=None, item=None, inspect_template_name=None, reidentify_template_name=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Re-identifies content that has been de-identified.
- Parameters
project_id (str) – (Optional) Google Cloud project ID where the DLP Instance exists. If set to None or missing, the default project_id from the Google Cloud connection is used.
reidentify_config (Optional[Union[dict, google.cloud.dlp_v2.types.DeidentifyConfig]]) – (Optional) Configuration for the re-identification of the content item.
inspect_config (Optional[Union[dict, google.cloud.dlp_v2.types.InspectConfig]]) – (Optional) Configuration for the inspector.
item (Optional[Union[dict, google.cloud.dlp_v2.types.ContentItem]]) – (Optional) The item to re-identify. Will be treated as text.
inspect_template_name (Optional[str]) – (Optional) Optional template to use. Any configuration directly specified in inspect_config will override those set in the template.
reidentify_template_name (Optional[str]) – (Optional) Optional template to use. References an instance of deidentify template. Any configuration directly specified in reidentify_config or inspect_config will override those set in the template.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- update_deidentify_template(template_id, organization_id=None, project_id=None, deidentify_template=None, update_mask=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Updates the deidentify template.
- Parameters
template_id (str) – The ID of deidentify template to be updated.
organization_id (Optional[str]) – (Optional) The organization ID. Required to set this field if parent resource is an organization.
project_id (Optional[str]) – (Optional) Google Cloud project ID where the DLP Instance exists. Only set this field if the parent resource is a project instead of an organization.
deidentify_template (Optional[Union[dict, google.cloud.dlp_v2.types.DeidentifyTemplate]]) – New deidentify template value.
update_mask (Optional[Union[dict, google.cloud.dlp_v2.types.FieldMask]]) – Mask to control which fields get updated.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- update_inspect_template(template_id, organization_id=None, project_id=None, inspect_template=None, update_mask=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Updates the inspect template.
- Parameters
template_id (str) – The ID of the inspect template to be updated.
organization_id (Optional[str]) – (Optional) The organization ID. Required to set this field if parent resource is an organization.
project_id (Optional[str]) – (Optional) Google Cloud project ID where the DLP Instance exists. Only set this field if the parent resource is a project instead of an organization.
inspect_template (Optional[Union[dict, google.cloud.dlp_v2.types.InspectTemplate]]) – New inspect template value.
update_mask (Optional[Union[dict, google.cloud.dlp_v2.types.FieldMask]]) – Mask to control which fields get updated.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- update_job_trigger(job_trigger_id, project_id, job_trigger=None, update_mask=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Updates a job trigger.
- Parameters
job_trigger_id (str) – The ID of the DLP job trigger to be updated.
project_id (str) – (Optional) Google Cloud project ID where the DLP Instance exists. If set to None or missing, the default project_id from the Google Cloud connection is used.
job_trigger (Optional[Union[dict, google.cloud.dlp_v2.types.JobTrigger]]) – New job trigger value.
update_mask (Optional[Union[dict, google.cloud.dlp_v2.types.FieldMask]]) – Mask to control which fields get updated.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type
- update_stored_info_type(stored_info_type_id, organization_id=None, project_id=None, config=None, update_mask=None, retry=DEFAULT, timeout=None, metadata=())[source]¶
Updates the stored info type by creating a new version.
- Parameters
stored_info_type_id (str) – The ID of the stored info type to be updated.
organization_id (Optional[str]) – (Optional) The organization ID. Required to set this field if parent resource is an organization.
project_id (Optional[str]) – (Optional) Google Cloud project ID where the DLP Instance exists. Only set this field if the parent resource is a project instead of an organization.
config (Optional[Union[dict, google.cloud.dlp_v2.types.StoredInfoTypeConfig]]) – Updated configuration for the stored info type. If not provided, a new version of the stored info type will be created with the existing configuration.
update_mask (Optional[Union[dict, google.cloud.dlp_v2.types.FieldMask]]) – Mask to control which fields get updated.
retry (Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault]) – (Optional) A retry object used to retry requests. If None is specified, requests will not be retried.
timeout (Optional[float]) – (Optional) The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata (Sequence[Tuple[str, str]]) – (Optional) Additional metadata that is provided to the method.
- Return type