Releasing version 2.48.0

oracle · Oct 19, 2021 · be3b6cb · be3b6cb
2 parents ddb0725 + 82fcff6
commit be3b6cb
Show file tree

Hide file tree

Showing 267 changed files with 36,345 additions and 15,668 deletions.
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -3,6 +3,24 @@ Change Log
 All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`_.
+====================
+2.48.0 - 2021-10-19
+====================
+
+Added
+-----
+* Support for creating database systems from backups with database software images in the Database service
+* Support for optionally providing a SID prefix during Exadata database creation in the Database service
+* Support for node subsetting on VM clusters in the Database service
+* Support for non-CDB to PDB conversion in the Database service
+* Support for default homepages, unprocessed data buckets, and parsing geostats in the Logging Analytics service
+* Support for Circuit Breakers. Please refer `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/circuit_breakers.html>`__ to learn more.
+* Support for enabling/disabling Retries globally for operations using Default Retry Strategy. Please refer `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html#overriding-the-retry-behavior-at-global-sdk-level>`__ for more info.
+
+Breaking
+--------
+* Default Retry strategy will now retry operations for max 8 attempts and have a timeout of 600 seconds before failing. The strategy will now use `De-Correlated jitter <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html#de-correlated-jitter>`__ as the default delay strategy.
+
 ====================
 2.47.1 - 2021-10-12
 ====================

diff --git a/THIRD_PARTY_LICENSES.txt b/THIRD_PARTY_LICENSES.txt
@@ -111,7 +111,11 @@ urllib3
 * Source code: https://github.com/urllib3/urllib3
 * Project home: https://urllib3.readthedocs.io
 
-
+circuitbreaker
+* Copyright (c) 2016-2020, Fabian Fuelling opensource@fabfuel.de. All rights reserved.
+* License: MIT License
+* Source code: https://github.com/fabfuel/circuitbreaker
+* Project home: https://pypi.org/project/circuitbreaker
 
 =============================== Licenses ===============================
 
@@ -128,6 +132,8 @@ Copyright (c) 2014 Adam Knight 2012 Adam T. Lindsay (original author)
 
 Copyright (c) 2008-2020 Andrey Petrov and contributors (see CONTRIBUTORS.txt)
 
+Copyright (c) 2016-2020, Fabian Fuelling opensource@fabfuel.de. All rights reserved.
+
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to
 deal in the Software without restriction, including without limitation the

diff --git a/docs/api/circuit_breaker.rst b/docs/api/circuit_breaker.rst
@@ -0,0 +1,18 @@
+=================
+ Circuit Breakers
+=================
+
+Default Circuit Breaker Strategy
+--------------------------------
+See :doc:`here </sdk_behaviors/circuit_breakers>` for information on the settings used for the circuit breaker strategy.
+
+.. autodata:: oci.circuit_breaker.DEFAULT_CIRCUIT_BREAKER_STRATEGY
+
+Circuit Breakers
+----------------
+
+.. automodule:: oci.circuit_breaker
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/docs/api/database.rst b/docs/api/database.rst
@@ -19,6 +19,7 @@ Database
     :template: autosummary/model_class.rst
 
     oci.database.models.ActivateExadataInfrastructureDetails
+    oci.database.models.AddVirtualMachineToVmClusterDetails
     oci.database.models.AssociatedDatabaseDetails
     oci.database.models.AutomatedMountDetails
     oci.database.models.AutonomousContainerDatabase
@@ -72,6 +73,8 @@ Database
     oci.database.models.ConfigureAutonomousDatabaseVaultKeyDetails
     oci.database.models.ConsoleConnection
     oci.database.models.ConsoleConnectionSummary
+    oci.database.models.ConvertToPdbDetails
+    oci.database.models.ConvertToPdbTargetBase
     oci.database.models.CreateAutonomousContainerDatabaseDetails
     oci.database.models.CreateAutonomousDatabaseBackupDetails
     oci.database.models.CreateAutonomousDatabaseBase
@@ -152,6 +155,9 @@ Database
     oci.database.models.DbIormConfigUpdateDetail
     oci.database.models.DbNode
     oci.database.models.DbNodeSummary
+    oci.database.models.DbServer
+    oci.database.models.DbServerDetails
+    oci.database.models.DbServerSummary
     oci.database.models.DbSystem
     oci.database.models.DbSystemOptions
     oci.database.models.DbSystemShapeSummary
@@ -219,13 +225,17 @@ Database
     oci.database.models.PatchHistoryEntry
     oci.database.models.PatchHistoryEntrySummary
     oci.database.models.PatchSummary
+    oci.database.models.PdbConversionHistoryEntry
+    oci.database.models.PdbConversionHistoryEntrySummary
+    oci.database.models.PdbConversionToNewDatabaseDetails
     oci.database.models.PeerAutonomousContainerDatabaseBackupConfig
     oci.database.models.PluggableDatabase
     oci.database.models.PluggableDatabaseConnectionStrings
     oci.database.models.PluggableDatabaseSummary
     oci.database.models.RegisterAutonomousDatabaseDataSafeDetails
     oci.database.models.ReinstateDataGuardAssociationDetails
     oci.database.models.RemoteClonePluggableDatabaseDetails
+    oci.database.models.RemoveVirtualMachineFromVmClusterDetails
     oci.database.models.RestoreAutonomousDatabaseDetails
     oci.database.models.RestoreDatabaseDetails
     oci.database.models.ScanDetails

diff --git a/...api/database/models/oci.database.models.AddVirtualMachineToVmClusterDetails.rst b/...api/database/models/oci.database.models.AddVirtualMachineToVmClusterDetails.rst
@@ -0,0 +1,11 @@
+AddVirtualMachineToVmClusterDetails
+===================================
+
+.. currentmodule:: oci.database.models
+
+.. autoclass:: AddVirtualMachineToVmClusterDetails
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/docs/api/database/models/oci.database.models.ConvertToPdbDetails.rst b/docs/api/database/models/oci.database.models.ConvertToPdbDetails.rst
@@ -0,0 +1,11 @@
+ConvertToPdbDetails
+===================
+
+.. currentmodule:: oci.database.models
+
+.. autoclass:: ConvertToPdbDetails
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/docs/api/database/models/oci.database.models.ConvertToPdbTargetBase.rst b/docs/api/database/models/oci.database.models.ConvertToPdbTargetBase.rst
@@ -0,0 +1,11 @@
+ConvertToPdbTargetBase
+======================
+
+.. currentmodule:: oci.database.models
+
+.. autoclass:: ConvertToPdbTargetBase
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/docs/api/database/models/oci.database.models.DbServer.rst b/docs/api/database/models/oci.database.models.DbServer.rst
@@ -0,0 +1,11 @@
+DbServer
+========
+
+.. currentmodule:: oci.database.models
+
+.. autoclass:: DbServer
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/docs/api/database/models/oci.database.models.DbServerDetails.rst b/docs/api/database/models/oci.database.models.DbServerDetails.rst
@@ -0,0 +1,11 @@
+DbServerDetails
+===============
+
+.. currentmodule:: oci.database.models
+
+.. autoclass:: DbServerDetails
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/docs/api/database/models/oci.database.models.DbServerSummary.rst b/docs/api/database/models/oci.database.models.DbServerSummary.rst
@@ -0,0 +1,11 @@
+DbServerSummary
+===============
+
+.. currentmodule:: oci.database.models
+
+.. autoclass:: DbServerSummary
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/docs/api/database/models/oci.database.models.PdbConversionHistoryEntry.rst b/docs/api/database/models/oci.database.models.PdbConversionHistoryEntry.rst
@@ -0,0 +1,11 @@
+PdbConversionHistoryEntry
+=========================
+
+.. currentmodule:: oci.database.models
+
+.. autoclass:: PdbConversionHistoryEntry
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/docs/api/database/models/oci.database.models.PdbConversionHistoryEntrySummary.rst b/docs/api/database/models/oci.database.models.PdbConversionHistoryEntrySummary.rst
@@ -0,0 +1,11 @@
+PdbConversionHistoryEntrySummary
+================================
+
+.. currentmodule:: oci.database.models
+
+.. autoclass:: PdbConversionHistoryEntrySummary
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/docs/api/database/models/oci.database.models.PdbConversionToNewDatabaseDetails.rst b/docs/api/database/models/oci.database.models.PdbConversionToNewDatabaseDetails.rst
@@ -0,0 +1,11 @@
+PdbConversionToNewDatabaseDetails
+=================================
+
+.. currentmodule:: oci.database.models
+
+.. autoclass:: PdbConversionToNewDatabaseDetails
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/...atabase/models/oci.database.models.RemoveVirtualMachineFromVmClusterDetails.rst b/...atabase/models/oci.database.models.RemoveVirtualMachineFromVmClusterDetails.rst
@@ -0,0 +1,11 @@
+RemoveVirtualMachineFromVmClusterDetails
+========================================
+
+.. currentmodule:: oci.database.models
+
+.. autoclass:: RemoveVirtualMachineFromVmClusterDetails
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/docs/api/landing.rst b/docs/api/landing.rst
@@ -136,6 +136,7 @@ API Reference
 * :doc:`Pagination <pagination>`
 * :doc:`Request and Response <request_and_response>`
 * :doc:`Retry <retry>`
+* :doc:`Circuit Breaker <circuit_breaker>`
 * :doc:`Signing <signing>`
 * :doc:`Upload Manager <upload_manager>`
 * :doc:`Utilities <utilities>`
@@ -229,6 +230,7 @@ API Reference
     waf
     work_requests
     config
+    circuit_breaker
     exceptions
     pagination
     request_and_response

diff --git a/docs/api/log_analytics.rst b/docs/api/log_analytics.rst
@@ -111,6 +111,7 @@ Log Analytics
     oci.log_analytics.models.FilterOutput
     oci.log_analytics.models.FixedFrequencySchedule
     oci.log_analytics.models.FunctionField
+    oci.log_analytics.models.GeoStatsCommandDescriptor
     oci.log_analytics.models.HeadCommandDescriptor
     oci.log_analytics.models.HighlightCommandDescriptor
     oci.log_analytics.models.HighlightGroupsCommandDescriptor
@@ -188,6 +189,9 @@ Log Analytics
     oci.log_analytics.models.LogAnalyticsParserMetaPluginParameter
     oci.log_analytics.models.LogAnalyticsParserSummary
     oci.log_analytics.models.LogAnalyticsPatternFilter
+    oci.log_analytics.models.LogAnalyticsPreference
+    oci.log_analytics.models.LogAnalyticsPreferenceCollection
+    oci.log_analytics.models.LogAnalyticsPreferenceDetails
     oci.log_analytics.models.LogAnalyticsSource
     oci.log_analytics.models.LogAnalyticsSourceCollection
     oci.log_analytics.models.LogAnalyticsSourceDataFilter
@@ -278,6 +282,7 @@ Log Analytics
     oci.log_analytics.models.TopCommandDescriptor
     oci.log_analytics.models.TrendColumn
     oci.log_analytics.models.UiParserTestMetadata
+    oci.log_analytics.models.UnprocessedDataBucket
     oci.log_analytics.models.UpdateLogAnalyticsEmBridgeDetails
     oci.log_analytics.models.UpdateLogAnalyticsEntityDetails
     oci.log_analytics.models.UpdateLogAnalyticsEntityTypeDetails

diff --git a/...api/log_analytics/models/oci.log_analytics.models.GeoStatsCommandDescriptor.rst b/...api/log_analytics/models/oci.log_analytics.models.GeoStatsCommandDescriptor.rst
@@ -0,0 +1,11 @@
+GeoStatsCommandDescriptor
+=========================
+
+.. currentmodule:: oci.log_analytics.models
+
+.. autoclass:: GeoStatsCommandDescriptor
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/docs/api/log_analytics/models/oci.log_analytics.models.LogAnalyticsPreference.rst b/docs/api/log_analytics/models/oci.log_analytics.models.LogAnalyticsPreference.rst
@@ -0,0 +1,11 @@
+LogAnalyticsPreference
+======================
+
+.. currentmodule:: oci.log_analytics.models
+
+.. autoclass:: LogAnalyticsPreference
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/..._analytics/models/oci.log_analytics.models.LogAnalyticsPreferenceCollection.rst b/..._analytics/models/oci.log_analytics.models.LogAnalyticsPreferenceCollection.rst
@@ -0,0 +1,11 @@
+LogAnalyticsPreferenceCollection
+================================
+
+.. currentmodule:: oci.log_analytics.models
+
+.. autoclass:: LogAnalyticsPreferenceCollection
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/...log_analytics/models/oci.log_analytics.models.LogAnalyticsPreferenceDetails.rst b/...log_analytics/models/oci.log_analytics.models.LogAnalyticsPreferenceDetails.rst
@@ -0,0 +1,11 @@
+LogAnalyticsPreferenceDetails
+=============================
+
+.. currentmodule:: oci.log_analytics.models
+
+.. autoclass:: LogAnalyticsPreferenceDetails
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/docs/api/log_analytics/models/oci.log_analytics.models.UnprocessedDataBucket.rst b/docs/api/log_analytics/models/oci.log_analytics.models.UnprocessedDataBucket.rst
@@ -0,0 +1,11 @@
+UnprocessedDataBucket
+=====================
+
+.. currentmodule:: oci.log_analytics.models
+
+.. autoclass:: UnprocessedDataBucket
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:
diff --git a/docs/pagination.rst b/docs/pagination.rst
@@ -19,4 +19,5 @@ As a convenience over manually writing pagination code, you can make use of the
 * Eagerly load all results from a list call up to a given limit
 * Lazily load results (either all results, or up to a given limit) from a list call via a generator. These generators can yield either values/models or the raw response from calling the list operation
 
+The :py:mod:`~oci.pagination` module uses retry with the default retry configuration. For more information, check out the :doc:`Retries </sdk_behaviors/retries>` documentation.
 For an example on how to use these functions, please check `GitHub <https://github.com/oracle/oci-python-sdk/blob/master/examples/pagination.py>`_. More details about the API is `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/api/pagination.html>`_.