Google Cloud Web Security Scanner V1beta Client - Class ScanRun (0.8.3)

Reference documentation and code samples for the Google Cloud Web Security Scanner V1beta Client class ScanRun.

A ScanRun is a output-only resource representing an actual run of the scan.

Next id: 12

Generated from protobuf message google.cloud.websecurityscanner.v1beta.ScanRun

Namespace

Google \ Cloud \ WebSecurityScanner \ V1beta

Methods

__construct

Constructor.

Parameters
Name Description
data array

Optional. Data for populating the Message object.

↳ name string

The resource name of the ScanRun. The name follows the format of 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'. The ScanRun IDs are generated by the system.

↳ execution_state int

The execution state of the ScanRun.

↳ result_state int

The result state of the ScanRun. This field is only available after the execution state reaches "FINISHED".

↳ start_time Google\Protobuf\Timestamp

The time at which the ScanRun started.

↳ end_time Google\Protobuf\Timestamp

The time at which the ScanRun reached termination state - that the ScanRun is either finished or stopped by user.

↳ urls_crawled_count int|string

The number of URLs crawled during this ScanRun. If the scan is in progress, the value represents the number of URLs crawled up to now.

↳ urls_tested_count int|string

The number of URLs tested during this ScanRun. If the scan is in progress, the value represents the number of URLs tested up to now. The number of URLs tested is usually larger than the number URLS crawled because typically a crawled URL is tested with multiple test payloads.

↳ has_vulnerabilities bool

Whether the scan run has found any vulnerabilities.

↳ progress_percent int

The percentage of total completion ranging from 0 to 100. If the scan is in queue, the value is 0. If the scan is running, the value ranges from 0 to 100. If the scan is finished, the value is 100.

↳ error_trace Google\Cloud\WebSecurityScanner\V1beta\ScanRunErrorTrace

If result_state is an ERROR, this field provides the primary reason for scan's termination and more details, if such are available.

↳ warning_traces array<Google\Cloud\WebSecurityScanner\V1beta\ScanRunWarningTrace>

A list of warnings, if such are encountered during this scan run.

getName

The resource name of the ScanRun. The name follows the format of 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.

The ScanRun IDs are generated by the system.

Returns
Type Description
string

setName

The resource name of the ScanRun. The name follows the format of 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.

The ScanRun IDs are generated by the system.

Parameter
Name Description
var string
Returns
Type Description
$this

getExecutionState

The execution state of the ScanRun.

Returns
Type Description
int

setExecutionState

The execution state of the ScanRun.

Parameter
Name Description
var int
Returns
Type Description
$this

getResultState

The result state of the ScanRun. This field is only available after the execution state reaches "FINISHED".

Returns
Type Description
int

setResultState

The result state of the ScanRun. This field is only available after the execution state reaches "FINISHED".

Parameter
Name Description
var int
Returns
Type Description
$this

getStartTime

The time at which the ScanRun started.

Returns
Type Description
Google\Protobuf\Timestamp|null

hasStartTime

clearStartTime

setStartTime

The time at which the ScanRun started.

Parameter
Name Description
var Google\Protobuf\Timestamp
Returns
Type Description
$this

getEndTime

The time at which the ScanRun reached termination state - that the ScanRun is either finished or stopped by user.

Returns
Type Description
Google\Protobuf\Timestamp|null

hasEndTime

clearEndTime

setEndTime

The time at which the ScanRun reached termination state - that the ScanRun is either finished or stopped by user.

Parameter
Name Description
var Google\Protobuf\Timestamp
Returns
Type Description
$this

getUrlsCrawledCount

The number of URLs crawled during this ScanRun. If the scan is in progress, the value represents the number of URLs crawled up to now.

Returns
Type Description
int|string

setUrlsCrawledCount

The number of URLs crawled during this ScanRun. If the scan is in progress, the value represents the number of URLs crawled up to now.

Parameter
Name Description
var int|string
Returns
Type Description
$this

getUrlsTestedCount

The number of URLs tested during this ScanRun. If the scan is in progress, the value represents the number of URLs tested up to now. The number of URLs tested is usually larger than the number URLS crawled because typically a crawled URL is tested with multiple test payloads.

Returns
Type Description
int|string

setUrlsTestedCount

The number of URLs tested during this ScanRun. If the scan is in progress, the value represents the number of URLs tested up to now. The number of URLs tested is usually larger than the number URLS crawled because typically a crawled URL is tested with multiple test payloads.

Parameter
Name Description
var int|string
Returns
Type Description
$this

getHasVulnerabilities

Whether the scan run has found any vulnerabilities.

Returns
Type Description
bool

setHasVulnerabilities

Whether the scan run has found any vulnerabilities.

Parameter
Name Description
var bool
Returns
Type Description
$this

getProgressPercent

The percentage of total completion ranging from 0 to 100.

If the scan is in queue, the value is 0. If the scan is running, the value ranges from 0 to 100. If the scan is finished, the value is 100.

Returns
Type Description
int

setProgressPercent

The percentage of total completion ranging from 0 to 100.

If the scan is in queue, the value is 0. If the scan is running, the value ranges from 0 to 100. If the scan is finished, the value is 100.

Parameter
Name Description
var int
Returns
Type Description
$this

getErrorTrace

If result_state is an ERROR, this field provides the primary reason for scan's termination and more details, if such are available.

Returns
Type Description
Google\Cloud\WebSecurityScanner\V1beta\ScanRunErrorTrace|null

hasErrorTrace

clearErrorTrace

setErrorTrace

If result_state is an ERROR, this field provides the primary reason for scan's termination and more details, if such are available.

Parameter
Name Description
var Google\Cloud\WebSecurityScanner\V1beta\ScanRunErrorTrace
Returns
Type Description
$this

getWarningTraces

A list of warnings, if such are encountered during this scan run.

Returns
Type Description
Google\Protobuf\Internal\RepeatedField

setWarningTraces

A list of warnings, if such are encountered during this scan run.

Parameter
Name Description
var array<Google\Cloud\WebSecurityScanner\V1beta\ScanRunWarningTrace>
Returns
Type Description
$this