Function

This API is used to create an extension for a specified database.

Before calling an API, you need to understand the API in Authentication.
Before calling this API, obtain the required region and endpoint.

Constraints

This operation cannot be performed when the DB instance is in any of the following statuses: creating, changing instance class, changing port, or abnormal.

URI

URI format
POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/extensions

Parameter description

**Table 1** Parameters
Parameter	Mandatory	Description
project_id	Yes	Specifies the project ID of a tenant in a region. For details about how to obtain the project ID, see Obtaining a Project ID.
instance_id	Yes	Specifies the DB instance ID.

Request

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
Content-Type	Yes	String	The content type. The default value is application/json.
X-Auth-Token	Yes	String	Specifies the user token. The user token is a response to the API used to obtain a user token.

**Table 3** Parameters
Parameter	Mandatory	Type	Description
database_name	Yes	String	The name of the specific database created inside the RDS instance. This is the logical database name, not the RDS instance identifier.
extension_name	Yes	String	Extension name.

Example Request

Create the extension pg_stat_statements for database db1.

POST https://rds.eu-de.otc.t-systems.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/f569f1358436479dbcba8603c32cc4aein03/extensions
{
  "database_name" : "db1",  
  "extension_name" : "pg_stat_statements"  
}

Response

Example normal response
```
{}
```
Abnormal response
For details, see Abnormal Request Results.

Status Code

Normal
200
Abnormal
For details, see Status Codes.

Error Code

For details, see Error Codes.

Creating an Extension