Merge branch 'release-1.28.1'

* release-1.28.1: Bumping version to 1.28.1 Update changelog based on model updates Add --query example for describe-instance-patches
aws · Jul 5, 2023 · 0135ae9 · 0135ae9
2 parents 8fcc79a + 9c7f0cc
commit 0135ae9
Show file tree

Hide file tree

Showing 7 changed files with 81 additions and 18 deletions.
diff --git a/.changes/1.28.1.json b/.changes/1.28.1.json
@@ -0,0 +1,27 @@
+[
+  {
+    "category": "``comprehendmedical``",
+    "description": "Update to Amazon Comprehend Medical documentation.",
+    "type": "api-change"
+  },
+  {
+    "category": "``connect``",
+    "description": "GetMetricDataV2 API: Channels filters do not count towards overall limitation of 100 filter values.",
+    "type": "api-change"
+  },
+  {
+    "category": "``kms``",
+    "description": "Added Dry Run Feature to cryptographic and cross-account mutating KMS APIs (14 in all). This feature allows users to test their permissions and parameters before making the actual API call.",
+    "type": "api-change"
+  },
+  {
+    "category": "``mgn``",
+    "description": "This release introduces the Global view feature and new Replication state APIs.",
+    "type": "api-change"
+  },
+  {
+    "category": "``securityhub``",
+    "description": "Documentation updates for AWS Security Hub",
+    "type": "api-change"
+  }
+]
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -2,6 +2,16 @@
 CHANGELOG
 =========
 
+1.28.1
+======
+
+* api-change:``comprehendmedical``: Update to Amazon Comprehend Medical documentation.
+* api-change:``connect``: GetMetricDataV2 API: Channels filters do not count towards overall limitation of 100 filter values.
+* api-change:``kms``: Added Dry Run Feature to cryptographic and cross-account mutating KMS APIs (14 in all). This feature allows users to test their permissions and parameters before making the actual API call.
+* api-change:``mgn``: This release introduces the Global view feature and new Replication state APIs.
+* api-change:``securityhub``: Documentation updates for AWS Security Hub
+
+
 1.28.0
 ======
 

diff --git a/awscli/__init__.py b/awscli/__init__.py
@@ -17,7 +17,7 @@
 """
 import os
 
-__version__ = '1.28.0'
+__version__ = '1.28.1'
 
 #
 # Get our data path to be added to botocore's search path

diff --git a/awscli/examples/ssm/describe-instance-patches.rst b/awscli/examples/ssm/describe-instance-patches.rst
@@ -15,15 +15,15 @@ Output::
                 "Classification": "SecurityUpdates",
                 "Severity": "Critical",
                 "State": "Installed",
-                "InstalledTime": 1546992000.0
+                "InstalledTime": "2019-01-09T00:00:00+00:00"
             },
             {
                 "Title": "",
                 "KBId": "KB4481031",
                 "Classification": "",
                 "Severity": "",
                 "State": "InstalledOther",
-                "InstalledTime": 1549584000.0
+                "InstalledTime": "2019-02-08T00:00:00+00:00"
             },
             ...
         ],
@@ -41,18 +41,44 @@ The following ``describe-instance-patches`` example retrieves information about
 Output::
 
     {
-      "Patches": [
-          {
-              "Title": "Windows Malicious Software Removal Tool x64 - February 2019 (KB890830)",
-              "KBId": "KB890830",
-              "Classification": "UpdateRollups",
-              "Severity": "Unspecified",
-              "State": "Missing",
-              "InstalledTime": 0.0
-          },
-          ...
-      ],
-      "NextToken": "--token string truncated--"
+        "Patches": [
+            {
+                "Title": "Windows Malicious Software Removal Tool x64 - February 2019 (KB890830)",
+                "KBId": "KB890830",
+                "Classification": "UpdateRollups",
+                "Severity": "Unspecified",
+                "State": "Missing",
+                "InstalledTime": "1970-01-01T00:00:00+00:00"
+            },
+            ...
+        ],
+        "NextToken": "--token string truncated--"
     }
 
 For more information, see `About Patch Compliance States <https://docs.aws.amazon.com/systems-manager/latest/userguide/about-patch-compliance-states.html>`__ in the *AWS Systems Manager User Guide*.
+
+**Example 3: To get a list of patches installed since a specified InstalledTime for an instance**
+
+The following ``describe-instance-patches`` example retrieves information about patches installed since a specified time for the specified instance by combining the use of ``--filters`` and ``--query``. ::
+
+    aws ssm describe-instance-patches \
+        --instance-id "i-1234567890abcdef0" \
+        --filters Key=State,Values=Installed \
+        --query "Patches[?InstalledTime >= `2023-01-01T16:00:00`]"
+
+Output::
+
+    {
+        "Patches": [
+            {
+                "Title": "2023-03 Cumulative Update for Windows Server 2019 (1809) for x64-based Systems (KB5023702)",
+                "KBId": "KB5023702",
+                "Classification": "SecurityUpdates",
+                "Severity": "Critical",
+                "State": "Installed",
+                "InstalledTime": "2023-03-16T11:00:00+00:00"
+            },
+            ...
+        ],
+        "NextToken": "--token string truncated--"
+    }
diff --git a/doc/source/conf.py b/doc/source/conf.py
@@ -52,7 +52,7 @@
 # The short X.Y version.
 version = '1.28'
 # The full version, including alpha/beta/rc tags.
-release = '1.28.0'
+release = '1.28.1'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

diff --git a/setup.cfg b/setup.cfg
@@ -3,7 +3,7 @@ universal = 0
 
 [metadata]
 requires_dist =
-        botocore==1.30.0
+        botocore==1.30.1
         docutils>=0.10,<0.17
         s3transfer>=0.6.0,<0.7.0
         PyYAML>=3.10,<5.5

diff --git a/setup.py b/setup.py
@@ -24,7 +24,7 @@ def find_version(*file_paths):
 
 
 install_requires = [
-    'botocore==1.30.0',
+    'botocore==1.30.1',
     'docutils>=0.10,<0.17',
     's3transfer>=0.6.0,<0.7.0',
     'PyYAML>=3.10,<5.5',