Create instance
curl --request POST \
--url https://api.omnistrate.cloud/2022-09-01-00/resource-instance/sp-JvkxkPhinN/falkordb/v1/prod/falkordb-pro-customer-hosted/falkordb-pro-falkordb-customer-hosted-model-omnistrate-dedicated-tenancy/cluster-Multi-Zone \
--header 'Content-Type: application/json' \
--header 'Cookie: <cookie>' \
--data '
{
"cloud_provider": "<string>",
"region": "<string>",
"requestParams": {
"enableTLS": true,
"falkordbPassword": "<string>",
"falkordbUser": "<string>",
"nodeInstanceType": "<string>",
"AOFPersistenceConfig": "<string>",
"description": "<string>",
"falkorDBCacheSize": 123,
"falkorDBMaxQueuedQueries": 123,
"falkorDBNodeCreationBuffer": 123,
"falkorDBQueryMemCapacity": 123,
"falkorDBResultSetSize": 123,
"falkorDBTimeoutDefault": 123,
"falkorDBTimeoutMax": 123,
"name": "<string>",
"RDBPersistenceConfig": "<string>"
}
}
'import requests
url = "https://api.omnistrate.cloud/2022-09-01-00/resource-instance/sp-JvkxkPhinN/falkordb/v1/prod/falkordb-pro-customer-hosted/falkordb-pro-falkordb-customer-hosted-model-omnistrate-dedicated-tenancy/cluster-Multi-Zone"
payload = {
"cloud_provider": "<string>",
"region": "<string>",
"requestParams": {
"enableTLS": True,
"falkordbPassword": "<string>",
"falkordbUser": "<string>",
"nodeInstanceType": "<string>",
"AOFPersistenceConfig": "<string>",
"description": "<string>",
"falkorDBCacheSize": 123,
"falkorDBMaxQueuedQueries": 123,
"falkorDBNodeCreationBuffer": 123,
"falkorDBQueryMemCapacity": 123,
"falkorDBResultSetSize": 123,
"falkorDBTimeoutDefault": 123,
"falkorDBTimeoutMax": 123,
"name": "<string>",
"RDBPersistenceConfig": "<string>"
}
}
headers = {
"Cookie": "<cookie>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Cookie: '<cookie>', 'Content-Type': 'application/json'},
body: JSON.stringify({
cloud_provider: '<string>',
region: '<string>',
requestParams: {
enableTLS: true,
falkordbPassword: '<string>',
falkordbUser: '<string>',
nodeInstanceType: '<string>',
AOFPersistenceConfig: '<string>',
description: '<string>',
falkorDBCacheSize: 123,
falkorDBMaxQueuedQueries: 123,
falkorDBNodeCreationBuffer: 123,
falkorDBQueryMemCapacity: 123,
falkorDBResultSetSize: 123,
falkorDBTimeoutDefault: 123,
falkorDBTimeoutMax: 123,
name: '<string>',
RDBPersistenceConfig: '<string>'
}
})
};
fetch('https://api.omnistrate.cloud/2022-09-01-00/resource-instance/sp-JvkxkPhinN/falkordb/v1/prod/falkordb-pro-customer-hosted/falkordb-pro-falkordb-customer-hosted-model-omnistrate-dedicated-tenancy/cluster-Multi-Zone', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.omnistrate.cloud/2022-09-01-00/resource-instance/sp-JvkxkPhinN/falkordb/v1/prod/falkordb-pro-customer-hosted/falkordb-pro-falkordb-customer-hosted-model-omnistrate-dedicated-tenancy/cluster-Multi-Zone",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'cloud_provider' => '<string>',
'region' => '<string>',
'requestParams' => [
'enableTLS' => true,
'falkordbPassword' => '<string>',
'falkordbUser' => '<string>',
'nodeInstanceType' => '<string>',
'AOFPersistenceConfig' => '<string>',
'description' => '<string>',
'falkorDBCacheSize' => 123,
'falkorDBMaxQueuedQueries' => 123,
'falkorDBNodeCreationBuffer' => 123,
'falkorDBQueryMemCapacity' => 123,
'falkorDBResultSetSize' => 123,
'falkorDBTimeoutDefault' => 123,
'falkorDBTimeoutMax' => 123,
'name' => '<string>',
'RDBPersistenceConfig' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Cookie: <cookie>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.omnistrate.cloud/2022-09-01-00/resource-instance/sp-JvkxkPhinN/falkordb/v1/prod/falkordb-pro-customer-hosted/falkordb-pro-falkordb-customer-hosted-model-omnistrate-dedicated-tenancy/cluster-Multi-Zone"
payload := strings.NewReader("{\n \"cloud_provider\": \"<string>\",\n \"region\": \"<string>\",\n \"requestParams\": {\n \"enableTLS\": true,\n \"falkordbPassword\": \"<string>\",\n \"falkordbUser\": \"<string>\",\n \"nodeInstanceType\": \"<string>\",\n \"AOFPersistenceConfig\": \"<string>\",\n \"description\": \"<string>\",\n \"falkorDBCacheSize\": 123,\n \"falkorDBMaxQueuedQueries\": 123,\n \"falkorDBNodeCreationBuffer\": 123,\n \"falkorDBQueryMemCapacity\": 123,\n \"falkorDBResultSetSize\": 123,\n \"falkorDBTimeoutDefault\": 123,\n \"falkorDBTimeoutMax\": 123,\n \"name\": \"<string>\",\n \"RDBPersistenceConfig\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Cookie", "<cookie>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.omnistrate.cloud/2022-09-01-00/resource-instance/sp-JvkxkPhinN/falkordb/v1/prod/falkordb-pro-customer-hosted/falkordb-pro-falkordb-customer-hosted-model-omnistrate-dedicated-tenancy/cluster-Multi-Zone")
.header("Cookie", "<cookie>")
.header("Content-Type", "application/json")
.body("{\n \"cloud_provider\": \"<string>\",\n \"region\": \"<string>\",\n \"requestParams\": {\n \"enableTLS\": true,\n \"falkordbPassword\": \"<string>\",\n \"falkordbUser\": \"<string>\",\n \"nodeInstanceType\": \"<string>\",\n \"AOFPersistenceConfig\": \"<string>\",\n \"description\": \"<string>\",\n \"falkorDBCacheSize\": 123,\n \"falkorDBMaxQueuedQueries\": 123,\n \"falkorDBNodeCreationBuffer\": 123,\n \"falkorDBQueryMemCapacity\": 123,\n \"falkorDBResultSetSize\": 123,\n \"falkorDBTimeoutDefault\": 123,\n \"falkorDBTimeoutMax\": 123,\n \"name\": \"<string>\",\n \"RDBPersistenceConfig\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.omnistrate.cloud/2022-09-01-00/resource-instance/sp-JvkxkPhinN/falkordb/v1/prod/falkordb-pro-customer-hosted/falkordb-pro-falkordb-customer-hosted-model-omnistrate-dedicated-tenancy/cluster-Multi-Zone")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Cookie"] = '<cookie>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cloud_provider\": \"<string>\",\n \"region\": \"<string>\",\n \"requestParams\": {\n \"enableTLS\": true,\n \"falkordbPassword\": \"<string>\",\n \"falkordbUser\": \"<string>\",\n \"nodeInstanceType\": \"<string>\",\n \"AOFPersistenceConfig\": \"<string>\",\n \"description\": \"<string>\",\n \"falkorDBCacheSize\": 123,\n \"falkorDBMaxQueuedQueries\": 123,\n \"falkorDBNodeCreationBuffer\": 123,\n \"falkorDBQueryMemCapacity\": 123,\n \"falkorDBResultSetSize\": 123,\n \"falkorDBTimeoutDefault\": 123,\n \"falkorDBTimeoutMax\": 123,\n \"name\": \"<string>\",\n \"RDBPersistenceConfig\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>"
}Cluster (Multi-Zone)
Create instance
Provision a new Pro Cluster (Multi-Zone) instance.
POST
/
2022-09-01-00
/
resource-instance
/
sp-JvkxkPhinN
/
falkordb
/
v1
/
prod
/
falkordb-pro-customer-hosted
/
falkordb-pro-falkordb-customer-hosted-model-omnistrate-dedicated-tenancy
/
cluster-Multi-Zone
Create instance
curl --request POST \
--url https://api.omnistrate.cloud/2022-09-01-00/resource-instance/sp-JvkxkPhinN/falkordb/v1/prod/falkordb-pro-customer-hosted/falkordb-pro-falkordb-customer-hosted-model-omnistrate-dedicated-tenancy/cluster-Multi-Zone \
--header 'Content-Type: application/json' \
--header 'Cookie: <cookie>' \
--data '
{
"cloud_provider": "<string>",
"region": "<string>",
"requestParams": {
"enableTLS": true,
"falkordbPassword": "<string>",
"falkordbUser": "<string>",
"nodeInstanceType": "<string>",
"AOFPersistenceConfig": "<string>",
"description": "<string>",
"falkorDBCacheSize": 123,
"falkorDBMaxQueuedQueries": 123,
"falkorDBNodeCreationBuffer": 123,
"falkorDBQueryMemCapacity": 123,
"falkorDBResultSetSize": 123,
"falkorDBTimeoutDefault": 123,
"falkorDBTimeoutMax": 123,
"name": "<string>",
"RDBPersistenceConfig": "<string>"
}
}
'import requests
url = "https://api.omnistrate.cloud/2022-09-01-00/resource-instance/sp-JvkxkPhinN/falkordb/v1/prod/falkordb-pro-customer-hosted/falkordb-pro-falkordb-customer-hosted-model-omnistrate-dedicated-tenancy/cluster-Multi-Zone"
payload = {
"cloud_provider": "<string>",
"region": "<string>",
"requestParams": {
"enableTLS": True,
"falkordbPassword": "<string>",
"falkordbUser": "<string>",
"nodeInstanceType": "<string>",
"AOFPersistenceConfig": "<string>",
"description": "<string>",
"falkorDBCacheSize": 123,
"falkorDBMaxQueuedQueries": 123,
"falkorDBNodeCreationBuffer": 123,
"falkorDBQueryMemCapacity": 123,
"falkorDBResultSetSize": 123,
"falkorDBTimeoutDefault": 123,
"falkorDBTimeoutMax": 123,
"name": "<string>",
"RDBPersistenceConfig": "<string>"
}
}
headers = {
"Cookie": "<cookie>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Cookie: '<cookie>', 'Content-Type': 'application/json'},
body: JSON.stringify({
cloud_provider: '<string>',
region: '<string>',
requestParams: {
enableTLS: true,
falkordbPassword: '<string>',
falkordbUser: '<string>',
nodeInstanceType: '<string>',
AOFPersistenceConfig: '<string>',
description: '<string>',
falkorDBCacheSize: 123,
falkorDBMaxQueuedQueries: 123,
falkorDBNodeCreationBuffer: 123,
falkorDBQueryMemCapacity: 123,
falkorDBResultSetSize: 123,
falkorDBTimeoutDefault: 123,
falkorDBTimeoutMax: 123,
name: '<string>',
RDBPersistenceConfig: '<string>'
}
})
};
fetch('https://api.omnistrate.cloud/2022-09-01-00/resource-instance/sp-JvkxkPhinN/falkordb/v1/prod/falkordb-pro-customer-hosted/falkordb-pro-falkordb-customer-hosted-model-omnistrate-dedicated-tenancy/cluster-Multi-Zone', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.omnistrate.cloud/2022-09-01-00/resource-instance/sp-JvkxkPhinN/falkordb/v1/prod/falkordb-pro-customer-hosted/falkordb-pro-falkordb-customer-hosted-model-omnistrate-dedicated-tenancy/cluster-Multi-Zone",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'cloud_provider' => '<string>',
'region' => '<string>',
'requestParams' => [
'enableTLS' => true,
'falkordbPassword' => '<string>',
'falkordbUser' => '<string>',
'nodeInstanceType' => '<string>',
'AOFPersistenceConfig' => '<string>',
'description' => '<string>',
'falkorDBCacheSize' => 123,
'falkorDBMaxQueuedQueries' => 123,
'falkorDBNodeCreationBuffer' => 123,
'falkorDBQueryMemCapacity' => 123,
'falkorDBResultSetSize' => 123,
'falkorDBTimeoutDefault' => 123,
'falkorDBTimeoutMax' => 123,
'name' => '<string>',
'RDBPersistenceConfig' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Cookie: <cookie>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.omnistrate.cloud/2022-09-01-00/resource-instance/sp-JvkxkPhinN/falkordb/v1/prod/falkordb-pro-customer-hosted/falkordb-pro-falkordb-customer-hosted-model-omnistrate-dedicated-tenancy/cluster-Multi-Zone"
payload := strings.NewReader("{\n \"cloud_provider\": \"<string>\",\n \"region\": \"<string>\",\n \"requestParams\": {\n \"enableTLS\": true,\n \"falkordbPassword\": \"<string>\",\n \"falkordbUser\": \"<string>\",\n \"nodeInstanceType\": \"<string>\",\n \"AOFPersistenceConfig\": \"<string>\",\n \"description\": \"<string>\",\n \"falkorDBCacheSize\": 123,\n \"falkorDBMaxQueuedQueries\": 123,\n \"falkorDBNodeCreationBuffer\": 123,\n \"falkorDBQueryMemCapacity\": 123,\n \"falkorDBResultSetSize\": 123,\n \"falkorDBTimeoutDefault\": 123,\n \"falkorDBTimeoutMax\": 123,\n \"name\": \"<string>\",\n \"RDBPersistenceConfig\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Cookie", "<cookie>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.omnistrate.cloud/2022-09-01-00/resource-instance/sp-JvkxkPhinN/falkordb/v1/prod/falkordb-pro-customer-hosted/falkordb-pro-falkordb-customer-hosted-model-omnistrate-dedicated-tenancy/cluster-Multi-Zone")
.header("Cookie", "<cookie>")
.header("Content-Type", "application/json")
.body("{\n \"cloud_provider\": \"<string>\",\n \"region\": \"<string>\",\n \"requestParams\": {\n \"enableTLS\": true,\n \"falkordbPassword\": \"<string>\",\n \"falkordbUser\": \"<string>\",\n \"nodeInstanceType\": \"<string>\",\n \"AOFPersistenceConfig\": \"<string>\",\n \"description\": \"<string>\",\n \"falkorDBCacheSize\": 123,\n \"falkorDBMaxQueuedQueries\": 123,\n \"falkorDBNodeCreationBuffer\": 123,\n \"falkorDBQueryMemCapacity\": 123,\n \"falkorDBResultSetSize\": 123,\n \"falkorDBTimeoutDefault\": 123,\n \"falkorDBTimeoutMax\": 123,\n \"name\": \"<string>\",\n \"RDBPersistenceConfig\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.omnistrate.cloud/2022-09-01-00/resource-instance/sp-JvkxkPhinN/falkordb/v1/prod/falkordb-pro-customer-hosted/falkordb-pro-falkordb-customer-hosted-model-omnistrate-dedicated-tenancy/cluster-Multi-Zone")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Cookie"] = '<cookie>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cloud_provider\": \"<string>\",\n \"region\": \"<string>\",\n \"requestParams\": {\n \"enableTLS\": true,\n \"falkordbPassword\": \"<string>\",\n \"falkordbUser\": \"<string>\",\n \"nodeInstanceType\": \"<string>\",\n \"AOFPersistenceConfig\": \"<string>\",\n \"description\": \"<string>\",\n \"falkorDBCacheSize\": 123,\n \"falkorDBMaxQueuedQueries\": 123,\n \"falkorDBNodeCreationBuffer\": 123,\n \"falkorDBQueryMemCapacity\": 123,\n \"falkorDBResultSetSize\": 123,\n \"falkorDBTimeoutDefault\": 123,\n \"falkorDBTimeoutMax\": 123,\n \"name\": \"<string>\",\n \"RDBPersistenceConfig\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>"
}Provisions a new Pro Cluster (Multi-Zone) instance in the requested cloud provider and region. The instance is created asynchronously; poll Describe until
status is RUNNING.
Authorization
string
required
Session cookie set by Sign in:
omnistrate_token=<jwt>.
Browsers send it automatically; other clients must forward it on every request.Query parameters
string
ID of the subscription that owns the instance.
Body
string
required
Cloud provider to provision the instance on, for example
aws or gcp.string
required
Region to provision the instance in, for example
us-east-1.object
required
Instance configuration.
Show requestParams properties
Show requestParams properties
boolean
default:false
required
Enable TLS for database connections. Set at creation only.
string
required
Default password for the database. Updating this value after deployment restarts the instance.
string
default:"falkordb"
required
Default username for the database. Set at creation only.
string
default:"e2-custom-4-8192"
required
Compute instance type used for each node. See Instance configuration.
string
default:"everysec"
Append-only file persistence mode. One of
everysec or always. Set at creation only.string
default:"Description"
Description of the instance.
number
default:25
Number of cached query executions. Between
1 and 256. Set at creation only. Maps to CACHE_SIZE in the FalkorDB configuration.number
default:50
Maximum number of queries that can be queued. Between
1 and 512. Set at creation only. Maps to MAX_QUEUED_QUERIES in the FalkorDB configuration.number
default:16384
Node creation buffer size. Between
256 and 32768. Set at creation only. Maps to NODE_CREATION_BUFFER in the FalkorDB configuration.number
default:0
Maximum memory a single query may use, in bytes. Between
5242880 (5 MiB) and 21474836480 (20 GiB). Set at creation only. Maps to QUERY_MEM_CAPACITY in the FalkorDB configuration.number
default:10000
Maximum number of records returned by a query. Between
0 and 1000000, where 0 means unlimited. Set at creation only. Maps to RESULTSET_SIZE in the FalkorDB configuration.number
default:0
Default query timeout in milliseconds. Between
0 and 45000, where 0 disables the timeout. Set at creation only. Maps to TIMEOUT_DEFAULT in the FalkorDB configuration.number
default:0
Maximum query timeout in milliseconds. Between
0 and 45000, where 0 disables the limit. Set at creation only. Maps to TIMEOUT_MAX in the FalkorDB configuration.string
default:"My favorite database"
Human-readable name for the instance.
string
default:"low"
How often the RDB snapshot is written to disk. One of
low, medium, or high. Set at creation only.Sizing and tier availability
nodeInstanceType is required and must be one of the instance types below. The list differs from the Enterprise tiers, which accept any instance type available to the plan.
| Cloud provider | nodeInstanceType | vCPU | Memory |
|---|---|---|---|
| AWS | t4g.medium | 2 | 4 GB |
| AWS | m7g.large | 2 | 8 GB |
| AWS | r7g.large | 2 | 16 GB |
| AWS | c7g.xlarge | 4 | 8 GB |
| AWS | m7g.xlarge | 4 | 16 GB |
| AWS | r7g.xlarge | 4 | 32 GB |
| AWS | c7g.2xlarge | 8 | 16 GB |
| AWS | m7g.2xlarge | 8 | 32 GB |
| AWS | r7g.2xlarge | 8 | 64 GB |
| AWS | c7g.4xlarge | 16 | 32 GB |
| AWS | m7g.4xlarge | 16 | 64 GB |
| AWS | r7g.4xlarge | 16 | 128 GB |
| AWS | c7g.8xlarge | 32 | 64 GB |
| AWS | m7g.8xlarge | 32 | 128 GB |
| GCP | e2-medium | 2 | 4 GB |
| GCP | e2-standard-2 | 2 | 8 GB |
| GCP | e2-highmem-2 | 2 | 16 GB |
| GCP | e2-custom-4-8192 | 4 | 8 GB |
| GCP | e2-standard-4 | 4 | 16 GB |
| GCP | e2-highmem-4 | 4 | 32 GB |
| GCP | e2-custom-8-16384 | 8 | 16 GB |
| GCP | e2-standard-8 | 8 | 32 GB |
| GCP | e2-highmem-8 | 8 | 64 GB |
| GCP | e2-custom-16-32768 | 16 | 32 GB |
| GCP | e2-custom-32-65536 | 32 | 64 GB |
maxMemory and enableEnterpriseModule are not available on the Pro tier. Memory is determined by the selected nodeInstanceType.
See Instance configuration for the full field reference.
Response
string
ID of the resource instance.
202 Accepted
{
"id": "instance-abc123"
}
Errors
See Error for the shared error response shape.⌘I