create-pro-database

Set up a new database within a specified Redis Cloud subscription, enabling customizable configurations like data persistence, eviction policies, and modules installation. Track progress using the returned TASK ID.

Instructions

Create a new database inside the specified subscription ID. Returns a TASK ID that can be used to track the status of the database creationPrerequisites: 1) For database modules, validate against get-database-modules list. 2) Validate regions using get-pro-plans-regions. The payload must match the input schema.

Input Schema

Name	Required	Description
`averageItemSizeInBytes`	No	Optional. Relevant only to ram-and-flash subscriptions. Estimated average size (measured in bytes) of the items stored in the database, Default: 1000
`dataEvictionPolicy`	No	Optional. Data items eviction method. Default: 'volatile-lru'
`dataPersistence`	No	Optional. Rate of database data persistence (in persistent storage). Default: 'none'
`datasetSizeInGb`	No	Optional. The maximum amount of data in the dataset for this specific database is in GB. You can not set both datasetSizeInGb and totalMemoryInGb. if 'replication' is true, the database's total memory will be twice as large as the datasetSizeInGb.if 'replication' is false, the database's total memory of the database will be the datasetSizeInGb value.
`dryRun`	No	Optional. When 'false': Creates a deployment plan and deploys it (creating any resources required by the plan). When 'true': creates a read-only deployment plan without any resource creation. Default: 'true'
`enableTls`	No	Optional. When 'true', requires TLS authentication for all connections (mTLS with valid clientSslCertificate, regular TLS when the clientSslCertificate is not provided. Default: 'false'
`modules`	No	Optional. Redis modules to be provisioned in the database. Use get-database-modules to retrieve available modules and configure the desired ones
`name`	Yes	Required. Name of the database. Database name is limited to 40 characters or less and must include only letters, digits, and hyphens ('-'). It must start with a letter and end with a letter or digit.
`password`	No	Optional. Password to access the database. If omitted, a random 32 character long alphanumeric password will be automatically generated. Can only be set if Database Protocol is REDIS
`port`	No	Optional. TCP port on which the database is available (10000-19999). Generated automatically if omitted
`protocol`	No	Optional. Database protocol. Default: 'redis'
`queryPerformanceFactor`	No	Optional. The query performance factor adds extra compute power specifically for search and query.
`replication`	No	Optional. Databases replication. Default: 'true'
`respVersion`	No	Optional. RESP version must be compatible with Redis version.
`saslPassword`	No	Optional. Memcached (SASL) Password to access the database. If omitted, a random 32 character long alphanumeric password will be automatically generated. Can only be set if Database Protocol is MEMCACHED
`saslUsername`	No	Optional. Memcached (SASL) Username to access the database. If omitted, the username will be set to a 'mc-' prefix followed by a random 5 character long alphanumeric. Can only be set if Database Protocol is MEMCACHED
`shardingType`	No	Optional. Database Hashing policy.
`sourceIp`	No	Optional. List of source IP addresses or subnet masks. If specified, Redis clients will be able to connect to this database only from within the specified source IP addresses ranges.
`subscriptionId`	Yes	Subscription ID
`supportOSSClusterApi`	No	Optional. Support Redis open-source (OSS) Cluster API. Default: 'false'
`throughputMeasurement`	No	Optional. Throughput measurement method.

Input Schema (JSON Schema)

{
  "properties": {
    "averageItemSizeInBytes": {
      "description": "Optional. Relevant only to ram-and-flash subscriptions. Estimated average size (measured in bytes) of the items stored in the database, Default: 1000",
      "type": "integer"
    },
    "dataEvictionPolicy": {
      "description": "Optional. Data items eviction method. Default: 'volatile-lru'",
      "enum": [
        "allkeys-lru",
        "allkeys-lfu",
        "allkeys-random",
        "volatile-lru",
        "volatile-lfu",
        "volatile-random",
        "volatile-ttl",
        "noeviction"
      ],
      "type": "string"
    },
    "dataPersistence": {
      "description": "Optional. Rate of database data persistence (in persistent storage). Default: 'none'",
      "enum": [
        "none",
        "aof-every-1-second",
        "aof-every-write",
        "snapshot-every-1-hour",
        "snapshot-every-6-hours",
        "snapshot-every-12-hours"
      ],
      "type": "string"
    },
    "datasetSizeInGb": {
      "description": "Optional. The maximum amount of data in the dataset for this specific database is in GB. You can not set both datasetSizeInGb and totalMemoryInGb. if 'replication' is true, the database's total memory will be twice as large as the datasetSizeInGb.if 'replication' is false, the database's total memory of the database will be the datasetSizeInGb value.",
      "minimum": 0.1,
      "type": "number"
    },
    "dryRun": {
      "description": "Optional. When 'false': Creates a deployment plan and deploys it (creating any resources required by the plan). When 'true': creates a read-only deployment plan without any resource creation. Default: 'true'",
      "type": "boolean"
    },
    "enableTls": {
      "description": "Optional. When 'true', requires TLS authentication for all connections (mTLS with valid clientSslCertificate, regular TLS when the clientSslCertificate is not provided. Default: 'false'",
      "type": "boolean"
    },
    "modules": {
      "description": "Optional. Redis modules to be provisioned in the database.  Use get-database-modules to retrieve available modules and configure the desired ones",
      "items": {
        "properties": {
          "name": {
            "description": "Required. Redis module Id. Get the list of available module identifiers by calling get-database-modules",
            "type": "string"
          },
          "parameters": {
            "description": "Optional. Redis database module parameters",
            "type": "object"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "name": {
      "description": "Required. Name of the database. Database name is limited to 40 characters or less and must include only letters, digits, and hyphens ('-'). It must start with a letter and end with a letter or digit.",
      "type": "string"
    },
    "password": {
      "description": "Optional. Password to access the database. If omitted, a random 32 character long alphanumeric password will be automatically generated. Can only be set if Database Protocol is REDIS",
      "type": "string"
    },
    "port": {
      "description": "Optional. TCP port on which the database is available (10000-19999). Generated automatically if omitted",
      "type": "integer"
    },
    "protocol": {
      "description": "Optional. Database protocol. Default: 'redis'",
      "enum": [
        "redis",
        "memcached"
      ],
      "type": "string"
    },
    "queryPerformanceFactor": {
      "description": "Optional. The query performance factor adds extra compute power specifically for search and query.",
      "type": "string"
    },
    "replication": {
      "description": "Optional. Databases replication. Default: 'true'",
      "type": "boolean"
    },
    "respVersion": {
      "description": "Optional. RESP version must be compatible with Redis version.",
      "enum": [
        "resp2",
        "resp3"
      ],
      "type": "string"
    },
    "saslPassword": {
      "description": "Optional. Memcached (SASL) Password to access the database. If omitted, a random 32 character long alphanumeric password will be automatically generated. Can only be set if Database Protocol is MEMCACHED",
      "type": "string"
    },
    "saslUsername": {
      "description": "Optional. Memcached (SASL) Username to access the database. If omitted, the username will be set to a 'mc-' prefix followed by a random 5 character long alphanumeric. Can only be set if Database Protocol is MEMCACHED",
      "type": "string"
    },
    "shardingType": {
      "description": "Optional. Database Hashing policy.",
      "enum": [
        "default-regex-rules",
        "custom-regex-rules",
        "redis-oss-hashing"
      ],
      "type": "string"
    },
    "sourceIp": {
      "description": "Optional. List of source IP addresses or subnet masks. If specified, Redis clients will be able to connect to this database only from within the specified source IP addresses ranges.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "subscriptionId": {
      "description": "Subscription ID",
      "min": 0,
      "type": "number"
    },
    "supportOSSClusterApi": {
      "description": "Optional. Support Redis open-source (OSS) Cluster API. Default: 'false'",
      "type": "boolean"
    },
    "throughputMeasurement": {
      "description": "Optional. Throughput measurement method.",
      "properties": {
        "by": {
          "description": "Required. Throughput measurement method. Either 'number-of-shards' or 'operations-per-second'",
          "enum": [
            "operations-per-second",
            "number-of-shards"
          ],
          "type": "string"
        },
        "value": {
          "description": "Required. Throughput value (as applies to selected measurement method)",
          "type": "integer"
        }
      },
      "required": [
        "by",
        "value"
      ],
      "type": "object"
    }
  },
  "required": [
    "subscriptionId",
    "name"
  ],
  "type": "object"
}

Redis Cloud API MCP Server