@google-cloud/containeranalysis 4.4.1 → 4.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +14 -0
- package/README.md +49 -70
- package/build/protos/google/devtools/containeranalysis/v1beta1/containeranalysis.proto +10 -120
- package/build/protos/grafeas/v1/common.proto +2 -0
- package/build/protos/grafeas/v1/grafeas.proto +3 -0
- package/build/protos/grafeas/v1/vex.proto +203 -0
- package/build/protos/grafeas/v1/vulnerability.proto +48 -2
- package/build/protos/protos.d.ts +8235 -6337
- package/build/protos/protos.js +17150 -11876
- package/build/protos/protos.json +1 -6679
- package/build/src/index.d.ts +2 -5
- package/build/src/index.js +3 -5
- package/build/src/index.js.map +1 -1
- package/build/src/v1/container_analysis_client.d.ts +4 -4
- package/build/src/v1/container_analysis_client.js +3 -1
- package/build/src/v1/container_analysis_client.js.map +1 -1
- package/build/src/v1/grafeas_client.d.ts +764 -0
- package/build/src/v1/grafeas_client.js +928 -0
- package/build/src/v1/grafeas_client.js.map +1 -0
- package/build/src/v1/grafeas_client_config.json +82 -0
- package/build/src/v1/index.js +1 -1
- package/build/src/v1beta1/container_analysis_v1_beta1_client.d.ts +5 -190
- package/build/src/v1beta1/container_analysis_v1_beta1_client.js +5 -224
- package/build/src/v1beta1/container_analysis_v1_beta1_client.js.map +1 -1
- package/build/src/v1beta1/container_analysis_v1_beta1_client_config.json +0 -12
- package/build/src/v1beta1/grafeas_v1_beta1_client.d.ts +21 -48
- package/build/src/v1beta1/grafeas_v1_beta1_client.js +9 -51
- package/build/src/v1beta1/grafeas_v1_beta1_client.js.map +1 -1
- package/build/src/v1beta1/index.js +1 -1
- package/package.json +41 -41
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,20 @@
|
|
|
4
4
|
|
|
5
5
|
[1]: https://www.npmjs.com/package/@google-cloud/containeranalysis?activeTab=versions
|
|
6
6
|
|
|
7
|
+
## [4.5.0](https://github.com/googleapis/google-cloud-node/compare/containeranalysis-v4.4.2...containeranalysis-v4.5.0) (2023-03-13)
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
### Features
|
|
11
|
+
|
|
12
|
+
* [containeranalysis] Import of Grafeas from Github ([#4050](https://github.com/googleapis/google-cloud-node/issues/4050)) ([1323ead](https://github.com/googleapis/google-cloud-node/commit/1323ead136e4352f44ccf57498b4aaa473533322))
|
|
13
|
+
|
|
14
|
+
## [4.4.2](https://github.com/googleapis/google-cloud-node/compare/containeranalysis-v4.4.1...containeranalysis-v4.4.2) (2023-02-15)
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
### Bug Fixes
|
|
18
|
+
|
|
19
|
+
* [Many APIs] changing format of the jsdoc links ([#3990](https://github.com/googleapis/google-cloud-node/issues/3990)) ([878c55d](https://github.com/googleapis/google-cloud-node/commit/878c55d62af7e41e8d5050b081e4b79202b1b9cc))
|
|
20
|
+
|
|
7
21
|
## [4.4.1](https://github.com/googleapis/nodejs-containeranalysis/compare/v4.4.0...v4.4.1) (2022-11-10)
|
|
8
22
|
|
|
9
23
|
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
[//]: # "To regenerate it, use `python -m synthtool`."
|
|
3
3
|
<img src="https://avatars2.githubusercontent.com/u/2810941?v=3&s=96" alt="Google Cloud Platform logo" title="Google Cloud Platform" align="right" height="96" width="96"/>
|
|
4
4
|
|
|
5
|
-
# [Google Container Analysis: Node.js Client](https://github.com/googleapis/
|
|
5
|
+
# [Google Container Analysis: Node.js Client](https://github.com/googleapis/google-cloud-node)
|
|
6
6
|
|
|
7
7
|
[](https://cloud.google.com/terms/launch-stages)
|
|
8
8
|
[](https://www.npmjs.org/package/@google-cloud/containeranalysis)
|
|
@@ -10,15 +10,15 @@
|
|
|
10
10
|
|
|
11
11
|
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
Containeranalysis client for Node.js
|
|
14
14
|
|
|
15
15
|
|
|
16
16
|
A comprehensive list of changes in each version may be found in
|
|
17
|
-
[the CHANGELOG](
|
|
17
|
+
[the CHANGELOG](googleapis/nodejs-containeranalysis/CHANGELOG.md).
|
|
18
18
|
|
|
19
19
|
* [Google Container Analysis Node.js Client API Reference][client-docs]
|
|
20
20
|
* [Google Container Analysis Documentation][product-docs]
|
|
21
|
-
* [github.com/googleapis/nodejs-containeranalysis](
|
|
21
|
+
* [github.com/googleapis/nodejs-containeranalysis](googleapis/nodejs-containeranalysis)
|
|
22
22
|
|
|
23
23
|
Read more about the client libraries for Cloud APIs, including the older
|
|
24
24
|
Google APIs Client Libraries, in [Client Libraries Explained][explained].
|
|
@@ -31,7 +31,7 @@ Google APIs Client Libraries, in [Client Libraries Explained][explained].
|
|
|
31
31
|
* [Quickstart](#quickstart)
|
|
32
32
|
* [Before you begin](#before-you-begin)
|
|
33
33
|
* [Installing the client library](#installing-the-client-library)
|
|
34
|
-
|
|
34
|
+
|
|
35
35
|
* [Samples](#samples)
|
|
36
36
|
* [Versioning](#versioning)
|
|
37
37
|
* [Contributing](#contributing)
|
|
@@ -54,76 +54,55 @@ npm install @google-cloud/containeranalysis
|
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
|
|
57
|
-
### Using the client library
|
|
58
|
-
|
|
59
|
-
```javascript
|
|
60
|
-
/**
|
|
61
|
-
* TODO(developer): Uncomment these variables before running the sample
|
|
62
|
-
*/
|
|
63
|
-
// const projectId = 'your-project-id', // Your GCP Project ID
|
|
64
|
-
// const noteId = 'my-note-id' // Id of the note
|
|
65
|
-
|
|
66
|
-
// Import the library and create a client
|
|
67
|
-
const {ContainerAnalysisClient} = require('@google-cloud/containeranalysis');
|
|
68
|
-
const client = new ContainerAnalysisClient();
|
|
69
|
-
// Fetch an instance of a Grafeas client:
|
|
70
|
-
// see: https://googleapis.dev/nodejs/grafeas/latest
|
|
71
|
-
const grafeasClient = client.getGrafeasClient();
|
|
72
|
-
|
|
73
|
-
// Construct request
|
|
74
|
-
// Associate the Note with a metadata type
|
|
75
|
-
// https://cloud.google.com/container-registry/docs/container-analysis#supported_metadata_types
|
|
76
|
-
// Here, we use the type "vulnerabiltity"
|
|
77
|
-
const formattedParent = grafeasClient.projectPath(projectId);
|
|
78
|
-
|
|
79
|
-
// Creates and returns a new Note
|
|
80
|
-
const [note] = await grafeasClient.createNote({
|
|
81
|
-
parent: formattedParent,
|
|
82
|
-
noteId: noteId,
|
|
83
|
-
note: {
|
|
84
|
-
vulnerability: {
|
|
85
|
-
details: [
|
|
86
|
-
{
|
|
87
|
-
affectedCpeUri: 'foo.uri',
|
|
88
|
-
affectedPackage: 'foo',
|
|
89
|
-
minAffectedVersion: {
|
|
90
|
-
kind: 'MINIMUM',
|
|
91
|
-
},
|
|
92
|
-
fixedVersion: {
|
|
93
|
-
kind: 'MAXIMUM',
|
|
94
|
-
},
|
|
95
|
-
},
|
|
96
|
-
],
|
|
97
|
-
},
|
|
98
|
-
},
|
|
99
|
-
});
|
|
100
|
-
|
|
101
|
-
console.log(`Note ${note.name} created.`);
|
|
102
|
-
|
|
103
|
-
```
|
|
104
|
-
|
|
105
57
|
|
|
106
58
|
|
|
107
59
|
## Samples
|
|
108
60
|
|
|
109
|
-
Samples are in the [`samples/`](https://github.com/googleapis/
|
|
61
|
+
Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/tree/main/samples) directory. Each sample's `README.md` has instructions for running its sample.
|
|
110
62
|
|
|
111
63
|
| Sample | Source Code | Try it |
|
|
112
64
|
| --------------------------- | --------------------------------- | ------ |
|
|
113
|
-
|
|
|
114
|
-
|
|
|
115
|
-
|
|
|
116
|
-
|
|
|
117
|
-
|
|
|
118
|
-
|
|
|
119
|
-
|
|
|
120
|
-
|
|
|
121
|
-
|
|
|
122
|
-
|
|
|
123
|
-
|
|
|
124
|
-
|
|
|
125
|
-
|
|
|
126
|
-
|
|
|
65
|
+
| Container_analysis.get_iam_policy | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/container_analysis.get_iam_policy.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/container_analysis.get_iam_policy.js,samples/README.md) |
|
|
66
|
+
| Container_analysis.get_vulnerability_occurrences_summary | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/container_analysis.get_vulnerability_occurrences_summary.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/container_analysis.get_vulnerability_occurrences_summary.js,samples/README.md) |
|
|
67
|
+
| Container_analysis.set_iam_policy | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/container_analysis.set_iam_policy.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/container_analysis.set_iam_policy.js,samples/README.md) |
|
|
68
|
+
| Container_analysis.test_iam_permissions | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/container_analysis.test_iam_permissions.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/container_analysis.test_iam_permissions.js,samples/README.md) |
|
|
69
|
+
| Grafeas.batch_create_notes | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.batch_create_notes.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.batch_create_notes.js,samples/README.md) |
|
|
70
|
+
| Grafeas.batch_create_occurrences | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.batch_create_occurrences.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.batch_create_occurrences.js,samples/README.md) |
|
|
71
|
+
| Grafeas.create_note | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.create_note.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.create_note.js,samples/README.md) |
|
|
72
|
+
| Grafeas.create_occurrence | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.create_occurrence.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.create_occurrence.js,samples/README.md) |
|
|
73
|
+
| Grafeas.delete_note | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.delete_note.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.delete_note.js,samples/README.md) |
|
|
74
|
+
| Grafeas.delete_occurrence | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.delete_occurrence.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.delete_occurrence.js,samples/README.md) |
|
|
75
|
+
| Grafeas.get_note | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.get_note.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.get_note.js,samples/README.md) |
|
|
76
|
+
| Grafeas.get_occurrence | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.get_occurrence.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.get_occurrence.js,samples/README.md) |
|
|
77
|
+
| Grafeas.get_occurrence_note | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.get_occurrence_note.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.get_occurrence_note.js,samples/README.md) |
|
|
78
|
+
| Grafeas.list_note_occurrences | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.list_note_occurrences.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.list_note_occurrences.js,samples/README.md) |
|
|
79
|
+
| Grafeas.list_notes | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.list_notes.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.list_notes.js,samples/README.md) |
|
|
80
|
+
| Grafeas.list_occurrences | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.list_occurrences.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.list_occurrences.js,samples/README.md) |
|
|
81
|
+
| Grafeas.update_note | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.update_note.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.update_note.js,samples/README.md) |
|
|
82
|
+
| Grafeas.update_occurrence | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.update_occurrence.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1/grafeas.update_occurrence.js,samples/README.md) |
|
|
83
|
+
| Container_analysis_v1_beta1.get_iam_policy | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/container_analysis_v1_beta1.get_iam_policy.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/container_analysis_v1_beta1.get_iam_policy.js,samples/README.md) |
|
|
84
|
+
| Container_analysis_v1_beta1.get_scan_config | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/container_analysis_v1_beta1.get_scan_config.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/container_analysis_v1_beta1.get_scan_config.js,samples/README.md) |
|
|
85
|
+
| Container_analysis_v1_beta1.list_scan_configs | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/container_analysis_v1_beta1.list_scan_configs.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/container_analysis_v1_beta1.list_scan_configs.js,samples/README.md) |
|
|
86
|
+
| Container_analysis_v1_beta1.set_iam_policy | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/container_analysis_v1_beta1.set_iam_policy.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/container_analysis_v1_beta1.set_iam_policy.js,samples/README.md) |
|
|
87
|
+
| Container_analysis_v1_beta1.test_iam_permissions | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/container_analysis_v1_beta1.test_iam_permissions.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/container_analysis_v1_beta1.test_iam_permissions.js,samples/README.md) |
|
|
88
|
+
| Container_analysis_v1_beta1.update_scan_config | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/container_analysis_v1_beta1.update_scan_config.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/container_analysis_v1_beta1.update_scan_config.js,samples/README.md) |
|
|
89
|
+
| Grafeas_v1_beta1.batch_create_notes | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.batch_create_notes.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.batch_create_notes.js,samples/README.md) |
|
|
90
|
+
| Grafeas_v1_beta1.batch_create_occurrences | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.batch_create_occurrences.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.batch_create_occurrences.js,samples/README.md) |
|
|
91
|
+
| Grafeas_v1_beta1.create_note | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.create_note.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.create_note.js,samples/README.md) |
|
|
92
|
+
| Grafeas_v1_beta1.create_occurrence | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.create_occurrence.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.create_occurrence.js,samples/README.md) |
|
|
93
|
+
| Grafeas_v1_beta1.delete_note | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.delete_note.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.delete_note.js,samples/README.md) |
|
|
94
|
+
| Grafeas_v1_beta1.delete_occurrence | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.delete_occurrence.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.delete_occurrence.js,samples/README.md) |
|
|
95
|
+
| Grafeas_v1_beta1.get_note | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.get_note.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.get_note.js,samples/README.md) |
|
|
96
|
+
| Grafeas_v1_beta1.get_occurrence | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.get_occurrence.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.get_occurrence.js,samples/README.md) |
|
|
97
|
+
| Grafeas_v1_beta1.get_occurrence_note | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.get_occurrence_note.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.get_occurrence_note.js,samples/README.md) |
|
|
98
|
+
| Grafeas_v1_beta1.get_vulnerability_occurrences_summary | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.get_vulnerability_occurrences_summary.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.get_vulnerability_occurrences_summary.js,samples/README.md) |
|
|
99
|
+
| Grafeas_v1_beta1.list_note_occurrences | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.list_note_occurrences.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.list_note_occurrences.js,samples/README.md) |
|
|
100
|
+
| Grafeas_v1_beta1.list_notes | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.list_notes.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.list_notes.js,samples/README.md) |
|
|
101
|
+
| Grafeas_v1_beta1.list_occurrences | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.list_occurrences.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.list_occurrences.js,samples/README.md) |
|
|
102
|
+
| Grafeas_v1_beta1.update_note | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.update_note.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.update_note.js,samples/README.md) |
|
|
103
|
+
| Grafeas_v1_beta1.update_occurrence | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.update_occurrence.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/generated/v1beta1/grafeas_v1_beta1.update_occurrence.js,samples/README.md) |
|
|
104
|
+
| Quickstart | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/quickstart.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/quickstart.js,samples/README.md) |
|
|
105
|
+
| Quickstart.test | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-devtools-containeranalysis/samples/test/quickstart.test.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-devtools-containeranalysis/samples/test/quickstart.test.js,samples/README.md) |
|
|
127
106
|
|
|
128
107
|
|
|
129
108
|
|
|
@@ -173,7 +152,7 @@ More Information: [Google Cloud Platform Launch Stages][launch_stages]
|
|
|
173
152
|
|
|
174
153
|
## Contributing
|
|
175
154
|
|
|
176
|
-
Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/
|
|
155
|
+
Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/main/CONTRIBUTING.md).
|
|
177
156
|
|
|
178
157
|
Please note that this `README.md`, the `samples/README.md`,
|
|
179
158
|
and a variety of configuration files in this repository (including `.nycrc` and `tsconfig.json`)
|
|
@@ -185,7 +164,7 @@ to its templates in
|
|
|
185
164
|
|
|
186
165
|
Apache Version 2.0
|
|
187
166
|
|
|
188
|
-
See [LICENSE](https://github.com/googleapis/
|
|
167
|
+
See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)
|
|
189
168
|
|
|
190
169
|
[client-docs]: https://cloud.google.com/nodejs/docs/reference/containeranalysis/latest
|
|
191
170
|
[product-docs]: https://cloud.google.com/container-registry/docs/container-analysis
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
// Copyright
|
|
1
|
+
// Copyright 2023 Google LLC
|
|
2
2
|
//
|
|
3
3
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
4
4
|
// you may not use this file except in compliance with the License.
|
|
@@ -11,7 +11,6 @@
|
|
|
11
11
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
12
12
|
// See the License for the specific language governing permissions and
|
|
13
13
|
// limitations under the License.
|
|
14
|
-
//
|
|
15
14
|
|
|
16
15
|
syntax = "proto3";
|
|
17
16
|
|
|
@@ -20,10 +19,8 @@ package google.devtools.containeranalysis.v1beta1;
|
|
|
20
19
|
import "google/api/annotations.proto";
|
|
21
20
|
import "google/api/client.proto";
|
|
22
21
|
import "google/api/field_behavior.proto";
|
|
23
|
-
import "google/api/resource.proto";
|
|
24
22
|
import "google/iam/v1/iam_policy.proto";
|
|
25
23
|
import "google/iam/v1/policy.proto";
|
|
26
|
-
import "google/protobuf/timestamp.proto";
|
|
27
24
|
|
|
28
25
|
option go_package = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1beta1;containeranalysis";
|
|
29
26
|
option java_multiple_files = true;
|
|
@@ -32,7 +29,7 @@ option objc_class_prefix = "GCA";
|
|
|
32
29
|
|
|
33
30
|
// Retrieves analysis results of Cloud components such as Docker container
|
|
34
31
|
// images. The Container Analysis API is an implementation of the
|
|
35
|
-
// [Grafeas](grafeas.io) API.
|
|
32
|
+
// [Grafeas](https://grafeas.io) API.
|
|
36
33
|
//
|
|
37
34
|
// Analysis results are stored as a series of occurrences. An `Occurrence`
|
|
38
35
|
// contains information about a specific analysis instance on a resource. An
|
|
@@ -45,7 +42,8 @@ option objc_class_prefix = "GCA";
|
|
|
45
42
|
// image with the vulnerability referring to that note.
|
|
46
43
|
service ContainerAnalysisV1Beta1 {
|
|
47
44
|
option (google.api.default_host) = "containeranalysis.googleapis.com";
|
|
48
|
-
option (google.api.oauth_scopes) =
|
|
45
|
+
option (google.api.oauth_scopes) =
|
|
46
|
+
"https://www.googleapis.com/auth/cloud-platform";
|
|
49
47
|
|
|
50
48
|
// Sets the access control policy on the specified note or occurrence.
|
|
51
49
|
// Requires `containeranalysis.notes.setIamPolicy` or
|
|
@@ -55,7 +53,8 @@ service ContainerAnalysisV1Beta1 {
|
|
|
55
53
|
// The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for
|
|
56
54
|
// notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
|
|
57
55
|
// occurrences.
|
|
58
|
-
rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest)
|
|
56
|
+
rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest)
|
|
57
|
+
returns (google.iam.v1.Policy) {
|
|
59
58
|
option (google.api.http) = {
|
|
60
59
|
post: "/v1beta1/{resource=projects/*/notes/*}:setIamPolicy"
|
|
61
60
|
body: "*"
|
|
@@ -75,7 +74,8 @@ service ContainerAnalysisV1Beta1 {
|
|
|
75
74
|
// The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for
|
|
76
75
|
// notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
|
|
77
76
|
// occurrences.
|
|
78
|
-
rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest)
|
|
77
|
+
rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest)
|
|
78
|
+
returns (google.iam.v1.Policy) {
|
|
79
79
|
option (google.api.http) = {
|
|
80
80
|
post: "/v1beta1/{resource=projects/*/notes/*}:getIamPolicy"
|
|
81
81
|
body: "*"
|
|
@@ -94,7 +94,8 @@ service ContainerAnalysisV1Beta1 {
|
|
|
94
94
|
// The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for
|
|
95
95
|
// notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
|
|
96
96
|
// occurrences.
|
|
97
|
-
rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest)
|
|
97
|
+
rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest)
|
|
98
|
+
returns (google.iam.v1.TestIamPermissionsResponse) {
|
|
98
99
|
option (google.api.http) = {
|
|
99
100
|
post: "/v1beta1/{resource=projects/*/notes/*}:testIamPermissions"
|
|
100
101
|
body: "*"
|
|
@@ -105,115 +106,4 @@ service ContainerAnalysisV1Beta1 {
|
|
|
105
106
|
};
|
|
106
107
|
option (google.api.method_signature) = "resource,permissions";
|
|
107
108
|
}
|
|
108
|
-
|
|
109
|
-
// Gets the specified scan configuration.
|
|
110
|
-
rpc GetScanConfig(GetScanConfigRequest) returns (ScanConfig) {
|
|
111
|
-
option (google.api.http) = {
|
|
112
|
-
get: "/v1beta1/{name=projects/*/scanConfigs/*}"
|
|
113
|
-
};
|
|
114
|
-
option (google.api.method_signature) = "name";
|
|
115
|
-
}
|
|
116
|
-
|
|
117
|
-
// Lists scan configurations for the specified project.
|
|
118
|
-
rpc ListScanConfigs(ListScanConfigsRequest) returns (ListScanConfigsResponse) {
|
|
119
|
-
option (google.api.http) = {
|
|
120
|
-
get: "/v1beta1/{parent=projects/*}/scanConfigs"
|
|
121
|
-
};
|
|
122
|
-
option (google.api.method_signature) = "parent,filter";
|
|
123
|
-
}
|
|
124
|
-
|
|
125
|
-
// Updates the specified scan configuration.
|
|
126
|
-
rpc UpdateScanConfig(UpdateScanConfigRequest) returns (ScanConfig) {
|
|
127
|
-
option (google.api.http) = {
|
|
128
|
-
put: "/v1beta1/{name=projects/*/scanConfigs/*}"
|
|
129
|
-
body: "scan_config"
|
|
130
|
-
};
|
|
131
|
-
option (google.api.method_signature) = "name,scan_config";
|
|
132
|
-
}
|
|
133
|
-
}
|
|
134
|
-
|
|
135
|
-
// A scan configuration specifies whether Cloud components in a project have a
|
|
136
|
-
// particular type of analysis being run. For example, it can configure whether
|
|
137
|
-
// vulnerability scanning is being done on Docker images or not.
|
|
138
|
-
message ScanConfig {
|
|
139
|
-
option (google.api.resource) = {
|
|
140
|
-
type: "containeranalysis.googleapis.com/ScanConfig"
|
|
141
|
-
pattern: "projects/{project}/scanConfigs/{scan_config}"
|
|
142
|
-
};
|
|
143
|
-
|
|
144
|
-
// Output only. The name of the scan configuration in the form of
|
|
145
|
-
// `projects/[PROJECT_ID]/scanConfigs/[SCAN_CONFIG_ID]`.
|
|
146
|
-
string name = 1;
|
|
147
|
-
|
|
148
|
-
// Output only. A human-readable description of what the scan configuration
|
|
149
|
-
// does.
|
|
150
|
-
string description = 2;
|
|
151
|
-
|
|
152
|
-
// Whether the scan is enabled.
|
|
153
|
-
bool enabled = 3;
|
|
154
|
-
|
|
155
|
-
// Output only. The time this scan config was created.
|
|
156
|
-
google.protobuf.Timestamp create_time = 4;
|
|
157
|
-
|
|
158
|
-
// Output only. The time this scan config was last updated.
|
|
159
|
-
google.protobuf.Timestamp update_time = 5;
|
|
160
|
-
}
|
|
161
|
-
|
|
162
|
-
// Request to get a scan configuration.
|
|
163
|
-
message GetScanConfigRequest {
|
|
164
|
-
// Required. The name of the scan configuration in the form of
|
|
165
|
-
// `projects/[PROJECT_ID]/scanConfigs/[SCAN_CONFIG_ID]`.
|
|
166
|
-
string name = 1 [
|
|
167
|
-
(google.api.field_behavior) = REQUIRED,
|
|
168
|
-
(google.api.resource_reference) = {
|
|
169
|
-
type: "containeranalysis.googleapis.com/ScanConfig"
|
|
170
|
-
}
|
|
171
|
-
];
|
|
172
|
-
}
|
|
173
|
-
|
|
174
|
-
// Request to list scan configurations.
|
|
175
|
-
message ListScanConfigsRequest {
|
|
176
|
-
// Required. The name of the project to list scan configurations for in the form of
|
|
177
|
-
// `projects/[PROJECT_ID]`.
|
|
178
|
-
string parent = 1 [
|
|
179
|
-
(google.api.field_behavior) = REQUIRED,
|
|
180
|
-
(google.api.resource_reference) = {
|
|
181
|
-
type: "cloudresourcemanager.googleapis.com/Project"
|
|
182
|
-
}
|
|
183
|
-
];
|
|
184
|
-
|
|
185
|
-
// Required. The filter expression.
|
|
186
|
-
string filter = 2 [(google.api.field_behavior) = REQUIRED];
|
|
187
|
-
|
|
188
|
-
// The number of scan configs to return in the list.
|
|
189
|
-
int32 page_size = 3;
|
|
190
|
-
|
|
191
|
-
// Token to provide to skip to a particular spot in the list.
|
|
192
|
-
string page_token = 4;
|
|
193
|
-
}
|
|
194
|
-
|
|
195
|
-
// Response for listing scan configurations.
|
|
196
|
-
message ListScanConfigsResponse {
|
|
197
|
-
// The scan configurations requested.
|
|
198
|
-
repeated ScanConfig scan_configs = 1;
|
|
199
|
-
|
|
200
|
-
// The next pagination token in the list response. It should be used as
|
|
201
|
-
// `page_token` for the following request. An empty value means no more
|
|
202
|
-
// results.
|
|
203
|
-
string next_page_token = 2;
|
|
204
|
-
}
|
|
205
|
-
|
|
206
|
-
// A request to update a scan configuration.
|
|
207
|
-
message UpdateScanConfigRequest {
|
|
208
|
-
// Required. The name of the scan configuration in the form of
|
|
209
|
-
// `projects/[PROJECT_ID]/scanConfigs/[SCAN_CONFIG_ID]`.
|
|
210
|
-
string name = 1 [
|
|
211
|
-
(google.api.field_behavior) = REQUIRED,
|
|
212
|
-
(google.api.resource_reference) = {
|
|
213
|
-
type: "containeranalysis.googleapis.com/ScanConfig"
|
|
214
|
-
}
|
|
215
|
-
];
|
|
216
|
-
|
|
217
|
-
// Required. The updated scan configuration.
|
|
218
|
-
ScanConfig scan_config = 2 [(google.api.field_behavior) = REQUIRED];
|
|
219
109
|
}
|
|
@@ -33,6 +33,7 @@ import "grafeas/v1/dsse_attestation.proto";
|
|
|
33
33
|
import "grafeas/v1/image.proto";
|
|
34
34
|
import "grafeas/v1/package.proto";
|
|
35
35
|
import "grafeas/v1/upgrade.proto";
|
|
36
|
+
import "grafeas/v1/vex.proto";
|
|
36
37
|
import "grafeas/v1/vulnerability.proto";
|
|
37
38
|
|
|
38
39
|
option go_package = "google.golang.org/genproto/googleapis/grafeas/v1;grafeas";
|
|
@@ -314,6 +315,8 @@ message Note {
|
|
|
314
315
|
grafeas.v1.ComplianceNote compliance = 18;
|
|
315
316
|
// A note describing a dsse attestation note.
|
|
316
317
|
grafeas.v1.DSSEAttestationNote dsse_attestation = 19;
|
|
318
|
+
// A note describing a vulnerability assessment.
|
|
319
|
+
grafeas.v1.VulnerabilityAssessmentNote vulnerability_assessment = 20;
|
|
317
320
|
}
|
|
318
321
|
}
|
|
319
322
|
|