Remove update database and consolidate

Author: cmilesb

content/operate/rc/api/_index.md

@@ -33,8 +33,7 @@ You can use the API to:
 
 1. [Manage subscriptions]({{< relref "/operate/rc/api/examples/manage-subscriptions.md" >}})
 1. Database examples
-    - [Create database]({{< relref "/operate/rc/api/examples/create-database" >}})
-    - [Update database]({{< relref "/operate/rc/api/examples/update-database.md" >}})
+    - [Create and manage databases]({{< relref "/operate/rc/api/examples/create-database" >}})
     - [Back up and import data]({{< relref "/operate/rc/api/examples/back-up-and-import-data.md" >}})
 1. [Manage cloud accounts]({{< relref "/operate/rc/api/examples/manage-cloud-accounts.md" >}})
 1. [Estimate costs]({{< relref "/operate/rc/api/examples/dryrun-cost-estimates.md" >}})

content/operate/rc/api/examples/create-database.md

@@ -5,8 +5,7 @@ categories:
 - docs
 - operate
 - rc
-description: This article describes how to create and manage a database using `cURL`
-  commands.
+description: This article describes how to create and manage a database using the Redis Cloud API.
 linkTitle: Create and manage databases
 weight: 20
 ---
@@ -15,6 +14,8 @@ You can use the Redis Cloud REST API to create and manage databases.
 
 ## Redis Cloud Essentials
 
+To create a Redis Cloud Essentials database, use 
+
 ## Redis Cloud Pro
 
 ### Create a Redis Cloud Pro database
@@ -23,23 +24,23 @@ To create a Redis Cloud Pro database, use `POST /subscriptions/{subscriptionId}/
 
 This call creates a database in the specified subscription. Use `GET /subscriptions` to get a list of subscriptions and their IDs. 
 
-Creating a database is an [asynchronous operation]({{< relref "/operate/rc/api/get-started/process-lifecycle" >}}).
-
-The following API call creates a database.
-
 ```shell
 POST "https://[host]/v1/subscriptions/{subscriptionId}/databases"
 {
-  "name": "Database-example-basic",
-  "memoryLimitInGb": 10,
-  "password": "P@ssw0rd"
+  "name": "Basic-database-example",
+  "datasetSizeInGb": 1
 }
 ```
 
-The example JSON body contains only the most basic, required parameters in order to create a database:
+This example JSON body contains only the most basic, required parameters in order to create a database:
+
+- `name`: The database name. A unique name per subscription that can contain only alphanumeric characters and hyphens
+- `datasetSizeInGb`: Maximum dataset size in GB
+
+There are many additional parameters and settings that can be defined on database creation. Review the database parameters and options in the [full API reference]({{< relref "/operate/rc/api/api-reference#tag/Databases-Pro/operation/createDatabase" >}}).
+
+### Update a Redis Cloud Pro database
 
-- Database name - A unique name per subscription that can contain only alphanumeric characters and hyphens
-- Maximum database size in GB
-- Database password
+To update a Redis Cloud Pro database, use `PUT /subscriptions/{subscriptionId}/databases/{databaseId}`. 
 
-There are many additional parameters and settings that can be defined on database creation. Review the database parameters and options in the [Full API documentation]({{< relref "/operate/rc/api/api-reference#tag/Databases-Pro/operation/createDatabase" >}}).
+The primary component of a database update request is the JSON request body that contains the details of the requested database changes. You can see the full set of changes you can make in the [full API reference]({{< relref "/operate/rc/api/api-reference#tag/Databases-Pro/operation/updateDatabase" >}}).