共用方式為


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
databaseName
path True

string

要繼續的資料庫名稱。

resourceGroupName
path True

string

包含資源的資源群組名稱。 您可以從 Azure Resource Manager API 或入口網站取得此值。

serverName
path True

string

伺服器的名稱。

subscriptionId
path True

string

識別 Azure 訂用帳戶的訂用帳戶標識碼。

api-version
query True

string

要用於要求的 API 版本。

回應

名稱 類型 Description
200 OK

Database

成功繼續資料庫。

202 Accepted

繼續資料庫正在進行中。

標題

Location: string

Other Status Codes

ErrorResponse

錯誤回應: ***

  • 400 FeatureDisabledOnSelectedEdition - 用戶嘗試使用目前資料庫版本已停用的功能。

  • 404 ServerNotInSubscription - 指定的伺服器不存在於指定的訂用帳戶上。

  • 404 SourceDatabaseNotFound - 源資料庫不存在。

  • 404 OperationIdNotFound - 標識符為 的作業不存在。

  • 409 CannotCancelOperation - 管理作業處於無法取消的狀態。

  • 409 OperationCancelled - 使用者已取消作業。

  • 409 OperationInterrupted - 無法完成資源上的作業,因為相同資源上的另一個作業中斷。

  • 429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。

  • 429 SubscriptionTooManyRequests - 超出可用資源可處理之最大要求的要求。

  • 500 ActivateOrDeactivateWorkflowThrottling - 啟用或停用工作流程失敗,因為並行工作流程太多

  • 500 OperationTimedOut - 作業逾時並自動回復。 請重試作業。

  • 503 TooManyRequests - 超出可用資源可處理之最大要求的要求。

範例

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
AlwaysEncryptedEnclaveType

資料庫上要求的記憶體保護區類型,也就是預設或 VBS記憶體保護區。

AvailabilityZoneType

指定資料庫釘選到的可用性區域。

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

識別類型

DatabaseKey

用於待用加密的資料庫層級金鑰。

DatabaseKeyType

資料庫金鑰類型。 只有支援的值為 『AzureKeyVault』。

DatabaseLicenseType

要套用此資料庫的授權類型。 如果您需要授權,或擁有授權且符合 Azure Hybrid Benefit 資格,請 LicenseIncludedBasePrice

DatabaseReadScale

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

DatabaseStatus

資料庫的狀態。

DatabaseUserIdentity

資源的 Azure Active Directory 身分識別設定。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

FreeLimitExhaustionBehavior

指定免費資料庫用完每月可用限制時的行為。

AutoPause:資料庫會在當月剩餘時間的可用限制用盡時自動暫停。

BillForUsage:資料庫會在免費限制用盡時繼續上線,並收取任何超額費用。

SampleName

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

SecondaryType

如果資料庫是輔助資料庫,則為次要類型。 有效值為 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

DatabaseIdentity

資料庫的 Azure Active Directory 身分識別。

kind

string

資料庫種類。 這是用於 Azure 入口網站體驗的元數據。

location

string

資源位置。

managedBy

string

管理資料庫的資源。

name

string

資源名稱。

properties.autoPauseDelay

integer (int32)

在幾分鐘后自動暫停資料庫的時間。 -1 值表示已停用自動暫停

properties.availabilityZone

AvailabilityZoneType

指定資料庫釘選到的可用性區域。

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 (date-time)

資料庫的建立日期(ISO8601格式)。

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

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

properties.currentServiceObjectiveName

string

資料庫目前的服務等級目標名稱。

properties.currentSku

Sku

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

FreeLimitExhaustionBehavior

指定免費資料庫用完每月可用限制時的行為。

AutoPause:資料庫會在當月剩餘時間的可用限制用盡時自動暫停。

BillForUsage:資料庫會在免費限制用盡時繼續上線,並收取任何超額費用。

properties.highAvailabilityReplicaCount

integer (int32)

與用來提供高可用性的商業關鍵、進階或超大規模資料庫相關聯的次要複本數目。 不適用於彈性集區內的超大規模資料庫。

properties.isInfraEncryptionEnabled

boolean

此資料庫已啟用基礎結構加密。

properties.isLedgerOn

boolean

這個資料庫是否為總賬資料庫,這表示資料庫中的所有數據表都是總賬數據表。 注意:建立資料庫之後,就無法變更此屬性的值。

properties.keys

<string,  DatabaseKey>

要使用的使用者指派身分識別的資源標識碼

properties.licenseType

DatabaseLicenseType

要套用此資料庫的授權類型。 如果您需要授權,或擁有授權且符合 Azure Hybrid Benefit 資格,請 LicenseIncludedBasePrice

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

AlwaysEncryptedEnclaveType

資料庫上要求的記憶體保護區類型,也就是預設或 VBS記憶體保護區。

properties.readScale

DatabaseReadScale

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

properties.recoverableDatabaseId

string (arm-id)

與此資料庫建立作業相關聯的可復原資料庫資源標識符。

properties.recoveryServicesRecoveryPointId

string (arm-id)

與此資料庫建立作業相關聯的恢復點資源標識碼。

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

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

properties.requestedServiceObjectiveName

string

資料庫所要求的服務等級目標名稱。

properties.restorableDroppedDatabaseId

string (arm-id)

與這個資料庫建立作業相關聯的可還原卸除資料庫資源標識符。

properties.restorePointInTime

string (date-time)

指定要還原以建立新資料庫的源資料庫的時間點(ISO8601格式)。

properties.resumedDate

string (date-time)

使用者動作或資料庫登入繼續資料庫的日期(ISO8601格式)。 如果資料庫暫停,則為 Null。

properties.sampleName

SampleName

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

properties.secondaryType

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

DatabaseStatus

資料庫的狀態。

properties.useFreeLimit

boolean

資料庫是否使用免費每月限制。 在訂用帳戶中的一個資料庫上允許。

properties.zoneRedundant

boolean

此資料庫是否為區域備援,這表示此資料庫的複本會分散到多個可用性區域。

sku

Sku

資料庫 SKU。

SKU 清單可能會因區域和支援供應項目而異。 若要判斷 Azure 區域中訂用帳戶可用的 SKU(包括 SKU 名稱、層/版本、系列和容量),請使用 Capabilities_ListByLocation REST API 或下列其中一個命令:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
tags

object

資源標籤。

type

string

資源類型。

DatabaseIdentity

資源的 Azure Active Directory 身分識別設定。

名稱 類型 Description
tenantId

string (uuid)

Azure Active Directory 租用戶標識符。

type

DatabaseIdentityType

識別類型

userAssignedIdentities

<string,  DatabaseUserIdentity>

要使用的使用者指派身分識別的資源標識碼

DatabaseIdentityType

識別類型

Description
None
UserAssigned

DatabaseKey

用於待用加密的資料庫層級金鑰。

名稱 類型 Description
creationDate

string (date-time)

資料庫金鑰建立日期。

subregion

string

伺服器索引鍵的子區域。

thumbprint

string

資料庫金鑰的指紋。

type

DatabaseKeyType

資料庫金鑰類型。 只有支援的值為 『AzureKeyVault』。

DatabaseKeyType

資料庫金鑰類型。 只有支援的值為 『AzureKeyVault』。

Description
AzureKeyVault

DatabaseLicenseType

要套用此資料庫的授權類型。 如果您需要授權,或擁有授權且符合 Azure Hybrid Benefit 資格,請 LicenseIncludedBasePrice

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

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細數據。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

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 的階層或版本,例如基本、進階。