Skip to content

Commit 6caf26c

Browse files
bhagwatvyasbhagwatvyas
authored
Releasing version 2.38.3
Releasing version 2.38.3
2 parents 72e38ef + 3074cd2 commit 6caf26c

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+1822
-105
lines changed

‎CHANGELOG.rst‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,15 @@ Change Log
33
All notable changes to this project will be documented in this file.
44

55
The format is based on `Keep a Changelog <http://keepachangelog.com/>`_.
6+
====================
7+
2.38.3 - 2021-05-18
8+
====================
9+
10+
Added
11+
-----
12+
* Support for spark-submit compatible options in the Data Flow service
13+
* Support for Object Storage as a configuration source in the Resource Manager service
14+
615
====================
716
2.38.2 - 2021-05-11
817
====================

‎docs/api/ai_language.rst‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@ Ai Language
66
:nosignatures:
77
:template: autosummary/service_client.rst
88

9-
oci.ai_language.AiServiceLanguageClient
10-
oci.ai_language.AiServiceLanguageClientCompositeOperations
9+
oci.ai_language.AIServiceLanguageClient
10+
oci.ai_language.AIServiceLanguageClientCompositeOperations
1111

1212
--------
1313
Models

‎docs/api/resource_manager.rst‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,7 @@ Resource Manager
4141
oci.resource_manager.models.CreateImportTfStateJobOperationDetails
4242
oci.resource_manager.models.CreateJobDetails
4343
oci.resource_manager.models.CreateJobOperationDetails
44+
oci.resource_manager.models.CreateObjectStorageConfigSourceDetails
4445
oci.resource_manager.models.CreatePlanJobOperationDetails
4546
oci.resource_manager.models.CreateStackDetails
4647
oci.resource_manager.models.CreateStackTemplateConfigSourceDetails
@@ -65,6 +66,8 @@ Resource Manager
6566
oci.resource_manager.models.JobOperationDetailsSummary
6667
oci.resource_manager.models.JobSummary
6768
oci.resource_manager.models.LogEntry
69+
oci.resource_manager.models.ObjectStorageConfigSource
70+
oci.resource_manager.models.ObjectStorageConfigSourceRecord
6871
oci.resource_manager.models.PlanJobOperationDetails
6972
oci.resource_manager.models.PlanJobOperationDetailsSummary
7073
oci.resource_manager.models.ResourceDiscoveryServiceCollection
@@ -88,6 +91,7 @@ Resource Manager
8891
oci.resource_manager.models.UpdateGithubAccessTokenConfigurationSourceProviderDetails
8992
oci.resource_manager.models.UpdateGitlabAccessTokenConfigurationSourceProviderDetails
9093
oci.resource_manager.models.UpdateJobDetails
94+
oci.resource_manager.models.UpdateObjectStorageConfigSourceDetails
9195
oci.resource_manager.models.UpdateStackDetails
9296
oci.resource_manager.models.UpdateTemplateConfigSourceDetails
9397
oci.resource_manager.models.UpdateTemplateDetails

‎docs/api/resource_manager/models/oci.resource_manager.models.CreateObjectStorageConfigSourceDetails.rst‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
CreateObjectStorageConfigSourceDetails
2+
======================================
3+
4+
.. currentmodule:: oci.resource_manager.models
5+
6+
.. autoclass:: CreateObjectStorageConfigSourceDetails
7+
:show-inheritance:
8+
:special-members: __init__
9+
:members:
10+
:undoc-members:
11+
:inherited-members:

‎docs/api/resource_manager/models/oci.resource_manager.models.ObjectStorageConfigSource.rst‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
ObjectStorageConfigSource
2+
=========================
3+
4+
.. currentmodule:: oci.resource_manager.models
5+
6+
.. autoclass:: ObjectStorageConfigSource
7+
:show-inheritance:
8+
:special-members: __init__
9+
:members:
10+
:undoc-members:
11+
:inherited-members:

‎docs/api/resource_manager/models/oci.resource_manager.models.ObjectStorageConfigSourceRecord.rst‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
ObjectStorageConfigSourceRecord
2+
===============================
3+
4+
.. currentmodule:: oci.resource_manager.models
5+
6+
.. autoclass:: ObjectStorageConfigSourceRecord
7+
:show-inheritance:
8+
:special-members: __init__
9+
:members:
10+
:undoc-members:
11+
:inherited-members:

‎docs/api/resource_manager/models/oci.resource_manager.models.UpdateObjectStorageConfigSourceDetails.rst‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
UpdateObjectStorageConfigSourceDetails
2+
======================================
3+
4+
.. currentmodule:: oci.resource_manager.models
5+
6+
.. autoclass:: UpdateObjectStorageConfigSourceDetails
7+
:show-inheritance:
8+
:special-members: __init__
9+
:members:
10+
:undoc-members:
11+
:inherited-members:

‎docs/sdk_behaviors/retries.rst‎

Lines changed: 33 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,39 @@ By default, operations exposed in the SDK do not retry, but retries can be set i
1111

1212
A sample on using retries, including the default strategy and a custom strategy, can be found on `GitHub <https://github.com/oracle/oci-python-sdk/blob/master/examples/retries.py>`__
1313

14+
Exponential Backoff
15+
-------------------
16+
The client application must implement retries responsibly. If there are N clients retrying for the same resource the work done by service increases proportionally to N^2 as N clients retry in first round, N-1 in second and so on. This quadratic increase in workload can overwhelm the system and can cause further degradation of a service which might already be under stress. A common strategy to avoid this is to use exponential backoff. This strategy essentially makes the client wait progressively longer after each consecutive retry which is exponential in nature.
17+
18+
The wait interval with exponential backoff would be as below:-
19+
::
20+
exponential_backoff_sleep_base = min(base_time * (exponent ** attempt_number), max_wait_time)
21+
22+
Introducing Jitter
23+
------------------
24+
Exponential backoff solves the problem of overwhelming the service by spreading the retries over a longer interval of time; however, the N clients still retry in lockstep, albeit with retries spaced exponentially farther apart. To remove this synchronous behavior of the retrying clients we can add jitter, which adds randomness, to the wait interval helping these clients to avoid collision.
25+
26+
There are different strategies to implement these timed backoff delays as mentioned below.
27+
28+
Full Jitter
29+
^^^^^^^^^^^^
30+
Instead of using a constant time we can instead use a random value between 0 and the exponential backoff time.
31+
32+
Exponential backoff with full jitter is used for other scenarios where we need to retry because of a failure (e.g. timeouts, HTTP 5xx). The sleep time in this circumstance is calculated as:
33+
::
34+
exponential_backoff_sleep_base = min(base_time * (exponent ** attempt_number), max_wait_time)
35+
sleep_time = random(0, exponential_backoff_sleep_base)
36+
37+
Equal Jitter
38+
^^^^^^^^^^^^^
39+
In this strategy we keep some amount of the original backoff and jitter on smaller amount. The intuition behind this it to avoid short sleep scenarios which can again lead to overwhelming the service.
40+
41+
Exponential backoff with equal jitter is used for throttles as this guarantees some sleep time between attempts. The sleep time in this circumstance is calculated as:
42+
::
43+
exponential_backoff_sleep_base = min(base_time * (exponent ** attempt_number), max_wait_time)
44+
sleep_time = (exponential_backoff_sleep_base / 2.0) + random(0, exponential_backoff_sleep_base / 2.0)
45+
46+
1447
Default Retry Strategy
1548
------------------------
1649
The default retry strategy vended by the SDK has the following attributes:
@@ -23,20 +56,6 @@ The default retry strategy vended by the SDK has the following attributes:
2356
* An exponent of 2. When calculating the next retry time we will raise this to the power of the number of attempts
2457
* A maximum wait time between calls of 30 seconds
2558

26-
* Exponential backoff with equal jitter is used for throttles as this guarantees some sleep time between attempts. The sleep time in this circumstance is calculated as:
27-
28-
.. code-block:: none
29-
30-
exponential_backoff_sleep_base = min(base_time * (exponent ** attempt_number), max_wait_time)
31-
sleep_time = (exponential_backoff_sleep_base / 2.0) + random(0, exponential_backoff_sleep_base / 2.0)
32-
33-
* Exponential backoff with full jitter is used for other scenarios where we need to retry (e.g. timeouts, HTTP 5xx). The sleep time in this circumstance is calculated as:
34-
35-
.. code-block:: none
36-
37-
exponential_backoff_sleep_base = min(base_time * (exponent ** attempt_number), max_wait_time)
38-
sleep_time = random(0, exponential_backoff_sleep_base)
39-
4059
* Retries on the following exception types:
4160

4261
* Timeouts and connection errors

‎examples/showoci/CHANGELOG.rst‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,16 @@ All notable changes to this project will be documented in this file.
44

55
The format is based on `Keep a Changelog <http://keepachangelog.com/>`_.
66

7+
=====================
8+
21.05.11 - 21.05.11
9+
=====================
10+
* Added DNS Resolver, endpoints and rules to VCNs
11+
* Added Flex OCPUS to summary Shapes
12+
* Fixed Stopped OCPUs for VM/BM DB if node is stopped
13+
* Added Windows OCPUs to the summary
14+
* Remove vcn_id requirement from list_vlans
15+
* Added Security Scores under -sec
16+
717
=====================
818
21.04.20 - 21.04.20
919
=====================

‎examples/showoci/showoci.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@
9393
import argparse
9494
import datetime
9595

96-
version = "21.04.20"
96+
version = "21.05.11"
9797

9898
##########################################################################
9999
# check OCI version

0 commit comments

Comments
 (0)