ondemandscanning/v1 library

On-Demand Scanning API - v1

A service to scan container images for vulnerabilities.

For more information, see cloud.google.com/container-analysis/docs/on-demand-scanning/

Create an instance of OnDemandScanningApi to access these resources:

Classes

AnalyzePackagesRequestV1
AnalyzePackagesRequest is the request to analyze a list of packages and create Vulnerability Occurrences for it.
AttestationOccurrence
Occurrence that represents a single "attestation".
BinarySourceInfo
BuildDefinition
BuildOccurrence
Details of a build occurrence.
BuildProvenance
Provenance of a build.
CloudRepoSourceContext
A CloudRepoSourceContext denotes a particular revision in a Google Cloud Source Repo.
ComplianceOccurrence
An indication that the compliance checks in the associated ComplianceNote were not satisfied for particular resources or a specified reason.
DiscoveryOccurrence
Provides information about the analysis status of a discovered resource.
DSSEAttestationOccurrence
Prefer to use a regular Occurrence, and populate the Envelope at the top level of the Occurrence.
Envelope
MUST match https://github.com/secure-systems-lab/dsse/blob/master/envelope.proto.
FileHashes
Container message for hashes of byte content of files, used in source messages to verify integrity of source input to the build.
GerritSourceContext
A SourceContext referring to a Gerrit project.
GrafeasV1SlsaProvenanceZeroTwoSlsaInvocation
Identifies the event that kicked off the build.
GrafeasV1SlsaProvenanceZeroTwoSlsaMetadata
Other properties of the build.
ImageOccurrence
Details of the derived image portion of the DockerImage relationship.
InTotoProvenance
InTotoSlsaProvenanceV1
InTotoStatement
Spec defined at https://github.com/in-toto/attestation/tree/main/spec#statement The serialized InTotoStatement will be stored as Envelope.payload.
LanguagePackageDependency
Indicates a language package available between this package and the customer's resource artifact.
ListOperationsResponse
The response message for Operations.ListOperations.
ListVulnerabilitiesResponseV1
ListVulnerabilitiesResponse contains a single page of vulnerabilities resulting from a scan.
Location
An occurrence of a particular package installation found within a system's filesystem.
Maintainer
Metadata
Other properties of the build.
Occurrence
An instance of an analysis type that has been found on a resource.
OnDemandScanningApi
A service to scan container images for vulnerabilities.
Operation
This resource represents a long-running operation that is the result of a network API call.
PackageData
PackageIssue
A detail for a distro and package this vulnerability occurrence was found in and its associated fix (if one is available).
PackageOccurrence
Details on how a particular software package was installed on a system.
PackageVersion
ProjectsLocationsOperationsResource
ProjectsLocationsResource
ProjectsLocationsScansResource
ProjectsLocationsScansVulnerabilitiesResource
ProjectsResource
ProvenanceBuilder
Remediation
Specifies details on how to handle (and presumably, fix) a vulnerability.
RepoId
A unique identifier for a Cloud Repo.
RunDetails
SbomReferenceIntotoPayload
The actual payload that contains the SBOM Reference data.
SBOMReferenceOccurrence
The occurrence representing an SBOM reference as applied to a specific resource.
SlsaMetadata
Other properties of the build.
SlsaProvenance
SlsaProvenanceV1
Keep in sync with schema at https://github.com/slsa-framework/slsa/blob/main/docs/provenance/schema/v1/provenance.proto Builder renamed to ProvenanceBuilder because of Java conflicts.
SlsaProvenanceZeroTwo
See full explanation of fields at slsa.dev/provenance/v0.2.
Source
Source describes the location of the source used for the build.
SourceContext
A SourceContext is a reference to a tree of files.
UpgradeOccurrence
An Upgrade Occurrence represents that a specific resource_url could install a specific upgrade.
VexAssessment
VexAssessment provides all publisher provided Vex information that is related to this vulnerability.
VulnerabilityOccurrence
An occurrence of a severity vulnerability on a resource.
WindowsUpdate
Windows Update represents the metadata about the update for the Windows operating system.

Typedefs

AliasContext = $AliasContext
An alias to a repo revision.
AnalysisCompleted = $AnalysisCompleted
Indicates which analysis completed successfully.
Artifact = $Artifact
Artifact describes a build product.
BuilderConfig = $Shared00
BuildMetadata = $BuildMetadata
Category = $Category
The category to which the update belongs.
Command = $Command
Command describes a step performed as part of the build pipeline.
Completeness = $Completeness
Indicates that the builder claims certain fields in this message to be complete.
ComplianceVersion = $ComplianceVersion
Describes the CIS benchmark version that is applicable to a given OS and os version.
CVSS = $CVSS
Common Vulnerability Scoring System.
DeploymentOccurrence = $DeploymentOccurrence
The period during which some deployable was active in a runtime.
Empty = $Empty
A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs.
EnvelopeSignature = $EnvelopeSignature
FileLocation = $FileLocation
Indicates the location at which a package was found.
Fingerprint = $Fingerprint
A set of properties that uniquely identify a given Docker image.
GitSourceContext = $GitSourceContext
A GitSourceContext denotes a particular revision in a third party Git repository (e.g., GitHub).
GrafeasV1FileLocation = $FileLocation
Indicates the location at which a package was found.
GrafeasV1SlsaProvenanceZeroTwoSlsaBuilder = $Shared00
Identifies the entity that executed the recipe, which is trusted to have correctly performed the operation and populated this provenance.
GrafeasV1SlsaProvenanceZeroTwoSlsaCompleteness = $GrafeasV1SlsaProvenanceZeroTwoSlsaCompleteness
Indicates that the builder claims certain fields in this message to be complete.
GrafeasV1SlsaProvenanceZeroTwoSlsaConfigSource = $GrafeasV1SlsaProvenanceZeroTwoSlsaConfigSource
Describes where the config file that kicked off the build came from.
GrafeasV1SlsaProvenanceZeroTwoSlsaMaterial = $Material
The collection of artifacts that influenced the build including sources, dependencies, build tools, base images, and so on.
Hash = $Hash
Container message for hash values.
Identity = $Identity
The unique identifier of the update.
Justification = $Justification
Justification provides the justification when the state of the assessment if NOT_AFFECTED.
Jwt = $Jwt
Layer = $Layer
Layer holds metadata specific to a layer of a Docker image.
License = $License
License information.
Material = $Material
NonCompliantFile = $NonCompliantFile
Details about files that caused a compliance check to fail.
ProjectRepoId = $ProjectRepoId
Selects a repo using a Google Cloud Platform project ID (e.g., winged-cargo-31) and a repo name within that project.
Recipe = $Recipe
Steps taken to build the artifact.
RelatedUrl = $RelatedUrl
Metadata for any related URL information.
ResourceDescriptor = $ResourceDescriptor
SbomReferenceIntotoPredicate = $SbomReferenceIntotoPredicate
A predicate which describes the SBOM being referenced.
SBOMStatus = $SBOMStatus
The status of an SBOM generation.
Signature = $Signature
Verifiers (e.g. Kritis implementations) MUST verify signatures with respect to the trust anchors defined in policy (e.g. a Kritis policy).
SlsaBuilder = $Shared00
SlsaCompleteness = $Completeness
Indicates that the builder claims certain fields in this message to be complete.
SlsaRecipe = $SlsaRecipe
Steps taken to build the artifact.
Status = $Status
The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs.
Subject = $Subject
UpgradeDistribution = $UpgradeDistribution
The Upgrade Distribution represents metadata about the Upgrade for each operating system (CPE).
Version = $Version
Version contains structured information about the version of a package.

Exceptions / Errors

ApiRequestError
Represents a general error reported by the API endpoint.
DetailedApiRequestError
Represents a specific error reported by the API endpoint.