Migrate PostgreSql to TypeSpec

specification/postgresql/DBforPostgreSQL.Management/AdministratorMicrosoftEntra.tsp

@@ -0,0 +1,77 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+import "./Server.tsp";
+
+using TypeSpec.Rest;
+using Azure.ResourceManager;
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+
+namespace Microsoft.DBforPostgreSQL;
+/**
+ * Server administrator associated to a Microsoft Entra principal.
+ */
+@parentResource(Server)
+model AdministratorMicrosoftEntra
+  is Azure.ResourceManager.ProxyResource<
+    AdministratorMicrosoftEntraProperties,
+    false
+  > {
+  ...ResourceNameParameter<
+    Resource = AdministratorMicrosoftEntra,
+    KeyName = "objectId",
+    SegmentName = "administrators",
+    NamePattern = ""
+  >;
+}
+
+@armResourceOperations
+interface AdministratorMicrosoftEntras {
+  /**
+   * Gets information about a server administrator associated to a Microsoft Entra principal.
+   */
+  get is ArmResourceRead<AdministratorMicrosoftEntra>;
+
+  /**
+   * Creates a new server administrator associated to a Microsoft Entra principal.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-put-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @Azure.Core.useFinalStateVia("azure-async-operation")
+  @put
+  createOrUpdate is Legacy.CreateOrReplaceAsync<
+    AdministratorMicrosoftEntra,
+    Request = AdministratorMicrosoftEntraAdd,
+    Response = ArmAcceptedLroResponse<LroHeaders = ArmCombinedLroHeaders<FinalResult = AdministratorMicrosoftEntra> &
+      Azure.Core.Foundations.RetryAfterHeader>
+  >;
+
+  /**
+   * Deletes an existing server administrator associated to a Microsoft Entra principal.
+   */
+  delete is ArmResourceDeleteWithoutOkAsync<
+    AdministratorMicrosoftEntra,
+    Response = ArmDeleteAcceptedLroResponse<LroHeaders = ArmCombinedLroHeaders &
+      Azure.Core.Foundations.RetryAfterHeader> | ArmDeletedNoContentResponse
+  >;
+
+  /**
+   * List all server administrators associated to a Microsoft Entra principal.
+   */
+  listByServer is ArmResourceListByParent<
+    AdministratorMicrosoftEntra,
+    Response = ArmResponse<AdministratorMicrosoftEntraList>
+  >;
+}
+
+@@doc(AdministratorMicrosoftEntra.name,
+  "Object identifier of the Microsoft Entra principal."
+);
+@@doc(AdministratorMicrosoftEntra.properties,
+  "Properties of a server administrator associated to a Microsoft Entra principal."
+);
+@@doc(AdministratorMicrosoftEntras.createOrUpdate::parameters.resource,
+  "Required parameters for adding a server administrator associated to a Microsoft Entra principal."
+);

specification/postgresql/DBforPostgreSQL.Management/AdvancedThreatProtectionSettingsModel.tsp

@@ -0,0 +1,65 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+import "./Server.tsp";
+
+using TypeSpec.Rest;
+using Azure.ResourceManager;
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+
+namespace Microsoft.DBforPostgreSQL;
+/**
+ * Advanced threat protection settings of the server.
+ */
+@parentResource(Server)
+model AdvancedThreatProtectionSettingsModel
+  is Azure.ResourceManager.ProxyResource<AdvancedThreatProtectionSettingsProperties> {
+  ...ResourceNameParameter<
+    Resource = AdvancedThreatProtectionSettingsModel,
+    KeyName = "threatProtectionName",
+    SegmentName = "advancedThreatProtectionSettings",
+    NamePattern = "",
+    Type = ThreatProtectionName
+  >;
+}
+
+#suppress "@azure-tools/typespec-azure-resource-manager/no-resource-delete-operation" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+@armResourceOperations
+interface AdvancedThreatProtectionSettingsModels {
+  /**
+   * Gets state of advanced threat protection settings for a server.
+   */
+  get is ArmResourceRead<AdvancedThreatProtectionSettingsModel>;
+
+  /**
+   * Creates or updates a server's Advanced Threat Protection settings.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-put-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @Azure.Core.useFinalStateVia("azure-async-operation")
+  createOrUpdate is ArmResourceCreateOrReplaceAsync<
+    AdvancedThreatProtectionSettingsModel,
+    Response = ArmAcceptedLroResponse<LroHeaders = ArmCombinedLroHeaders<FinalResult = AdvancedThreatProtectionSettingsModel> &
+      Azure.Core.Foundations.RetryAfterHeader>
+  >;
+
+  /**
+   * Lists state of advanced threat protection settings for a server.
+   */
+  listByServer is ArmResourceListByParent<
+    AdvancedThreatProtectionSettingsModel,
+    Response = ArmResponse<AdvancedThreatProtectionSettingsList>
+  >;
+}
+
+@@doc(AdvancedThreatProtectionSettingsModel.name,
+  "Name of the advanced threat protection settings."
+);
+@@doc(AdvancedThreatProtectionSettingsModel.properties,
+  "Advanced threat protection properties."
+);
+@@doc(AdvancedThreatProtectionSettingsModels.createOrUpdate::parameters.resource,
+  "The Advanced Threat Protection state for the server."
+);

specification/postgresql/DBforPostgreSQL.Management/BackupAutomaticAndOnDemand.tsp

@@ -0,0 +1,69 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+import "./Server.tsp";
+
+using TypeSpec.Rest;
+using Azure.ResourceManager;
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+
+namespace Microsoft.DBforPostgreSQL;
+/**
+ * Properties of a backup.
+ */
+@parentResource(Server)
+model BackupAutomaticAndOnDemand
+  is Azure.ResourceManager.ProxyResource<BackupAutomaticAndOnDemandProperties> {
+  ...ResourceNameParameter<
+    Resource = BackupAutomaticAndOnDemand,
+    KeyName = "backupName",
+    SegmentName = "backups",
+    NamePattern = "^[-\\w\\._]+$"
+  >;
+}
+
+@armResourceOperations
+interface BackupAutomaticAndOnDemands {
+  /**
+   * Gets information of an on demand backup, given its name.
+   */
+  get is ArmResourceRead<BackupAutomaticAndOnDemand>;
+
+  // FIXME: (ArmResourceCreateOrReplace): ArmResourceCreateOrReplaceAsync/ArmResourceCreateOrReplaceSync should have a body parameter.
+  /**
+   * Creates an on demand backup of a server.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-put-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @Azure.Core.useFinalStateVia("azure-async-operation")
+  create is Legacy.CreateOrReplaceAsync<
+    BackupAutomaticAndOnDemand,
+    Request = void,
+    Response = ArmAcceptedLroResponse<LroHeaders = ArmCombinedLroHeaders<FinalResult = BackupAutomaticAndOnDemand> &
+      Azure.Core.Foundations.RetryAfterHeader>
+  >;
+
+  /**
+   * Deletes a specific backup, given its name.
+   */
+  delete is ArmResourceDeleteWithoutOkAsync<
+    BackupAutomaticAndOnDemand,
+    Response = ArmDeleteAcceptedLroResponse<LroHeaders = ArmCombinedLroHeaders &
+      Azure.Core.Foundations.RetryAfterHeader> | ArmDeletedNoContentResponse
+  >;
+
+  /**
+   * Lists all available backups of a server.
+   */
+  listByServer is ArmResourceListByParent<
+    BackupAutomaticAndOnDemand,
+    Response = ArmResponse<BackupAutomaticAndOnDemandList>
+  >;
+}
+
+@@maxLength(BackupAutomaticAndOnDemand.name, 128);
+@@minLength(BackupAutomaticAndOnDemand.name, 1);
+@@doc(BackupAutomaticAndOnDemand.name, "Name of the backup.");
+@@doc(BackupAutomaticAndOnDemand.properties, "Properties of a backup.");

specification/postgresql/DBforPostgreSQL.Management/BackupsLongTermRetentionOperation.tsp

@@ -0,0 +1,69 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+import "./Server.tsp";
+
+using TypeSpec.Rest;
+using Azure.ResourceManager;
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+
+namespace Microsoft.DBforPostgreSQL;
+/**
+ * Response for the LTR backup Operation API call
+ */
+@parentResource(Server)
+model BackupsLongTermRetentionOperation
+  is Azure.ResourceManager.ProxyResource<LtrBackupOperationResponseProperties> {
+  ...ResourceNameParameter<
+    Resource = BackupsLongTermRetentionOperation,
+    KeyName = "backupName",
+    SegmentName = "ltrBackupOperations",
+    NamePattern = "^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*"
+  >;
+}
+
+alias BackupsLongTermRetentionOperationAlias = Azure.ResourceManager.Legacy.LegacyOperations<
+  {
+    ...ApiVersionParameter;
+    ...SubscriptionIdParameter;
+    ...ResourceGroupParameter;
+    ...Azure.ResourceManager.Legacy.Provider<BackupsLongTermRetentionOperation>;
+    ...ParentKeysOf<BackupsLongTermRetentionOperation>;
+  },
+  {
+    /**
+     * The name of the backup.
+     */
+    @path
+    @segment("ltrBackupOperations")
+    @minLength(1)
+    @maxLength(128)
+    @pattern("^[-\\w\\._]+$")
+    backupName: string;
+  },
+  ErrorType = ErrorResponse
+>;
+
+@armResourceOperations
+interface BackupsLongTermRetentionOperations {
+  /**
+   * Gets the results of a long retention backup operation for a server.
+   */
+  get is BackupsLongTermRetentionOperationAlias.Read<BackupsLongTermRetentionOperation>;
+
+  /**
+   * Lists the results of the long term retention backup operations for a server.
+   */
+  listByServer is ArmResourceListByParent<
+    BackupsLongTermRetentionOperation,
+    Response = ArmResponse<LtrServerBackupOperationList>
+  >;
+}
+
+@@doc(BackupsLongTermRetentionOperation.name, "The name of the backup.");
+@@doc(BackupsLongTermRetentionOperation.properties,
+  "Long Term Retention Backup Operation Resource Properties"
+);

specification/postgresql/DBforPostgreSQL.Management/Configuration.tsp

@@ -0,0 +1,84 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/openapi";
+import "@typespec/rest";
+import "./models.tsp";
+import "./Server.tsp";
+
+using TypeSpec.Rest;
+using Azure.ResourceManager;
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+using Azure.Core;
+
+namespace Microsoft.DBforPostgreSQL;
+/**
+ * Configuration (also known as server parameter).
+ */
+@parentResource(Server)
+model Configuration
+  is Azure.ResourceManager.ProxyResource<ConfigurationProperties> {
+  ...ResourceNameParameter<
+    Resource = Configuration,
+    KeyName = "configurationName",
+    SegmentName = "configurations",
+    NamePattern = "^[-\\w\\._]+$"
+  >;
+}
+
+#suppress "@azure-tools/typespec-azure-resource-manager/no-resource-delete-operation" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+@armResourceOperations
+interface Configurations {
+  /**
+   * Gets information about a specific configuration (also known as server parameter) of a server.
+   */
+  get is ArmResourceRead<Configuration>;
+
+  /**
+   * Updates, using Put verb, the value assigned to a specific modifiable configuration (also known as server parameter) of a server.
+   */
+  #suppress "@azure-tools/typespec-azure-resource-manager/arm-put-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @useFinalStateVia("azure-async-operation")
+  @put
+  put is Azure.ResourceManager.Legacy.CreateOrReplaceAsync<
+    Configuration,
+    ConfigurationForUpdate,
+    Response = ArmAcceptedLroResponse<LroHeaders = ArmCombinedLroHeaders<FinalResult = Configuration> &
+      Azure.Core.Foundations.RetryAfterHeader>
+  >;
+
+  /**
+   * Updates the value assigned to a specific modifiable configuration (also known as server parameter) of a server.
+   */
+  @patch(#{ implicitOptionality: false })
+  @useFinalStateVia("azure-async-operation")
+  update is ArmCustomPatchAsync<
+    Configuration,
+    PatchModel = ConfigurationForUpdate,
+    Response = ArmAcceptedLroResponse<LroHeaders = ArmCombinedLroHeaders<FinalResult = Configuration> &
+      Azure.Core.Foundations.RetryAfterHeader>
+  >;
+
+  /**
+   * Lists all configurations (also known as server parameters) of a server.
+   */
+  listByServer is ArmResourceListByParent<
+    Configuration,
+    Response = ArmResponse<ConfigurationList>
+  >;
+}
+
+@@maxLength(Configuration.name, 256);
+@@minLength(Configuration.name, 1);
+@@doc(Configuration.name,
+  "Name of the configuration (also known as server parameter)."
+);
+@@doc(Configuration.properties,
+  "Properties of a configuration (also known as server parameter)."
+);
+@@doc(Configurations.put::parameters.resource,
+  "Parameters required to update the value of a specific modifiable configuration (also known as server parameter)."
+);
+@@doc(Configurations.update::parameters.properties,
+  "Parameters required to update the value of a specific modifiable configuration (also known as server parameter)."
+);