Restore Points - Create

服務:

SQL Database

API 版本:

2021-11-01

建立數據倉儲的還原點。

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

URI 參數

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

要求本文

名稱	必要	類型	Description
restorePointLabel	True	string	要套用的還原點標籤

回應

名稱	類型	Description
200 OK	RestorePoint	已成功建立還原點要求。
201 Created	RestorePoint	已成功建立還原點要求。
202 Accepted		已接受
Other Status Codes		錯誤回應： ≦ 400 BackupNotAllowedOnDeactivatedDatabase - 無法在停用的資料庫上建立還原點。 400 FeatureDisabledOnSelectedEdition - 用戶嘗試使用目前資料庫版本停用的功能。 400 RestorePointLimitReached - 無法建立還原點，因為資料庫會超過還原點的允許配額。 400 RestorePointAttemptToDeleteSystemBackup - 無法刪除系統還原點。 404 DatabaseRestorePointNotFound - 找不到資料庫還原點。 404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器 404 DatabaseDoesNotExist - 使用者已指定不存在於此伺服器實例上的資料庫名稱。 404 OperationIdNotFound - 標識符為 的作業不存在。 408 DatabaseRestorePointTimedOut - 建立資料庫還原點失敗。 409 OperationCancelled - 使用者已取消作業。 409 OperationInterrupted - 無法完成資源上的作業，因為它被相同資源上的另一個作業中斷。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。 429 SubscriptionTooManyRequests - 超出可用資源可處理之最大要求的要求。 500 OperationTimedOut - 作業逾時並自動回復。 請重試該作業。 503 TooManyRequests - 超出可用資源可處理之最大要求的要求。

範例

Creates datawarehouse database restore point.

範例要求

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/restorePoints?api-version=2021-11-01

{
  "restorePointLabel": "mylabel"
}

Java

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

/** Samples for RestorePoints Create. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DatabaseRestorePointsPost.json
     */
    /**
     * Sample code: Creates datawarehouse database restore point.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createsDatawarehouseDatabaseRestorePoint(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getRestorePoints().create("Default-SQL-SouthEastAsia",
            "testserver", "testDatabase", new CreateDatabaseRestorePointDefinition().withRestorePointLabel("mylabel"),
            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/servers/testserver/databases/testDatabase/restorePoints/131546477590000000",
  "name": "131546477590000000",
  "type": "Microsoft.Sql/servers/databases/restorePoints",
  "location": "japaneast",
  "properties": {
    "restorePointType": "DISCRETE",
    "restorePointCreationDate": "2017-03-10T08:00:00Z",
    "restorePointLabel": "mylabel"
  }
}

狀態碼:

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/restorePoints/131546477590000000",
  "name": "131546477590000000",
  "type": "Microsoft.Sql/servers/databases/restorePoints",
  "location": "southeastasia",
  "properties": {
    "restorePointType": "DISCRETE",
    "restorePointCreationDate": "2017-03-10T08:00:00Z",
    "restorePointLabel": "mylabel"
  }
}

狀態碼:

202

定義

名稱	Description
CreateDatabaseRestorePointDefinition	包含執行建立資料庫還原點作業所需的資訊。
RestorePoint	資料庫還原點。
RestorePointType	還原點的類型

CreateDatabaseRestorePointDefinition

包含執行建立資料庫還原點作業所需的資訊。

名稱	類型	Description
restorePointLabel	string	要套用的還原點標籤

RestorePoint

資料庫還原點。

名稱	類型	Description
id	string	資源識別碼。
location	string	資源位置。
name	string	資源名稱。
properties.earliestRestoreDate	string	此資料庫可以還原的最早時間
properties.restorePointCreationDate	string	備份的建立時間
properties.restorePointLabel	string	用戶備份要求的還原點標籤
properties.restorePointType	RestorePointType	還原點的類型
type	string	資源類型。

RestorePointType

還原點的類型

名稱	類型	Description
CONTINUOUS	string
DISCRETE	string