awscli 1.40.17__py3-none-any.whl → 1.44.26__py3-none-any.whl

awscli/examples/eks/list-associated-access-policies.rst

@@ -0,0 +1,27 @@
+**To list the access policies associated with an access entry**
+
+The following ``list-associated-access-policies`` example returns the list of access policies associated with an access entry in the EKS cluster. ::
+
+    aws eks list-associated-access-policies \
+        --cluster-name eks-customer \
+        --principal-arn arn:aws:iam::111122223333:role/Admin
+
+Output::
+
+    {
+        "associatedAccessPolicies": [
+            {
+                "policyArn": "arn:aws:eks::aws:cluster-access-policy/AmazonEKSAdminPolicy",
+                "accessScope": {
+                    "type": "cluster",
+                    "namespaces": []
+                },
+                "associatedAt": "2025-05-24T17:26:22.935000-05:00",
+                "modifiedAt": "2025-05-24T17:26:22.935000-05:00"
+            }
+        ],
+        "clusterName": "eks-customer",
+        "principalArn": "arn:aws:iam::111122223333:role/Admin"
+    }
+
+For more information, see `Grant IAM users access to Kubernetes with EKS access entries <https://docs.aws.amazon.com/eks/latest/userguide/access-entries.html>`__ in the *Amazon EKS User Guide*.

awscli/examples/eks/list-insights.rst

@@ -0,0 +1,67 @@
+**To list all insights for the specified cluster**
+
+The following ``list-insights`` example returns the list of all insights checked against the specified cluster. ::
+
+    aws eks list-insights \
+    --cluster-name eks-customer
+
+Output::
+
+    {
+        "insights": [
+            {
+                "id": "38ea7a64-a14f-4e0e-95c7-8dbcab3c3616",
+                "name": "Kubelet version skew",
+                "category": "UPGRADE_READINESS",
+                "kubernetesVersion": "1.33",
+                "lastRefreshTime": "2025-05-24T11:22:50-05:00",
+                "lastTransitionTime": "2025-05-24T11:22:50-05:00",
+                "description": "Checks for kubelet versions of worker nodes in the cluster to see if upgrade would cause noncompliance with supported Kubernetes kubelet version skew policy.",
+                "insightStatus": {
+                    "status": "PASSING",
+                    "reason": "Node kubelet versions match the cluster control plane version."
+                }
+            },
+            {
+                "id": "9cd91472-f99c-45a9-b7d7-54d4900dee23",
+                "name": "EKS add-on version compatibility",
+                "category": "UPGRADE_READINESS",
+                "kubernetesVersion": "1.33",
+                "lastRefreshTime": "2025-05-24T11:22:59-05:00",
+                "lastTransitionTime": "2025-05-24T11:22:50-05:00",
+                "description": "Checks version of installed EKS add-ons to ensure they are compatible with the next version of Kubernetes. ",
+                "insightStatus": {
+                    "status": "PASSING",
+                    "reason": "All installed EKS add-on versions are compatible with next Kubernetes version."
+                }
+            },
+            {
+                "id": "0deb269d-b1e1-458c-a2b4-7a57f940c875",
+                "name": "Cluster health issues",
+                "category": "UPGRADE_READINESS",
+                "kubernetesVersion": "1.33",
+                "lastRefreshTime": "2025-05-24T11:22:59-05:00",
+                "lastTransitionTime": "2025-05-24T11:22:50-05:00",
+                "description": "Checks for any cluster health issues that prevent successful upgrade to the next Kubernetes version on EKS.",
+                "insightStatus": {
+                    "status": "PASSING",
+                    "reason": "No cluster health issues detected."
+                }
+            },
+            {
+                "id": "214fa274-344f-420b-812a-5049ce72c9ww",
+                "name": "kube-proxy version skew",
+                "category": "UPGRADE_READINESS",
+                "kubernetesVersion": "1.33",
+                "lastRefreshTime": "2025-05-24T11:22:50-05:00",
+                "lastTransitionTime": "2025-05-24T11:22:50-05:00",
+                "description": "Checks version of kube-proxy in cluster to see if upgrade would cause noncompliance with supported Kubernetes kube-proxy version skew policy.",
+                "insightStatus": {
+                    "status": "PASSING",
+                    "reason": "kube-proxy versions match the cluster control plane version."
+                }
+            }
+        ]
+    }
+
+For more information, see `View cluster insights <https://docs.aws.amazon.com/eks/latest/userguide/view-cluster-insights.html>`__ in the *Amazon EKS User Guide*.

awscli/examples/eks/list-pod-identity-associations.rst

@@ -0,0 +1,61 @@
+**Example 1: To list the Pod Identity associations in an EKS cluster**
+
+The following ``list-pod-identity-associations`` returns the list of Pod Identity associations associated with the EKS cluster named ``eks-customer`` in all namespaces and service accounts. ::
+
+    aws eks list-pod-identity-associations \
+        --cluster-name eks-customer
+
+Output::
+
+    {
+        "associations": [
+            {
+                "clusterName": "eks-customer",
+                "namespace": "default",
+                "serviceAccount": "default",
+                "associationArn": "arn:aws:eks:us-west-2:111122223333:podidentityassociation/eks-customer/a-9njjin9gfghecgocd",
+                "associationId": "a-9njjin9gfghecgocd"
+            },
+            {
+                "clusterName": "eks-customer",
+                "namespace": "kube-system",
+                "serviceAccount": "eks-customer",
+                "associationArn": "arn:aws:eks:us-west-2:111122223333:podidentityassociation/eks-customer/a-dvtacahdvjn01ffbc",
+                "associationId": "a-dvtacahdvjn01ffbc"
+            },
+            {
+                "clusterName": "eks-customer",
+                "namespace": "kube-system",
+                "serviceAccount": "coredns",
+                "associationArn": "arn:aws:eks:us-west-2:111122223333:podidentityassociation/eks-customer/a-yrpsdroc4ei7k6xps",
+                "associationId": "a-yrpsdroc4ei7k6xps"
+            }
+        ]
+    }
+
+For more information, see `Learn how EKS Pod Identity grants pods access to AWS services <https://docs.aws.amazon.com/eks/latest/userguide/pod-identities.html>`__ in the *Amazon EKS User Guide*.
+
+**Example 2: To list the Pod Identity associations in an EKS cluster based on namespace and service account**
+
+The following ``list-pod-identity-associations`` returns the list of Pod Identity associations in the EKS cluster based on namespace and service account. ::
+
+    aws eks list-pod-identity-associations \
+        --cluster-name eks-customer \
+        --namespace kube-system \
+        --service-account eks-customer
+
+Output::
+
+    {
+        "associations": [
+            {
+                "clusterName": "eks-customer",
+                "namespace": "kube-system",
+                "serviceAccount": "eks-customer",
+                "associationArn": "arn:aws:eks:us-west-2:111122223333:podidentityassociation/eks-customer/a-dvtacahdvjn01ffbc",
+                "associationId": "a-dvtacahdvjn01ffbc"
+            }
+        ]
+    }
+
+For more information, see `Learn how EKS Pod Identity grants pods access to AWS services <https://docs.aws.amazon.com/eks/latest/userguide/pod-identities.html>`__ in the *Amazon EKS User Guide*.

awscli/examples/eks/update-access-entry.rst

@@ -0,0 +1,28 @@
+**To update an access entry for an EKS cluster**
+
+The following ``update-access-entry`` updates an access entry for the EKS cluster by adding the Kubernetes group ``tester``. ::
+
+    aws eks update-access-entry \
+        --cluster-name eks-customer \
+        --principal-arn arn:aws:iam::111122223333:role/Admin \
+        --kubernetes-groups tester
+
+Output::
+
+    {
+        "accessEntry": {
+            "clusterName": "eks-customer",
+            "principalArn": "arn:aws:iam::111122223333:role/Admin",
+            "kubernetesGroups": [
+                "tester"
+            ],
+            "accessEntryArn": "arn:aws:eks:us-west-2:111122223333:access-entry/eks-customer/role/111122223333/Admin/d2cb8183-d6ec-b82a-d967-eca21902a4b4",
+            "createdAt": "2025-05-24T11:02:04.432000-05:00",
+            "modifiedAt": "2025-05-24T17:08:01.608000-05:00",
+            "tags": {},
+            "username": "arn:aws:sts::111122223333:assumed-role/Admin/{{SessionName}}",
+            "type": "STANDARD"
+        }
+    }
+
+For more information, see `Update access entries <https://docs.aws.amazon.com/eks/latest/userguide/updating-access-entries.html>`__ in the *Amazon EKS User Guide*.

awscli/examples/eks/update-pod-identity-association.rst

@@ -0,0 +1,29 @@
+**To update the EKS Pod Identity association**
+
+The following ``update-pod-identity-association`` example updates an EKS Pod Identity association by changing the associated IAM role from ``arn:aws:iam::111122223333:role/my-role`` to ``arn:aws:iam::111122223333:role/s3-role`` for association ID ``a-9njjin9gfghecgocd``. This API only allows updating the associated IAM role. ::
+
+    aws eks update-pod-identity-association \
+        --cluster-name eks-customer \
+        --association-id a-9njjin9gfghecgocd \
+        --role-arn arn:aws:iam::111122223333:role/s3-role
+
+Output::
+
+    {
+        "association": {
+            "clusterName": "eks-customer",
+            "namespace": "default",
+            "serviceAccount": "default",
+            "roleArn": "arn:aws:iam::111122223333:role/s3-role",
+            "associationArn": "arn:aws:eks:us-west-2:111122223333:podidentityassociation/eks-customer/a-9njjin9gfghecgocd",
+            "associationId": "a-9njjin9gfghecgocd",
+            "tags": {
+                "Key2": "value2",
+                "Key1": "value1"
+            },
+            "createdAt": "2025-05-24T19:52:14.135000-05:00",
+            "modifiedAt": "2025-05-25T21:01:53.120000-05:00"
+        }
+    }
+
+For more information, see `Learn how EKS Pod Identity grants pods access to AWS services <https://docs.aws.amazon.com/eks/latest/userguide/pod-identities.html>`__ in the *Amazon EKS User Guide*.

awscli/examples/elbv2/modify-listener.rst

@@ -1,86 +1,95 @@
-**Example 1: To change the default action to a forward action**
-
-The following ``modify-listener`` example changes the default action (to a **forward** action)for the specified listener. ::
-
-    aws elbv2 modify-listener \
-        --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \
-        --default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f
-
-Output::
-
-    {
-        "Listeners": [
-            {
-                "Protocol": "HTTP",
-                "DefaultActions": [
-                    {
-                        "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f",
-                        "Type": "forward"
-                    }
-                ],
-                "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188",
-                "Port": 80,
-                "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2"
-            }
-        ]
-    }
-
-**Example 2: To change the default action to a redirect action**
-
-The following ``modify-listener`` example changes the default action to a **redirect** action for the specified listener. ::
-
-    aws elbv2 modify-listener \
-        --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \
-        --default-actions Type=redirect,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f
-
-Output::
-
-    {
-    "Listeners": [
-        {
-            "Protocol": "HTTP",
-            "DefaultActions": [
-                {
-                    "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f",
-                    "Type": "redirect"
-                }
-            ],
-            "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188",
-            "Port": 80,
-            "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2"
-        }
-      ]
-    }
-
-**Example 3: To change the server certificate**
-
-This example changes the server certificate for the specified HTTPS listener. ::
-
-    aws elbv2 modify-listener \
-        --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65 \
-        --certificates CertificateArn=arn:aws:iam::123456789012:server-certificate/my-new-server-cert
-
-Output::
-
-    {
-        "Listeners": [
-            {
-                "Protocol": "HTTPS",
-                "DefaultActions": [
-                    {
-                        "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067",
-                        "Type": "forward"
-                    }
-                ],
-                "SslPolicy": "ELBSecurityPolicy-2015-05",
-                "Certificates": [
-                    {
-                        "CertificateArn": "arn:aws:iam::123456789012:server-certificate/my-new-server-cert"
-                    }
-                ],
-                "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188",
-                "Port": 443,
-                "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65"
-            }
-        ]
-    }
+**Example 1: To change the default action to a forward action**
+
+The following ``modify-listener`` example changes the default action to a ``forward`` action for the specified listener. ::
+
+    aws elbv2 modify-listener \
+        --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \
+        --default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f
+
+Output::
+
+    {
+        "Listeners": [
+            {
+                "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2",
+                "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188",
+                "Protocol": "HTTP",
+                "Port": 80,
+                "DefaultActions": [
+                    {
+                        "Type": "forward",
+                        "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f"
+                    }
+                ]
+            }
+        ]
+    }
+
+**Example 2: To change the default action to a redirect action**
+
+The following ``modify-listener`` example changes the default action to a ``redirect`` action for the specified listener. ::
+
+    aws elbv2 modify-listener \
+        --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \
+        --default-actions Type=redirect, RedirectConfig='{Protocol=HTTPS,StatusCode=HTTP_302}'
+
+Output::
+
+    {
+        "Listeners": [
+            {
+                "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2",
+                "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188",
+                "Protocol": "HTTP",
+                "Port": 80,
+                "DefaultActions": [
+                    {
+                        "Type": "redirect",
+                        "RedirectConfig": {
+                            "Protocol": "HTTPS",
+                            "Port": "#{port}",
+                            "Host": "#{host}",
+                            "Path": "/#{path}",
+                            "Query": "#{query}",
+                            "StatusCode": "HTTP_302",
+                        }
+                    }
+                ]
+            }
+        ]
+    }
+
+**Example 3: To change the server certificate**
+
+The following ``modify-listener`` example changes the server certificate for the specified HTTPS listener. ::
+
+    aws elbv2 modify-listener \
+        --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65 \
+        --certificates CertificateArn=arn:aws:iam::123456789012:server-certificate/my-new-server-cert
+
+Output::
+
+    {
+        "Listeners": [
+            {
+                "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65",
+                "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188",
+                "Protocol": "HTTPS",
+                "Port": 443,
+                "DefaultActions": [
+                    {
+                        "Type": "forward",
+                        "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067"
+                    }
+                ],
+                "SslPolicy": "ELBSecurityPolicy-2015-05",
+                "Certificates": [
+                    {
+                        "CertificateArn": "arn:aws:iam::123456789012:server-certificate/my-new-server-cert"
+                    }
+                ],
+            }
+        ]
+    }
+
+For more information, see `Listener rules <https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-listeners.html#listener-rules>`__ in the *Application Load Balancers User Guide*.

awscli/examples/emr/create-cluster-synopsis.txt

@@ -32,3 +32,4 @@
      [--managed-scaling-policy <value>]
      [--placement-group-configs <value>]
      [--auto-termination-policy <value>]
+     [--extended-support | --no-extended-support]

awscli/examples/global_options.rst

@@ -70,3 +70,7 @@
   
   The maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not timeout. The default value is 60 seconds.
   
+``--v2-debug`` (boolean)
+  
+  Enable AWS CLI v2 migration assistance. Prints warnings if the command would face a breaking change after swapping AWS CLI v1 for AWS CLI v2 in the current environment. Prints one warning for each breaking change detected.
+  

awscli/examples/global_synopsis.rst

@@ -12,3 +12,4 @@
 [--ca-bundle <value>]
 [--cli-read-timeout <value>]
 [--cli-connect-timeout <value>]
+[--v2-debug]

awscli/examples/guardduty/update-detector.rst

@@ -0,0 +1,23 @@
+**Example 1: To enable runtime monitoring in GuardDuty**
+
+The following ``update-detector`` example enables runtime monitoring without additional configuration. ::
+
+    aws guardduty update-detector \
+        --detector-id 12abc34d567e8fa901bc2d34eexample \
+        --features 'Name=RUNTIME_MONITORING,Status=ENABLED'
+
+This command produces no output.
+
+For more information, see `Runtime monitoring <https://docs.aws.amazon.com/guardduty/latest/ug/runtime-monitoring.html>`__ in the *GuardDuty User Guide*.
+
+**Example 2: To enable runtime monitoring with additional configuration**
+
+The following ``update-detector`` example enables runtime monitoring with additional configuration for EC2, ECS Fargate, and EKS. ::
+
+    aws guardduty update-detector \
+        --detector-id 12abc34d567e8fa901bc2d34eexample \
+        --features 'Name=RUNTIME_MONITORING,Status=ENABLED,AdditionalConfiguration=[{Name=EC2_AGENT_MANAGEMENT,Status=ENABLED},{Name=ECS_FARGATE_AGENT_MANAGEMENT,Status=ENABLED},{Name=EKS_ADDON_MANAGEMENT,Status=ENABLED}]'
+
+This command produces no output.
+
+For more information, see `Runtime monitoring <https://docs.aws.amazon.com/guardduty/latest/ug/runtime-monitoring.html>`__ in the *GuardDuty User Guide*.

awscli/examples/ivs-realtime/create-stage.rst

@@ -34,7 +34,8 @@ Output::
                 "recordingReconnectWindowSeconds": 0,
                 "hlsConfiguration": {
                     "targetSegmentDurationSeconds": 6
-                }
+                },
+                "recordParticipantReplicas": true
             },
             "endpoints": {
                 "events": "wss://global.events.live-video.net",
@@ -79,7 +80,8 @@ Output::
                 "recordingReconnectWindowSeconds": 100,
                 "hlsConfiguration": {
                     "targetSegmentDurationSeconds": 5
-                }
+                },
+                "recordParticipantReplicas": true
             },
             "endpoints": {
                 "events": "wss://global.events.live-video.net",
@@ -124,7 +126,8 @@ Output::
                 "recordingReconnectWindowSeconds": 0,
                 "hlsConfiguration": {
                     "targetSegmentDurationSeconds": 6
-                }
+                },
+                "recordParticipantReplicas": true
             },
             "endpoints": {
                 "events": "wss://global.events.live-video.net",

awscli/examples/ivs-realtime/get-composition.rst

@@ -51,9 +51,10 @@ Output::
             ],
             "layout": {
                 "grid": {
-                    "featuredParticipantAttribute": ""
+                    "featuredParticipantAttribute": "",
                     "gridGap": 2,
                     "omitStoppedVideo": false,
+                    "participantOrderAttribute": "",
                     "videoAspectRatio": "VIDEO",
                     "videoFillMode": ""
                 }
@@ -65,7 +66,7 @@ Output::
         }
     }
 
-For more information, see `IVS Composite Recording | Real-Time Streaming <https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html>`__ in the *Amazon IVS Real-Time Streaming User Guide*.
+For more information, see `IVS 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 2: To get a composition with PiP layout**
 
@@ -123,6 +124,7 @@ Output::
                     "featuredParticipantAttribute": "abcdefg",
                     "gridGap": 0,
                     "omitStoppedVideo": false,
+                    "participantOrderAttribute": "",
                     "pipBehavior": "STATIC",
                     "pipOffset": 0,
                     "pipParticipantAttribute": "",
@@ -137,7 +139,7 @@ Output::
         }
     }
 
-For more information, see `IVS Composite Recording | Real-Time Streaming <https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html>`__ in the *Amazon IVS Real-Time Streaming User Guide*.
+For more information, see `IVS 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**
 
@@ -203,6 +205,7 @@ Output::
                     "featuredParticipantAttribute": ""
                     "gridGap": 2,
                     "omitStoppedVideo": false,
+                    "participantOrderAttribute": "",
                     "videoAspectRatio": "VIDEO",
                     "videoFillMode": ""                }
             },
@@ -213,4 +216,4 @@ Output::
         }
     }
 
-For more information, see `IVS Composite Recording | Real-Time Streaming <https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html>`__ in the *Amazon IVS Real-Time Streaming User Guide*.
+For more information, see `IVS 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*.