awscli 1.36.10__py3-none-any.whl → 1.36.12__py3-none-any.whl

awscli/__init__.py

@@ -18,7 +18,7 @@ A Universal Command Line Environment for Amazon Web Services.
 
 import os
 
-__version__ = '1.36.10'
+__version__ = '1.36.12'
 
 #
 # Get our data path to be added to botocore's search path

awscli/examples/cloudwatch/delete-anomaly-detector.rst

@@ -0,0 +1,12 @@
+**To delete a specified anomaly detection model**
+
+The following ``delete-anomaly-detector`` example deletes an anomaly detector model in the specified account. ::
+
+    aws cloudwatch delete-anomaly-detector \
+        --namespace AWS/Logs \
+        --metric-name IncomingBytes \
+        --stat SampleCount 
+
+This command produces no output.
+
+For more information, see `Deleting an anomaly detection model <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Anomaly_Detection_Alarm.html#Delete_Anomaly_Detection_Model>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/delete-dashboards.rst

@@ -0,0 +1,10 @@
+**To delete specified dashboards**
+
+The following ``delete-dashboards`` example deletes two dashboards named ``Dashboard-A`` and ``Dashboard-B`` in the specified account. ::
+
+    aws cloudwatch delete-dashboards \
+        --dashboard-names Dashboard-A Dashboard-B
+
+This command produces no output.
+
+For more information, see `Amazon CloudWatch dashboards <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/delete-insight-rules.rst

@@ -0,0 +1,14 @@
+**To delete specified contributor insights rules**
+
+The following ``delete-insight-rules`` example deletes two contributor insights rules named ``Rule-A`` and ``Rule-B`` in the specified account. ::
+
+    aws cloudwatch delete-insight-rules \
+        --rule-names Rule-A Rule-B 
+
+Output::
+
+    {
+        "Failures": []
+    }
+
+For more information, see `Use Contributor Insights to analyze high-cardinality data <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/delete-metric-stream.rst

@@ -0,0 +1,10 @@
+**To delete a specified metric stream**
+
+The following ``delete-metric-stream`` example deletes the metric stream named ``QuickPartial-gSCKvO`` in the specified account. ::
+
+    aws cloudwatch delete-metric-stream \
+        --name QuickPartial-gSCKvO 
+
+This command produces no output.
+
+For more information, see `Use metric streams <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/describe-anomaly-detectors.rst

@@ -0,0 +1,59 @@
+**To retrieve a list of anomaly detection models**
+
+The following ``describe-anomaly-detectors`` example displays information about anomaly detector models that are associated with the ``AWS/Logs`` namespace in the specified account. ::
+
+    aws cloudwatch describe-anomaly-detectors \
+        --namespace AWS/Logs
+
+Output::
+
+    {
+        "AnomalyDetectors": [
+            {
+                "Namespace": "AWS/Logs",
+                "MetricName": "IncomingBytes",
+                "Dimensions": [],
+                "Stat": "SampleCount",
+                "Configuration": {
+                    "ExcludedTimeRanges": []
+                },
+                "StateValue": "TRAINED",
+                "SingleMetricAnomalyDetector": {
+                    "AccountId": "123456789012",
+                    "Namespace": "AWS/Logs",
+                    "MetricName": "IncomingBytes",
+                    "Dimensions": [],
+                    "Stat": "SampleCount"
+                }
+            },
+            {
+                "Namespace": "AWS/Logs",
+                "MetricName": "IncomingBytes",
+                "Dimensions": [
+                    {
+                        "Name": "LogGroupName",
+                        "Value": "demo"
+                    }
+                ],
+                "Stat": "Average",
+                "Configuration": {
+                    "ExcludedTimeRanges": []
+                },
+                "StateValue": "PENDING_TRAINING",
+                "SingleMetricAnomalyDetector": {
+                    "AccountId": "123456789012",
+                    "Namespace": "AWS/Logs",
+                    "MetricName": "IncomingBytes",
+                    "Dimensions": [
+                        {
+                            "Name": "LogGroupName",
+                            "Value": "demo"
+                        }
+                    ],
+                    "Stat": "Average"
+                }
+            }
+        ]
+    }
+
+For more information, see `Using CloudWatch anomaly detection <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Anomaly_Detection.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/describe-insight-rules.rst

@@ -0,0 +1,28 @@
+**To retrieve a list of Contributor Insights rules**
+
+The following ``describe-insight-rules`` example shows all the Contributor Insight rules in the specified account. ::
+
+    aws cloudwatch describe-insight-rules 
+
+Output::
+
+    {
+        "InsightRules": [
+            {
+                "Name": "Rule-A",
+                "State": "ENABLED",
+                "Schema": "CloudWatchLogRule/1",
+                "Definition": "{\n\t\"AggregateOn\": \"Count\",\n\t\"Contribution\": {\n\t\t\"Filters\": [],\n\t\t\"Keys\": [\n\t\t\t\"$.requestId\"\n\t\t]\n\t},\n\t\"LogFormat\": \"JSON\",\n\t\"Schema\": {\n\t\t\"Name\": \"CloudWatchLogRule\",\n\t\t\"Version\": 1\n\t},\n\t\"LogGroupARNs\": [\n\t\t\"arn:aws:logs:us-east-1:123456789012:log-group:demo\"\n\t]\n}",
+                "ManagedRule": false
+            },
+            {
+                "Name": "Rule-B",
+                "State": "ENABLED",
+                "Schema": "CloudWatchLogRule/1",
+                "Definition": "{\n\t\"AggregateOn\": \"Count\",\n\t\"Contribution\": {\n\t\t\"Filters\": [],\n\t\t\"Keys\": [\n\t\t\t\"$.requestId\"\n\t\t]\n\t},\n\t\"LogFormat\": \"JSON\",\n\t\"Schema\": {\n\t\t\"Name\": \"CloudWatchLogRule\",\n\t\t\"Version\": 1\n\t},\n\t\"LogGroupARNs\": [\n\t\t\"arn:aws:logs:us-east-1:123456789012:log-group:demo-1\"\n\t]\n}",
+                "ManagedRule": false
+            }
+        ]
+    }
+
+For more information, see `Use Contributor Insights to analyze high-cardinality data <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/disable-insight-rules.rst

@@ -0,0 +1,14 @@
+**To disable specified contributor insight rules**
+
+The following ``disable-insight-rules`` example disables two contributor insights rules named ``Rule-A`` and ``Rule-B`` in the specified account. ::
+
+    aws cloudwatch disable-insight-rules \
+        --rule-names Rule-A Rule-B
+
+Output::
+
+    {
+        "Failures": []
+    }
+
+For more information, see `Use Contributor Insights to analyze high-cardinality data <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/enable-insight-rules.rst

@@ -0,0 +1,14 @@
+**To enable specified contributor insight rules**
+
+The following ``enable-insight-rules`` example enables two contributor insights rules named ``Rule-A`` and ``Rule-B`` in the specified account. ::
+
+    aws cloudwatch enable-insight-rules \
+        --rule-names Rule-A Rule-B
+
+Output::
+
+    {
+        "Failures": []
+    }
+
+For more information, see `Use Contributor Insights to analyze high-cardinality data <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/get-dashboard.rst

@@ -0,0 +1,16 @@
+**To retrieve information about a Dashboard**
+
+The following ``get-dashboard`` example displays information about the dashboard named ``Dashboard-A`` in the specified account. ::
+
+    aws cloudwatch get-dashboard \
+        --dashboard-name Dashboard-A 
+
+Output::
+
+    {
+        "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-A",
+        "DashboardBody": "{\"widgets\":[{\"type\":\"metric\",\"x\":0,\"y\":0,\"width\":6,\"height\":6,\"properties\":{\"view\":\"timeSeries\",\"stacked\":false,\"metrics\":[[\"AWS/EC2\",\"NetworkIn\",\"InstanceId\",\"i-0131f062232ade043\"],[\".\",\"NetworkOut\",\".\",\".\"]],\"region\":\"us-east-1\"}}]}",
+        "DashboardName": "Dashboard-A"
+    }
+
+For more information, see `Amazon CloudWatch dashboards <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/get-insight-rule-report.rst

@@ -0,0 +1,37 @@
+**To retrieve the time series data collected by a Contributor Insights rule**
+
+The following ``get-insight-rule-report`` example returns the time series data collected by a Contributor Insights rule. ::
+
+    aws cloudwatch get-insight-rule-report \
+        --rule-name Rule-A \
+        --start-time 2024-10-13T20:15:00Z \
+        --end-time 2024-10-13T20:30:00Z \
+        --period 300
+
+Output::
+
+    {
+        "KeyLabels": [
+            "PartitionKey"
+        ],
+        "AggregationStatistic": "Sum",
+        "AggregateValue": 0.5,
+        "ApproximateUniqueCount": 1,
+        "Contributors": [
+            {
+                "Keys": [
+                    "RequestID"
+                ],
+                "ApproximateAggregateValue": 0.5,
+                "Datapoints": [
+                    {
+                        "Timestamp": "2024-10-13T21:00:00+00:00",
+                        "ApproximateValue": 0.5
+                    }
+                ]
+            }
+        ],
+        "RuleAttributes": []
+    }
+
+For more information, see `Use Contributor Insights to analyze high-cardinality data <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/get-metric-data.rst

@@ -0,0 +1,106 @@
+**Example 1: To get the Average Total IOPS for the specified EC2 using math expression**
+
+The following ``get-metric-data`` example retrieves CloudWatch metric values for the EC2 instance with InstanceID ``i-abcdef`` using metric math exprssion that combines ``EBSReadOps`` and ``EBSWriteOps`` metrics. ::
+
+    aws cloudwatch get-metric-data \
+        --metric-data-queries file://file.json \
+        --start-time 2024-09-29T22:10:00Z \
+        --end-time 2024-09-29T22:15:00Z
+
+Contents of ``file.json``::
+
+    [
+        {
+            "Id": "m3",
+            "Expression": "(m1+m2)/300",
+            "Label": "Avg Total IOPS"
+        },
+        {
+            "Id": "m1",
+            "MetricStat": {
+                "Metric": {
+                    "Namespace": "AWS/EC2",
+                    "MetricName": "EBSReadOps",
+                    "Dimensions": [
+                        {
+                            "Name": "InstanceId",
+                            "Value": "i-abcdef"
+                        }
+                    ]
+                },
+                "Period": 300,
+                "Stat": "Sum",
+                "Unit": "Count"
+            },
+            "ReturnData": false
+        },
+        {
+            "Id": "m2",
+            "MetricStat": {
+                "Metric": {
+                    "Namespace": "AWS/EC2",
+                    "MetricName": "EBSWriteOps",
+                    "Dimensions": [
+                        {
+                            "Name": "InstanceId",
+                            "Value": "i-abcdef"
+                        }
+                    ]
+                },
+                "Period": 300,
+                "Stat": "Sum",
+                "Unit": "Count"
+            },
+            "ReturnData": false
+        }
+    ]
+
+Output::
+
+    {
+        "MetricDataResults": [
+            {
+                "Id": "m3",
+                "Label": "Avg Total IOPS",
+                "Timestamps": [
+                    "2024-09-29T22:10:00+00:00"
+                ],
+                "Values": [
+                    96.85
+                ],
+                "StatusCode": "Complete"
+            }
+        ],
+        "Messages": []
+    }
+
+**Example 2: To monitor the estimated AWS charges using CloudWatch billing metrics**
+
+The following ``get-metric-data`` example retrieves ``EstimatedCharges`` CloudWatch metric from AWS/Billing namespace. ::
+
+    aws cloudwatch get-metric-data \
+        --metric-data-queries '[{"Id":"m1","MetricStat":{"Metric":{"Namespace":"AWS/Billing","MetricName":"EstimatedCharges","Dimensions":[{"Name":"Currency","Value":"USD"}]},"Period":21600,"Stat":"Maximum"}}]' \
+        --start-time 2024-09-26T12:00:00Z \
+        --end-time 2024-09-26T18:00:00Z \
+        --region us-east-1
+
+Output::
+
+    {
+        "MetricDataResults": [
+            {
+                "Id": "m1",
+                "Label": "EstimatedCharges",
+                "Timestamps": [
+                    "2024-09-26T12:00:00+00:00"
+                ],
+                "Values": [
+                    542.38
+                ],
+                "StatusCode": "Complete"
+            }
+        ],
+        "Messages": []
+    }
+    
+For more information, see `Using math expressions with CloudWatch metrics <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/get-metric-stream.rst

@@ -0,0 +1,22 @@
+**To retrieve information about a metric stream**
+
+The following ``get-metric-stream`` example displays information about the metric stream named ``QuickFull-GuaFbs`` in the specified account. ::
+
+    aws cloudwatch get-metric-stream \
+        --name QuickFull-GuaFbs
+
+Output::
+
+    {
+        "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs",
+        "Name": "QuickFull-GuaFbs",
+        "FirehoseArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG",
+        "RoleArn": "arn:aws:iam::123456789012:role/service-role/MetricStreams-FirehosePutRecords-JN10W9B3",
+        "State": "running",
+        "CreationDate": "2024-10-11T18:48:59.187000+00:00",
+        "LastUpdateDate": "2024-10-11T18:48:59.187000+00:00",
+        "OutputFormat": "json",
+        "IncludeLinkedAccountsMetrics": false
+    }
+
+For more information, see `Use metric streams <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/get-metric-widget-image.rst

@@ -0,0 +1,10 @@
+**To retrieve a snapshot graph of CPUUtilization**
+
+The following ``get-metric-widget-image`` example retrieves snapshot graph for the metric ``CPUUtilization`` of the EC2 instance with the ID ``i-abcde`` and saves the retrieved image as a file named "image.png" on your local machine. ::
+
+    aws cloudwatch get-metric-widget-image \
+        --metric-widget '{"metrics":[["AWS/EC2","CPUUtilization","InstanceId","i-abcde"]]}' \
+        --output-format png \
+        --output text | base64 --decode > image.png
+
+This command produces no output.

awscli/examples/cloudwatch/list-dashboards.rst

@@ -0,0 +1,26 @@
+**To retrieve a list of Dashboards**
+
+The following ``list-dashboards`` example lists all the Dashboards in the specified account. ::
+
+    aws cloudwatch list-dashboards 
+
+Output::
+
+    {
+        "DashboardEntries": [
+            {
+                "DashboardName": "Dashboard-A",
+                "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-A",
+                "LastModified": "2024-10-11T18:40:11+00:00",
+                "Size": 271
+            },
+            {
+                "DashboardName": "Dashboard-B",
+                "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-B",
+                "LastModified": "2024-10-11T18:44:41+00:00",
+                "Size": 522
+            }
+        ]
+    }
+    
+For more information, see `Amazon CloudWatch dashboards <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/list-metric-streams.rst

@@ -0,0 +1,23 @@
+**To retrieve a list of metric streams**
+
+The following ``list-metric-streams`` example lists all the metric streams in the specified account. ::
+
+    aws cloudwatch list-metric-streams 
+
+Output::
+
+    {
+        "Entries": [
+            {
+                "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs",
+                "CreationDate": "2024-10-11T18:48:59.187000+00:00",
+                "LastUpdateDate": "2024-10-11T18:48:59.187000+00:00",
+                "Name": "QuickFull-GuaFbs",
+                "FirehoseArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG",
+                "State": "running",
+                "OutputFormat": "json"
+            }
+        ]
+    }
+
+For more information, see `Use metric streams <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/list-tags-for-resource.rst

@@ -0,0 +1,23 @@
+**To list the tags associated with an existing alarm***
+
+The following ``list-tags-for-resource`` example lists all the tags associated with an alarm named ``demo`` in the specified account. ::
+
+    aws cloudwatch list-tags-for-resource \
+        --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo
+
+Output::
+
+    {
+        "Tags": [
+            {
+                "Key": "stack",
+                "Value": "Production"
+            },
+            {
+                "Key": "team",
+                "Value": "Devops"
+            }
+        ]
+    }
+    
+For more information, see `Alarms and tagging <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarms_and_tagging.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/put-anomaly-detector.rst

@@ -0,0 +1,12 @@
+**To create an anomaly detection model**
+
+The following ``put-anomaly-detector`` example creates an anomaly detection model for a CloudWatch metric. ::
+
+    aws cloudwatch put-anomaly-detector \
+        --namespace AWS/Logs \
+        --metric-name IncomingBytes \
+        --stat SampleCount
+
+This command produces no output.
+
+For more information, see `Using CloudWatch anomaly detection <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Anomaly_Detection.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/put-composite-alarm.rst

@@ -0,0 +1,13 @@
+**To create a composite cloudwatch alarm**
+
+The following ``put-composite-alarm`` example creates a composite alarm named ``ProdAlarm``  in the specified account. ::
+
+    aws cloudwatch put-composite-alarm \
+        --alarm-name ProdAlarm \
+        --alarm-rule "ALARM(CPUUtilizationTooHigh) AND ALARM(MemUsageTooHigh)" \
+        --alarm-actions arn:aws:sns:us-east-1:123456789012:demo \
+        --actions-enabled
+
+This command produces no output.
+
+For more information, see `Create a composite alarm <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Composite_Alarm_How_To.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/put-dashboard.rst

@@ -0,0 +1,15 @@
+**To create a dashboard**
+
+The following ``put-dashboard`` example creates a dashboard named ``Dashboard-A`` in the specified account. ::
+
+    aws cloudwatch put-dashboard \
+        --dashboard-name Dashboard-A \
+        --dashboard-body '{"widgets":[{"height":6,"width":6,"y":0,"x":0,"type":"metric","properties":{"view":"timeSeries","stacked":false,"metrics":[["Namespace","CPUUtilization","Environment","Prod","Type","App"]],"region":"us-east-1"}}]}'
+
+Output::
+
+    {
+        "DashboardValidationMessages": []
+    }
+    
+For more information, see `Creating a CloudWatch dashboard <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create_dashboard.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/put-insight-rule.rst

@@ -0,0 +1,35 @@
+**To create a contributor insights rule**
+
+The following ``put-insight-rule`` example creates a Contributor Insights rule named ``VPCFlowLogsContributorInsights`` in the specified account. ::
+
+    aws cloudwatch put-insight-rule \
+        --rule-name VPCFlowLogsContributorInsights \
+        --rule-definition file://insight-rule.json \
+        --rule-state ENABLED
+
+Contents of ``insight-rule.json``::
+
+    {
+        "Schema": {
+            "Name": "CloudWatchLogRule",
+            "Version": 1
+        },
+        "AggregateOn": "Count",
+        "Contribution": {
+            "Filters": [],
+            "Keys": [
+                "tcp-flag"
+            ]
+        },
+        "LogFormat": "CLF",
+        "LogGroupNames": [
+            "/vpc/flowlogs/*"
+        ],
+        "Fields": {
+            "23": "tcp-flag"
+        }
+    }
+
+This command produces no output.
+
+For more information, see `Create a Contributor Insights rule in CloudWatch <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights-CreateRule.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/put-metric-stream.rst

@@ -0,0 +1,18 @@
+**To create a metric stream**
+
+The following ``put-metric-stream`` example creates a metric stream named ``QuickFull-GuaFb`` in the specified account. ::
+
+    aws cloudwatch put-metric-stream \
+        --name QuickFull-GuaFbs \
+        --firehose-arn arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG \
+        --role-arn arn:aws:iam::123456789012:role/service-role/MetricStreams-FirehosePutRecords-JN10W9B3 \
+        --output-format json \
+        --no-include-linked-accounts-metrics
+
+Output::
+
+    {
+        "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs"
+    }
+    
+For more information, see `Set up a metric stream <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-metric-streams-setup.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/start-metric-streams.rst

@@ -0,0 +1,10 @@
+**To start a specified metric stream**
+
+The following ``start-metric-streams`` example starts the metric stream named ``QuickFull-GuaFbs`` in the specified account. ::
+
+    aws cloudwatch start-metric-streams \
+        --names QuickFull-GuaFbs
+
+This command produces no output.
+
+For more information, see `Use metric streams <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/stop-metric-streams.rst

@@ -0,0 +1,10 @@
+**To stop a specified metric stream**
+
+The following ``stop-metric-streams`` example stops the metric stream named ``QuickFull-GuaFbs`` in the specified account. ::
+
+    aws cloudwatch stop-metric-streams \
+        --names QuickFull-GuaFbs
+
+This command produces no output.
+
+For more information, see `Use metric streams <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/tag-resource.rst

@@ -0,0 +1,11 @@
+**To add one or more tags to the specified resource**
+
+The following ``tag-resource`` example adds 2 tags to the cloudwatch alarm named ``demo`` in the specified account. ::
+
+    aws cloudwatch tag-resource \
+        --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo \
+        --tags Key=stack,Value=Production Key=team,Value=Devops
+
+This command produces no output.
+
+For more information, see `Tagging your Amazon CloudWatch resources <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/untag-resource.rst

@@ -0,0 +1,11 @@
+**To remove one or more tags from the specified resource**
+
+The following ``untag-resource`` example removes 2 tags from the cloudwatch alarm named ``demo`` in the specified account. ::
+
+    aws cloudwatch untag-resource \
+        --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo \
+        --tag-keys stack team
+
+This command produces no output.
+
+For more information, see `Tagging your Amazon CloudWatch resources <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/cloudwatch/wait/alarm-exists.rst

@@ -0,0 +1,8 @@
+**To wait until an alarm exists**
+
+The following ``wait alarm-exists`` example pauses and resumes running only after it confirms that the specified CloudWatch alarm exists. ::
+
+    aws cloudwatch wait alarm-exists \
+        --alarm-names demo
+
+This command produces no output.

awscli/examples/cloudwatch/wait/composite-alarm-exists.rst

@@ -0,0 +1,9 @@
+**To wait until a composite alarm exists**
+
+The following ``wait composite-alarm-exists`` example pauses and resumes running only after it confirms that the specified CloudWatch alarm exists. ::
+
+    aws cloudwatch wait composite-alarm-exists \
+        --alarm-names demo \
+        --alarm-types CompositeAlarm
+
+This command produces no output.

{awscli-1.36.10.dist-info → awscli-1.36.12.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: awscli
-Version: 1.36.10
+Version: 1.36.12
 Summary: Universal Command Line Environment for AWS.
 Home-page: http://aws.amazon.com/cli/
 Author: Amazon Web Services
@@ -23,7 +23,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >= 3.8
 License-File: LICENSE.txt
-Requires-Dist: botocore (==1.35.69)
+Requires-Dist: botocore (==1.35.71)
 Requires-Dist: docutils (<0.17,>=0.10)
 Requires-Dist: s3transfer (<0.11.0,>=0.10.0)
 Requires-Dist: PyYAML (<6.1,>=3.10)

{awscli-1.36.10.dist-info → awscli-1.36.12.dist-info}/RECORD

@@ -1,4 +1,4 @@
-awscli/__init__.py,sha256=fN-j4f8JLlFfTPEI-FL8dIrR_IxqJ-mZkl63aLj1uVo,1534
+awscli/__init__.py,sha256=6MxJEAQRsjRz2pYR3HcqMi4GxLiKBk1kEUulfseAyNM,1534
 awscli/__main__.py,sha256=iBjOg0tBxNlhzTi_tyc1G0SMGBvHMVvBJzX3JqYaooY,662
 awscli/alias.py,sha256=Us9pvP8Zplbr1W4N3rE5gxicWLqlRG3l_9VPskxafgs,11313
 awscli/argparser.py,sha256=3Pxx-vWytdV985Y6MIl9DeutUXyehIvACIs_PDby8GI,7650
@@ -900,16 +900,43 @@ awscli/examples/cloudtrail/update-subscription.rst,sha256=p2kF6eLCfGjqlrWGz9ZvUR
 awscli/examples/cloudtrail/update-trail.rst,sha256=szhXEmHstQfrZFoN_lnWj13M-_aJ2wyG46dHyBjrnDk,472
 awscli/examples/cloudtrail/validate-logs.rst,sha256=s-FpQPivasuD8oXopgbDcMXErMBoT6VVaqYTRBBPVQw,583
 awscli/examples/cloudwatch/delete-alarms.rst,sha256=BKs1LQkjwJ5NsXMvyKqLSwmewY4PPu8XkEWHxOgAskY,254
+awscli/examples/cloudwatch/delete-anomaly-detector.rst,sha256=WlTXIEpQdhKJFkA3HyDT9kP9eM0WOw7SycACDQvHaOw,578
+awscli/examples/cloudwatch/delete-dashboards.rst,sha256=DDw207V0PODPBp-I3DdoGhE2HEpHu4xYg7-MAb7Bz60,488
+awscli/examples/cloudwatch/delete-insight-rules.rst,sha256=7G1GekO4s0ZuC7J6uWVR5wMw8rnXjrBJ2g2X5FEp5kM,541
+awscli/examples/cloudwatch/delete-metric-stream.rst,sha256=0Ip3Re-Ize3iH1oy4ML15NOB4t3OWqjmvGO6CGgl71k,470
 awscli/examples/cloudwatch/describe-alarm-history.rst,sha256=nDAXGrqpi628a9-qkeNejUARZzP5hQWY60hCt1pHpds,1898
 awscli/examples/cloudwatch/describe-alarms-for-metric.rst,sha256=p-2dFjgRRhI2UaxuL5jyPM5tmq186SWRPRm3DvaHT8I,3562
 awscli/examples/cloudwatch/describe-alarms.rst,sha256=Xx62GZDNqLCWMqmwpfcoyFN384sD9D_TVxGtoD9s0u8,1751
+awscli/examples/cloudwatch/describe-anomaly-detectors.rst,sha256=Mb7qInil-SxlxqyKrzchaw52XOgBgn6A0yq29oNqWjk,2143
+awscli/examples/cloudwatch/describe-insight-rules.rst,sha256=-Ek0n68WWSBeQqX4irGx26B8xCMcp4XqYCngKaC3Qww,1591
 awscli/examples/cloudwatch/disable-alarm-actions.rst,sha256=zKpiELbmWk7HBvpusZYj1Hltzrl3N-0U0DhPWnS3eVE,270
+awscli/examples/cloudwatch/disable-insight-rules.rst,sha256=6f-NLto_A5-MX9sieCJLdyPyebgGPALAtsCy-w0uOCo,543
 awscli/examples/cloudwatch/enable-alarm-actions.rst,sha256=xcyA_t0kcw-eVVkLpdZiuicKwqW84sw4NTrN5sJIl8M,270
+awscli/examples/cloudwatch/enable-insight-rules.rst,sha256=CSgO6kZ18Q1LEaMmunfNHLPZ-g0UWEEAsf6psUAp-dQ,539
+awscli/examples/cloudwatch/get-dashboard.rst,sha256=UOdhUB0-39Y5bb90PuqGNTQifqjZLFsx7dTLD-CRlYw,894
+awscli/examples/cloudwatch/get-insight-rule-report.rst,sha256=JIFp8P5fQeSFwaBI-JJ_g5zHUxNkUcIr9Dy4X_LFdmk,1222
+awscli/examples/cloudwatch/get-metric-data.rst,sha256=VNu4aMEQ_HB6PF5EubzOCD8phN3xtNiSFD_PVywQpPE,3349
 awscli/examples/cloudwatch/get-metric-statistics.rst,sha256=2eW5dmXky_oYy7bgJKFyjfZ0_wDhvOsAmA3D1igPteg,4916
+awscli/examples/cloudwatch/get-metric-stream.rst,sha256=si8zJ0jnNcnu3xl8oaxbsVEeBOZC5-uWTvJGJ1ixIII,1059
+awscli/examples/cloudwatch/get-metric-widget-image.rst,sha256=PEC0-bkqlir2L8ilPLrTExKOklsv9NVtLWrBAGB9Tjc,545
+awscli/examples/cloudwatch/list-dashboards.rst,sha256=3GsC1-KNyZQkGgPP9y7JAznidHMj8p3v3XBblCb0T9w,939
+awscli/examples/cloudwatch/list-metric-streams.rst,sha256=oX4-OwQ8Gy5b_35DUPMGW3kaLKnYSBE-GkiUONuVWrA,938
 awscli/examples/cloudwatch/list-metrics.rst,sha256=OEtHygb7cFJKBa9B73FKLTM6Bwi7VSzt9tmJIdIJOds,2692
+awscli/examples/cloudwatch/list-tags-for-resource.rst,sha256=oIoy7Nq7Bu0NsVrwldhANOpNQkT1P1LT0ZBNYnopIYk,750
+awscli/examples/cloudwatch/put-anomaly-detector.rst,sha256=-1yQn3VKximNkbIwpp5A6oPn1h0LsT7e8tBF8FI1bts,528
+awscli/examples/cloudwatch/put-composite-alarm.rst,sha256=bfwlpImHP_SS1gCIeaW-GN2xJ6JEnwX9GLI0WPXo9jM,642
+awscli/examples/cloudwatch/put-dashboard.rst,sha256=SQHxZQiRb_2UjoLa1fKTKFWox1uXAqoyTMxlEebgK1o,711
+awscli/examples/cloudwatch/put-insight-rule.rst,sha256=eYjGZ9NH3gkkPUow_w-BqI2nA43YaxQTfVeN-ug0mDc,1080
 awscli/examples/cloudwatch/put-metric-alarm.rst,sha256=6VnpT0S0xIxdEO59HB4kPqXYUmmheOkWjWrrzQktjPQ,1412
 awscli/examples/cloudwatch/put-metric-data.rst,sha256=bLFC5gwHvntIXiGv0LFhRaEd7jC27sHqeWzl3cVtMgA,1126
+awscli/examples/cloudwatch/put-metric-stream.rst,sha256=DLQNw04DyuQxAwIcsYwP0O6QlHq1xGorGmXKZWlBxYw,842
 awscli/examples/cloudwatch/set-alarm-state.rst,sha256=rDkHfPCup5cx4j37z-Y2dF4xSl8jsbS07EYo0WdP5mY,401
+awscli/examples/cloudwatch/start-metric-streams.rst,sha256=F9ViY2cx46Y0KDSTO84q-LrL3A4uakis3b0IxICCPw8,462
+awscli/examples/cloudwatch/stop-metric-streams.rst,sha256=No0y7QeLnuKv9fT976kDgL-aLE01mNAevVxi2wjOwXE,458
+awscli/examples/cloudwatch/tag-resource.rst,sha256=Zwv6LHMNEcoU1c3cs-mw1aJzWvm8yNDiejr6r8sM7rI,584
+awscli/examples/cloudwatch/untag-resource.rst,sha256=m6mYf5jiqnnZSnmx5Ak3Mb0nTgzcO0fhpuw9baeC2A4,564
+awscli/examples/cloudwatch/wait/alarm-exists.rst,sha256=LaDbfk6p3-Dt-ZR1RXC1liMmHOiPD8Q77au_4OBsJfY,277
+awscli/examples/cloudwatch/wait/composite-alarm-exists.rst,sha256=_u-DynBA2deK8AA7yUMxex1Qvpik1BPSBLfy_wfVBDM,345
 awscli/examples/codeartifact/associate-external-connection.rst,sha256=X3ZzxvsXOBiBOF3ltcu730BCU3o7TplaAf8NZriuEbg,1107
 awscli/examples/codeartifact/copy-package-versions.rst,sha256=FJJIGEg8BsrtZTvofwzC_xVVcsIh_4YITw449mDsBq0,1053
 awscli/examples/codeartifact/create-domain.rst,sha256=9WQbaFrHUF-W4900jdgDZ3slNDZsSQkTe4H4FKuodsI,805
@@ -5956,13 +5983,13 @@ awscli/topics/return-codes.rst,sha256=d9lpNFZwD75IiYcDEADQzu-4QiR8P28UPHkrNwPV5J
 awscli/topics/s3-config.rst,sha256=FwwCczTylrSLwELuDQ-VA8sCI7ruwV9PEJJrqxjUeG0,11502
 awscli/topics/s3-faq.rst,sha256=sS5jKHF_7X5eiGwpUg7aTqQt2zCRN-m_xXOcE0Bme0Q,1899
 awscli/topics/topic-tags.json,sha256=6lUSrs3FKCZNRSQMnjcXNgWyRNGjZIeur1988a4IO5o,1577
-awscli-1.36.10.data/scripts/aws,sha256=r24FExgs0-JjILTQ3XZAqXBYE4SV6UMTtALkLGAj86g,805
-awscli-1.36.10.data/scripts/aws.cmd,sha256=s46DkC6LNgX63CIkzxxbPnFMJ6DRDBkvc88GnWa8Pvg,1432
-awscli-1.36.10.data/scripts/aws_bash_completer,sha256=RRpoEGJRagRzyHZKZZOwpltuVYv2EoiZsdXhmyWPZ54,204
-awscli-1.36.10.data/scripts/aws_completer,sha256=oC9kuMDlWE47dWk_4xjPde2PQvN-M0vND0J4YSLabVQ,1126
-awscli-1.36.10.data/scripts/aws_zsh_completer.sh,sha256=Qm6Z8ejNAMzpJjaT0pzqxbSDT2zxdmzVe5haRA7qLoc,1808
-awscli-1.36.10.dist-info/LICENSE.txt,sha256=o5XhFlwu0OK_BBrijlKCRa7dQAm36UrUB3gCV_cEr8E,549
-awscli-1.36.10.dist-info/METADATA,sha256=qcDEDCWrlYHxZ90Octx4T-Ahtmv4rSbGmpvdZDVsOCE,11331
-awscli-1.36.10.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
-awscli-1.36.10.dist-info/top_level.txt,sha256=vt9wXFr1_nGYK6abhJgt6zY3fULe4JSZedm_5XOM9S0,7
-awscli-1.36.10.dist-info/RECORD,,
+awscli-1.36.12.data/scripts/aws,sha256=r24FExgs0-JjILTQ3XZAqXBYE4SV6UMTtALkLGAj86g,805
+awscli-1.36.12.data/scripts/aws.cmd,sha256=s46DkC6LNgX63CIkzxxbPnFMJ6DRDBkvc88GnWa8Pvg,1432
+awscli-1.36.12.data/scripts/aws_bash_completer,sha256=RRpoEGJRagRzyHZKZZOwpltuVYv2EoiZsdXhmyWPZ54,204
+awscli-1.36.12.data/scripts/aws_completer,sha256=oC9kuMDlWE47dWk_4xjPde2PQvN-M0vND0J4YSLabVQ,1126
+awscli-1.36.12.data/scripts/aws_zsh_completer.sh,sha256=Qm6Z8ejNAMzpJjaT0pzqxbSDT2zxdmzVe5haRA7qLoc,1808
+awscli-1.36.12.dist-info/LICENSE.txt,sha256=o5XhFlwu0OK_BBrijlKCRa7dQAm36UrUB3gCV_cEr8E,549
+awscli-1.36.12.dist-info/METADATA,sha256=ScS_sEK-9ZAGBL_eFQj9FxGY07odU3N67eKsqp5iywM,11331
+awscli-1.36.12.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
+awscli-1.36.12.dist-info/top_level.txt,sha256=vt9wXFr1_nGYK6abhJgt6zY3fULe4JSZedm_5XOM9S0,7
+awscli-1.36.12.dist-info/RECORD,,