Databases - Resume
繼續資料庫。
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/resume?api-version=2023-08-01
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
database
|
path | True |
string |
要繼續的資料庫名稱。 |
resource
|
path | True |
string |
包含資源的資源群組名稱。 您可以從 Azure Resource Manager API 或入口網站取得此值。 |
server
|
path | True |
string |
伺服器的名稱。 |
subscription
|
path | True |
string |
識別 Azure 訂用帳戶的訂用帳戶標識碼。 |
api-version
|
query | True |
string |
要用於要求的 API 版本。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
成功繼續資料庫。 |
|
202 Accepted |
繼續資料庫正在進行中。 標題 Location: string |
|
Other Status Codes |
錯誤回應: ***
|
範例
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=2023-08-01
範例回覆
{
"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"
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/locations/japaneast/databaseOperationResults/00000000-0000-0000-0000-000000000000
定義
名稱 | Description |
---|---|
Always |
資料庫上要求的記憶體保護區類型,也就是預設或 VBS記憶體保護區。 |
Availability |
指定資料庫釘選到的可用性區域。 |
Backup |
用來儲存此資料庫的備份的記憶體帳戶類型。 |
Catalog |
元資料目錄的定序。 |
Create |
指定資料庫建立模式。 默認值:定期建立資料庫。 複製:建立資料庫做為現有資料庫的複本。 sourceDatabaseId 必須指定為源資料庫的資源標識碼。 次要:建立資料庫做為現有資料庫的次要複本。 sourceDatabaseId 必須指定為現有主資料庫的資源標識碼。 PointInTimeRestore:藉由還原現有資料庫的時間點備份來建立資料庫。 sourceDatabaseId 必須指定為現有資料庫的資源標識符,而且必須指定 restorePointInTime。 復原:藉由還原異地復寫備份來建立資料庫。 sourceDatabaseId 必須指定為要還原的可復原資料庫資源標識符。 還原:藉由還原已刪除資料庫的備份來建立資料庫。 必須指定sourceDatabaseId。 如果 sourceDatabaseId 是資料庫的原始資源識別碼,則必須指定 sourceDatabaseDeletionDate。 否則,sourceDatabaseId 必須是可還原的卸除資料庫資源標識符,而且會忽略 sourceDatabaseDeletionDate。 restorePointInTime 也可以指定為從先前的時間點還原。 RestoreLongTermRetentionBackup:從長期保留保存庫還原來建立資料庫。 recoveryServicesRecoveryPointResourceId 必須指定為恢復點資源標識符。 DataWarehouse 版本不支援 Copy、Secondary 和 RestoreLongTermRetentionBackup。 |
Database |
資料庫資源。 |
Database |
資源的 Azure Active Directory 身分識別設定。 |
Database |
識別類型 |
Database |
用於待用加密的資料庫層級金鑰。 |
Database |
資料庫金鑰類型。 只有支援的值為 『AzureKeyVault』。 |
Database |
要套用此資料庫的授權類型。 如果您需要授權,或擁有授權且符合 Azure Hybrid Benefit 資格,請 |
Database |
唯讀路由的狀態。 如果啟用,在其連接字串中將應用程式意圖設定為唯讀的連線,可能會路由傳送至相同區域中的唯讀次要複本。 不適用於彈性集區內的超大規模資料庫。 |
Database |
資料庫的狀態。 |
Database |
資源的 Azure Active Directory 身分識別設定。 |
Error |
資源管理錯誤其他資訊。 |
Error |
錯誤詳細數據。 |
Error |
錯誤回應 |
Free |
指定免費資料庫用完每月可用限制時的行為。 AutoPause:資料庫會在當月剩餘時間的可用限制用盡時自動暫停。 BillForUsage:資料庫會在免費限制用盡時繼續上線,並收取任何超額費用。 |
Sample |
建立這個資料庫時要套用的範例架構名稱。 |
Secondary |
如果資料庫是輔助資料庫,則為次要類型。 有效值為 Geo、Named 和 Standby。 |
Sku |
ARM 資源 SKU。 |
AlwaysEncryptedEnclaveType
資料庫上要求的記憶體保護區類型,也就是預設或 VBS記憶體保護區。
值 | Description |
---|---|
Default | |
VBS |
AvailabilityZoneType
指定資料庫釘選到的可用性區域。
值 | Description |
---|---|
1 | |
2 | |
3 | |
NoPreference |
BackupStorageRedundancy
用來儲存此資料庫的備份的記憶體帳戶類型。
值 | Description |
---|---|
Geo | |
GeoZone | |
Local | |
Zone |
CatalogCollationType
元資料目錄的定序。
值 | Description |
---|---|
DATABASE_DEFAULT | |
SQL_Latin1_General_CP1_CI_AS |
CreateMode
指定資料庫建立模式。
默認值:定期建立資料庫。
複製:建立資料庫做為現有資料庫的複本。 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
資料庫資源。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源標識碼。 |
identity |
資料庫的 Azure Active Directory 身分識別。 |
|
kind |
string |
資料庫種類。 這是用於 Azure 入口網站體驗的元數據。 |
location |
string |
資源位置。 |
managedBy |
string |
管理資料庫的資源。 |
name |
string |
資源名稱。 |
properties.autoPauseDelay |
integer (int32) |
在幾分鐘后自動暫停資料庫的時間。 -1 值表示已停用自動暫停 |
properties.availabilityZone |
指定資料庫釘選到的可用性區域。 |
|
properties.catalogCollation |
元資料目錄的定序。 |
|
properties.collation |
string |
資料庫的定序。 |
properties.createMode |
指定資料庫建立模式。 默認值:定期建立資料庫。 複製:建立資料庫做為現有資料庫的複本。 sourceDatabaseId 必須指定為源資料庫的資源標識碼。 次要:建立資料庫做為現有資料庫的次要複本。 sourceDatabaseId 必須指定為現有主資料庫的資源標識碼。 PointInTimeRestore:藉由還原現有資料庫的時間點備份來建立資料庫。 sourceDatabaseId 必須指定為現有資料庫的資源標識符,而且必須指定 restorePointInTime。 復原:藉由還原異地復寫備份來建立資料庫。 sourceDatabaseId 必須指定為要還原的可復原資料庫資源標識符。 還原:藉由還原已刪除資料庫的備份來建立資料庫。 必須指定sourceDatabaseId。 如果 sourceDatabaseId 是資料庫的原始資源識別碼,則必須指定 sourceDatabaseDeletionDate。 否則,sourceDatabaseId 必須是可還原的卸除資料庫資源標識符,而且會忽略 sourceDatabaseDeletionDate。 restorePointInTime 也可以指定為從先前的時間點還原。 RestoreLongTermRetentionBackup:從長期保留保存庫還原來建立資料庫。 recoveryServicesRecoveryPointResourceId 必須指定為恢復點資源標識符。 DataWarehouse 版本不支援 Copy、Secondary 和 RestoreLongTermRetentionBackup。 |
|
properties.creationDate |
string (date-time) |
資料庫的建立日期(ISO8601格式)。 |
properties.currentBackupStorageRedundancy |
用來儲存此資料庫的備份的記憶體帳戶類型。 |
|
properties.currentServiceObjectiveName |
string |
資料庫目前的服務等級目標名稱。 |
properties.currentSku |
SKU 的名稱和層。 |
|
properties.databaseId |
string (uuid) |
資料庫的標識碼。 |
properties.defaultSecondaryLocation |
string |
這個資料庫的預設次要區域。 |
properties.earliestRestoreDate |
string (date-time) |
這會記錄此資料庫最早的開始日期和時間(ISO8601格式)。 |
properties.elasticPoolId |
string (arm-id) |
包含此資料庫之彈性集區的資源標識碼。 |
properties.encryptionProtector |
string |
如果資料庫已針對每個資料庫客戶管理的金鑰進行設定,則為資料庫的 Azure 金鑰保存庫 URI。 |
properties.encryptionProtectorAutoRotation |
boolean |
啟用或停用資料庫加密保護裝置 AKV 金鑰自動輪替的旗標。 |
properties.failoverGroupId |
string |
此資料庫所屬的故障轉移群組資源標識碼。 |
properties.federatedClientId |
string (uuid) |
用於每個資料庫跨租使用者的用戶端標識碼 CMK 案例 |
properties.freeLimitExhaustionBehavior |
指定免費資料庫用完每月可用限制時的行為。 AutoPause:資料庫會在當月剩餘時間的可用限制用盡時自動暫停。 BillForUsage:資料庫會在免費限制用盡時繼續上線,並收取任何超額費用。 |
|
properties.highAvailabilityReplicaCount |
integer (int32) |
與用來提供高可用性的商業關鍵、進階或超大規模資料庫相關聯的次要複本數目。 不適用於彈性集區內的超大規模資料庫。 |
properties.isInfraEncryptionEnabled |
boolean |
此資料庫已啟用基礎結構加密。 |
properties.isLedgerOn |
boolean |
這個資料庫是否為總賬資料庫,這表示資料庫中的所有數據表都是總賬數據表。 注意:建立資料庫之後,就無法變更此屬性的值。 |
properties.keys |
<string,
Database |
要使用的使用者指派身分識別的資源標識碼 |
properties.licenseType |
要套用此資料庫的授權類型。 如果您需要授權,或擁有授權且符合 Azure Hybrid Benefit 資格,請 |
|
properties.longTermRetentionBackupResourceId |
string (arm-id) |
與此資料庫建立作業相關聯的長期保留備份資源標識符。 |
properties.maintenanceConfigurationId |
string |
指派給資料庫的維護組態標識碼。 此組態會定義維護更新發生的期間。 |
properties.manualCutover |
boolean |
客戶控制手動完全移轉是否需要在更新資料庫作業期間完成超大規模資料庫層。 只有在將資料庫從業務關鍵/一般用途/進階/標準層調整為超大規模資料庫層時,才適用此屬性。 指定manualCutover時,調整作業會等候使用者輸入觸發超大規模資料庫完全移轉。 若要觸發完全移轉,請在調整作業處於等候狀態時提供 『performCutover』 參數。 |
properties.maxLogSizeBytes |
integer (int64) |
這個資料庫的記錄大小上限。 |
properties.maxSizeBytes |
integer (int64) |
以位元組表示的資料庫大小上限。 |
properties.minCapacity |
number (double) |
資料庫一律配置的最小容量,如果未暫停,則為 |
properties.pausedDate |
string (date-time) |
用戶設定或動作暫停資料庫的日期(ISO8601格式)。 如果資料庫已就緒,則為 Null。 |
properties.performCutover |
boolean |
在調整作業進行中時,觸發客戶控制的手動完全移轉。 這個屬性參數僅適用於起始與 'manualCutover' 參數一起起始的調整作業。 只有當資料庫從業務關鍵/一般用途/進階/標準層調整至超大規模資料庫層級正在進行時,才適用此屬性。 指定了performCutover時,調整作業會觸發完全移轉,並執行超大規模資料庫的角色變更。 |
properties.preferredEnclaveType |
資料庫上要求的記憶體保護區類型,也就是預設或 VBS記憶體保護區。 |
|
properties.readScale |
唯讀路由的狀態。 如果啟用,在其連接字串中將應用程式意圖設定為唯讀的連線,可能會路由傳送至相同區域中的唯讀次要複本。 不適用於彈性集區內的超大規模資料庫。 |
|
properties.recoverableDatabaseId |
string (arm-id) |
與此資料庫建立作業相關聯的可復原資料庫資源標識符。 |
properties.recoveryServicesRecoveryPointId |
string (arm-id) |
與此資料庫建立作業相關聯的恢復點資源標識碼。 |
properties.requestedBackupStorageRedundancy |
要用來儲存此資料庫的備份的記憶體帳戶類型。 |
|
properties.requestedServiceObjectiveName |
string |
資料庫所要求的服務等級目標名稱。 |
properties.restorableDroppedDatabaseId |
string (arm-id) |
與這個資料庫建立作業相關聯的可還原卸除資料庫資源標識符。 |
properties.restorePointInTime |
string (date-time) |
指定要還原以建立新資料庫的源資料庫的時間點(ISO8601格式)。 |
properties.resumedDate |
string (date-time) |
使用者動作或資料庫登入繼續資料庫的日期(ISO8601格式)。 如果資料庫暫停,則為 Null。 |
properties.sampleName |
建立這個資料庫時要套用的範例架構名稱。 |
|
properties.secondaryType |
如果資料庫是輔助資料庫,則為次要類型。 有效值為 Geo、Named 和 Standby。 |
|
properties.sourceDatabaseDeletionDate |
string (date-time) |
指定刪除資料庫的時間。 |
properties.sourceDatabaseId |
string (arm-id) |
與這個資料庫建立作業相關聯的源資料庫資源標識符。 |
properties.sourceResourceId |
string (arm-id) |
與這個資料庫建立作業相關聯的來源資源標識符。 只有 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 |
資料庫的狀態。 |
|
properties.useFreeLimit |
boolean |
資料庫是否使用免費每月限制。 在訂用帳戶中的一個資料庫上允許。 |
properties.zoneRedundant |
boolean |
此資料庫是否為區域備援,這表示此資料庫的複本會分散到多個可用性區域。 |
sku |
資料庫 SKU。 SKU 清單可能會因區域和支援供應項目而異。 若要判斷 Azure 區域中訂用帳戶可用的 SKU(包括 SKU 名稱、層/版本、系列和容量),請使用
|
|
tags |
object |
資源標籤。 |
type |
string |
資源類型。 |
DatabaseIdentity
資源的 Azure Active Directory 身分識別設定。
名稱 | 類型 | Description |
---|---|---|
tenantId |
string (uuid) |
Azure Active Directory 租用戶標識符。 |
type |
識別類型 |
|
userAssignedIdentities |
<string,
Database |
要使用的使用者指派身分識別的資源標識碼 |
DatabaseIdentityType
識別類型
值 | Description |
---|---|
None | |
UserAssigned |
DatabaseKey
用於待用加密的資料庫層級金鑰。
名稱 | 類型 | Description |
---|---|---|
creationDate |
string (date-time) |
資料庫金鑰建立日期。 |
subregion |
string |
伺服器索引鍵的子區域。 |
thumbprint |
string |
資料庫金鑰的指紋。 |
type |
資料庫金鑰類型。 只有支援的值為 『AzureKeyVault』。 |
DatabaseKeyType
資料庫金鑰類型。 只有支援的值為 『AzureKeyVault』。
值 | Description |
---|---|
AzureKeyVault |
DatabaseLicenseType
要套用此資料庫的授權類型。 如果您需要授權,或擁有授權且符合 Azure Hybrid Benefit 資格,請 LicenseIncluded
BasePrice
。
值 | Description |
---|---|
BasePrice | |
LicenseIncluded |
DatabaseReadScale
唯讀路由的狀態。 如果啟用,在其連接字串中將應用程式意圖設定為唯讀的連線,可能會路由傳送至相同區域中的唯讀次要複本。 不適用於彈性集區內的超大規模資料庫。
值 | Description |
---|---|
Disabled | |
Enabled |
DatabaseStatus
資料庫的狀態。
值 | 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
資源的 Azure Active Directory 身分識別設定。
名稱 | 類型 | Description |
---|---|---|
clientId |
string (uuid) |
Azure Active Directory 用戶端標識符。 |
principalId |
string (uuid) |
Azure Active Directory 主體標識符。 |
ErrorAdditionalInfo
資源管理錯誤其他資訊。
名稱 | 類型 | Description |
---|---|---|
info |
object |
其他資訊。 |
type |
string |
其他信息類型。 |
ErrorDetail
錯誤詳細數據。
名稱 | 類型 | Description |
---|---|---|
additionalInfo |
錯誤其他資訊。 |
|
code |
string |
錯誤碼。 |
details |
錯誤詳細數據。 |
|
message |
string |
錯誤訊息。 |
target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
名稱 | 類型 | Description |
---|---|---|
error |
error 物件。 |
FreeLimitExhaustionBehavior
指定免費資料庫用完每月可用限制時的行為。
AutoPause:資料庫會在當月剩餘時間的可用限制用盡時自動暫停。
BillForUsage:資料庫會在免費限制用盡時繼續上線,並收取任何超額費用。
值 | Description |
---|---|
AutoPause | |
BillOverUsage |
SampleName
建立這個資料庫時要套用的範例架構名稱。
值 | Description |
---|---|
AdventureWorksLT | |
WideWorldImportersFull | |
WideWorldImportersStd |
SecondaryType
如果資料庫是輔助資料庫,則為次要類型。 有效值為 Geo、Named 和 Standby。
值 | Description |
---|---|
Geo | |
Named | |
Standby |
Sku
ARM 資源 SKU。
名稱 | 類型 | Description |
---|---|---|
capacity |
integer (int32) |
特定 SKU 的容量。 |
family |
string |
如果服務有不同世代的硬體,針對相同的 SKU,則可以在這裡擷取。 |
name |
string |
SKU 的名稱,通常是字母 + 數位碼,例如 P3。 |
size |
string |
特定 SKU 的大小 |
tier |
string |
特定 SKU 的階層或版本,例如基本、進階。 |