Skip to content

Get all databases.

GET
/databases

Retrieves a list of all databases accessible to the user. The list can be filtered by status.

Authorizations

Parameters

Query Parameters

status_ne
Array<string>
unique items
Allowed values:
not-available
provisioning
active
updating
decommissioning
decommissioned
pausing
paused
resuming
action-required
config-error
usage-exceeded
multiple
unknown

Filter databases to exclude any matching one or more of the specified statuses. Provide statuses as a single comma-separated list (e.g., ?status_ne=deleting,failed).

Example
Example:
?status_ne=decommissioned,decommissioning

Responses

200

A collection of databases

Response Headers
X-Request-Id
string
Example:
b0658b67-8ea3-46de-a3b8-18c3f5347def

ID uniquely identifying the request/response cycle.

Response Schema
object
count
required

Number of items returned in the result.

integer
Example:
1
databases
required
Array
object
id

Unique identifier for this resource within Aerospike Cloud

string
Example:
e2e81cba-446e-4ff9-9b92-9a9992af44c6
name
required
string
Example:
My cool database
createdAt
required
string
format: date-time
updatedAt
required
string
format: date-time
dataPlaneVersion
required
string
Example:
0.0.1
connectionDetails
required
object
host

Host name that clients will use to connect to the database. Correlates to the AEROSPIKE_CLOUD_HOST variable in documentation and code samples.

string
Example:
e2e81cba-446e-4ff9-9b92-9a9992af44c6.asdb.io
tlsCertificate

PEM encoded TLS certificate for the database.

string
infrastructure
required
object
provider
required

Cloud provider for the infrastructure

string
Allowed values:
aws
gcp
instanceType
required

Instance type for vertical scaling

string
Example:
m5d.large
region
required

AWS region where resources will be deployed

string
Example:
us-east-1
availabilityZoneCount
required

Number of availability zones to spread resources across

integer
>= 1
<= 3
zoneIds

AWS availability zone IDs for aerospike nodes

Array<string>
Example:
[ "use1-az1" ]
cidrBlock

The /19 IPv4 CIDR block for the database VPC

string
/^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)/19$/
Example:
10.128.0.0/19
networkId

The network ID of the database

string
Example:
vpc-01234567890123456
accountId

The account ID of the database

string
Example:
123456789012
networkAttachedStorage
One of:
gp2
object
type
required

General Purpose SSD (gp2)

string
Allowed values:
gp2
sizeInGB
required

Size of the EBS volume in gigabytes

integer
>= 1
aerospikeCloud
required
Any of:
object
clusterSize
required

Number of nodes in the cluster (horizontal scaling)

integer
>= 1
dataStorage
required
string
Allowed values:
memory
local-disk
network-storage
dataStorage
required
Allowed values:
memory
dataResiliency

Persist data using local disks or network storage. If omitted, data is stored in-memory without persistence.

string
Allowed values:
local-disk
network-storage
aerospikeServer
required

Aerospike server configuration

object
service
object
advertise-ipv6
boolean
auto-pin
string
Allowed values:
none
cpu
numa
adq
batch-index-threads
integer
>= 1
<= 256
batch-max-buffers-per-queue
integer
<= 4294967295
batch-max-requests
integer
<= 4294967295
batch-max-unused-buffers
integer
<= 4294967295
cluster-name
string
debug-allocations
boolean
disable-udf-execution
boolean
enable-benchmarks-fabric
boolean
enable-health-check
boolean
enable-hist-info
boolean
enforce-best-practices
boolean
feature-key-file
string
feature-key-files
Array<string>
group
string
indent-allocations
boolean
info-max-ms
integer
>= 500
<= 10000
info-threads
integer
<= 2147483647
keep-caps-ssd-health
boolean
log-local-time
boolean
log-millis
boolean
microsecond-histograms
boolean
migrate-fill-delay
integer
<= 4294967295
migrate-max-num-incoming
integer
<= 256
migrate-threads
integer
<= 100
min-cluster-size
integer
<= 256
node-id
string
node-id-interface
string
os-group-perms
boolean
pidfile
string
poison-allocations
boolean
proto-fd-idle-ms
integer
<= 2147483647
proto-fd-max
integer
<= 2147483647
quarantine-allocations
integer
<= 100000000
query-max-done
integer
<= 10000
query-threads-limit
integer
>= 1
<= 1024
run-as-daemon
boolean
secrets-address-port
string
secrets-tls-context
string
secrets-uds-path
string
service-threads
integer
>= 1
<= 4096
sindex-builder-threads
integer
>= 1
<= 32
sindex-gc-period
integer
<= 4294967295
stay-quiesced
boolean
ticker-interval
integer
<= 4294967295
tls-refresh-period
integer
<= 4294967295
transaction-max-ms
integer
<= 4294967295
transaction-retry-ms
integer
<= 4294967295
user
string
vault-ca
string
vault-namespace
string
vault-path
string
vault-token-file
string
vault-url
string
work-directory
string
logging
Array<object>
object
name
string
default:
misc
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
alloc
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
arenax
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
hardware
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
msg
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
os
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
secrets
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
socket
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
tls
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
vault
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
vmapx
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
xmem
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
aggr
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
appeal
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
as
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
audit
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
batch
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
batch-sub
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
bin
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
config
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
clustering
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
drv-mem
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
drv_pmem
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
drv_ssd
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
exchange
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
exp
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
fabric
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
flat
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
geo
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
hb
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
health
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
hlc
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
index
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
info
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
info-command
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
info-port
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
key-busy
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
migrate
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
mrt-audit
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
mrt-monitor
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
namespace
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
nsup
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
particle
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
partition
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
proto
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
proxy
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
proxy-divert
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
query
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
record
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
roster
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
rw
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
rw-client
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
security
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
service
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
service-list
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
sindex
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
skew
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
smd
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
storage
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
truncate
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
tsvc
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
udf
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
xdr
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
xdr-client
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
any
default: CRITICAL
Allowed values:
CRITICAL
critical
WARNING
warning
INFO
info
DEBUG
debug
DETAIL
detail
facility
default: local0
Allowed values:
auth
authpriv
cron
daemon
ftp
kern
lpr
mail
news
syslog
user
uucp
local0
local1
local2
local3
local4
local5
local6
local7
path
string
default: /dev/log
tag
string
default: asd
network
object
service
required
Any of:
object
access-addresses
Array<string>
default:
access-port
integer
>= 1024
<= 65535
addresses
Array<string>
default:
alternate-access-addresses
Array<string>
default:
alternate-access-port
integer
>= 1024
<= 65535
disable-localhost
boolean
port
required
integer
>= 1024
<= 65535
tls-access-addresses
Array<string>
default:
tls-access-port
integer
>= 1024
<= 65535
tls-addresses
Array<string>
default:
tls-alternate-access-addresses
Array<string>
default:
tls-alternate-access-port
integer
>= 1024
<= 65535
tls-authenticate-client
One of:
string
default: any
Allowed values:
any
false
tls-name
string
""
tls-port
integer
>= 1024
<= 65535
heartbeat
required
Any of:
object
addresses
Array<string>
default:
connect-timeout-ms
integer
default: 500
>= 50
<= 4294967295
interval
integer
default: 150
>= 50
<= 600000
mesh-seed-address-ports
Array<string>
default:
mode
required
string
Allowed values:
mesh
multicast
mtu
integer
<= 4294967295
multicast-groups
Array<string>
default:
multicast-ttl
integer
<= 255
port
required
integer
>= 1024
<= 65535
protocol
string
default: v3
Allowed values:
none
v3
timeout
integer
default: 10
>= 3
<= 4294967295
tls-addresses
Array<string>
default:
tls-mesh-seed-address-ports
Array<string>
default:
tls-name
string
""
tls-port
integer
>= 1024
<= 65535
fabric
required
Any of:
object
addresses
Array<string>
default:
channel-bulk-fds
integer
default: 2
>= 1
<= 128
channel-bulk-recv-threads
integer
default: 4
>= 1
<= 128
channel-ctrl-fds
integer
default: 1
>= 1
<= 128
channel-ctrl-recv-threads
integer
default: 4
>= 1
<= 128
channel-meta-fds
integer
default: 1
>= 1
<= 128
channel-meta-recv-threads
integer
default: 4
>= 1
<= 128
channel-rw-fds
integer
default: 8
>= 1
<= 128
channel-rw-recv-pools
integer
default: 1
>= 1
<= 16
channel-rw-recv-threads
integer
default: 16
>= 1
<= 128
keepalive-enabled
boolean
default: true
keepalive-intvl
integer
default: 1
>= 1
<= 2147483647
keepalive-probes
integer
default: 10
>= 1
<= 2147483647
keepalive-time
integer
default: 1
>= 1
<= 2147483647
latency-max-ms
integer
default: 5
<= 1000
port
required
integer
>= 1024
<= 65535
recv-rearm-threshold
integer
default: 1024
<= 1048576
send-threads
integer
default: 8
>= 1
<= 128
tls-addresses
Array<string>
default:
tls-name
string
""
tls-port
integer
>= 1024
<= 65535
info
object
addresses
Array<string>
default:
port
integer
>= 1024
<= 65535
tls
Array<object>
object
name
string
default:
ca-file
string
""
ca-path
string
""
cert-blacklist
string
""
cert-file
string
""
cipher-suite
string
""
key-file
string
""
key-file-password
string
""
protocols
string
default: TLSv1.2
namespaces
required
Array<object>
>= 1 items
<= 1 items
object
name
required
string
active-rack
integer
<= 1000000
allow-ttl-without-nsup
boolean
auto-revive
boolean
background-query-max-rps
integer
>= 1
<= 1000000
conflict-resolution-policy
string
Allowed values:
generation
last-update-time
conflict-resolve-writes
boolean
default-read-touch-ttl-pct
integer
<= 100
default-ttl
integer
<= 315360000
disable-cold-start-eviction
boolean
disable-mrt-writes
boolean
disable-write-dup-res
boolean
disallow-expunge
boolean
disallow-null-setname
boolean
enable-benchmarks-batch-sub
boolean
enable-benchmarks-ops-sub
boolean
enable-benchmarks-read
boolean
enable-benchmarks-udf
boolean
enable-benchmarks-udf-sub
boolean
enable-benchmarks-write
boolean
enable-hist-proxy
boolean
evict-hist-buckets
integer
>= 100
<= 10000000
evict-indexes-memory-pct
integer
<= 100
evict-tenths-pct
integer
<= 4294967295
ignore-migrate-fill-delay
boolean
index-stage-size
integer
>= 134217728
<= 17179869184
indexes-memory-budget
integer
<= 18446744073709552000
inline-short-queries
boolean
max-record-size
integer
>= 64
<= 8388608
migrate-order
integer
>= 1
<= 10
migrate-retransmit-ms
integer
<= 4294967295
migrate-skip-unreadable
boolean
migrate-sleep
integer
<= 4294967295
mrt-duration
integer
>= 1
<= 120
nsup-hist-period
integer
<= 4294967295
nsup-period
integer
<= 4294967295
nsup-threads
integer
>= 1
<= 128
partition-tree-sprigs
integer
>= 256
<= 268435456
prefer-uniform-balance
boolean
rack-id
integer
<= 1000000
read-consistency-level-override
string
Allowed values:
all
off
one
reject-non-xdr-writes
boolean
reject-xdr-writes
boolean
replication-factor
integer
>= 1
<= 256
sindex-stage-size
integer
>= 134217728
<= 4294967296
single-query-threads
integer
>= 1
<= 128
stop-writes-sys-memory-pct
integer
<= 100
strong-consistency
boolean
strong-consistency-allow-expunge
boolean
tomb-raider-eligible-age
integer
<= 4294967295
tomb-raider-period
integer
<= 4294967295
transaction-pending-limit
integer
<= 4294967295
truncate-threads
integer
>= 1
<= 128
write-commit-level-override
string
Allowed values:
all
master
off
xdr-bin-tombstone-ttl
integer
<= 315360000
xdr-tomb-raider-period
integer
<= 4294967295
xdr-tomb-raider-threads
integer
>= 1
<= 128
geo2dsphere-within
object
strict
boolean
min-level
integer
<= 30
max-level
integer
<= 30
max-cells
integer
>= 1
<= 256
level-mod
integer
>= 1
<= 3
earth-radius-meters
integer
<= 4294967295
index-type
One of:
object
type
required
string
default: shmem
Allowed values:
shmem
sets
Array<object>
object
name
string
default:
default-read-touch-ttl-pct
integer
>= -1
<= 100
default-ttl
integer
<= 315360000
disable-eviction
boolean
enable-index
boolean
stop-writes-count
integer
<= 18446744073709552000
stop-writes-size
integer
<= 18446744073709552000
sindex-type
One of:
object
type
required
string
default: shmem
Allowed values:
shmem
storage-engine
One of:
object
type
string
Allowed values:
memory
commit-to-device
boolean
compression
string
Allowed values:
none
lz4
snappy
zstd
compression-acceleration
integer
>= 1
<= 65537
compression-level
integer
>= 1
<= 9
data-size
integer
>= 268435456
<= 281474976710656
defrag-lwm-pct
integer
>= 1
<= 99
defrag-queue-min
integer
<= 4294967295
defrag-sleep
integer
<= 4294967295
defrag-startup-minimum
integer
<= 99
devices
Array<string>
direct-files
boolean
disable-odsync
boolean
enable-benchmarks-storage
boolean
encryption
string
Allowed values:
aes-128
aes-256
encryption-key-file
string
encryption-old-key-file
string
evict-used-pct
integer
<= 100
files
Array<string>
filesize
integer
>= 134217728
<= 2199023255552
flush-max-ms
integer
<= 1000
flush-size
integer
>= 4096
<= 8388608
max-write-cache
integer
<= 18446744073709552000
stop-writes-avail-pct
integer
<= 100
stop-writes-used-pct
integer
<= 100
tomb-raider-sleep
integer
<= 4294967295
mod-lua
object
cache-enabled
boolean
user-path
string
security
object
default-password-file
string
""
enable-quotas
boolean
privilege-refresh-period
integer
default: 300
>= 10
<= 86400
session-ttl
integer
default: 86400
>= 120
<= 864000
tps-weight
integer
default: 2
>= 2
<= 20
ldap
object
disable-tls
boolean
login-threads
integer
default: 8
>= 1
<= 64
polling-period
integer
default: 300
<= 86400
query-base-dn
string
""
query-user-dn
string
""
query-user-password-file
string
""
role-query-base-dn
string
""
role-query-patterns
Array<string>
default:
role-query-search-ou
boolean
server
string
""
tls-ca-file
string
""
token-hash-method
string
default: sha-256
user-dn-pattern
string
""
user-query-pattern
string
""
log
object
report-authentication
boolean
report-data-op
Array<string>
default:
report-data-op-role
Array<string>
default:
report-data-op-user
Array<string>
default:
report-sys-admin
boolean
report-user-admin
boolean
report-violation
boolean
xdr
object
src-id
integer
<= 255
dcs
Array<object>
object
name
string
auth-mode
string
Allowed values:
none
internal
external
external-insecure
pki
auth-password-file
string
auth-user
string
connector
boolean
max-recoveries-interleaved
integer
<= 4294967295
node-address-ports
Array<string>
period-ms
integer
>= 5
<= 1000
tls-name
string
use-alternate-access-address
boolean
namespaces
Array<object>
object
name
string
bin-policy
string
Allowed values:
all
no-bins
only-changed
changed-and-specified
changed-or-specified
compression-level
integer
>= 1
<= 9
compression-threshold
integer
>= 128
<= 4294967295
delay-ms
integer
<= 5000
enable-compression
boolean
forward
boolean
hot-key-ms
integer
<= 5000
ignore-bins
Array<string>
ignore-expunges
boolean
ignore-sets
Array<string>
max-throughput
integer
<= 4294967295
remote-namespace
string
sc-replication-wait-ms
integer
>= 5
<= 1000
ship-bins
Array<string>
ship-bin-luts
boolean
ship-nsup-deletes
boolean
ship-only-specified-sets
boolean
ship-sets
Array<string>
ship-versions-interval
integer
>= 1
<= 3600
ship-versions-policy
string
Allowed values:
latest
all
interval
transaction-queue-limit
integer
>= 1024
<= 1048576
write-policy
string
Allowed values:
auto
update
replace
health
object
state
string
Allowed values:
ONLINE
OFFLINE
UNSPECIFIED
Example:
ONLINE
status
string
Allowed values:
not-available
provisioning
active
updating
decommissioning
decommissioned
pausing
paused
resuming
action-required
config-error
usage-exceeded
multiple
unknown
Example:
active
Example
Content type: application/json
{
"count": 1,
"databases":
"id": "e2e81cba-446e-4ff9-9b92-9a9992af44c6",
"name": "My cool database",
"createdAt": "string",
"updatedAt": "string",
"dataPlaneVersion": "0.0.1",
"connectionDetails":
"host": "e2e81cba-446e-4ff9-9b92-9a9992af44c6.asdb.io",
"tlsCertificate": "string"
},
"infrastructure":
"provider": "aws",
"instanceType": "m5d.large",
"region": "us-east-1",
"availabilityZoneCount": 1,
"zoneIds":
"string"
],
"cidrBlock": "10.128.0.0/19",
"networkId": "vpc-01234567890123456",
"accountId": "123456789012",
"networkAttachedStorage":
},
"aerospikeCloud":
"clusterSize": 1,
"dataStorage": "memory",
"dataResiliency": "local-disk"
},
"aerospikeServer":
"service":
"advertise-ipv6": "boolean",
"auto-pin": "none",
"batch-index-threads": 1,
"batch-max-buffers-per-queue": "integer",
"batch-max-requests": "integer",
"batch-max-unused-buffers": "integer",
"cluster-name": "string",
"debug-allocations": "boolean",
"disable-udf-execution": "boolean",
"enable-benchmarks-fabric": "boolean",
"enable-health-check": "boolean",
"enable-hist-info": "boolean",
"enforce-best-practices": "boolean",
"feature-key-file": "string",
"feature-key-files":
"string"
],
"group": "string",
"indent-allocations": "boolean",
"info-max-ms": 500,
"info-threads": "integer",
"keep-caps-ssd-health": "boolean",
"log-local-time": "boolean",
"log-millis": "boolean",
"microsecond-histograms": "boolean",
"migrate-fill-delay": "integer",
"migrate-max-num-incoming": "integer",
"migrate-threads": "integer",
"min-cluster-size": "integer",
"node-id": "string",
"node-id-interface": "string",
"os-group-perms": "boolean",
"pidfile": "string",
"poison-allocations": "boolean",
"proto-fd-idle-ms": "integer",
"proto-fd-max": "integer",
"quarantine-allocations": "integer",
"query-max-done": "integer",
"query-threads-limit": 1,
"run-as-daemon": "boolean",
"secrets-address-port": "string",
"secrets-tls-context": "string",
"secrets-uds-path": "string",
"service-threads": 1,
"sindex-builder-threads": 1,
"sindex-gc-period": "integer",
"stay-quiesced": "boolean",
"ticker-interval": "integer",
"tls-refresh-period": "integer",
"transaction-max-ms": "integer",
"transaction-retry-ms": "integer",
"user": "string",
"vault-ca": "string",
"vault-namespace": "string",
"vault-path": "string",
"vault-token-file": "string",
"vault-url": "string",
"work-directory": "string"
},
"logging":
"name": "string",
"misc": "CRITICAL",
"alloc": "CRITICAL",
"arenax": "CRITICAL",
"hardware": "CRITICAL",
"msg": "CRITICAL",
"os": "CRITICAL",
"secrets": "CRITICAL",
"socket": "CRITICAL",
"tls": "CRITICAL",
"vault": "CRITICAL",
"vmapx": "CRITICAL",
"xmem": "CRITICAL",
"aggr": "CRITICAL",
"appeal": "CRITICAL",
"as": "CRITICAL",
"audit": "CRITICAL",
"batch": "CRITICAL",
"batch-sub": "CRITICAL",
"bin": "CRITICAL",
"config": "CRITICAL",
"clustering": "CRITICAL",
"drv-mem": "CRITICAL",
"drv_pmem": "CRITICAL",
"drv_ssd": "CRITICAL",
"exchange": "CRITICAL",
"exp": "CRITICAL",
"fabric": "CRITICAL",
"flat": "CRITICAL",
"geo": "CRITICAL",
"hb": "CRITICAL",
"health": "CRITICAL",
"hlc": "CRITICAL",
"index": "CRITICAL",
"info": "CRITICAL",
"info-command": "CRITICAL",
"info-port": "CRITICAL",
"key-busy": "CRITICAL",
"migrate": "CRITICAL",
"mrt-audit": "CRITICAL",
"mrt-monitor": "CRITICAL",
"namespace": "CRITICAL",
"nsup": "CRITICAL",
"particle": "CRITICAL",
"partition": "CRITICAL",
"proto": "CRITICAL",
"proxy": "CRITICAL",
"proxy-divert": "CRITICAL",
"query": "CRITICAL",
"record": "CRITICAL",
"roster": "CRITICAL",
"rw": "CRITICAL",
"rw-client": "CRITICAL",
"security": "CRITICAL",
"service": "CRITICAL",
"service-list": "CRITICAL",
"sindex": "CRITICAL",
"skew": "CRITICAL",
"smd": "CRITICAL",
"storage": "CRITICAL",
"truncate": "CRITICAL",
"tsvc": "CRITICAL",
"udf": "CRITICAL",
"xdr": "CRITICAL",
"xdr-client": "CRITICAL",
"any": "CRITICAL",
"facility": "auth",
"path": "string",
"tag": "string"
}
],
"network":
"service": ,
"heartbeat": ,
"fabric": ,
"info":
"addresses":
"string"
],
"port": 1024
},
"tls":
"name": "string",
"ca-file": "string",
"ca-path": "string",
"cert-blacklist": "string",
"cert-file": "string",
"cipher-suite": "string",
"key-file": "string",
"key-file-password": "string",
"protocols": "string"
}
]
},
"namespaces":
"name": "string",
"active-rack": "integer",
"allow-ttl-without-nsup": "boolean",
"auto-revive": "boolean",
"background-query-max-rps": 1,
"conflict-resolution-policy": "generation",
"conflict-resolve-writes": "boolean",
"default-read-touch-ttl-pct": "integer",
"default-ttl": "integer",
"disable-cold-start-eviction": "boolean",
"disable-mrt-writes": "boolean",
"disable-write-dup-res": "boolean",
"disallow-expunge": "boolean",
"disallow-null-setname": "boolean",
"enable-benchmarks-batch-sub": "boolean",
"enable-benchmarks-ops-sub": "boolean",
"enable-benchmarks-read": "boolean",
"enable-benchmarks-udf": "boolean",
"enable-benchmarks-udf-sub": "boolean",
"enable-benchmarks-write": "boolean",
"enable-hist-proxy": "boolean",
"evict-hist-buckets": 100,
"evict-indexes-memory-pct": "integer",
"evict-tenths-pct": "integer",
"ignore-migrate-fill-delay": "boolean",
"index-stage-size": 134217728,
"indexes-memory-budget": "integer",
"inline-short-queries": "boolean",
"max-record-size": 64,
"migrate-order": 1,
"migrate-retransmit-ms": "integer",
"migrate-skip-unreadable": "boolean",
"migrate-sleep": "integer",
"mrt-duration": 1,
"nsup-hist-period": "integer",
"nsup-period": "integer",
"nsup-threads": 1,
"partition-tree-sprigs": 256,
"prefer-uniform-balance": "boolean",
"rack-id": "integer",
"read-consistency-level-override": "all",
"reject-non-xdr-writes": "boolean",
"reject-xdr-writes": "boolean",
"replication-factor": 1,
"sindex-stage-size": 134217728,
"single-query-threads": 1,
"stop-writes-sys-memory-pct": "integer",
"strong-consistency": "boolean",
"strong-consistency-allow-expunge": "boolean",
"tomb-raider-eligible-age": "integer",
"tomb-raider-period": "integer",
"transaction-pending-limit": "integer",
"truncate-threads": 1,
"write-commit-level-override": "all",
"xdr-bin-tombstone-ttl": "integer",
"xdr-tomb-raider-period": "integer",
"xdr-tomb-raider-threads": 1,
"geo2dsphere-within":
"strict": "boolean",
"min-level": "integer",
"max-level": "integer",
"max-cells": 1,
"level-mod": 1,
"earth-radius-meters": "integer"
},
"index-type": ,
"sets":
"name": "string",
"default-read-touch-ttl-pct": -1,
"default-ttl": "integer",
"disable-eviction": "boolean",
"enable-index": "boolean",
"stop-writes-count": "integer",
"stop-writes-size": "integer"
}
],
"sindex-type": ,
"storage-engine":
}
],
"mod-lua":
"cache-enabled": "boolean",
"user-path": "string"
},
"security":
"default-password-file": "string",
"enable-quotas": "boolean",
"privilege-refresh-period": 10,
"session-ttl": 120,
"tps-weight": 2,
"ldap":
"disable-tls": "boolean",
"login-threads": 1,
"polling-period": "integer",
"query-base-dn": "string",
"query-user-dn": "string",
"query-user-password-file": "string",
"role-query-base-dn": "string",
"role-query-patterns":
"string"
],
"role-query-search-ou": "boolean",
"server": "string",
"tls-ca-file": "string",
"token-hash-method": "string",
"user-dn-pattern": "string",
"user-query-pattern": "string"
},
"log":
"report-authentication": "boolean",
"report-data-op":
"string"
],
"report-data-op-role":
"string"
],
"report-data-op-user":
"string"
],
"report-sys-admin": "boolean",
"report-user-admin": "boolean",
"report-violation": "boolean"
}
},
"xdr":
"src-id": "integer",
"dcs":
"name": "string",
"auth-mode": "none",
"auth-password-file": "string",
"auth-user": "string",
"connector": "boolean",
"max-recoveries-interleaved": "integer",
"node-address-ports":
"string"
],
"period-ms": 5,
"tls-name": "string",
"use-alternate-access-address": "boolean",
"namespaces":
"name": "string",
"bin-policy": "all",
"compression-level": 1,
"compression-threshold": 128,
"delay-ms": "integer",
"enable-compression": "boolean",
"forward": "boolean",
"hot-key-ms": "integer",
"ignore-bins":
"string"
],
"ignore-expunges": "boolean",
"ignore-sets":
"string"
],
"max-throughput": "integer",
"remote-namespace": "string",
"sc-replication-wait-ms": 5,
"ship-bins":
"string"
],
"ship-bin-luts": "boolean",
"ship-nsup-deletes": "boolean",
"ship-only-specified-sets": "boolean",
"ship-sets":
"string"
],
"ship-versions-interval": 1,
"ship-versions-policy": "latest",
"transaction-queue-limit": 1024,
"write-policy": "auto"
}
]
}
]
}
},
"health":
"state": "ONLINE",
"status": "active"
}
}
]
}

401

Access token is missing or invalid

Response Headers
X-Request-Id
string
Example:
b0658b67-8ea3-46de-a3b8-18c3f5347def

ID uniquely identifying the request/response cycle.

Response Schema

Generic API error

object
code

Unique (system-wide) error code for an error happened

string
message
required

Developer-friendly message explaining error

string
key
additional properties
any
Example
Content type: application/json
{
"code": "invalid_token",
"message": "The access token expired."
}

403

Permission denied

Response Headers
X-Request-Id
string
Example:
b0658b67-8ea3-46de-a3b8-18c3f5347def

ID uniquely identifying the request/response cycle.

Response Schema

Generic API error

object
code

Unique (system-wide) error code for an error happened

string
message
required

Developer-friendly message explaining error

string
key
additional properties
any
Example
Content type: application/json
{
"code": "string",
"message": "string"
}

500

Internal Server Error

Response Headers
X-Request-Id
string
Example:
b0658b67-8ea3-46de-a3b8-18c3f5347def

ID uniquely identifying the request/response cycle.

Response Schema

Generic API error

object
code

Unique (system-wide) error code for an error happened

string
message
required

Developer-friendly message explaining error

string
key
additional properties
any
Example
Content type: application/json
{
"code": "string",
"message": "string"
}

501

The endpoint has not been implemented yet.

Response Schema
object
message
string
Example:
This endpoint has not been implemented yet.
Example
Content type: application/json
{
"message": "This endpoint has not been implemented yet."
}
Feedback

Was this page helpful?

What type of feedback are you giving?

What would you like us to know?

+Capture screenshot

Can we reach out to you?