awscli 1.36.25__py3-none-any.whl → 1.36.26__py3-none-any.whl

awscli/examples/ecr-public/set-repository-policy.rst

@@ -0,0 +1,118 @@
+**Example 1: To set a repository policy to allow a pull on the repository**
+
+The following ``set-repository-policy`` example applies an ECR public repository policy to the specified repository to control access permissions. ::
+
+    aws ecr-public set-repository-policy \
+        --repository-name project-a/nginx-web-app \
+        --policy-text file://my-repository-policy.json 
+
+Contents of ``my-repository-policy.json``::
+
+    {
+        "Version" : "2008-10-17",
+        "Statement" : [
+            {
+                "Sid" : "allow public pull",
+                "Effect" : "Allow",
+                "Principal" : "*",
+                "Action" : [
+                    "ecr:BatchCheckLayerAvailability",
+                    "ecr:BatchGetImage",
+                    "ecr:GetDownloadUrlForLayer"
+                ]
+            }
+        ]
+    }
+
+Output::
+
+    {
+        "registryId": "12345678901",
+        "repositoryName": "project-a/nginx-web-app",
+        "policyText": "{\n  \"Version\" : \"2008-10-17\",\n  \"Statement\" : [ {\n    \"Sid\" : \"allow public pull\",\n    \"Effect\" : \"Allow\",\n    \"Principal\" : \"*\",\n    \"Action\" : [ \"ecr:BatchCheckLayerAvailability\", \"ecr:BatchGetImage\", \"ecr:GetDownloadUrlForLayer\" ]\n  } ]\n}"
+    }
+
+For more information, see `Setting a repository policy statement <https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-policy-examples.html>`__ in the *Amazon ECR Public User Guide*.
+
+**Example 2: To set a repository policy to allow an IAM user within your account to push images**
+
+The following ``set-repository-policy`` example allows an IAM user within your account to push images using to an ECR repository in your AWS account using the input file named ``file://my-repository-policy.json`` as policy text. ::
+
+    aws ecr-public set-repository-policy \
+        --repository-name project-a/nginx-web-app \
+        --policy-text file://my-repository-policy.json 
+
+Contents of ``my-repository-policy.json``::
+
+    {
+        "Version": "2008-10-17",
+        "Statement": [
+            {
+                "Sid": "AllowPush",
+                "Effect": "Allow",
+                "Principal": {
+                    "AWS": [
+                        "arn:aws:iam::account-id:user/push-pull-user-1",
+                        "arn:aws:iam::account-id:user/push-pull-user-2"
+                    ]
+                },
+                "Action": [
+                    "ecr-public:BatchCheckLayerAvailability",
+                    "ecr-public:PutImage",
+                    "ecr-public:InitiateLayerUpload",
+                    "ecr-public:UploadLayerPart",
+                    "ecr-public:CompleteLayerUpload"
+                ]
+            }
+        ]
+    }
+
+Output::
+
+    {
+        "registryId": "12345678901",
+        "repositoryName": "project-a/nginx-web-app",
+        "policyText": "{\n  \"Version\" : \"2008-10-17\",\n  \"Statement\" : [ {\n    \"Sid\" : \"AllowPush\",\n    \"Effect\" : \"Allow\",\n    \"Principal\" : {\n      \"AWS\" : [ \"arn:aws:iam::12345678901:user/admin\", \"arn:aws:iam::12345678901:user/eksuser1\" ]\n    },\n    \"Action\" : [ \"ecr-public:BatchCheckLayerAvailability\", \"ecr-public:PutImage\", \"ecr-public:InitiateLayerUpload\", \"ecr-public:UploadLayerPart\", \"ecr-public:CompleteLayerUpload\" ]\n  } ]\n}"
+    }
+
+For more information, see `Setting a repository policy statement <https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-policy-examples.html>`__ in the *Amazon ECR Public User Guide*.
+
+**Example 3: To set a repository policy to allow an IAM user from different account to push images**
+
+The following ``set-repository-policy`` example allows a specific account to push images using cli input file://my-repository-policy.json in your AWS account. ::
+
+    aws ecr-public set-repository-policy \
+        --repository-name project-a/nginx-web-app \
+        --policy-text file://my-repository-policy.json
+
+Contents of ``my-repository-policy.json``::
+
+    {
+        "Version": "2008-10-17",
+        "Statement": [
+            {
+                "Sid": "AllowCrossAccountPush",
+                "Effect": "Allow",
+                "Principal": {
+                    "AWS": "arn:aws:iam::other-or-same-account-id:role/RoleName"
+                },
+                "Action": [
+                    "ecr-public:BatchCheckLayerAvailability",
+                    "ecr-public:PutImage",
+                    "ecr-public:InitiateLayerUpload",
+                    "ecr-public:UploadLayerPart",
+                    "ecr-public:CompleteLayerUpload"
+                ]
+            }
+        ]
+   }
+
+Output::
+
+    {
+        "registryId": "12345678901",
+        "repositoryName": "project-a/nginx-web-app",
+        "policyText": "{\n  \"Version\" : \"2008-10-17\",\n  \"Statement\" : [ {\n    \"Sid\" : \"AllowCrossAccountPush\",\n    \"Effect\" : \"Allow\",\n    \"Principal\" : {\n      \"AWS\" : \"arn:aws:iam::12345678901:role/RoleName\"\n    },\n    \"Action\" : [ \"ecr-public:BatchCheckLayerAvailability\", \"ecr-public:PutImage\", \"ecr-public:InitiateLayerUpload\", \"ecr-public:UploadLayerPart\", \"ecr-public:CompleteLayerUpload\" ]\n  } ]\n}"
+    }
+
+For more information, see `Public repository policy examples <https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-policy-examples.html>`__ in the *Amazon ECR Public User Guide*.

awscli/examples/ecs/capacity-provider-update.rst

@@ -0,0 +1,33 @@
+**Update the capacity provider in an ECS cluster**
+
+The following ``update-capacity-provider`` example shows how we can modify the parameters of the capacity provider in an ECS cluster. ::
+
+    aws ecs update-capacity-provider \
+        --name Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt \
+        --auto-scaling-group-provider "managedScaling={status=DISABLED,targetCapacity=50,minimumScalingStepSize=2,maximumScalingStepSize=30,instanceWarmupPeriod=200},managedTerminationProtection=DISABLED,managedDraining=DISABLED"
+
+Output::
+
+    {
+        "capacityProvider": {
+            "capacityProviderArn": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
+            "name": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
+            "status": "ACTIVE",
+            "autoScalingGroupProvider": {
+                "autoScalingGroupArn": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:424941d1-b43f-4a17-adbb-08b6a6e397e1:autoScalingGroupName/Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-ECSAutoScalingGroup-f44jrQHS2nRB",
+                "managedScaling": {
+                    "status": "ENABLED",
+                    "targetCapacity": 100,
+                    "minimumScalingStepSize": 1,
+                    "maximumScalingStepSize": 10000,
+                    "instanceWarmupPeriod": 300
+                },
+                "managedTerminationProtection": "DISABLED",
+                "managedDraining": "ENABLED"
+            },
+            "updateStatus": "UPDATE_IN_PROGRESS",
+            "tags": []
+        }
+    }
+
+For more information on Capacity Provider, see `Amazon ECS capacity providers for the EC2 launch type <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/asg-capacity-providers.html>`__ in the *Amazon ECS Developer Guide*.

awscli/examples/ecs/get-task-protection.rst

@@ -0,0 +1,21 @@
+**Retrieve the protection status of task in ECS service**
+
+The following ``get-task-protection`` provides the protection status of ECS tasks that belong to Amazon ECS service. ::
+
+    aws ecs get-task-protection \
+        --cluster ECS-project-update-cluster \
+        --tasks c43ed3b1331041f289316f958adb6a24
+
+Output::
+
+    {
+        "protectedTasks": [
+            {
+                "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/c43ed3b1331041f289316f958adb6a24",
+                "protectionEnabled": false
+            }
+        ],
+        "failures": []
+    }
+
+For more formation on task protection, see `Protect your Amazon ECS tasks from being terminated by scale-in events <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-scale-in-protection.html>`__ in the *Amazon ECS Developer Guide*.

awscli/examples/ecs/update-cluster.rst

@@ -0,0 +1,176 @@
+**Example 1: Update ECS cluster enabling containerInsights**
+
+The following ``update-cluster`` updates the containerInsights value to ``enabled`` in an already created cluster. By default, it is disabled. ::
+
+    aws ecs update-cluster \
+        --cluster ECS-project-update-cluster \
+        --settings name=containerInsights,value=enabled
+
+Output::
+
+    "cluster": {
+        "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/ECS-project-update-cluster",
+        "clusterName": "ECS-project-update-cluster",
+        "status": "ACTIVE",
+        "registeredContainerInstancesCount": 0,
+        "runningTasksCount": 0,
+        "pendingTasksCount": 0,
+        "activeServicesCount": 0,
+        "statistics": [],
+        "tags": [],
+        "settings": [
+            {
+                "name": "containerInsights",
+                "value": "enabled"
+            }
+        ],
+        "capacityProviders": [
+            "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
+        ],
+        "defaultCapacityProviderStrategy": [
+            {
+                "capacityProvider": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
+                "weight": 1,
+                "base": 0
+            }
+        ],
+        "attachments": [
+            {
+                "id": "069d002b-7634-42e4-b1d4-544f4c8f6380",
+                "type": "as_policy",
+                "status": "CREATED",
+                "details": [
+                    {
+                        "name": "capacityProviderName",
+                        "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
+                    },
+                    {
+                        "name": "scalingPolicyName",
+                        "value": "ECSManagedAutoScalingPolicy-152363a6-8c65-484c-b721-42c3e070ae93"
+                    }
+                ]
+            },
+            {
+                "id": "08b5b6ca-45e9-4209-a65d-e962a27c490a",
+                "type": "managed_draining",
+                "status": "CREATED",
+                "details": [
+                    {
+                        "name": "capacityProviderName",
+                        "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
+                    },
+                    {
+                        "name": "autoScalingLifecycleHookName",
+                        "value": "ecs-managed-draining-termination-hook"
+                    }
+                ]
+            },
+            {
+                "id": "45d0b36f-8cff-46b6-9380-1288744802ab",
+                "type": "sc",
+                "status": "ATTACHED",
+                "details": []
+            }
+        ],
+        "attachmentsStatus": "UPDATE_COMPLETE",
+        "serviceConnectDefaults": {
+            "namespace": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-igwrsylmy3kwvcdx"
+        }
+    }
+
+
+**Example 2: Update ECS cluster to set a default Service Connect namspace**
+
+The following ``update-cluster`` updates ECS cluster by setting a default Service Connect namespace. ::
+
+    aws ecs update-cluster \
+        --cluster ECS-project-update-cluster \
+        --service-connect-defaults namespace=test
+
+Output::
+
+    {
+        "cluster": {
+            "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/ECS-project-update-cluster",
+            "clusterName": "ECS-project-update-cluster",
+            "status": "ACTIVE",
+            "registeredContainerInstancesCount": 0,
+            "runningTasksCount": 0,
+            "pendingTasksCount": 0,
+            "activeServicesCount": 0,
+            "statistics": [],
+            "tags": [],
+            "settings": [
+                {
+                    "name": "containerInsights",
+                    "value": "enabled"
+                }
+            ],
+            "capacityProviders": [
+                "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
+            ],
+            "defaultCapacityProviderStrategy": [
+                {
+                    "capacityProvider": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
+                    "weight": 1,
+                    "base": 0
+                }
+            ],
+            "attachments": [
+                {
+                    "id": "069d002b-7634-42e4-b1d4-544f4c8f6380",
+                    "type": "as_policy",
+                    "status": "CREATED",
+                    "details": [
+                        {
+                            "name": "capacityProviderName",
+                            "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
+                        },
+                        {
+                            "name": "scalingPolicyName",
+                            "value": "ECSManagedAutoScalingPolicy-152363a6-8c65-484c-b721-42c3e070ae93"
+                        }
+                    ]
+                },
+                {
+                    "id": "08b5b6ca-45e9-4209-a65d-e962a27c490a",
+                    "type": "managed_draining",
+                    "status": "CREATED",
+                    "details": [
+                        {
+                            "name": "capacityProviderName",
+                            "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
+                        },
+                        {
+                            "name": "autoScalingLifecycleHookName",
+                            "value": "ecs-managed-draining-termination-hook"
+                        }
+                    ]
+                },
+                {
+                    "id": "45d0b36f-8cff-46b6-9380-1288744802ab",
+                    "type": "sc",
+                    "status": "DELETED",
+                    "details": []
+                },
+                {
+                    "id": "3e6890c3-609c-4832-91de-d6ca891b3ef1",
+                    "type": "sc",
+                    "status": "ATTACHED",
+                    "details": []
+                },
+                {
+                    "id": "961b8ec1-c2f1-4070-8495-e669b7668e90",
+                    "type": "sc",
+                    "status": "DELETED",
+                    "details": []
+                }
+            ],
+            "attachmentsStatus": "UPDATE_COMPLETE",
+            "serviceConnectDefaults": {
+                "namespace": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-dtjmxqpfi46ht7dr"
+            }
+        }
+   }
+   
+For more information on Service Connect, see `Use Service Connect to connect Amazon ECS services with short names <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html>`__ in the *Amazon ECS Developer Guide*.

awscli/examples/ecs/update-task-protection.rst

@@ -0,0 +1,46 @@
+**Example 1: Enable task protection for ECS tasks**
+
+The following ``update-task-protection`` protects your ECS task from termination during scale-in from Deployments or Service AutoScaling. You can specify custom expiration period for task protection from 1 up to 2,880 minutes (48 hours). If you do not specify expiration period, enabling task protection default time is 2 hours. ::
+
+    aws ecs update-task-protection \
+        --cluster ECS-project-update-cluster \
+        --tasks c43ed3b1331041f289316f958adb6a24 \
+        --protection-enabled \
+        --expires-in-minutes 300
+
+Output::
+
+    {
+    "protectedTasks": [
+        {
+            "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/c43ed3b1331041f289316f958adb6a24",
+            "protectionEnabled": true,
+            "expirationDate": "2024-09-14T19:53:36.687000-05:00"
+        }
+    ],
+    "failures": []
+    }
+
+**Example 2: Disable task protection for ECS tasks**
+
+The following ``update-task-protection`` disables the tasks protected from scale in from Deployments or Service AutoScaling. ::
+
+    aws ecs update-task-protection \
+        --cluster ECS-project-update-cluster \
+        --tasks c43ed3b1331041f289316f958adb6a24 \
+        --no-protection-enabled
+
+Output::
+
+    {
+        "protectedTasks": [
+            {
+                "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/c43ed3b1331041f289316f958adb6a24",
+                "protectionEnabled": false
+            }
+        ],
+        "failures": []
+    }
+
+For more formation on task protection, see `Protect your Amazon ECS tasks from being terminated by scale-in events <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-scale-in-protection.html>`__ in the *Amazon ECS Developer Guide*.
+

awscli/examples/inspector2/associate-member.rst

@@ -0,0 +1,14 @@
+**Example: To associate an AWS account with an Amazon Inspector delegated administrator**
+
+The following ``associate-member`` example associates an AWS account with an Amazon Inspector delegated administrator. ::
+
+    aws inspector2 associate-member \
+        --account-id 123456789012
+
+Output::
+
+    {
+        "accountId": "123456789012"
+    }
+
+For more information, see `Managing multiple accounts in Amazon Inspector with AWS Organizations <https://docs.aws.amazon.com/inspector/latest/user/managing-multiple-accounts.html>`__ in the *Amazon Inspector User Guide*.

awscli/examples/inspector2/disassociate-member.rst

@@ -0,0 +1,14 @@
+**Example: To disassociate a member account from an Amazon Inspector delegated administrator**
+
+The following ``disassociate-member`` example disassociates an AWS account from an Amazon Inspector delegated administrator. ::
+
+    aws inspector2 disassociate-member \
+        --account-id 123456789012
+
+Output::
+
+    {
+        "accountId": "123456789012"
+    }
+
+For more information, see `Managing multiple accounts in Amazon Inspector with AWS Organizations <https://docs.aws.amazon.com/inspector/latest/user/managing-multiple-accounts.html>`__ in the *Amazon Inspector User Guide*.

awscli/examples/inspector2/get-member.rst

@@ -0,0 +1,17 @@
+**Example: To get member information for your organization**
+
+    aws inspector2 get-member \
+        --account-id 123456789012
+
+Output::
+
+    {
+            "member": {
+            "accountId": "123456789012",
+            "delegatedAdminAccountId": "123456789012",
+            "relationshipStatus": "ENABLED",
+            "updatedAt": "2023-09-11T09:57:20.520000-07:00"
+        }
+    }
+
+For more information, see `Managing multiple accounts in Amazon Inspector with AWS Organizations <https://docs.aws.amazon.com/inspector/latest/user/managing-multiple-accounts.html>`__ in the *Amazon Inspector User Guide*.

awscli/examples/inspector2/list-members.rst

@@ -0,0 +1,83 @@
+**Example 1: To list all member accounts associated with the Amazon Inspector delegated administrator for your organization**
+
+    aws inspector2 list-members \
+        --only-associated
+
+Output::
+
+    {
+            {
+                 "members": [
+            {
+                 "accountId": "123456789012",
+                 "delegatedAdminAccountId": "123456789012",
+                 "relationshipStatus": "ENABLED",
+                 "updatedAt": "2023-09-11T09:57:20.520000-07:00"
+            },
+            {
+                 "accountId": "123456789012",
+                 "delegatedAdminAccountId": "123456789012",
+                 "relationshipStatus": "ENABLED",
+                 "updatedAt": "2024-08-12T10:13:01.472000-07:00"
+            },
+            {
+                 "accountId": "625032911453",
+                 "delegatedAdminAccountId": "123456789012",
+                 "relationshipStatus": "ENABLED",
+                 "updatedAt": "2023-09-11T09:57:20.438000-07:00"
+            },
+            {
+                "accountId": "715411239211",
+                "delegatedAdminAccountId": "123456789012",
+                "relationshipStatus": "ENABLED",
+                "updatedAt": "2024-04-24T09:14:57.471000-07:00"
+            }
+        ]
+    }
+
+For more information, see `Managing multiple accounts in Amazon Inspector with AWS Organizations <https://docs.aws.amazon.com/inspector/latest/user/managing-multiple-accounts.html>`__ in the *Amazon Inspector User Guide*.
+
+**Example 2: To list all member accounts associated with and disassociated from the Amazon Inspector delegated administrator for your organization**
+
+    aws inspector2 list-members \
+        --no-only-associated
+
+Output::
+
+    {
+            {
+                "members": [
+            {
+                "accountId": "123456789012",
+                "delegatedAdminAccountId": "123456789012",
+                "relationshipStatus": "REMOVED",
+                "updatedAt": "2024-05-15T11:34:53.326000-07:00"
+            },
+            {
+                "accountId": "123456789012",
+                "delegatedAdminAccountId": "123456789012",
+                "relationshipStatus": "ENABLED",
+                "updatedAt": "2023-09-11T09:57:20.520000-07:00"
+            },
+            {
+                "accountId": "123456789012",
+                "delegatedAdminAccountId": "123456789012",
+                "relationshipStatus": "ENABLED",
+                "updatedAt": "2024-08-12T10:13:01.472000-07:00"
+            },
+            {
+                "accountId": "123456789012",
+                "delegatedAdminAccountId": "123456789012",
+                "relationshipStatus": "ENABLED",
+                "updatedAt": "2023-09-11T09:57:20.438000-07:00"
+            },
+            {
+                "accountId": "123456789012",
+                "delegatedAdminAccountId": "123456789012",
+                "relationshipStatus": "ENABLED",
+                "updatedAt": "2024-04-24T09:14:57.471000-07:00"
+            }
+        ]
+    }
+
+For more information, see `Managing multiple accounts in Amazon Inspector with AWS Organizations <https://docs.aws.amazon.com/inspector/latest/user/managing-multiple-accounts.html>`__ in the *Amazon Inspector User Guide*.

awscli/examples/ivs-realtime/create-ingest-configuration.rst

@@ -0,0 +1,25 @@
+**To create an ingest configuration**
+
+The following ``create-ingest-configuration`` example creates an ingest configuration using RTMPS protocol. ::
+
+    aws ivs-realtime create-ingest-configuration \
+        --name ingest1 \
+        --ingest-protocol rtmps
+
+Output::
+
+    {
+        "ingestConfiguration": {
+            "name": "ingest1",
+            "arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234",
+            "ingestProtocol": "RTMPS",
+            "streamKey": "rt_123456789012_us-west-2_AbCdEfGh1234_abcd1234efgh5678ijkl9012MNOP34",
+            "stageArn": "",
+            "participantId": "xyZ654abC321",
+            "state": "INACTIVE",
+            "userId": "",
+            "tags": {}
+        }
+    }
+
+For more information, see `IVS Stream Ingest | Real-Time Streaming <https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html>`__ in the *Amazon Interactive Video Service User Guide*.

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

@@ -21,6 +21,8 @@ Output::
             "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
             "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"
             },
             "name": "stage1",
@@ -49,9 +51,11 @@ Output::
                        "AUDIO_VIDEO"
                  ],
                  "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
-            },            
+            },
             "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"
             },
             "name": "stage1",
@@ -59,4 +63,4 @@ Output::
         }
     }
 
-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*.

awscli/examples/ivs-realtime/delete-ingest-configuration.rst

@@ -0,0 +1,22 @@
+**Example 1: To delete an inactive ingest configuration**
+
+The following ``delete-ingest-configuration`` example deletes the inactive ingest configuration for a specified ingest-configuration ARN (Amazon Resource Name). ::
+
+    aws ivs-realtime delete-ingest-configuration \
+        --arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234
+
+This command produces no output.
+
+For more information, see `IVS Stream Ingest | Real-Time Streaming <https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html>`__ in the *Amazon Interactive Video Service User Guide*.
+
+**Example 2: To force delete an active ingest configuration**
+
+The following ``delete-ingest-configuration`` example forces deletion of the active ingest configuration for a specified ingest-configuration ARN (Amazon Resource Name). ::
+
+    aws ivs-realtime delete-ingest-configuration \
+        --arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234 \
+        --force
+
+This command produces no output.
+
+For more information, see `IVS Stream Ingest | Real-Time Streaming <https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html>`__ in the *Amazon Interactive Video Service User Guide*.

awscli/examples/ivs-realtime/get-ingest-configuration.rst

@@ -0,0 +1,24 @@
+**To get ingest configuration information**
+
+The following ``get-ingest-configuration`` example gets the ingest configuration for a specified ingest-configuration ARN (Amazon Resource Name). ::
+
+    aws ivs-realtime get-ingest-configuration \
+        --arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234
+
+Output::
+
+    {
+        "ingestConfiguration": {
+            "name": "ingest1",
+            "arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234",
+            "ingestProtocol": "RTMPS",
+            "streamKey": "rt_123456789012_us-west-2_AbCdEfGh1234_abcd1234efgh5678ijkl9012MNOP34",
+            "stageArn": "",
+            "participantId": "xyZ654abC321",
+            "state": "INACTIVE",
+            "userId": "",
+            "tags": {}
+        }
+    }
+
+For more information, see `IVS Stream Ingest | Real-Time Streaming <https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html>`__ in the *Amazon Interactive Video Service User Guide*.

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

@@ -16,9 +16,11 @@ Output::
                        "AUDIO_VIDEO"
                  ],
                  "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
-            },            
+            },
             "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"
             },
             "name": "test",
@@ -26,4 +28,4 @@ Output::
         }
     }
 
-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*.