Skip to content

Commit 4b6a8af

Browse files
committed
Apply comments
1 parent c402699 commit 4b6a8af

File tree

5 files changed

+41
-14
lines changed

5 files changed

+41
-14
lines changed
Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,10 @@
11
To get the cost report using the REST API:
22

3-
1. Use [`POST /cost-report`]({{< relref "/operate/rc/api/api-reference#tag/Account/operation/createCostReport" >}}) to generate a cost report, with the request body containing the `startDate` and `endDate` for the report as well as any optional filters. The response includes a `taskId` that you can use to track the status of the report generation.
4-
1. Use [`GET /tasks/{taskId}`]({{< relref "/operate/rc/api/api-reference#tag/Tasks/operation/getTaskById" >}}) to check report generation status. The report is ready when the `status` is `processing-completed` and the `response` field will contain a `costReportId`.
3+
1. Use [`POST /cost-report`]({{< relref "/operate/rc/api/api-reference#tag/Account/operation/createCostReport" >}}) to generate a cost report, with the request body containing the `startDate` and `endDate` for the report as well as any optional filters. Your account must have the **Owner** or **Viewer** role to generate a cost report through this endpoint.
4+
5+
The response includes a `taskId` that you can use to track the status of the report generation.
6+
7+
1. Use [`GET /tasks/{taskId}`]({{< relref "/operate/rc/api/api-reference#tag/Tasks/operation/getTaskById" >}}) to check report generation status. The report is ready when the `status` is `processing-completed` and the `response` field contains a `costReportId`.
58
1. Use [`GET /cost-report/{costReportId}`]({{< relref "/operate/rc/api/api-reference#tag/Account/operation/getCostReport" >}}) to download the generated cost report.
69

710
The cost report returned from the Redis Cloud REST API contains all columns from the [FOCUS column library](https://focus.finops.org/focus-columns/).

content/operate/rc/api/examples/generate-cost-report.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ categories:
77
- operate
88
- rc
99
description: Shows how to generate and download a cost report in FOCUS format using the Redis Cloud REST API.
10+
bannerText: The cost report API endpoint is currently in preview. [Contact support](https://redis.io/support/) to request access to this endpoint.
1011
weight: 60
1112
---
1213

@@ -18,27 +19,27 @@ The following sections provide examples for each step.
1819

1920
## Generate a cost report
2021

21-
To generate a cost report, use [`POST /cost-report`]({{< relref "/operate/rc/api/api-reference#tag/Account/operation/createCostReport" >}}).
22+
To generate a cost report, use [`POST /cost-report`]({{< relref "/operate/rc/api/api-reference#tag/Account/operation/createCostReport" >}}). Your account must have the **Owner** or **Viewer** role to generate a cost report through this endpoint.
2223

23-
The request body must contain the `startDate` and `endDate` for the report in `YYYY-MM-DD` format.
24+
Include `startDate` and `endDate` in your request body using `YYYY-MM-DD` format. You can specify a date range up to 40 days.
2425

2526
```json
2627
{
2728
"startDate": "2025-01-01",
28-
"endDate": "2025-12-31"
29+
"endDate": "2025-01-31"
2930
}
3031
```
3132

3233
More options and filters can be added to the request body to filter the report data.
3334

3435
| Option name | Type | Description |
3536
|-------------|--------|-------------|
36-
| `format` | Enum: `csv`, `json` | The format for the report file. Default is `json`. |
37+
| `format` | Enum: `csv`, `json` | The format for the report file. Default is `csv`. |
3738
| `subscriptionIds` | Array of integers | Filters the report to only include the specified subscriptions. |
3839
| `databaseIds` | Array of integers | Filters the report to only include the specified databases. |
3940
| `subscriptionType` | Enum: `essentials`, `pro` | Filters the report to only include subscriptions of the specified type. |
4041
| `regions` | Array of strings | Filters the report to only include subscriptions in the specified regions. |
41-
| `tags` | Array of key-value pairs | Filters the report to only include databases with the specified [tags]({{< relref "/operate/rc/databases/tag-database" >}}). |
42+
| `tags` | Array of key-value pairs | Filters the report to only include databases with the specified [tags]({{< relref "/operate/rc/databases/tag-database" >}}). Both `key` and `value` are required for each tag. |
4243

4344
For example, the following request body generates a CSV report for all databases in the `us-east-1` region that have the `team:marketing` tag in January 2025:
4445

content/operate/rc/billing-and-payments/cost-report.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -93,6 +93,10 @@ All columns after the **Total cost** column show the key values for any [tags]({
9393

9494
## Get FOCUS format using REST API
9595

96+
{{< note >}}
97+
The cost report API endpoint is currently in preview. [Contact support](https://redis.io/support/) to request access to this endpoint.
98+
{{< /note >}}
99+
96100
You can use the [Redis Cloud REST API]({{< relref "/operate/rc/api" >}}) to get a cost report in [FinOps Open Cost and Usage Specification (FOCUS)](https://focus.finops.org/) compatible format.
97101

98102
{{< embed-md "rc-cost-report-api.md" >}}
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
Title: Redis Cloud changelog (December 2025)
3+
alwaysopen: false
4+
categories:
5+
- docs
6+
- operate
7+
- rc
8+
description: New features, enhancements, and other changes added to Redis Cloud during
9+
December 2025.
10+
highlights: FOCUS-compliant cost reports with REST API
11+
linktitle: December 2025
12+
weight: 55
13+
tags:
14+
- changelog
15+
---
16+
17+
## New features
18+
19+
### FOCUS-compliant cost reports with REST API
20+
21+
Select users can now generate and download [cost reports]({{< relref "/operate/rc/billing-and-payments/cost-report" >}}) in a [FinOps Open Cost and Usage Specification (FOCUS)](https://focus.finops.org/) compliant format using the Redis Cloud REST API. You can use this cost report with any FOCUS-compatible cost reporting tool to analyze and visualize your costs.
22+
23+
[Contact support](https://redis.io/support/) to request access to the cost report endpoint.
24+
25+
See [Generate FOCUS-compliant cost report with REST API]({{< relref "/operate/rc/api/examples/generate-cost-report" >}}) for examples.

content/operate/rc/changelog/november-2025.md

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ categories:
77
- rc
88
description: New features, enhancements, and other changes added to Redis Cloud during
99
November 2025.
10-
highlights: Redis 8.2 on Redis Cloud Pro, FOCUS-compliant cost reports
10+
highlights: Redis 8.2 on Redis Cloud Pro
1111
linktitle: November 2025
1212
weight: 60
1313
tags:
@@ -16,12 +16,6 @@ tags:
1616

1717
## New features
1818

19-
### FOCUS-compliant cost reports
20-
21-
You can now generate and download [cost reports]({{< relref "/operate/rc/billing-and-payments/cost-report" >}}) in a [FinOps Open Cost and Usage Specification (FOCUS)](https://focus.finops.org/) compliant format using the Redis Cloud REST API. You can use this cost report with any FOCUS-compatible cost reporting tool to analyze and visualize your costs.
22-
23-
See [Generate FOCUS-compliant cost report with REST API]({{< relref "/operate/rc/api/examples/generate-cost-report" >}}) for examples.
24-
2519
### Redis 8.2 on Redis Cloud Pro
2620

2721
Redis 8.2 is now available on Redis Cloud Pro. You can now upgrade your existing Pro database to Redis 8.2.

0 commit comments

Comments
 (0)