chore: regens API reference docs (#889)
diff --git a/docs/dyn/containeranalysis_v1alpha1.projects.notes.occurrences.html b/docs/dyn/containeranalysis_v1alpha1.projects.notes.occurrences.html
index 0a9d7ea..59cef8a 100644
--- a/docs/dyn/containeranalysis_v1alpha1.projects.notes.occurrences.html
+++ b/docs/dyn/containeranalysis_v1alpha1.projects.notes.occurrences.html
@@ -105,6 +105,61 @@
"nextPageToken": "A String", # Token to receive the next page of notes.
"occurrences": [ # The occurrences attached to the specified note.
{ # `Occurrence` includes information about analysis occurrences for an image.
+ "vulnerabilityDetails": { # Used by Occurrence to point to where the vulnerability exists and how # Details of a security vulnerability note.
+ # to fix it.
+ "packageIssue": [ # The set of affected locations and their fixes (if available) within
+ # the associated resource.
+ { # This message wraps a location affected by a vulnerability and its
+ # associated fix (if one is available).
+ "severityName": "A String",
+ "affectedLocation": { # The location of the vulnerability # The location of the vulnerability.
+ "cpeUri": "A String", # The cpe_uri in [cpe format] (https://cpe.mitre.org/specification/)
+ # format. Examples include distro or storage location for vulnerable jar.
+ # This field can be used as a filter in list requests.
+ "version": { # Version contains structured information about the version of the package. # The version of the package being described. This field can be used as a
+ # filter in list requests.
+ # For a discussion of this in Debian/Ubuntu:
+ # http://serverfault.com/questions/604541/debian-packages-version-convention
+ # For a discussion of this in Redhat/Fedora/Centos:
+ # http://blog.jasonantman.com/2014/07/how-yum-and-rpm-compare-versions/
+ "epoch": 42, # Used to correct mistakes in the version numbering scheme.
+ "name": "A String", # The main part of the version name.
+ "kind": "A String", # Distinguish between sentinel MIN/MAX versions and normal versions.
+ # If kind is not NORMAL, then the other fields are ignored.
+ "revision": "A String", # The iteration of the package build from the above version.
+ },
+ "package": "A String", # The package being described.
+ },
+ "fixedLocation": { # The location of the vulnerability # The location of the available fix for vulnerability.
+ "cpeUri": "A String", # The cpe_uri in [cpe format] (https://cpe.mitre.org/specification/)
+ # format. Examples include distro or storage location for vulnerable jar.
+ # This field can be used as a filter in list requests.
+ "version": { # Version contains structured information about the version of the package. # The version of the package being described. This field can be used as a
+ # filter in list requests.
+ # For a discussion of this in Debian/Ubuntu:
+ # http://serverfault.com/questions/604541/debian-packages-version-convention
+ # For a discussion of this in Redhat/Fedora/Centos:
+ # http://blog.jasonantman.com/2014/07/how-yum-and-rpm-compare-versions/
+ "epoch": 42, # Used to correct mistakes in the version numbering scheme.
+ "name": "A String", # The main part of the version name.
+ "kind": "A String", # Distinguish between sentinel MIN/MAX versions and normal versions.
+ # If kind is not NORMAL, then the other fields are ignored.
+ "revision": "A String", # The iteration of the package build from the above version.
+ },
+ "package": "A String", # The package being described.
+ },
+ },
+ ],
+ "type": "A String", # The type of package; whether native or non native(ruby gems,
+ # node.js packages etc)
+ "cvssScore": 3.14, # Output only. The CVSS score of this vulnerability. CVSS score is on a
+ # scale of 0-10 where 0 indicates low severity and 10 indicates high
+ # severity.
+ "severity": "A String", # Output only. The note provider assigned Severity of the vulnerability.
+ "effectiveSeverity": "A String", # The distro assigned severity for this vulnerability when that is
+ # available and note provider assigned severity when distro has not yet
+ # assigned a severity for this vulnerability.
+ },
"resource": { # #
# The resource for which the `Occurrence` applies.
# Resource is an entity that can have metadata. E.g., a Docker image.
@@ -112,11 +167,41 @@
"type": "A String", # The type of hash that was performed.
"value": "A String", # The hash value.
},
+ "name": "A String", # The name of the resource. E.g., the name of a Docker image - "Debian".
"uri": "A String", # The unique URI of the resource. E.g.,
# "https://gcr.io/project/image@sha256:foo" for a Docker image.
- "name": "A String", # The name of the resource. E.g., the name of a Docker image - "Debian".
},
"updateTime": "A String", # Output only. The time this `Occurrence` was last updated.
+ "upgrade": { # An Upgrade Occurrence represents that a specific resource_url could install a # Describes an upgrade.
+ # specific upgrade. This presence is supplied via local sources (i.e. it is
+ # present in the mirror and the running system has noticed its availability).
+ "distribution": { # The Upgrade Distribution represents metadata about the Upgrade for each # Metadata about the upgrade for available for the specific operating system
+ # for the resource_url. This allows efficient filtering, as well as
+ # making it easier to use the occurrence.
+ # operating system (CPE). Some distributions have additional metadata around
+ # updates, classifying them into various categories and severities.
+ "cpeUri": "A String", # Required - The specific operating system this metadata applies to. See
+ # https://cpe.mitre.org/specification/.
+ "cve": [ # The cve that would be resolved by this upgrade.
+ "A String",
+ ],
+ "severity": "A String", # The severity as specified by the upstream operating system.
+ "classification": "A String", # The operating system classification of this Upgrade, as specified by the
+ # upstream operating system upgrade feed.
+ },
+ "parsedVersion": { # Version contains structured information about the version of the package. # Required - The version of the package in a machine + human readable form.
+ # For a discussion of this in Debian/Ubuntu:
+ # http://serverfault.com/questions/604541/debian-packages-version-convention
+ # For a discussion of this in Redhat/Fedora/Centos:
+ # http://blog.jasonantman.com/2014/07/how-yum-and-rpm-compare-versions/
+ "epoch": 42, # Used to correct mistakes in the version numbering scheme.
+ "name": "A String", # The main part of the version name.
+ "kind": "A String", # Distinguish between sentinel MIN/MAX versions and normal versions.
+ # If kind is not NORMAL, then the other fields are ignored.
+ "revision": "A String", # The iteration of the package build from the above version.
+ },
+ "package": "A String", # Required - The package this Upgrade is for.
+ },
"installation": { # This represents how a particular software package may be installed on # Describes the installation of a package on the linked resource.
# a system.
"location": [ # All of the places within the filesystem versions of this package
@@ -132,11 +217,11 @@
# http://serverfault.com/questions/604541/debian-packages-version-convention
# For a discussion of this in Redhat/Fedora/Centos:
# http://blog.jasonantman.com/2014/07/how-yum-and-rpm-compare-versions/
+ "epoch": 42, # Used to correct mistakes in the version numbering scheme.
+ "name": "A String", # The main part of the version name.
"kind": "A String", # Distinguish between sentinel MIN/MAX versions and normal versions.
# If kind is not NORMAL, then the other fields are ignored.
"revision": "A String", # The iteration of the package build from the above version.
- "name": "A String", # The main part of the version name.
- "epoch": 42, # Used to correct mistakes in the version numbering scheme.
},
},
],
@@ -183,9 +268,9 @@
# Repository.
"projectId": "A String", # ID of the project that owns the repo.
"branchName": "A String", # Name of the branch to build.
- "repoName": "A String", # Name of the repo.
- "tagName": "A String", # Name of the tag to build.
"commitSha": "A String", # Explicit commit SHA to build.
+ "tagName": "A String", # Name of the tag to build.
+ "repoName": "A String", # Name of the repo.
},
"fileHashes": { # Hash(es) of the build source, which can be used to verify that the original
# source integrity was maintained in the build.
@@ -214,8 +299,7 @@
"git": { # A GitSourceContext denotes a particular revision in a third party Git # A SourceContext referring to any third party Git repo (e.g., GitHub).
# repository (e.g., GitHub).
"url": "A String", # Git repository URL.
- "revisionId": "A String", # Required.
- # Git commit hash.
+ "revisionId": "A String", # Required. Git commit hash.
},
"cloudRepo": { # A CloudRepoSourceContext denotes a particular revision in a Google Cloud # A SourceContext referring to a revision in a Google Cloud Source Repo.
# Source Repo.
@@ -225,12 +309,12 @@
},
"revisionId": "A String", # A revision ID.
"repoId": { # A unique identifier for a Cloud Repo. # The ID of the repo.
+ "uid": "A String", # A server-assigned, globally unique identifier.
"projectRepoId": { # Selects a repo using a Google Cloud Platform project ID (e.g., # A combination of a project ID and a repo name.
# winged-cargo-31) and a repo name within that project.
"projectId": "A String", # The ID of the project.
"repoName": "A String", # The name of the repo. Leave empty for the default repo.
},
- "uid": "A String", # A server-assigned, globally unique identifier.
},
},
"labels": { # Labels with user defined metadata.
@@ -242,10 +326,10 @@
"name": "A String", # The alias name.
},
"revisionId": "A String", # A revision (commit) ID.
+ "hostUri": "A String", # The URI of a running Gerrit instance.
"gerritProject": "A String", # The full project name within the host. Projects may be nested, so
# "project/subproject" is a valid project name. The "repo name" is
# the hostURI/project.
- "hostUri": "A String", # The URI of a running Gerrit instance.
},
},
],
@@ -254,8 +338,7 @@
"git": { # A GitSourceContext denotes a particular revision in a third party Git # A SourceContext referring to any third party Git repo (e.g., GitHub).
# repository (e.g., GitHub).
"url": "A String", # Git repository URL.
- "revisionId": "A String", # Required.
- # Git commit hash.
+ "revisionId": "A String", # Required. Git commit hash.
},
"cloudRepo": { # A CloudRepoSourceContext denotes a particular revision in a Google Cloud # A SourceContext referring to a revision in a Google Cloud Source Repo.
# Source Repo.
@@ -265,12 +348,12 @@
},
"revisionId": "A String", # A revision ID.
"repoId": { # A unique identifier for a Cloud Repo. # The ID of the repo.
+ "uid": "A String", # A server-assigned, globally unique identifier.
"projectRepoId": { # Selects a repo using a Google Cloud Platform project ID (e.g., # A combination of a project ID and a repo name.
# winged-cargo-31) and a repo name within that project.
"projectId": "A String", # The ID of the project.
"repoName": "A String", # The name of the repo. Leave empty for the default repo.
},
- "uid": "A String", # A server-assigned, globally unique identifier.
},
},
"labels": { # Labels with user defined metadata.
@@ -282,10 +365,10 @@
"name": "A String", # The alias name.
},
"revisionId": "A String", # A revision (commit) ID.
+ "hostUri": "A String", # The URI of a running Gerrit instance.
"gerritProject": "A String", # The full project name within the host. Projects may be nested, so
# "project/subproject" is a valid project name. The "repo name" is
# the hostURI/project.
- "hostUri": "A String", # The URI of a running Gerrit instance.
},
},
"storageSource": { # StorageSource describes the location of the source in an archive file in # If provided, get the source from this location in in Google Cloud
@@ -305,7 +388,7 @@
"creator": "A String", # E-mail address of the user who initiated this build. Note that this was the
# user's e-mail address at the time the build was initiated; this address may
# not represent the same end-user for all time.
- "logsBucket": "A String", # Google Cloud Storage bucket where logs were written.
+ "projectId": "A String", # ID of the project.
"builderVersion": "A String", # Version string of the builder at the time this build was executed.
"createTime": "A String", # Time at which the build was created.
"builtArtifacts": [ # Output of the build.
@@ -333,7 +416,7 @@
],
"triggerId": "A String", # Trigger identifier if the build was triggered automatically; empty if not.
"startTime": "A String", # Time at which execution of the build was started.
- "projectId": "A String", # ID of the project.
+ "logsBucket": "A String", # Google Cloud Storage bucket where logs were written.
"id": "A String", # Unique identifier of the build.
},
"provenanceBytes": "A String", # Serialized JSON representation of the provenance, used in generating the
@@ -394,6 +477,8 @@
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
},
+ "continuousAnalysis": "A String", # Whether the resource is continuously analyzed.
+ "cpe": "A String", # The CPE of the resource being scanned.
"analysisStatusError": { # The `Status` type defines a logical error model that is suitable for # When an error is encountered this will contain a LocalizedMessage under
# details to show to the user. The LocalizedMessage output only and
# populated by the API.
@@ -414,7 +499,6 @@
},
],
},
- "continuousAnalysis": "A String", # Whether the resource is continuously analyzed.
},
"attestation": { # Occurrence that represents a single "attestation". The authenticity of an # Describes an attestation of an artifact.
# Attestation can be verified using the attached signature. If the verifier
@@ -439,7 +523,7 @@
# gpg --with-colons --with-fingerprint --force-v4-certs \
# --list-keys attester@example.com
# tru::1:1513631572:0:3:1:5
- # pub:...<SNIP>...
+ # pub:...<SNIP>...
# fpr:::::::::24FF6481B76AC91E66A00AC657A93A81EF3AE6FB:
# ```
# Above, the fingerprint is `24FF6481B76AC91E66A00AC657A93A81EF3AE6FB`.
@@ -474,66 +558,14 @@
"config": "A String", # Configuration used to create this deployment.
},
"remediation": "A String", # A description of actions that can be taken to remedy the `Note`
- "vulnerabilityDetails": { # Used by Occurrence to point to where the vulnerability exists and how # Details of a security vulnerability note.
- # to fix it.
- "packageIssue": [ # The set of affected locations and their fixes (if available) within
- # the associated resource.
- { # This message wraps a location affected by a vulnerability and its
- # associated fix (if one is available).
- "severityName": "A String",
- "affectedLocation": { # The location of the vulnerability # The location of the vulnerability.
- "cpeUri": "A String", # The cpe_uri in [cpe format] (https://cpe.mitre.org/specification/)
- # format. Examples include distro or storage location for vulnerable jar.
- # This field can be used as a filter in list requests.
- "version": { # Version contains structured information about the version of the package. # The version of the package being described. This field can be used as a
- # filter in list requests.
- # For a discussion of this in Debian/Ubuntu:
- # http://serverfault.com/questions/604541/debian-packages-version-convention
- # For a discussion of this in Redhat/Fedora/Centos:
- # http://blog.jasonantman.com/2014/07/how-yum-and-rpm-compare-versions/
- "kind": "A String", # Distinguish between sentinel MIN/MAX versions and normal versions.
- # If kind is not NORMAL, then the other fields are ignored.
- "revision": "A String", # The iteration of the package build from the above version.
- "name": "A String", # The main part of the version name.
- "epoch": 42, # Used to correct mistakes in the version numbering scheme.
- },
- "package": "A String", # The package being described.
- },
- "fixedLocation": { # The location of the vulnerability # The location of the available fix for vulnerability.
- "cpeUri": "A String", # The cpe_uri in [cpe format] (https://cpe.mitre.org/specification/)
- # format. Examples include distro or storage location for vulnerable jar.
- # This field can be used as a filter in list requests.
- "version": { # Version contains structured information about the version of the package. # The version of the package being described. This field can be used as a
- # filter in list requests.
- # For a discussion of this in Debian/Ubuntu:
- # http://serverfault.com/questions/604541/debian-packages-version-convention
- # For a discussion of this in Redhat/Fedora/Centos:
- # http://blog.jasonantman.com/2014/07/how-yum-and-rpm-compare-versions/
- "kind": "A String", # Distinguish between sentinel MIN/MAX versions and normal versions.
- # If kind is not NORMAL, then the other fields are ignored.
- "revision": "A String", # The iteration of the package build from the above version.
- "name": "A String", # The main part of the version name.
- "epoch": 42, # Used to correct mistakes in the version numbering scheme.
- },
- "package": "A String", # The package being described.
- },
- },
- ],
- "type": "A String", # The type of package; whether native or non native(ruby gems,
- # node.js packages etc)
- "cvssScore": 3.14, # Output only. The CVSS score of this vulnerability. CVSS score is on a
- # scale of 0-10 where 0 indicates low severity and 10 indicates high
- # severity.
- "severity": "A String", # Output only. The note provider assigned Severity of the vulnerability.
- "effectiveSeverity": "A String", # The distro assigned severity for this vulnerability when that is
- # available and note provider assigned severity when distro has not yet
- # assigned a severity for this vulnerability.
- },
+ "resourceUrl": "A String", # The unique URL of the image or the container for which the `Occurrence`
+ # applies. For example, https://gcr.io/project/image@sha256:foo This field
+ # can be used as a filter in list requests.
"createTime": "A String", # Output only. The time this `Occurrence` was created.
"derivedImage": { # Derived describes the derived image portion (Occurrence) of the # Describes how this resource derives from the basis
# in the associated note.
# DockerImage relationship. This image would be produced from a Dockerfile
- # with FROM <DockerImage.Basis in attached Note>.
+ # with FROM <DockerImage.Basis in attached Note>.
"distance": 42, # Output only. The number of layers by which this image differs from the
# associated image basis.
"baseResourceUrl": "A String", # Output only. This contains the base image URL for the derived image
@@ -559,9 +591,6 @@
# This field can be used as a filter in list requests.
},
},
- "resourceUrl": "A String", # The unique URL of the image or the container for which the `Occurrence`
- # applies. For example, https://gcr.io/project/image@sha256:foo This field
- # can be used as a filter in list requests.
},
],
}</pre>