Improve/fix oas example

Author: mkistler

aip/general/0214/expiry.oas.yaml

@@ -3,24 +3,32 @@ openapi: 3.0.3
 info:
   title: Library
   version: 1.0.0
+paths: {}
 components:
-  schema:
+  schemas:
     Book:
       description: This book will self-destruct.
+      type: object
       properties:
         name:
           type: string
           description: |
             The name of the book.
             Format: publishers/{publisher}/books/{book}
-        expire_time:
-          type: string
-          format: date-time
-          description: |
-            Timestamp in UTC of when this resource is considered expired.
-            This is *always* provided on output, regardless of what was sent
-            on input.
-        ttl_seconds:
-          type: integer
-          description: The TTL for this resource.
-          writeOnly: true
+      oneOf:
+      - type: object
+        properties:
+          expireTime:
+            type: string
+            format: date-time
+            description: |
+              Timestamp in UTC of when this resource is considered expired.
+      - type: object
+        properties:
+          ttlSeconds:
+            type: integer
+            description: |
+              The TTL for this resource in seconds.
+              When this value is passed as input it is returned as the equivalent
+              expireTime on output.
+            writeOnly: true