diff --git a/content/operate/rs/references/rest-api/requests/redis_acls/_index.md b/content/operate/rs/references/rest-api/requests/redis_acls/_index.md index 48dccc189d..f5e18c826d 100644 --- a/content/operate/rs/references/rest-api/requests/redis_acls/_index.md +++ b/content/operate/rs/references/rest-api/requests/redis_acls/_index.md @@ -183,6 +183,17 @@ PUT /redis_acls/17 | Host | cnm.cluster.fqdn | Domain name | | Accept | application/json | Accepted media type | +#### Query parameters + +| Field | Type | Description | +|---------|------|---------------| +| dry_run | | Validate the updated [Redis ACL object]({{< relref "/operate/rs/references/rest-api/objects/redis_acl" >}}) but don't apply the update. | + +#### URL parameters + +| Field | Type | Description | +|-------|------|-------------| +| uid | integer | The Redis ACL's unique ID. | #### Request body @@ -258,6 +269,11 @@ POST /redis_acls | Host | cnm.cluster.fqdn | Domain name | | Accept | application/json | Accepted media type | +#### Query parameters + +| Field | Type | Description | +|---------|------|---------------| +| dry_run | | Validate the new [Redis ACL object]({{< relref "/operate/rs/references/rest-api/objects/redis_acl" >}}) but don't apply the update. | #### Request body diff --git a/content/operate/rs/release-notes/rs-7-8-releases/rs-7-8-4-18.md b/content/operate/rs/release-notes/rs-7-8-releases/rs-7-8-4-18.md index 7907d5c6cf..5471fb77b5 100644 --- a/content/operate/rs/release-notes/rs-7-8-releases/rs-7-8-4-18.md +++ b/content/operate/rs/release-notes/rs-7-8-releases/rs-7-8-4-18.md @@ -6,7 +6,7 @@ categories: - operate - rs compatibleOSSVersion: Redis 7.4.0 -description: Certificate-based authentication for the REST API. +description: Certificate-based authentication for the REST API. Dry run option to validate Redis ACL REST API requests. linkTitle: 7.8.4-18 (December 2024) weight: 88 aliases: /operate/rs/release-notes/rs-7-8-releases/rs-7-8-4-tba/ @@ -20,6 +20,8 @@ This version offers: - Certificate-based authentication for the REST API +- Dry run option to validate Redis ACL REST API requests + ## New in this release ### New features @@ -74,6 +76,22 @@ This version offers: - Certificate-based authentication is not implemented for the Cluster Manager UI. +### Enhancements + +- If you create or update a Redis ACL using the REST API, you can use the `dry_run` query parameter to validate the request without actually applying the update. + + - [Create Redis ACL]({{}}) example request: + + ```sh + POST /v1/redis_acls?dry_run + ``` + + - [Update Redis ACL]({{}}) example request: + + ```sh + PUT /v1/redis_acls/?dry_run + ``` + ### Redis database versions Redis Software version 7.8.4 includes three Redis database versions: 7.4, 7.2, and 6.2.