Releasing version 2.2.4

Releasing version 2.2.4

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.4 - 2019-03-26
+====================
+
+Added
+-----
+* Support for glob patterns and exclusions for object lifecycle management in the Object Storage service
+* Documentation enhancements and corrections for traffic management in the DNS service
+
 ====================
 2.2.3 - 2019-03-19
 ====================

docs/api/object_storage.rst

@@ -34,6 +34,7 @@ Object Storage
     oci.object_storage.models.ObjectLifecycleRule
     oci.object_storage.models.ObjectNameFilter
     oci.object_storage.models.ObjectSummary
+    oci.object_storage.models.PatternDetails
     oci.object_storage.models.PreauthenticatedRequest
     oci.object_storage.models.PreauthenticatedRequestSummary
     oci.object_storage.models.PutObjectLifecyclePolicyDetails

docs/api/object_storage/models/oci.object_storage.models.PatternDetails.rst

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

src/oci/config.py

@@ -92,9 +92,10 @@ def from_file(file_location=DEFAULT_LOCATION, profile_name=DEFAULT_PROFILE):
 
 def validate_config(config, **kwargs):
     if 'signer' in kwargs:
-        # The InstancePrincipalsSecurityTokenSigner is self-sufficient and doesn't need to read
-        # the normally-required keys in the config
-        if isinstance(kwargs['signer'], signers.InstancePrincipalsSecurityTokenSigner):
+        # InstancePrincipalsSecurityTokenSigner and  SecurityTokenSigner are
+        # self-sufficient and do not need to read the normally-required keys
+        # in the config
+        if isinstance(kwargs['signer'], signers.InstancePrincipalsSecurityTokenSigner) or isinstance(kwargs['signer'], signers.SecurityTokenSigner):
             return
 
     """Raises ValueError if required fields are missing or malformed."""

src/oci/dns/dns_client.py

@@ -82,7 +82,10 @@ def __init__(self, config, **kwargs):
 
     def create_steering_policy(self, create_steering_policy_details, **kwargs):
         """
-        Creates a new steering policy in the specified compartment.
+        Creates a new steering policy in the specified compartment. For more information on
+        creating policies with templates, see `Traffic Management API Guide`__.
+
+        __ https://docs.cloud.oracle.com/iaas/Content/TrafficManagement/Concepts/trafficmanagementapi.htm
 
 
         :param CreateSteeringPolicyDetails create_steering_policy_details: (required)
@@ -151,9 +154,12 @@ def create_steering_policy(self, create_steering_policy_details, **kwargs):
 
     def create_steering_policy_attachment(self, create_steering_policy_attachment_details, **kwargs):
         """
-        Creates a new attachment between a steering policy and a domain.
+        Creates a new attachment between a steering policy and a domain, giving the
+        policy permission to answer queries for the specified domain. A steering policy must
+        be attached to a domain for the policy to answer DNS queries for that domain.
+
         For the purposes of access control, the attachment is automatically placed
-        into the same compartment as the containing zone of the domain.
+        into the same compartment as the domain's zone.
 
 
         :param CreateSteeringPolicyAttachmentDetails create_steering_policy_attachment_details: (required)
@@ -493,7 +499,8 @@ def delete_steering_policy(self, steering_policy_id, **kwargs):
         """
         Deletes the specified steering policy.
         A `204` response indicates that the delete has been successful.
-        Deletion will fail if the policy is attached to any zones.
+        Deletion will fail if the policy is attached to any zones. To detach a
+        policy from a zone, see `DeleteSteeringPolicyAttachment`.
 
 
         :param str steering_policy_id: (required)
@@ -1470,7 +1477,7 @@ def list_steering_policies(self, compartment_id, **kwargs):
 
         :param str health_check_monitor_id: (optional)
             Search by health check monitor OCID.
-            Will match any resource whose health check monitor id matches the provided value.
+            Will match any resource whose health check monitor ID matches the provided value.
 
         :param datetime time_created_greater_than_or_equal_to: (optional)
             An `RFC 3339`__ timestamp that states
@@ -1485,7 +1492,7 @@ def list_steering_policies(self, compartment_id, **kwargs):
             __ https://www.ietf.org/rfc/rfc3339.txt
 
         :param str template: (optional)
-            Search by template type.
+            Search by steering template type.
             Will match any resource whose template type matches the provided value.
 
         :param str lifecycle_state: (optional)
@@ -1494,7 +1501,7 @@ def list_steering_policies(self, compartment_id, **kwargs):
             Allowed values are: "ACTIVE", "CREATING", "DELETED", "DELETING"
 
         :param str sort_by: (optional)
-            The field by which to sort steering policies.
+            The field by which to sort steering policies. If unspecified, defaults to `timeCreated`.
 
             Allowed values are: "displayName", "timeCreated", "template"
 
@@ -1623,11 +1630,11 @@ def list_steering_policy_attachments(self, compartment_id, **kwargs):
 
         :param str steering_policy_id: (optional)
             Search by steering policy OCID.
-            Will match any resource whose steering policy id matches the provided value.
+            Will match any resource whose steering policy ID matches the provided value.
 
         :param str zone_id: (optional)
             Search by zone OCID.
-            Will match any resource whose zone id matches the provided value.
+            Will match any resource whose zone ID matches the provided value.
 
         :param str domain: (optional)
             Search by domain.
@@ -1655,7 +1662,7 @@ def list_steering_policy_attachments(self, compartment_id, **kwargs):
             Allowed values are: "CREATING", "ACTIVE", "DELETING"
 
         :param str sort_by: (optional)
-            The field by which to sort steering policy attachments.
+            The field by which to sort steering policy attachments. If unspecified, defaults to `timeCreated`.
 
             Allowed values are: "displayName", "timeCreated", "domainName"
 
@@ -1923,7 +1930,10 @@ def list_zones(self, compartment_id, **kwargs):
 
     def patch_domain_records(self, zone_name_or_id, domain, patch_domain_records_details, **kwargs):
         """
-        Updates records in the specified zone at a domain. You can update one record or all records for the specified zone depending on the changes provided in the request body. You can also add or remove records using this function.
+        Updates records in the specified zone at a domain. You can update
+        one record or all records for the specified zone depending on the changes
+        provided in the request body. You can also add or remove records using this
+        function.
 
 
         :param str zone_name_or_id: (required)
@@ -2460,7 +2470,7 @@ def update_rr_set(self, zone_name_or_id, domain, rtype, update_rr_set_details, *
 
     def update_steering_policy(self, steering_policy_id, update_steering_policy_details, **kwargs):
         """
-        Updates the specified steering policy with your new information.
+        Updates the configuration of the specified steering policy.
 
 
         :param str steering_policy_id: (required)

src/oci/dns/models/create_steering_policy_attachment_details.py

@@ -10,12 +10,9 @@
 class CreateSteeringPolicyAttachmentDetails(object):
     """
     The body for defining an attachment between a steering policy and a domain.
-    An attachment occludes all records at its domain that are of a covered rtype, constructing
-    DNS responses from its steering policy rather than from those domain records.
-    The attachment will cover every rtype that matches the rtype of an answer in its policy, and
-    will cover all address rtypes (e.g., A and AAAA) if the policy includes at least one CNAME
-    answer.
-    A domain can have at most one attachment covering any given rtype.
+
+
+    **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
     """
 
     def __init__(self, **kwargs):
@@ -136,7 +133,7 @@ def display_name(self):
         """
         Gets the display_name of this CreateSteeringPolicyAttachmentDetails.
         A user-friendly name for the steering policy attachment.
-        Does not have to be unique, and it's changeable.
+        Does not have to be unique and can be changed.
         Avoid entering confidential information.
 
 
@@ -150,7 +147,7 @@ def display_name(self, display_name):
         """
         Sets the display_name of this CreateSteeringPolicyAttachmentDetails.
         A user-friendly name for the steering policy attachment.
-        Does not have to be unique, and it's changeable.
+        Does not have to be unique and can be changed.
         Avoid entering confidential information.