Cloud Audit Logs for On-Demand Scanning API let you track administrative and
data-access operations on your resources to help you monitor access and
configuration changes. You can query these logs in the Logs Explorer and
check which On-Demand Scanning API API methods generate Cloud Audit Logs.

For more information about Cloud Audit Logs,
see the following documents:

- [Types of audit logs](https://docs.cloud.google.com/logging/docs/audit#types)
- [Audit log entry structure](https://docs.cloud.google.com/logging/docs/audit#audit_log_entry_structure)
- [Storing and routing audit logs](https://docs.cloud.google.com/logging/docs/audit#storing_and_routing_audit_logs)
- [Cloud Logging pricing summary](https://docs.cloud.google.com/stackdriver/pricing#logs-pricing-summary)
- [Enable Data Access audit logs](https://docs.cloud.google.com/logging/docs/audit/configure-data-access)

<br />

## Service name

To view the On-Demand Scanning API audit logs, do the following:

1. In the Google Cloud console, go to the Logs Explorer page:

   [Go to Logs Explorer](https://console.cloud.google.com/logs/query)
2. Copy and paste the following query into the **Query** field of the
   Logs Explorer, and then click **Run query**.

   ```
       protoPayload.serviceName="ondemandscanning.googleapis.com"
     
   ```

## Methods by permission type

Each IAM permission has a `type` property, whose value is an enum
that can be one of four values: `ADMIN_READ`, `ADMIN_WRITE`,
`DATA_READ`, or `DATA_WRITE`. When you call a method,
On-Demand Scanning API generates an audit log whose category is dependent on the
`type` property of the permission required to perform the method.

Methods that require an IAM permission with the `type` property value
of `DATA_READ`, `DATA_WRITE`, or `ADMIN_READ` generate
[Data Access](https://docs.cloud.google.com/logging/docs/audit#data-access) audit logs.

Methods that require an IAM permission with the `type` property value
of `ADMIN_WRITE` generate
[Admin Activity](https://docs.cloud.google.com/logging/docs/audit#admin-activity) audit logs.
API methods in the following list that are marked with (LRO) are long-running operations (LROs). These methods usually generate two audit log entries: one when the operation starts and another when it ends. For more information see [Audit logs for long-running operations](https://docs.cloud.google.com/logging/docs/audit/understanding-audit-logs#lro).

| Permission type | Methods |
|---|---|
| `DATA_READ` | `google.cloud.ondemandscanning.v1.ScannerService.ListVulnerabilities` `google.cloud.ondemandscanning.v1beta1.ScannerService.ListVulnerabilities` |
| `DATA_WRITE` | `google.cloud.ondemandscanning.v1.ScannerService.AnalyzePackages` (LRO) `google.cloud.ondemandscanning.v1beta1.ScannerService.AnalyzePackages` (LRO) |

## API interface audit logs

For information about how and which permissions are evaluated for each method,
see the Identity and Access Management documentation for On-Demand Scanning API.

### `google.cloud.ondemandscanning.v1.ScannerService`

The following audit logs are associated with methods belonging to
`google.cloud.ondemandscanning.v1.ScannerService`.

#### `AnalyzePackages`

- **Method** : `google.cloud.ondemandscanning.v1.ScannerService.AnalyzePackages`  
- **Audit log type** : [Data access](https://docs.cloud.google.com/logging/docs/audit#data-access)  
- **Permissions** :
  - `ondemandscanning.scans.analyzePackages - DATA_WRITE`
- **Method is a long-running or streaming operation** : [**Long-running operation**](https://docs.cloud.google.com/logging/docs/audit/understanding-audit-logs#lro)   
- **Filter for this method** : `
  protoPayload.methodName="google.cloud.ondemandscanning.v1.ScannerService.AnalyzePackages"
  `  

#### `ListVulnerabilities`

- **Method** : `google.cloud.ondemandscanning.v1.ScannerService.ListVulnerabilities`  
- **Audit log type** : [Data access](https://docs.cloud.google.com/logging/docs/audit#data-access)  
- **Permissions** :
  - `ondemandscanning.scans.listVulnerabilities - DATA_READ`
- **Method is a long-running or streaming operation** : No.  
- **Filter for this method** : `
  protoPayload.methodName="google.cloud.ondemandscanning.v1.ScannerService.ListVulnerabilities"
  `  

### `google.cloud.ondemandscanning.v1beta1.ScannerService`

The following audit logs are associated with methods belonging to
`google.cloud.ondemandscanning.v1beta1.ScannerService`.

#### `AnalyzePackages`

- **Method** : `google.cloud.ondemandscanning.v1beta1.ScannerService.AnalyzePackages`  
- **Audit log type** : [Data access](https://docs.cloud.google.com/logging/docs/audit#data-access)  
- **Permissions** :
  - `ondemandscanning.scans.analyzePackages - DATA_WRITE`
- **Method is a long-running or streaming operation** : [**Long-running operation**](https://docs.cloud.google.com/logging/docs/audit/understanding-audit-logs#lro)   
- **Filter for this method** : `
  protoPayload.methodName="google.cloud.ondemandscanning.v1beta1.ScannerService.AnalyzePackages"
  `  

#### `ListVulnerabilities`

- **Method** : `google.cloud.ondemandscanning.v1beta1.ScannerService.ListVulnerabilities`  
- **Audit log type** : [Data access](https://docs.cloud.google.com/logging/docs/audit#data-access)  
- **Permissions** :
  - `ondemandscanning.scans.listVulnerabilities - DATA_READ`
- **Method is a long-running or streaming operation** : No.  
- **Filter for this method** : `
  protoPayload.methodName="google.cloud.ondemandscanning.v1beta1.ScannerService.ListVulnerabilities"
  `