Releasing version 2.2.16

Releasing version 2.2.16

Author: dshelbyo

CHANGELOG.rst

@@ -4,6 +4,19 @@ All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`_.
 
+====================
+2.2.16 - 2019-07-02
+====================
+
+Added
+-----
+* Support for moving images, instance configurations, and instance pools across compartments in Core Services
+* Support for moving autoscaling configurations across compartments in the Compute Autoscaling service
+
+Fixed
+-----
+* Fixed a bug where the Streaming service's endpoints in Tokyo, Seoul, and future regions were not reachable from the SDK
+
 ====================
 2.2.15 - 2019-06-25
 ====================

docs/api/autoscaling.rst

@@ -24,6 +24,7 @@ Autoscaling
     oci.autoscaling.models.AutoScalingPolicy
     oci.autoscaling.models.AutoScalingPolicySummary
     oci.autoscaling.models.Capacity
+    oci.autoscaling.models.ChangeAutoScalingCompartmentDetails
     oci.autoscaling.models.Condition
     oci.autoscaling.models.CreateAutoScalingConfigurationDetails
     oci.autoscaling.models.CreateAutoScalingPolicyDetails

docs/api/autoscaling/models/oci.autoscaling.models.ChangeAutoScalingCompartmentDetails.rst

@@ -0,0 +1,11 @@
+ChangeAutoScalingCompartmentDetails
+===================================
+
+.. currentmodule:: oci.autoscaling.models
+
+.. autoclass:: ChangeAutoScalingCompartmentDetails
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:

docs/api/core.rst

@@ -52,6 +52,9 @@ Core Services
     oci.core.models.CaptureConsoleHistoryDetails
     oci.core.models.ChangeBootVolumeBackupCompartmentDetails
     oci.core.models.ChangeBootVolumeCompartmentDetails
+    oci.core.models.ChangeImageCompartmentDetails
+    oci.core.models.ChangeInstanceConfigurationCompartmentDetails
+    oci.core.models.ChangeInstancePoolCompartmentDetails
     oci.core.models.ChangeNatGatewayCompartmentDetails
     oci.core.models.ChangeServiceGatewayCompartmentDetails
     oci.core.models.ChangeVolumeBackupCompartmentDetails

docs/api/core/models/oci.core.models.ChangeImageCompartmentDetails.rst

@@ -0,0 +1,11 @@
+ChangeImageCompartmentDetails
+=============================
+
+.. currentmodule:: oci.core.models
+
+.. autoclass:: ChangeImageCompartmentDetails
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:

docs/api/core/models/oci.core.models.ChangeInstanceConfigurationCompartmentDetails.rst

@@ -0,0 +1,11 @@
+ChangeInstanceConfigurationCompartmentDetails
+=============================================
+
+.. currentmodule:: oci.core.models
+
+.. autoclass:: ChangeInstanceConfigurationCompartmentDetails
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:

docs/api/core/models/oci.core.models.ChangeInstancePoolCompartmentDetails.rst

@@ -0,0 +1,11 @@
+ChangeInstancePoolCompartmentDetails
+====================================
+
+.. currentmodule:: oci.core.models
+
+.. autoclass:: ChangeInstancePoolCompartmentDetails
+    :show-inheritance:
+    :special-members: __init__
+    :members:
+    :undoc-members:
+    :inherited-members:

docs/logging.rst

@@ -10,15 +10,26 @@
 Logging
 ~~~~~~~
 
-The Python SDK uses Python's `logging <https://docs.python.org/3.6/library/logging.html>`_ module. 
+The Python SDK uses Python's `logging <https://docs.python.org/3.6/library/logging.html>`_ module.
 
 Loggers for the Python SDK are ordered hierarchically, with the top level being ``oci`` (or ``oraclebmc`` if you are using the legacy OracleBMC package).
 
 Logger names are of the form ``<hierarchy>.<id>`` where the ``<hierarchy>`` is similar to ``oci.base_client`` and ``<id>`` is the result of Python's built-in ``id()`` function. The implication of this is that different instances of the same class have different loggers.
 
+The following code snippet is an example for configuring debug level logging for the oci package:
+
+.. code-block:: python
+    import oci
+    import logging
+
+    # Enable debug logging
+    logging.getLogger('oci').setLevel(logging.DEBUG)
+
+    # Rest of code ...
+
 Request Logging
 ================
-Logging of the requests which the Python SDK sends to Oracle Cloud Infrastructure services can be enabled by setting the ``log_requests`` attribute to ``True`` in your configuration. This could be done in your configuration file, for example:
+Request logging can be enabled for more detailed debugging information.  Request logging outputs the requests that the Python SDK sends to Oracle Cloud Infrastructure services.  This option can be enabled by setting the configuration attribute ``log_requests`` to ``True``. Alternatively, request logging can be enabled in your configuration file. For example:
 
 .. code-block:: text
 
@@ -43,9 +54,11 @@ Or programmatically, for example:
         "log_requests": True
     }
 
+Request logging enables debugging information in the Python http module.  This debugging information can be quite verbose and the output will go to standard out.  This http module does not use Python's logging module.
+
 Once you have request logging in your config, you can create the appropriate logging handler(s) for your use case. For example to log to an output stream such as ``stderr`` you could do:
 
-.. code-block:: python 
+.. code-block:: python
 
     import oci
     import logging
@@ -60,9 +73,10 @@ Once you have request logging in your config, you can create the appropriate log
     # This call will emit log information to stderr
     client.list_regions()
 
-Note that request logging occurs at the following levels:
+The oci module has logging at the following levels:
 
 * ``INFO``: Request method and request URL
 * ``DEBUG``: Request headers and body, and response headers
 
+
 The raw response body is not logged.

examples/database/adb_example.py

@@ -2,6 +2,7 @@
 # Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
 
 import oci
+import time
 
 # Overview of Autonomous Data Warehouse
 # https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/adboverview.htm
@@ -26,6 +27,8 @@ def create_adb(db_client):
     adb_request.display_name = "PYSDK-ADB-EXAMPLE"
     adb_request.db_workload = "OLTP"
     adb_request.license_model = adb_request.LICENSE_MODEL_BRING_YOUR_OWN_LICENSE
+    # For demonstration, we just passed the password here but for Production code you should have a better
+    # way to pass the password like env variable or commandline
     adb_request.admin_password = "Welcome1!SDK"
     adb_request.is_auto_scaling_enabled = True
 
@@ -38,8 +41,8 @@ def create_adb(db_client):
     return adb_response.data.id
 
 
+# Delete the autonomous database
 def delete_adb(db_client, adb_id):
-    # Delete the autonomous database
     response = db_client.delete_autonomous_database(adb_id)
     print(response)
 
@@ -62,8 +65,50 @@ def update_adb(db_client, adb_id):
     return adb_response.data.id
 
 
+def update_adb_acl(db_client, adb_id):
+    # Update adb Access Control List
+    adb_request = oci.database.models.UpdateAutonomousDatabaseDetails()
+
+    adb_request.whitelisted_ips = ["1.1.1.1/28", "3.3.3.3"]
+
+    adb_response = db_client.update_autonomous_database(adb_id,
+                                                        update_autonomous_database_details=adb_request,
+                                                        retry_strategy=oci.retry.DEFAULT_RETRY_STRATEGY)
+
+    print("ATP Shared instance Access Control List is being changed {}".format(adb_response.data.id))
+
+    return adb_response.data.id
+
+
+def update_adb_licesnse_type(db_client, adb_id):
+    # Update adb Licesnse Type
+    adb_request = oci.database.models.UpdateAutonomousDatabaseDetails()
+
+    adb_request.license_model = adb_request.LICENSE_MODEL_LICENSE_INCLUDED
+
+    adb_response = db_client.update_autonomous_database(adb_id,
+                                                        update_autonomous_database_details=adb_request,
+                                                        retry_strategy=oci.retry.DEFAULT_RETRY_STRATEGY)
+
+    print("ATP Shared instance License Type is being changed {}".format(adb_response.data.id))
+
+    return adb_response.data.id
+
+
 if __name__ == "__main__":
     # Initialize the client
     db_client = oci.database.DatabaseClient(config)
+    # Create adb
     adb_id = create_adb(db_client)
+    # sleep 5 mins
+    time.sleep(300)
+    # Update adb acl with specific adb_id.
+    update_adb_acl(db_client, adb_id)
+    # sleep 5 mins
+    time.sleep(300)
+    # Update adb license type
+    update_adb_licesnse_type(db_client, adb_id)
+    # sleep 5 mins
+    time.sleep(300)
+    # Delete adb
     delete_adb(db_client, adb_id)

src/oci/autoscaling/auto_scaling_client.py

@@ -81,6 +81,108 @@ def __init__(self, config, **kwargs):
         self.base_client = BaseClient("auto_scaling", config, signer, autoscaling_type_mapping, **base_client_init_kwargs)
         self.retry_strategy = kwargs.get('retry_strategy')
 
+    def change_auto_scaling_configuration_compartment(self, auto_scaling_configuration_id, change_compartment_details, **kwargs):
+        """
+        ChangeAutoScalingConfigurationCompartment
+        Moves an autoscaling configuration into a different compartment within the same tenancy. For information
+        about moving resources between compartments, see
+        `Moving Resources to a Different Compartment`__.
+
+        When you move an autoscaling configuration to a different compartment, associated resources such as instance
+        pools are not moved.
+
+        __ https://docs.cloud.oracle.com/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes
+
+
+        :param str auto_scaling_configuration_id: (required)
+            The `OCID`__ of the autoscaling configuration.
+
+            __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm
+
+        :param ChangeAutoScalingCompartmentDetails change_compartment_details: (required)
+            Request to change the compartment of given autoscaling configuration.
+
+        :param str opc_request_id: (optional)
+
+        :param str if_match: (optional)
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+            parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+            will be updated or deleted only if the etag you provide matches the resource's current etag value.
+
+        :param str opc_retry_token: (optional)
+            A token that uniquely identifies a request so it can be retried in case of a timeout or
+            server error without risk of executing that same action again. Retry tokens expire after 24
+            hours, but can be invalidated before then due to conflicting operations (for example, if a resource
+            has been deleted and purged from the system, then a retry of the original creation request
+            may be rejected).
+
+        :param obj retry_strategy: (optional)
+            A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
+
+            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. The specifics of the default retry strategy are described `here <https://oracle-cloud-infrastructure-python-sdk.readthedocs.io/en/latest/sdk_behaviors/retries.html>`__.
+
+            To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
+
+        :return: A :class:`~oci.response.Response` object with data of type None
+        :rtype: :class:`~oci.response.Response`
+        """
+        resource_path = "/autoScalingConfigurations/{autoScalingConfigurationId}/actions/changeCompartment"
+        method = "POST"
+
+        # Don't accept unknown kwargs
+        expected_kwargs = [
+            "retry_strategy",
+            "opc_request_id",
+            "if_match",
+            "opc_retry_token"
+        ]
+        extra_kwargs = [key for key in six.iterkeys(kwargs) if key not in expected_kwargs]
+        if extra_kwargs:
+            raise ValueError(
+                "change_auto_scaling_configuration_compartment got unknown kwargs: {!r}".format(extra_kwargs))
+
+        path_params = {
+            "autoScalingConfigurationId": auto_scaling_configuration_id
+        }
+
+        path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
+
+        for (k, v) in six.iteritems(path_params):
+            if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
+                raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k))
+
+        header_params = {
+            "accept": "application/json",
+            "content-type": "application/json",
+            "opc-request-id": kwargs.get("opc_request_id", missing),
+            "if-match": kwargs.get("if_match", missing),
+            "opc-retry-token": kwargs.get("opc_retry_token", missing)
+        }
+        header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
+
+        retry_strategy = self.retry_strategy
+        if kwargs.get('retry_strategy'):
+            retry_strategy = kwargs.get('retry_strategy')
+
+        if retry_strategy:
+            if not isinstance(retry_strategy, retry.NoneRetryStrategy):
+                self.base_client.add_opc_retry_token_if_needed(header_params)
+            return retry_strategy.make_retrying_call(
+                self.base_client.call_api,
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                header_params=header_params,
+                body=change_compartment_details)
+        else:
+            return self.base_client.call_api(
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                header_params=header_params,
+                body=change_compartment_details)
+
     def create_auto_scaling_configuration(self, create_auto_scaling_configuration_details, **kwargs):
         """
         CreateAutoScalingConfiguration