使用 Tools for PowerShell V5 的 CloudWatch 範例 - AWS SDK 程式碼範例
動作

AWS文件開發套件範例 GitHub 儲存庫中有更多可用的 AWS SDK 範例。

使用 Tools for PowerShell V5 的 CloudWatch 範例

下列程式碼範例示範如何搭配使用 AWS Tools for PowerShell V5 和 CloudWatch 來執行動作，並實作常見案例。

Actions 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。

每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。

主題

動作

以下程式碼範例顯示如何使用 Get-CWDashboard。

Tools for PowerShell V5

範例 1：傳回指定儀表板內文的 arn。

Get-CWDashboard -DashboardName Dashboard1

輸出：

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

  • 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V5)》中的 GetDashboard。

以下程式碼範例顯示如何使用 Get-CWDashboardList。

Tools for 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 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V5)》中的 ListDashboards。

以下程式碼範例顯示如何使用 Remove-CWDashboard。

Tools for PowerShell V5

範例 1：刪除指定儀表板，並在執行前要求確認。若要略過確認，請將 -Force 切換變數新增至命令。

Remove-CWDashboard -DashboardName Dashboard1

  • 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V5)》中的 DeleteDashboards。

以下程式碼範例顯示如何使用 Write-CWDashboard。

Tools for 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 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V5)》中的 PutDashboard。

以下程式碼範例顯示如何使用 Write-CWMetricData。

Tools for PowerShell V5

範例 1：建立新的 MetricDatum 物件，並將其寫入 Amazon Web Services CloudWatch 指標。

### 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 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V5)》中的 PutMetricData。