Merge branch 'release-1.38.4'

* release-1.38.4: Bumping version to 1.38.4 Update changelog based on model updates CLI examples for ec2, ecs, ivs-realtime, lambda (#9179)
aws · Feb 28, 2025 · c29ffae · c29ffae
2 parents cbfb5d5 + 6b3656c
commit c29ffae
Show file tree

Hide file tree

Showing 15 changed files with 360 additions and 27 deletions.
diff --git a/.changes/1.38.4.json b/.changes/1.38.4.json
@@ -0,0 +1,42 @@
+[
+  {
+    "category": "``bedrock-agent``",
+    "description": "This release lets Amazon Bedrock Flows support newer models by increasing the maximum length of output in a prompt configuration. This release also increases the maximum number of prompt variables to 20 and the maximum number of node inputs to 20.",
+    "type": "api-change"
+  },
+  {
+    "category": "``bedrock-data-automation``",
+    "description": "Renamed and added new StandardConfiguration enums. Added support to update EncryptionConfiguration in UpdateBlueprint and UpdateDataAutomation APIs. Changed HttpStatus code for DeleteBlueprint and DeleteDataAutomationProject APIs to 200 from 204. Added APIs to support tagging.",
+    "type": "api-change"
+  },
+  {
+    "category": "``bedrock-data-automation-runtime``",
+    "description": "Added a mandatory parameter DataAutomationProfileArn to support for cross region inference for InvokeDataAutomationAsync API. Renamed DataAutomationArn to DataAutomationProjectArn. Added APIs to support tagging.",
+    "type": "api-change"
+  },
+  {
+    "category": "``dms``",
+    "description": "Add skipped status to the Result Statistics of an Assessment Run",
+    "type": "api-change"
+  },
+  {
+    "category": "``eks``",
+    "description": "Adding licenses to EKS Anywhere Subscription operations response.",
+    "type": "api-change"
+  },
+  {
+    "category": "``mediaconvert``",
+    "description": "The AWS MediaConvert Probe API allows you to analyze media files and retrieve detailed metadata about their content, format, and structure.",
+    "type": "api-change"
+  },
+  {
+    "category": "``pricing``",
+    "description": "Update GetProducts and DescribeServices API request input validations.",
+    "type": "api-change"
+  },
+  {
+    "category": "``ssm``",
+    "description": "Systems Manager doc-only updates for Feb. 2025.",
+    "type": "api-change"
+  }
+]
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -2,6 +2,19 @@
 CHANGELOG
 =========
 
+1.38.4
+======
+
+* api-change:``bedrock-agent``: This release lets Amazon Bedrock Flows support newer models by increasing the maximum length of output in a prompt configuration. This release also increases the maximum number of prompt variables to 20 and the maximum number of node inputs to 20.
+* api-change:``bedrock-data-automation``: Renamed and added new StandardConfiguration enums. Added support to update EncryptionConfiguration in UpdateBlueprint and UpdateDataAutomation APIs. Changed HttpStatus code for DeleteBlueprint and DeleteDataAutomationProject APIs to 200 from 204. Added APIs to support tagging.
+* api-change:``bedrock-data-automation-runtime``: Added a mandatory parameter DataAutomationProfileArn to support for cross region inference for InvokeDataAutomationAsync API. Renamed DataAutomationArn to DataAutomationProjectArn. Added APIs to support tagging.
+* api-change:``dms``: Add skipped status to the Result Statistics of an Assessment Run
+* api-change:``eks``: Adding licenses to EKS Anywhere Subscription operations response.
+* api-change:``mediaconvert``: The AWS MediaConvert Probe API allows you to analyze media files and retrieve detailed metadata about their content, format, and structure.
+* api-change:``pricing``: Update GetProducts and DescribeServices API request input validations.
+* api-change:``ssm``: Systems Manager doc-only updates for Feb. 2025.
+
+
 1.38.3
 ======
 

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

diff --git a/awscli/examples/ec2/allocate-address.rst b/awscli/examples/ec2/allocate-address.rst
@@ -53,4 +53,25 @@ Output::
         "NetworkBorderGroup": "us-west-2",
     }
 
-For more information, see `Elastic IP addresses <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html>`__ in the *Amazon EC2 User Guide*.
+For more information, see `Elastic IP addresses <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html>`__ in the *Amazon EC2 User Guide*.
+
+**Example 4: To allocate an Elastic IP address from an IPAM pool**
+
+The following ``allocate-address`` example allocates a specific /32 Elastic IP address from an Amazon VPC IP Address Manager (IPAM) pool. ::
+
+    aws ec2 allocate-address \
+        --region us-east-1 \
+        --ipam-pool-id ipam-pool-1234567890abcdef0 \
+        --address 192.0.2.0
+
+Output::
+
+    {                                                    
+        "PublicIp": "192.0.2.0",                        
+        "AllocationId": "eipalloc-abcdef01234567890",    
+        "PublicIpv4Pool": "ipam-pool-1234567890abcdef0", 
+        "NetworkBorderGroup": "us-east-1",               
+        "Domain": "vpc"                                  
+    }                                                    
+
+For more information, see `Allocate sequential Elastic IP addresses from an IPAM pool <https://docs.aws.amazon.com/vpc/latest/ipam/tutorials-eip-pool.html>`__ in the *Amazon VPC IPAM User Guide*.
diff --git a/awscli/examples/ecs/wait/services-inactive.rst b/awscli/examples/ecs/wait/services-inactive.rst
@@ -0,0 +1,9 @@
+**Wait until an ECS service becomes inactive**
+
+The following ``service-inactive`` example waits until ECS services becomes inactive in the cluster. ::
+
+    aws ecs wait services-inactive \
+        --cluster MyCluster \
+        --services MyService 
+
+This command produces no output.
diff --git a/awscli/examples/ecs/wait/task-stopped.rst b/awscli/examples/ecs/wait/task-stopped.rst
@@ -0,0 +1,22 @@
+**Example 1: Wait until an ECS task is in stopped state**
+
+The following ``wait tasks-stopped`` example waits until the provided tasks in the command are in a stopped state. You can pass IDs or full ARN of the tasks. This example uses ID of the task. ::
+
+    aws ecs wait tasks-stopped \
+        --cluster MyCluster \ 
+        --tasks 2c196f0a00dd4f58b7c8897a5c7bce13
+
+This command produces no output.
+
+**Example 2: Wait until multiple ECS tasks are in stopped state**
+
+The following ``wait tasks-stopped`` example waits until the multiple tasks provided in the command are in a stopped state. You can pass IDs or full ARN of the tasks. This example uses IDs of the tasks. ::
+
+    aws ecs wait tasks-stopped \
+        --cluster MyCluster \ 
+        --tasks 2c196f0a00dd4f58b7c8897a5c7bce13 4d590253bb114126b7afa7b58EXAMPLE
+
+This command produces no output.
+
+
+
diff --git a/awscli/examples/ivs-realtime/create-stage.rst b/awscli/examples/ivs-realtime/create-stage.rst
@@ -19,11 +19,24 @@ Output::
         "stage": {
             "activeSessionId": "st-a1b2c3d4e5f6g",
             "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
+            "autoParticipantRecordingConfiguration": {
+                "storageConfigurationArn": "",
+                "mediaTypes": [
+                    "AUDIO_VIDEO"
+                ],
+                "thumbnailConfiguration": {
+                    "targetIntervalSeconds": 60,
+                    "storage": [
+                        "SEQUENTIAL"
+                    ],
+                    "recordingMode": "DISABLED"
+                }
+            },
             "endpoints": {
                 "events": "wss://global.events.live-video.net",
                 "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
                 "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
-                "whip": "https://1a2b3c4d5e6f.global-bm.whip.live-video.net"
+                "whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
             },
             "name": "stage1",
             "tags": {}
@@ -47,20 +60,68 @@ Output::
             "activeSessionId": "st-a1b2c3d4e5f6g",
             "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
             "autoParticipantRecordingConfiguration": {
-                 "mediaTypes": [
-                       "AUDIO_VIDEO"
-                 ],
-                 "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
-            },
+                "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh"
+                "mediaTypes": [
+                    "AUDIO_VIDEO"
+                ],
+                "thumbnailConfiguration": {
+                    "targetIntervalSeconds": 60,
+                    "storage": [
+                        "SEQUENTIAL"
+                    ],
+                    "recordingMode": "DISABLED"
+                }
+            },            
             "endpoints": {
                 "events": "wss://global.events.live-video.net",
                 "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
                 "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
-                "whip": "https://1a2b3c4d5e6f.global-bm.whip.live-video.net"
+                "whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
             },
             "name": "stage1",
             "tags": {}
         }
     }
 
 For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon Interactive Video Service User Guide*.
+
+**Example 3: To create a stage and configure individial participant recording with thumbnail recording enabled**
+
+The following ``create-stage`` example creates a stage and configures individual participant recording with thumbnail recording enabled. ::
+
+    aws ivs-realtime create-stage \
+        --name stage1 \
+        --auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", \
+            "thumbnailConfiguration": {"recordingMode": "INTERVAL","storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}}'
+
+Output::
+
+    {
+        "stage": { 
+            "activeSessionId": "st-a1b2c3d4e5f6g",
+            "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
+            "autoParticipantRecordingConfiguration": {
+                "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
+                "mediaTypes": [
+                    "AUDIO_VIDEO"
+                ],
+                "thumbnailConfiguration": { 
+                    "targetIntervalSeconds": 60,
+                    "storage": [
+                        "SEQUENTIAL"
+                    ],
+                    "recordingMode": "INTERVAL"
+                }
+            },            
+            "endpoints": {
+                "events": "wss://global.events.live-video.net",
+                "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
+                "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
+                "whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
+            },
+            "name": "stage1",
+            "tags": {}
+        }
+    }
+
+For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon Interactive Video Service User Guide*.
diff --git a/awscli/examples/ivs-realtime/get-composition.rst b/awscli/examples/ivs-realtime/get-composition.rst
@@ -33,7 +33,7 @@ Output::
                             "recordingConfiguration": {
                                 "format": "HLS"
                             },
-                            "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"
+                            "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE",
                         }
                     },
                     "detail": {
@@ -130,4 +130,77 @@ Output::
         }
     }
 
+For more information, see `Composite Recording (Real-Time Streaming) <https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html>`__ in the *Amazon Interactive Video Service User Guide*.
+
+**Example 3: To get a composition with thumbnail recording enabled**
+
+The following ``get-composition`` example gets the composition for the ARN (Amazon Resource Name) specified, which has thumbnail recording enabled with default settings. ::
+
+    aws ivs-realtime get-composition \
+        --arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh"
+
+Output::
+
+    {
+        "composition": {
+            "arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
+            "destinations": [
+                {
+                    "configuration": {
+                        "channel": {
+                            "channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
+                            "encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
+                        },
+                        "name": ""
+                    },
+                    "id": "AabBCcdDEefF",
+                    "startTime": "2023-10-16T23:26:00+00:00",
+                    "state": "ACTIVE"
+                },
+                {
+                    "configuration": {
+                        "name": "",
+                        "s3": {
+                            "encoderConfigurationArns": [
+                                "arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
+                            ],
+                            "recordingConfiguration": {
+                                "format": "HLS"
+                            },
+                            "storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE",
+                            "thumbnailConfigurations": [
+                               {
+                                  "targetIntervalSeconds": 60,
+                                  "storage": [
+                                      "SEQUENTIAL"
+                                  ],
+                               }
+                            ]
+                        }
+                    },
+                    "detail": {
+                        "s3": {
+                            "recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
+                        }
+                    },
+                    "id": "GHFabcgefABC",
+                    "startTime": "2023-10-16T23:26:00+00:00",
+                    "state": "STARTING"
+                }
+            ],
+            "layout": {
+                "grid": {
+                    "featuredParticipantAttribute": ""
+                    "gridGap": 2,
+                    "omitStoppedVideo": false,
+                    "videoAspectRatio": "VIDEO",
+                    "videoFillMode": ""                }
+            },
+            "stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
+            "startTime": "2023-10-16T23:24:00+00:00",
+            "state": "ACTIVE",
+            "tags": {}
+        }
+    }
+
 For more information, see `Composite Recording (Real-Time Streaming) <https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html>`__ in the *Amazon Interactive Video Service User Guide*.
diff --git a/awscli/examples/ivs-realtime/get-stage.rst b/awscli/examples/ivs-realtime/get-stage.rst
@@ -12,20 +12,27 @@ Output::
             "activeSessionId": "st-a1b2c3d4e5f6g",
             "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
             "autoParticipantRecordingConfiguration": {
+                 "storageConfigurationArn": "",
                  "mediaTypes": [
-                       "AUDIO_VIDEO"
+                     "AUDIO_VIDEO"
                  ],
-                 "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
-            },
+                 "thumbnailConfiguration": {
+                     "targetIntervalSeconds": 60,
+                     "storage": [
+                         "SEQUENTIAL"
+                     ],
+                     "recordingMode": "DISABLED",
+                 }
+            },            
             "endpoints": {
                 "events": "wss://global.events.live-video.net",
                 "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
                 "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
-                "whip": "https://1a2b3c4d5e6f.global-bm.whip.live-video.net"
+                "whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
             },
             "name": "test",
             "tags": {}
         }
     }
 
-For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon Interactive Video Service User Guide*.
+For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon Interactive Video Service User Guide*.