Releasing version 2.18.1

Releasing version 2.18.1

Author: bhagwatvyas

CHANGELOG.rst

@@ -3,6 +3,18 @@ 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.18.1 - 2020-07-21
+====================
+
+Added
+-----
+* Support for license types on instances in the Content and Experience service
+
+Fixed
+-----
+* Fixed a bug for Resource Principal authentication where RPST token was not getting refreshed correctly.
+
 ====================
 2.18.0 - 2020-07-14
 ====================

docs/known-issues.rst

@@ -6,6 +6,10 @@ These are the current known issues for the Python SDK.
 
 UploadManager generates ssl3_write_pending error when a read timeout is set for the Object Storage client
 =========================================================================================================
+**Update:** With v2.18.0 we handle the object storage client with default timeout values (connect timeout = 10 secs and read timeout = 60 secs), by overwriting the timeout to `None` in the operations.
+
+PLEASE NOTE that the operations are NOT thread-safe, and you should provide the UploadManager class with its own Object Storage client that isn't used elsewhere.
+
 **Details:** UploadManager generates the following error when a read timeout is set for the Object Storage client.
 
 .. code-block:: python
@@ -35,4 +39,9 @@ Potential data corruption with Python SDK on binary upload (versions 2.8.0 and b
 
 **Impacted Versions:** v2.8.0 and below
 
-**Direct link to this issue:** `Potential data corruption with Python SDK on binary upload <https://github.com/oracle/oci-python-sdk/issues/203/>`_
+**Direct link to this issue:** `Potential data corruption with Python SDK on binary upload <https://github.com/oracle/oci-python-sdk/issues/203/>`_
+
+
+Default timeout not getting set in the clients (versions 2.17.2 and below)
+==========================================================================
+The default timeout values (connect timeout = 10 secs and read timeout = 60 secs) we not getting set in the clients and remained None (infinite timeout). This has been fixed in v2.18.0.

docs/pagination.rst

@@ -19,4 +19,4 @@ 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
 
-For an example on how to use these functions, please check `GitHub <https://github.com/oracle/oci-python-sdk/blob/master/examples/pagination.py>`_.
+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://oracle-cloud-infrastructure-python-sdk.readthedocs.io/en/latest/api/pagination.html>`_.

examples/Resource_Principle_v2.2_Functions_example/Dockerfile

@@ -0,0 +1,17 @@
+FROM fnproject/python:3.6-dev as build-stage
+WORKDIR /function
+ADD . /function/
+RUN pip3 install --target /python/  --no-cache --no-cache-dir -r requirements.txt &&\
+        rm -fr ~/.cache/pip /tmp* requirements.txt func.yaml Dockerfile .venv
+RUN rm -fr /function/.pip_cache
+
+
+FROM fnproject/python:3.6
+WORKDIR /function
+COPY --from=build-stage /function /function
+COPY --from=build-stage /python /python
+RUN chmod -R o+r /python /function
+# Usually, users don't need to install python sdk here, but directly add oci in requirement.txt
+ENV PYTHONPATH=/function:/python
+RUN pip3 install oci-2.17.1+preview.1-py2.py3-none-any.whl
+ENTRYPOINT ["/python/bin/fdk", "/function/func.py", "handler"]

examples/Resource_Principle_v2.2_Functions_example/func.py

@@ -0,0 +1,40 @@
+# coding: utf-8
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+# This example uses functions service to get the rpv2.2 token, for how to use functions, please refer fn Tutorials: https://fnproject.io/tutorials/
+# Users can set up Fn locally or with oci cloud shell, the tutoials can be found here: https://www.oracle.com/webfolder/technetwork/tutorials/infographics/oci_functions_cloudshell_quickview/functions_quickview_top/functions_quickview/index.html
+
+import io
+import json
+import logging
+import oci
+# used by functions service
+from fdk import response
+
+
+def list_regions(client):
+    try:
+        resp = client.list_regions()
+        logging.getLogger().info("region info:", resp.data)
+    except oci.exceptions.ServiceError as e:
+        logging.getLogger().error("service error: {0}, error code: {1}, opc-request-id: {2}".format(e.message, e.code, e.request_id))
+        return e
+    return resp.data
+
+
+def handler(ctx, data: io.BytesIO = None):  # noqa: E999
+    rpv2 = oci.auth.signers.get_resource_principals_signer()
+    # Print the Resource Principal Security Token
+    logging.getLogger().info("resource principle token:", rpv2.get_security_token())
+
+    # Note the config is passed in as an empty dictionary.  A populated config
+    # is not needed when using an EphemeralResourcePrincipalSigner
+    iam_client = oci.identity.IdentityClient({}, signer=rpv2)
+
+    resp = list_regions(iam_client)
+    return response.Response(
+        ctx, response_data=json.dumps(
+            {"regions:": str(resp)}),
+        headers={"Content-Type": "application/json"}
+    )

examples/Resource_Principle_v2.2_Functions_example/func.yaml

@@ -0,0 +1,6 @@
+schema_version: 20180708
+name: pythonfn
+version: 0.0.1
+runtime: python
+entrypoint: /python/bin/fdk /function/func.py handler
+memory: 1024

examples/Resource_Principle_v2.2_Functions_example/requirement.txt

@@ -0,0 +1 @@
+fdk==0.1.16

examples/showoci/CHANGELOG.rst

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`_.
 
+=====================
+20.07.21 - 2020-07-21
+=====================
+* Remove vcn_id from several network list options to boost the performance - list_dhcp_options, list_local_peering_gateways, list_route_tables, list_security_lists, list_subnets and list_internet_gateways
+* Fix database error if DG is in different region
+
 =====================
 20.07.14 - 2020-07-14
 =====================

examples/showoci/showoci.py

@@ -69,7 +69,12 @@
 # - oci.secrets.SecretsClient
 # - oci.vault.VaultsClient
 # - oci.work_requests.WorkRequestClient
-# -
+# - oci.blockchain.BlockchainPlatformClient
+# - oci.data_integration.DataIntegrationClient
+# - oci.data_safe.DataSafeClient
+# - oci.ocvp.EsxiHostClient and oci.ocvp.SddcClient
+# - oci.usage_api.UsageapiClient
+#
 ##########################################################################
 from __future__ import print_function
 from showoci_data import ShowOCIData
@@ -81,7 +86,7 @@
 import argparse
 import datetime
 
-version = "20.07.14"
+version = "20.07.21"
 
 ##########################################################################
 # check OCI version