chore: regens API reference docs (#889)
diff --git a/docs/dyn/containeranalysis_v1beta1.projects.notes.occurrences.html b/docs/dyn/containeranalysis_v1beta1.projects.notes.occurrences.html
index fc8b0c2..9285ee9 100644
--- a/docs/dyn/containeranalysis_v1beta1.projects.notes.occurrences.html
+++ b/docs/dyn/containeranalysis_v1beta1.projects.notes.occurrences.html
@@ -88,7 +88,7 @@
specified note.
Args:
- name: string, The name of the note to list occurrences for in the form of
+ name: string, Required. The name of the note to list occurrences for in the form of
`projects/[PROVIDER_ID]/notes/[NOTE_ID]`. (required)
pageToken: string, Token to provide to skip to a particular spot in the list.
x__xgafv: string, V1 error format.
@@ -105,8 +105,7 @@
"nextPageToken": "A String", # Token to provide to skip to a particular spot in the list.
"occurrences": [ # The occurrences attached to the specified note.
{ # An instance of an analysis type that has been found on a resource.
- "kind": "A String", # Output only. This explicitly denotes which of the occurrence details are
- # specified. This field can be used as a filter in list requests.
+ "updateTime": "A String", # Output only. The time this occurrence was last updated.
"resource": { # An entity that can have metadata. For example, a Docker image. # Required. Immutable. The resource for which the occurrence applies.
"contentHash": { # Container message for hash values. # Deprecated, do not use. Use uri instead.
#
@@ -114,12 +113,12 @@
"type": "A String", # Required. The type of hash that was performed.
"value": "A String", # Required. The hash value.
},
- "uri": "A String", # Required. The unique URI of the resource. For example,
- # `https://gcr.io/project/image@sha256:foo` for a Docker image.
"name": "A String", # Deprecated, do not use. Use uri instead.
#
# The name of the resource. For example, the name of a Docker image -
# "Debian".
+ "uri": "A String", # Required. The unique URI of the resource. For example,
+ # `https://gcr.io/project/image@sha256:foo` for a Docker image.
},
"name": "A String", # Output only. The name of the occurrence in the form of
# `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`.
@@ -176,7 +175,8 @@
"longDescription": "A String", # Output only. A detailed description of this vulnerability.
"shortDescription": "A String", # Output only. A one sentence description of this vulnerability.
},
- "updateTime": "A String", # Output only. The time this occurrence was last updated.
+ "kind": "A String", # Output only. This explicitly denotes which of the occurrence details are
+ # specified. This field can be used as a filter in list requests.
"discovered": { # Details of a discovery occurrence. # Describes when a resource was discovered.
"discovered": { # Provides information about the analysis status of a discovered resource. # Required. Analysis status for the discovered resource.
"lastAnalysisTime": "A String", # The last time continuous analysis was done for this resource.
@@ -229,7 +229,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`.
@@ -312,6 +312,77 @@
},
},
},
+ "intoto": { # This corresponds to a signed in-toto link - it is made up of one or more # Describes a specific in-toto link.
+ # signatures and the in-toto link itself. This is used for occurrences of a
+ # Grafeas in-toto note.
+ "signatures": [
+ { # A signature object consists of the KeyID used and the signature itself.
+ "keyid": "A String",
+ "sig": "A String",
+ },
+ ],
+ "signed": { # This corresponds to an in-toto link.
+ "environment": { # Defines an object for the environment field in in-toto links. The suggested # This is a field that can be used to capture information about the
+ # environment. It is suggested for this field to contain information that
+ # details environment variables, filesystem information, and the present
+ # working directory. The recommended structure of this field is:
+ # "environment": {
+ # "custom_values": {
+ # "variables": "<ENV>",
+ # "filesystem": "<FS>",
+ # "workdir": "<CWD>",
+ # "<ANY OTHER RELEVANT FIELDS>": "..."
+ # }
+ # }
+ # fields are "variables", "filesystem", and "workdir".
+ "customValues": {
+ "a_key": "A String",
+ },
+ },
+ "command": [ # This field contains the full command executed for the step. This can also
+ # be empty if links are generated for operations that aren't directly mapped
+ # to a specific command. Each term in the command is an independent string
+ # in the list. An example of a command in the in-toto metadata field is:
+ # "command": ["git", "clone", "https://github.com/in-toto/demo-project.git"]
+ "A String",
+ ],
+ "materials": [ # Materials are the supply chain artifacts that go into the step and are used
+ # for the operation performed. The key of the map is the path of the artifact
+ # and the structure contains the recorded hash information. An example is:
+ # "materials": [
+ # {
+ # "resource_uri": "foo/bar",
+ # "hashes": {
+ # "sha256": "ebebf...",
+ # <OTHER HASH ALGORITHMS>: <HASH VALUE>
+ # }
+ # }
+ # ]
+ {
+ "resourceUri": "A String",
+ "hashes": { # Defines a hash object for use in Materials and Products.
+ "sha256": "A String",
+ },
+ },
+ ],
+ "products": [ # Products are the supply chain artifacts generated as a result of the step.
+ # The structure is identical to that of materials.
+ {
+ "resourceUri": "A String",
+ "hashes": { # Defines a hash object for use in Materials and Products.
+ "sha256": "A String",
+ },
+ },
+ ],
+ "byproducts": { # Defines an object for the byproducts field in in-toto links. The suggested # ByProducts are data generated as part of a software supply chain step, but
+ # are not the actual result of the step.
+ # fields are "stderr", "stdout", and "return-value".
+ "customValues": {
+ "a_key": "A String",
+ },
+ },
+ },
+ },
"build": { # Details of a build occurrence. # Describes a verifiable build.
"provenance": { # Provenance of a build. Contains all information needed to verify the full # Required. The actual provenance for the build.
# details about the build from source to completion.
@@ -391,10 +462,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.
},
},
],
@@ -430,10 +501,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.
},
},
},
@@ -498,6 +569,7 @@
"installation": { # Details of a package occurrence. # Describes the installation of a package on the linked resource.
"installation": { # This represents how a particular software package may be installed on a # Required. Where the package was installed.
# system.
+ "name": "A String", # Output only. The name of the installed package.
"location": [ # Required. All of the places within the filesystem versions of this package
# have been found.
{ # An occurrence of a particular package installation found within a system's
@@ -515,7 +587,6 @@
},
},
],
- "name": "A String", # Output only. The name of the installed package.
},
},
"createTime": "A String", # Output only. The time this occurrence was created.
@@ -523,7 +594,7 @@
# note.
"derivedImage": { # Derived describes the derived image portion (Occurrence) of the DockerImage # Required. Immutable. The child image derived from the base image.
# relationship. This image would be produced from a Dockerfile with FROM
- # <DockerImage.Basis in attached Note>.
+ # <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
@@ -539,12 +610,12 @@
"fingerprint": { # A set of properties that uniquely identify a given Docker image. # Required. The fingerprint of the derived image.
"v1Name": "A String", # Required. The layer ID of the final layer in the Docker image's v1
# representation.
- "v2Name": "A String", # Output only. The name of the image's v2 blobs computed via:
- # [bottom] := v2_blobbottom := sha256(v2_blob[N] + " " + v2_name[N+1])
- # Only the name of the final blob is kept.
"v2Blob": [ # Required. The ordered list of v2 blobs that represent a given image.
"A String",
],
+ "v2Name": "A String", # Output only. The name of the image's v2 blobs computed via:
+ # [bottom] := v2_blobbottom := sha256(v2_blob[N] + " " + v2_name[N+1])
+ # Only the name of the final blob is kept.
},
},
},