文档 AWS SDK 示例 GitHub 存储库中还有更多 [S AWS DK 示例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# `PutDashboard`与 AWS SDK 或 CLI 配合使用
以下代码示例演示如何使用 `PutDashboard`。
操作示例是大型程序的代码摘录，必须在上下文中运行。在以下代码示例中，您可以查看此操作的上下文：
+ [了解基本功能](cloudwatch_example_cloudwatch_GetStartedMetricsDashboardsAlarms_section.md)
------
#### [ .NET ]
**适用于 .NET 的 SDK (v4)**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv4/CloudWatch#code-examples)中查找完整示例，了解如何进行设置和运行。
```
///
/// Set up a dashboard using a call to the wrapper class.
///
/// The metric namespace.
/// The metric name.
/// The name of the dashboard.
/// A list of validation messages.
private static async Task> SetupDashboard(
string customMetricNamespace, string customMetricName, string dashboardName)
{
// Get the dashboard model from configuration.
var newDashboard = new DashboardModel();
_configuration.GetSection("dashboardExampleBody").Bind(newDashboard);
// Add a new metric to the dashboard.
newDashboard.Widgets.Add(new Widget
{
Height = 8,
Width = 8,
Y = 8,
X = 0,
Type = "metric",
Properties = new Properties
{
Metrics = new List>
{ new() { customMetricNamespace, customMetricName } },
View = "timeSeries",
Region = "us-east-1",
Stat = "Sum",
Period = 86400,
YAxis = new YAxis { Left = new Left { Min = 0, Max = 100 } },
Title = "Custom Metric Widget",
LiveData = true,
Sparkline = true,
Trend = true,
Stacked = false,
SetPeriodToTimeRange = false
}
});
var newDashboardString = JsonSerializer.Serialize(newDashboard,
new JsonSerializerOptions
{ DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull });
var validationMessages =
await _cloudWatchWrapper.PutDashboard(dashboardName, newDashboardString);
return validationMessages;
}
///
/// Wrapper to create or add to a dashboard with metrics.
///
/// The name for the dashboard.
/// The metric data in JSON for the dashboard.
/// A list of validation messages for the dashboard.
public async Task> PutDashboard(string dashboardName,
string dashboardBody)
{
// Updating a dashboard replaces all contents.
// Best practice is to include a text widget indicating this dashboard was created programmatically.
var dashboardResponse = await _amazonCloudWatch.PutDashboardAsync(
new PutDashboardRequest()
{
DashboardName = dashboardName,
DashboardBody = dashboardBody
});
return dashboardResponse.DashboardValidationMessages ?? new List();
}
```
+ 有关 API 的详细信息，请参阅 *适用于 .NET 的 AWS SDK API 参考[PutDashboard](https://docs.aws.amazon.com/goto/DotNetSDKV4/monitoring-2010-08-01/PutDashboard)*中的。
------
#### [ CLI ]
**AWS CLI**
**创建控制面板**
以下 `put-dashboard` 示例在指定账户中创建了名为 `Dashboard-A` 的控制面板。
```
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"}}]}'
```
输出：
```
{
"DashboardValidationMessages": []
}
```
有关更多信息，请参阅 *Amazon CloudWatch 用户指南*中的[创建 CloudWatch 控制面板](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create_dashboard.html)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[PutDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-dashboard.html)*中的。
------
#### [ Java ]
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/cloudwatch#code-examples)中查找完整示例，了解如何进行设置和运行。
```
/**
* Creates a new dashboard with the specified name and metrics from the given file.
*
* @param dashboardName the name of the dashboard to be created
* @param fileName the name of the file containing the dashboard body
* @return a {@link CompletableFuture} representing the asynchronous operation of creating the dashboard
* @throws IOException if there is an error reading the dashboard body from the file
*/
public CompletableFuture createDashboardWithMetricsAsync(String dashboardName, String fileName) throws IOException {
String dashboardBody = readFileAsString(fileName);
PutDashboardRequest dashboardRequest = PutDashboardRequest.builder()
.dashboardName(dashboardName)
.dashboardBody(dashboardBody)
.build();
return getAsyncClient().putDashboard(dashboardRequest)
.handle((response, ex) -> {
if (ex != null) {
logger.info("Failed to create dashboard: {}", ex.getMessage());
throw new RuntimeException("Dashboard creation failed", ex);
} else {
// Handle the normal response case
logger.info("{} was successfully created.", dashboardName);
List messages = response.dashboardValidationMessages();
if (messages.isEmpty()) {
logger.info("There are no messages in the new Dashboard.");
} else {
for (DashboardValidationMessage message : messages) {
logger.info("Message: {}", message.message());
}
}
return response; // Return the response for further use
}
});
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[PutDashboard](https://docs.aws.amazon.com/goto/SdkForJavaV2/monitoring-2010-08-01/PutDashboard)*中的。
------
#### [ Kotlin ]
**适用于 Kotlin 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/cloudwatch#code-examples)中查找完整示例，了解如何进行设置和运行。
```
suspend fun createDashboardWithMetrics(
dashboardNameVal: String,
fileNameVal: String,
) {
val dashboardRequest =
PutDashboardRequest {
dashboardName = dashboardNameVal
dashboardBody = readFileAsString(fileNameVal)
}
CloudWatchClient.fromEnvironment { region = "us-east-1" }.use { cwClient ->
val response = cwClient.putDashboard(dashboardRequest)
println("$dashboardNameVal was successfully created.")
val messages = response.dashboardValidationMessages
if (messages != null) {
if (messages.isEmpty()) {
println("There are no messages in the new Dashboard")
} else {
for (message in messages) {
println("Message is: ${message.message}")
}
}
}
}
}
```
+ 有关 API 的详细信息，请参阅适用[PutDashboard](https://sdk.amazonaws.com/kotlin/api/latest/index.html)于 K *otlin 的AWS SDK API 参考*。
------
#### [ PowerShell ]
**适用于 PowerShell V4 的工具**
**示例 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 参考 (V* 4) [PutDashboard](https://docs.aws.amazon.com/powershell/v4/reference)中的。
**适用于 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 参考 (V* 5) [PutDashboard](https://docs.aws.amazon.com/powershell/v5/reference)中的。
------