DeleteDashboards与 AWS SDK 或 CLI 配合使用

以下代码示例演示如何使用 DeleteDashboards。

操作示例是大型程序的代码摘录，必须在上下文中运行。在以下代码示例中，您可以查看此操作的上下文：

• 了解基础知识

.NET

AWS SDK for .NET

注意

还有更多相关信息 GitHub。查找完整示例，学习如何在 AWS 代码示例存储库中进行设置和运行。

    /// <summary>
    /// Delete a list of CloudWatch dashboards.
    /// </summary>
    /// <param name="dashboardNames">List of dashboard names to delete.</param>
    /// <returns>True if successful.</returns>
    public async Task<bool> DeleteDashboards(List<string> dashboardNames)
    {
        var deleteDashboardsResponse = await _amazonCloudWatch.DeleteDashboardsAsync(
            new DeleteDashboardsRequest()
            {
                DashboardNames = dashboardNames
            });

        return deleteDashboardsResponse.HttpStatusCode == HttpStatusCode.OK;
    }

• 有关 API 的详细信息，请参阅 AWS SDK for .NET API 参考DeleteDashboards中的。

CLI

AWS CLI

删除指定的控制面板

以下 delete-dashboards 示例删除了指定账户中名为 Dashboard-A 和 Dashboard-B 的两个控制面板。

aws cloudwatch delete-dashboards \
    --dashboard-names Dashboard-A Dashboard-B

此命令不生成任何输出。

有关更多信息，请参阅《亚马逊 CloudWatch 用户指南》中的亚马逊 CloudWatch 控制面板。

• 有关 API 的详细信息，请参阅AWS CLI 命令参考DeleteDashboards中的。

Java

适用于 Java 的 SDK 2.x

注意

还有更多相关信息 GitHub。查找完整示例，学习如何在 AWS 代码示例存储库中进行设置和运行。

    /**
     * Deletes the specified dashboard.
     *
     * @param dashboardName the name of the dashboard to be deleted
     * @return a {@link CompletableFuture} representing the asynchronous operation of deleting the dashboard
     * @throws RuntimeException if the dashboard deletion fails
     */
    public CompletableFuture<DeleteDashboardsResponse> deleteDashboardAsync(String dashboardName) {
        DeleteDashboardsRequest dashboardsRequest = DeleteDashboardsRequest.builder()
            .dashboardNames(dashboardName)
            .build();

        return getAsyncClient().deleteDashboards(dashboardsRequest)
            .whenComplete((response, exception) -> {
                if (exception != null) {
                    throw new RuntimeException("Failed to delete the dashboard: " + dashboardName, exception);
                } else {
                    logger.info("{} was successfully deleted.", dashboardName);
                }
            });
    }

• 有关 API 的详细信息，请参阅 AWS SDK for Java 2.x API 参考DeleteDashboards中的。

Kotlin

适用于 Kotlin 的 SDK

注意

还有更多相关信息 GitHub。查找完整示例，学习如何在 AWS 代码示例存储库中进行设置和运行。

suspend fun deleteDashboard(dashboardName: String) {
    val dashboardsRequest =
        DeleteDashboardsRequest {
            dashboardNames = listOf(dashboardName)
        }
    CloudWatchClient { region = "us-east-1" }.use { cwClient ->
        cwClient.deleteDashboards(dashboardsRequest)
        println("$dashboardName was successfully deleted.")
    }
}

• 有关 API 的详细信息，请参阅适用DeleteDashboards于 K otlin 的AWS SDK API 参考。

PowerShell

用于 PowerShell

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

Remove-CWDashboard -DashboardName Dashboard1

• 有关 API 的详细信息，请参阅 AWS Tools for PowerShell Cmdlet 参考DeleteDashboards中的。