ReportDefinition - Amazon Billing and Cost Management
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

ReportDefinition

The definition of Amazon 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

AdditionalSchemaElements

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

Type: Array of strings

Valid Values: RESOURCES | SPLIT_COST_ALLOCATION_DATA | MANUAL_DISCOUNT_COMPATIBILITY

Required: Yes

Compression

The compression format that Amazon uses for the report.

If you choose Parquet for the Compression, you must also specify Parquet for the Format parameter.

If you choose ZIP or GZIP for the Compression, you must specify textORcsv for the Format parameter.

Type: String

Valid Values: ZIP | GZIP | Parquet

Required: Yes

Format

The format that Amazon saves the report in.

If you choose Parquet for the Format, you must also specify Parquet for the Compression parameter.

If you choose textORcsv for the Format, you must specify ZIP or GZIP for the Compression parameter.

Type: String

Valid Values: textORcsv | Parquet

Required: Yes

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

S3Bucket

The S3 bucket where Amazon delivers the report.

Type: String

Length Constraints: Maximum length of 256.

Pattern: [A-Za-z0-9_\.\-]+

Required: Yes

S3Prefix

The prefix that Amazon adds to the report name when Amazon 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 Amazon delivers the report into.

Type: String

Valid Values: af-south-1 | ap-east-1 | ap-south-1 | ap-south-2 | ap-southeast-1 | ap-southeast-2 | ap-southeast-3 | ap-northeast-1 | ap-northeast-2 | ap-northeast-3 | ca-central-1 | eu-central-1 | eu-central-2 | eu-west-1 | eu-west-2 | eu-west-3 | eu-north-1 | eu-south-1 | eu-south-2 | me-central-1 | me-south-1 | sa-east-1 | us-east-1 | us-east-2 | us-west-1 | us-west-2 | cn-north-1 | cn-northwest-1

Required: Yes

TimeUnit

The length of time covered by the report.

Type: String

Valid Values: HOURLY | DAILY | MONTHLY

Required: Yes

AdditionalArtifacts

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

Type: Array of strings

Valid Values: REDSHIFT | QUICKSIGHT | ATHENA

Required: No

BillingViewArn

The Amazon resource name of the billing view. The BillingViewArn is needed to create Amazon Cost and Usage Report for each billing group maintained in the Amazon Billing Conductor service. The BillingViewArn for a billing group can be constructed as: arn:aws:billing::payer-account-id:billingview/billing-group-primary-account-id or retrieved by calling the ListBillingViews API.

Type: String

Length Constraints: Maximum length of 128.

Pattern: (arn:aws(-cn)?:billing::[0-9]{12}:billingview/)?[a-zA-Z0-9_\+=\.\-@].{1,30}

Required: No

RefreshClosedReports

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

Type: Boolean

Required: No

ReportStatus

The status of the report.

Type: ReportStatus object

Required: No

ReportVersioning

Whether you want Amazon 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

See Also

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