Update Domain schema and Domain Create/Update

Author: bbiggerr

openapi.yaml

@@ -2625,7 +2625,11 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/Domain'
+              required:
+              - domain
+              - type
+              allOf:
+              - $ref: '#/components/schemas/Domain'
       responses:
         '200':
           description: |
@@ -2730,6 +2734,7 @@ paths:
           content:
             application/json:
               schema:
+                required: domain
                 $ref: '#/components/schemas/Domain'
         default:
           $ref: '#/components/responses/ErrorResponse'
@@ -15771,10 +15776,6 @@ components:
         A domain zonefile in our DNS system.  You must own the domain name and
         tell your registrar to use Linode's nameservers in order for a domain
         in our system to be treated as authoritative.
-      required:
-      - id
-      - domain
-      - type
       properties:
         id:
           type: integer
@@ -15795,6 +15796,8 @@ components:
         domain:
           type: string
           pattern: ([a-zA-Z0-9-_]{1,63}\.)+([a-zA-Z]{2,3}\.)?([a-zA-Z]{2,16}|xn--[a-zA-Z0-9]+\.?)
+          minLength: 1
+          maxLength: 255
           description: >
             The domain this Domain represents. Domain labels cannot be longer than
             63 characters and must conform to [RFC1035](https://tools.ietf.org/html/rfc1035).
@@ -15818,6 +15821,7 @@ components:
           enum:
           - disabled
           - active
+          default: active
           description: >
             Used to control whether this Domain is currently being rendered.
           example: active
@@ -15844,11 +15848,16 @@ components:
           x-linode-cli-display: 5
         retry_sec:
           type: integer
-          description: >
+          default: "0"
+          description: |
             The interval, in seconds, at which a failed refresh should be retried.
-            Valid values are 300, 3600, 7200, 14400, 28800, 57600,
-            86400, 172800, 345600, 604800, 1209600, and 2419200 - any other
-            value will be rounded to the nearest valid value.
+
+            * Valid values are
+            0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.
+
+            * Any other value is rounded up to the nearest valid value.
+
+            * A value of 0 is equivalent to the default value of 14400.
           example: 300
         master_ips:
           type: array
@@ -15871,34 +15880,44 @@ components:
           example: []
         expire_sec:
           type: integer
-          description: >
+          default: "0"
+          description: |
             The amount of time in seconds that may pass before this Domain is no longer
-            authoritative. Valid values are
-            300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600,
-            604800, 1209600, and 2419200 - any other value will be rounded to
-            the nearest valid value.
+            authoritative.
+
+            * Valid values are
+            0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.
+
+            * Any other value is rounded up to the nearest valid value.
+
+            * A value of 0 is equivalent to the default value of 1209600.
           example: 300
         refresh_sec:
           type: integer
-          description: >
+          default: "0"
+          description: |
             The amount of time in seconds before this Domain should be refreshed.
-            Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600,
-            604800, 1209600, and 2419200 - any other value will be rounded to
-            the nearest valid value.
+
+            * Valid values are
+            0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.
+
+            * Any other value is rounded up to the nearest valid value.
+
+            * A value of 0 is equivalent to the default value of 14400.
           example: 300
         ttl_sec:
           type: integer
+          default: "0"
           description: >
             "Time to Live" - the amount of time in seconds that this Domain's
             records may be cached by resolvers or other domain servers.
 
-            * Valid values are 0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800,
-            345600, 604800, 1209600, and 2419200 - any other value will be
-            rounded to the nearest valid value.
+            * Valid values are
+            0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.
 
-            * ttl_sec will default to 0 if no value is provided.
+            * Any other value is rounded up to the nearest valid value.
 
-            * A value of 0 is equivalent to a value of 86400.
+            * A value of 0 is equivalent to the default value of 86400.
           example: 300
         tags:
           x-linode-filterable: true