Merge pull request #449 from bbiggerr/domain-zone-file

[New] Domain Zone File View (GET /domains/{domainId}/zone-file)

Author: bbiggerr

openapi.yaml

@@ -2985,6 +2985,61 @@ paths:
         - lang: CLI
           source: >
             linode-cli domains delete 1234
+  /domains/{domainId}/zone-file:
+    x-linode-cli-command: domains
+    parameters:
+    - name: domainId
+      in: path
+      description: ID of the Domain.
+      required: true
+      schema:
+        type: string
+    get:
+      x-linode-grant: read_only
+      tags:
+      - Domains
+      summary: Domain Zone File View
+      description: >
+        Returns the zone file for the last rendered zone for the specified domain.
+      operationId: getDomainZone
+      x-linode-cli-action: zone-file
+      security:
+      - personalAccessToken: []
+      - oauth:
+        - domains:read_only
+      responses:
+        '200':
+          description: |
+            An array containing the lines of the domain zone file.
+          content:
+            application/json:
+              schema:
+                properties:
+                  zone_file:
+                    type: array
+                    items:
+                      type: string
+                    example:
+                      - "; example.com [123]"
+                      - "$TTL 864000"
+                      - "@  IN  SOA  ns1.linode.com. user.example.com. 2021000066 14400 14400 1209600 86400"
+                      - "@    NS  ns1.linode.com."
+                      - "@    NS  ns2.linode.com."
+                      - "@    NS  ns3.linode.com."
+                      - "@    NS  ns4.linode.com."
+                      - "@    NS  ns5.linode.com."
+                    description: |
+                      The lines of the zone file for the last rendered zone for this domain.
+        default:
+          $ref: '#/components/responses/ErrorResponse'
+      x-code-samples:
+      - lang: Shell
+        source: >
+          curl -H "Authorization: Bearer $TOKEN" \
+            https://api.linode.com/v4/domains/123/zone-file
+      - lang: CLI
+        source: >
+          linode-cli domains zone-file 123
   /domains/import:
     post:
       x-linode-grant: read_write