[TSP Migration][domainregistration] TypeSpec migrated from swagger

specification/domainregistration/DomainRegistration.Management/Domain.tsp

@@ -0,0 +1,141 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+
+using TypeSpec.Rest;
+using Azure.ResourceManager;
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+
+namespace Microsoft.DomainRegistration;
+/**
+ * Information about a domain.
+ */
+model Domain is Azure.ResourceManager.TrackedResource<DomainProperties> {
+  ...ResourceNameParameter<
+    Resource = Domain,
+    KeyName = "domainName",
+    SegmentName = "domains",
+    NamePattern = "[a-zA-Z0-9][a-zA-Z0-9\\.-]+"
+  >;
+
+  /**
+   * Kind of resource
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  kind?: string;
+}
+
+@armResourceOperations
+interface Domains {
+  /**
+   * Description for Get a domain.
+   */
+  @summary("Get a domain.")
+  get is ArmResourceRead<Domain, Error = DefaultErrorResponse>;
+
+  /**
+   * Description for Creates or updates a domain.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-put-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/no-response-body" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @summary("Creates or updates a domain.")
+  createOrUpdate is ArmResourceCreateOrReplaceAsync<
+    Domain,
+    Response = ArmResourceUpdatedResponse<Domain> | (ArmAcceptedLroResponse<LroHeaders = ArmLroLocationHeader<FinalResult = Domain>> & {
+      @bodyRoot
+      _: Domain;
+    }),
+    Error = DefaultErrorResponse
+  >;
+
+  /**
+   * Description for Creates or updates a domain.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/no-response-body" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/lro-location-header" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @patch(#{ implicitOptionality: false })
+  @summary("Creates or updates a domain.")
+  update is ArmCustomPatchSync<
+    Domain,
+    PatchModel = DomainPatchResource,
+    Response = ArmResponse<Domain> | (ArmAcceptedResponse & {
+      @bodyRoot
+      _: Domain;
+    }),
+    Error = DefaultErrorResponse
+  >;
+
+  /**
+   * Description for Delete a domain.
+   */
+  @summary("Delete a domain.")
+  delete is ArmResourceDeleteSync<
+    Domain,
+    Parameters = {
+      /**
+       * Specify <code>true</code> to delete the domain immediately. The default is <code>false</code> which deletes the domain after 24 hours.
+       */
+      @query("forceHardDeleteDomain")
+      forceHardDeleteDomain?: boolean;
+    },
+    Error = DefaultErrorResponse
+  >;
+
+  /**
+   * Description for Get all domains in a resource group.
+   */
+  @summary("Get all domains in a resource group.")
+  listByResourceGroup is ArmResourceListByParent<
+    Domain,
+    Response = ArmResponse<DomainCollection>,
+    Error = DefaultErrorResponse
+  >;
+
+  /**
+   * Description for Get all domains in a subscription.
+   */
+  @summary("Get all domains in a subscription.")
+  list is ArmListBySubscription<
+    Domain,
+    Response = ArmResponse<DomainCollection>,
+    Error = DefaultErrorResponse
+  >;
+
+  /**
+   * Description for Renew a domain.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-post-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  #suppress "@azure-tools/typespec-azure-resource-manager/lro-location-header" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @summary("Renew a domain.")
+  renew is ArmResourceActionSync<
+    Domain,
+    void,
+    OkResponse | ArmAcceptedResponse | NoContentResponse,
+    Error = DefaultErrorResponse
+  >;
+
+  /**
+   * Transfer out domain to another registrar
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-put-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @put
+  @summary("Transfer out domain to another registrar")
+  transferOut is ArmResourceActionSync<
+    Domain,
+    void,
+    ArmResponse<Domain> | ArmBadRequestResponse,
+    Error = DefaultErrorResponse
+  >;
+}
+
+@@doc(Domain.name, "Name of the domain.");
+@@doc(Domain.properties, "Domain resource specific properties");
+@@doc(Domains.createOrUpdate::parameters.resource,
+  "Domain registration information."
+);
+@@doc(Domains.update::parameters.properties,
+  "Domain registration information."
+);

specification/domainregistration/DomainRegistration.Management/DomainOwnershipIdentifier.tsp

@@ -0,0 +1,96 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+import "./Domain.tsp";
+
+using TypeSpec.Rest;
+using Azure.ResourceManager;
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+
+namespace Microsoft.DomainRegistration;
+/**
+ * Domain ownership Identifier.
+ */
+@parentResource(Domain)
+model DomainOwnershipIdentifier
+  is Azure.ResourceManager.ProxyResource<DomainOwnershipIdentifierProperties> {
+  ...ResourceNameParameter<
+    Resource = DomainOwnershipIdentifier,
+    KeyName = "name",
+    SegmentName = "domainOwnershipIdentifiers",
+    NamePattern = ""
+  >;
+
+  /**
+   * Kind of resource
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  kind?: string;
+}
+
+@armResourceOperations
+interface DomainOwnershipIdentifiers {
+  /**
+   * Description for Get ownership identifier for domain
+   */
+  @summary("Get ownership identifier for domain")
+  getOwnershipIdentifier is ArmResourceRead<
+    DomainOwnershipIdentifier,
+    Error = DefaultErrorResponse
+  >;
+
+  /**
+   * Description for Creates an ownership identifier for a domain or updates identifier details for an existing identifier
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-put-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @summary("Creates an ownership identifier for a domain or updates identifier details for an existing identifier")
+  createOrUpdateOwnershipIdentifier is ArmResourceCreateOrReplaceSync<
+    DomainOwnershipIdentifier,
+    Response = ArmResourceUpdatedResponse<DomainOwnershipIdentifier>,
+    Error = DefaultErrorResponse
+  >;
+
+  /**
+   * Description for Creates an ownership identifier for a domain or updates identifier details for an existing identifier
+   */
+  @patch(#{ implicitOptionality: false })
+  @summary("Creates an ownership identifier for a domain or updates identifier details for an existing identifier")
+  updateOwnershipIdentifier is ArmCustomPatchSync<
+    DomainOwnershipIdentifier,
+    PatchModel = DomainOwnershipIdentifier,
+    Error = DefaultErrorResponse
+  >;
+
+  /**
+   * Description for Delete ownership identifier for domain
+   */
+  @summary("Delete ownership identifier for domain")
+  deleteOwnershipIdentifier is ArmResourceDeleteSync<
+    DomainOwnershipIdentifier,
+    Error = DefaultErrorResponse
+  >;
+
+  /**
+   * Description for Lists domain ownership identifiers.
+   */
+  @summary("Lists domain ownership identifiers.")
+  listOwnershipIdentifiers is ArmResourceListByParent<
+    DomainOwnershipIdentifier,
+    Response = ArmResponse<DomainOwnershipIdentifierCollection>,
+    Error = DefaultErrorResponse
+  >;
+}
+
+@@doc(DomainOwnershipIdentifier.name, "Name of identifier.");
+@@doc(DomainOwnershipIdentifier.properties,
+  "DomainOwnershipIdentifier resource specific properties"
+);
+@@doc(DomainOwnershipIdentifiers.createOrUpdateOwnershipIdentifier::parameters.resource,
+  "A JSON representation of the domain ownership properties."
+);
+@@doc(DomainOwnershipIdentifiers.updateOwnershipIdentifier::parameters.properties,
+  "A JSON representation of the domain ownership properties."
+);

specification/domainregistration/DomainRegistration.Management/TopLevelDomain.tsp

@@ -0,0 +1,74 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+
+using TypeSpec.Rest;
+using Azure.ResourceManager;
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+
+namespace Microsoft.DomainRegistration;
+/**
+ * A top level domain object.
+ */
+@subscriptionResource
+model TopLevelDomain
+  is Azure.ResourceManager.ProxyResource<TopLevelDomainProperties> {
+  ...ResourceNameParameter<
+    Resource = TopLevelDomain,
+    KeyName = "name",
+    SegmentName = "topLevelDomains",
+    NamePattern = ""
+  >;
+
+  /**
+   * Kind of resource
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  kind?: string;
+}
+
+@armResourceOperations
+interface TopLevelDomains {
+  /**
+   * Description for Get details of a top-level domain.
+   */
+  @summary("Get details of a top-level domain.")
+  get is ArmResourceRead<
+    TopLevelDomain,
+    BaseParameters = Azure.ResourceManager.Foundations.SubscriptionBaseParameters,
+    Error = DefaultErrorResponse
+  >;
+
+  /**
+   * Description for Get all top-level domains supported for registration.
+   */
+  @summary("Get all top-level domains supported for registration.")
+  list is ArmResourceListByParent<
+    TopLevelDomain,
+    BaseParameters = Azure.ResourceManager.Foundations.SubscriptionBaseParameters,
+    Response = ArmResponse<TopLevelDomainCollection>,
+    Error = DefaultErrorResponse
+  >;
+
+  /**
+   * Description for Gets all legal agreements that user needs to accept before purchasing a domain.
+   */
+  @list
+  @summary("Gets all legal agreements that user needs to accept before purchasing a domain.")
+  listAgreements is ArmResourceActionSync<
+    TopLevelDomain,
+    TopLevelDomainAgreementOption,
+    ArmResponse<TldLegalAgreementCollection>,
+    BaseParameters = Azure.ResourceManager.Foundations.SubscriptionBaseParameters,
+    Error = DefaultErrorResponse
+  >;
+}
+
+@@doc(TopLevelDomain.name, "Name of the top-level domain.");
+@@doc(TopLevelDomain.properties, "TopLevelDomain resource specific properties");
+@@doc(TopLevelDomains.listAgreements::parameters.body,
+  "Domain agreement options."
+);

specification/domainregistration/DomainRegistration.Management/back-compatible.tsp

@@ -0,0 +1,49 @@
+import "@azure-tools/typespec-client-generator-core";
+
+using Azure.ClientGenerator.Core;
+using Azure.ClientGenerator.Core.Legacy;
+using Microsoft.DomainRegistration;
+
+@@clientName(Domains.createOrUpdate::parameters.resource, "domain");
+@@clientName(Domains.update::parameters.properties, "domain");
+@@clientLocation(DomainOwnershipIdentifiers.getOwnershipIdentifier, Domains);
+@@clientLocation(DomainOwnershipIdentifiers.createOrUpdateOwnershipIdentifier,
+  Domains
+);
+@@clientName(DomainOwnershipIdentifiers.createOrUpdateOwnershipIdentifier::parameters.resource,
+  "domainOwnershipIdentifier"
+);
+@@clientLocation(DomainOwnershipIdentifiers.updateOwnershipIdentifier, Domains);
+@@clientName(DomainOwnershipIdentifiers.updateOwnershipIdentifier::parameters.properties,
+  "domainOwnershipIdentifier"
+);
+@@clientLocation(DomainOwnershipIdentifiers.deleteOwnershipIdentifier, Domains);
+@@clientLocation(DomainOwnershipIdentifiers.listOwnershipIdentifiers, Domains);
+
+@@clientName(TopLevelDomains.listAgreements::parameters.body,
+  "agreementOption"
+);
+@@clientLocation(DomainsOperationGroup.checkAvailability, Domains);
+@@clientLocation(DomainsOperationGroup.getControlCenterSsoRequest, Domains);
+@@clientLocation(DomainsOperationGroup.listRecommendations, Domains);
+
+@@clientName(DomainsOperationGroup.listRecommendations::parameters.body,
+  "parameters"
+);
+@@clientName(DomainsOperationGroup.checkAvailability::parameters.body,
+  "identifier"
+);
+#suppress "@azure-tools/typespec-azure-core/no-legacy-usage" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+@@flattenProperty(DomainOwnershipIdentifier.properties);
+
+#suppress "@azure-tools/typespec-azure-core/no-legacy-usage" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+@@flattenProperty(DomainPatchResource.properties);
+
+#suppress "@azure-tools/typespec-azure-core/no-legacy-usage" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+@@flattenProperty(TopLevelDomain.properties);
+
+#suppress "@azure-tools/typespec-azure-core/no-legacy-usage" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+@@flattenProperty(Domain.properties);
+
+@@clientLocation(Operations.list, "DomainRegistrationProvider");
+@@clientName(Operations.list, "ListOperations");

specification/domainregistration/DomainRegistration.Management/client.tsp

@@ -0,0 +1,9 @@
+import "@azure-tools/typespec-client-generator-core";
+import "./main.tsp";
+
+using Azure.ClientGenerator.Core;
+
+@@clientName(Microsoft.DomainRegistration,
+  "DomainRegistrationManagementClient",
+  "javascript"
+);

specification/domainregistration/DomainRegistration.Management/examples/2024-11-01/CheckDomainAvailability.json

@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "api-version": "2024-11-01",
+    "identifier": {
+      "name": "abcd.com"
+    },
+    "subscriptionId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "abcd.com",
+        "available": true,
+        "domainType": "Regular"
+      }
+    }
+  },
+  "operationId": "Domains_CheckAvailability",
+  "title": "Check domain availability"
+}