Updated on 2026-09-22 GMT+08:00

Deleting a Memory Mapping

This API is used to delete a memory mapping.

This API can be used only on primary/standby GeminiDB Redis instances.

Each account has permissions to call all APIs, but IAM users must have the required permissions specifically assigned.

If you are using role/policy-based authorization, see the required permissions in Permissions and Supported Actions.

If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
gaussdbfornosql:instance:deleteDBCacheMapping	write	-	-	nosql:instance:deleteDBCacheMapping	-

DELETE /v3/{project_id}/dbcache/mapping

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID of a tenant in a region. To obtain this value, see Obtaining a Project ID. Constraints N/A Range The value contains 32 characters. Only letters and digits are allowed. Default Value N/A

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition User token You can obtain the token by calling the IAM API by following Obtaining a User Token Through Password Authentication. Constraints N/A Range N/A Default Value N/A

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
id	Yes	String	Definition Memory acceleration mapping ID. To obtain this value, see Querying Memory Acceleration Mappings and Details. Constraints N/A Range N/A Default Value N/A

Status code: 202

**Table 4** Response body parameters
Parameter	Type	Description
job_id	String	Definition Task ID Range N/A

DELETE https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/dbcache/mapping 
 
{ 
  "id":     "1094e5d3-c140-4095-9b13-242de267c175" 
}

Status code: 202

Accepted.

{ 
  "job_id" : "04efe8e2-9255-44ae-a98b-d87cae411890" 
}

For details, see Status Codes.

For details, see Error Codes.

Parent topic: Instances