CloudWatch 使用适用于 PowerShell V5 的工具的示例 - Amazon Tools for PowerShell （版本 5）
操作
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

的版本 5 (V5) Amazon Tools for PowerShell 已经发布！

有关重大更改和迁移应用程序的信息，请参阅迁移主题。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

CloudWatch 使用适用于 PowerShell V5 的工具的示例

以下代码示例向您展示了如何使用带 CloudWatch的 Amazon Tools for PowerShell V5 来执行操作和实现常见场景。

操作是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。

每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。

主题

操作

以下代码示例演示了如何使用 Get-CWDashboard。

适用于 PowerShell V5 的工具

示例 1：返回指定控制面板的正文 arn。

Get-CWDashboard -DashboardName Dashboard1

输出：

DashboardArn                                          DashboardBody
------------                                          -------------
arn:aws:cloudwatch::123456789012:dashboard/Dashboard1 {...

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 5) GetDashboard中的。

以下代码示例演示了如何使用 Get-CWDashboardList。

适用于 PowerShell V5 的工具

示例 1：返回您账户的控制面板集合。

Get-CWDashboardList

输出：

DashboardArn DashboardName LastModified        Size
------------ ------------- ------------        ----
arn:...      Dashboard1    7/6/2017 8:14:15 PM 252

示例 2：返回名称以前缀“dev”开头的账户的控制面板集合。

Get-CWDashboardList -DashboardNamePrefix dev

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 5) ListDashboards中的。

以下代码示例演示了如何使用 Remove-CWDashboard。

适用于 PowerShell V5 的工具

示例 1：删除指定的控制面板，继续操作前提示确认。要绕过确认，请在命令中添加 -Force 开关。

Remove-CWDashboard -DashboardName Dashboard1

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 5) DeleteDashboards中的。

以下代码示例演示了如何使用 Write-CWDashboard。

适用于 PowerShell V5 的工具

示例 1：创建或更新名为“Dashboard1”的控制面板，以包含两个并排的指标小部件。

$dashBody = @"
{
    "widgets":[
        {
             "type":"metric",
             "x":0,
             "y":0,
             "width":12,
             "height":6,
             "properties":{
                "metrics":[
                   [
                      "AWS/EC2",
                      "CPUUtilization",
                      "InstanceId",
                      "i-012345"
                   ]
                ],
                "period":300,
                "stat":"Average",
                "region":"us-east-1",
                "title":"EC2 Instance CPU"
             }
        },
        {
             "type":"metric",
             "x":12,
             "y":0,
             "width":12,
             "height":6,
             "properties":{
                "metrics":[
                   [
                      "AWS/S3",
                      "BucketSizeBytes",
                      "BucketName",
                      "amzn-s3-demo-bucket"
                   ]
                ],
                "period":86400,
                "stat":"Maximum",
                "region":"us-east-1",
                "title":"amzn-s3-demo-bucket bytes"
            }
        }
    ]
}
"@

Write-CWDashboard -DashboardName Dashboard1 -DashboardBody $dashBody

示例 2：创建或更新控制面板，将描述控制面板的内容通过管道传输到 cmdlet 中。

$dashBody = @"
{
...
}
"@
        
$dashBody | Write-CWDashboard -DashboardName Dashboard1

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 5) PutDashboard中的。

以下代码示例演示了如何使用 Write-CWMetricData。

适用于 PowerShell V5 的工具

示例 1：创建新 MetricDatum 对象并将其写入 Amazon Web Serv CloudWatch ices 指标。

### Create a MetricDatum .NET object
$Metric = New-Object -TypeName Amazon.CloudWatch.Model.MetricDatum
$Metric.Timestamp = [DateTime]::UtcNow
$Metric.MetricName = 'CPU'
$Metric.Value = 50

### Write the metric data to the CloudWatch service
Write-CWMetricData -Namespace instance1 -MetricData $Metric

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 5) PutMetricData中的。