Merge branch 'release-1.32.81'

* release-1.32.81: Bumping version to 1.32.81 Update changelog based on model updates CLI examples for eks, imagebuilder, ivs-realtime
aws · Apr 9, 2024 · 24fd6dc · 24fd6dc
2 parents 514ec9b + d851a37
commit 24fd6dc
Show file tree

Hide file tree

Showing 15 changed files with 556 additions and 41 deletions.
diff --git a/.changes/1.32.81.json b/.changes/1.32.81.json
@@ -0,0 +1,22 @@
+[
+  {
+    "category": "``codebuild``",
+    "description": "Add new webhook filter types for GitHub webhooks",
+    "type": "api-change"
+  },
+  {
+    "category": "``mediaconvert``",
+    "description": "This release includes support for bringing your own fonts to use for burn-in or DVB-Sub captioning workflows.",
+    "type": "api-change"
+  },
+  {
+    "category": "``pinpoint``",
+    "description": "The OrchestrationSendingRoleArn has been added to the email channel and is used to send emails from campaigns or journeys.",
+    "type": "api-change"
+  },
+  {
+    "category": "``rds``",
+    "description": "This release adds support for specifying the CA certificate to use for the new db instance when restoring from db snapshot, restoring from s3, restoring to point in time, and creating a db instance read replica.",
+    "type": "api-change"
+  }
+]
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -2,6 +2,15 @@
 CHANGELOG
 =========
 
+1.32.81
+=======
+
+* api-change:``codebuild``: Add new webhook filter types for GitHub webhooks
+* api-change:``mediaconvert``: This release includes support for bringing your own fonts to use for burn-in or DVB-Sub captioning workflows.
+* api-change:``pinpoint``: The OrchestrationSendingRoleArn has been added to the email channel and is used to send emails from campaigns or journeys.
+* api-change:``rds``: This release adds support for specifying the CA certificate to use for the new db instance when restoring from db snapshot, restoring from s3, restoring to point in time, and creating a db instance read replica.
+
+
 1.32.80
 =======
 

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

diff --git a/awscli/examples/eks/associate-encryption-config.rst b/awscli/examples/eks/associate-encryption-config.rst
@@ -0,0 +1,27 @@
+**To associates an encryption configuration to an existing cluster**
+
+The following ``associate-encryption-config`` example enable's encryption on an existing EKS clusters that do not already have encryption enabled. ::
+
+    aws eks associate-encryption-config \
+        --cluster-name my-eks-cluster \
+        --encryption-config '[{"resources":["secrets"],"provider":{"keyArn":"arn:aws:kms:region-code:account:key/key"}}]'
+
+Output::
+
+    {
+        "update": {
+            "id": "3141b835-8103-423a-8e68-12c2521ffa4d",
+            "status": "InProgress",
+            "type": "AssociateEncryptionConfig",
+            "params": [
+                {
+                    "type": "EncryptionConfig",
+                    "value": "[{\"resources\":[\"secrets\"],\"provider\":{\"keyArn\":\"arn:aws:kms:region-code:account:key/key\"}}]"
+                }
+            ],
+            "createdAt": "2024-03-14T11:01:26.297000-04:00",
+            "errors": []
+        }
+    }
+
+For more information, see `Enabling secret encryption on an existing cluster <https://docs.aws.amazon.com/eks/latest/userguide/enable-kms.html>`__ in the *Amazon EKS User Guide*.
diff --git a/awscli/examples/eks/create-addon.rst b/awscli/examples/eks/create-addon.rst
@@ -0,0 +1,191 @@
+**Example 1: To create an Amazon EKS add-on with default compatibile version for the respective EKS cluster version**
+
+The following ``create-addon`` example command creates an Amazon EKS add-on with default compatibile version for the respective EKS cluster version. ::
+
+    aws eks create-addon \
+        --cluster-name my-eks-cluster \
+        --addon-name my-eks-addon \
+        --service-account-role-arn arn:aws:iam::111122223333:role/role-name
+
+Output::
+
+    {
+        "addon": {
+            "addonName": "my-eks-addon",
+            "clusterName": "my-eks-cluster",
+            "status": "CREATING",
+            "addonVersion": "v1.15.1-eksbuild.1",
+            "health": {
+                "issues": []
+            },
+            "addonArn": "arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/my-eks-addon/1ec71ee1-b9c2-8915-4e17-e8be0a55a149",
+            "createdAt": "2024-03-14T12:20:03.264000-04:00",
+            "modifiedAt": "2024-03-14T12:20:03.283000-04:00",
+            "serviceAccountRoleArn": "arn:aws:iam::111122223333:role/role-name",
+            "tags": {}
+        }
+    }
+
+For more information, see `Managing Amazon EKS add-ons - Creating an add-on <https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#creating-an-add-on>`__ in the *Amazon EKS User Guide*.
+
+**Example 2: To create an Amazon EKS add-on with specific add-on version**
+
+The following ``create-addon`` example command creates an Amazon EKS add-on with specific add-on version. ::
+
+    aws eks create-addon \
+        --cluster-name my-eks-cluster \
+        --addon-name my-eks-addon \
+        --service-account-role-arn arn:aws:iam::111122223333:role/role-name \
+        --addon-version v1.16.4-eksbuild.2
+
+Output::
+
+    {
+        "addon": {
+            "addonName": "my-eks-addon",
+            "clusterName": "my-eks-cluster",
+            "status": "CREATING",
+            "addonVersion": "v1.16.4-eksbuild.2",
+            "health": {
+                "issues": []
+            },
+            "addonArn": "arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/my-eks-addon/34c71ee6-7738-6c8b-c6bd-3921a176b5ff",
+            "createdAt": "2024-03-14T12:30:24.507000-04:00",
+            "modifiedAt": "2024-03-14T12:30:24.521000-04:00",
+            "serviceAccountRoleArn": "arn:aws:iam::111122223333:role/role-name",
+            "tags": {}
+        }
+    }
+
+For more information, see `Managing Amazon EKS add-ons - Creating an add-on <https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#creating-an-add-on>`__ in the *Amazon EKS User Guide*.
+
+**Example 3: To create an Amazon EKS add-on with custom configuration values and resolve conflicts details**
+
+The following ``create-addon`` example command creates an Amazon EKS add-on with custom configuration values and resolves conflicts details. ::
+
+    aws eks create-addon \
+        --cluster-name my-eks-cluster \
+        --addon-name my-eks-addon \
+        --service-account-role-arn arn:aws:iam::111122223333:role/role-name \
+        --addon-version v1.16.4-eksbuild.2 \
+        --configuration-values '{"resources":{"limits":{"cpu":"100m"}}}' \
+        --resolve-conflicts OVERWRITE
+
+Output::
+
+    {
+        "addon": {
+            "addonName": "my-eks-addon",
+            "clusterName": "my-eks-cluster",
+            "status": "CREATING",
+            "addonVersion": "v1.16.4-eksbuild.2",
+            "health": {
+                "issues": []
+            },
+            "addonArn": "arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/my-eks-addon/a6c71ee9-0304-9237-1be8-25af1b0f1ffb",
+            "createdAt": "2024-03-14T12:35:58.313000-04:00",
+            "modifiedAt": "2024-03-14T12:35:58.327000-04:00",
+            "serviceAccountRoleArn": "arn:aws:iam::111122223333:role/role-name",
+            "tags": {},
+            "configurationValues": "{\"resources\":{\"limits\":{\"cpu\":\"100m\"}}}"
+        }
+    }
+
+For more information, see `Managing Amazon EKS add-ons - Creating an add-on <https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#creating-an-add-on>`__ in the *Amazon EKS User Guide*.
+
+**Example 4: To create an Amazon EKS add-on with custom JSON configuration values file**
+
+The following ``create-addon`` example command creates an Amazon EKS add-on with custom configuration values and resolve conflicts details. ::
+
+    aws eks create-addon \
+        --cluster-name my-eks-cluster \
+        --addon-name my-eks-addon \
+        --service-account-role-arn arn:aws:iam::111122223333:role/role-name \
+        --addon-version v1.16.4-eksbuild.2 \
+        --configuration-values 'file://configuration-values.json' \
+        --resolve-conflicts OVERWRITE \
+        --tags '{"eks-addon-key-1": "value-1" , "eks-addon-key-2": "value-2"}'
+
+Contents of ``configuration-values.json``::
+
+    {
+        "resources": {
+            "limits": {
+                "cpu": "150m"
+            }
+        },
+        "env": {
+            "AWS_VPC_K8S_CNI_LOGLEVEL": "ERROR"
+        }
+    }
+
+Output::
+
+    {
+        "addon": {
+            "addonName": "my-eks-addon",
+            "clusterName": "my-eks-cluster",
+            "status": "CREATING",
+            "addonVersion": "v1.16.4-eksbuild.2",
+            "health": {
+                "issues": []
+            },
+            "addonArn": "arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/my-eks-addon/d8c71ef8-fbd8-07d0-fb32-6a7be19ececd",
+            "createdAt": "2024-03-14T13:10:51.763000-04:00",
+            "modifiedAt": "2024-03-14T13:10:51.777000-04:00",
+            "serviceAccountRoleArn": "arn:aws:iam::111122223333:role/role-name",
+            "tags": {
+                "eks-addon-key-1": "value-1",
+                "eks-addon-key-2": "value-2"
+            },
+            "configurationValues": "{\n    \"resources\": {\n        \"limits\": {\n            \"cpu\": \"150m\"\n        }\n    },\n    \"env\": {\n        \"AWS_VPC_K8S_CNI_LOGLEVEL\": \"ERROR\"\n    }\n}"
+        }
+    }
+
+For more information, see `Managing Amazon EKS add-ons - Creating an add-on <https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#creating-an-add-on>`__ in the *Amazon EKS User Guide*.
+
+**Example 5: To create an Amazon EKS add-on with custom YAML configuration values file**
+
+The following ``create-addon`` example command creates an Amazon EKS add-on with custom configuration values and resolve conflicts details. ::
+
+    aws eks create-addon \
+        --cluster-name my-eks-cluster \
+        --addon-name my-eks-addon \
+        --service-account-role-arn arn:aws:iam::111122223333:role/role-name \
+        --addon-version v1.16.4-eksbuild.2 \
+        --configuration-values 'file://configuration-values.yaml' \
+        --resolve-conflicts OVERWRITE \
+        --tags '{"eks-addon-key-1": "value-1" , "eks-addon-key-2": "value-2"}'
+
+Contents of ``configuration-values.yaml``::
+
+    resources:
+        limits:
+            cpu: '100m'
+    env:
+        AWS_VPC_K8S_CNI_LOGLEVEL: 'DEBUG'
+
+Output::
+
+    {
+        "addon": {
+            "addonName": "my-eks-addon",
+            "clusterName": "my-eks-cluster",
+            "status": "CREATING",
+            "addonVersion": "v1.16.4-eksbuild.2",
+            "health": {
+                "issues": []
+            },
+            "addonArn": "arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/my-eks-addon/d4c71efb-3909-6f36-a548-402cd4b5d59e",
+            "createdAt": "2024-03-14T13:15:45.220000-04:00",
+            "modifiedAt": "2024-03-14T13:15:45.237000-04:00",
+            "serviceAccountRoleArn": "arn:aws:iam::111122223333:role/role-name",
+            "tags": {
+                "eks-addon-key-3": "value-3",
+                "eks-addon-key-4": "value-4"
+            },
+            "configurationValues": "resources:\n    limits:\n        cpu: '100m'\nenv:\n    AWS_VPC_K8S_CNI_LOGLEVEL: 'INFO'"
+        }
+    }
+
+For more information, see `Managing Amazon EKS add-ons - Creating an add-on <https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#creating-an-add-on>`__ in the *Amazon EKS User Guide*.
diff --git a/awscli/examples/eks/delete-addon.rst b/awscli/examples/eks/delete-addon.rst
@@ -0,0 +1,57 @@
+**Example 1. To deletes an Amazon EKS add-on but preserve the add-on software on the EKS Cluster**
+
+The following ``delete-addon`` example command deletes an Amazon EKS add-on but preserve the add-on software on the EKS Cluster. ::
+
+    aws eks delete-addon \
+        --cluster-name my-eks-cluster \
+        --addon-name my-eks-addon \
+        --preserve
+
+Output::
+
+    {
+        "addon": {
+            "addonName": "my-eks-addon",
+            "clusterName": "my-eks-cluster",
+            "status": "DELETING",
+            "addonVersion": "v1.9.3-eksbuild.7",
+            "health": {
+                "issues": []
+            },
+            "addonArn": "arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/my-eks-addon/a8c71ed3-944e-898b-9167-c763856af4b8",
+            "createdAt": "2024-03-14T11:49:09.009000-04:00",
+            "modifiedAt": "2024-03-14T12:03:49.776000-04:00",
+            "tags": {}
+        }
+    }
+
+For more information, see `Managing Amazon EKS add-ons - Deleting an add-on <https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#removing-an-add-on>`__ in the *Amazon EKS*.
+
+**Example 2. To deletes an Amazon EKS add-on and also delete the add-on software from the EKS Cluster**
+
+The following ``delete-addon`` example command deletes an Amazon EKS add-on and also delete the add-on software from the EKS Cluster. ::
+
+    aws eks delete-addon \
+        --cluster-name my-eks-cluster \
+        --addon-name my-eks-addon
+
+Output::
+
+    {
+        "addon": {
+            "addonName": "my-eks-addon",
+            "clusterName": "my-eks-cluster",
+            "status": "DELETING",
+            "addonVersion": "v1.15.1-eksbuild.1",
+            "health": {
+                "issues": []
+            },
+            "addonArn": "arn:aws:eks:us-east-2:111122223333:addon/my-eks-cluster/my-eks-addon/bac71ed1-ec43-3bb6-88ea-f243cdb58954",
+            "createdAt": "2024-03-14T11:45:31.983000-04:00",
+            "modifiedAt": "2024-03-14T11:58:40.136000-04:00",
+            "serviceAccountRoleArn": "arn:aws:iam::111122223333:role/role-name",
+            "tags": {}
+        }
+    }
+
+For more information, see `Managing Amazon EKS add-ons - Deleting an add-on <https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html#removing-an-add-on>`__ in the *Amazon EKS*.