ReportDefinition¶
- class oci.data_safe.models.ReportDefinition(**kwargs)¶
Bases:
objectDescription of report definition.
Attributes:
A constant which can be used with the category property of a ReportDefinition.
A constant which can be used with the category property of a ReportDefinition.
A constant which can be used with the category property of a ReportDefinition.
A constant which can be used with the category property of a ReportDefinition.
A constant which can be used with the category property of a ReportDefinition.
A constant which can be used with the category property of a ReportDefinition.
A constant which can be used with the category property of a ReportDefinition.
A constant which can be used with the data_source property of a ReportDefinition.
A constant which can be used with the data_source property of a ReportDefinition.
A constant which can be used with the data_source property of a ReportDefinition.
A constant which can be used with the data_source property of a ReportDefinition.
A constant which can be used with the data_source property of a ReportDefinition.
A constant which can be used with the data_source property of a ReportDefinition.
A constant which can be used with the lifecycle_state property of a ReportDefinition.
A constant which can be used with the lifecycle_state property of a ReportDefinition.
A constant which can be used with the lifecycle_state property of a ReportDefinition.
A constant which can be used with the lifecycle_state property of a ReportDefinition.
A constant which can be used with the lifecycle_state property of a ReportDefinition.
A constant which can be used with the lifecycle_state property of a ReportDefinition.
A constant which can be used with the scheduled_report_mime_type property of a ReportDefinition.
A constant which can be used with the scheduled_report_mime_type property of a ReportDefinition.
A constant which can be used with the scheduled_report_mime_type property of a ReportDefinition.
Gets the category of this ReportDefinition.
Gets the column_filters of this ReportDefinition.
Gets the column_info of this ReportDefinition.
Gets the column_sortings of this ReportDefinition.
[Required] Gets the compartment_id of this ReportDefinition.
Gets the compliance_standards of this ReportDefinition.
Gets the data_source of this ReportDefinition.
Gets the defined_tags of this ReportDefinition.
Gets the description of this ReportDefinition.
[Required] Gets the display_name of this ReportDefinition.
Gets the display_order of this ReportDefinition.
Gets the freeform_tags of this ReportDefinition.
[Required] Gets the id of this ReportDefinition.
Gets the is_schedule_pagination_enabled of this ReportDefinition.
Gets the is_seeded of this ReportDefinition.
Gets the lifecycle_details of this ReportDefinition.
[Required] Gets the lifecycle_state of this ReportDefinition.
Gets the parent_id of this ReportDefinition.
Gets the record_time_span of this ReportDefinition.
Gets the schedule of this ReportDefinition.
Gets the scheduled_report_compartment_id of this ReportDefinition.
Gets the scheduled_report_mime_type of this ReportDefinition.
Gets the scheduled_report_name of this ReportDefinition.
Gets the scheduled_report_row_limit of this ReportDefinition.
Gets the scim_filter of this ReportDefinition.
Gets the summary of this ReportDefinition.
Gets the system_tags of this ReportDefinition.
Gets the time_created of this ReportDefinition.
Gets the time_updated of this ReportDefinition.
Methods:
__init__(**kwargs)Initializes a new ReportDefinition object with values from keyword arguments.
- CATEGORY_ACTIVITY_AUDITING = 'ACTIVITY_AUDITING'¶
A constant which can be used with the category property of a ReportDefinition. This constant has a value of “ACTIVITY_AUDITING”
- CATEGORY_ALLOWED_SQL = 'ALLOWED_SQL'¶
A constant which can be used with the category property of a ReportDefinition. This constant has a value of “ALLOWED_SQL”
- CATEGORY_CRYPTO_ASSESSMENT = 'CRYPTO_ASSESSMENT'¶
A constant which can be used with the category property of a ReportDefinition. This constant has a value of “CRYPTO_ASSESSMENT”
- CATEGORY_CUSTOM_REPORTS = 'CUSTOM_REPORTS'¶
A constant which can be used with the category property of a ReportDefinition. This constant has a value of “CUSTOM_REPORTS”
- CATEGORY_FIREWALL_VIOLATIONS = 'FIREWALL_VIOLATIONS'¶
A constant which can be used with the category property of a ReportDefinition. This constant has a value of “FIREWALL_VIOLATIONS”
- CATEGORY_SECURITY_ASSESSMENT = 'SECURITY_ASSESSMENT'¶
A constant which can be used with the category property of a ReportDefinition. This constant has a value of “SECURITY_ASSESSMENT”
- CATEGORY_SUMMARY = 'SUMMARY'¶
A constant which can be used with the category property of a ReportDefinition. This constant has a value of “SUMMARY”
- DATA_SOURCE_ALERTS = 'ALERTS'¶
A constant which can be used with the data_source property of a ReportDefinition. This constant has a value of “ALERTS”
- DATA_SOURCE_ALLOWED_SQL = 'ALLOWED_SQL'¶
A constant which can be used with the data_source property of a ReportDefinition. This constant has a value of “ALLOWED_SQL”
- DATA_SOURCE_CRYPTO_ASSESSMENT = 'CRYPTO_ASSESSMENT'¶
A constant which can be used with the data_source property of a ReportDefinition. This constant has a value of “CRYPTO_ASSESSMENT”
- DATA_SOURCE_EVENTS = 'EVENTS'¶
A constant which can be used with the data_source property of a ReportDefinition. This constant has a value of “EVENTS”
- DATA_SOURCE_SECURITY_ASSESSMENT = 'SECURITY_ASSESSMENT'¶
A constant which can be used with the data_source property of a ReportDefinition. This constant has a value of “SECURITY_ASSESSMENT”
- DATA_SOURCE_VIOLATIONS = 'VIOLATIONS'¶
A constant which can be used with the data_source property of a ReportDefinition. This constant has a value of “VIOLATIONS”
- LIFECYCLE_STATE_ACTIVE = 'ACTIVE'¶
A constant which can be used with the lifecycle_state property of a ReportDefinition. This constant has a value of “ACTIVE”
- LIFECYCLE_STATE_CREATING = 'CREATING'¶
A constant which can be used with the lifecycle_state property of a ReportDefinition. This constant has a value of “CREATING”
- LIFECYCLE_STATE_DELETED = 'DELETED'¶
A constant which can be used with the lifecycle_state property of a ReportDefinition. This constant has a value of “DELETED”
- LIFECYCLE_STATE_DELETING = 'DELETING'¶
A constant which can be used with the lifecycle_state property of a ReportDefinition. This constant has a value of “DELETING”
- LIFECYCLE_STATE_FAILED = 'FAILED'¶
A constant which can be used with the lifecycle_state property of a ReportDefinition. This constant has a value of “FAILED”
- LIFECYCLE_STATE_UPDATING = 'UPDATING'¶
A constant which can be used with the lifecycle_state property of a ReportDefinition. This constant has a value of “UPDATING”
- SCHEDULED_REPORT_MIME_TYPE_JSON = 'JSON'¶
A constant which can be used with the scheduled_report_mime_type property of a ReportDefinition. This constant has a value of “JSON”
- SCHEDULED_REPORT_MIME_TYPE_PDF = 'PDF'¶
A constant which can be used with the scheduled_report_mime_type property of a ReportDefinition. This constant has a value of “PDF”
- SCHEDULED_REPORT_MIME_TYPE_XLS = 'XLS'¶
A constant which can be used with the scheduled_report_mime_type property of a ReportDefinition. This constant has a value of “XLS”
- __init__(**kwargs)¶
Initializes a new ReportDefinition object with values from keyword arguments. The following keyword arguments are supported (corresponding to the getters/setters of this class):
- Parameters
display_name (str) – The value to assign to the display_name property of this ReportDefinition.
id (str) – The value to assign to the id property of this ReportDefinition.
parent_id (str) – The value to assign to the parent_id property of this ReportDefinition.
category (str) – The value to assign to the category property of this ReportDefinition. Allowed values for this property are: “CUSTOM_REPORTS”, “SUMMARY”, “ACTIVITY_AUDITING”, “SECURITY_ASSESSMENT”, “CRYPTO_ASSESSMENT”, “FIREWALL_VIOLATIONS”, “ALLOWED_SQL”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
description (str) – The value to assign to the description property of this ReportDefinition.
data_source (str) – The value to assign to the data_source property of this ReportDefinition. Allowed values for this property are: “EVENTS”, “ALERTS”, “SECURITY_ASSESSMENT”, “CRYPTO_ASSESSMENT”, “VIOLATIONS”, “ALLOWED_SQL”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
is_seeded (bool) – The value to assign to the is_seeded property of this ReportDefinition.
display_order (int) – The value to assign to the display_order property of this ReportDefinition.
time_created (datetime) – The value to assign to the time_created property of this ReportDefinition.
time_updated (datetime) – The value to assign to the time_updated property of this ReportDefinition.
scim_filter (str) – The value to assign to the scim_filter property of this ReportDefinition.
column_info (list[oci.data_safe.models.Column]) – The value to assign to the column_info property of this ReportDefinition.
column_filters (list[oci.data_safe.models.ColumnFilter]) – The value to assign to the column_filters property of this ReportDefinition.
column_sortings (list[oci.data_safe.models.ColumnSorting]) – The value to assign to the column_sortings property of this ReportDefinition.
summary (list[oci.data_safe.models.Summary]) – The value to assign to the summary property of this ReportDefinition.
compartment_id (str) – The value to assign to the compartment_id property of this ReportDefinition.
lifecycle_state (str) – The value to assign to the lifecycle_state property of this ReportDefinition. Allowed values for this property are: “CREATING”, “UPDATING”, “ACTIVE”, “DELETING”, “DELETED”, “FAILED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
schedule (str) – The value to assign to the schedule property of this ReportDefinition.
scheduled_report_mime_type (str) – The value to assign to the scheduled_report_mime_type property of this ReportDefinition. Allowed values for this property are: “PDF”, “XLS”, “JSON”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
scheduled_report_row_limit (int) – The value to assign to the scheduled_report_row_limit property of this ReportDefinition.
scheduled_report_name (str) – The value to assign to the scheduled_report_name property of this ReportDefinition.
scheduled_report_compartment_id (str) – The value to assign to the scheduled_report_compartment_id property of this ReportDefinition.
record_time_span (str) – The value to assign to the record_time_span property of this ReportDefinition.
compliance_standards (list[str]) – The value to assign to the compliance_standards property of this ReportDefinition.
lifecycle_details (str) – The value to assign to the lifecycle_details property of this ReportDefinition.
is_schedule_pagination_enabled (bool) – The value to assign to the is_schedule_pagination_enabled property of this ReportDefinition.
freeform_tags (dict(str, str)) – The value to assign to the freeform_tags property of this ReportDefinition.
defined_tags (dict(str, dict(str, object))) – The value to assign to the defined_tags property of this ReportDefinition.
system_tags (dict(str, dict(str, object))) – The value to assign to the system_tags property of this ReportDefinition.
- property category¶
Gets the category of this ReportDefinition. Specifies the name of the category that this report belongs to.
Allowed values for this property are: “CUSTOM_REPORTS”, “SUMMARY”, “ACTIVITY_AUDITING”, “SECURITY_ASSESSMENT”, “CRYPTO_ASSESSMENT”, “FIREWALL_VIOLATIONS”, “ALLOWED_SQL”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
- Returns
The category of this ReportDefinition.
- Return type
str
- property column_filters¶
Gets the column_filters of this ReportDefinition. An array of columnFilter objects. A columnFilter object stores all information about a column filter including field name, an operator, one or more expressions, if the filter is enabled, or if the filter is hidden.
- Returns
The column_filters of this ReportDefinition.
- Return type
- property column_info¶
Gets the column_info of this ReportDefinition. An array of column objects in the order (left to right) displayed in the report. A column object stores all information about a column, including the name displayed on the UI, corresponding field name in the data source, data type of the column, and column visibility (if the column is visible to the user).
- Returns
The column_info of this ReportDefinition.
- Return type
- property column_sortings¶
Gets the column_sortings of this ReportDefinition. An array of column sorting objects. Each column sorting object stores the column name to be sorted and if the sorting is in ascending order; sorting is done by the first column in the array, then by the second column in the array, etc.
- Returns
The column_sortings of this ReportDefinition.
- Return type
- property compartment_id¶
[Required] Gets the compartment_id of this ReportDefinition. The OCID of the compartment containing the report definition.
- Returns
The compartment_id of this ReportDefinition.
- Return type
str
- property compliance_standards¶
Gets the compliance_standards of this ReportDefinition. The list of the data protection regulations/standards used in the report that will help demonstrate compliance.
- Returns
The compliance_standards of this ReportDefinition.
- Return type
list[str]
- property data_source¶
Gets the data_source of this ReportDefinition. Specifies the name of a resource that provides data for the report. For example alerts, events.
Allowed values for this property are: “EVENTS”, “ALERTS”, “SECURITY_ASSESSMENT”, “CRYPTO_ASSESSMENT”, “VIOLATIONS”, “ALLOWED_SQL”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
- Returns
The data_source of this ReportDefinition.
- Return type
str
- property defined_tags¶
Gets the defined_tags of this ReportDefinition. Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags Example: {“Operations”: {“CostCenter”: “42”}}
- Returns
The defined_tags of this ReportDefinition.
- Return type
dict(str, dict(str, object))
- property description¶
Gets the description of this ReportDefinition. A description of the report definition.
- Returns
The description of this ReportDefinition.
- Return type
str
- property display_name¶
[Required] Gets the display_name of this ReportDefinition. Name of the report definition.
- Returns
The display_name of this ReportDefinition.
- Return type
str
- property display_order¶
Gets the display_order of this ReportDefinition. Specifies how the report definitions are ordered in the display.
- Returns
The display_order of this ReportDefinition.
- Return type
int
- property freeform_tags¶
Gets the freeform_tags of this ReportDefinition. Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags
Example: {“Department”: “Finance”}
- Returns
The freeform_tags of this ReportDefinition.
- Return type
dict(str, str)
- property id¶
[Required] Gets the id of this ReportDefinition. The OCID of the report definition.
- Returns
The id of this ReportDefinition.
- Return type
str
- property is_schedule_pagination_enabled¶
Gets the is_schedule_pagination_enabled of this ReportDefinition. Indicates if the reports being generated should be paginated. If set to true, multiple reports can be generated and the details of next and previous report are present in Report. Values can either be ‘true’ or ‘false’.
- Returns
The is_schedule_pagination_enabled of this ReportDefinition.
- Return type
bool
- property is_seeded¶
Gets the is_seeded of this ReportDefinition. Signifies whether the definition is seeded or user defined. Values can either be ‘true’ or ‘false’.
- Returns
The is_seeded of this ReportDefinition.
- Return type
bool
- property lifecycle_details¶
Gets the lifecycle_details of this ReportDefinition. Details about the current state of the report definition in Data Safe.
- Returns
The lifecycle_details of this ReportDefinition.
- Return type
str
- property lifecycle_state¶
[Required] Gets the lifecycle_state of this ReportDefinition. The current state of the report.
Allowed values for this property are: “CREATING”, “UPDATING”, “ACTIVE”, “DELETING”, “DELETED”, “FAILED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
- Returns
The lifecycle_state of this ReportDefinition.
- Return type
str
- property parent_id¶
Gets the parent_id of this ReportDefinition. The OCID of the parent report definition. In the case of seeded report definition, this is same as definition OCID.
- Returns
The parent_id of this ReportDefinition.
- Return type
str
- property record_time_span¶
Gets the record_time_span of this ReportDefinition. The time span for the records in the report to be scheduled. <period-value><period> Allowed period strings - “H”,”D”,”M”,”Y” Each of the above fields potentially introduce constraints. A workRequest is created only when period-value satisfies all the constraints. Constraints introduced: 1. period = H (The allowed range for period-value is [1, 23]) 2. period = D (The allowed range for period-value is [1, 30]) 3. period = M (The allowed range for period-value is [1, 11]) 4. period = Y (The minimum period-value is 1)
- Returns
The record_time_span of this ReportDefinition.
- Return type
str
- property schedule¶
Gets the schedule of this ReportDefinition. The schedule to generate the report periodically in the specified format: <version-string>;<version-specific-schedule>
Allowed version strings - “v1” v1’s version specific schedule -<ss> <mm> <hh> <day-of-week> <day-of-month> Each of the above fields potentially introduce constraints. A workrequest is created only when clock time satisfies all the constraints. Constraints introduced: 1. seconds = <ss> (So, the allowed range for <ss> is [0, 59]) 2. minutes = <mm> (So, the allowed range for <mm> is [0, 59]) 3. hours = <hh> (So, the allowed range for <hh> is [0, 23]) 4. <day-of-week> can be either ‘*’ (without quotes or a number between 1(Monday) and 7(Sunday)) No constraint introduced when it is ‘*’. When not, day of week must equal the given value 5. <day-of-month> can be either ‘*’ (without quotes or a number between 1 and 28) No constraint introduced when it is ‘*’. When not, day of month must equal the given value
- Returns
The schedule of this ReportDefinition.
- Return type
str
- property scheduled_report_compartment_id¶
Gets the scheduled_report_compartment_id of this ReportDefinition. The OCID of the compartment in which the scheduled resource will be created.
- Returns
The scheduled_report_compartment_id of this ReportDefinition.
- Return type
str
- property scheduled_report_mime_type¶
Gets the scheduled_report_mime_type of this ReportDefinition. Specifies the format of the report ( either .xls or .pdf or .json)
Allowed values for this property are: “PDF”, “XLS”, “JSON”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
- Returns
The scheduled_report_mime_type of this ReportDefinition.
- Return type
str
- property scheduled_report_name¶
Gets the scheduled_report_name of this ReportDefinition. The name of the report to be scheduled.
- Returns
The scheduled_report_name of this ReportDefinition.
- Return type
str
- property scheduled_report_row_limit¶
Gets the scheduled_report_row_limit of this ReportDefinition. Specifies the limit on the number of rows in the report.
- Returns
The scheduled_report_row_limit of this ReportDefinition.
- Return type
int
- property scim_filter¶
Gets the scim_filter of this ReportDefinition. Additional SCIM filters used to define the report.
- Returns
The scim_filter of this ReportDefinition.
- Return type
str
- property summary¶
Gets the summary of this ReportDefinition. An array of report summary objects in the order (left to right) displayed in the report. A report summary object stores all information about summary of report to be displayed, including the name displayed on UI, the display order, corresponding group by and count of values, summary visibility (if the summary is visible to user).
- Returns
The summary of this ReportDefinition.
- Return type
- property system_tags¶
Gets the system_tags of this ReportDefinition. System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {“orcl-cloud”: {“free-tier-retained”: “true”}}
- Returns
The system_tags of this ReportDefinition.
- Return type
dict(str, dict(str, object))
- property time_created¶
Gets the time_created of this ReportDefinition. Specifies the date and time the report definition was created.
- Returns
The time_created of this ReportDefinition.
- Return type
datetime
- property time_updated¶
Gets the time_updated of this ReportDefinition. The date and time the report definition was updated.
- Returns
The time_updated of this ReportDefinition.
- Return type
datetime