ProtectedDatabase

class oci.recovery.models.ProtectedDatabase(**kwargs)

Bases: object

A protected database is an Oracle Cloud Database whose backups are managed by Oracle Database Autonomous Recovery Service. Each protected database requires a recovery service subnet and a protection policy to use Recovery Service as the backup destination for centralized backup and recovery

Attributes

DATABASE_SIZE_AUTO A constant which can be used with the database_size property of a ProtectedDatabase.
DATABASE_SIZE_L A constant which can be used with the database_size property of a ProtectedDatabase.
DATABASE_SIZE_M A constant which can be used with the database_size property of a ProtectedDatabase.
DATABASE_SIZE_S A constant which can be used with the database_size property of a ProtectedDatabase.
DATABASE_SIZE_XL A constant which can be used with the database_size property of a ProtectedDatabase.
DATABASE_SIZE_XS A constant which can be used with the database_size property of a ProtectedDatabase.
DATABASE_SIZE_XXL A constant which can be used with the database_size property of a ProtectedDatabase.
HEALTH_ALERT A constant which can be used with the health property of a ProtectedDatabase.
HEALTH_PROTECTED A constant which can be used with the health property of a ProtectedDatabase.
HEALTH_WARNING A constant which can be used with the health property of a ProtectedDatabase.
LIFECYCLE_STATE_ACTIVE A constant which can be used with the lifecycle_state property of a ProtectedDatabase.
LIFECYCLE_STATE_CREATING A constant which can be used with the lifecycle_state property of a ProtectedDatabase.
LIFECYCLE_STATE_DELETED A constant which can be used with the lifecycle_state property of a ProtectedDatabase.
LIFECYCLE_STATE_DELETE_SCHEDULED A constant which can be used with the lifecycle_state property of a ProtectedDatabase.
LIFECYCLE_STATE_DELETING A constant which can be used with the lifecycle_state property of a ProtectedDatabase.
LIFECYCLE_STATE_FAILED A constant which can be used with the lifecycle_state property of a ProtectedDatabase.
LIFECYCLE_STATE_UPDATING A constant which can be used with the lifecycle_state property of a ProtectedDatabase.
change_rate Gets the change_rate of this ProtectedDatabase.
compartment_id [Required] Gets the compartment_id of this ProtectedDatabase.
compression_ratio Gets the compression_ratio of this ProtectedDatabase.
database_id Gets the database_id of this ProtectedDatabase.
database_size [Required] Gets the database_size of this ProtectedDatabase.
database_size_in_gbs Gets the database_size_in_gbs of this ProtectedDatabase.
db_unique_name [Required] Gets the db_unique_name of this ProtectedDatabase.
defined_tags Gets the defined_tags of this ProtectedDatabase.
display_name Gets the display_name of this ProtectedDatabase.
freeform_tags Gets the freeform_tags of this ProtectedDatabase.
health Gets the health of this ProtectedDatabase.
health_details Gets the health_details of this ProtectedDatabase.
id [Required] Gets the id of this ProtectedDatabase.
is_read_only_resource Gets the is_read_only_resource of this ProtectedDatabase.
is_redo_logs_shipped Gets the is_redo_logs_shipped of this ProtectedDatabase.
lifecycle_details Gets the lifecycle_details of this ProtectedDatabase.
lifecycle_state Gets the lifecycle_state of this ProtectedDatabase.
metrics Gets the metrics of this ProtectedDatabase.
policy_locked_date_time Gets the policy_locked_date_time of this ProtectedDatabase.
protection_policy_id [Required] Gets the protection_policy_id of this ProtectedDatabase.
recovery_service_subnets [Required] Gets the recovery_service_subnets of this ProtectedDatabase.
subscription_id Gets the subscription_id of this ProtectedDatabase.
system_tags Gets the system_tags of this ProtectedDatabase.
time_created Gets the time_created of this ProtectedDatabase.
time_updated Gets the time_updated of this ProtectedDatabase.
vpc_user_name [Required] Gets the vpc_user_name of this ProtectedDatabase.

Methods

__init__(**kwargs) Initializes a new ProtectedDatabase object with values from keyword arguments.
DATABASE_SIZE_AUTO = 'AUTO'

A constant which can be used with the database_size property of a ProtectedDatabase. This constant has a value of “AUTO”

DATABASE_SIZE_L = 'L'

A constant which can be used with the database_size property of a ProtectedDatabase. This constant has a value of “L”

DATABASE_SIZE_M = 'M'

A constant which can be used with the database_size property of a ProtectedDatabase. This constant has a value of “M”

DATABASE_SIZE_S = 'S'

A constant which can be used with the database_size property of a ProtectedDatabase. This constant has a value of “S”

DATABASE_SIZE_XL = 'XL'

A constant which can be used with the database_size property of a ProtectedDatabase. This constant has a value of “XL”

DATABASE_SIZE_XS = 'XS'

A constant which can be used with the database_size property of a ProtectedDatabase. This constant has a value of “XS”

DATABASE_SIZE_XXL = 'XXL'

A constant which can be used with the database_size property of a ProtectedDatabase. This constant has a value of “XXL”

HEALTH_ALERT = 'ALERT'

A constant which can be used with the health property of a ProtectedDatabase. This constant has a value of “ALERT”

HEALTH_PROTECTED = 'PROTECTED'

A constant which can be used with the health property of a ProtectedDatabase. This constant has a value of “PROTECTED”

HEALTH_WARNING = 'WARNING'

A constant which can be used with the health property of a ProtectedDatabase. This constant has a value of “WARNING”

LIFECYCLE_STATE_ACTIVE = 'ACTIVE'

A constant which can be used with the lifecycle_state property of a ProtectedDatabase. This constant has a value of “ACTIVE”

LIFECYCLE_STATE_CREATING = 'CREATING'

A constant which can be used with the lifecycle_state property of a ProtectedDatabase. This constant has a value of “CREATING”

LIFECYCLE_STATE_DELETED = 'DELETED'

A constant which can be used with the lifecycle_state property of a ProtectedDatabase. This constant has a value of “DELETED”

LIFECYCLE_STATE_DELETE_SCHEDULED = 'DELETE_SCHEDULED'

A constant which can be used with the lifecycle_state property of a ProtectedDatabase. This constant has a value of “DELETE_SCHEDULED”

LIFECYCLE_STATE_DELETING = 'DELETING'

A constant which can be used with the lifecycle_state property of a ProtectedDatabase. This constant has a value of “DELETING”

LIFECYCLE_STATE_FAILED = 'FAILED'

A constant which can be used with the lifecycle_state property of a ProtectedDatabase. This constant has a value of “FAILED”

LIFECYCLE_STATE_UPDATING = 'UPDATING'

A constant which can be used with the lifecycle_state property of a ProtectedDatabase. This constant has a value of “UPDATING”

__init__(**kwargs)

Initializes a new ProtectedDatabase 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 ProtectedDatabase.
  • display_name (str) – The value to assign to the display_name property of this ProtectedDatabase.
  • compartment_id (str) – The value to assign to the compartment_id property of this ProtectedDatabase.
  • db_unique_name (str) – The value to assign to the db_unique_name property of this ProtectedDatabase.
  • vpc_user_name (str) – The value to assign to the vpc_user_name property of this ProtectedDatabase.
  • database_size (str) – The value to assign to the database_size property of this ProtectedDatabase. Allowed values for this property are: “XS”, “S”, “M”, “L”, “XL”, “XXL”, “AUTO”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
  • protection_policy_id (str) – The value to assign to the protection_policy_id property of this ProtectedDatabase.
  • policy_locked_date_time (str) – The value to assign to the policy_locked_date_time property of this ProtectedDatabase.
  • recovery_service_subnets (list[oci.recovery.models.RecoveryServiceSubnetDetails]) – The value to assign to the recovery_service_subnets property of this ProtectedDatabase.
  • database_id (str) – The value to assign to the database_id property of this ProtectedDatabase.
  • database_size_in_gbs (int) – The value to assign to the database_size_in_gbs property of this ProtectedDatabase.
  • change_rate (float) – The value to assign to the change_rate property of this ProtectedDatabase.
  • compression_ratio (float) – The value to assign to the compression_ratio property of this ProtectedDatabase.
  • is_redo_logs_shipped (bool) – The value to assign to the is_redo_logs_shipped property of this ProtectedDatabase.
  • time_created (datetime) – The value to assign to the time_created property of this ProtectedDatabase.
  • time_updated (datetime) – The value to assign to the time_updated property of this ProtectedDatabase.
  • lifecycle_state (str) – The value to assign to the lifecycle_state property of this ProtectedDatabase. Allowed values for this property are: “CREATING”, “UPDATING”, “ACTIVE”, “DELETE_SCHEDULED”, “DELETING”, “DELETED”, “FAILED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
  • health (str) – The value to assign to the health property of this ProtectedDatabase. Allowed values for this property are: “PROTECTED”, “WARNING”, “ALERT”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
  • is_read_only_resource (bool) – The value to assign to the is_read_only_resource property of this ProtectedDatabase.
  • lifecycle_details (str) – The value to assign to the lifecycle_details property of this ProtectedDatabase.
  • health_details (str) – The value to assign to the health_details property of this ProtectedDatabase.
  • metrics (oci.recovery.models.Metrics) – The value to assign to the metrics property of this ProtectedDatabase.
  • subscription_id (str) – The value to assign to the subscription_id property of this ProtectedDatabase.
  • freeform_tags (dict(str, str)) – The value to assign to the freeform_tags property of this ProtectedDatabase.
  • defined_tags (dict(str, dict(str, object))) – The value to assign to the defined_tags property of this ProtectedDatabase.
  • system_tags (dict(str, dict(str, object))) – The value to assign to the system_tags property of this ProtectedDatabase.
change_rate

Gets the change_rate of this ProtectedDatabase. The percentage of data changes that exist in the database between successive incremental backups.

Returns:The change_rate of this ProtectedDatabase.
Return type:float
compartment_id

[Required] Gets the compartment_id of this ProtectedDatabase. The OCID of the compartment that contains the protected database.

Returns:The compartment_id of this ProtectedDatabase.
Return type:str
compression_ratio

Gets the compression_ratio of this ProtectedDatabase. The compression ratio of the protected database. The compression ratio represents the ratio of compressed block size to expanded block size.

Returns:The compression_ratio of this ProtectedDatabase.
Return type:float
database_id

Gets the database_id of this ProtectedDatabase. The OCID of the protected database.

Returns:The database_id of this ProtectedDatabase.
Return type:str
database_size

[Required] Gets the database_size of this ProtectedDatabase. The size of the protected database. XS - Less than 5GB, S - 5GB to 50GB, M - 50GB to 500GB, L - 500GB to 1TB, XL - 1TB to 5TB, XXL - Greater than 5TB.

Allowed values for this property are: “XS”, “S”, “M”, “L”, “XL”, “XXL”, “AUTO”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns:The database_size of this ProtectedDatabase.
Return type:str
database_size_in_gbs

Gets the database_size_in_gbs of this ProtectedDatabase. The size of the database in GBs, in gigabytes.

Returns:The database_size_in_gbs of this ProtectedDatabase.
Return type:int
db_unique_name

[Required] Gets the db_unique_name of this ProtectedDatabase. The dbUniqueName for the protected database in Recovery Service. You cannot change the unique name.

Returns:The db_unique_name of this ProtectedDatabase.
Return type:str
defined_tags

Gets the defined_tags of this ProtectedDatabase. Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {“foo-namespace”: {“bar-key”: “value”}}. For more information, see Resource Tags

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

Gets the display_name of this ProtectedDatabase. The protected database name. You can change the displayName. Avoid entering confidential information.

Returns:The display_name of this ProtectedDatabase.
Return type:str
freeform_tags

Gets the freeform_tags of this ProtectedDatabase. 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 ProtectedDatabase.
Return type:dict(str, str)
health

Gets the health of this ProtectedDatabase. Indicates the protection status of the database.

A ‘PROTECTED’ status indicates that Recovery Service can ensure database recovery to any point in time within the entire recovery window. The potential data loss exposure since the last backup is:
  • Less than 10 seconds, if Real-time data protection is enabled
  • Less than 70 minutes if Real-time data protection is disabled
A ‘WARNING’ status indicates that Recovery Service can ensure database recovery within the current recovery window - 1 day. The potential data loss exposure since the last backup is:
  • Greater than 10 seconds, if Real-time data protection is enabled
  • Greater than 60 minutes, if if Real-time data protection is disabled

An ‘ALERT’ status indicates that Recovery Service cannot recover the database within the current recovery window.

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

Returns:The health of this ProtectedDatabase.
Return type:str
health_details

Gets the health_details of this ProtectedDatabase. A message describing the current health of the protected database.

Returns:The health_details of this ProtectedDatabase.
Return type:str
id

[Required] Gets the id of this ProtectedDatabase. The OCID of the protected database.

Returns:The id of this ProtectedDatabase.
Return type:str
is_read_only_resource

Gets the is_read_only_resource of this ProtectedDatabase. Indicates whether the protected database is created by Recovery Service or created manually. Set to <b>TRUE</b> for a service-defined protected database. When you enable the OCI-managed automatic backups option for a database and set Recovery Service as the backup destination, then Recovery Service creates the associated protected database resource. Set to <b>FALSE</b> for a user-defined protected database.

Returns:The is_read_only_resource of this ProtectedDatabase.
Return type:bool
is_redo_logs_shipped

Gets the is_redo_logs_shipped of this ProtectedDatabase. The value TRUE indicates that the protected database is configured to use Real-time data protection, and redo-data is sent from the protected database to Recovery Service. Real-time data protection substantially reduces the window of potential data loss that exists between successive archived redo log backups. For this to be effective, additional configuration is needed on client side.

Returns:The is_redo_logs_shipped of this ProtectedDatabase.
Return type:bool
lifecycle_details

Gets the lifecycle_details of this ProtectedDatabase. Detailed description about the current lifecycle state of the protected database. For example, it can be used to provide actionable information for a resource in a Failed state.

Returns:The lifecycle_details of this ProtectedDatabase.
Return type:str
lifecycle_state

Gets the lifecycle_state of this ProtectedDatabase. The current state of the Protected Database.

Allowed values for this property are: “CREATING”, “UPDATING”, “ACTIVE”, “DELETE_SCHEDULED”, “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 ProtectedDatabase.
Return type:str
metrics

Gets the metrics of this ProtectedDatabase.

Returns:The metrics of this ProtectedDatabase.
Return type:oci.recovery.models.Metrics
policy_locked_date_time

Gets the policy_locked_date_time of this ProtectedDatabase. An RFC3339 formatted datetime string that specifies the exact date and time for the retention lock to take effect and permanently lock the retention period defined in the policy.

The retention lock feature controls whether Recovery Service strictly preserves backups for the duration defined in a policy. Retention lock is useful to enforce recovery window compliance and to prevent unintentional modifications to protected database backups. Recovery Service enforces a 14-day delay before the retention lock set for a policy can take effect.

Returns:The policy_locked_date_time of this ProtectedDatabase.
Return type:str
protection_policy_id

[Required] Gets the protection_policy_id of this ProtectedDatabase. The OCID of the protection policy associated with the protected database.

Returns:The protection_policy_id of this ProtectedDatabase.
Return type:str
recovery_service_subnets

[Required] Gets the recovery_service_subnets of this ProtectedDatabase. List of recovery service subnet resources associated with the protected database.

Returns:The recovery_service_subnets of this ProtectedDatabase.
Return type:list[oci.recovery.models.RecoveryServiceSubnetDetails]
subscription_id

Gets the subscription_id of this ProtectedDatabase. The OCID of the cloud service subscription to which the protected database is linked.

Returns:The subscription_id of this ProtectedDatabase.
Return type:str
system_tags

Gets the system_tags of this ProtectedDatabase. Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {“orcl-cloud”: {“free-tier-retained”: “true”}}. For more information, see Resource Tags

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

Gets the time_created of this ProtectedDatabase. An RFC3339 formatted datetime string that indicates the created time for a protected database. For example: ‘2020-05-22T21:10:29.600Z’

Returns:The time_created of this ProtectedDatabase.
Return type:datetime
time_updated

Gets the time_updated of this ProtectedDatabase. An RFC3339 formatted datetime string that indicates the last updated time for a protected database. For example: ‘2020-05-22T21:10:29.600Z’

Returns:The time_updated of this ProtectedDatabase.
Return type:datetime
vpc_user_name

[Required] Gets the vpc_user_name of this ProtectedDatabase. The virtual private catalog (VPC) user credentials that authenticates the protected database to access Recovery Service.

Returns:The vpc_user_name of this ProtectedDatabase.
Return type:str