AWS Cost Explorer Service
Cost Management APIs

ReportDefinition

The definition of AWS Cost and Usage Report. You can specify the report name, time unit, report format, compression format, S3 bucket, additional artifacts, and schema elements in the definition.

Contents

AdditionalArtifacts

A list of manifests that you want Amazon Web Services to create for this report.

Type: Array of strings

Valid Values: REDSHIFT | QUICKSIGHT | ATHENA

Required: No

AdditionalSchemaElements

A list of strings that indicate additional content that Amazon Web Services includes in the report, such as individual resource IDs.

Type: Array of strings

Valid Values: RESOURCES

Required: Yes

Compression

The compression format that AWS uses for the report.

Type: String

Valid Values: ZIP | GZIP | Parquet

Required: Yes

Format

The format that AWS saves the report in.

Type: String

Valid Values: textORcsv | Parquet

Required: Yes

RefreshClosedReports

Whether you want Amazon Web Services to update your reports after they have been finalized if Amazon Web Services detects charges related to previous months. These charges can include refunds, credits, or support fees.

Type: Boolean

Required: No

ReportName

The name of the report that you want to create. The name must be unique, is case sensitive, and can't include spaces.

Type: String

Length Constraints: Maximum length of 256.

Pattern: [0-9A-Za-z!\-_.*\'()]+

Required: Yes

ReportVersioning

Whether you want Amazon Web Services to overwrite the previous version of each report or to deliver the report in addition to the previous versions.

Type: String

Valid Values: CREATE_NEW_REPORT | OVERWRITE_REPORT

Required: No

S3Bucket

The S3 bucket where AWS delivers the report.

Type: String

Length Constraints: Maximum length of 256.

Required: Yes

S3Prefix

The prefix that AWS adds to the report name when AWS delivers the report. Your prefix can't include spaces.

Type: String

Length Constraints: Maximum length of 256.

Pattern: [0-9A-Za-z!\-_.*\'()/]*

Required: Yes

S3Region

The region of the S3 bucket that AWS delivers the report into.

Type: String

Valid Values: us-east-1 | us-west-1 | us-west-2 | eu-central-1 | eu-west-1 | ap-southeast-1 | ap-southeast-2 | ap-northeast-1 | eu-north-1 | ap-northeast-3

Required: Yes

TimeUnit

The length of time covered by the report.

Type: String

Valid Values: HOURLY | DAILY

Required: Yes

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

On this page: