oci 2.139.0__py3-none-any.whl → 2.141.0__py3-none-any.whl

oci/artifacts/artifacts_client.py

@@ -168,7 +168,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/change_container_repository_compartment.py.html>`__ to see an example of how to use change_container_repository_compartment API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/change_container_repository_compartment.py.html>`__ to see an example of how to use change_container_repository_compartment API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['repositoryId']
@@ -295,7 +295,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/change_repository_compartment.py.html>`__ to see an example of how to use change_repository_compartment API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/change_repository_compartment.py.html>`__ to see an example of how to use change_repository_compartment API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['repositoryId']
@@ -411,7 +411,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/create_container_image_signature.py.html>`__ to see an example of how to use create_container_image_signature API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/create_container_image_signature.py.html>`__ to see an example of how to use create_container_image_signature API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
@@ -512,7 +512,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/create_container_repository.py.html>`__ to see an example of how to use create_container_repository API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/create_container_repository.py.html>`__ to see an example of how to use create_container_repository API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
@@ -611,7 +611,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/create_repository.py.html>`__ to see an example of how to use create_repository API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/create_repository.py.html>`__ to see an example of how to use create_repository API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
@@ -710,7 +710,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/delete_container_image.py.html>`__ to see an example of how to use delete_container_image API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/delete_container_image.py.html>`__ to see an example of how to use delete_container_image API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['imageId']
@@ -818,7 +818,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/delete_container_image_signature.py.html>`__ to see an example of how to use delete_container_image_signature API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/delete_container_image_signature.py.html>`__ to see an example of how to use delete_container_image_signature API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['imageSignatureId']
@@ -926,7 +926,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/delete_container_repository.py.html>`__ to see an example of how to use delete_container_repository API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/delete_container_repository.py.html>`__ to see an example of how to use delete_container_repository API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['repositoryId']
@@ -1036,7 +1036,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/delete_generic_artifact.py.html>`__ to see an example of how to use delete_generic_artifact API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/delete_generic_artifact.py.html>`__ to see an example of how to use delete_generic_artifact API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['artifactId']
@@ -1154,7 +1154,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/delete_generic_artifact_by_path.py.html>`__ to see an example of how to use delete_generic_artifact_by_path API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/delete_generic_artifact_by_path.py.html>`__ to see an example of how to use delete_generic_artifact_by_path API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['repositoryId', 'artifactPath', 'version']
@@ -1264,7 +1264,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/delete_repository.py.html>`__ to see an example of how to use delete_repository API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/delete_repository.py.html>`__ to see an example of how to use delete_repository API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['repositoryId']
@@ -1365,7 +1365,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/get_container_configuration.py.html>`__ to see an example of how to use get_container_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/get_container_configuration.py.html>`__ to see an example of how to use get_container_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -1463,7 +1463,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/get_container_image.py.html>`__ to see an example of how to use get_container_image API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/get_container_image.py.html>`__ to see an example of how to use get_container_image API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['imageId']
@@ -1566,7 +1566,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/get_container_image_signature.py.html>`__ to see an example of how to use get_container_image_signature API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/get_container_image_signature.py.html>`__ to see an example of how to use get_container_image_signature API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['imageSignatureId']
@@ -1669,7 +1669,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/get_container_repository.py.html>`__ to see an example of how to use get_container_repository API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/get_container_repository.py.html>`__ to see an example of how to use get_container_repository API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['repositoryId']
@@ -1774,7 +1774,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/get_generic_artifact.py.html>`__ to see an example of how to use get_generic_artifact API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/get_generic_artifact.py.html>`__ to see an example of how to use get_generic_artifact API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['artifactId']
@@ -1887,7 +1887,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/get_generic_artifact_by_path.py.html>`__ to see an example of how to use get_generic_artifact_by_path API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/get_generic_artifact_by_path.py.html>`__ to see an example of how to use get_generic_artifact_by_path API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['repositoryId', 'artifactPath', 'version']
@@ -1992,7 +1992,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/get_repository.py.html>`__ to see an example of how to use get_repository API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/get_repository.py.html>`__ to see an example of how to use get_repository API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['repositoryId']
@@ -2172,7 +2172,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/list_container_image_signatures.py.html>`__ to see an example of how to use list_container_image_signatures API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/list_container_image_signatures.py.html>`__ to see an example of how to use list_container_image_signatures API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -2381,7 +2381,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/list_container_images.py.html>`__ to see an example of how to use list_container_images API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/list_container_images.py.html>`__ to see an example of how to use list_container_images API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -2568,7 +2568,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/list_container_repositories.py.html>`__ to see an example of how to use list_container_repositories API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/list_container_repositories.py.html>`__ to see an example of how to use list_container_repositories API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -2751,7 +2751,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/list_generic_artifacts.py.html>`__ to see an example of how to use list_generic_artifacts API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/list_generic_artifacts.py.html>`__ to see an example of how to use list_generic_artifacts API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId', 'repositoryId']
@@ -2928,7 +2928,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/list_repositories.py.html>`__ to see an example of how to use list_repositories API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/list_repositories.py.html>`__ to see an example of how to use list_repositories API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -3071,7 +3071,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/remove_container_version.py.html>`__ to see an example of how to use remove_container_version API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/remove_container_version.py.html>`__ to see an example of how to use remove_container_version API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['imageId']
@@ -3196,7 +3196,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/restore_container_image.py.html>`__ to see an example of how to use restore_container_image API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/restore_container_image.py.html>`__ to see an example of how to use restore_container_image API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['imageId']
@@ -3312,7 +3312,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/update_container_configuration.py.html>`__ to see an example of how to use update_container_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/update_container_configuration.py.html>`__ to see an example of how to use update_container_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -3422,7 +3422,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/update_container_image.py.html>`__ to see an example of how to use update_container_image API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/update_container_image.py.html>`__ to see an example of how to use update_container_image API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['imageId']
@@ -3537,7 +3537,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/update_container_image_signature.py.html>`__ to see an example of how to use update_container_image_signature API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/update_container_image_signature.py.html>`__ to see an example of how to use update_container_image_signature API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['imageSignatureId']
@@ -3652,7 +3652,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/update_container_repository.py.html>`__ to see an example of how to use update_container_repository API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/update_container_repository.py.html>`__ to see an example of how to use update_container_repository API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['repositoryId']
@@ -3771,7 +3771,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/update_generic_artifact.py.html>`__ to see an example of how to use update_generic_artifact API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/update_generic_artifact.py.html>`__ to see an example of how to use update_generic_artifact API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['artifactId']
@@ -3896,7 +3896,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/update_generic_artifact_by_path.py.html>`__ to see an example of how to use update_generic_artifact_by_path API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/update_generic_artifact_by_path.py.html>`__ to see an example of how to use update_generic_artifact_by_path API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['repositoryId', 'artifactPath', 'version']
@@ -4013,7 +4013,7 @@ class ArtifactsClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/artifacts/update_repository.py.html>`__ to see an example of how to use update_repository API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/artifacts/update_repository.py.html>`__ to see an example of how to use update_repository API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['repositoryId']

oci/audit/audit_client.py

@@ -143,7 +143,7 @@ class AuditClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/audit/get_configuration.py.html>`__ to see an example of how to use get_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/audit/get_configuration.py.html>`__ to see an example of how to use get_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -260,7 +260,7 @@ class AuditClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/audit/list_events.py.html>`__ to see an example of how to use list_events API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/audit/list_events.py.html>`__ to see an example of how to use list_events API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId', 'startTime', 'endTime']
@@ -355,7 +355,7 @@ class AuditClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/audit/update_configuration.py.html>`__ to see an example of how to use update_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/audit/update_configuration.py.html>`__ to see an example of how to use update_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']

oci/auth/certificate_retriever.py

@@ -17,17 +17,14 @@ import pprint
 
 # A retry strategy for use when calling the metadata endpoint on an instance to retrieve certificates.
 # This retry strategy will retry on 404, 429 and 5xx exceptions (the metadata endpoint does not throw errors like an
-# OCI service) up to 3 times with ~30-31 seconds wait, for a max of 3 minutes
+# OCI service) up to 8 times with exponential backoff and jitter, for a max of 3 minutes
 INSTANCE_METADATA_URL_CERTIFICATE_RETRIEVER_RETRY_STRATEGY = (
     oci.retry.RetryStrategyBuilder(service_error_check=True,
                                    service_error_retry_config={-1: [], 429: [], 404: []},
                                    service_error_retry_on_any_5xx=True,
-                                   retry_max_wait_between_calls_seconds=31,
-                                   retry_base_sleep_time_seconds=30,
-                                   retry_exponential_growth_factor=1,
                                    total_elapsed_time_seconds=180
                                    )
-    .add_max_attempts(3).add_total_elapsed_time().get_retry_strategy())
+    .add_max_attempts(8).add_total_elapsed_time().get_retry_strategy())
 
 
 # An abstract class which defines the interface via which certificates (and their corresponding private key) can be retrieved.

oci/auth/signers/instance_principals_security_token_signer.py

@@ -12,6 +12,7 @@ from oci._vendor.requests.exceptions import HTTPError
 from oci._vendor.requests.exceptions import ConnectTimeout
 
 import oci.regions
+import os
 import logging
 
 
@@ -24,6 +25,7 @@ class InstancePrincipalsSecurityTokenSigner(X509FederationClientBasedSecurityTok
     the token:
 
     * Using the metadata endpoint for the instance (http://169.254.169.254/opc/v2) we can discover the region the instance is in, its leaf certificate and any intermediate certificates (for requesting the token) and the tenancy (as) that is in the leaf certificate.
+    * You can override the metadata endpoint by overriding the environment variable OCI_METADATA_BASE_URL with an endpoint of your choice
     * The signer leverages X509FederationClient so it can refresh the security token and also get the private key needed to sign requests (via the client's session_key_supplier)
 
     This signer can be used as follows:
@@ -47,7 +49,7 @@ class InstancePrincipalsSecurityTokenSigner(X509FederationClientBasedSecurityTok
 
     :param obj federation_client_retry_strategy: (optional):
         A retry strategy to apply to calls made by the X509FederationClient used by this class. This should be one of the strategies available in
-        the :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` is also available and
+        the :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.DEFAULT_FEDERATION_CLIENT_RETRY_STRATEGY` is also available and
         will be used by the X509FederationClient if no explicit retry strategy is specified.
 
         The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
@@ -59,15 +61,16 @@ class InstancePrincipalsSecurityTokenSigner(X509FederationClientBasedSecurityTok
         the certificate & corresponding private key (if there is one defined for this retriever) from UrlBasedCertificateRetriever,
         region, federation endpoint, and the response for receiving the token from the federation endpoint
     """
-
-    METADATA_URL_BASE = 'http://169.254.169.254/opc/v2'
-    GET_REGION_URL = '{}/instance/region'.format(METADATA_URL_BASE)
-    LEAF_CERTIFICATE_URL = '{}/identity/cert.pem'.format(METADATA_URL_BASE)
-    LEAF_CERTIFICATE_PRIVATE_KEY_URL = '{}/identity/key.pem'.format(METADATA_URL_BASE)
-    INTERMEDIATE_CERTIFICATE_URL = '{}/identity/intermediate.pem'.format(METADATA_URL_BASE)
-    METADATA_AUTH_HEADERS = {'Authorization': 'Bearer Oracle'}
-
     def __init__(self, **kwargs):
+        self.METADATA_URL_BASE_ENV_VAR = 'OCI_METADATA_BASE_URL'
+        self.DEFAULT_METADATA_URL_BASE = 'http://169.254.169.254/opc/v2'
+        self.METADATA_URL_BASE = os.environ.get(self.METADATA_URL_BASE_ENV_VAR, self.DEFAULT_METADATA_URL_BASE)
+        self.GET_REGION_URL = '{}/instance/region'.format(self.METADATA_URL_BASE)
+        self.LEAF_CERTIFICATE_URL = '{}/identity/cert.pem'.format(self.METADATA_URL_BASE)
+        self.LEAF_CERTIFICATE_PRIVATE_KEY_URL = '{}/identity/key.pem'.format(self.METADATA_URL_BASE)
+        self.INTERMEDIATE_CERTIFICATE_URL = '{}/identity/intermediate.pem'.format(self.METADATA_URL_BASE)
+        self.METADATA_AUTH_HEADERS = {'Authorization': 'Bearer Oracle'}
+
         self.logger = logging.getLogger("{}.{}".format(__name__, id(self)))
         self.logger.addHandler(logging.NullHandler())
         if kwargs.get('log_requests'):
@@ -90,22 +93,10 @@ class InstancePrincipalsSecurityTokenSigner(X509FederationClientBasedSecurityTok
                 headers=self.METADATA_AUTH_HEADERS,
                 log_requests=kwargs.get('log_requests'))
         except (HTTPError, ConnectTimeout, oci.exceptions.ServiceError) as e:
-            if e.response and e.response.status_code == 404:
-                InstancePrincipalsSecurityTokenSigner.METADATA_URL_BASE = 'http://169.254.169.254/opc/v1'
-                InstancePrincipalsSecurityTokenSigner.GET_REGION_URL = '{}/instance/region'.format(InstancePrincipalsSecurityTokenSigner.METADATA_URL_BASE)
-                InstancePrincipalsSecurityTokenSigner.LEAF_CERTIFICATE_URL = '{}/identity/cert.pem'.format(InstancePrincipalsSecurityTokenSigner.METADATA_URL_BASE)
-                InstancePrincipalsSecurityTokenSigner.LEAF_CERTIFICATE_PRIVATE_KEY_URL = '{}/identity/key.pem'.format(InstancePrincipalsSecurityTokenSigner.METADATA_URL_BASE)
-                InstancePrincipalsSecurityTokenSigner.INTERMEDIATE_CERTIFICATE_URL = '{}/identity/intermediate.pem'.format(InstancePrincipalsSecurityTokenSigner.METADATA_URL_BASE)
-                self.leaf_certificate_retriever = UrlBasedCertificateRetriever(
-                    certificate_url=self.LEAF_CERTIFICATE_URL,
-                    private_key_url=self.LEAF_CERTIFICATE_PRIVATE_KEY_URL,
-                    retry_strategy=self.retry_strategy,
-                    headers=self.METADATA_AUTH_HEADERS)
-            else:
-                if not e.args:
-                    e.args = ('',)
-                e.args = e.args + ("Instance principals authentication can only be used on OCI compute instances. Please confirm this code is running on an OCI compute instance. See https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/callingservicesfrominstances.htm for more info.",)
-                raise e
+            if not e.args:
+                e.args = ('',)
+            e.args = e.args + ("Instance principals authentication can only be used on OCI compute instances. Please confirm this code is running on an OCI compute instance. See https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/callingservicesfrominstances.htm for more info.",)
+            raise e
 
         self.intermediate_certificate_retriever = UrlBasedCertificateRetriever(
             certificate_url=self.INTERMEDIATE_CERTIFICATE_URL,
@@ -143,8 +134,23 @@ class InstancePrincipalsSecurityTokenSigner(X509FederationClientBasedSecurityTok
         if hasattr(self, 'region'):
             return self.region
 
-        self.logger.debug("Requesting region information from : %s " % (self.GET_REGION_URL))
+        if self.retry_strategy:
+            self.retry_strategy.make_retrying_call(self._set_region_from_imds)
+        else:
+            self._set_region_from_imds()
+
+        self.logger.debug(f"Region is set to: {self.region}")
+        return self.region
+
+    def _set_region_from_imds(self):
+        self.logger.debug(f"Requesting region information from IMDS: {self.GET_REGION_URL}")
         response = requests.get(self.GET_REGION_URL, timeout=(10, 60), headers=self.METADATA_AUTH_HEADERS)
+
+        try:
+            response.raise_for_status()
+        except HTTPError as e:
+            raise oci.exceptions.ServiceError(e.response.status_code, e.errno, e.response.headers, str(e))
+
         region_raw = response.text.strip().lower()
 
         # The region can be something like "phx" but internally we expect "us-phoenix-1", "us-ashburn-1" etc.
@@ -152,6 +158,3 @@ class InstancePrincipalsSecurityTokenSigner(X509FederationClientBasedSecurityTok
             self.region = oci.regions.REGIONS_SHORT_NAMES[region_raw]
         else:
             self.region = region_raw
-
-        self.logger.debug("Region is set to : %s " % (self.region))
-        return self.region

oci/auth/signers/oke_workload_identity_resource_principal_signer.py

@@ -134,11 +134,18 @@ class OkeWorkloadIdentityResourcePrincipalSigner(SecurityTokenSigner):
              "reason": response.reason}, indent=2)))
 
         if not response.ok:
-            raise oci.exceptions.ServiceError(
-                response.status_code,
-                response.reason,
-                response.headers,
-                "Failed to get RPST token from proxymux")
+            if response.status_code == 403:
+                raise oci.exceptions.ServiceError(
+                    response.status_code,
+                    response.reason,
+                    response.headers,
+                    "Please ensure the cluster type is enhanced")
+            else:
+                raise oci.exceptions.ServiceError(
+                    response.status_code,
+                    response.reason,
+                    response.headers,
+                    "Failed to get RPST token from proxymux")
 
         try:
             decoded_response = base64.b64decode(response.content).decode("UTF-8")

oci/autoscaling/auto_scaling_client.py

@@ -171,7 +171,7 @@ class AutoScalingClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/autoscaling/change_auto_scaling_configuration_compartment.py.html>`__ to see an example of how to use change_auto_scaling_configuration_compartment API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/autoscaling/change_auto_scaling_configuration_compartment.py.html>`__ to see an example of how to use change_auto_scaling_configuration_compartment API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['autoScalingConfigurationId']
@@ -278,7 +278,7 @@ class AutoScalingClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/autoscaling/create_auto_scaling_configuration.py.html>`__ to see an example of how to use create_auto_scaling_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/autoscaling/create_auto_scaling_configuration.py.html>`__ to see an example of how to use create_auto_scaling_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
@@ -386,7 +386,7 @@ class AutoScalingClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/autoscaling/create_auto_scaling_policy.py.html>`__ to see an example of how to use create_auto_scaling_policy API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/autoscaling/create_auto_scaling_policy.py.html>`__ to see an example of how to use create_auto_scaling_policy API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['autoScalingConfigurationId']
@@ -493,7 +493,7 @@ class AutoScalingClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/autoscaling/delete_auto_scaling_configuration.py.html>`__ to see an example of how to use delete_auto_scaling_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/autoscaling/delete_auto_scaling_configuration.py.html>`__ to see an example of how to use delete_auto_scaling_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['autoScalingConfigurationId']
@@ -598,7 +598,7 @@ class AutoScalingClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/autoscaling/delete_auto_scaling_policy.py.html>`__ to see an example of how to use delete_auto_scaling_policy API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/autoscaling/delete_auto_scaling_policy.py.html>`__ to see an example of how to use delete_auto_scaling_policy API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['autoScalingConfigurationId', 'autoScalingPolicyId']
@@ -696,7 +696,7 @@ class AutoScalingClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/autoscaling/get_auto_scaling_configuration.py.html>`__ to see an example of how to use get_auto_scaling_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/autoscaling/get_auto_scaling_configuration.py.html>`__ to see an example of how to use get_auto_scaling_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['autoScalingConfigurationId']
@@ -796,7 +796,7 @@ class AutoScalingClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/autoscaling/get_auto_scaling_policy.py.html>`__ to see an example of how to use get_auto_scaling_policy API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/autoscaling/get_auto_scaling_policy.py.html>`__ to see an example of how to use get_auto_scaling_policy API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['autoScalingConfigurationId', 'autoScalingPolicyId']
@@ -924,7 +924,7 @@ class AutoScalingClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/autoscaling/list_auto_scaling_configurations.py.html>`__ to see an example of how to use list_auto_scaling_configurations API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/autoscaling/list_auto_scaling_configurations.py.html>`__ to see an example of how to use list_auto_scaling_configurations API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -1068,7 +1068,7 @@ class AutoScalingClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/autoscaling/list_auto_scaling_policies.py.html>`__ to see an example of how to use list_auto_scaling_policies API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/autoscaling/list_auto_scaling_policies.py.html>`__ to see an example of how to use list_auto_scaling_policies API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['autoScalingConfigurationId']
@@ -1211,7 +1211,7 @@ class AutoScalingClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/autoscaling/update_auto_scaling_configuration.py.html>`__ to see an example of how to use update_auto_scaling_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/autoscaling/update_auto_scaling_configuration.py.html>`__ to see an example of how to use update_auto_scaling_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['autoScalingConfigurationId']
@@ -1333,7 +1333,7 @@ class AutoScalingClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.139.0/autoscaling/update_auto_scaling_policy.py.html>`__ to see an example of how to use update_auto_scaling_policy API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.141.0/autoscaling/update_auto_scaling_policy.py.html>`__ to see an example of how to use update_auto_scaling_policy API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['autoScalingConfigurationId', 'autoScalingPolicyId']