diff --git a/content/embeds/rc-cost-report-api.md b/content/embeds/rc-cost-report-api.md new file mode 100644 index 0000000000..297bd138da --- /dev/null +++ b/content/embeds/rc-cost-report-api.md @@ -0,0 +1,8 @@ +To get the cost report using the REST API: + +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. + + The response includes a `taskId` that you can use to track the status of the report generation. + +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`. +1. Use [`GET /cost-report/{costReportId}`]({{< relref "/operate/rc/api/api-reference#tag/Account/operation/getCostReport" >}}) to download the generated cost report. \ No newline at end of file diff --git a/content/operate/rc/api/examples/generate-cost-report.md b/content/operate/rc/api/examples/generate-cost-report.md new file mode 100644 index 0000000000..359f3e03a8 --- /dev/null +++ b/content/operate/rc/api/examples/generate-cost-report.md @@ -0,0 +1,186 @@ +--- +Title: Generate FOCUS-compliant cost report +linkTitle: Generate cost report +alwaysopen: false +categories: +- docs +- operate +- rc +description: Shows how to generate and download a cost report in FOCUS format using the Redis Cloud REST API. +bannerText: The cost report API endpoint is currently in preview. [Contact support](https://redis.io/support/) to request access to this endpoint. +weight: 60 +--- + +You can use the Redis Cloud REST API to generate and download a cost report in a [FinOps Open Cost and Usage Specification (FOCUS)](https://focus.finops.org/) compatible format. The report includes detailed information about your Redis Cloud subscription usage and associated charges. + +{{< embed-md "rc-cost-report-api.md" >}} + +The following sections provide examples for each step. + +## Generate a cost report + +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. + +Include `startDate` and `endDate` in your request body using `YYYY-MM-DD` format. You can specify a date range up to 40 days. + +```json +{ + "startDate": "2025-01-01", + "endDate": "2025-01-31" +} +``` + +More options and filters can be added to the request body to filter the report data. + +| Option name | Type | Description | +|-------------|--------|-------------| +| `format` | Enum: `csv`, `json` | The format for the report file. Default is `csv`. | +| `subscriptionIds` | Array of integers | Filters the report to only include the specified subscriptions. | +| `databaseIds` | Array of integers | Filters the report to only include the specified databases. | +| `subscriptionType` | Enum: `essentials`, `pro` | Filters the report to only include subscriptions of the specified type. | +| `regions` | Array of strings | Filters the report to only include subscriptions in the specified regions. | +| `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. | + +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: + +```json +{ + "startDate": "2025-01-01", + "endDate": "2025-01-31", + "format": "csv", + "regions": ["us-east-1"], + "tags": [ + { + "key": "team", + "value": "marketing" + } + ] +} +``` + +The response body is a [task object]({{< relref "/operate/rc/api/get-started/manage-tasks#task-information" >}}) that contains the `taskId` for the task that generates the cost report: + +```json +{ + "taskId": "7ba51acc-cd1d-44c7-8453-281730d214ce", + "commandType": "costReportCreateRequest", + "status": "received", + "description": "Task request received and is being queued for processing.", + "timestamp": "2025-11-07T15:44:29.811142433Z", + "links": [ + { + "href": "https://api.redislabs.com/v1/tasks/7ba51acc-cd1d-44c7-8453-281730d214ce", + "type": "GET", + "rel": "task" + } + ] +} +``` + +## Get cost report status + +To get the status of the cost report generation, use [`GET /tasks/{taskId}`]({{< relref "/operate/rc/api/api-reference#tag/Tasks/operation/getTaskById" >}}) with the `taskId` from the previous step. + +When the report is ready, the `status` is `processing-completed` and the `response` field contains a `costReportId`: + +```json +{ + "taskId": "7ba51acc-cd1d-44c7-8453-281730d214ce", + "commandType": "costReportCreateRequest", + "status": "processing-completed", + "description": "Request processing completed successfully and its resources are now being provisioned / de-provisioned.", + "timestamp": "2025-11-07T15:44:31.168900133Z", + "response": { + "resource": { + "costReportId": "a07524cf-6d4d-47ec-a1b7-810d1cbafcf7.json" + } + }, + "links": [ + { + "href": "https://api.redislabs.com/v1/tasks/7ba51acc-cd1d-44c7-8453-281730d214ce", + "type": "GET", + "rel": "self" + } + ] +} +``` + +## Download cost report + +To get the cost report, use [`GET /cost-report/{costReportId}`]({{< relref "/operate/rc/api/api-reference#tag/Account/operation/getCostReport" >}}) with the `costReportId` from the previous step. + +You can use this cost report with any FOCUS-compatible cost reporting tool to analyze and visualize your costs. + +### Cost report fields + +The cost report returned from the Redis Cloud REST API contains fields from the [FOCUS column library](https://focus.finops.org/focus-columns/). The Redis Cloud-specific implementation is described in the following sections. + +#### Billing account and publisher fields + +| Field | Type | Description | +|---|---|---| +| `BillingAccountId` | String | Redis Cloud account ID. | +| `BillingAccountName` | String | Display name of the Redis Cloud account. | +| `BillingAccountType` | String | Type of billing account structure. Always set to `Redis Cloud`. | +| `PublisherName` | String | Publisher/vendor of the service, which is Redis. Always `redis.io`. | + +#### Pricing fields + +| Field | Type | Description | +|---|---|---| +| `PricingCategory` | String | Pricing model category. Always `Standard`. | +| `PricingCurrency` | String | The currency used for pricing. Always `USD`. | +| `PricingQuantity` | BigDecimal | Quantity of units being priced. For hourly services like Redis Cloud Pro, this is the number of hours. For monthly services like Redis Cloud Essentials and network costs, this is typically one month. | +| `PricingUnit` | String | The unit of measure for pricing. Can be `Hours` (Pro), `Months` (Essentials), or `Network`. | + +#### Period fields + +| Field | Type | Description | +|---|---|---| +| `BillingPeriodStart` | Instant (ISO 8601 DateTime) | Start of the billing period (inclusive). | +| `BillingPeriodEnd` | Instant (ISO 8601 DateTime) | End of the billing period (exclusive). | +| `ChargePeriodStart` | Instant (ISO 8601 DateTime) | Start of the specific charge period (inclusive). May differ from billing period if the resource was created mid-period. | +| `ChargePeriodEnd` | Instant (ISO 8601 DateTime) | End of the specific charge period (exclusive). May differ from billing period if the resource was deleted mid-period. | + +#### Cost fields + +| Field | Type | Description | +|---|---|---| +| `BilledCost` | BigDecimal | Cost that Redis will invoice you for. | +| `BillingCurrency` | String (ISO 4217) | Currency code for all billing amounts. Always `USD`. | +| `ConsumedQuantity` | BigDecimal | Actual amount of resources used. May be null for fixed-price plans. | +| `ConsumedUnit` | String | Unit for `ConsumedQuantity`. Can be `Hours` or `Network`. | +| `ContractedCost` | BigDecimal | Cost after applying contractual discounts but before credits. | +| `ContractedUnitPrice` | BigDecimal | Per-unit price after applying your negotiated discounts. | +| `EffectiveCost` | BigDecimal | True cost after all discounts, credits, and adjustments. | +| `ListCost` | BigDecimal | Cost at Redis's published list prices before any discounts. | +| `ListUnitPrice` | BigDecimal | Redis's published price per unit at list rates. | + +#### Location, Resource, and SKU fields + +| Field | Type | Description | +|---|---|---| +| `RegionId` | String | Cloud vendor region identifier. | +| `RegionName` | String | Display name of the region. | +| `ResourceId` | String | Identifier of the resource being charged. | +| `ResourceName` | String | Display name you gave to the resource in the Redis Cloud console. | +| `ResourceType` | String | Whether the charge is for a specific database or a subscription-level service. | +| `Tags` | JSON Map | User-defined tags on resources. | +| `SkuPriceDetails` | JSON Map | Redis-specific technical details about the database configuration, such as RBUs, memory limit, and throughput. | + +#### Charge fields + +| Field | Type | Description | +|---|---|---| +| `ChargeCategory` | String | Category of the charge: `Usage`, `Purchase`, `Tax`, or `Adjustment`. | +| `ChargeDescription` | String | A clear description of what you're being charged for, combining service type and resource details. | +| `ChargeFrequency` | String | How often the charge occurs - always `Recurring`. | + +#### Service fields + +| Field | Type | Description | +|---|---|---| +| `ServiceCategory` | String | The high-level category of service - always `Databases`. | +| `ServiceName` | String | The Redis Cloud service tier - `Redis Cloud Pro` or `Redis Cloud Essentials`. | +| `ServiceSubcategory` | String | The specific type of database service - always `Caching`. | + diff --git a/content/operate/rc/billing-and-payments/cost-report.md b/content/operate/rc/billing-and-payments/cost-report.md index f6ba923f35..8aa8abd0ad 100644 --- a/content/operate/rc/billing-and-payments/cost-report.md +++ b/content/operate/rc/billing-and-payments/cost-report.md @@ -12,7 +12,7 @@ weight: 39 The Redis Cloud cost report gives you a detailed breakdown of your Redis Cloud subscription usage and associated charges. You can use it to track, audit, and optimize your Redis Cloud spending across Essentials and Pro subscription plans. -You can download the cost report from the [**Billing and payments**]({{< relref "/operate/rc/billing-and-payments" >}}) and [**Usage reports**]({{< relref "/operate/rc/logs-reports/usage-reports" >}}) pages. +You can download the cost report from the [**Billing and payments**]({{< relref "/operate/rc/billing-and-payments" >}}) and [**Usage reports**]({{< relref "/operate/rc/logs-reports/usage-reports" >}}) pages. You can also use the [Redis Cloud REST API](#rest-api) to get a cost report in [FOCUS](https://focus.finops.org/) format. {{< embed-md "rc-cost-report-csv.md" >}} @@ -91,3 +91,14 @@ All columns after the **Total cost** column show the key values for any [tags]({ {{< embed-md "rc-pro-billing-units.md" >}} +## Get FOCUS format using REST API + +{{< note >}} +The cost report API endpoint is currently in preview. [Contact support](https://redis.io/support/) to request access to this endpoint. +{{< /note >}} + +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. + +{{< embed-md "rc-cost-report-api.md" >}} + +The cost report returned from the Redis Cloud REST API contains fields from the [FOCUS column library](https://focus.finops.org/focus-columns/). See [Generate FOCUS-compliant cost report with REST API]({{< relref "/operate/rc/api/examples/generate-cost-report" >}}) for more details. \ No newline at end of file diff --git a/content/operate/rc/changelog/december-2025.md b/content/operate/rc/changelog/december-2025.md new file mode 100644 index 0000000000..e7d216de79 --- /dev/null +++ b/content/operate/rc/changelog/december-2025.md @@ -0,0 +1,25 @@ +--- +Title: Redis Cloud changelog (December 2025) +alwaysopen: false +categories: +- docs +- operate +- rc +description: New features, enhancements, and other changes added to Redis Cloud during + December 2025. +highlights: FOCUS-compliant cost reports with REST API +linktitle: December 2025 +weight: 55 +tags: +- changelog +--- + +## New features + +### FOCUS-compliant cost reports with REST API + +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. + +[Contact support](https://redis.io/support/) to request access to the cost report endpoint. + +See [Generate FOCUS-compliant cost report with REST API]({{< relref "/operate/rc/api/examples/generate-cost-report" >}}) for examples. \ No newline at end of file diff --git a/content/operate/rc/changelog/november-2025.md b/content/operate/rc/changelog/november-2025.md index bc077cf395..f9b83cf7c5 100644 --- a/content/operate/rc/changelog/november-2025.md +++ b/content/operate/rc/changelog/november-2025.md @@ -7,7 +7,7 @@ categories: - rc description: New features, enhancements, and other changes added to Redis Cloud during November 2025. -highlights: Redis 8.2 on Redis Cloud Pro, Automatic minor version upgrades +highlights: Redis 8.2 on Redis Cloud Pro linktitle: November 2025 weight: 60 tags: