DBAAS-7537: Add do_settings.service_cnames support to Databases API

specification/resources/databases/databases_create_cluster.yml

@@ -94,6 +94,22 @@ requestBody:
             size: db-s-2vcpu-4gb
             num_nodes: 2
 
+        Create a New Database Cluster with service CNAMEs:
+          value:
+            name: backend
+            engine: pg
+            version: "14"
+            region: nyc3
+            size: db-s-2vcpu-4gb
+            num_nodes: 2
+            storage_size_mib: 61440
+            tags:
+              - production
+            do_settings:
+              service_cnames:
+                - "db.example.com"
+                - "database.myapp.io"
+
 responses:
   "201":
     $ref: "responses/database_cluster.yml"

specification/resources/databases/databases_create_replica.yml

@@ -34,11 +34,24 @@ requestBody:
           - name
           - size
 
-      example:
-        name: read-nyc3-01
-        region: nyc3
-        size: db-s-2vcpu-4gb
-        storage_size_mib: 61440
+      examples:
+        Create a Read-only Replica:
+          value:
+            name: read-nyc3-01
+            region: nyc3
+            size: db-s-2vcpu-4gb
+            storage_size_mib: 61440
+
+        Create a Read-only Replica with service CNAMEs:
+          value:
+            name: read-nyc3-01
+            region: nyc3
+            size: db-s-2vcpu-4gb
+            storage_size_mib: 61440
+            do_settings:
+              service_cnames:
+                - "replica-db.example.com"
+                - "read-replica.myapp.io"
 
 responses:
   '201':

specification/resources/databases/examples/curl/databases_create_cluster.yml

@@ -3,5 +3,5 @@ source: |-
   curl -X POST \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
-    -d '{"name": "backend", "engine": "pg", "version": "14", "region": "nyc3", "size": "db-s-2vcpu-4gb", "num_nodes": 2, "storage_size_mib": 61440, "tags": ["production"]}' \
+    -d '{"name": "backend", "engine": "pg", "version": "14", "region": "nyc3", "size": "db-s-2vcpu-4gb", "num_nodes": 2, "storage_size_mib": 61440, "tags": ["production"], "do_settings": {"service_cnames": ["db.example.com", "database.myapp.io"]}}' \
     "https://api.digitalocean.com/v2/databases"

specification/resources/databases/examples/curl/databases_create_replica.yml

@@ -3,5 +3,5 @@ source: |-
   curl -X POST \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
-    -d '{"name":"read-nyc3-01", "region":"nyc3", "size": "db-s-2vcpu-4gb", "storage_size_mib": 61440}' \
+    -d '{"name":"read-nyc3-01", "region":"nyc3", "size": "db-s-2vcpu-4gb", "storage_size_mib": 61440, "do_settings": {"service_cnames": ["replica-db.example.com", "read-replica.myapp.io"]}}' \
     "https://api.digitalocean.com/v2/databases/9cc10173-e9ea-4176-9dbc-a4cee4c4ff30/replicas"

specification/resources/databases/examples/go/databases_create_cluster.yml

@@ -21,6 +21,9 @@ source: |-
           SizeSlug:   "db-s-2vcpu-4gb",
           NumNodes:   2,
           StorageSizeMiB : 61440,
+          DOSettings: &godo.DOSettings{
+              ServiceCnames: []string{"db.example.com", "database.myapp.io"},
+          },
       }
 
       cluster, _, err := client.Databases.Create(ctx, createRequest)

specification/resources/databases/examples/go/databases_create_replica.yml

@@ -14,11 +14,13 @@ source: |-
       ctx := context.TODO()
 
       replicaRequest := &godo.DatabaseCreateReplicaRequest{
-
           Name:   "read-nyc3-01",
           Region: "nyc3",
           Size:   "db-s-2vcpu-4gb",
-          StorageSizeMiB : 61440,
+          StorageSizeMiB: 61440,
+          DOSettings: &godo.DOSettings{
+              ServiceCnames: []string{"replica-db.example.com", "read-replica.myapp.io"},
+          },
       }
 
       replica, _, err := client.Databases.CreateReplica(ctx, "9cc10173-e9ea-4176-9dbc-a4cee4c4ff30", replicaRequest)

specification/resources/databases/examples/python/databases_create_cluster.yml

@@ -15,7 +15,13 @@ source: |-
     "storage_size_mib": 61440,
     "tags": [
       "production"
-    ]
+    ],
+    "do_settings": {
+      "service_cnames": [
+        "db.example.com",
+        "database.myapp.io"
+      ]
+    }
   }
 
   create_resp = client.databases.create_cluster(body=create_req)

specification/resources/databases/examples/python/databases_create_replica.yml

@@ -10,6 +10,12 @@ source: |-
     "region": "nyc3",
     "size": "db-s-2vcpu-4gb",
     "storage_size_mib": 61440,
+    "do_settings": {
+      "service_cnames": [
+        "replica-db.example.com",
+        "read-replica.myapp.io"
+      ]
+    }
   }
 
   create_resp = client.databases.create_replica(database_cluster_uuid="9cc10173", body=create_req)

specification/resources/databases/models/database_cluster.yml

@@ -177,6 +177,11 @@ properties:
     description: >-
       Autoscaling configuration for the database cluster. Currently only supports storage autoscaling. If null, autoscaling is
       not configured for the cluster.
+  do_settings:
+    allOf:
+    - $ref: './do_settings.yml'
+    - description: >-
+        DigitalOcean-specific settings for the database cluster, including custom service CNAMEs.
 
 
 

specification/resources/databases/models/database_cluster_read.yml

@@ -171,6 +171,11 @@ properties:
       Public hostname and port of the cluster's metrics endpoint(s). Includes one record for the cluster's primary node and
       a second entry for the cluster's standby node(s).
     readOnly: true
+  do_settings:
+    allOf:
+    - $ref: './do_settings.yml'
+    - description: >-
+        DigitalOcean-specific settings for the database cluster, including custom service CNAMEs.
 
 
 

specification/resources/databases/models/database_replica.yml

@@ -76,6 +76,11 @@ properties:
     description: >-
       Additional storage added to the cluster, in MiB. If null, no additional storage is added to the cluster, beyond
       what is provided as a base amount from the 'size' and any previously added additional storage.
+  do_settings:
+    allOf:
+    - $ref: './do_settings.yml'
+    - description: >-
+        DigitalOcean-specific settings for the read-only replica, including custom service CNAMEs.
 
 required:
   - name

specification/resources/databases/models/database_replica_read.yml

@@ -74,6 +74,11 @@ properties:
     description: >-
       Additional storage added to the cluster, in MiB. If null, no additional storage is added to the cluster, beyond
       what is provided as a base amount from the 'size' and any previously added additional storage.
+  do_settings:
+    allOf:
+    - $ref: './do_settings.yml'
+    - description: >-
+        DigitalOcean-specific settings for the read-only replica, including custom service CNAMEs.
 
 required:
   - name

specification/resources/databases/models/do_settings.yml

@@ -0,0 +1,20 @@
+type: object
+
+description: >-
+  DigitalOcean-specific settings for the database cluster.
+
+properties:
+  service_cnames:
+    type: array
+    items:
+      type: string
+      pattern: '^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?)+$'
+      maxLength: 253
+    maxItems: 16
+    example:
+      - "db.example.com"
+      - "database.myapp.io"
+    description: >-
+      An array of custom CNAMEs for the database cluster. Each CNAME must be a valid
+      RFC 1123 hostname (e.g., "db.example.com"). Maximum of 16 CNAMEs allowed, each
+      up to 253 characters.

specification/resources/databases/responses/database_cluster.yml

@@ -80,3 +80,7 @@ content:
         version_end_of_life: '2023-11-09T00:00:00Z'
         version_end_of_availability: '2023-05-09T00:00:00Z'
         storage_size_mib: 61440
+        do_settings:
+          service_cnames:
+            - "db.example.com"
+            - "database.myapp.io"

specification/resources/databases/responses/database_replica.yml

@@ -37,3 +37,7 @@ content:
         region: nyc3
         status: online
         created_at: '2019-01-11T18:37:36Z'
+        do_settings:
+          service_cnames:
+            - "replica-db.example.com"
+            - "read-replica.myapp.io"