

# Using AWS billing and usage reports
<a name="billing-usage-reporting"></a>

When using Amazon EFS, you pay only for the resources you use and there are no minimum fees or setup charges. Like other AWS services, while pricing is quoted on a monthly basis, your usage is prorated by the hour, and you are billed for your average usage over a month.

AWS provides the following reports for Amazon EFS:
+ **Billing reports** – Multiple reports that provide high-level views of all of the activity for the AWS services that you're using, including Amazon EFS. AWS always bills the owner of the EFS file system for Amazon EFS fees. For more information about billing reports, see [AWS Billing reports for Amazon EFS](aws-billing-report.md). 
+ **Usage reports** – A summary of activity for a specific service, aggregated by hour, day, or month. You can choose which usage type and operation to include. You can also choose how the data is aggregated. For more information, see [AWS usage reports for Amazon EFS](aws-usage-report.md). 

  The following topics provide information about billing and usage reporting for Amazon EFS.

**Topics**
+ [Using cost allocation EFS file system tags](CostAllocTagging.md)
+ [AWS Billing reports for Amazon EFS](aws-billing-report.md)
+ [AWS usage reports for Amazon EFS](aws-usage-report.md)
+ [Understanding billing and usage reports for Amazon EFS](billing-usage-reports-understand.md)

# Using cost allocation EFS file system tags
<a name="CostAllocTagging"></a>

To track the storage cost or other criteria for individual projects or groups of projects, label your EFS file systems using cost allocation tags. A *cost allocation tag* is a key-value pair that you associate with a file system. After you activate cost allocation tags, AWS uses the tags to organize your resource costs on your cost allocation report.

The *cost allocation report* lists the AWS usage for your account by product category and linked account user. The report contains the same line items as the detailed billing report (see [Understanding billing and usage reports for Amazon EFS](billing-usage-reports-understand.md)) and additional columns for your tag keys.

AWS provides two types of cost allocation tags, *AWS-generated tags* and *user-defined tags*. AWS defines, creates, and applies the AWS-generated `aws:createdBy` tag key for you after an Amazon EFS CreateFileSystem event. You define, create, and apply *user-defined* tags to your file systems.

You must activate both types of tags separately in the Billing and Cost Management console before they can appear in your billing reports. For more information about AWS-generated tags, see [Organizing and tracking costs using AWS cost allocation tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) in the *AWS Billing User Guide*.
+ For more information about creating user-defined tags for EFS resources, see [Tagging EFS resources](manage-fs-tags.md).
+ For more information about activating user-defined tags in the Billing and Cost Management console, see [Activating user-defined cost allocation tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/activating-tags.html) in the *AWS Billing User Guide*.
+ For more information about activating AWS-generated tags in the Billing and Cost Management console, see [Activating AWS-generated cost allocation tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/activate-built-in-tags.html) in the *AWS Billing User Guide*.

## User-defined cost allocation tags
<a name="user-defined-cost-allocation"></a>

A user-defined cost allocation tag has the following components:
+ The tag key. The tag key is the name of the tag. For example, in the tag project/Trinity, project is the key. The tag key is a case-sensitive string that can contain 1 to 128 Unicode characters. 
+ The tag value. The tag value is a required string. For example, in the tag project/Trinity, Trinity is the value. The tag value is a case-sensitive string that can contain from 0 to 256 Unicode characters.

For more information about user-defined tags, see [Using user-defined cost allocation tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/custom-tags.html) in the *AWS Billing User Guide*.

# AWS Billing reports for Amazon EFS
<a name="aws-billing-report"></a>

Your monthly bill from AWS separates your usage information and cost by AWS service and function. There are several AWS billing reports available: the monthly report, the cost allocation report, and detailed billing reports. For more information, see [Understanding your bill](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/getting-viewing-bill.html) in the *AWS Billing* User Guide.

For more detailed reports about your Amazon EFS storage usage, use AWS Data Exports to create exports of the AWS Cost and Usage Report (AWS CUR). With AWS CUR 2.0, you publish your AWS billing reports to an Amazon Simple Storage Service (Amazon S3) bucket that you own. The Amazon EFS usage report lists operations by usage type and AWS Region. For more information, see [Cost and Usage Report (CUR) 2.0](https://docs.aws.amazon.com/cur/latest/userguide/table-dictionary-cur2.html) in the *AWS Data Exports User Guide*. 

EFS file systems are billed based on the following categories of usage.
+ Storage (per gigabyte [GB]) – The amount of data stored in your EFS file systems per month, with different prices depending on the storage class (EFS Standard, EFS Infrequent Access (IA) and EFS Archive).
+ Throughput (per GB or mebibytes per second [MiBps]) – The amount of data transferred (read/write operations) or the amount that exceeds your provisioned amount, depending on the file system's throughput, per month. 
+ Data access and transition (per MiBps) – The amount of data read and transferred to the EFS Infrequent Access (IA) and EFS Archive storage classes per month. 
+ Backup storage (per GB) – The amount of storage space consumed by backups per month. Increasing your backup retention period or taking additional user-initiated volume backups increases the amount of backup storage your file system consumes. For more information, see [Backing up EFS file systems](awsbackup.md)
+ Replication (per GB) – The prevailing storage and read, write, and tiering activity rates for your source and destination EFS file systems, as well as any applicable charges for data transfer activity between them, per month.

For detailed information about Amazon EFS charges, see [Amazon EFS Pricing](https://aws.amazon.com/efs/pricing/).

For information about understanding the codes and abbreviations used in the billing and usage reports for Amazon EFS, see [Understanding billing and usage reports for Amazon EFS](billing-usage-reports-understand.md).

# AWS usage reports for Amazon EFS
<a name="aws-usage-report"></a>

When you download a usage report, you can choose to aggregate usage data by hour, day, or month. The Amazon EFS usage report lists operations by usage type and AWS Region. For more detailed reports about your Amazon EFS storage usage, download dynamically generated AWS usage reports. You can choose which usage type, operation, and time period to include. You can also choose how the data is aggregated. For more information about downloading usage reports, see [Downloading an AWS Usage Report](https://docs.aws.amazon.com/cur/latest/userguide/usage-report.html) in the *AWS Data Exports User Guide*. 

The Amazon EFS usage report includes the following information:
+ **Service** – Amazon EFS 
+ **UsageType** – One of the following values:
  + A code that identifies the type of storage
  + A code that identifies the type of request
  + A code that identifies the type of data transfer
  + A code that identifies the throughput mode
  + A code that identifies the backup usage

  For a detailed explanation of Amazon EFS usage types, see [Understanding billing and usage reports for Amazon EFS](billing-usage-reports-understand.md).
+ **Resource** – The name of the resource associated with the listed usage.
+ **StartTime** – Start time of the day that the usage applies to, in Coordinated Universal Time (UTC).
+ **EndTime** – End time of the day that the usage applies to, in Coordinated Universal Time (UTC). 
+ **UsageValue** – One of the following volume values. The typical unit of measurement for data is gigabytes (GB). However, depending on the service and the report, terabytes (TB) might appear instead.
  + The number of requests during the specified time period
  + The amount of data transferred
  + The amount of data stored in a given hour

For information about understanding the codes and abbreviations used in the billing and usage reports for Amazon EFS, see [Understanding billing and usage reports for Amazon EFS](billing-usage-reports-understand.md).

# Understanding billing and usage reports for Amazon EFS
<a name="billing-usage-reports-understand"></a>

Amazon EFS billing and usage reports use codes and abbreviations. For usage types in the table that follows, replace `region` with abbreviations from this list:
+ **APE1:** Asia Pacific (Hong Kong)
+ **APN1:** Asia Pacific (Tokyo)
+ **APN2:** Asia Pacific (Seoul)
+ **APN3:** Asia Pacific (Osaka)
+ **APS1:** Asia Pacific (Singapore)
+ **APS2:** Asia Pacific (Sydney)
+ **APS3:** Asia Pacific (Mumbai)
+ **APS4:** Asia Pacific (Jakarta)
+ **APS5:** Asia Pacific (Hyderabad)
+ **APS6:** Asia Pacific (Melbourne)
+ **CAN1:** Canada (Central)
+ **CAN2:** Canada West (Calgary)
+ **CNN1:** China (Beijing)
+ **CNW1:** China (Ningxia)
+ **AFS1:** Africa (Cape Town)
+ **EUC2:** Europe (Zurich)
+ **EUN1:** Europe (Stockholm)
+ **EUS2:** Europe (Spain)
+ **EUC1:** Europe (Frankfurt)
+ **EU:** Europe (Ireland)
+ **EUS1:** Europe (Milan)
+ **EUW2:** Europe (London)
+ **EUW3:** Europe (Paris)
+ **ILC1:** Israel (Tel Aviv)
+ **MEC1:** Middle East (UAE)
+ **MES1:** Middle East (Bahrain)
+ **SAE1:** South America (São Paulo)
+ **UGW1:** AWS GovCloud (US-West)
+ **UGE1:** AWS GovCloud (US-East)
+ **USE1 (or no prefix):** US East (N. Virginia)
+ **USE2:** US East (Ohio)
+ **USW1:** US West (N. California)
+ **USW2:** US West (Oregon)

For information about pricing by AWS Region, see [Amazon EFS Pricing](https://aws.amazon.com/efs/pricing/).

The first column in the following table lists usage types that appear in your billing and usage reports. The typical unit of measurement for data is gigabytes (GB). For provisioned throughput amount, however, mebibytes per second (MiBps) is used instead.


**Usage types for Amazon EFS**  

| Usage type | CloudWatch metric | Units | Granularity | Description | 
| --- | --- | --- | --- | --- | 
|  `region-ArchiveDataAccess-Bytes`  | N/A |  GB  |  N/A  | The amount of data that was transferred to or accessed in EFS Archive storage. | 
|  `region-ArchiveEarlyDelete-ByteHrs`  | N/A |  GB-Mo  |  N/A  |  Prorated storage usage for files deleted from EFS Archive storage before the 90-day minimum commitment ended.  | 
|  `region-ArchiveEarlyDelete-SmallFiles`  | N/A |  GB-Mo  |  N/A  | Prorated storage usage for small files (smaller than 128 KB) that were deleted from EFS Archive storage before the 90-day minimum commitment ended. | 
|  `region-ArchiveTimedStorage-ByteHrs`  | [StorageBytes.Archive](efs-metrics.md#archivebytes) |  GB-Mo  |  Hourly  | The number of GB-months that data was stored in EFS Archive storage. | 
|  `region-ArchiveTimedStorage-SmallFiles`  | [StorageBytes.ArchiveSizeOverhead](efs-metrics.md#archiveoverhead) |  GB-Mo  |  Hourly  | The number of GB-months that small objects (smaller than 128 KB) were stored in EFS Archive storage.  | 
|  `region-ETDataAccess-Bytes`  | [TotalIOBytes](efs-metrics.md#totaliobytes) |  GB  |  Hourly  | The amount of data that was written or read for files using Elastic throughput. | 
|  `region-IADataAccess-Bytes`  | N/A |  GB  |  Hourly  | The amount of data that was transferred to or accessed in EFS Infrequent Access (IA) storage. | 
|  `region-IATimedStorage-ByteHrs`  | [StorageBytes.IA](efs-metrics.md#iabytes) |  GB-Mo  |  Hourly  | The number of GB-months that data was stored in EFS IA storage. | 
|  `region-IATimedStorage-ET-ByteHrs`  | [StorageBytes.IA](efs-metrics.md#iabytes) |  GB-Mo  |  Hourly  | The number of GB-months that data for files using Elastic throughput was stored in EFS IA storage. | 
|  `region-IATimedStorage-ET-SmallFiles`  | [StorageBytes.IASizeOverhead](efs-metrics.md#iaoverhead) |  GB-Mo  |  Hourly  | The number of GB-months that small files (smaller than 128 KB) were stored in EFS IA storage, for files using Elastic throughput. | 
|  `region-IATimedStorage-SmallFiles`  | [StorageBytes.IASizeOverhead](efs-metrics.md#iaoverhead) |  GB-Mo  |  Hourly  | The number of GB-months that small files (smaller than 128 KB) were stored in EFS IA storage. | 
|  `region-IATimedStorage-Z-ByteHrs`  | [StorageBytes.IA](efs-metrics.md#iabytes) |  GB-Mo  |  Hourly  | The actual size of data stored in EFS IA storage for One Zone file systems. | 
|  `region-IATimedStorage-Z-SmallFiles`  | [StorageBytes.IASizeOverhead](efs-metrics.md#iaoverhead) |  GB-Mo  |  Hourly  | The number of GB-months that small files (smaller than 128 KB) were stored in EFS IA storage for One Zone file systems. | 
|  `region-IncludedTP-MiBpsHrs`  | [PermittedThroughput](efs-metrics.md#permittedtp) |  MiBps-Mo  |  Hourly  | The maximum amount of throughput that a file system can drive. | 
|  `region-ProvisionedTP-MiBpsHrs`  | [PermittedThroughput](efs-metrics.md#permittedtp) | MiBps-Mo |  Hourly  |  For file systems using Provisioned throughput, the throughput provisioned or maximum permitted throughput.  | 
| region-TimedStorage-ByteHrs | [StorageBytes.Standard](efs-metrics.md#standardbytes) | GB-Mo |  Hourly  | The actual total amount of data stored in EFS Standard storage for regional file systems. | 
| region-TimedStorage-Z-ByteHrs | [StorageBytes.Standard](efs-metrics.md#standardbytes) | GB-Mo |  Hourly  | The actual total amount of data stored in EFS Standard storage for One Zone file systems. | 

**Notes**
+ EFS Archive storage is charged for a minimum storage duration of 90 days, even if the data is deleted before 90 days.
+ A tiering charge applies to data tiered from EFS Standard storage to EFS Infrequent Access (IA) storage, and from EFS IA storage to EFS Standard storage.
+ EFS IA and EFS Archive storage have a minimum billable file size of 128 KiB. Files smaller than 128 KiB can be tiered to these storage classes but are charged for 128 KiB of storage at the appropriate storage class rate. 
+ For file systems using Elastic throughput, metadata operations are metered in 1 KiB increments after the first 4 KiB and data operations are metered in 1 KiB increments after the first 32 KiB.
+ Storage usage is calculated in binary gigabytes (GB), where 1 GB is 230 bytes. See [How Amazon EFS reports file system and object sizes](metered-sizes.md) for additional details on how storage and throughput usage are metered to calculate your Amazon EFS bill.
+ GB-Month is derived by taking the total number of GB-hours, aggregating these over the course of a month, and then dividing by the number of hours in that month. 

## Tracking operations in your usage reports
<a name="aws-usage-report-understand-operations"></a>

Operations describe the action taken on your EFS file system by the specified usage type. Operations are indicated by self-explanatory codes, such as `Read` or `Delete`. To see which actions on your file system generated a specific type of usage, use these codes. When you create a usage report, you can choose to include **All Operations**, or a specific operation, for example, `Write`, to report on.