* $dlpService = new Google\Service\DLP(...); * $jobTriggers = $dlpService->jobTriggers; * */ class ProjectsLocationsJobTriggers extends \Google\Service\Resource { /** * Activate a job trigger. Causes the immediate execute of a trigger instead of * waiting on the trigger event to occur. (jobTriggers.activate) * * @param string $name Required. Resource name of the trigger to activate, for * example `projects/dlp-test-project/jobTriggers/53234423`. * @param GooglePrivacyDlpV2ActivateJobTriggerRequest $postBody * @param array $optParams Optional parameters. * @return GooglePrivacyDlpV2DlpJob */ public function activate($name, GooglePrivacyDlpV2ActivateJobTriggerRequest $postBody, $optParams = []) { $params = ['name' => $name, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('activate', [$params], GooglePrivacyDlpV2DlpJob::class); } /** * Creates a job trigger to run DLP actions such as scanning storage for * sensitive information on a set schedule. See * https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. * (jobTriggers.create) * * @param string $parent Required. Parent resource name. The format of this * value varies depending on whether you have [specified a processing * location](https://cloud.google.com/dlp/docs/specifying-location): + Projects * scope, location specified: `projects/`PROJECT_ID`/locations/`LOCATION_ID + * Projects scope, no location specified (defaults to global): * `projects/`PROJECT_ID The following example `parent` string specifies a * parent project with the identifier `example-project`, and specifies the * `europe-west3` location for processing data: parent=projects/example- * project/locations/europe-west3 * @param GooglePrivacyDlpV2CreateJobTriggerRequest $postBody * @param array $optParams Optional parameters. * @return GooglePrivacyDlpV2JobTrigger */ public function create($parent, GooglePrivacyDlpV2CreateJobTriggerRequest $postBody, $optParams = []) { $params = ['parent' => $parent, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('create', [$params], GooglePrivacyDlpV2JobTrigger::class); } /** * Deletes a job trigger. See https://cloud.google.com/dlp/docs/creating-job- * triggers to learn more. (jobTriggers.delete) * * @param string $name Required. Resource name of the project and the * triggeredJob, for example `projects/dlp-test-project/jobTriggers/53234423`. * @param array $optParams Optional parameters. * @return GoogleProtobufEmpty */ public function delete($name, $optParams = []) { $params = ['name' => $name]; $params = array_merge($params, $optParams); return $this->call('delete', [$params], GoogleProtobufEmpty::class); } /** * Gets a job trigger. See https://cloud.google.com/dlp/docs/creating-job- * triggers to learn more. (jobTriggers.get) * * @param string $name Required. Resource name of the project and the * triggeredJob, for example `projects/dlp-test-project/jobTriggers/53234423`. * @param array $optParams Optional parameters. * @return GooglePrivacyDlpV2JobTrigger */ public function get($name, $optParams = []) { $params = ['name' => $name]; $params = array_merge($params, $optParams); return $this->call('get', [$params], GooglePrivacyDlpV2JobTrigger::class); } /** * Inspect hybrid content and store findings to a trigger. The inspection will * be processed asynchronously. To review the findings monitor the jobs within * the trigger. (jobTriggers.hybridInspect) * * @param string $name Required. Resource name of the trigger to execute a * hybrid inspect on, for example `projects/dlp-test- * project/jobTriggers/53234423`. * @param GooglePrivacyDlpV2HybridInspectJobTriggerRequest $postBody * @param array $optParams Optional parameters. * @return GooglePrivacyDlpV2HybridInspectResponse */ public function hybridInspect($name, GooglePrivacyDlpV2HybridInspectJobTriggerRequest $postBody, $optParams = []) { $params = ['name' => $name, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('hybridInspect', [$params], GooglePrivacyDlpV2HybridInspectResponse::class); } /** * Lists job triggers. See https://cloud.google.com/dlp/docs/creating-job- * triggers to learn more. (jobTriggers.listProjectsLocationsJobTriggers) * * @param string $parent Required. Parent resource name. The format of this * value varies depending on whether you have [specified a processing * location](https://cloud.google.com/dlp/docs/specifying-location): + Projects * scope, location specified: `projects/`PROJECT_ID`/locations/`LOCATION_ID + * Projects scope, no location specified (defaults to global): * `projects/`PROJECT_ID The following example `parent` string specifies a * parent project with the identifier `example-project`, and specifies the * `europe-west3` location for processing data: parent=projects/example- * project/locations/europe-west3 * @param array $optParams Optional parameters. * * @opt_param string filter Allows filtering. Supported syntax: * Filter * expressions are made up of one or more restrictions. * Restrictions can be * combined by `AND` or `OR` logical operators. A sequence of restrictions * implicitly uses `AND`. * A restriction has the form of `{field} {operator} * {value}`. * Supported fields/values for inspect triggers: - `status` - * HEALTHY|PAUSED|CANCELLED - `inspected_storage` - * DATASTORE|CLOUD_STORAGE|BIGQUERY - 'last_run_time` - RFC 3339 formatted * timestamp, surrounded by quotation marks. Nanoseconds are ignored. - * 'error_count' - Number of errors that have occurred while running. * The * operator must be `=` or `!=` for status and inspected_storage. Examples: * * inspected_storage = cloud_storage AND status = HEALTHY * inspected_storage = * cloud_storage OR inspected_storage = bigquery * inspected_storage = * cloud_storage AND (state = PAUSED OR state = HEALTHY) * last_run_time > * \"2017-12-12T00:00:00+00:00\" The length of this field should be no more than * 500 characters. * @opt_param string locationId Deprecated. This field has no effect. * @opt_param string orderBy Comma separated list of triggeredJob fields to * order by, followed by `asc` or `desc` postfix. This list is case-insensitive, * default sorting order is ascending, redundant space characters are * insignificant. Example: `name asc,update_time, create_time desc` Supported * fields are: - `create_time`: corresponds to time the JobTrigger was created. * - `update_time`: corresponds to time the JobTrigger was last updated. - * `last_run_time`: corresponds to the last time the JobTrigger ran. - `name`: * corresponds to JobTrigger's name. - `display_name`: corresponds to * JobTrigger's display name. - `status`: corresponds to JobTrigger's status. * @opt_param int pageSize Size of the page, can be limited by a server. * @opt_param string pageToken Page token to continue retrieval. Comes from * previous call to ListJobTriggers. `order_by` field must not change for * subsequent calls. * @opt_param string type The type of jobs. Will use `DlpJobType.INSPECT` if not * set. * @return GooglePrivacyDlpV2ListJobTriggersResponse */ public function listProjectsLocationsJobTriggers($parent, $optParams = []) { $params = ['parent' => $parent]; $params = array_merge($params, $optParams); return $this->call('list', [$params], GooglePrivacyDlpV2ListJobTriggersResponse::class); } /** * Updates a job trigger. See https://cloud.google.com/dlp/docs/creating-job- * triggers to learn more. (jobTriggers.patch) * * @param string $name Required. Resource name of the project and the * triggeredJob, for example `projects/dlp-test-project/jobTriggers/53234423`. * @param GooglePrivacyDlpV2UpdateJobTriggerRequest $postBody * @param array $optParams Optional parameters. * @return GooglePrivacyDlpV2JobTrigger */ public function patch($name, GooglePrivacyDlpV2UpdateJobTriggerRequest $postBody, $optParams = []) { $params = ['name' => $name, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('patch', [$params], GooglePrivacyDlpV2JobTrigger::class); } } // Adding a class alias for backwards compatibility with the previous class name. class_alias(ProjectsLocationsJobTriggers::class, 'Google_Service_DLP_Resource_ProjectsLocationsJobTriggers');