VulnerabilityAudit¶

class oci.adm.models.VulnerabilityAudit(**kwargs)¶

Bases: object

A Vulnerability Audit associates the Application Dependencies of a project with their associated Vulnerabilities. Each Vulnerability is associated with a score (Common Vulnerability Scoring System V2 or V3). A vulnerable Application Dependency can be ignored based on the configuration of the Vulnerability Audit. maxObservedCvssV2Score, maxObservedCvssV3Score and vulnerableArtifactsCount do not take into account non-vulnerable Application Dependency.

Attributes

`BUILD_TYPE_MAVEN`	A constant which can be used with the build_type property of a VulnerabilityAudit.
`LIFECYCLE_STATE_ACTIVE`	A constant which can be used with the lifecycle_state property of a VulnerabilityAudit.
`LIFECYCLE_STATE_CREATING`	A constant which can be used with the lifecycle_state property of a VulnerabilityAudit.
`LIFECYCLE_STATE_DELETED`	A constant which can be used with the lifecycle_state property of a VulnerabilityAudit.
`LIFECYCLE_STATE_DELETING`	A constant which can be used with the lifecycle_state property of a VulnerabilityAudit.
`LIFECYCLE_STATE_FAILED`	A constant which can be used with the lifecycle_state property of a VulnerabilityAudit.
`build_type`	[Required] Gets the build_type of this VulnerabilityAudit.
`compartment_id`	[Required] Gets the compartment_id of this VulnerabilityAudit.
`configuration`	Gets the configuration of this VulnerabilityAudit.
`defined_tags`	Gets the defined_tags of this VulnerabilityAudit.
`display_name`	Gets the display_name of this VulnerabilityAudit.
`freeform_tags`	Gets the freeform_tags of this VulnerabilityAudit.
`id`	[Required] Gets the id of this VulnerabilityAudit.
`is_success`	Gets the is_success of this VulnerabilityAudit.
`knowledge_base_id`	[Required] Gets the knowledge_base_id of this VulnerabilityAudit.
`lifecycle_state`	[Required] Gets the lifecycle_state of this VulnerabilityAudit.
`max_observed_cvss_v2_score`	[Required] Gets the max_observed_cvss_v2_score of this VulnerabilityAudit.
`max_observed_cvss_v2_score_with_ignored`	[Required] Gets the max_observed_cvss_v2_score_with_ignored of this VulnerabilityAudit.
`max_observed_cvss_v3_score`	[Required] Gets the max_observed_cvss_v3_score of this VulnerabilityAudit.
`max_observed_cvss_v3_score_with_ignored`	[Required] Gets the max_observed_cvss_v3_score_with_ignored of this VulnerabilityAudit.
`source`	[Required] Gets the source of this VulnerabilityAudit.
`system_tags`	Gets the system_tags of this VulnerabilityAudit.
`time_created`	[Required] Gets the time_created of this VulnerabilityAudit.
`time_updated`	[Required] Gets the time_updated of this VulnerabilityAudit.
`vulnerabilities`	[Required] Gets the vulnerabilities of this VulnerabilityAudit.
`vulnerable_artifacts_count`	[Required] Gets the vulnerable_artifacts_count of this VulnerabilityAudit.
`vulnerable_artifacts_count_with_ignored`	[Required] Gets the vulnerable_artifacts_count_with_ignored of this VulnerabilityAudit.

Methods

__init__(**kwargs) Initializes a new VulnerabilityAudit object with values from keyword arguments.

BUILD_TYPE_MAVEN = 'MAVEN'¶: A constant which can be used with the build_type property of a VulnerabilityAudit. This constant has a value of “MAVEN”

LIFECYCLE_STATE_ACTIVE = 'ACTIVE'¶: A constant which can be used with the lifecycle_state property of a VulnerabilityAudit. This constant has a value of “ACTIVE”

LIFECYCLE_STATE_CREATING = 'CREATING'¶: A constant which can be used with the lifecycle_state property of a VulnerabilityAudit. This constant has a value of “CREATING”

LIFECYCLE_STATE_DELETED = 'DELETED'¶: A constant which can be used with the lifecycle_state property of a VulnerabilityAudit. This constant has a value of “DELETED”

LIFECYCLE_STATE_DELETING = 'DELETING'¶: A constant which can be used with the lifecycle_state property of a VulnerabilityAudit. This constant has a value of “DELETING”

LIFECYCLE_STATE_FAILED = 'FAILED'¶: A constant which can be used with the lifecycle_state property of a VulnerabilityAudit. This constant has a value of “FAILED”

__init__(**kwargs)¶

Initializes a new VulnerabilityAudit object with values from keyword arguments. The following keyword arguments are supported (corresponding to the getters/setters of this class):

Parameters:

id (str) – The value to assign to the id property of this VulnerabilityAudit.
display_name (str) – The value to assign to the display_name property of this VulnerabilityAudit.
knowledge_base_id (str) – The value to assign to the knowledge_base_id property of this VulnerabilityAudit.
time_created (datetime) – The value to assign to the time_created property of this VulnerabilityAudit.
time_updated (datetime) – The value to assign to the time_updated property of this VulnerabilityAudit.
lifecycle_state (str) – The value to assign to the lifecycle_state property of this VulnerabilityAudit. Allowed values for this property are: “ACTIVE”, “CREATING”, “DELETED”, “DELETING”, “FAILED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
vulnerabilities (list[oci.adm.models.Vulnerability]) – The value to assign to the vulnerabilities property of this VulnerabilityAudit.
max_observed_cvss_v2_score (float) – The value to assign to the max_observed_cvss_v2_score property of this VulnerabilityAudit.
max_observed_cvss_v3_score (float) – The value to assign to the max_observed_cvss_v3_score property of this VulnerabilityAudit.
max_observed_cvss_v2_score_with_ignored (float) – The value to assign to the max_observed_cvss_v2_score_with_ignored property of this VulnerabilityAudit.
max_observed_cvss_v3_score_with_ignored (float) – The value to assign to the max_observed_cvss_v3_score_with_ignored property of this VulnerabilityAudit.
vulnerable_artifacts_count_with_ignored (int) – The value to assign to the vulnerable_artifacts_count_with_ignored property of this VulnerabilityAudit.
vulnerable_artifacts_count (int) – The value to assign to the vulnerable_artifacts_count property of this VulnerabilityAudit.
configuration (oci.adm.models.VulnerabilityAuditConfiguration) – The value to assign to the configuration property of this VulnerabilityAudit.
is_success (bool) – The value to assign to the is_success property of this VulnerabilityAudit.
build_type (str) – The value to assign to the build_type property of this VulnerabilityAudit. Allowed values for this property are: “MAVEN”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
source (oci.adm.models.VulnerabilityAuditSource) – The value to assign to the source property of this VulnerabilityAudit.
compartment_id (str) – The value to assign to the compartment_id property of this VulnerabilityAudit.
freeform_tags (dict(str, str)) – The value to assign to the freeform_tags property of this VulnerabilityAudit.
defined_tags (dict(str, dict(str, object))) – The value to assign to the defined_tags property of this VulnerabilityAudit.
system_tags (dict(str, dict(str, object))) – The value to assign to the system_tags property of this VulnerabilityAudit.

build_type¶

[Required] Gets the build_type of this VulnerabilityAudit. The type of the build tool.

Allowed values for this property are: “MAVEN”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns:	The build_type of this VulnerabilityAudit.
Return type:	str

compartment_id¶

[Required] Gets the compartment_id of this VulnerabilityAudit. The Oracle Cloud identifier (OCID) of the compartment associated with the Vulnerability Audit.

Returns:	The compartment_id of this VulnerabilityAudit.
Return type:	str

configuration¶

Gets the configuration of this VulnerabilityAudit.

Returns:	The configuration of this VulnerabilityAudit.
Return type:	oci.adm.models.VulnerabilityAuditConfiguration

defined_tags¶

Gets the defined_tags of this VulnerabilityAudit. Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {“foo-namespace”: {“bar-key”: “value”}}

Returns:	The defined_tags of this VulnerabilityAudit.
Return type:	dict(str, dict(str, object))

display_name¶

Gets the display_name of this VulnerabilityAudit. The name of the Vulnerability Audit.

Returns:	The display_name of this VulnerabilityAudit.
Return type:	str

freeform_tags¶

Gets the freeform_tags of this VulnerabilityAudit. Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {“bar-key”: “value”}

Returns:	The freeform_tags of this VulnerabilityAudit.
Return type:	dict(str, str)

id¶

[Required] Gets the id of this VulnerabilityAudit. The Oracle Cloud identifier (OCID) of the Vulnerability Audit.

Returns:	The id of this VulnerabilityAudit.
Return type:	str

is_success¶

Gets the is_success of this VulnerabilityAudit. Indicates if an audit succeeded according to the configuration. The value is null if the audit is in the CREATING state.

Returns:	The is_success of this VulnerabilityAudit.
Return type:	bool

knowledge_base_id¶

[Required] Gets the knowledge_base_id of this VulnerabilityAudit. The Oracle Cloud identifier (OCID) of the Knowledge Base.

Returns:	The knowledge_base_id of this VulnerabilityAudit.
Return type:	str

lifecycle_state¶

[Required] Gets the lifecycle_state of this VulnerabilityAudit. The current lifecycle state of the Vulnerability Audit.

Allowed values for this property are: “ACTIVE”, “CREATING”, “DELETED”, “DELETING”, “FAILED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns:	The lifecycle_state of this VulnerabilityAudit.
Return type:	str

max_observed_cvss_v2_score¶

[Required] Gets the max_observed_cvss_v2_score of this VulnerabilityAudit. Maximum Common Vulnerability Scoring System Version 2 score observed for non-ignored vulnerable Application Dependencies.

Returns:	The max_observed_cvss_v2_score of this VulnerabilityAudit.
Return type:	float

max_observed_cvss_v2_score_with_ignored¶

[Required] Gets the max_observed_cvss_v2_score_with_ignored of this VulnerabilityAudit. Maximum Common Vulnerability Scoring System Version 2 score observed for vulnerable Application Dependencies including ignored ones.

Returns:	The max_observed_cvss_v2_score_with_ignored of this VulnerabilityAudit.
Return type:	float

max_observed_cvss_v3_score¶

[Required] Gets the max_observed_cvss_v3_score of this VulnerabilityAudit. Maximum Common Vulnerability Scoring System Version 3 score observed for non-ignored vulnerable Application Dependencies.

Returns:	The max_observed_cvss_v3_score of this VulnerabilityAudit.
Return type:	float

max_observed_cvss_v3_score_with_ignored¶

[Required] Gets the max_observed_cvss_v3_score_with_ignored of this VulnerabilityAudit. Maximum Common Vulnerability Scoring System Version 3 score observed for vulnerable Application Dependencies including ignored ones.

Returns:	The max_observed_cvss_v3_score_with_ignored of this VulnerabilityAudit.
Return type:	float

source¶

[Required] Gets the source of this VulnerabilityAudit.

Returns:	The source of this VulnerabilityAudit.
Return type:	oci.adm.models.VulnerabilityAuditSource

system_tags¶

Gets the system_tags of this VulnerabilityAudit. Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {“orcl-cloud”: {“free-tier-retained”: “true”}}

Returns:	The system_tags of this VulnerabilityAudit.
Return type:	dict(str, dict(str, object))

time_created¶

[Required] Gets the time_created of this VulnerabilityAudit. The creation date and time of the Vulnerability Audit (formatted according to RFC3339).

Returns:	The time_created of this VulnerabilityAudit.
Return type:	datetime

time_updated¶

[Required] Gets the time_updated of this VulnerabilityAudit. The update date and time of the Vulnerability Audit (formatted according to RFC3339).

Returns:	The time_updated of this VulnerabilityAudit.
Return type:	datetime

vulnerabilities¶

[Required] Gets the vulnerabilities of this VulnerabilityAudit. List of vulnerabilities found in the Vulnerability Audit.

Returns:	The vulnerabilities of this VulnerabilityAudit.
Return type:	list[oci.adm.models.Vulnerability]

vulnerable_artifacts_count¶

[Required] Gets the vulnerable_artifacts_count of this VulnerabilityAudit. Count of non-ignored vulnerable Application Dependencies.

Returns:	The vulnerable_artifacts_count of this VulnerabilityAudit.
Return type:	int

vulnerable_artifacts_count_with_ignored¶

[Required] Gets the vulnerable_artifacts_count_with_ignored of this VulnerabilityAudit. Count of all vulnerable Application Dependencies.

Returns:	The vulnerable_artifacts_count_with_ignored of this VulnerabilityAudit.
Return type:	int