update_autonomous_database ¶

def update_autonomous_database(
    self,
    autonomous_database_id: "capo_odb.types.resource_id_or_arn.ResourceIdOrArn",
    *,
    config_overrides: Optional[odbClientConfig] = None,
    admin_password: Optional[
        "capo_odb.types.sensitive_string.SensitiveString"
    ] = None,
    compute_count: Optional[float] = None,
    cpu_core_count: Optional[int] = None,
    data_storage_size_in_t_bs: Optional[int] = None,
    data_storage_size_in_g_bs: Optional[int] = None,
    display_name: Optional[
        "capo_odb.types.resource_display_name.ResourceDisplayName"
    ] = None,
    db_name: Optional[str] = None,
    db_version: Optional[str] = None,
    db_workload: Optional["capo_odb.types.db_workload.DbWorkload"] = None,
    db_tools_details: Optional[
        "capo_odb.types.database_tool_list.DatabaseToolList"
    ] = None,
    database_edition: Optional[
        "capo_odb.types.database_edition.DatabaseEdition"
    ] = None,
    license_model: Optional["capo_odb.types.license_model.LicenseModel"] = None,
    is_auto_scaling_enabled: Optional[bool] = None,
    is_auto_scaling_for_storage_enabled: Optional[bool] = None,
    is_backup_retention_locked: Optional[bool] = None,
    is_local_data_guard_enabled: Optional[bool] = None,
    is_mtls_connection_required: Optional[bool] = None,
    is_refreshable_clone: Optional[bool] = None,
    is_disconnect_peer: Optional[bool] = None,
    backup_retention_period_in_days: Optional[int] = None,
    byol_compute_count_limit: Optional[float] = None,
    local_adg_auto_failover_max_data_loss_limit: Optional[int] = None,
    autonomous_maintenance_schedule_type: Optional[
        "capo_odb.types.autonomous_maintenance_schedule_type.AutonomousMaintenanceScheduleType"
    ] = None,
    customer_contacts_to_send_to_oci: Optional[
        "capo_odb.types.customer_contacts.CustomerContacts"
    ] = None,
    scheduled_operations: Optional[
        "capo_odb.types.scheduled_operation_details_list.ScheduledOperationDetailsList"
    ] = None,
    long_term_backup_schedule: Optional[
        "capo_odb.types.long_term_backup_schedule.LongTermBackupSchedule"
    ] = None,
    open_mode: Optional["capo_odb.types.open_mode.OpenMode"] = None,
    permission_level: Optional[
        "capo_odb.types.permission_level.PermissionLevel"
    ] = None,
    refreshable_mode: Optional[
        "capo_odb.types.refreshable_mode.RefreshableMode"
    ] = None,
    private_endpoint_ip: Optional[str] = None,
    private_endpoint_label: Optional[str] = None,
    peer_db_id: Optional[
        "capo_odb.types.resource_id_or_arn.ResourceIdOrArn"
    ] = None,
    resource_pool_leader_id: Optional[
        "capo_odb.types.resource_id_or_arn.ResourceIdOrArn"
    ] = None,
    resource_pool_summary: Optional[
        "capo_odb.types.resource_pool_summary.ResourcePoolSummary"
    ] = None,
    standby_allowlisted_ips_source: Optional[
        "capo_odb.types.standby_allowlisted_ips_source.StandbyAllowlistedIpsSource"
    ] = None,
    standby_allowlisted_ips: Optional[
        "capo_odb.types.string_list.StringList"
    ] = None,
    allowlisted_ips: Optional["capo_odb.types.string_list.StringList"] = None,
    auto_refresh_frequency_in_seconds: Optional[int] = None,
    auto_refresh_point_lag_in_seconds: Optional[int] = None,
    time_of_auto_refresh_start: Optional[datetime.datetime] = None,
    encryption_key_provider: Optional[
        "capo_odb.types.encryption_key_provider_input.EncryptionKeyProviderInput"
    ] = None,
    encryption_key_configuration: Optional[
        "capo_odb.types.encryption_key_configuration_input.EncryptionKeyConfigurationInput"
    ] = None,
    admin_password_source: Optional[
        "capo_odb.types.admin_password_source.AdminPasswordSource"
    ] = None,
    admin_password_source_configuration: Optional[
        "capo_odb.types.admin_password_source_configuration_input.AdminPasswordSourceConfigurationInput"
    ] = None,
) -> "capo_odb.types.update_autonomous_database_output.UpdateAutonomousDatabaseOutput":
    """<p>Updates the properties of an Autonomous Database.</p>

    Args:
        autonomous_database_id: <p>The unique identifier of the Autonomous Database to update.</p>
        admin_password: <p>The new password for the <code>ADMIN</code> user of the Autonomous Database.</p>
        compute_count: <p>The compute capacity, in number of ECPUs or OCPUs, to assign to the Autonomous Database.</p>
        cpu_core_count: <p>The number of CPU cores to allocate to the Autonomous Database.</p>
        data_storage_size_in_t_bs: <p>The size, in terabytes (TB), of the data volume to allocate for the Autonomous Database.</p>
        data_storage_size_in_g_bs: <p>The size, in gigabytes (GB), of the data volume to allocate for the Autonomous Database.</p>
        display_name: <p>The new user-friendly name for the Autonomous Database.</p>
        db_name: <p>The new name of the Autonomous Database.</p>
        db_version: <p>The Oracle Database software version to use for the Autonomous Database.</p>
        db_workload: <p>The intended use of the Autonomous Database, such as transaction processing, data warehouse, JSON database, or APEX.</p>
        db_tools_details: <p>The list of database management tools to enable for the Autonomous Database.</p>
        database_edition: <p>The Oracle Database edition to apply to the Autonomous Database.</p>
        license_model: <p>The Oracle license model to apply to the Autonomous Database.</p>
        is_auto_scaling_enabled: <p>Specifies whether to enable automatic scaling of the compute resources for the Autonomous Database.</p>
        is_auto_scaling_for_storage_enabled: <p>Specifies whether to enable automatic scaling of the storage for the Autonomous Database.</p>
        is_backup_retention_locked: <p>Specifies whether to lock the backup retention period of the Autonomous Database to prevent it from being shortened.</p>
        is_local_data_guard_enabled: <p>Specifies whether to enable local Oracle Data Guard for the Autonomous Database.</p>
        is_mtls_connection_required: <p>Specifies whether mutual TLS (mTLS) authentication is required to connect to the Autonomous Database.</p>
        is_refreshable_clone: <p>Specifies whether the Autonomous Database is a refreshable clone.</p>
        is_disconnect_peer: <p>Specifies whether to disconnect the Autonomous Database from its peer database.</p>
        backup_retention_period_in_days: <p>The retention period, in days, for automatic backups of the Autonomous Database.</p>
        byol_compute_count_limit: <p>The maximum number of compute resources that you can allocate to the Autonomous Database under the bring-your-own-license (BYOL) model.</p>
        local_adg_auto_failover_max_data_loss_limit: <p>The maximum data loss limit, in seconds, for automatic failover to the local Oracle Data Guard standby database.</p>
        autonomous_maintenance_schedule_type: <p>The maintenance schedule type for the Autonomous Database.</p>
        customer_contacts_to_send_to_oci: <p>The list of customer contacts to receive operational notifications from OCI for the Autonomous Database.</p>
        scheduled_operations: <p>The list of scheduled start and stop times for the Autonomous Database.</p>
        long_term_backup_schedule: <p>The long-term backup schedule for the Autonomous Database.</p>
        open_mode: <p>The mode in which to open the Autonomous Database, either read-only or read/write.</p>
        permission_level: <p>The permission level of the Autonomous Database.</p>
        refreshable_mode: <p>The refresh mode of the refreshable clone Autonomous Database.</p>
        private_endpoint_ip: <p>The private endpoint IP address for the Autonomous Database.</p>
        private_endpoint_label: <p>The private endpoint label for the Autonomous Database.</p>
        peer_db_id: <p>The unique identifier of the peer Autonomous Database.</p>
        resource_pool_leader_id: <p>The unique identifier of the resource pool leader Autonomous Database.</p>
        resource_pool_summary: <p>The configuration of the resource pool for the Autonomous Database.</p>
        standby_allowlisted_ips_source: <p>The source of the allowlisted IP addresses for the standby Autonomous Database.</p>
        standby_allowlisted_ips: <p>The list of IP addresses that are allowed to access the standby Autonomous Database.</p>
        allowlisted_ips: <p>The list of IP addresses that are allowed to access the Autonomous Database.</p>
        auto_refresh_frequency_in_seconds: <p>The frequency, in seconds, at which the refreshable clone Autonomous Database is automatically refreshed.</p>
        auto_refresh_point_lag_in_seconds: <p>The time lag, in seconds, between the refreshable clone and its source Autonomous Database.</p>
        time_of_auto_refresh_start: <p>The date and time at which the automatic refresh of the refreshable clone Autonomous Database starts.</p>
        encryption_key_provider: <p>The provider of the encryption key to use for the Autonomous Database.</p>
        encryption_key_configuration: <p>The configuration of the encryption key to use for the Autonomous Database.</p>
        admin_password_source: <p>The source of the admin password for the Autonomous Database. When set to <code>CUSTOMER_MANAGED_AWS_SECRET</code>, the admin password is retrieved from an Amazon Web Services Secrets Manager secret.</p>
        admin_password_source_configuration: <p>The configuration of the admin password source for the Autonomous Database.</p>

    Raises:
        capo_odb.errors.access_denied_exception.AccessDeniedException: <p>You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.</p>
        capo_odb.errors.conflict_exception.ConflictException: <p>Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.</p>
        capo_odb.errors.internal_server_exception.InternalServerException: <p>Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.</p>
        capo_odb.errors.resource_not_found_exception.ResourceNotFoundException: <p>The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.</p>
        capo_odb.errors.throttling_exception.ThrottlingException: <p>The request was denied due to request throttling.</p>
        capo_odb.errors.validation_exception.ValidationException: <p>The request has failed validation because it is missing required fields or has invalid inputs.</p>
        capo_odb.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_odb.types.update_autonomous_database_input.UpdateAutonomousDatabaseInput]",
    ) -> OperationResponse[
        "capo_odb.types.update_autonomous_database_output.UpdateAutonomousDatabaseOutput"
    ]:
        import capo_odb._operations.odb.update_autonomous_database

        output, http_response = (
            capo_odb._operations.odb.update_autonomous_database.update_autonomous_database(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    def _redact_input(
        input_: "capo_odb.types.update_autonomous_database_input.UpdateAutonomousDatabaseInput",
    ) -> dict[str, Any]:
        import capo_odb.types.update_autonomous_database_input

        return capo_odb.types.update_autonomous_database_input.redact_sensitive(
            input_
        )

    interceptors_, options_ = self.operation_options(
        config_overrides,
        OperationLogging("UpdateAutonomousDatabase", redact_input=_redact_input),
    )
    input_: capo_odb.types.update_autonomous_database_input.UpdateAutonomousDatabaseInput = {
        "autonomous_database_id": autonomous_database_id
    }
    if admin_password is not None:
        input_["admin_password"] = admin_password
    if compute_count is not None:
        input_["compute_count"] = compute_count
    if cpu_core_count is not None:
        input_["cpu_core_count"] = cpu_core_count
    if data_storage_size_in_t_bs is not None:
        input_["data_storage_size_in_t_bs"] = data_storage_size_in_t_bs
    if data_storage_size_in_g_bs is not None:
        input_["data_storage_size_in_g_bs"] = data_storage_size_in_g_bs
    if display_name is not None:
        input_["display_name"] = display_name
    if db_name is not None:
        input_["db_name"] = db_name
    if db_version is not None:
        input_["db_version"] = db_version
    if db_workload is not None:
        input_["db_workload"] = db_workload
    if db_tools_details is not None:
        input_["db_tools_details"] = db_tools_details
    if database_edition is not None:
        input_["database_edition"] = database_edition
    if license_model is not None:
        input_["license_model"] = license_model
    if is_auto_scaling_enabled is not None:
        input_["is_auto_scaling_enabled"] = is_auto_scaling_enabled
    if is_auto_scaling_for_storage_enabled is not None:
        input_["is_auto_scaling_for_storage_enabled"] = (
            is_auto_scaling_for_storage_enabled
        )
    if is_backup_retention_locked is not None:
        input_["is_backup_retention_locked"] = is_backup_retention_locked
    if is_local_data_guard_enabled is not None:
        input_["is_local_data_guard_enabled"] = is_local_data_guard_enabled
    if is_mtls_connection_required is not None:
        input_["is_mtls_connection_required"] = is_mtls_connection_required
    if is_refreshable_clone is not None:
        input_["is_refreshable_clone"] = is_refreshable_clone
    if is_disconnect_peer is not None:
        input_["is_disconnect_peer"] = is_disconnect_peer
    if backup_retention_period_in_days is not None:
        input_["backup_retention_period_in_days"] = backup_retention_period_in_days
    if byol_compute_count_limit is not None:
        input_["byol_compute_count_limit"] = byol_compute_count_limit
    if local_adg_auto_failover_max_data_loss_limit is not None:
        input_["local_adg_auto_failover_max_data_loss_limit"] = (
            local_adg_auto_failover_max_data_loss_limit
        )
    if autonomous_maintenance_schedule_type is not None:
        input_["autonomous_maintenance_schedule_type"] = (
            autonomous_maintenance_schedule_type
        )
    if customer_contacts_to_send_to_oci is not None:
        input_["customer_contacts_to_send_to_oci"] = (
            customer_contacts_to_send_to_oci
        )
    if scheduled_operations is not None:
        input_["scheduled_operations"] = scheduled_operations
    if long_term_backup_schedule is not None:
        input_["long_term_backup_schedule"] = long_term_backup_schedule
    if open_mode is not None:
        input_["open_mode"] = open_mode
    if permission_level is not None:
        input_["permission_level"] = permission_level
    if refreshable_mode is not None:
        input_["refreshable_mode"] = refreshable_mode
    if private_endpoint_ip is not None:
        input_["private_endpoint_ip"] = private_endpoint_ip
    if private_endpoint_label is not None:
        input_["private_endpoint_label"] = private_endpoint_label
    if peer_db_id is not None:
        input_["peer_db_id"] = peer_db_id
    if resource_pool_leader_id is not None:
        input_["resource_pool_leader_id"] = resource_pool_leader_id
    if resource_pool_summary is not None:
        input_["resource_pool_summary"] = resource_pool_summary
    if standby_allowlisted_ips_source is not None:
        input_["standby_allowlisted_ips_source"] = standby_allowlisted_ips_source
    if standby_allowlisted_ips is not None:
        input_["standby_allowlisted_ips"] = standby_allowlisted_ips
    if allowlisted_ips is not None:
        input_["allowlisted_ips"] = allowlisted_ips
    if auto_refresh_frequency_in_seconds is not None:
        input_["auto_refresh_frequency_in_seconds"] = (
            auto_refresh_frequency_in_seconds
        )
    if auto_refresh_point_lag_in_seconds is not None:
        input_["auto_refresh_point_lag_in_seconds"] = (
            auto_refresh_point_lag_in_seconds
        )
    if time_of_auto_refresh_start is not None:
        input_["time_of_auto_refresh_start"] = time_of_auto_refresh_start
    if encryption_key_provider is not None:
        input_["encryption_key_provider"] = encryption_key_provider
    if encryption_key_configuration is not None:
        input_["encryption_key_configuration"] = encryption_key_configuration
    if admin_password_source is not None:
        input_["admin_password_source"] = admin_password_source
    if admin_password_source_configuration is not None:
        input_["admin_password_source_configuration"] = (
            admin_password_source_configuration
        )

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output