Backup Short Term Retention Policies - Get

Service:

SQL Database

API Version:

2021-11-01

取得資料庫的短期保留原則。

GET 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
200 OK	BackupShortTermRetentionPolicy	已成功擷取原則。
Other Status Codes		錯誤回應： ≦ 400 InvalidParameterValue - 已將無效的值提供給參數。 404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器 404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。 404 ResourceNotFound - 找不到所要求的資源。

範例

Get the short term retention policy for the database.

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.ShortTermRetentionPolicyName;

/** Samples for BackupShortTermRetentionPolicies Get. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/GetShortTermRetentionPolicy.json
     */
    /**
     * Sample code: Get the short term retention policy for the database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getTheShortTermRetentionPolicyForTheDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getBackupShortTermRetentionPolicies().getWithResponse(
            "Default-SQL-SouthEastAsia", "testsvr", "testdb", ShortTermRetentionPolicyName.DEFAULT, 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

Sample Response

Status code:

200

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

定義

名稱	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