YugabyteDB UniverseClusterMutations API
The UniverseClusterMutations API from YugabyteDB — 4 operation(s) for universeclustermutations.
YugabyteDB UniverseClusterMutations API is one of 73 APIs that YugabyteDB publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include UniverseClusterMutations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.
This API exposes 5 operations across 4 paths, and defines 91 schemas. It is described by OpenAPI 3.1.0, at version v1.
Requests are made against a single base URL, https://cloud.yugabyte.com/api/public/v1.
5 operations
4 paths
91 schemas
1 DELETE2 POST2 PUT
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
YugabyteDB UniverseClusterMutations API declares
1 security scheme
for authenticating requests.
It accepts HTTP bearer tokens (bearerAuth).
By default, every request must be authenticated.
bearerAuth— API key obtained from the YugabyteDB Aeon UI under User Profile API Keys. Pass the key as a Bearer token in the Authorization header.
Paths & Operations 5
Across 4 paths, the API surfaces 5 operations — 1 DELETE, 2 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.
UniverseClusterMutations 5
POST
/api/v1/customers/{cUUID}/universes/clusters
YugabyteDB Anywhere Create Universe Clusters
PUT
/api/v1/customers/{cUUID}/universes/{uniUUID}/clusters/primary
YugabyteDB Anywhere Update Primary Cluster
POST
/api/v1/customers/{cUUID}/universes/{uniUUID}/clusters/read_only
YugabyteDB Anywhere Create ReadOnly Cluster
PUT
/api/v1/customers/{cUUID}/universes/{uniUUID}/clusters/read_only
YugabyteDB Anywhere Update Readonly Cluster
DELETE
/api/v1/customers/{cUUID}/universes/{uniUUID}/clusters/read_only/{clustUUID}
YugabyteDB Anywhere Delete Readonly Cluster
Schemas 91
The contract defines 91 schemas that model the data the API accepts and returns. The most detailed are UniverseConfigureTaskParams (67 properties), UniverseConfigureTaskParams_2 (67 properties), UniverseDefinitionTaskParams (64 properties), UniverseDefinitionTaskParams_2 (64 properties). Each schema is shown below with its type and property counts.
QueryLogConfig
object
Query Log Configuration
3 properties
1 required
NodeDetails
object
Details of a cloud node
37 properties
AvailabilityZone
object
Availability zone (AZ) for a region
9 properties
1 required
EarlyoomConfig
object
State for earlyoom service
6 properties
MetricsExportConfig
object
Metrics Export Configuration
5 properties
1 required
UniverseQueryLogsExporterConfig
object
Universe Logs Exporter Config
7 properties
2 required
AZCloudInfo
object
1 property
YBPTask
object
2 properties
SpecificGFlags
object
GFlags for current cluster
4 properties
EncryptionAtRestConfig
object
Encryption at rest configuration
4 properties
AWSRegionCloudInfo
object
4 properties
RegionDetails
object
1 property
YCQLAuditConfig
object
YCQL Audit Logging Configuration
8 properties
8 required
CloudSpecificInfo
object
Node information reported by the cloud provider
18 properties
AvailabilityZoneDetails
object
1 property
AZOverrides
object
WARNING: This is a preview API that could change. Availability zone level overrides
5 properties
YSQLAuditConfig
object
YSQL Audit Logging Configuration
11 properties
11 required
Cluster
object
7 properties
2 required
UniverseLogsExporterConfig
object
Universe Logs Exporter Config
2 properties
2 required
AdditionalServicesStateData
object
Additional services state
2 properties
AzureRegionCloudInfo
object
5 properties
PrevYBSoftwareConfig
object
5 properties
AuditLogConfig
object
Audit Log Configuration
4 properties
1 required
YSQLQueryLogConfig
object
YSQL Query Logging Configuration
10 properties
9 required
ExtraDependencies
object
Extra dependencies
1 property
PartitionInfo
object
WARNING: This is a preview API that could change. Information about Geo partition
5 properties
GCPRegionCloudInfo
object
2 properties
PlacementAZ
object
9 properties
Users
object
A user associated with a customer
12 properties
3 required
UniverseMetricsExporterConfig
object
Metrics Exporter Configuration
8 properties
2 required
Region
object
Region within a given provider. Typically, this maps to a single cloud provider region.
12 properties
1 required
DeviceInfo
object
Device information
8 properties
K8SNodeResourceSpec
object
2 properties
2 required
PerProcessDetails
object
WARNING: This is a preview API that could change. User intent Properties that can be overriden on per-process basis.
2 properties
UserIntent
object
55 properties
UserIntentOverrides
object
WARNING: This is a preview API that could change. User Intent overrides
2 properties
CloudVolumeEncryption
object
Volume encryption settings for AWS EBS volumes
2 properties
PerProcessFlags
object
1 property
1 required
UniverseConfigureTaskParams
object
67 properties
5 required
CommunicationPorts
object
Communication ports
15 properties
PlacementCloud
object
4 properties
XClusterInfo
object
1 property
ProxyConfig
object
The Proxy Settings for the Universe
3 properties
PlacementRegion
object
5 properties
KubernetesRegionInfo
object
22 properties
1 required
RegionCloudInfo
object
4 properties
PlacementInfo
object
1 property
1 required
UniverseDefinitionTaskParams
object
64 properties
5 required
QueryLogConfig_2
object
Query Log Configuration
3 properties
1 required
NodeDetails_2
object
Details of a cloud node
37 properties
AvailabilityZone_2
object
Availability zone (AZ) for a region
9 properties
1 required
EarlyoomConfig_2
object
State for earlyoom service
6 properties
MetricsExportConfig_2
object
Metrics Export Configuration
5 properties
1 required
UniverseQueryLogsExporterConfig_2
object
Universe Logs Exporter Config
7 properties
2 required
YBPTask_2
object
2 properties
SpecificGFlags_2
object
GFlags for current cluster
4 properties
EncryptionAtRestConfig_2
object
Encryption at rest configuration
4 properties
AWSRegionCloudInfo_2
object
4 properties
YCQLAuditConfig_2
object
YCQL Audit Logging Configuration
8 properties
8 required
CloudSpecificInfo_2
object
Node information reported by the cloud provider
18 properties
AZOverrides_2
object
WARNING: This is a preview API that could change. Availability zone level overrides
5 properties
YSQLAuditConfig_2
object
YSQL Audit Logging Configuration
11 properties
11 required
Cluster_2
object
7 properties
2 required
UniverseLogsExporterConfig_2
object
Universe Logs Exporter Config
2 properties
2 required
AdditionalServicesStateData_2
object
Additional services state
2 properties
AzureRegionCloudInfo_2
object
5 properties
PrevYBSoftwareConfig_2
object
5 properties
AuditLogConfig_2
object
Audit Log Configuration
4 properties
1 required
YSQLQueryLogConfig_2
object
YSQL Query Logging Configuration
10 properties
9 required
ExtraDependencies_2
object
Extra dependencies
1 property
PartitionInfo_2
object
WARNING: This is a preview API that could change. Information about Geo partition
5 properties
GCPRegionCloudInfo_2
object
2 properties
PlacementAZ_2
object
9 properties
Users_2
object
A user associated with a customer
12 properties
3 required
UniverseMetricsExporterConfig_2
object
Metrics Exporter Configuration
8 properties
2 required
Region_2
object
Region within a given provider. Typically, this maps to a single cloud provider region.
12 properties
1 required
DeviceInfo_2
object
Device information
8 properties
K8SNodeResourceSpec_2
object
2 properties
2 required
PerProcessDetails_2
object
WARNING: This is a preview API that could change. User intent Properties that can be overriden on per-process basis.
2 properties
UserIntent_2
object
55 properties
UserIntentOverrides_2
object
WARNING: This is a preview API that could change. User Intent overrides
2 properties
CloudVolumeEncryption_2
object
Volume encryption settings for AWS EBS volumes
2 properties
PerProcessFlags_2
object
1 property
1 required
UniverseConfigureTaskParams_2
object
67 properties
5 required
CommunicationPorts_2
object
Communication ports
15 properties
PlacementCloud_2
object
4 properties
XClusterInfo_2
object
1 property
PlacementRegion_2
object
5 properties
KubernetesRegionInfo_2
object
22 properties
1 required
PlacementInfo_2
object
1 property
1 required
UniverseDefinitionTaskParams_2
object
64 properties
5 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from YugabyteDB 12
Other APIs YugabyteDB publishes across the network.
YugabyteDB Access Keys API
YugabyteDB Accounts API
YugabyteDB Alerts API
YugabyteDB AllowLists API
YugabyteDB Asynchronous Replication API
YugabyteDB Audit API
YugabyteDB Authentication API
YugabyteDB Availability Zones API
YugabyteDB Backup and Restore API
YugabyteDB Backups API
YugabyteDB Certificate Info API
YugabyteDB Cloud providers API
#UniverseClusterMutations