# List clusters. GET /database/clusters - Retrieves a list of all clusters accessible to the user. The list can be filtered by status. ## Authorizations - **[publicOauth2](https://aerospike.com/docs/cloud/reference/api/#publicoauth2)** read:database ## Parameters ### Query Parameters **status\_ne** Array 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** Pagination metadata 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 **logging** object **logBucket** The ARN of the S3 bucket the logs reside in string Example: arn:aws:s3:::db\_logs **authorizedRoles** A list of role ARNs authorized to read the log bucket Array Example: \[ "arn:aws:iam::123456789012:role/ASLogReader" \] **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 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](#tab-panel-8) - [gp3](#tab-panel-9) - [io1](#tab-panel-10) - [io2](#tab-panel-11) _gp2_ object **type** required General Purpose SSD (gp2) string Allowed values: gp2 **sizeInGB** required Size of the EBS volume in gigabytes integer \>= 1 _gp3_ object **type** required General Purpose SSD (gp3) string Allowed values: gp3 **iops** required IOPS for gp3 (min 3000, max 16000). Max 500 IOPS per GB (not enforced by schema). integer \>= 3000 <= 16000 **sizeInGB** required Size of the EBS volume in gigabytes integer \>= 1 _io1_ object **type** required Provisioned IOPS SSD (io1) string Allowed values: io1 **iops** required IOPS for io1 (min 100, max 64000). Max 50 IOPS per GB (not enforced by schema). integer \>= 100 <= 64000 **sizeInGB** required Size of the EBS volume in gigabytes (min 4 for io1) integer \>= 4 _io2_ object **type** required Provisioned IOPS SSD (io2) string Allowed values: io2 **iops** required IOPS for io2 (min 100, max 64000). Max 1000 IOPS per GB (not enforced by schema). integer \>= 100 <= 64000 **sizeInGB** required Size of the EBS volume in gigabytes (min 4 for io2) integer \>= 4 **hostedZoneId** The Route 53 hosted zone ID for the database string Example: Z1234567890ABCD **aerospikeCloud** required Any of: - [In-memory database](#tab-panel-18) - [Local disk database](#tab-panel-19) - [Network storage database](#tab-panel-20) 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 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: local-disk **dataResiliency** Persist data using network storage. If omitted, data is stored only on local SSDs without additional persistence. string Allowed values: network-storage 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: 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 **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 <= 58982 **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