AWS Fundamentals Logo
AWS Fundamentals
AWS::CUR::ReportDefinition

CUR ReportDefinition

The AWS::CUR::ReportDefinition resource creates a Cost & Usage Report with user-defined settings. You can use this resource to define settings like time granularity (hourly, daily, monthly), file format (Parquet, CSV), and S3 bucket for delivery of these reports.

Properties

13 configurable properties. 9 required. Click a row to see details.

Filter:
PropertyTypeFlags
Compression
string
Required
Format
string
Required
RefreshClosedReports
boolean
Required
ReportName
string
RequiredCreate-only
ReportVersioning
string
RequiredCreate-only
S3Bucket
string
Required
S3Prefix
string
Required
S3Region
string
Required
TimeUnit
string
RequiredCreate-only
AdditionalArtifacts
Array<string>
AdditionalSchemaElements
Array<string>
Create-only
BillingViewArn
string
Create-only
Tags
Array<Tag>

Sample CloudFormation Template

A minimal template with required properties and common optional ones.

template.yaml
AWSTemplateFormatVersion: "2010-09-09"
Description: Sample template for AWS::CUR::ReportDefinition

Resources:
  MyResource:
    Type: AWS::CUR::ReportDefinition
    Properties:
      ReportName: "my-reportname"
      TimeUnit: "HOURLY"
      Format: "textORcsv"
      Compression: "ZIP"
      S3Bucket: "value"
      S3Prefix: "value"
      S3Region: "value"
      RefreshClosedReports: true
      ReportVersioning: "CREATE_NEW_REPORT"
      Tags:
        - Key: Environment
          Value: Production

Required IAM Permissions

Permissions CloudFormation needs in your IAM role to manage this resource.

create

cur:PutReportDefinitioncur:DescribeReportDefinitionscur:ListTagsForResourcecur:TagResource

read

cur:DescribeReportDefinitionscur:ListTagsForResource

update

cur:DescribeReportDefinitionscur:ModifyReportDefinitioncur:ListTagsForResourcecur:TagResourcecur:UntagResource

delete

cur:DeleteReportDefinition

list

cur:DescribeReportDefinitions

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter

Quick Facts

ServiceCUR
Properties13
Required9
TaggingSupported
Primary IDReportName

Supported Operations

CreateReadUpdateDeleteList

Immutable After Creation

These properties cannot be changed after the resource is created. Updating them triggers a replacement.

ReportNameAdditionalSchemaElementsTimeUnitReportVersioningBillingViewArn

External Links