Skip to content

List clusters.

GET
/database/clusters

Retrieves a list of all clusters 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 clusters 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
limit
integer
default: 10
>= 1
<= 100

The maximum number of items to return in a single response. Used for pagination. Must be between 1 and 100.

Example
Example:
10
offset
integer

The number of items to skip before starting to return results. Used for pagination. For example, to get the next 10 items after the first 10, set offset to 10.

Responses

200

A collection of clusters

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 current result set.

integer
Example:
10
meta
required

Pagination metadata for collection responses

object
total
required

Total number of items available

integer
Example:
1000
limit
required

Maximum number of items per page

integer
Example:
10
offset
required

Number of items skipped before the current result set

integer
Example:
10
clusters
required
Array
object
id
required

Unique identifier for this resource within Aerospike Cloud

string
Example:
e2e81cba-446e-4ff9-9b92-9a9992af44c6
name
required
string
Example:
My cool cluster
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 cluster. 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 cluster.

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:
>= 1 characters
/^[a-zA-Z0-9- ]*$/
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
>= 1 characters
/^[a-zA-Z0-9./_-]*$/
tag
string
default: asd
>= 1 characters
/^[a-zA-Z0-9- ]*$/
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
format: hostname
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
format: hostname
default: null
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
format: hostname
default: null
tls-port
integer
>= 1024
<= 65535
info
object
addresses
Array<string>
default:
port
integer
>= 1024
<= 65535
tls
Array<object>
object
name
string
format: hostname
default: null
>= 1 characters
ca-file
string
""
/^[a-zA-Z0-9./_-]*$/
ca-path
string
""
/^[a-zA-Z0-9./_-]*$/
cert-blacklist
string
""
/^[a-zA-Z0-9./_-]*$/
cert-file
string
""
/^[a-zA-Z0-9./_-]*$/
cipher-suite
string
""
/^[a-zA-Z0-9- ]*$/
key-file
string
""
/^[a-zA-Z0-9./_-]*$/
key-file-password
string
""
/^[a-zA-Z0-9- ]*$/
protocols
string
default: TLSv1.2
/[a-zA-Z0-9-+]+/
namespaces
required
Array<object>
>= 1 items
<= 1 items
object
name
required
Allowed values:
null
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
Allowed values:
null
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
>= 1 characters
/^[a-zA-Z0-9./_-]*$/
encryption-old-key-file
string
>= 1 characters
/^[a-zA-Z0-9./_-]*$/
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
>= 1 characters
/^[a-zA-Z0-9./_-]*$/
security
object
default-password-file
string
""
/^[a-zA-Z0-9./_-]*$/
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
""
/^[a-zA-Z0-9-\\ ]*$/
query-user-dn
string
""
/^[a-zA-Z0-9-\\ ]*$/
query-user-password-file
string
""
/^[a-zA-Z0-9./_-]*$/
role-query-base-dn
string
""
/^[a-zA-Z0-9-\\ ]*$/
role-query-patterns
Array<string>
default:
role-query-search-ou
boolean
server
string
""
/^[a-zA-Z0-9./_-]*$/
tls-ca-file
string
""
/^[a-zA-Z0-9./_-]*$/
token-hash-method
string
default: sha-256
>= 1 characters
/^[a-zA-Z0-9- ]*$/
user-dn-pattern
string
""
/^[a-zA-Z0-9-\\ ]*$/
user-query-pattern
string
format: regex
""
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
required
string
>= 1 characters
/^[a-zA-Z0-9- ]*$/
auth-mode
string
Allowed values:
none
internal
external
external-insecure
pki
auth-password-file
string
>= 1 characters
/^[a-zA-Z0-9./_-]*$/
auth-user
string
>= 1 characters
/^[a-zA-Z0-9- ]*$/
connector
boolean
max-recoveries-interleaved
integer
<= 4294967295
node-address-ports

The address, port and TLS name of the node. The TLS name is optional.

Array<string>
>= 1 items
<= 3 items
Example:
[ "5eb35d27-23fb-4a36-b01e-6efcff9279b4.aerospike.cloud 4000 5eb35d27-23fb-4a36-b01e-6efcff9279b4.aerospike.cloud" ]
period-ms
integer
>= 5
<= 1000
tls-name
string
format: hostname
use-alternate-access-address
boolean
namespaces
required
Array<object>
>= 1 items
<= 1 items
object
name
required
string
>= 1 characters
/^[a-zA-Z0-9- ]*$/
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
>= 1 characters
/^[a-zA-Z0-9- ]*$/
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": 10,
"meta":
"total": 1000,
"limit": 10,
"offset": 10
},
"clusters":
"id": "e2e81cba-446e-4ff9-9b92-9a9992af44c6",
"name": "My cool cluster",
"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":
],
"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?