AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Retrieves cost and usage metrics for your account. You can specify which cost and usage-related metric that you want the request to return. For example, you can specify BlendedCosts or UsageQuantity. You can also filter and group your data by various dimensions, such as SERVICE or AZ, in a specific time range. For a complete list of valid dimensions, see the GetDimensionValues operation. Management account in an organization in Organizations have access to all member accounts.

For information about filter limitations, see Quotas and restrictions in the Billing and Cost Management User Guide.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginGetCostAndUsage and EndGetCostAndUsage.

Namespace: Amazon.CostExplorer
Assembly: AWSSDK.CostExplorer.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<GetCostAndUsageResponse> GetCostAndUsageAsync(
         GetCostAndUsageRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.CostExplorer.Model.GetCostAndUsageRequest

Container for the necessary parameters to execute the GetCostAndUsage service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the GetCostAndUsage service method, as returned by CostExplorer.

Exceptions

ExceptionCondition
BillExpirationException The requested report expired. Update the date interval and try again.
DataUnavailableException The requested data is unavailable.
InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
LimitExceededException You made too many calls in a short period of time. Try again later.
RequestChangedException Your request parameters changed between pages. Try again with the old parameters or without a pagination token.

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5 and newer

See Also