Databases - Resume

參考

服務:: SQL Database

API 版本:: 2021-11-01

繼續資料庫。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/resume?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
200 OK	Database	已成功繼續資料庫。
202 Accepted		繼續資料庫正在進行中。
Other Status Codes		錯誤回應： ≦ 400 FeatureDisabledOnSelectedEdition - 用戶嘗試使用目前資料庫版本停用的功能。 404 ServerNotInSubscription - 指定的伺服器不存在於指定的訂用帳戶上。 404 SourceDatabaseNotFound - 源資料庫不存在。 500 ActivateOrDeactivateWorkflowThrottling - 啟用或停用工作流程失敗，因為並行工作流程太多

名稱

類型

Description

200 OK

Database

已成功繼續資料庫。

202 Accepted

繼續資料庫正在進行中。

Other Status Codes

錯誤回應： ≦

400 FeatureDisabledOnSelectedEdition - 用戶嘗試使用目前資料庫版本停用的功能。
404 ServerNotInSubscription - 指定的伺服器不存在於指定的訂用帳戶上。
404 SourceDatabaseNotFound - 源資料庫不存在。
500 ActivateOrDeactivateWorkflowThrottling - 啟用或停用工作流程失敗，因為並行工作流程太多

範例

Resumes a database.

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


/**
 * Samples for Databases Resume.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ResumeDatabase.json
     */
    /**
     * Sample code: Resumes a database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void resumesADatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases().resume("Default-SQL-SouthEastAsia", "testsvr",
            "testdwdb", 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

{
  "sku": {
    "name": "DataWarehouse"
  },
  "kind": "v12.0,user,datawarehouse",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 10995116277760,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-07-13T02:04:26.187Z",
    "currentServiceObjectiveName": "D1",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdwdb",
  "name": "testdwdb",
  "type": "Microsoft.Sql/servers/databases"
}

狀態碼:: 202

定義

名稱	Description
BackupStorageRedundancy	用來儲存此資料庫的備份的記憶體帳戶類型。
CatalogCollationType	元資料目錄的定序。
CreateMode	指定資料庫建立模式。默認值：一般資料庫建立。複製：建立資料庫做為現有資料庫的複本。 sourceDatabaseId 必須指定為源資料庫的資源標識碼。次要：建立資料庫做為現有資料庫的次要複本。 sourceDatabaseId 必須指定為現有主資料庫的資源標識碼。 PointInTimeRestore：藉由還原現有資料庫的時間點備份來建立資料庫。 sourceDatabaseId 必須指定為現有資料庫的資源標識符，而且必須指定 restorePointInTime。復原：藉由還原異地復寫備份來建立資料庫。 sourceDatabaseId 必須指定為可復原的資料庫資源標識碼，才能還原。還原：藉由還原已刪除資料庫的備份來建立資料庫。必須指定sourceDatabaseId。如果 sourceDatabaseId 是資料庫的原始資源識別碼，則必須指定 sourceDatabaseDeletionDate。否則，sourceDatabaseId 必須是可還原的已卸除資料庫資源標識符，而且會忽略 sourceDatabaseDeletionDate。 restorePointInTime 也可以指定為從先前的時間點還原。 RestoreLongTermRetentionBackup：從長期保留保存庫還原來建立資料庫。 recoveryServicesRecoveryPointResourceId 必須指定為恢復點資源標識符。 DataWarehouse 版本不支援 Copy、Secondary 和 RestoreLongTermRetentionBackup。
Database	資料庫資源。
DatabaseIdentity	資源的 Azure Active Directory 身分識別組態。
DatabaseIdentityType	身分識別類型
DatabaseLicenseType	要套用至此資料庫的授權類型。 `LicenseIncluded`如果您需要授權，或`BasePrice`如果您有授權且符合 Azure Hybrid Benefit 資格。
DatabaseReadScale	唯讀路由的狀態。如果啟用，應用程式意圖在其連接字串中設定為唯讀的連線，可能會路由傳送至相同區域中的唯讀次要複本。不適用於彈性集區內的超大規模資料庫。
DatabaseStatus	資料庫的狀態。
DatabaseUserIdentity	資源的 Azure Active Directory 身分識別組態。
SampleName	建立此資料庫時要套用的範例架構名稱。
SecondaryType	如果資料庫是輔助資料庫，則為次要類型。有效值為 Geo 和 Named。
Sku	ARM 資源 SKU。

BackupStorageRedundancy

Enumeration

用來儲存此資料庫的備份的記憶體帳戶類型。

值	Description
Geo
GeoZone
Local
Zone

CatalogCollationType

Enumeration

元資料目錄的定序。

值	Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

CreateMode

Enumeration

指定資料庫建立模式。

默認值：一般資料庫建立。

複製：建立資料庫做為現有資料庫的複本。 sourceDatabaseId 必須指定為源資料庫的資源標識碼。

次要：建立資料庫做為現有資料庫的次要複本。 sourceDatabaseId 必須指定為現有主資料庫的資源標識碼。

PointInTimeRestore：藉由還原現有資料庫的時間點備份來建立資料庫。 sourceDatabaseId 必須指定為現有資料庫的資源標識符，而且必須指定 restorePointInTime。

復原：藉由還原異地復寫備份來建立資料庫。 sourceDatabaseId 必須指定為可復原的資料庫資源標識碼，才能還原。

還原：藉由還原已刪除資料庫的備份來建立資料庫。必須指定sourceDatabaseId。如果 sourceDatabaseId 是資料庫的原始資源識別碼，則必須指定 sourceDatabaseDeletionDate。否則，sourceDatabaseId 必須是可還原的已卸除資料庫資源標識符，而且會忽略 sourceDatabaseDeletionDate。 restorePointInTime 也可以指定為從先前的時間點還原。

RestoreLongTermRetentionBackup：從長期保留保存庫還原來建立資料庫。 recoveryServicesRecoveryPointResourceId 必須指定為恢復點資源標識符。

DataWarehouse 版本不支援 Copy、Secondary 和 RestoreLongTermRetentionBackup。

值	Description
Copy
Default
OnlineSecondary
PointInTimeRestore
Recovery
Restore
RestoreExternalBackup
RestoreExternalBackupSecondary
RestoreLongTermRetentionBackup
Secondary

Database

Object

資料庫資源。

名稱	類型	Description
id	string	資源識別碼。
identity	DatabaseIdentity	資料庫的 Azure Active Directory 身分識別。
kind	string	資料庫種類。這是用於 Azure 入口網站體驗的元數據。
location	string	資源位置。
managedBy	string	管理資料庫的資源。
name	string	資源名稱。
properties.autoPauseDelay	integer	在幾分鐘后自動暫停資料庫的時間。值為 -1 表示已停用自動暫停
properties.catalogCollation	CatalogCollationType	元資料目錄的定序。
properties.collation	string	資料庫的定序。
properties.createMode	CreateMode	指定資料庫建立模式。默認值：一般資料庫建立。複製：建立資料庫做為現有資料庫的複本。 sourceDatabaseId 必須指定為源資料庫的資源標識碼。次要：建立資料庫做為現有資料庫的次要複本。 sourceDatabaseId 必須指定為現有主資料庫的資源標識碼。 PointInTimeRestore：藉由還原現有資料庫的時間點備份來建立資料庫。 sourceDatabaseId 必須指定為現有資料庫的資源標識符，而且必須指定 restorePointInTime。復原：藉由還原異地復寫備份來建立資料庫。 sourceDatabaseId 必須指定為可復原的資料庫資源標識碼，才能還原。還原：藉由還原已刪除資料庫的備份來建立資料庫。必須指定sourceDatabaseId。如果 sourceDatabaseId 是資料庫的原始資源識別碼，則必須指定 sourceDatabaseDeletionDate。否則，sourceDatabaseId 必須是可還原的已卸除資料庫資源標識符，而且會忽略 sourceDatabaseDeletionDate。 restorePointInTime 也可以指定為從先前的時間點還原。 RestoreLongTermRetentionBackup：從長期保留保存庫還原來建立資料庫。 recoveryServicesRecoveryPointResourceId 必須指定為恢復點資源標識符。 DataWarehouse 版本不支援 Copy、Secondary 和 RestoreLongTermRetentionBackup。
properties.creationDate	string	資料庫 (ISO8601 格式的建立日期) 。
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	用來儲存此資料庫的備份的記憶體帳戶類型。
properties.currentServiceObjectiveName	string	資料庫目前的服務等級目標名稱。
properties.currentSku	Sku	SKU 的名稱和層級。
properties.databaseId	string	資料庫的識別碼。
properties.defaultSecondaryLocation	string	這個資料庫的預設次要區域。
properties.earliestRestoreDate	string	這會記錄此資料庫的最早開始日期和時間， (ISO8601 格式) 。
properties.elasticPoolId	string	包含此資料庫之彈性集區的資源標識碼。
properties.failoverGroupId	string	此資料庫所屬的故障轉移群組資源標識碼。
properties.federatedClientId	string	每個資料庫 CMK 案例用於跨租使用者的用戶端識別碼
properties.highAvailabilityReplicaCount	integer	與用來提供高可用性之資料庫相關聯的次要複本數目。不適用於彈性集區內的超大規模資料庫。
properties.isInfraEncryptionEnabled	boolean	此資料庫已啟用基礎結構加密。
properties.isLedgerOn	boolean	不論此資料庫是否為總賬資料庫，這表示資料庫中的所有數據表都是總賬數據表。注意：建立資料庫之後，就無法變更此屬性的值。
properties.licenseType	DatabaseLicenseType	要套用至此資料庫的授權類型。 `LicenseIncluded`如果您需要授權，或`BasePrice`如果您有授權且符合 Azure Hybrid Benefit 資格。
properties.longTermRetentionBackupResourceId	string	與此資料庫建立作業相關聯的長期保留備份資源標識符。
properties.maintenanceConfigurationId	string	指派給資料庫的維護組態標識碼。此組態會定義發生維護更新的期間。
properties.maxLogSizeBytes	integer	這個資料庫的記錄大小上限。
properties.maxSizeBytes	integer	以位元組表示的資料庫大小上限。
properties.minCapacity	number	資料庫一律已配置的最小容量，如果未暫停，則為
properties.pausedDate	string	用戶設定或動作暫停資料庫 (ISO8601 格式) 的日期。如果資料庫已就緒，則為 Null。
properties.readScale	DatabaseReadScale	唯讀路由的狀態。如果啟用，將應用程式意圖設定為唯讀的連線連接字串可能會路由傳送至相同區域中的唯讀次要複本。不適用於彈性集區內的超大規模資料庫。
properties.recoverableDatabaseId	string	與這個資料庫建立作業相關聯的可復原資料庫資源標識符。
properties.recoveryServicesRecoveryPointId	string	與此資料庫建立作業相關聯的恢復點資源標識碼。
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	用來儲存此資料庫的備份的記憶體帳戶類型。
properties.requestedServiceObjectiveName	string	資料庫所要求的服務等級目標名稱。
properties.restorableDroppedDatabaseId	string	與這個資料庫的建立作業相關聯的可還原已卸除資料庫資源標識碼。
properties.restorePointInTime	string	指定將還原以建立新資料庫之源資料庫) (ISO8601 時間點。
properties.resumedDate	string	使用者動作或資料庫登入 (ISO8601 格式) 繼續資料庫的日期。如果資料庫暫停，則為 Null。
properties.sampleName	SampleName	建立此資料庫時要套用的範例架構名稱。
properties.secondaryType	SecondaryType	如果資料庫是輔助資料庫，則為次要類型。有效值為 Geo 和 Named。
properties.sourceDatabaseDeletionDate	string	指定刪除資料庫的時間。
properties.sourceDatabaseId	string	與此資料庫建立作業相關聯的源資料庫資源標識符。
properties.sourceResourceId	string	與這個資料庫建立作業相關聯的來源資源標識符。此屬性僅支援 DataWarehouse 版本，並允許跨訂用帳戶還原。指定 sourceResourceId 時，sourceDatabaseId、recoverableDatabaseId、restoreableDroppedDatabaseId 和 sourceDatabaseDeletionDate 不得指定，而且 CreateMode 必須是 PointInTimeRestore、Restore 或 Recover。當 createMode 是 PointInTimeRestore 時，sourceResourceId 必須是現有資料庫或現有 SQL 集區的資源識別碼，而且必須指定 restorePointInTime。當 createMode 為 Restore 時，sourceResourceId 必須是可還原的已卸除資料庫或可還原的已卸除 SQL 集區的資源識別符。當 createMode 為 Recover 時，sourceResourceId 必須是可復原資料庫或可復原 SQL 集區的資源標識碼。當來源訂用帳戶屬於與目標訂用帳戶不同的租使用者時，“x-ms-authorization-auxiliary” 標頭必須包含來源租使用者的驗證令牌。如需有關「x-ms-authorization-auxiliary」標頭的詳細資訊，請參閱 https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
properties.status	DatabaseStatus	資料庫的狀態。
properties.zoneRedundant	boolean	不論此資料庫是否為區域備援，這表示此資料庫的複本會分散到多個可用性區域。
sku	Sku	資料庫 SKU。 SKU 清單可能會因區域和支援供應項目而異。若要判斷 SKU (包括 SKU 名稱、層/版本、系列和容量) ，這些 sku 可供您在 Azure 區域中的訂用帳戶使用，請使用 `Capabilities_ListByLocation` REST API 或下列其中一個命令： `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
tags	object	資源標籤。
type	string	資源類型。

DatabaseIdentity

Object

資源的 Azure Active Directory 身分識別組態。

名稱	類型	Description
tenantId	string	Azure Active Directory 租用戶標識符。
type	DatabaseIdentityType	身分識別類型
userAssignedIdentities	<string, DatabaseUserIdentity>	要使用的使用者指派身分識別的資源標識碼

DatabaseIdentityType

Enumeration

身分識別類型

值	Description
None
UserAssigned

DatabaseLicenseType

Enumeration

要套用至此資料庫的授權類型。 LicenseIncluded如果您需要授權，或BasePrice如果您有授權且符合 Azure Hybrid Benefit 資格。

值	Description
BasePrice
LicenseIncluded

DatabaseReadScale

Enumeration

唯讀路由的狀態。如果啟用，應用程式意圖在其連接字串中設定為唯讀的連線，可能會路由傳送至相同區域中的唯讀次要複本。不適用於彈性集區內的超大規模資料庫。

值	Description
Disabled
Enabled

DatabaseStatus

Enumeration

資料庫的狀態。

值	Description
AutoClosed
Copying
Creating
Disabled
EmergencyMode
Inaccessible
Offline
OfflineChangingDwPerformanceTiers
OfflineSecondary
Online
OnlineChangingDwPerformanceTiers
Paused
Pausing
Recovering
RecoveryPending
Restoring
Resuming
Scaling
Shutdown
Standby
Starting
Stopped
Stopping
Suspect

DatabaseUserIdentity

Object

資源的 Azure Active Directory 身分識別組態。

名稱	類型	Description
clientId	string	Azure Active Directory 用戶端標識符。
principalId	string	Azure Active Directory 主體標識符。

SampleName

Enumeration

建立此資料庫時要套用的範例架構名稱。

值	Description
AdventureWorksLT
WideWorldImportersFull
WideWorldImportersStd

SecondaryType

Enumeration

如果資料庫是輔助資料庫，則為次要類型。有效值為 Geo 和 Named。

值	Description
Geo
Named

Sku

Object

ARM 資源 SKU。

名稱	類型	Description
capacity	integer	特定 SKU 的容量。
family	string	如果服務有不同的硬體世代，則針對相同的 SKU，則可以在這裡擷取。
name	string	SKU 的名稱，通常是字母 + 編號代碼，例如 P3。
size	string	特定 SKU 的大小
tier	string	特定 SKU 的層級或版本，例如基本、進階。

共用方式為

Databases - Resume

URI 參數

回應

範例

Resumes a database.

範例要求

範例回覆

定義

BackupStorageRedundancy

CatalogCollationType

CreateMode

Database

DatabaseIdentity

DatabaseIdentityType

DatabaseLicenseType

DatabaseReadScale

DatabaseStatus

DatabaseUserIdentity

SampleName

SecondaryType

Sku

其他資源