import { Command as $Command } from "@smithy/smithy-client"; import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { CloudWatchClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudWatchClient"; import type { ListMetricsInput, ListMetricsOutput } from "../models/models_0"; /** * @public */ export type { __MetadataBearer }; export { $Command }; /** * @public * * The input for {@link ListMetricsCommand}. */ export interface ListMetricsCommandInput extends ListMetricsInput { } /** * @public * * The output of {@link ListMetricsCommand}. */ export interface ListMetricsCommandOutput extends ListMetricsOutput, __MetadataBearer { } declare const ListMetricsCommand_base: { new (input: ListMetricsCommandInput): import("@smithy/smithy-client").CommandImpl; new (...[input]: [] | [ListMetricsCommandInput]): import("@smithy/smithy-client").CommandImpl; getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions; }; /** *

List the specified metrics. You can use the returned metrics with GetMetricData or GetMetricStatistics to get statistical data.

*

Up to 500 results are returned for any one call. To retrieve additional results, * use the returned token with subsequent calls.

*

After you create a metric, allow up to 15 minutes for the metric to appear. To see * metric statistics sooner, use GetMetricData or GetMetricStatistics.

*

If you are using CloudWatch cross-account observability, you can use this * operation in a monitoring account and view metrics from the linked source accounts. For * more information, see CloudWatch cross-account observability.

*

* ListMetrics doesn't return information about metrics if those metrics * haven't reported data in the past two weeks. To retrieve those metrics, use GetMetricData or GetMetricStatistics.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { CloudWatchClient, ListMetricsCommand } from "@aws-sdk/client-cloudwatch"; // ES Modules import * // const { CloudWatchClient, ListMetricsCommand } = require("@aws-sdk/client-cloudwatch"); // CommonJS import * // import type { CloudWatchClientConfig } from "@aws-sdk/client-cloudwatch"; * const config = {}; // type is CloudWatchClientConfig * const client = new CloudWatchClient(config); * const input = { // ListMetricsInput * Namespace: "STRING_VALUE", * MetricName: "STRING_VALUE", * Dimensions: [ // DimensionFilters * { // DimensionFilter * Name: "STRING_VALUE", // required * Value: "STRING_VALUE", * }, * ], * NextToken: "STRING_VALUE", * RecentlyActive: "PT3H", * IncludeLinkedAccounts: true || false, * OwningAccount: "STRING_VALUE", * }; * const command = new ListMetricsCommand(input); * const response = await client.send(command); * // { // ListMetricsOutput * // Metrics: [ // Metrics * // { // Metric * // Namespace: "STRING_VALUE", * // MetricName: "STRING_VALUE", * // Dimensions: [ // Dimensions * // { // Dimension * // Name: "STRING_VALUE", // required * // Value: "STRING_VALUE", // required * // }, * // ], * // }, * // ], * // NextToken: "STRING_VALUE", * // OwningAccounts: [ // OwningAccounts * // "STRING_VALUE", * // ], * // }; * * ``` * * @param ListMetricsCommandInput - {@link ListMetricsCommandInput} * @returns {@link ListMetricsCommandOutput} * @see {@link ListMetricsCommandInput} for command's `input` shape. * @see {@link ListMetricsCommandOutput} for command's `response` shape. * @see {@link CloudWatchClientResolvedConfig | config} for CloudWatchClient's `config` shape. * * @throws {@link InternalServiceFault} (server fault) *

Request processing has failed due to some unknown error, exception, or * failure.

* * @throws {@link InvalidParameterValueException} (client fault) *

The value of an input parameter is bad or out-of-range.

* * @throws {@link CloudWatchServiceException} *

Base exception class for all service exceptions from CloudWatch service.

* * * @public */ export declare class ListMetricsCommand extends ListMetricsCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: ListMetricsInput; output: ListMetricsOutput; }; sdk: { input: ListMetricsCommandInput; output: ListMetricsCommandOutput; }; }; }