import { Command as $Command } from "@smithy/smithy-client"; import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { CostExplorerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CostExplorerClient"; import type { GetCostAndUsageComparisonsRequest, GetCostAndUsageComparisonsResponse } from "../models/models_0"; /** * @public */ export type { __MetadataBearer }; export { $Command }; /** * @public * * The input for {@link GetCostAndUsageComparisonsCommand}. */ export interface GetCostAndUsageComparisonsCommandInput extends GetCostAndUsageComparisonsRequest { } /** * @public * * The output of {@link GetCostAndUsageComparisonsCommand}. */ export interface GetCostAndUsageComparisonsCommandOutput extends GetCostAndUsageComparisonsResponse, __MetadataBearer { } declare const GetCostAndUsageComparisonsCommand_base: { new (input: GetCostAndUsageComparisonsCommandInput): import("@smithy/smithy-client").CommandImpl; new (input: GetCostAndUsageComparisonsCommandInput): import("@smithy/smithy-client").CommandImpl; getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions; }; /** *

Retrieves cost and usage comparisons for your account between two periods within the last * 13 months. If you have enabled multi-year data at monthly granularity, you can go back up to * 38 months.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { CostExplorerClient, GetCostAndUsageComparisonsCommand } from "@aws-sdk/client-cost-explorer"; // ES Modules import * // const { CostExplorerClient, GetCostAndUsageComparisonsCommand } = require("@aws-sdk/client-cost-explorer"); // CommonJS import * // import type { CostExplorerClientConfig } from "@aws-sdk/client-cost-explorer"; * const config = {}; // type is CostExplorerClientConfig * const client = new CostExplorerClient(config); * const input = { // GetCostAndUsageComparisonsRequest * BillingViewArn: "STRING_VALUE", * BaselineTimePeriod: { // DateInterval * Start: "STRING_VALUE", // required * End: "STRING_VALUE", // required * }, * ComparisonTimePeriod: { * Start: "STRING_VALUE", // required * End: "STRING_VALUE", // required * }, * MetricForComparison: "STRING_VALUE", // required * Filter: { // Expression * Or: [ // Expressions * { * Or: [ * "", * ], * And: [ * "", * ], * Not: "", * Dimensions: { // DimensionValues * Key: "AZ" || "INSTANCE_TYPE" || "LINKED_ACCOUNT" || "PAYER_ACCOUNT" || "LINKED_ACCOUNT_NAME" || "OPERATION" || "PURCHASE_TYPE" || "REGION" || "SERVICE" || "SERVICE_CODE" || "USAGE_TYPE" || "USAGE_TYPE_GROUP" || "RECORD_TYPE" || "OPERATING_SYSTEM" || "TENANCY" || "SCOPE" || "PLATFORM" || "SUBSCRIPTION_ID" || "LEGAL_ENTITY_NAME" || "DEPLOYMENT_OPTION" || "DATABASE_ENGINE" || "CACHE_ENGINE" || "INSTANCE_TYPE_FAMILY" || "BILLING_ENTITY" || "RESERVATION_ID" || "RESOURCE_ID" || "RIGHTSIZING_TYPE" || "SAVINGS_PLANS_TYPE" || "SAVINGS_PLAN_ARN" || "PAYMENT_OPTION" || "AGREEMENT_END_DATE_TIME_AFTER" || "AGREEMENT_END_DATE_TIME_BEFORE" || "INVOICING_ENTITY" || "ANOMALY_TOTAL_IMPACT_ABSOLUTE" || "ANOMALY_TOTAL_IMPACT_PERCENTAGE", * Values: [ // Values * "STRING_VALUE", * ], * MatchOptions: [ // MatchOptions * "EQUALS" || "ABSENT" || "STARTS_WITH" || "ENDS_WITH" || "CONTAINS" || "CASE_SENSITIVE" || "CASE_INSENSITIVE" || "GREATER_THAN_OR_EQUAL", * ], * }, * Tags: { // TagValues * Key: "STRING_VALUE", * Values: [ * "STRING_VALUE", * ], * MatchOptions: [ * "EQUALS" || "ABSENT" || "STARTS_WITH" || "ENDS_WITH" || "CONTAINS" || "CASE_SENSITIVE" || "CASE_INSENSITIVE" || "GREATER_THAN_OR_EQUAL", * ], * }, * CostCategories: { // CostCategoryValues * Key: "STRING_VALUE", * Values: [ * "STRING_VALUE", * ], * MatchOptions: [ * "EQUALS" || "ABSENT" || "STARTS_WITH" || "ENDS_WITH" || "CONTAINS" || "CASE_SENSITIVE" || "CASE_INSENSITIVE" || "GREATER_THAN_OR_EQUAL", * ], * }, * }, * ], * And: [ * "", * ], * Not: "", * Dimensions: { * Key: "AZ" || "INSTANCE_TYPE" || "LINKED_ACCOUNT" || "PAYER_ACCOUNT" || "LINKED_ACCOUNT_NAME" || "OPERATION" || "PURCHASE_TYPE" || "REGION" || "SERVICE" || "SERVICE_CODE" || "USAGE_TYPE" || "USAGE_TYPE_GROUP" || "RECORD_TYPE" || "OPERATING_SYSTEM" || "TENANCY" || "SCOPE" || "PLATFORM" || "SUBSCRIPTION_ID" || "LEGAL_ENTITY_NAME" || "DEPLOYMENT_OPTION" || "DATABASE_ENGINE" || "CACHE_ENGINE" || "INSTANCE_TYPE_FAMILY" || "BILLING_ENTITY" || "RESERVATION_ID" || "RESOURCE_ID" || "RIGHTSIZING_TYPE" || "SAVINGS_PLANS_TYPE" || "SAVINGS_PLAN_ARN" || "PAYMENT_OPTION" || "AGREEMENT_END_DATE_TIME_AFTER" || "AGREEMENT_END_DATE_TIME_BEFORE" || "INVOICING_ENTITY" || "ANOMALY_TOTAL_IMPACT_ABSOLUTE" || "ANOMALY_TOTAL_IMPACT_PERCENTAGE", * Values: [ * "STRING_VALUE", * ], * MatchOptions: [ * "EQUALS" || "ABSENT" || "STARTS_WITH" || "ENDS_WITH" || "CONTAINS" || "CASE_SENSITIVE" || "CASE_INSENSITIVE" || "GREATER_THAN_OR_EQUAL", * ], * }, * Tags: { * Key: "STRING_VALUE", * Values: [ * "STRING_VALUE", * ], * MatchOptions: [ * "EQUALS" || "ABSENT" || "STARTS_WITH" || "ENDS_WITH" || "CONTAINS" || "CASE_SENSITIVE" || "CASE_INSENSITIVE" || "GREATER_THAN_OR_EQUAL", * ], * }, * CostCategories: { * Key: "STRING_VALUE", * Values: "", * MatchOptions: "", * }, * }, * GroupBy: [ // GroupDefinitions * { // GroupDefinition * Type: "DIMENSION" || "TAG" || "COST_CATEGORY", * Key: "STRING_VALUE", * }, * ], * MaxResults: Number("int"), * NextPageToken: "STRING_VALUE", * }; * const command = new GetCostAndUsageComparisonsCommand(input); * const response = await client.send(command); * // { // GetCostAndUsageComparisonsResponse * // CostAndUsageComparisons: [ // CostAndUsageComparisons * // { // CostAndUsageComparison * // CostAndUsageSelector: { // Expression * // Or: [ // Expressions * // { * // Or: [ * // "", * // ], * // And: [ * // "", * // ], * // Not: "", * // Dimensions: { // DimensionValues * // Key: "AZ" || "INSTANCE_TYPE" || "LINKED_ACCOUNT" || "PAYER_ACCOUNT" || "LINKED_ACCOUNT_NAME" || "OPERATION" || "PURCHASE_TYPE" || "REGION" || "SERVICE" || "SERVICE_CODE" || "USAGE_TYPE" || "USAGE_TYPE_GROUP" || "RECORD_TYPE" || "OPERATING_SYSTEM" || "TENANCY" || "SCOPE" || "PLATFORM" || "SUBSCRIPTION_ID" || "LEGAL_ENTITY_NAME" || "DEPLOYMENT_OPTION" || "DATABASE_ENGINE" || "CACHE_ENGINE" || "INSTANCE_TYPE_FAMILY" || "BILLING_ENTITY" || "RESERVATION_ID" || "RESOURCE_ID" || "RIGHTSIZING_TYPE" || "SAVINGS_PLANS_TYPE" || "SAVINGS_PLAN_ARN" || "PAYMENT_OPTION" || "AGREEMENT_END_DATE_TIME_AFTER" || "AGREEMENT_END_DATE_TIME_BEFORE" || "INVOICING_ENTITY" || "ANOMALY_TOTAL_IMPACT_ABSOLUTE" || "ANOMALY_TOTAL_IMPACT_PERCENTAGE", * // Values: [ // Values * // "STRING_VALUE", * // ], * // MatchOptions: [ // MatchOptions * // "EQUALS" || "ABSENT" || "STARTS_WITH" || "ENDS_WITH" || "CONTAINS" || "CASE_SENSITIVE" || "CASE_INSENSITIVE" || "GREATER_THAN_OR_EQUAL", * // ], * // }, * // Tags: { // TagValues * // Key: "STRING_VALUE", * // Values: [ * // "STRING_VALUE", * // ], * // MatchOptions: [ * // "EQUALS" || "ABSENT" || "STARTS_WITH" || "ENDS_WITH" || "CONTAINS" || "CASE_SENSITIVE" || "CASE_INSENSITIVE" || "GREATER_THAN_OR_EQUAL", * // ], * // }, * // CostCategories: { // CostCategoryValues * // Key: "STRING_VALUE", * // Values: [ * // "STRING_VALUE", * // ], * // MatchOptions: [ * // "EQUALS" || "ABSENT" || "STARTS_WITH" || "ENDS_WITH" || "CONTAINS" || "CASE_SENSITIVE" || "CASE_INSENSITIVE" || "GREATER_THAN_OR_EQUAL", * // ], * // }, * // }, * // ], * // And: [ * // "", * // ], * // Not: "", * // Dimensions: { * // Key: "AZ" || "INSTANCE_TYPE" || "LINKED_ACCOUNT" || "PAYER_ACCOUNT" || "LINKED_ACCOUNT_NAME" || "OPERATION" || "PURCHASE_TYPE" || "REGION" || "SERVICE" || "SERVICE_CODE" || "USAGE_TYPE" || "USAGE_TYPE_GROUP" || "RECORD_TYPE" || "OPERATING_SYSTEM" || "TENANCY" || "SCOPE" || "PLATFORM" || "SUBSCRIPTION_ID" || "LEGAL_ENTITY_NAME" || "DEPLOYMENT_OPTION" || "DATABASE_ENGINE" || "CACHE_ENGINE" || "INSTANCE_TYPE_FAMILY" || "BILLING_ENTITY" || "RESERVATION_ID" || "RESOURCE_ID" || "RIGHTSIZING_TYPE" || "SAVINGS_PLANS_TYPE" || "SAVINGS_PLAN_ARN" || "PAYMENT_OPTION" || "AGREEMENT_END_DATE_TIME_AFTER" || "AGREEMENT_END_DATE_TIME_BEFORE" || "INVOICING_ENTITY" || "ANOMALY_TOTAL_IMPACT_ABSOLUTE" || "ANOMALY_TOTAL_IMPACT_PERCENTAGE", * // Values: [ * // "STRING_VALUE", * // ], * // MatchOptions: [ * // "EQUALS" || "ABSENT" || "STARTS_WITH" || "ENDS_WITH" || "CONTAINS" || "CASE_SENSITIVE" || "CASE_INSENSITIVE" || "GREATER_THAN_OR_EQUAL", * // ], * // }, * // Tags: { * // Key: "STRING_VALUE", * // Values: [ * // "STRING_VALUE", * // ], * // MatchOptions: [ * // "EQUALS" || "ABSENT" || "STARTS_WITH" || "ENDS_WITH" || "CONTAINS" || "CASE_SENSITIVE" || "CASE_INSENSITIVE" || "GREATER_THAN_OR_EQUAL", * // ], * // }, * // CostCategories: { * // Key: "STRING_VALUE", * // Values: "", * // MatchOptions: "", * // }, * // }, * // Metrics: { // ComparisonMetrics * // "": { // ComparisonMetricValue * // BaselineTimePeriodAmount: "STRING_VALUE", * // ComparisonTimePeriodAmount: "STRING_VALUE", * // Difference: "STRING_VALUE", * // Unit: "STRING_VALUE", * // }, * // }, * // }, * // ], * // TotalCostAndUsage: { * // "": { * // BaselineTimePeriodAmount: "STRING_VALUE", * // ComparisonTimePeriodAmount: "STRING_VALUE", * // Difference: "STRING_VALUE", * // Unit: "STRING_VALUE", * // }, * // }, * // NextPageToken: "STRING_VALUE", * // }; * * ``` * * @param GetCostAndUsageComparisonsCommandInput - {@link GetCostAndUsageComparisonsCommandInput} * @returns {@link GetCostAndUsageComparisonsCommandOutput} * @see {@link GetCostAndUsageComparisonsCommandInput} for command's `input` shape. * @see {@link GetCostAndUsageComparisonsCommandOutput} for command's `response` shape. * @see {@link CostExplorerClientResolvedConfig | config} for CostExplorerClient's `config` shape. * * @throws {@link BillingViewHealthStatusException} (client fault) *

* The billing view status must be HEALTHY to perform this action. Try again when the status is HEALTHY. *

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

The requested data is unavailable.

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

The pagination token is invalid. Try again without a pagination token.

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

You made too many calls in a short period of time. Try again later.

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

The specified ARN in the request doesn't exist.

* * @throws {@link CostExplorerServiceException} *

Base exception class for all service exceptions from CostExplorer service.

* * * @public */ export declare class GetCostAndUsageComparisonsCommand extends GetCostAndUsageComparisonsCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: GetCostAndUsageComparisonsRequest; output: GetCostAndUsageComparisonsResponse; }; sdk: { input: GetCostAndUsageComparisonsCommandInput; output: GetCostAndUsageComparisonsCommandOutput; }; }; }