Backup Short Term Retention Policies - Create Or Update

參考

服務:: SQL Database

API 版本:: 2021-11-01

匯報資料庫的短期保留原則。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/backupShortTermRetentionPolicies/default?api-version=2021-11-01

URI 參數

名稱	位於	必要	類型	Description
databaseName	path	True	string	資料庫的名稱。
policyName	path	True	ShortTermRetentionPolicyName	原則名稱。應一律為「default」。
resourceGroupName	path	True	string	包含資源的資源群組名稱。您可以從 Azure 資源管理員 API 或入口網站取得這個值。
serverName	path	True	string	伺服器的名稱。
subscriptionId	path	True	string	可識別 Azure 訂用帳戶的訂用帳戶識別碼。
api-version	query	True	string	要用於要求的 API 版本。

要求本文

名稱	類型	Description
properties.diffBackupIntervalInHours	DiffBackupIntervalInHours	差異備份間隔以小時為單位。這是支援每個差異備份之間的間隔時數。這隻適用於即時資料庫，但不適用於卸除的資料庫。
properties.retentionDays	integer	備份保留期限 (以天為單位)。這是支援多少天的時間點還原。

回應

名稱	類型	Description
200 OK	BackupShortTermRetentionPolicy	已成功更新原則。
202 Accepted		已接受
Other Status Codes		錯誤回應： ≦ 400 InvalidParameterValue - 提供給參數的值無效。 400 InvalidBackupRetentionPeriod - 的 {0} 保留天數不是有效的設定。有效的備份保留天數必須介於和之間{1}{2} 400 InvalidDiffBackupIntervalHours - 的差異 {0} 備份間隔時數不是有效的設定。有效的差異備份間隔必須是 {1} 小時。 400 FeatureDisabledOnSelectedEdition - 用戶嘗試使用目前資料庫版本停用的功能。 404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器 404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。 404 ResourceNotFound - 找不到所要求的資源。 404 SourceDatabaseNotFound - 源資料庫不存在。 404 CannotFindObject - 找不到對象，因為它不存在或您沒有許可權 409 ConflictingDatabaseOperation - 資料庫上已經有一些作業，目前的作業應該等到完成為止。 409 ConflictingSystemOperationInProgress - 資料庫上的系統維護作業正在進行中，而進一步的作業必須等到完成為止。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。 429 SubscriptionTooManyRequests - 超出可用資源可處理的最大要求。 503 TooManyRequests - 超出可用資源可處理之最大要求的要求。 504 RequestTimeout - 服務要求超過允許的逾時。

名稱

類型

Description

200 OK

BackupShortTermRetentionPolicy

已成功更新原則。

202 Accepted

已接受

Other Status Codes

錯誤回應： ≦

400 InvalidParameterValue - 提供給參數的值無效。
400 InvalidBackupRetentionPeriod - 的 {0} 保留天數不是有效的設定。有效的備份保留天數必須介於和之間{1}{2}
400 InvalidDiffBackupIntervalHours - 的差異 {0} 備份間隔時數不是有效的設定。有效的差異備份間隔必須是 {1} 小時。
400 FeatureDisabledOnSelectedEdition - 用戶嘗試使用目前資料庫版本停用的功能。
404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器
404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。
404 ResourceNotFound - 找不到所要求的資源。
404 SourceDatabaseNotFound - 源資料庫不存在。
404 CannotFindObject - 找不到對象，因為它不存在或您沒有許可權
409 ConflictingDatabaseOperation - 資料庫上已經有一些作業，目前的作業應該等到完成為止。
409 ConflictingSystemOperationInProgress - 資料庫上的系統維護作業正在進行中，而進一步的作業必須等到完成為止。
429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。
429 SubscriptionTooManyRequests - 超出可用資源可處理的最大要求。
503 TooManyRequests - 超出可用資源可處理之最大要求的要求。
504 RequestTimeout - 服務要求超過允許的逾時。

範例

Update the short term retention policy for the database.

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default?api-version=2021-11-01

{
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}


import com.azure.resourcemanager.sql.fluent.models.BackupShortTermRetentionPolicyInner;
import com.azure.resourcemanager.sql.models.DiffBackupIntervalInHours;
import com.azure.resourcemanager.sql.models.ShortTermRetentionPolicyName;

/**
 * Samples for BackupShortTermRetentionPolicies Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/UpdateShortTermRetentionPolicy.json
     */
    /**
     * Sample code: Update the short term retention policy for the database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        updateTheShortTermRetentionPolicyForTheDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getBackupShortTermRetentionPolicies().update("resourceGroup",
            "testsvr", "testdb", ShortTermRetentionPolicyName.DEFAULT, new BackupShortTermRetentionPolicyInner()
                .withRetentionDays(7).withDiffBackupIntervalInHours(DiffBackupIntervalInHours.TWO_FOUR),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

範例回覆

狀態碼:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/backupShortTermRetentionPolicies",
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}

狀態碼:: 202

定義

名稱	Description
BackupShortTermRetentionPolicy	短期保留原則。
DiffBackupIntervalInHours	差異備份間隔以小時為單位。這是支援每個差異備份之間的間隔時數。這隻適用於即時資料庫，但不適用於卸除的資料庫。
ShortTermRetentionPolicyName	原則名稱。應一律為「default」。

BackupShortTermRetentionPolicy

短期保留原則。

名稱	類型	Description
id	string	資源識別碼。
name	string	資源名稱。
properties.diffBackupIntervalInHours	DiffBackupIntervalInHours	差異備份間隔以小時為單位。這是支援每個差異備份之間的間隔時數。這隻適用於即時資料庫，但不適用於卸除的資料庫。
properties.retentionDays	integer	備份保留期限 (以天為單位)。這是支援多少天的時間點還原。
type	string	資源類型。

DiffBackupIntervalInHours

差異備份間隔以小時為單位。這是支援每個差異備份之間的間隔時數。這隻適用於即時資料庫，但不適用於卸除的資料庫。

名稱	類型	Description
12	string
24	string

ShortTermRetentionPolicyName

原則名稱。應一律為「default」。

名稱	類型	Description
default	string

共用方式為

Backup Short Term Retention Policies - Create Or Update

URI 參數

要求本文

回應

範例

Update the short term retention policy for the database.

範例要求

範例回覆

定義

BackupShortTermRetentionPolicy

DiffBackupIntervalInHours

ShortTermRetentionPolicyName

其他資源