Releasing version 2.2.15

Releasing version 2.2.15

Author: dshelbyo

CHANGELOG.rst

@@ -4,6 +4,15 @@ 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.15 - 2019-06-25
+====================
+
+Added
+-----
+* Support for moving senders across compartments in the Email service
+* Support for moving NAT gateway resources across compartments in Core Services
+
 ====================
 2.2.14 - 2019-06-18
 ====================

docs/api/core.rst

@@ -52,6 +52,7 @@ Core Services
     oci.core.models.CaptureConsoleHistoryDetails
     oci.core.models.ChangeBootVolumeBackupCompartmentDetails
     oci.core.models.ChangeBootVolumeCompartmentDetails
+    oci.core.models.ChangeNatGatewayCompartmentDetails
     oci.core.models.ChangeServiceGatewayCompartmentDetails
     oci.core.models.ChangeVolumeBackupCompartmentDetails
     oci.core.models.ChangeVolumeCompartmentDetails

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

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

docs/api/email.rst

@@ -18,6 +18,7 @@ Email
     :nosignatures:
     :template: autosummary/model_class.rst
 
+    oci.email.models.ChangeSenderCompartmentDetails
     oci.email.models.CreateSenderDetails
     oci.email.models.CreateSuppressionDetails
     oci.email.models.Sender

docs/api/email/models/oci.email.models.ChangeSenderCompartmentDetails.rst

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

examples/change_nat_gateway_compartment_example.py

@@ -0,0 +1,192 @@
+# coding: utf-8
+# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+
+# This sample will create the VCN where the NAT Gateway will be created, and create the NAT Gateway that
+# will be moved to a new compartment.  Cleanup of NAT gateway and VCN is performed after completion of
+# the change compartment operation.
+#
+# This script takes the following arguments
+#
+#    * The OCID of the compartment where the NAT gateway and related resources will be created
+#    * TThe OCID of the compartment where the NAT gateway will be moved to
+#
+# Usage :
+#    change_nat_gateway_compartment_example.py --src-compartment-id=<src compartment OCID>
+#                                           --dest-compartment-id=<dest compartment OCID>
+#
+#
+
+import argparse
+import oci
+from oci.core import VirtualNetworkClient
+from oci.core import VirtualNetworkClientCompositeOperations
+from oci.core.models import ChangeNatGatewayCompartmentDetails
+from oci.core.models import CreateNatGatewayDetails
+from oci.core.models import CreateVcnDetails
+from oci.core.models import Vcn
+from oci.core.models import NatGateway
+
+nat_gateway_id = None
+src_compartment_id = None
+dest_compartment_id = None
+virtual_network_client = None
+virtual_network_client_composite_ops = None
+vcn_id = None
+
+
+# Sets up the service client used to perform the operations
+def setup_client():
+    global virtual_network_client
+    global virtual_network_client_composite_ops
+
+    # read oci config
+    config = oci.config.from_file()
+
+    # Create Virtual Network Client with configuration
+    virtual_network_client = VirtualNetworkClient(config)
+
+    # Create Virtual Network Client with configuration for composite operations
+    virtual_network_client_composite_ops = VirtualNetworkClientCompositeOperations(virtual_network_client)
+
+
+# Creates VCN and waits for it to become available
+def create_vcn():
+    global virtual_network_client_composite_ops
+    global vcn_id
+
+    # setup create vcn details
+    create_vcn_details = CreateVcnDetails()
+    create_vcn_details.cidr_block = '10.0.0.0/16'
+    create_vcn_details.compartment_id = src_compartment_id
+    create_vcn_details.display_name = 'test_change_nat_gateway'
+
+    # create vcn
+    response = virtual_network_client_composite_ops.create_vcn_and_wait_for_state(create_vcn_details, wait_for_states=[Vcn.LIFECYCLE_STATE_AVAILABLE])
+    vcn_id = response.data.id
+    print("Created Vcn: " + vcn_id)
+    print("")
+
+
+# Creates NAT Gateway and waits for it to become available
+def create_nat_gateway():
+    global virtual_network_client_composite_ops
+    global nat_gateway_id
+    global vcn_id
+
+    print("Creating NAT Gateway")
+    print("=======================================")
+    # setup create nat gateway details
+    create_ngw_details = CreateNatGatewayDetails()
+    create_ngw_details.vcn_id = vcn_id
+    create_ngw_details.compartment_id = src_compartment_id
+    create_ngw_details.display_name = 'test_change_nat_gateway'
+
+    # create ngw
+    response = virtual_network_client_composite_ops.create_nat_gateway_and_wait_for_state(create_ngw_details, wait_for_states=[NatGateway.LIFECYCLE_STATE_AVAILABLE])
+    nat_gateway_id = response.data.id
+
+    print("Created NAT Gateway and waited for it to become available %s" % response.data)
+    print("")
+    print("")
+
+
+# Changes the compartment of the NAT Gateway
+def change_nat_gateway_compartment():
+    global virtual_network_client
+    global dest_compartment_id
+    global nat_gateway_id
+    print("Changing NAT Gateway's compartment")
+    print("=======================================")
+    # setup change compartment details
+    change_compartment_details = ChangeNatGatewayCompartmentDetails()
+    change_compartment_details.compartment_id = dest_compartment_id
+
+    virtual_network_client.change_nat_gateway_compartment(nat_gateway_id, change_compartment_details)
+    changedNatGateway = get_nat_gateway()
+    print("NAT Gateway's compartment has been changed: %s" % changedNatGateway.data)
+    print("")
+    print("")
+
+
+# Gets the NAT Gateway
+def get_nat_gateway():
+    global virtual_network_client
+    global nat_gateway_id
+
+    response = virtual_network_client.get_nat_gateway(nat_gateway_id)
+    return response
+
+
+# Deletes the NAT Gateway and waits for it to become terminated
+def delete_nat_gateway():
+    global virtual_network_client_composite_ops
+    global nat_gateway_id
+
+    virtual_network_client_composite_ops.delete_nat_gateway_and_wait_for_state(nat_gateway_id, wait_for_states=[NatGateway.LIFECYCLE_STATE_TERMINATED])
+
+
+# Deletes the VCN and waits for it to become terminated
+def delete_vcn():
+    global virtual_network_client_composite_ops
+    global vcn_id
+
+    virtual_network_client_composite_ops.delete_vcn_and_wait_for_state(vcn_id, wait_for_states=[Vcn.LIFECYCLE_STATE_TERMINATED])
+
+
+# Parses the command line
+def parse_command_line():
+    global src_compartment_id
+    global dest_compartment_id
+
+    # parse arguments
+    parser = argparse.ArgumentParser()
+    parser.add_argument('--src-compartment-id',
+                        help='source compartment ID in which to create and change nat gateway from',
+                        required=True
+                        )
+    parser.add_argument('--dest-compartment-id',
+                        help='destination compartment ID where the nat gateway should be moved',
+                        required=True
+                        )
+    args = parser.parse_args()
+    src_compartment_id = args.src_compartment_id
+    dest_compartment_id = args.dest_compartment_id
+
+
+def perform_change_compartment():
+    global nat_gateway_id
+    global vcn_id
+
+    try:
+        print("")
+        print("Performing operations to change NAT Gateway compartment from %s to %s" % (src_compartment_id, dest_compartment_id))
+        print("")
+        setup_client()
+        # A VCN is required to create a NAT Gateway
+        create_vcn()
+        # Here we demonstrate:
+        #
+        #      - Creating a NAT gateway
+        #      - Changing the NAT gateway's compartment
+        #
+        # And we'll delete these resources when we're done
+        #
+        create_nat_gateway()
+        change_nat_gateway_compartment()
+
+    except Exception as e:
+        print("[ERROR]: Error during change nat gateway example execution : %s" % e)
+    finally:
+        print("Clean Up")
+        print("===========")
+        if nat_gateway_id:
+            delete_nat_gateway()
+            print("Deleted NAT Gateway")
+        if vcn_id:
+            delete_vcn()
+            print("Deleted VCN")
+
+
+if __name__ == '__main__':
+    parse_command_line()
+    perform_change_compartment()

examples/email_service_example.py

@@ -4,15 +4,16 @@
 # This script provides a basic example of how to use the Email Service in the Python SDK. This script accepts two
 # will demonstrate:
 #
-#   * Creating, retrieving, listing and deleting email senders
+#   * Creating, retrieving, moving, listing and deleting email senders
 #   * Creating, retrieving, listing and deleting email suppressions
 #   * Obtaining SMTP credentials for your IAM user so that you can send emails.
 #     See https://docs.cloud.oracle.com/Content/Email/Tasks/configuresmtpconnection.htm for more
 #     information on sending emails
 #
-# This script accepts three arguments:
+# This script accepts four arguments:
 #
 #   * The compartment ID where email senders will be created
+#   * The target compartment ID where email senders will be moved to
 #   * The address of the email sender
 #   * The address of the email suppression
 #
@@ -27,13 +28,14 @@
 email_client = oci.email.EmailClient(config)
 identity_client = oci.identity.IdentityClient(config)
 
-if len(sys.argv) != 4:
-    raise RuntimeError('This script expects an argument of a compartment OCID, sender email address and suppression email address')
+if len(sys.argv) != 5:
+    raise RuntimeError('This script expects an argument of a compartment OCID, a target compartment OCID, sender email address and suppression email address')
 
 # The first argument is the name of the script, so start the index at 1
 compartment_id = sys.argv[1]
-sender_address = sys.argv[2]
-suppression_address = sys.argv[3]
+target_compartment_id = sys.argv[2]
+sender_address = sys.argv[3]
+suppression_address = sys.argv[4]
 
 create_sender_response = email_client.create_sender(
     oci.email.models.CreateSenderDetails(
@@ -49,6 +51,16 @@
 print('Waited for sender to become available:\n{}'.format(get_sender_response.data))
 print('\n=========================\n')
 
+# change sender compartment
+change_sender_response = email_client.change_sender_compartment(
+    create_sender_response.data.id,
+    oci.email.models.ChangeSenderCompartmentDetails(
+        compartment_id=target_compartment_id
+    )
+)
+print('Moved sender:\n{}'.format(create_sender_response.data.id))
+print('\n=========================\n')
+
 # We can list all senders, and also provide optional filters and sorts. Here we'll list all
 # senders sorted by their email address, and also demonstrate filtering by sender email
 # address (an exact match filter)

examples/showoci/CHANGELOG.rst

@@ -4,6 +4,30 @@ All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`_.
 
+====================
+19.6.24 - 2019-06-24
+====================
+Added
+-----
+* Added Freeform Tags and Defined Tages to the Compute and Database CSVs extract
+
+====================
+19.6.17 - 2019-06-17
+====================
+Added
+-----
+* Support to extract to CSV using -csv, currently supported IAM Groups and Policies, Network, Load Balancers and Databases
+* Added subnet IP for the database node
+* Added Shape base OCPU, Memory and local storage to instances and databases
+* Added host+rules+path for load balancer listeners
+* Added Support for Exadata.Base.48
+
+Fixed
+-----
+* Several Bugs
+* Fix Instances + db_node VNIC information
+* Fix All ports display at network security list
+
 ====================
 19.6.10 - 2019-06-10
 ====================