Microsoft Azure RecordSets API

openapi: 3.2.0
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector Record Sets API
tags:
- name: RecordSets
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName}
  : patch:
      tags:
      - RecordSets
      operationId: microsoftAzureRecordsetsUpdate
      description: Updates a record set within a DNS zone.
      parameters:
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
      - $ref: '#/components/parameters/ZoneNameParameter'
      - $ref: '#/components/parameters/RelativeRecordSetNameParameter'
      - $ref: '#/components/parameters/RecordTypeParameter'
      - name: If-Match
        in: header
        required: false
        x-ms-client-name: IfMatch
        description: The etag of the record set. Omit this value to always overwrite the current record set. Specify the last-seen etag value to prevent accidentally overwriting concurrent changes.
        schema:
          type: string
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
      responses:
        '200':
          description: The record set has been updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordSet'
        default:
          description: Default response. It will be deserialized as per the Error definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      x-ms-examples:
        Patch A recordset:
          $ref: ./examples/PatchARecordset.json
        Patch AAAA recordset:
          $ref: ./examples/PatchAAAARecordset.json
        Patch CAA recordset:
          $ref: ./examples/PatchCaaRecordset.json
        Patch CNAME recordset:
          $ref: ./examples/PatchCNAMERecordset.json
        Patch MX recordset:
          $ref: ./examples/PatchMXRecordset.json
        Patch NS recordset:
          $ref: ./examples/PatchNSRecordset.json
        Patch PTR recordset:
          $ref: ./examples/PatchPTRRecordset.json
        Patch SOA recordset:
          $ref: ./examples/PatchSOARecordset.json
        Patch SRV recordset:
          $ref: ./examples/PatchSRVRecordset.json
        Patch TXT recordset:
          $ref: ./examples/PatchTXTRecordset.json
        Patch DS recordset:
          $ref: ./examples/PatchDSRecordset.json
        Patch TLSA recordset:
          $ref: ./examples/PatchTLSARecordset.json
        Patch NAPTR recordset:
          $ref: ./examples/PatchNAPTRRecordset.json
      summary: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Network Dnszones Zonename Recordtype Relativerecordsetname
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecordSet'
        description: Parameters supplied to the Update operation.
        required: true
    put:
      tags:
      - RecordSets
      operationId: microsoftAzureRecordsetsCreateorupdate
      description: Creates or updates a record set within a DNS zone. Record sets of type SOA can be updated but not created (they are created when the DNS zone is created).
      parameters:
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
      - $ref: '#/components/parameters/ZoneNameParameter'
      - $ref: '#/components/parameters/RelativeRecordSetNameParameter'
      - $ref: '#/components/parameters/RecordTypeParameter'
      - name: If-Match
        in: header
        required: false
        x-ms-client-name: IfMatch
        description: The etag of the record set. Omit this value to always overwrite the current record set. Specify the last-seen etag value to prevent accidentally overwriting any concurrent changes.
        schema:
          type: string
      - name: If-None-Match
        in: header
        required: false
        x-ms-client-name: IfNoneMatch
        description: Set to '*' to allow a new record set to be created, but to prevent updating an existing record set. Other values will be ignored.
        schema:
          type: string
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
      responses:
        '200':
          description: The record set has been updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordSet'
        '201':
          description: The record set has been created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordSet'
        default:
          description: Default response. It will be deserialized as per the Error definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      x-ms-examples:
        Create A recordset:
          $ref: ./examples/CreateOrUpdateARecordset.json
        Create A recordset with alias target resource:
          $ref: ./examples/CreateOrUpdateARecordsetAlias.json
        Create A recordset with traffic management profile:
          $ref: ./examples/CreateOrUpdateARecordSetTrafficManagementProfile.json
        Create AAAA recordset:
          $ref: ./examples/CreateOrUpdateAAAARecordset.json
        Create CAA recordset:
          $ref: ./examples/CreateOrUpdateCaaRecordset.json
        Create CNAME recordset:
          $ref: ./examples/CreateOrUpdateCNAMERecordset.json
        Create MX recordset:
          $ref: ./examples/CreateOrUpdateMXRecordset.json
        Create NS recordset:
          $ref: ./examples/CreateOrUpdateNSRecordset.json
        Create PTR recordset:
          $ref: ./examples/CreateOrUpdatePTRRecordset.json
        Create SOA recordset:
          $ref: ./examples/CreateOrUpdateSOARecordset.json
        Create SRV recordset:
          $ref: ./examples/CreateOrUpdateSRVRecordset.json
        Create TXT recordset:
          $ref: ./examples/CreateOrUpdateTXTRecordset.json
        Create DS recordset:
          $ref: ./examples/CreateOrUpdateDSRecordset.json
        Create TLSA recordset:
          $ref: ./examples/CreateOrUpdateTLSARecordset.json
        Create NAPTR recordset:
          $ref: ./examples/CreateOrUpdateNAPTRRecordset.json
      summary: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Network Dnszones Zonename Recordtype Relativerecordsetname
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecordSet'
        description: Parameters supplied to the CreateOrUpdate operation.
        required: true
    delete:
      tags:
      - RecordSets
      operationId: microsoftAzureRecordsetsDelete
      description: Deletes a record set from a DNS zone. This operation cannot be undone. Record sets of type SOA cannot be deleted (they are deleted when the DNS zone is deleted).
      parameters:
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
      - $ref: '#/components/parameters/ZoneNameParameter'
      - $ref: '#/components/parameters/RelativeRecordSetNameParameter'
      - $ref: '#/components/parameters/RecordTypeParameter'
      - name: If-Match
        in: header
        required: false
        x-ms-client-name: IfMatch
        description: The etag of the record set. Omit this value to always delete the current record set. Specify the last-seen etag value to prevent accidentally deleting any concurrent changes.
        schema:
          type: string
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
      responses:
        '200':
          description: The record set has been deleted.
        '204':
          description: The record set was not found.
        default:
          description: Default response. It will be deserialized as per the Error definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      x-ms-examples:
        Delete A recordset:
          $ref: ./examples/DeleteARecordset.json
        Delete AAAA recordset:
          $ref: ./examples/DeleteAAAARecordset.json
        Delete CAA recordset:
          $ref: ./examples/DeleteCaaRecordset.json
        Delete CNAME recordset:
          $ref: ./examples/DeleteCNAMERecordset.json
        Delete MX recordset:
          $ref: ./examples/DeleteMXRecordset.json
        Delete NS recordset:
          $ref: ./examples/DeleteNSRecordset.json
        Delete PTR recordset:
          $ref: ./examples/DeletePTRRecordset.json
        Delete SRV recordset:
          $ref: ./examples/DeleteSRVRecordset.json
        Delete TXT recordset:
          $ref: ./examples/DeleteTXTRecordset.json
        Delete DS recordset:
          $ref: ./examples/DeleteDSRecordset.json
        Delete TLSA recordset:
          $ref: ./examples/DeleteTLSARecordset.json
        Delete NAPTR recordset:
          $ref: ./examples/DeleteNAPTRRecordset.json
      summary: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Network Dnszones Zonename Recordtype Relativerecordsetname
    get:
      tags:
      - RecordSets
      operationId: microsoftAzureRecordsetsGet
      description: Gets a record set.
      parameters:
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
      - $ref: '#/components/parameters/ZoneNameParameter'
      - $ref: '#/components/parameters/RelativeRecordSetNameParameter'
      - $ref: '#/components/parameters/RecordTypeParameter'
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordSet'
        default:
          description: Default response. It will be deserialized as per the Error definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      x-ms-examples:
        Get A recordset:
          $ref: ./examples/GetARecordset.json
        Get AAAA recordset:
          $ref: ./examples/GetAAAARecordset.json
        Get CAA recordset:
          $ref: ./examples/GetCaaRecordset.json
        Get CNAME recordset:
          $ref: ./examples/GetCNAMERecordset.json
        Get MX recordset:
          $ref: ./examples/GetMXRecordset.json
        Get NS recordset:
          $ref: ./examples/GetNSRecordset.json
        Get PTR recordset:
          $ref: ./examples/GetPTRRecordset.json
        Get SOA recordset:
          $ref: ./examples/GetSOARecordset.json
        Get SRV recordset:
          $ref: ./examples/GetSRVRecordset.json
        Get TXT recordset:
          $ref: ./examples/GetTXTRecordset.json
        Get DS recordset:
          $ref: ./examples/GetDSRecordset.json
        Get TLSA recordset:
          $ref: ./examples/GetTLSARecordset.json
        Get NAPTR recordset:
          $ref: ./examples/GetNAPTRRecordset.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Network Dnszones Zonename Recordtype Relativerecordsetname
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}
  : get:
      tags:
      - RecordSets
      operationId: microsoftAzureRecordsetsListbytype
      description: Lists the record sets of a specified type in a DNS zone.
      parameters:
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
      - $ref: '#/components/parameters/ZoneNameParameter'
      - $ref: '#/components/parameters/RecordTypeParameter'
      - name: $top
        in: query
        required: false
        description: The maximum number of record sets to return. If not specified, returns up to 100 record sets.
        schema:
          type: integer
          format: int32
      - name: $recordsetnamesuffix
        in: query
        required: false
        description: The suffix label of the record set name that has to be used to filter the record set enumerations. If this parameter is specified, Enumeration will return only records that end with .<recordSetNameSuffix>
        schema:
          type: string
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordSetListResult'
        default:
          description: Default response. It will be deserialized as per the Error definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        List A recordsets:
          $ref: ./examples/ListARecordset.json
        List AAAA recordsets:
          $ref: ./examples/ListAAAARecordset.json
        List CAA recordsets:
          $ref: ./examples/ListCaaRecordset.json
        List CNAME recordsets:
          $ref: ./examples/ListCNAMERecordset.json
        List MX recordsets:
          $ref: ./examples/ListMXRecordset.json
        List NS recordsets:
          $ref: ./examples/ListNSRecordset.json
        List PTR recordsets:
          $ref: ./examples/ListPTRRecordset.json
        List SOA recordsets:
          $ref: ./examples/ListSOARecordset.json
        List SRV recordsets:
          $ref: ./examples/ListSRVRecordset.json
        List TXT recordsets:
          $ref: ./examples/ListTXTRecordset.json
        List DS recordsets:
          $ref: ./examples/ListDSRecordset.json
        List TLSA recordsets:
          $ref: ./examples/ListTLSARecordset.json
        List NAPTR recordsets:
          $ref: ./examples/ListNAPTRRecordset.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Network Dnszones Zonename Recordtype
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/recordsets
  : get:
      tags:
      - RecordSets
      operationId: microsoftAzureRecordsetsListbydnszone
      description: Lists all record sets in a DNS zone.
      parameters:
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
      - $ref: '#/components/parameters/ZoneNameParameter'
      - name: $top
        in: query
        required: false
        description: The maximum number of record sets to return. If not specified, returns up to 100 record sets.
        schema:
          type: integer
          format: int32
      - name: $recordsetnamesuffix
        in: query
        required: false
        description: The suffix label of the record set name that has to be used to filter the record set enumerations. If this parameter is specified, Enumeration will return only records that end with .<recordSetNameSuffix>
        schema:
          type: string
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordSetListResult'
        default:
          description: Default response. It will be deserialized as per the Error definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        List recordsets by zone:
          $ref: ./examples/ListRecordSetsByZone.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Network Dnszones Zonename Recordsets
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/all:
    get:
      tags:
      - RecordSets
      operationId: microsoftAzureRecordsetsListallbydnszone
      description: Lists all record sets in a DNS zone.
      parameters:
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
      - $ref: '#/components/parameters/ZoneNameParameter'
      - name: $top
        in: query
        required: false
        description: The maximum number of record sets to return. If not specified, returns up to 100 record sets.
        schema:
          type: integer
          format: int32
      - name: $recordsetnamesuffix
        in: query
        required: false
        description: The suffix label of the record set name that has to be used to filter the record set enumerations. If this parameter is specified, Enumeration will return only records that end with .<recordSetNameSuffix>
        x-ms-client-name: recordSetNameSuffix
        schema:
          type: string
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordSetListResult'
        default:
          description: Default response. It will be deserialized as per the Error definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        List all recordsets by zone:
          $ref: ./examples/ListRecordSetsByZone.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Network Dnszones Zonename All
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/{recordType}/{relativeRecordSetName}
  : put:
      tags:
      - RecordSets
      operationId: microsoftAzureRecordsetsCreateorupdate
      description: Creates or updates a record set within a Private DNS zone.
      parameters:
      - name: resourceGroupName
        in: path
        required: true
        description: The name of the resource group.
        schema:
          type: string
      - name: privateZoneName
        in: path
        required: true
        description: The name of the Private DNS zone (without a terminating dot).
        schema:
          type: string
      - name: recordType
        in: path
        required: true
        description: The type of DNS record in this record set. Record sets of type SOA can be updated but not created (they are created when the Private DNS zone is created).
        x-ms-enum:
          name: RecordType
          modelAsString: false
        schema:
          type: string
          enum:
          - A
          - AAAA
          - CNAME
          - MX
          - PTR
          - SOA
          - SRV
          - TXT
      - name: relativeRecordSetName
        in: path
        required: true
        description: The name of the record set, relative to the name of the zone.
        x-ms-skip-url-encoding: true
        schema:
          type: string
      - name: If-Match
        in: header
        required: false
        x-ms-client-name: IfMatch
        description: The ETag of the record set. Omit this value to always overwrite the current record set. Specify the last-seen ETag value to prevent accidentally overwriting any concurrent changes.
        schema:
          type: string
      - name: If-None-Match
        in: header
        required: false
        x-ms-client-name: IfNoneMatch
        description: Set to '*' to allow a new record set to be created, but to prevent updating an existing record set. Other values will be ignored.
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      responses:
        '200':
          description: The record set has been updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordSet_2'
        '201':
          description: The record set has been created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordSet_2'
        default:
          description: Default response. It will be deserialized as per the Error definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      x-ms-examples:
        PUT Private DNS Zone A Record Set:
          $ref: ./examples/RecordSetAPut.json
        PUT Private DNS Zone AAAA Record Set:
          $ref: ./examples/RecordSetAAAAPut.json
        PUT Private DNS Zone CNAME Record Set:
          $ref: ./examples/RecordSetCNAMEPut.json
        PUT Private DNS Zone MX Record Set:
          $ref: ./examples/RecordSetMXPut.json
        PUT Private DNS Zone PTR Record Set:
          $ref: ./examples/RecordSetPTRPut.json
        PUT Private DNS Zone SOA Record Set:
          $ref: ./examples/RecordSetSOAPut.json
        PUT Private DNS Zone SRV Record Set:
          $ref: ./examples/RecordSetSRVPut.json
        PUT Private DNS Zone TXT Record Set:
          $ref: ./examples/RecordSetTXTPut.json
      summary: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Network Privatednszones Privatezonename Recordtype Relativerecordsetname
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecordSet_2'
        description: Parameters supplied to the CreateOrUpdate operation.
        required: true
    patch:
      tags:
      - RecordSets
      operationId: microsoftAzureRecordsetsUpdate
      description: Updates a record set within a Private DNS zone.
      parameters:
      - name: resourceGroupName
        in: path
        required: true
        description: The name of the resource group.
        schema:
          type: string
      - name: privateZoneName
        in: path
        required: true
        description: The name of the Private DNS zone (without a terminating dot).
        schema:
          type: string
      - name: recordType
        in: path
        required: true
        description: The type of DNS record in this record set.
        x-ms-enum:
          name: RecordType
          modelAsString: false
        schema:
          type: string
          enum:
          - A
          - AAAA
          - CNAME
          - MX
          - PTR
          - SOA
          - SRV
          - TXT
      - name: relativeRecordSetName
        in: path
        required: true
        description: The name of the record set, relative to the name of the zone.
        x-ms-skip-url-encoding: true
        schema:
          type: string
      - name: If-Match
        in: header
        required: false
        x-ms-client-name: IfMatch
        description: The ETag of the record set. Omit this value to always overwrite the current record set. Specify the last-seen ETag value to prevent accidentally overwriting concurrent changes.
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      responses:
        '200':
          description: The record set has been updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordSet_2'
        default:
          description: Default response. It will be deserialized as per the Error definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      x-ms-examples:
        PATCH Private DNS Zone A Record Set:
          $ref: ./examples/RecordSetAPatch.json
        PATCH Private DNS Zone AAAA Record Set:
          $ref: ./examples/RecordSetAAAAPatch.json
        PATCH Private DNS Zone CNAME Record Set:
          $ref: ./examples/RecordSetCNAMEPatch.json
        PATCH Private DNS Zone MX Record Set:
          $ref: ./examples/RecordSetMXPatch.json
        PATCH Private DNS Zone PTR Record Set:
          $ref: ./examples/RecordSetPTRPatch.json
        PATCH Private DNS Zone SOA Record Set:
          $ref: ./examples/RecordSetSOAPatch.json
        PATCH Private DNS Zone SRV Record Set:
          $ref: ./examples/RecordSetSRVPatch.json
        PATCH Private DNS Zone TXT Record Set:
          $ref: ./examples/RecordSetTXTPatch.json
      summary: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Network Privatednszones Privatezonename Recordtype Relativerecordsetname
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecordSet_2'
        description: Parameters supplied to the Update operation.
        required: true
    delete:
      tags:
      - RecordSets
      operationId: microsoftAzureRecordsetsDelete
      description: Deletes a record set from a Private DNS zone. This operation cannot be undone.
      parameters:
      - name: resourceGroupName
        in: path
        required: true
        description: The name of the resource group.
        schema:
          type: string
      - name: privateZoneName
        in: path
        required: true
        description: The name of the Private DNS zone (without a terminating dot).
        schema:
          type: string
      - name: recordType
        in: path
        required: true
        description: The type of DNS record in this record set. Record sets of type SOA cannot be deleted (they are deleted when the Private DNS zone is deleted).
        x-ms-enum:
          name: RecordType
          modelAsString: false
        schema:
          type: string
          enum:
          - A
          - AAAA
          - CNAME
          - MX
          - PTR
          - SOA
          - SRV
          - TXT
      - name: relativeRecordSetName
        in: path
        required: true
        description: The name of the record set, relative to the name of the zone.
        x-ms-skip-url-encoding: true
        schema:
          type: string
      - name: If-Match
        in: header
        required: false
        x-ms-client-name: IfMatch
        description: The ETag of the record set. Omit this value to always delete the current record set. Specify the last-seen ETag value to prevent accidentally deleting any concurrent changes.
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      responses:
        '200':
          description: The record set has been deleted.
        '204':
          description: The record set was not found.
        default:
          description: Default response. It will be deserialized as per the Error definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      x-ms-examples:
        DELETE Private DNS Zone A Record Set:
          $ref: ./examples/RecordSetADelete.json
        DELETE Private DNS Zone AAAA Record Set:
          $ref: ./examples/RecordSetAAAADelete.json
        DELETE Private DNS Zone CNAME Record Set:
          $ref: ./examples/RecordSetCNAMEDelete.json
        DELETE Private DNS Zone MX Record Set:
          $ref: ./examples/RecordSetMXDelete.json
        DELETE Private DNS Zone PTR Record Set:
          $ref: ./examples/RecordSetPTRDelete.json
        DELETE Private DNS Zone SRV Record Set:
          $ref: ./examples/RecordSetSRVDelete.json
        DELETE Private DNS Zone TXT Record Set:
          $ref: ./examples/RecordSetTXTDelete.json
      summary: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Network Privatednszones Privatezonename Recordtype Relativerecordsetname
    get:
      tags:
      - RecordSets
      operationId: microsoftAzureRecordsetsGet
      description: Gets a record set.
      parameters:
      - name: resourceGroupName
        in: path
        required: true
        description: The name of the resource group.
        schema:
          type: string
      - name: privateZoneName
        in: path
        required: true
        description: The name of the Private DNS zone (without a terminating dot).
        schema:
          type: string
      - name: recordType
        in: path
        required: true
        description: The type of DNS record in this record set.
        x-ms-enum:
          name: RecordType
          modelAsString: false
        schema:
          type: string
          enum:
          - A
          - AAAA
          - CNAME
          - MX
          - PTR
          - SOA
          - SRV
          - TXT
      - name: relativeRecordSetName
        in: path
        required: true
        description: The name of the record set, relative to the name of the zone.
        x-ms-skip-url-encoding: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordSet_2'
        default:
          description: Default response. It will be deserialized as per the Error definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      x-ms-examples:
        GET Private DNS Zone A Record Set:
          $ref: ./examples/RecordSetAGet.json
        GET Private DNS Zone AAAA Record Set:
          $ref: ./examples/RecordSetAAAAGet.json
        GET Private DNS Zone CNAME Record Set:
          $ref: ./examples/RecordSetCNAMEGet.json
        GET Private DNS Zone MX Record Set:
          $ref: ./examples/RecordSetMXGet.json
        GET Private DNS Zone PTR Record Set:
          $ref: ./examples/RecordSetPTRGet.json
        GET Private DNS Zone SOA Record Set:
          $ref: ./examples/RecordSetSOAGet.json
        GET Private DNS Zone SRV Record Set:
          $ref: ./examples/RecordSetSRVGet.json
        GET Private DNS Zone TXT Record Set:
          $ref: ./examples/RecordSetTXTGet.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Network Privatednszones Privatezonename Recordtype Relativerecordsetname
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/{recordType}
  : get:
      tags:
      - RecordSets
      operationId: microsoftAzureRecordsetsListbytype
      description: Lists the record sets of a specified type in a Private DNS zone.
      parameters:
      - name: resourceGroupName
        in: path
        required: true
  

# --- truncated at 32 KB (59 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/openapi/microsoft-azure-recordsets-api-openapi.yml