openapi spec for advanced_pg + advanced_mysql (#1167)

* openapi spec for advanced_pg + advanced_mysql

* openapi spec for advanced_pg + advanced_mysql

* add atl1

* remove duplicate examples

* address feedback

* update description details

Author: dweinshenker

specification/resources/databases/databases_create_cluster.yml

@@ -30,6 +30,17 @@ description: >-
   database cluster and the timestamp of the backup to be restored. Creating a database
   from a backup is the same as forking a database in the control panel.
 
+
+  PostgreSQL and MySQL Advanced Edition clusters can be provisioned by setting `engine` to
+  `advanced_pg` or `advanced_mysql`. Advanced Edition clusters are currently in public
+  preview and target highly available workloads. `advanced_pg` supports 1-, 2-, and
+  3-node deployments; `advanced_mysql` only supports 1- and 3-node deployments. See the
+  [PostgreSQL Advanced Edition](https://docs.digitalocean.com/products/databases/postgresql/how-to/use-advanced-edition-clusters/)
+  and
+  [MySQL Advanced Edition](https://docs.digitalocean.com/products/databases/mysql/how-to/use-advanced-edition-clusters/)
+  documentation for the feature differences vs. Standard Edition and current preview limitations.
+
+
   Note: Caching cluster creates are no longer supported as of 2025-04-30T00:00:00Z.
   Backups are also not supported for Caching or Valkey clusters.
 
@@ -110,6 +121,42 @@ requestBody:
                 - "db.example.com"
                 - "database.myapp.io"
 
+        Create a New PostgreSQL Advanced Edition Cluster:
+          value:
+            name: backend-advanced
+            engine: advanced_pg
+            version: "18"
+            region: nyc3
+            size: db-s-2vcpu-4gb
+            num_nodes: 3
+            storage_size_mib: 61440
+            tags:
+              - production
+
+        Create a New MySQL Advanced Edition Cluster:
+          value:
+            name: backend-advanced
+            engine: advanced_mysql
+            version: "8.4.8"
+            region: nyc3
+            size: db-s-2vcpu-4gb
+            num_nodes: 3
+            storage_size_mib: 61440
+            tags:
+              - production
+
+        Create a Single-Node MySQL Advanced Edition Cluster:
+          value:
+            name: backend-advanced-single
+            engine: advanced_mysql
+            version: "8.4.8"
+            region: nyc3
+            size: db-s-2vcpu-4gb
+            num_nodes: 1
+            storage_size_mib: 61440
+            tags:
+              - production
+
 responses:
   "201":
     $ref: "responses/database_cluster.yml"

specification/resources/databases/models/database_cluster.yml

@@ -22,10 +22,14 @@ properties:
       - mongodb
       - kafka
       - opensearch
+      - advanced_pg
+      - advanced_mysql
     description: >-
       A slug representing the database engine used for the cluster. The possible values
       are: "pg" for PostgreSQL, "mysql" for MySQL, "redis" for Caching, "mongodb" for MongoDB,
-      "kafka" for Kafka, "opensearch" for OpenSearch, and "valkey" for Valkey.
+      "kafka" for Kafka, "opensearch" for OpenSearch, "valkey" for Valkey, "advanced_pg" for
+      PostgreSQL Advanced Edition, and "advanced_mysql" for MySQL Advanced Edition. Advanced
+      Edition engines are currently in public preview.
   version:
     type: string
     example: '8'

specification/resources/databases/models/database_cluster_read.yml

@@ -22,10 +22,14 @@ properties:
       - mongodb
       - kafka
       - opensearch
+      - advanced_pg
+      - advanced_mysql
     description: >-
       A slug representing the database engine used for the cluster. The possible values
       are: "pg" for PostgreSQL, "mysql" for MySQL, "redis" for Caching, "mongodb" for MongoDB,
-      "kafka" for Kafka, "opensearch" for OpenSearch, and "valkey" for Valkey.
+      "kafka" for Kafka, "opensearch" for OpenSearch, "valkey" for Valkey, "advanced_pg" for
+      PostgreSQL Advanced Edition, and "advanced_mysql" for MySQL Advanced Edition. Advanced
+      Edition engines are currently in public preview.
   version:
     type: string
     example: '8'

specification/resources/databases/models/options.yml

@@ -39,6 +39,16 @@ properties:
           - $ref: "./database_region_options.yml"
           - $ref: "./database_version_options.yml"
           - $ref: "./database_layout_options.yml"
+      advanced_pg:
+        allOf:
+          - $ref: "./database_region_options.yml"
+          - $ref: "./database_version_options.yml"
+          - $ref: "./database_layout_options.yml"
+      advanced_mysql:
+        allOf:
+          - $ref: "./database_region_options.yml"
+          - $ref: "./database_version_options.yml"
+          - $ref: "./database_layout_options.yml"
   version_availability:
     type: object
     properties:
@@ -56,3 +66,7 @@ properties:
         $ref: "./database_version_availabilities.yml"
       opensearch:
         $ref: "./database_version_availabilities.yml"
+      advanced_pg:
+        $ref: "./database_version_availabilities.yml"
+      advanced_mysql:
+        $ref: "./database_version_availabilities.yml"