Constructor
new GrafeasV1Beta1Client(optionsopt)
Construct an instance of GrafeasV1Beta1Client.
Parameters:
Name | Type | Attributes | Description | ||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
object |
<optional> |
The configuration object. See the subsequent parameters for more details. Properties
|
Members
(static) apiEndpoint
The DNS address for this API service - same as servicePath(), exists for compatibility reasons.
(static) port
The port for this API service.
(static) scopes
The scopes needed to make gRPC calls for every method defined in this service.
(static) servicePath
The DNS address for this API service.
Methods
batchCreateNotes(request, optionsopt, callbackopt) → {Promise}
Creates new notes in batch.
Parameters:
Name | Type | Attributes | Description | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
||||||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
|||||||||
callback |
function |
<optional> |
The function which will be called with the result of the API call. The second parameter to the callback is an object representing BatchCreateNotesResponse. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
const formattedParent = client.projectPath('[PROJECT]');
const notes = {};
const request = {
parent: formattedParent,
notes: notes,
};
client.batchCreateNotes(request)
.then(responses => {
const response = responses[0];
// doThingsWith(response)
})
.catch(err => {
console.error(err);
});
batchCreateOccurrences(request, optionsopt, callbackopt) → {Promise}
Creates new occurrences in batch.
Parameters:
Name | Type | Attributes | Description | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
||||||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
|||||||||
callback |
function |
<optional> |
The function which will be called with the result of the API call. The second parameter to the callback is an object representing BatchCreateOccurrencesResponse. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
const formattedParent = client.projectPath('[PROJECT]');
const occurrences = [];
const request = {
parent: formattedParent,
occurrences: occurrences,
};
client.batchCreateOccurrences(request)
.then(responses => {
const response = responses[0];
// doThingsWith(response)
})
.catch(err => {
console.error(err);
});
createNote(request, optionsopt, callbackopt) → {Promise}
Creates a new note.
Parameters:
Name | Type | Attributes | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
|||||||||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
||||||||||||
callback |
function |
<optional> |
The function which will be called with the result of the API call. The second parameter to the callback is an object representing Note. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
const formattedParent = client.projectPath('[PROJECT]');
const noteId = '';
const note = {};
const request = {
parent: formattedParent,
noteId: noteId,
note: note,
};
client.createNote(request)
.then(responses => {
const response = responses[0];
// doThingsWith(response)
})
.catch(err => {
console.error(err);
});
createOccurrence(request, optionsopt, callbackopt) → {Promise}
Creates a new occurrence.
Parameters:
Name | Type | Attributes | Description | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
||||||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
|||||||||
callback |
function |
<optional> |
The function which will be called with the result of the API call. The second parameter to the callback is an object representing Occurrence. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
const formattedParent = client.projectPath('[PROJECT]');
const occurrence = {};
const request = {
parent: formattedParent,
occurrence: occurrence,
};
client.createOccurrence(request)
.then(responses => {
const response = responses[0];
// doThingsWith(response)
})
.catch(err => {
console.error(err);
});
deleteNote(request, optionsopt, callbackopt) → {Promise}
Deletes the specified note.
Parameters:
Name | Type | Attributes | Description | ||||||
---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
|||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
||||||
callback |
function |
<optional> |
The function which will be called with the result of the API call. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
const formattedName = client.notePath('[PROJECT]', '[NOTE]');
client.deleteNote({name: formattedName}).catch(err => {
console.error(err);
});
deleteOccurrence(request, optionsopt, callbackopt) → {Promise}
Deletes the specified occurrence. For example, use this method to delete an occurrence when the occurrence is no longer applicable for the given resource.
Parameters:
Name | Type | Attributes | Description | ||||||
---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
|||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
||||||
callback |
function |
<optional> |
The function which will be called with the result of the API call. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
const formattedName = client.occurrencePath('[PROJECT]', '[OCCURRENCE]');
client.deleteOccurrence({name: formattedName}).catch(err => {
console.error(err);
});
getNote(request, optionsopt, callbackopt) → {Promise}
Gets the specified note.
Parameters:
Name | Type | Attributes | Description | ||||||
---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
|||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
||||||
callback |
function |
<optional> |
The function which will be called with the result of the API call. The second parameter to the callback is an object representing Note. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
const formattedName = client.notePath('[PROJECT]', '[NOTE]');
client.getNote({name: formattedName})
.then(responses => {
const response = responses[0];
// doThingsWith(response)
})
.catch(err => {
console.error(err);
});
getOccurrence(request, optionsopt, callbackopt) → {Promise}
Gets the specified occurrence.
Parameters:
Name | Type | Attributes | Description | ||||||
---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
|||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
||||||
callback |
function |
<optional> |
The function which will be called with the result of the API call. The second parameter to the callback is an object representing Occurrence. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
const formattedName = client.occurrencePath('[PROJECT]', '[OCCURRENCE]');
client.getOccurrence({name: formattedName})
.then(responses => {
const response = responses[0];
// doThingsWith(response)
})
.catch(err => {
console.error(err);
});
getOccurrenceNote(request, optionsopt, callbackopt) → {Promise}
Gets the note attached to the specified occurrence. Consumer projects can use this method to get a note that belongs to a provider project.
Parameters:
Name | Type | Attributes | Description | ||||||
---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
|||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
||||||
callback |
function |
<optional> |
The function which will be called with the result of the API call. The second parameter to the callback is an object representing Note. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
const formattedName = client.occurrencePath('[PROJECT]', '[OCCURRENCE]');
client.getOccurrenceNote({name: formattedName})
.then(responses => {
const response = responses[0];
// doThingsWith(response)
})
.catch(err => {
console.error(err);
});
getProjectId(callback)
Return the project ID used by this class.
Parameters:
Name | Type | Description |
---|---|---|
callback |
function |
the callback to be called with the current project Id. |
getVulnerabilityOccurrencesSummary(request, optionsopt, callbackopt) → {Promise}
Gets a summary of the number and severity of occurrences.
Parameters:
Name | Type | Attributes | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
|||||||||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
||||||||||||
callback |
function |
<optional> |
The function which will be called with the result of the API call. The second parameter to the callback is an object representing VulnerabilityOccurrencesSummary. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
const formattedParent = client.projectPath('[PROJECT]');
client.getVulnerabilityOccurrencesSummary({parent: formattedParent})
.then(responses => {
const response = responses[0];
// doThingsWith(response)
})
.catch(err => {
console.error(err);
});
listNoteOccurrences(request, optionsopt, callbackopt) → {Promise}
Lists occurrences referencing the specified note. Provider projects can use this method to get all occurrences across consumer projects referencing the specified note.
Parameters:
Name | Type | Attributes | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
|||||||||||||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
||||||||||||||||
callback |
function |
<optional> |
The function which will be called with the result of the API call. The second parameter to the callback is Array of Occurrence. When autoPaginate: false is specified through options, it contains the result in a single response. If the response indicates the next page exists, the third parameter is set to be used for the next request object. The fourth parameter keeps the raw response object of an object representing ListNoteOccurrencesResponse. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
// Iterate over all elements.
const formattedName = client.notePath('[PROJECT]', '[NOTE]');
client.listNoteOccurrences({name: formattedName})
.then(responses => {
const resources = responses[0];
for (const resource of resources) {
// doThingsWith(resource)
}
})
.catch(err => {
console.error(err);
});
// Or obtain the paged response.
const formattedName = client.notePath('[PROJECT]', '[NOTE]');
const options = {autoPaginate: false};
const callback = responses => {
// The actual resources in a response.
const resources = responses[0];
// The next request if the response shows that there are more responses.
const nextRequest = responses[1];
// The actual response object, if necessary.
// const rawResponse = responses[2];
for (const resource of resources) {
// doThingsWith(resource);
}
if (nextRequest) {
// Fetch the next page.
return client.listNoteOccurrences(nextRequest, options).then(callback);
}
}
client.listNoteOccurrences({name: formattedName}, options)
.then(callback)
.catch(err => {
console.error(err);
});
listNoteOccurrencesStream(request, optionsopt) → {Stream}
Equivalent to listNoteOccurrences, but returns a NodeJS Stream object.
This fetches the paged responses for listNoteOccurrences continuously and invokes the callback registered for 'data' event for each element in the responses.
The returned object has 'end' method when no more elements are required.
autoPaginate option will be ignored.
Parameters:
Name | Type | Attributes | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
|||||||||||||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
const formattedName = client.notePath('[PROJECT]', '[NOTE]');
client.listNoteOccurrencesStream({name: formattedName})
.on('data', element => {
// doThingsWith(element)
}).on('error', err => {
console.log(err);
});
listNotes(request, optionsopt, callbackopt) → {Promise}
Lists notes for the specified project.
Parameters:
Name | Type | Attributes | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
|||||||||||||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
||||||||||||||||
callback |
function |
<optional> |
The function which will be called with the result of the API call. The second parameter to the callback is Array of Note. When autoPaginate: false is specified through options, it contains the result in a single response. If the response indicates the next page exists, the third parameter is set to be used for the next request object. The fourth parameter keeps the raw response object of an object representing ListNotesResponse. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
// Iterate over all elements.
const formattedParent = client.projectPath('[PROJECT]');
client.listNotes({parent: formattedParent})
.then(responses => {
const resources = responses[0];
for (const resource of resources) {
// doThingsWith(resource)
}
})
.catch(err => {
console.error(err);
});
// Or obtain the paged response.
const formattedParent = client.projectPath('[PROJECT]');
const options = {autoPaginate: false};
const callback = responses => {
// The actual resources in a response.
const resources = responses[0];
// The next request if the response shows that there are more responses.
const nextRequest = responses[1];
// The actual response object, if necessary.
// const rawResponse = responses[2];
for (const resource of resources) {
// doThingsWith(resource);
}
if (nextRequest) {
// Fetch the next page.
return client.listNotes(nextRequest, options).then(callback);
}
}
client.listNotes({parent: formattedParent}, options)
.then(callback)
.catch(err => {
console.error(err);
});
listNotesStream(request, optionsopt) → {Stream}
Equivalent to listNotes, but returns a NodeJS Stream object.
This fetches the paged responses for listNotes continuously and invokes the callback registered for 'data' event for each element in the responses.
The returned object has 'end' method when no more elements are required.
autoPaginate option will be ignored.
Parameters:
Name | Type | Attributes | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
|||||||||||||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
const formattedParent = client.projectPath('[PROJECT]');
client.listNotesStream({parent: formattedParent})
.on('data', element => {
// doThingsWith(element)
}).on('error', err => {
console.log(err);
});
listOccurrences(request, optionsopt, callbackopt) → {Promise}
Lists occurrences for the specified project.
Parameters:
Name | Type | Attributes | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
|||||||||||||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
||||||||||||||||
callback |
function |
<optional> |
The function which will be called with the result of the API call. The second parameter to the callback is Array of Occurrence. When autoPaginate: false is specified through options, it contains the result in a single response. If the response indicates the next page exists, the third parameter is set to be used for the next request object. The fourth parameter keeps the raw response object of an object representing ListOccurrencesResponse. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
// Iterate over all elements.
const formattedParent = client.projectPath('[PROJECT]');
client.listOccurrences({parent: formattedParent})
.then(responses => {
const resources = responses[0];
for (const resource of resources) {
// doThingsWith(resource)
}
})
.catch(err => {
console.error(err);
});
// Or obtain the paged response.
const formattedParent = client.projectPath('[PROJECT]');
const options = {autoPaginate: false};
const callback = responses => {
// The actual resources in a response.
const resources = responses[0];
// The next request if the response shows that there are more responses.
const nextRequest = responses[1];
// The actual response object, if necessary.
// const rawResponse = responses[2];
for (const resource of resources) {
// doThingsWith(resource);
}
if (nextRequest) {
// Fetch the next page.
return client.listOccurrences(nextRequest, options).then(callback);
}
}
client.listOccurrences({parent: formattedParent}, options)
.then(callback)
.catch(err => {
console.error(err);
});
listOccurrencesStream(request, optionsopt) → {Stream}
Equivalent to listOccurrences, but returns a NodeJS Stream object.
This fetches the paged responses for listOccurrences continuously and invokes the callback registered for 'data' event for each element in the responses.
The returned object has 'end' method when no more elements are required.
autoPaginate option will be ignored.
Parameters:
Name | Type | Attributes | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
|||||||||||||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
const formattedParent = client.projectPath('[PROJECT]');
client.listOccurrencesStream({parent: formattedParent})
.on('data', element => {
// doThingsWith(element)
}).on('error', err => {
console.log(err);
});
matchNoteFromNoteName(noteName) → {String}
Parse the noteName from a note resource.
Parameters:
Name | Type | Description |
---|---|---|
noteName |
String |
A fully-qualified path representing a note resources. |
matchOccurrenceFromOccurrenceName(occurrenceName) → {String}
Parse the occurrenceName from a occurrence resource.
Parameters:
Name | Type | Description |
---|---|---|
occurrenceName |
String |
A fully-qualified path representing a occurrence resources. |
matchProjectFromNoteName(noteName) → {String}
Parse the noteName from a note resource.
Parameters:
Name | Type | Description |
---|---|---|
noteName |
String |
A fully-qualified path representing a note resources. |
matchProjectFromOccurrenceName(occurrenceName) → {String}
Parse the occurrenceName from a occurrence resource.
Parameters:
Name | Type | Description |
---|---|---|
occurrenceName |
String |
A fully-qualified path representing a occurrence resources. |
matchProjectFromProjectName(projectName) → {String}
Parse the projectName from a project resource.
Parameters:
Name | Type | Description |
---|---|---|
projectName |
String |
A fully-qualified path representing a project resources. |
notePath(project, note) → {String}
Return a fully-qualified note resource name string.
Parameters:
Name | Type | Description |
---|---|---|
project |
String | |
note |
String |
occurrencePath(project, occurrence) → {String}
Return a fully-qualified occurrence resource name string.
Parameters:
Name | Type | Description |
---|---|---|
project |
String | |
occurrence |
String |
projectPath(project) → {String}
Return a fully-qualified project resource name string.
Parameters:
Name | Type | Description |
---|---|---|
project |
String |
updateNote(request, optionsopt, callbackopt) → {Promise}
Updates the specified note.
Parameters:
Name | Type | Attributes | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
|||||||||||||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
||||||||||||||||
callback |
function |
<optional> |
The function which will be called with the result of the API call. The second parameter to the callback is an object representing Note. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
const formattedName = client.notePath('[PROJECT]', '[NOTE]');
const note = {};
const request = {
name: formattedName,
note: note,
};
client.updateNote(request)
.then(responses => {
const response = responses[0];
// doThingsWith(response)
})
.catch(err => {
console.error(err);
});
updateOccurrence(request, optionsopt, callbackopt) → {Promise}
Updates the specified occurrence.
Parameters:
Name | Type | Attributes | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
request |
Object |
The request object that will be sent. Properties
|
|||||||||||||||||
options |
Object |
<optional> |
Optional parameters. You can override the default settings for this call, e.g, timeout, retries, paginations, etc. See gax.CallOptions for the details. |
||||||||||||||||
callback |
function |
<optional> |
The function which will be called with the result of the API call. The second parameter to the callback is an object representing Occurrence. |
Example
const containeranalysis = require('@google-cloud/containeranalysis');
const client = new containeranalysis.v1beta1.GrafeasV1Beta1Client({
// optional auth parameters.
});
const formattedName = client.occurrencePath('[PROJECT]', '[OCCURRENCE]');
const occurrence = {};
const request = {
name: formattedName,
occurrence: occurrence,
};
client.updateOccurrence(request)
.then(responses => {
const response = responses[0];
// doThingsWith(response)
})
.catch(err => {
console.error(err);
});