Resume V2021-02-01-Preview BackupShortTermRetentionPolicies API Specification (#14671)

lululilliancoding · Lillian Liu · web-flow · commit 08faf3284d23 · 2021-06-15T10:46:41.000+08:00
* Resume V2021-02-01-Preview BackupShortTermRetentionPolicies API Specification

* Prettier check fix

* comment

Co-authored-by: Lillian Liu &lt;liulu@microsoft.com&gt;
diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2021-02-01-preview/BackupShortTermRetentionPolicies.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2021-02-01-preview/BackupShortTermRetentionPolicies.json
@@ -125,7 +125,7 @@
             }
           },
           "default": {
-            "description": "*** Error Responses: ***\n\n * 400 InvalidParameterValue - An invalid value was given to a parameter.\n\n * 400 InvalidBackupRetentionPeriod - The retention days of {0} is not a valid configuration. Valid backup retention in days must be between {1} and {2}\n\n * 400 FeatureDisabledOnSelectedEdition - User attempted to use a feature which is disabled on current database edition.\n\n * 404 SubscriptionDoesNotHaveServer - The requested server was not found\n\n * 404 ServerNotInSubscriptionResourceGroup - Specified server does not exist in the specified resource group and subscription.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 SourceDatabaseNotFound - The source database does not exist.\n\n * 404 CannotFindObject - Cannot find the object because it does not exist or you do not have permissions\n\n * 409 ConflictingDatabaseOperation - There is already some operation on the database and the current operation should wait till it is done.\n\n * 409 ConflictingSystemOperationInProgress - A system maintenance operation is in progress on the database and further operations need to wait until it is completed.\n\n * 429 SubscriptionTooManyCreateUpdateRequests - Requests beyond max requests that can be processed by available resources.\n\n * 429 SubscriptionTooManyRequests - Requests beyond max requests that can be processed by available resources.\n\n * 503 TooManyRequests - Requests beyond max requests that can be processed by available resources.\n\n * 504 RequestTimeout - Service request exceeded the allowed timeout."
+            "description": "*** Error Responses: ***\n\n * 400 InvalidParameterValue - An invalid value was given to a parameter.\n\n * 400 InvalidBackupRetentionPeriod - The retention days of {0} is not a valid configuration. Valid backup retention in days must be between {1} and {2}\n\n * 400 InvalidDiffBackupIntervalHours - The differential backup interval hours of {0} is not a valid configuration. Valid differential backup interval must be {1} hours.\n\n * 400 FeatureDisabledOnSelectedEdition - User attempted to use a feature which is disabled on current database edition.\n\n * 404 SubscriptionDoesNotHaveServer - The requested server was not found\n\n * 404 ServerNotInSubscriptionResourceGroup - Specified server does not exist in the specified resource group and subscription.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 SourceDatabaseNotFound - The source database does not exist.\n\n * 404 CannotFindObject - Cannot find the object because it does not exist or you do not have permissions\n\n * 409 ConflictingDatabaseOperation - There is already some operation on the database and the current operation should wait till it is done.\n\n * 409 ConflictingSystemOperationInProgress - A system maintenance operation is in progress on the database and further operations need to wait until it is completed.\n\n * 429 SubscriptionTooManyCreateUpdateRequests - Requests beyond max requests that can be processed by available resources.\n\n * 429 SubscriptionTooManyRequests - Requests beyond max requests that can be processed by available resources.\n\n * 503 TooManyRequests - Requests beyond max requests that can be processed by available resources.\n\n * 504 RequestTimeout - Service request exceeded the allowed timeout."
           },
           "202": {
             "description": "Accepted"
@@ -192,7 +192,7 @@
             }
           },
           "default": {
-            "description": "*** Error Responses: ***\n\n * 400 InvalidParameterValue - An invalid value was given to a parameter.\n\n * 400 InvalidBackupRetentionPeriod - The retention days of {0} is not a valid configuration. Valid backup retention in days must be between {1} and {2}\n\n * 400 FeatureDisabledOnSelectedEdition - User attempted to use a feature which is disabled on current database edition.\n\n * 404 SubscriptionDoesNotHaveServer - The requested server was not found\n\n * 404 ServerNotInSubscriptionResourceGroup - Specified server does not exist in the specified resource group and subscription.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 SourceDatabaseNotFound - The source database does not exist.\n\n * 404 CannotFindObject - Cannot find the object because it does not exist or you do not have permissions\n\n * 409 ConflictingDatabaseOperation - There is already some operation on the database and the current operation should wait till it is done.\n\n * 409 ConflictingSystemOperationInProgress - A system maintenance operation is in progress on the database and further operations need to wait until it is completed.\n\n * 429 SubscriptionTooManyCreateUpdateRequests - Requests beyond max requests that can be processed by available resources.\n\n * 429 SubscriptionTooManyRequests - Requests beyond max requests that can be processed by available resources.\n\n * 503 TooManyRequests - Requests beyond max requests that can be processed by available resources.\n\n * 504 RequestTimeout - Service request exceeded the allowed timeout."
+            "description": "*** Error Responses: ***\n\n * 400 InvalidParameterValue - An invalid value was given to a parameter.\n\n * 400 InvalidBackupRetentionPeriod - The retention days of {0} is not a valid configuration. Valid backup retention in days must be between {1} and {2}\n\n * 400 InvalidDiffBackupIntervalHours - The differential backup interval hours of {0} is not a valid configuration. Valid differential backup interval must be {1} hours.\n\n * 400 FeatureDisabledOnSelectedEdition - User attempted to use a feature which is disabled on current database edition.\n\n * 404 SubscriptionDoesNotHaveServer - The requested server was not found\n\n * 404 ServerNotInSubscriptionResourceGroup - Specified server does not exist in the specified resource group and subscription.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 SourceDatabaseNotFound - The source database does not exist.\n\n * 404 CannotFindObject - Cannot find the object because it does not exist or you do not have permissions\n\n * 409 ConflictingDatabaseOperation - There is already some operation on the database and the current operation should wait till it is done.\n\n * 409 ConflictingSystemOperationInProgress - A system maintenance operation is in progress on the database and further operations need to wait until it is completed.\n\n * 429 SubscriptionTooManyCreateUpdateRequests - Requests beyond max requests that can be processed by available resources.\n\n * 429 SubscriptionTooManyRequests - Requests beyond max requests that can be processed by available resources.\n\n * 503 TooManyRequests - Requests beyond max requests that can be processed by available resources.\n\n * 504 RequestTimeout - Service request exceeded the allowed timeout."
           },
           "202": {
             "description": "Accepted"
@@ -261,6 +261,19 @@
           "format": "int32",
           "description": "The backup retention period in days. This is how many days Point-in-Time Restore will be supported.",
           "type": "integer"
+        },
+        "diffBackupIntervalInHours": {
+          "format": "int32",
+          "description": "The differential backup interval in hours. This is how many interval hours between each differential backup will be supported. This is only applicable to live databases but not dropped databases.",
+          "enum": [
+            "12",
+            "24"
+          ],
+          "type": "integer",
+          "x-ms-enum": {
+            "name": "DiffBackupIntervalInHours",
+            "modelAsString": true
+          }
         }
       }
     },
diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2021-02-01-preview/examples/GetShortTermRetentionPolicy.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2021-02-01-preview/examples/GetShortTermRetentionPolicy.json
@@ -14,7 +14,8 @@
         "name": "default",
         "type": "Microsoft.Sql/servers/databases/backupShortTermRetentionPolicies",
         "properties": {
-          "retentionDays": 14
+          "retentionDays": 7,
+          "diffBackupIntervalInHours": 24
         }
       }
     }
diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2021-02-01-preview/examples/ListShortTermRetentionPoliciesByDatabase.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2021-02-01-preview/examples/ListShortTermRetentionPoliciesByDatabase.json
@@ -16,7 +16,8 @@
             "name": "default",
             "type": "Microsoft.Sql/servers/databases/backupShortTermRetentionPolicies",
             "properties": {
-              "retentionDays": 14
+              "retentionDays": 7,
+              "diffBackupIntervalInHours": 24
             }
           }
         ]
diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2021-02-01-preview/examples/UpdateShortTermRetentionPolicy.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2021-02-01-preview/examples/UpdateShortTermRetentionPolicy.json
@@ -8,7 +8,8 @@
     "api-version": "2021-02-01-preview",
     "parameters": {
       "properties": {
-        "retentionDays": 14
+        "retentionDays": 7,
+        "diffBackupIntervalInHours": 24
       }
     }
   },
@@ -19,7 +20,8 @@
         "name": "default",
         "type": "Microsoft.Sql/servers/databases/backupShortTermRetentionPolicies",
         "properties": {
-          "retentionDays": 14
+          "retentionDays": 7,
+          "diffBackupIntervalInHours": 24
         }
       }
     },
diff --git a/specification/sql/resource-manager/readme.md b/specification/sql/resource-manager/readme.md
@@ -52,7 +52,6 @@ input-file:
 - Microsoft.Sql/stable/2014-04-01/serviceObjectives.json
 - Microsoft.Sql/stable/2014-04-01/sql.core_legacy.json
 - Microsoft.Sql/stable/2014-04-01/usages_legacy.json
-- ./Microsoft.Sql/preview/2020-11-01-preview/BackupShortTermRetentionPolicies.json
 - ./Microsoft.Sql/preview/2020-11-01-preview/BlobAuditing.json
 - ./Microsoft.Sql/preview/2020-11-01-preview/DatabaseAdvisors.json
 - ./Microsoft.Sql/preview/2020-11-01-preview/DatabaseAutomaticTuning.json
@@ -145,6 +144,7 @@ input-file:
 - ./Microsoft.Sql/preview/2020-11-01-preview/VirtualNetworkRules.json
 - ./Microsoft.Sql/preview/2020-11-01-preview/WorkloadClassifiers.json
 - ./Microsoft.Sql/preview/2020-11-01-preview/WorkloadGroups.json
+- ./Microsoft.Sql/preview/2021-02-01-preview/BackupShortTermRetentionPolicies.json
 - ./Microsoft.Sql/preview/2021-02-01-preview/Databases.json
 - ./Microsoft.Sql/preview/2021-02-01-preview/DatabaseExtensions.json
 - ./Microsoft.Sql/preview/2021-02-01-preview/DatabaseOperations.json

Original file line number	Diff line number	Diff line change
`@@ -14,7 +14,8 @@`
`14`	`14`	`"name": "default",`
`15`	`15`	`"type": "Microsoft.Sql/servers/databases/backupShortTermRetentionPolicies",`
`16`	`16`	`"properties": {`
`17`		`- "retentionDays": 14`
	`17`	`+ "retentionDays": 7,`
	`18`	`+ "diffBackupIntervalInHours": 24`
`18`	`19`	`}`
`19`	`20`	`}`
`20`	`21`	`}`
Original file line number	Diff line number	Diff line change
`@@ -16,7 +16,8 @@`
`16`	`16`	`"name": "default",`
`17`	`17`	`"type": "Microsoft.Sql/servers/databases/backupShortTermRetentionPolicies",`
`18`	`18`	`"properties": {`
`19`		`- "retentionDays": 14`
	`19`	`+ "retentionDays": 7,`
	`20`	`+ "diffBackupIntervalInHours": 24`
`20`	`21`	`}`
`21`	`22`	`}`
`22`	`23`	`]`
Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,8 @@`
`8`	`8`	`"api-version": "2021-02-01-preview",`
`9`	`9`	`"parameters": {`
`10`	`10`	`"properties": {`
`11`		`- "retentionDays": 14`
	`11`	`+ "retentionDays": 7,`
	`12`	`+ "diffBackupIntervalInHours": 24`
`12`	`13`	`}`
`13`	`14`	`}`
`14`	`15`	`},`
`@@ -19,7 +20,8 @@`
`19`	`20`	`"name": "default",`
`20`	`21`	`"type": "Microsoft.Sql/servers/databases/backupShortTermRetentionPolicies",`
`21`	`22`	`"properties": {`
`22`		`- "retentionDays": 14`
	`23`	`+ "retentionDays": 7,`
	`24`	`+ "diffBackupIntervalInHours": 24`
`23`	`25`	`}`
`24`	`26`	`}`
`25`	`27`	`},`