Couchbase Public API
- beta
API reference guide for the Couchbase Cloud Public API.
| The API is regularly updated along with the documentation. In the process, documentation may be built first — so it is possible that a new endpoint listed here may be some hours from reaching the API. |
Endpoints
Clouds
clouds/list
GET /v2/clouds
List Clouds
Clusters
clusters/create
POST /v2/clusters
Create cluster
clusters/createAllowlistEntry
POST /v2/clusters/{id}/allowlist
Adds entry to allowlist
clusters/createBucket
POST /v2/clusters/{id}/buckets
Create bucket in cluster
clusters/createUser
POST /v2/clusters/{id}/users
Create Database User
Description
Creates Database user. A database user entity is required for applications to remotely authenticate on a cluster and access bucket data
clusters/delete
DELETE /v2/clusters/{id}
Delete cluster
clusters/deleteAllowlistEntry
DELETE /v2/clusters/{id}/allowlist
Delete entry from allowlist
clusters/deleteBucket
DELETE /v2/clusters/{id}/buckets
Delete bucket in cluster
clusters/deleteUser
DELETE /v2/clusters/{id}/users/{username}
Delete Database User
clusters/getAllowlist
GET /v2/clusters/{id}/allowlist
Get current allowlist
clusters/getCertificate
GET /v2/clusters/{id}/certificate
Get Cluster Certificate
Description
Retrieve a self-signed certificate to securely connect to the cluster. Required for both public and private connections.
clusters/health
GET /v2/clusters/{id}/health
Get Cluster Health
Description
Retrieve Cluster health and status. Health stats of the cluster are returned only for clusters with ready status.
clusters/list
GET /v2/clusters
List Clusters
Parameters
Query Parameters
| Name | Description | Required | Default | Pattern |
|---|---|---|---|---|
page |
Sets how many results you would like to have on each page |
- |
null |
|
perPage |
Sets what page you would like to view |
- |
null |
|
sortBy |
Sets order of how you would like to sort results and also the key you would like to order by |
- |
null |
|
cloudId |
Cloud ID for filtering cloud clusters. |
- |
null |
|
projectId |
Project ID for filtering project clusters. |
- |
null |
clusters/listBuckets
GET /v2/clusters/{id}/buckets
List cluster buckets
clusters/listUsers
GET /v2/clusters/{id}/users
List Database Users
clusters/show
GET /v2/clusters/{id}
Get Cluster
Projects
projects/create
POST /v2/projects
Create project
projects/delete
DELETE /v2/projects/{id}
Delete project
projects/list
GET /v2/projects
List Projects
Models
AWSProviderSettings
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
region |
||||
bucket |
||||
supportBucket |
||||
accountId |
||||
vpcCidr |
||||
vpcId |
||||
stackId |
||||
privateSubnets |
List of [string] |
|||
availabilityZone |
List of [string] |
|||
azCount |
||||
lastRotated |
date-time |
AllowListEntry
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
cidrBlock |
X |
|||
ruleType |
X |
|||
duration |
||||
createdAt |
X |
date-time |
||
expiresAt |
date-time |
|||
updatedAt |
X |
date-time |
||
comment |
X |
|||
state |
X |
AppendAllowListRequest
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
cidrBlock |
X |
|||
ruleType |
X |
|||
comment |
||||
duration |
The duration you would like the temporary cidr block to be active |
AwsInstances
Allowable Values
m5.large, m5.xlarge, m5.2xlarge, m5.4xlarge, m5.8xlarge, m5.12xlarge, m5.16xlarge, m5.24xlarge, r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.8xlarge, r5.12xlarge, r5.24xlarge, c5.large, c5.xlarge, c5.2xlarge, c5.4xlarge, c5.9xlarge, c5.12xlarge, c5.18xlarge, x1.16xlarge, x1.32xlarge
AzureInstances
Allowable Values
Standard_F4s_v2, Standard_F8s_v2, Standard_F16s_v2, Standard_F32s_v2, Standard_F48s_v2, Standard_F64s_v2, Standard_F72s_v2, Standard_D4s_v3, Standard_D8s_v3, Standard_D16s_v3, Standard_D32s_v3, Standard_D48s_v3, Standard_D64s_v3, Standard_E4s_v3, Standard_E8s_v3, Standard_E16s_v3, Standard_E20s_v3, Standard_E32s_v3, Standard_E48s_v3, Standard_E64s_v3, Standard_GS2, Standard_GS3, Standard_GS4, Standard_GS5
AzureProviderSettings
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
resourceGroupName |
||||
region |
||||
aksClusterName |
||||
dnsPrefix |
||||
defaultNodePoolName |
||||
tags |
Map of [string] |
|||
vNetCidr |
||||
vNetName |
||||
storageAccountName |
||||
configContainerName |
||||
importContainerName |
||||
availabilityZones |
List of [string] |
|||
azCount |
||||
deploymentName |
||||
msiName |
||||
tenantId |
||||
subscriptionId |
BucketRole
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
name |
X |
Bucket Name |
||
roles |
X |
Set of BucketRoleTypes |
BucketStats
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
status |
X |
|||
totalCount |
X |
|||
unhealthyCount |
X |
|||
healthStats |
X |
Map of [string] |
Cloud
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
id |
X |
uuid |
||
name |
X |
|||
tenantId |
X |
uuid |
||
status |
X |
|||
provider |
X |
|||
createdAt |
X |
date-time |
||
updatedAt |
date-time |
|||
preflightStartedAt |
date-time |
|||
preflightFailedAt |
date-time |
|||
preflightCompletedAt |
date-time |
|||
bootstrappedAt |
date-time |
|||
deployedAt |
date-time |
|||
destroyedAt |
date-time |
|||
providerSettings |
X |
|||
version |
X |
CloudProviderSettings
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
resourceGroupName |
||||
region |
||||
aksClusterName |
||||
dnsPrefix |
||||
defaultNodePoolName |
||||
tags |
Map of [string] |
|||
vNetCidr |
||||
vNetName |
||||
storageAccountName |
||||
configContainerName |
||||
importContainerName |
||||
availabilityZones |
List of [string] |
|||
azCount |
||||
deploymentName |
||||
msiName |
||||
tenantId |
||||
subscriptionId |
||||
bucket |
||||
supportBucket |
||||
accountId |
||||
vpcCidr |
||||
vpcId |
||||
stackId |
||||
privateSubnets |
List of [string] |
|||
availabilityZone |
List of [string] |
|||
lastRotated |
date-time |
CloudSummary
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
id |
X |
uuid |
||
name |
X |
|||
status |
X |
|||
provider |
X |
|||
region |
X |
|||
virtualNetworkID |
X |
|||
virtualNetworkCIDR |
X |
CloudVersion
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
name |
X |
|||
components |
X |
Map of [string] |
Cluster
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
id |
X |
|||
name |
X |
|||
tenantId |
X |
|||
cloudId |
X |
|||
projectId |
X |
|||
status |
X |
|||
resourceIdentifier |
X |
Resource identifier name linked with the Cloud Provider |
||
createdAt |
date-time |
|||
updatedAt |
date-time |
|||
deployedAt |
date-time |
|||
version |
||||
endpointsURL |
List of [string] |
|||
privateEndpointURL |
List of [string] |
|||
endpointsSrv |
||||
privateEndpointsSrv |
ClusterHealth
Description
-
healthy- denotes that the resource is in a healthy state. -
unhealthy- denotes that the resource is in an uhealthy state. -
degraded- is reported for the overall health of a cluster or overall health for all nodes if all unhealthy nodes in the cluster are failed over. -
failedOver- enotes that a couchbase server node failed over to a new pod. This status is attached only to a node. -
inactiveFailed- is the value of the cluster membership as reported for a couchbase server node when it is in failed over state. -
N/A- is the value of the cluster membership if we are unable to determine the health of the cluster
ClusterHealthResponse
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
status |
X |
|||
health |
X |
|||
bucketStats |
||||
nodeStats |
ClusterStatus
Allowable Values
draft, needs_deploy, job_scheduled, deploying, deploy_failed, deploy_succeeded, ready, destroying, destroy_failed, destroy_succeeded, metrics_failed, preflight_started, preflight_failed, preflight_succeeded, management_blocked, upgrading
Description
-
draft- indicates that all fields under database model are mutable. -
needs_deploy- indicates that the new configuration changes have not been applied to the cluster -
job_scheduled- indicates that the new configuration changes have been scheduled to be applied. -
deploying- indicates that database is currently being deployed/new configurations being applied. -
deploy_failed- indicates that the last deployment failed. -
deploy_succeeded- indicates that the last deployment succeeded. -
ready- indicates that the database is ready. -
destroying- indicates that the database is being destroyed. -
destroy_failed- indicates that the database destroy job failed. -
destroy_succeeded- indicates that the database destroy job succeeded. -
metrics_failed- indicates that the database is not serving metrics. -
preflight_started- indicates a preflight check has started on the database -
preflight_failed- indicates a preflight check has failed on the database -
preflight_succeeded- indicates a preflight check has succeeded on the database -
management_blocked- indicates the IAM credentiald for the cloud hosting the databse have been deleted. -
upgrading- indicates the database is being upgrading.
ClusterSummary
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
id |
X |
uuid |
||
name |
X |
|||
tenantId |
X |
uuid |
||
cloudId |
X |
uuid |
||
projectId |
X |
uuid |
||
services |
X |
List of CouchbaseServices |
||
nodes |
X |
ClusterVersion
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
name |
X |
|||
components |
X |
Map of [string] |
CouchbaseBucketSpec
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
name |
X |
|||
memoryQuota |
X |
|||
replicas |
||||
conflictResolution |
CreateClusterRequest
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
name |
X |
|||
cloudId |
X |
uuid |
||
projectId |
X |
uuid |
||
servers |
List of Server |
|||
supportPackage |
||||
version |
If not defined the latest version of Couchbase Server is deployed. |
CreateDatabaseUserRequest
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
userId |
Organisation user which is assigned to the database user. |
uuid |
||
username |
X |
|||
password |
X |
|||
access |
X |
List of BucketRole |
CursorPages
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
page |
Current page starting from 1. |
|||
next |
Next page number, it is not set on the last page. |
|||
previous |
Previous page number, it is not set on the first page. |
|||
last |
Last page number. |
|||
perPage |
How many items are displayed in the page. |
|||
totalItems |
X |
Total items found by the given query. |
DeleteBucketRequest
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
name |
X |
The name of the bucket to be deleted |
ListBucketItem
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
name |
X |
|||
memoryQuota |
X |
|||
replicas |
X |
|||
conflictResolution |
X |
|||
status |
X |
ListCloudsResponse
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
cursor |
X |
|||
data |
X |
List of CloudSummary |
ListClustersResponse
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
cursor |
X |
|||
data |
X |
List of ClusterSummary |
ListDatabaseUsersResponseItem
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
userId |
Organisation user ID Database user is attached to |
uuid |
||
username |
X |
|||
access |
X |
List of BucketRole |
ListProjectsResponse
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
cursor |
X |
|||
data |
X |
List of Project |
ListUsersResponse
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
cursor |
X |
|||
data |
X |
List of ListUsersResponseItem |
NodeStats
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
status |
X |
|||
totalCount |
X |
|||
failedOverCount |
X |
|||
unhealthyCount |
X |
|||
serviceStats |
X |
List of ServiceStats |
Project
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
id |
X |
uuid |
||
name |
X |
|||
tenantId |
X |
uuid |
||
createdAt |
X |
Creation date and time |
date-time |
Server
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
size |
X |
|||
services |
X |
List of CouchbaseServices |
||
aws |
||||
azure |
ServiceStats
| Field Name | Required | Type | Description | Format |
|---|---|---|---|---|
services |
X |
List of [string] |
||
nodeName |
X |
|||
status |
X |