文档 AWS SDK 示例 GitHub 存储库中还有更多 [S AWS DK 示例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# `GetMetricWidgetImage`与 AWS SDK 或 CLI 配合使用
以下代码示例演示如何使用 `GetMetricWidgetImage`。
操作示例是大型程序的代码摘录，必须在上下文中运行。在以下代码示例中，您可以查看此操作的上下文：
+ [了解基本功能](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)中查找完整示例，了解如何进行设置和运行。
```
///
/// Get an image for a metric graphed over time.
///
/// The namespace of the metric.
/// The name of the metric.
/// The name of the stat to chart.
/// The period to use for the chart.
/// A memory stream for the chart image.
public async Task GetTimeSeriesMetricImage(string metricNamespace, string metric, string stat, int period)
{
var metricImageWidget = new
{
title = "Example Metric Graph",
view = "timeSeries",
stacked = false,
period = period,
width = 1400,
height = 600,
metrics = new List>
{ new() { metricNamespace, metric, new { stat } } }
};
var metricImageWidgetString = JsonSerializer.Serialize(metricImageWidget);
var imageResponse = await _amazonCloudWatch.GetMetricWidgetImageAsync(
new GetMetricWidgetImageRequest()
{
MetricWidget = metricImageWidgetString
});
return imageResponse.MetricWidgetImage;
}
///
/// Save a metric image to a file.
///
/// The MemoryStream for the metric image.
/// The name of the metric.
/// The path to the file.
public string SaveMetricImage(MemoryStream memoryStream, string metricName)
{
var metricFileName = $"{metricName}_{DateTime.Now.Ticks}.png";
using var sr = new StreamReader(memoryStream);
// Writes the memory stream to a file.
File.WriteAllBytes(metricFileName, memoryStream.ToArray());
var filePath = Path.Join(AppDomain.CurrentDomain.BaseDirectory,
metricFileName);
return filePath;
}
```
+ 有关 API 的详细信息，请参阅 *适用于 .NET 的 AWS SDK API 参考[GetMetricWidgetImage](https://docs.aws.amazon.com/goto/DotNetSDKV4/monitoring-2010-08-01/GetMetricWidgetImage)*中的。
------
#### [ CLI ]
**AWS CLI**
**要检索的快照图 CPUUtilization**
以下 `get-metric-widget-image` 示例检索 ID 为 `i-abcde` 的 EC2 实例的指标 `CPUUtilization` 快照图，并将检索到的图像保存为本地计算机上名为“image.png”的文件。
```
aws cloudwatch get-metric-widget-image \
--metric-widget '{"metrics":[["AWS/EC2","CPUUtilization","InstanceId","i-abcde"]]}' \
--output-format png \
--output text | base64 --decode > image.png
```
此命令不生成任何输出。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[GetMetricWidgetImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-widget-image.html)*中的。
------
#### [ Java ]
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/cloudwatch#code-examples)中查找完整示例，了解如何进行设置和运行。
```
/**
* Retrieves and saves a custom metric image to a file.
*
* @param fileName the name of the file to save the metric image to
* @return a {@link CompletableFuture} that completes when the image has been saved to the file
*/
public CompletableFuture downloadAndSaveMetricImageAsync(String fileName) {
logger.info("Getting Image data for custom metric.");
String myJSON = """
{
"title": "Example Metric Graph",
"view": "timeSeries",
"stacked ": false,
"period": 10,
"width": 1400,
"height": 600,
"metrics": [
[
"AWS/Billing",
"EstimatedCharges",
"Currency",
"USD"
]
]
}
""";
GetMetricWidgetImageRequest imageRequest = GetMetricWidgetImageRequest.builder()
.metricWidget(myJSON)
.build();
return getAsyncClient().getMetricWidgetImage(imageRequest)
.thenCompose(response -> {
SdkBytes sdkBytes = response.metricWidgetImage();
byte[] bytes = sdkBytes.asByteArray();
return CompletableFuture.runAsync(() -> {
try {
File outputFile = new File(fileName);
try (FileOutputStream outputStream = new FileOutputStream(outputFile)) {
outputStream.write(bytes);
}
} catch (IOException e) {
throw new RuntimeException("Failed to write image to file", e);
}
});
})
.whenComplete((result, exception) -> {
if (exception != null) {
throw new RuntimeException("Error getting and saving metric image", exception);
} else {
logger.info("Image data saved successfully to {}", fileName);
}
});
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[GetMetricWidgetImage](https://docs.aws.amazon.com/goto/SdkForJavaV2/monitoring-2010-08-01/GetMetricWidgetImage)*中的。
------
#### [ Kotlin ]
**适用于 Kotlin 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/cloudwatch#code-examples)中查找完整示例，了解如何进行设置和运行。
```
suspend fun getAndOpenMetricImage(fileName: String) {
println("Getting Image data for custom metric.")
val myJSON = """{
"title": "Example Metric Graph",
"view": "timeSeries",
"stacked ": false,
"period": 10,
"width": 1400,
"height": 600,
"metrics": [
[
"AWS/Billing",
"EstimatedCharges",
"Currency",
"USD"
]
]
}"""
val imageRequest =
GetMetricWidgetImageRequest {
metricWidget = myJSON
}
CloudWatchClient.fromEnvironment { region = "us-east-1" }.use { cwClient ->
val response = cwClient.getMetricWidgetImage(imageRequest)
val bytes = response.metricWidgetImage
if (bytes != null) {
File(fileName).writeBytes(bytes)
}
}
println("You have successfully written data to $fileName")
}
```
+ 有关 API 的详细信息，请参阅适用[GetMetricWidgetImage](https://sdk.amazonaws.com/kotlin/api/latest/index.html)于 K *otlin 的AWS SDK API 参考*。
------