[TSP Migration][dns] TypeSpec migrated from swagger

specification/dns/DNS.Management/DnssecConfig.tsp

@@ -0,0 +1,92 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+import "./Zone.tsp";
+
+using TypeSpec.Rest;
+using Azure.ResourceManager;
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+
+namespace Microsoft.Network;
+/**
+ * Represents the DNSSEC configuration.
+ */
+@singleton("default")
+@parentResource(Zone)
+model DnssecConfig is Azure.ResourceManager.ProxyResource<DnssecProperties> {
+  ...ResourceNameParameter<
+    Resource = DnssecConfig,
+    KeyName = "dnssecConfig",
+    SegmentName = "dnssecConfigs",
+    NamePattern = ""
+  >;
+
+  /**
+   * The etag of the DNSSEC configuration.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  etag?: string;
+}
+
+@armResourceOperations
+interface DnssecConfigs {
+  /**
+   * Gets the DNSSEC configuration.
+   */
+  get is ArmResourceRead<DnssecConfig, Error = CloudError>;
+
+  // FIXME: (ArmResourceCreateOrReplace): ArmResourceCreateOrReplaceAsync/ArmResourceCreateOrReplaceSync should have a body parameter.
+  /**
+   * Creates or updates the DNSSEC configuration on a DNS zone.
+   */
+  createOrUpdate is Azure.ResourceManager.CustomLegacy.CreateOrUpdateWithoutBodyAsync<
+    DnssecConfig,
+    Parameters = {
+      /**
+       * The etag of the DNSSEC configuration. Omit this value to always overwrite the DNSSEC configuration. Specify the last-seen etag value to prevent accidentally overwriting any concurrent changes.
+       */
+      #suppress "@azure-tools/typespec-azure-core/casing-style" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+      @header("If-Match")
+      IfMatch?: string;
+
+      /**
+       * Set to '*' to allow this DNSSEC configuration to be created, but to prevent updating existing DNSSEC configuration. Other values will be ignored.
+       */
+      #suppress "@azure-tools/typespec-azure-core/casing-style" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+      @header("If-None-Match")
+      IfNoneMatch?: string;
+    },
+    LroHeaders = ArmLroLocationHeader<FinalResult = DnssecConfig> &
+      Azure.Core.Foundations.RetryAfterHeader,
+    Error = CloudError
+  >;
+
+  /**
+   * Deletes the DNSSEC configuration on a DNS zone. This operation cannot be undone.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  delete is ArmResourceDeleteWithoutOkAsync<
+    DnssecConfig,
+    Parameters = {
+      /**
+       * The etag of this DNSSEC configuration. Omit this value to always delete the DNSSEC configuration. Specify the last-seen etag value to prevent accidentally deleting any concurrent changes.
+       */
+      #suppress "@azure-tools/typespec-azure-core/casing-style" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+      @header("If-Match")
+      IfMatch?: string;
+    },
+    Response = ArmDeletedResponse | ArmDeleteAcceptedLroResponse | ArmDeletedNoContentResponse,
+    Error = CloudError
+  >;
+
+  /**
+   * Lists the DNSSEC configurations in a DNS zone.
+   */
+  listByDnsZone is ArmResourceListByParent<DnssecConfig, Error = CloudError>;
+}
+
+@@doc(DnssecConfig.name, "");
+@@doc(DnssecConfig.properties, "The DNSSEC properties.");

specification/dns/DNS.Management/RecordSet.tsp

@@ -0,0 +1,244 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+import "./Zone.tsp";
+
+using TypeSpec.Rest;
+using Azure.ResourceManager;
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+using Azure.ResourceManager.Private;
+
+namespace Microsoft.Network;
+/**
+ * Describes a DNS record set (a collection of DNS records with the same name and type).
+ */
+#suppress "@azure-tools/typespec-azure-core/no-private-usage" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+#suppress "@azure-tools/typespec-azure-core/composition-over-inheritance" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+@Azure.ResourceManager.Private.armResourceInternal(RecordSetProperties)
+@TypeSpec.Http.Private.includeInapplicableMetadataInPayload(false)
+@parentResource(Zone)
+model RecordSet extends Foundations.ProxyResource {
+  ...ResourceNameParameter<
+    Resource = RecordSet,
+    KeyName = "relativeRecordSetName",
+    SegmentName = "{recordType}",
+    NamePattern = ""
+  >;
+
+  /**
+   * The etag of the record set.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  etag?: string;
+
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @Azure.ResourceManager.Private.armResourcePropertiesOptionality(true)
+  properties?: RecordSetProperties;
+}
+
+#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-interface-requires-decorator" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+interface RecordSets {
+  /**
+   * Gets a record set.
+   */
+  @get
+  @armResourceRead(RecordSet)
+  @route("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{+relativeRecordSetName}")
+  get(
+    ...ApiVersionParameter,
+    ...SubscriptionIdParameter,
+    ...ResourceGroupParameter,
+
+    /**
+     * The name of the DNS zone (without a terminating dot).
+     */
+    @path
+    zoneName: string,
+
+    /**
+     * The name of the record set, relative to the name of the zone.
+     */
+    @path
+    relativeRecordSetName: string,
+
+    /**
+     * The type of DNS record in this record set.
+     */
+    @path
+    recordType: RecordType,
+  ): ArmResponse<RecordSet> | CloudError;
+
+  /**
+   * 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).
+   */
+  @put
+  @armResourceCreateOrUpdate(RecordSet)
+  @route("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{+relativeRecordSetName}")
+  createOrUpdate(
+    ...ApiVersionParameter,
+    ...SubscriptionIdParameter,
+    ...ResourceGroupParameter,
+
+    /**
+     * The name of the DNS zone (without a terminating dot).
+     */
+    @path
+    zoneName: string,
+
+    /**
+     * The name of the record set, relative to the name of the zone.
+     */
+    @path
+    relativeRecordSetName: string,
+
+    /**
+     * The type of DNS record in this record set.
+     */
+    @path
+    recordType: RecordType,
+
+    /**
+     * 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.
+     */
+    #suppress "@azure-tools/typespec-azure-core/casing-style" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+    @header("If-Match")
+    IfMatch?: string,
+
+    /**
+     * Set to '*' to allow a new record set to be created, but to prevent updating an existing record set. Other values will be ignored.
+     */
+    #suppress "@azure-tools/typespec-azure-core/casing-style" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+    @header("If-None-Match")
+    IfNoneMatch?: string,
+
+    @doc("Parameters supplied to the CreateOrUpdate operation.")
+    @bodyRoot
+    resource: RecordSet,
+  ): ArmResponse<RecordSet> | ArmCreatedResponse<RecordSet> | CloudError;
+  /**
+   * Updates a record set within a DNS zone.
+   */
+  @patch(#{ implicitOptionality: false })
+  @armResourceUpdate(RecordSet)
+  @route("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{+relativeRecordSetName}")
+  update(
+    ...ApiVersionParameter,
+    ...SubscriptionIdParameter,
+    ...ResourceGroupParameter,
+
+    /**
+     * The name of the DNS zone (without a terminating dot).
+     */
+    @path
+    zoneName: string,
+
+    /**
+     * The name of the record set, relative to the name of the zone.
+     */
+    @path
+    relativeRecordSetName: string,
+
+    /**
+     * The type of DNS record in this record set.
+     */
+    @path
+    recordType: RecordType,
+
+    /**
+     * 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.
+     */
+    #suppress "@azure-tools/typespec-azure-core/casing-style" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+    @header("If-Match")
+    IfMatch?: string,
+
+    @doc("Parameters supplied to the Update operation.")
+    @bodyRoot
+    properties: RecordSet,
+  ): ArmResponse<RecordSet> | CloudError;
+  /**
+   * 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).
+   */
+  @delete
+  @armResourceDelete(RecordSet)
+  @route("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{+relativeRecordSetName}")
+  delete(
+    ...ApiVersionParameter,
+    ...SubscriptionIdParameter,
+    ...ResourceGroupParameter,
+
+    /**
+     * The name of the DNS zone (without a terminating dot).
+     */
+    @path
+    zoneName: string,
+
+    /**
+     * The name of the record set, relative to the name of the zone.
+     */
+    @path
+    relativeRecordSetName: string,
+
+    /**
+     * The type of DNS record in this record set.
+     */
+    @path
+    recordType: RecordType,
+
+    /**
+     * 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.
+     */
+    #suppress "@azure-tools/typespec-azure-core/casing-style" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+    @header("If-Match")
+    IfMatch?: string,
+  ): ArmDeletedResponse | ArmDeletedNoContentResponse | CloudError;
+  /**
+   * Lists the record sets of a specified type in a DNS zone.
+   */
+  #suppress "@azure-tools/typespec-azure-core/no-openapi" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @get
+  @armResourceList(RecordSet)
+  @route("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}")
+  listByType(
+    ...ApiVersionParameter,
+    ...SubscriptionIdParameter,
+    ...ResourceGroupParameter,
+
+    /**
+     * The name of the DNS zone (without a terminating dot).
+     */
+    @path
+    zoneName: string,
+
+    /**
+     * The type of DNS record in this record set.
+     */
+    @path
+    recordType: RecordType,
+
+    /**
+     * The maximum number of record sets to return. If not specified, returns up to 100 record sets.
+     */
+    @query("$top")
+    $top?: int32,
+
+    /**
+     * 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>
+     */
+    @query("$recordsetnamesuffix")
+    $recordsetnamesuffix?: string,
+  ): ArmResponse<ResourceListResult<RecordSet>> | CloudError;
+}
+
+@@doc(RecordSet.name,
+  "The name of the record set, relative to the name of the zone."
+);
+@@doc(RecordSet.properties, "The properties of the record set.");
+@@doc(RecordSets.createOrUpdate::parameters.resource,
+  "Parameters supplied to the CreateOrUpdate operation."
+);
+@@doc(RecordSets.update::parameters.properties,
+  "Parameters supplied to the Update operation."
+);