共用方式為


Elastic Pools - Update

更新彈性集區。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}?api-version=2023-08-01

URI 參數

名稱 位於 必要 類型 Description
elasticPoolName
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
properties.autoPauseDelay

integer (int32)

彈性集區自動暫停的分鐘數。 -1 值表示已停用自動暫停

properties.availabilityZone

AvailabilityZoneType

指定集區主要複本釘選到的可用性區域。

properties.highAvailabilityReplicaCount

integer (int32)

與商務關鍵、進階或超大規模資料庫版本彈性集區相關聯的次要複本數目,這些復本可用來提供高可用性。 僅適用於超大規模彈性集區。

properties.licenseType

ElasticPoolLicenseType

要套用此彈性集區的授權類型。

properties.maintenanceConfigurationId

string

指派給彈性集區的維護組態標識碼。 此組態會定義將發生維護更新的期間。

properties.maxSizeBytes

integer (int64)

資料庫彈性集區的記憶體限制,以位元組為單位。

properties.minCapacity

number (double)

如果未暫停,無伺服器集區的最小容量將不會縮小到下方

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

彈性集區的每個資料庫設定。

properties.preferredEnclaveType

AlwaysEncryptedEnclaveType

彈性集區上要求的記憶體保護區類型。

properties.zoneRedundant

boolean

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

sku

Sku

ARM 資源 SKU。

tags

object

資源標籤。

回應

名稱 類型 Description
200 OK

ElasticPool

已更新彈性集區

202 Accepted

接受

標題

Location: string

Other Status Codes

ErrorResponse

錯誤回應: ***

  • 400 ManagedInstanceStoppingOrStopped - 實例處於停止/停止狀態時提交的衝突作業

  • 400 ManagedInstanceStarting - 實例處於啟動狀態時提交的衝突作業

  • 400 ElasticPoolOverStorageUsage - 在達到彈性集區的儲存限制時,嘗試將數據寫入資料庫。

  • 400 ElasticPoolScaleNotSupportedWithInaccessibleDatabases - 彈性集區包含無法存取的資料庫,這些資料庫已遺失 TDE 設定所需的 Azure Key Vault 存取權。 請將可存取的資料庫移至不同的集區,以調整或還原無法存取資料庫的遺失 Azure Key Vault 存取權。

  • 400 CreateElasticPoolAttemptedWhenKeyRotationInProgress - 由於伺服器上的透明數據加密 (TDE) 密鑰輪替,因此目前無法執行建立彈性集區作業。 請稍後再試一次作業。

  • 400 InvalidSku - 使用者指定了無效的 SKU。

  • 400 InvalidTierSkuCombination - 指定的層不支援指定的 SKU。

  • 400 ServerQuotaExceeded - 伺服器達到允許的資料庫輸送量單位限制。

  • 400 ElasticPoolAlreadyExists - 伺服器已經包含具有指定名稱的彈性集區。

  • 400 SubscriptionVcoreQuotaExceeded - 無法執行作業,因為訂用帳戶會超過允許的虛擬核心配額。

  • 400 InvalidInputValueForEdition - 彈性集區布建不支援指定的版本。

  • 400 ElasticPoolDtuBelowLimit - 要求的 DTU 值對於要求的彈性集區服務層級而言太低。

  • 400 ElasticPoolDtuAboveLimit - 要求的 DTU 值對於要求的彈性集區服務層級而言太高。

  • 400 InvalidMaxSize - 大小上限無效。

  • 400 ElasticPoolDbDtuMaxBelowLimit - 要求的每個資料庫 DTU 最大值對於要求的彈性集區服務層級而言太低。

  • 400 ElasticPoolDbDtuMaxAboveLimit - 針對要求的彈性集區服務層級,每個資料庫要求的 DTU 最大值太高。

  • 400 InvalidInputValueForDatabaseDtuMax - 嘗試為不符合允許值的資源集區設定每個資料庫的 DTU 最大值。

  • 400 ElasticPoolDbDtuMinAboveLimit - 每個資料庫要求的 DTU 最小值對於要求的服務層級而言太高。

  • 400 ElasticPoolOverStorage - 當達到彈性集區的儲存限制時,嘗試將數據寫入資料庫。

  • 400 InvalidInputValueForDatabaseDtuMin - 嘗試針對不符合允許值的資源集區,為每個資料庫設定 DTU 最小值。

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings - 嘗試為超過彈性集區所要求 DTU 的彈性集區中的資料庫提供 DTU 分鐘。

  • 400 ElasticPoolDtuUnsupported - 用戶嘗試使用不支援的 DTU 容量來建立或更新彈性集區。

  • 400 ElasticPoolStorageAboveLimitGB - 嘗試將彈性集區記憶體限制設定為低於支援的限制。

  • 400 ElasticPoolsNotEnabled - 此區域中尚未啟用彈性集區。

  • 400 ElasticPoolNotEmpty - 刪除非空白的彈性集區的要求。

  • 400 ElasticPoolStorageBelowLimitGB - 嘗試將彈性集區記憶體限制設定為低於支援的限制。

  • 400 ElasticPoolStorageNotAllowedGB - 嘗試以 GB 設定不符合允許值的彈性集區記憶體限制。

  • 400 ElasticPoolDatabaseLimit - 彈性集區已達到資料庫數目的限制。

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage - 嘗試降低其記憶體使用量下方彈性集區的儲存限制。

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax - 嘗試設定每個資料庫的 DTU 最小值高於每個資料庫的 DTU 最大值。

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings - 每個資料庫的資料庫和虛擬核心數目不能超過彈性集區要求的 VCore 數目。

  • 400 ElasticPoolStorageBelowLimitMB - 嘗試將彈性集區記憶體限制設定為低於支援的限制。

  • 400 ElasticPoolStorageNotAllowedMB - 嘗試以 mb 為單位設定彈性集區記憶體限制,但不符合允許的值。

  • 400 ElasticPoolCapacityStorageNotAllowedMB - 嘗試以 MB 設定彈性集區儲存限制,但不符合允許的值。

  • 400 InvalidReadScaleUnits - 用戶嘗試提供不支持的讀取小數字數值。

  • 400 ElasticPoolStorageAboveLimitMB - 嘗試將彈性集區記憶體限制設定為低於支援的限制。

  • 400 RegionDoesNotSupportVersion - 用戶嘗試在不支援該伺服器版本的位置建立指定版本的伺服器。

  • 400 InvalidTier - 使用者指定了無效的階層。

  • 400 SourceDatabaseEditionCouldNotBeUpgraded - 源資料庫的版本不能高於目標資料庫。

  • 400 TargetDatabaseEditionCouldNotBeDowngraded - 目標資料庫的版本不能低於源資料庫。

  • 400 ElasticPoolUpdateHkNotAllowed - 彈性集區無法將其服務層級從進階降低為標準或基本,因為一或多個資料庫使用記憶體優化物件。

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress - 作業是不允許的,因為伺服器 '{0}' 上資料庫 '{1}' 的複製或故障轉移作業目前正在進行中。

  • 400 RegionDoesNotAllowProvisioning - 選取的位置不接受新的 Windows Azure SQL Database 伺服器。 這可能會在稍後變更。

  • 400 HSElasticPoolUpdateSloPRMSNotSupported - 資料庫的服務目標指派失敗。 請連絡Microsoft客戶支援,並提供伺服器名稱、資料庫名稱和活動標識符。

  • 400 ElasticPoolOverFileSpace - 彈性集區中的檔案空間不足。

  • 400 ElasticPoolDbDtuMinBelowLimit - 針對要求的彈性集區服務層級,每個資料庫要求的 DTU 分鐘要求太低。

  • 400 ElasticPoolDbVcoreMaxBelowLimit - 針對要求的彈性集區服務層級,每個資料庫虛擬核心要求的要求太低。

  • 400 ElasticPoolDbVcoreMaxAboveLimit - 針對要求的彈性集區服務層級,每個資料庫 VCore 要求的最大值太高。

  • 400 InvalidInputValueForDatabaseVcoreMax - 嘗試為不符合允許值的資源集區設定每個資料庫的 VCore 最大值。

  • 400 ElasticPoolDbVcoreMinBelowLimit - 針對要求的彈性集區服務層級,每個資料庫虛擬核心要求的要求太低。

  • 400 InvalidInputValueForDatabaseVcoreMin - 嘗試為不符合允許值的資源集區設定每個資料庫的 VCore 最小值。

  • 400 PartnerDBNotCompatibleForSGXEnclave - 只有在兩個資料庫都在 DC 系列硬體上執行時,才支援設定已啟用記憶體保護區資料庫的 GeoDR 連結或更新 SLO。

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax - 嘗試將每個資料庫的 VCore 最小值設定為高於每個資料庫的 VCore 最大值。

  • 400 InvalidLicenseType - 用戶嘗試使用不支援的授權類型來建立或更新資料庫或彈性集區。

  • 400 ProvisioningDisabled - 顯示來自資源作業授權者的錯誤訊息,而不需變更

  • 400 CapacityGroupThresholdExceeded - 要求的服務等級目標和記憶體大小會對應至特定容量群組,而目前此容量群組的資源已達到閾值,而且需要採取進一步的動作,才能將這些通道中放置更多資料庫。

  • 400 CapacityGroupThresholdCheckFail - 容量群組資源條件約束檢查失敗,因此無法確認是否有足夠的容量可完成作業。

  • 400 InvalidPublicMaintenanceConfiguration - 使用者嘗試指定無法轉換成內部識別符的公用維護組態(格式不正確或錯誤區域)。

  • 400 InvalidResourceRequestBody - 要求主體中的資源或資源屬性是空的或無效的。

  • 400 InvalidResourceId - 無效的資源識別碼。

  • 400 InvalidSkuName - 無效的 SKU 名稱。

  • 400 不相符SkuNameAndCapacity - SKU 名稱和容量不符。

  • 400 不符SkuNameAndTier - SKU 名稱和層級不符。

  • 400 不相符SkuNameAndFamily - SKU 名稱和系列不符。

  • 400 MismatchingSubscriptionWithUrl - 提供的訂用帳戶不符合 Url 中的訂用帳戶。

  • 400 AvailabilityZoneNotSupported - 資料庫和彈性集區的要求可用性區域無效。

  • 400 ElasticPoolOverStorageUsage - 在達到彈性集區的儲存限制時,嘗試將數據寫入資料庫。

  • 400 ElasticPoolScaleNotSupportedWithInaccessibleDatabases - 彈性集區包含無法存取的資料庫,這些資料庫已遺失 TDE 設定所需的 Azure Key Vault 存取權。 請將可存取的資料庫移至不同的集區,以調整或還原無法存取資料庫的遺失 Azure Key Vault 存取權。

  • 400 CreateElasticPoolAttemptedWhenKeyRotationInProgress - 由於伺服器上的透明數據加密 (TDE) 密鑰輪替,因此目前無法執行建立彈性集區作業。 請稍後再試一次作業。

  • 400 InvalidSku - 使用者指定了無效的 SKU。

  • 400 InvalidTierSkuCombination - 指定的層不支援指定的 SKU。

  • 400 ServerQuotaExceeded - 伺服器達到允許的資料庫輸送量單位限制。

  • 400 ElasticPoolAlreadyExists - 伺服器已經包含具有指定名稱的彈性集區。

  • 400 SubscriptionVcoreQuotaExceeded - 無法執行作業,因為訂用帳戶會超過允許的虛擬核心配額。

  • 400 InvalidInputValueForEdition - 彈性集區布建不支援指定的版本。

  • 400 ElasticPoolDtuBelowLimit - 要求的 DTU 值對於要求的彈性集區服務層級而言太低。

  • 400 ElasticPoolDtuAboveLimit - 要求的 DTU 值對於要求的彈性集區服務層級而言太高。

  • 400 InvalidMaxSize - 大小上限無效。

  • 400 ElasticPoolDbDtuMaxBelowLimit - 要求的每個資料庫 DTU 最大值對於要求的彈性集區服務層級而言太低。

  • 400 ElasticPoolDbDtuMaxAboveLimit - 針對要求的彈性集區服務層級,每個資料庫要求的 DTU 最大值太高。

  • 400 InvalidInputValueForDatabaseDtuMax - 嘗試為不符合允許值的資源集區設定每個資料庫的 DTU 最大值。

  • 400 ElasticPoolDbDtuMinAboveLimit - 每個資料庫要求的 DTU 最小值對於要求的服務層級而言太高。

  • 400 ElasticPoolOverStorage - 當達到彈性集區的儲存限制時,嘗試將數據寫入資料庫。

  • 400 InvalidInputValueForDatabaseDtuMin - 嘗試針對不符合允許值的資源集區,為每個資料庫設定 DTU 最小值。

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings - 嘗試為超過彈性集區所要求 DTU 的彈性集區中的資料庫提供 DTU 分鐘。

  • 400 ElasticPoolDtuUnsupported - 用戶嘗試使用不支援的 DTU 容量來建立或更新彈性集區。

  • 400 ElasticPoolStorageAboveLimitGB - 嘗試將彈性集區記憶體限制設定為低於支援的限制。

  • 400 ElasticPoolsNotEnabled - 此區域中尚未啟用彈性集區。

  • 400 ElasticPoolNotEmpty - 刪除非空白的彈性集區的要求。

  • 400 ElasticPoolStorageBelowLimitGB - 嘗試將彈性集區記憶體限制設定為低於支援的限制。

  • 400 ElasticPoolStorageNotAllowedGB - 嘗試以 GB 設定不符合允許值的彈性集區記憶體限制。

  • 400 ElasticPoolDatabaseLimit - 彈性集區已達到資料庫數目的限制。

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage - 嘗試降低其記憶體使用量下方彈性集區的儲存限制。

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax - 嘗試設定每個資料庫的 DTU 最小值高於每個資料庫的 DTU 最大值。

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings - 每個資料庫的資料庫和虛擬核心數目不能超過彈性集區要求的 VCore 數目。

  • 400 ElasticPoolStorageBelowLimitMB - 嘗試將彈性集區記憶體限制設定為低於支援的限制。

  • 400 ElasticPoolStorageNotAllowedMB - 嘗試以 mb 為單位設定彈性集區記憶體限制,但不符合允許的值。

  • 400 ElasticPoolCapacityStorageNotAllowedMB - 嘗試以 MB 設定彈性集區儲存限制,但不符合允許的值。

  • 400 InvalidReadScaleUnits - 用戶嘗試提供不支持的讀取小數字數值。

  • 400 ElasticPoolStorageAboveLimitMB - 嘗試將彈性集區記憶體限制設定為低於支援的限制。

  • 400 RegionDoesNotSupportVersion - 用戶嘗試在不支援該伺服器版本的位置建立指定版本的伺服器。

  • 400 InvalidTier - 使用者指定了無效的階層。

  • 400 SourceDatabaseEditionCouldNotBeUpgraded - 源資料庫的版本不能高於目標資料庫。

  • 400 TargetDatabaseEditionCouldNotBeDowngraded - 目標資料庫的版本不能低於源資料庫。

  • 400 ElasticPoolUpdateHkNotAllowed - 彈性集區無法將其服務層級從進階降低為標準或基本,因為一或多個資料庫使用記憶體優化物件。

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress - 作業是不允許的,因為伺服器 '{0}' 上資料庫 '{1}' 的複製或故障轉移作業目前正在進行中。

  • 400 RegionDoesNotAllowProvisioning - 選取的位置不接受新的 Windows Azure SQL Database 伺服器。 這可能會在稍後變更。

  • 400 HSElasticPoolUpdateSloPRMSNotSupported - 資料庫的服務目標指派失敗。 請連絡Microsoft客戶支援,並提供伺服器名稱、資料庫名稱和活動標識符。

  • 400 ElasticPoolOverFileSpace - 彈性集區中的檔案空間不足。

  • 400 ElasticPoolDbDtuMinBelowLimit - 針對要求的彈性集區服務層級,每個資料庫要求的 DTU 分鐘要求太低。

  • 400 ElasticPoolDbVcoreMaxBelowLimit - 針對要求的彈性集區服務層級,每個資料庫虛擬核心要求的要求太低。

  • 400 ElasticPoolDbVcoreMaxAboveLimit - 針對要求的彈性集區服務層級,每個資料庫 VCore 要求的最大值太高。

  • 400 InvalidInputValueForDatabaseVcoreMax - 嘗試為不符合允許值的資源集區設定每個資料庫的 VCore 最大值。

  • 400 ElasticPoolDbVcoreMinBelowLimit - 針對要求的彈性集區服務層級,每個資料庫虛擬核心要求的要求太低。

  • 400 InvalidInputValueForDatabaseVcoreMin - 嘗試為不符合允許值的資源集區設定每個資料庫的 VCore 最小值。

  • 400 PartnerDBNotCompatibleForSGXEnclave - 只有在兩個資料庫都在 DC 系列硬體上執行時,才支援設定已啟用記憶體保護區資料庫的 GeoDR 連結或更新 SLO。

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax - 嘗試將每個資料庫的 VCore 最小值設定為高於每個資料庫的 VCore 最大值。

  • 400 InvalidLicenseType - 用戶嘗試使用不支援的授權類型來建立或更新資料庫或彈性集區。

  • 400 ProvisioningDisabled - 顯示來自資源作業授權者的錯誤訊息,而不需變更

  • 400 CapacityGroupThresholdExceeded - 要求的服務等級目標和記憶體大小會對應至特定容量群組,而目前此容量群組的資源已達到閾值,而且需要採取進一步的動作,才能將這些通道中放置更多資料庫。

  • 400 CapacityGroupThresholdCheckFail - 容量群組資源條件約束檢查失敗,因此無法確認是否有足夠的容量可完成作業。

  • 400 InvalidPublicMaintenanceConfiguration - 使用者嘗試指定無法轉換成內部識別符的公用維護組態(格式不正確或錯誤區域)。

  • 400 VBSEnclaveResourcePoolInvalidCombination - 不支援將具有 '{0}' preferredEnclaveType 的資料庫新增至彈性集區 '{1}' 與 '{2}' preferredEnclaveType。 將資料庫新增至彈性集區之前,請確定資料庫的 preferredEnclaveType 與彈性集區都相同。 如需詳細資訊,請參閱 https://aka.ms/AlwaysEncryptedEnableSecureEnclaves

  • 400 VBSEnclaveNotSupportedForDW - 專用 SQL 集區不支援 preferredEnclaveType。

  • 400 VBSEnclaveNotSupportedForDCSeriesSLO - 不支援使用 DC 系列硬體設定來設定資料庫的 'VBS' preferredEnclaveType。 DC 系列資料庫已預先設定 Intel SGX 記憶體保護區。 不支援虛擬化型安全性 (VBS) 記憶體保護區。

  • 400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave - 不支援使用 preferredEnclaveType 属性的不同值設定異地復寫的資料庫。 '{0}' 伺服器上的主要 '{1}' 資料庫會使用 '{2}' preferredEnclaveType,而 '{3}' 伺服器上次要 '{4}' 資料庫的指定 preferredEnclaveType 是 '{5}'。

  • 400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes - 虛擬式安全性 (VBS) 記憶體保護區不支援主要和輔助資料庫之間的計劃性故障轉移。

  • 404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。

  • 404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器

  • 404 ElasticPoolNotFound - 指定的彈性集區不存在指定的伺服器。

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

  • 404 ElasticPoolNotFound - 指定的彈性集區不存在指定的伺服器。

  • 405 NotSupported - 不支援此功能。

  • 405 NotSupported - 不支援此功能。

  • 409 ElasticPoolBusy - 在忙碌中的彈性集區上嘗試管理作業。

  • 409 ServerDisabled - 伺服器已停用。

  • 409 SimultaneousSkuChangeNotAllowed - 服務目標變更作業無法同時在復寫關聯性的兩個資料庫上執行。

  • 409 ElasticPoolUpdateLinksNotInCatchup - 無法在其中一個資料庫執行複製或異地復寫故障轉移作業時更新彈性集區。

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

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

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

  • 409 ElasticPoolBusy - 在忙碌中的彈性集區上嘗試管理作業。

  • 409 ServerDisabled - 伺服器已停用。

  • 409 SimultaneousSkuChangeNotAllowed - 服務目標變更作業無法同時在復寫關聯性的兩個資料庫上執行。

  • 409 ElasticPoolUpdateLinksNotInCatchup - 無法在其中一個資料庫執行複製或異地復寫故障轉移作業時更新彈性集區。

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

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

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

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

  • 500 ElasticPoolFailedMoveDbToElasticPool - 由於內部資源限制,無法將資料庫移至彈性集區。 這可能是暫時性狀況,請重試。

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

  • 500 ElasticPoolFailedMoveDbToElasticPool - 由於內部資源限制,無法將資料庫移至彈性集區。 這可能是暫時性狀況,請重試。

  • 503 ServiceTemporarilyUnavailable - 功能暫時無法使用。

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

  • 503 ServiceTemporarilyUnavailable - 功能暫時無法使用。

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

範例

Assigns maintenance configuration to an elastic pool.
Resets maintenance configuration of an elastic pool to default.
Update an elastic pool with all parameter
Update an elastic pool with minimum parameters
Update an elastic pool with preferred enclave type parameter as Default
Update an elastic pool with preferred enclave type parameter as VBS
Update an elastic pool with serverless properties
Update high availability replica count of a Hyperscale elastic pool.

Assigns maintenance configuration to an elastic pool.

範例要求

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2023-08-01

{
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

範例回覆

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "BasicPool",
    "tier": "Basic",
    "capacity": 50
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 5
    },
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2020-08-01

Resets maintenance configuration of an elastic pool to default.

範例要求

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2023-08-01

{
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default"
  }
}

範例回覆

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "BasicPool",
    "tier": "Basic",
    "capacity": 50
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 5
    }
  }
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2020-08-01

Update an elastic pool with all parameter

範例要求

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2023-08-01

{
  "sku": {
    "name": "BC_Gen4",
    "tier": "BusinessCritical",
    "capacity": 2
  },
  "properties": {
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 1
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded"
  }
}

範例回覆

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "BC_Gen4",
    "tier": "BusinessCritical",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-02-10T01:27:21.32Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 1
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded"
  }
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-10-01

Update an elastic pool with minimum parameters

範例要求

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2023-08-01

{}

範例回覆

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "BasicPool",
    "tier": "Basic",
    "capacity": 50
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 5
    }
  }
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-10-01

Update an elastic pool with preferred enclave type parameter as Default

範例要求

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2023-08-01

{
  "sku": {
    "name": "GP_Gen5_4"
  },
  "properties": {
    "preferredEnclaveType": "Default"
  }
}

範例回覆

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": "vcore,pool",
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 4
  },
  "properties": {
    "state": "Ready",
    "creationDate": "2022-08-26T03:46:20.57Z",
    "maxSizeBytes": 0,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 4
    },
    "zoneRedundant": false,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
    "preferredEnclaveType": "Default"
  }
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Update an elastic pool with preferred enclave type parameter as VBS

範例要求

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2023-08-01

{
  "sku": {
    "name": "GP_Gen5_4"
  },
  "properties": {
    "preferredEnclaveType": "VBS"
  }
}

範例回覆

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": "vcore,pool",
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 4
  },
  "properties": {
    "state": "Ready",
    "creationDate": "2022-08-26T03:46:20.57Z",
    "maxSizeBytes": 0,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 4
    },
    "zoneRedundant": false,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
    "preferredEnclaveType": "VBS"
  }
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Update an elastic pool with serverless properties

範例要求

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2023-08-01

{
  "sku": {
    "name": "GP_S_Gen5_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "minCapacity": 0.5,
    "autoPauseDelay": 60,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 2,
      "autoPauseDelay": 80
    }
  }
}

範例回覆

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "GP_S_Gen5_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "minCapacity": 0.5,
    "autoPauseDelay": 60,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 2,
      "autoPauseDelay": 80
    }
  }
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2023-05-01

Update high availability replica count of a Hyperscale elastic pool.

範例要求

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2023-08-01

{
  "properties": {
    "highAvailabilityReplicaCount": 2
  }
}

範例回覆

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": "vcore,pool",
  "sku": {
    "name": "HS_Gen5",
    "tier": "Hyperscale",
    "family": "Gen5",
    "capacity": 4
  },
  "properties": {
    "state": "Ready",
    "creationDate": "2021-08-26T03:46:20.57Z",
    "maxSizeBytes": 0,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 4
    },
    "zoneRedundant": false,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
    "highAvailabilityReplicaCount": 2
  }
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2021-08-01

定義

名稱 Description
AlwaysEncryptedEnclaveType

彈性集區上要求的記憶體保護區類型。

AvailabilityZoneType

指定集區主要複本釘選到的可用性區域。

ElasticPool

彈性集區。

ElasticPoolLicenseType

要套用此彈性集區的授權類型。

ElasticPoolPerDatabaseSettings

彈性集區的每個資料庫設定。

ElasticPoolState

彈性集區的狀態。

ElasticPoolUpdate

彈性集區更新。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

Sku

ARM 資源 SKU。

AlwaysEncryptedEnclaveType

彈性集區上要求的記憶體保護區類型。

Description
Default
VBS

AvailabilityZoneType

指定集區主要複本釘選到的可用性區域。

Description
1
2
3
NoPreference

ElasticPool

彈性集區。

名稱 類型 Description
id

string

資源標識碼。

kind

string

彈性集區種類。 這是用於 Azure 入口網站體驗的元數據。

location

string

資源位置。

name

string

資源名稱。

properties.autoPauseDelay

integer (int32)

彈性集區自動暫停的分鐘數。 -1 值表示已停用自動暫停

properties.availabilityZone

AvailabilityZoneType

指定集區主要複本釘選到的可用性區域。

properties.creationDate

string (date-time)

彈性集區的建立日期(ISO8601格式)。

properties.highAvailabilityReplicaCount

integer (int32)

與商務關鍵、進階或超大規模資料庫版本彈性集區相關聯的次要複本數目,這些復本可用來提供高可用性。 僅適用於超大規模彈性集區。

properties.licenseType

ElasticPoolLicenseType

要套用此彈性集區的授權類型。

properties.maintenanceConfigurationId

string

指派給彈性集區的維護組態標識碼。 此組態會定義將發生維護更新的期間。

properties.maxSizeBytes

integer (int64)

資料庫彈性集區的記憶體限制,以位元組為單位。

properties.minCapacity

number (double)

如果未暫停,無伺服器集區的最小容量將不會縮小到下方

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

彈性集區的每個資料庫設定。

properties.preferredEnclaveType

AlwaysEncryptedEnclaveType

彈性集區上要求的記憶體保護區類型。

properties.state

ElasticPoolState

彈性集區的狀態。

properties.zoneRedundant

boolean

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

sku

Sku

彈性集區 SKU。

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

az sql elastic-pool list-editions -l <location> -o table
tags

object

資源標籤。

type

string

資源類型。

ElasticPoolLicenseType

要套用此彈性集區的授權類型。

Description
BasePrice
LicenseIncluded

ElasticPoolPerDatabaseSettings

彈性集區的每個資料庫設定。

名稱 類型 Description
autoPauseDelay

integer (int32)

集區內每個資料庫的自動暫停延遲

maxCapacity

number (double)

任何一個資料庫都可以取用的最大容量。

minCapacity

number (double)

保證所有資料庫的最小容量。

ElasticPoolState

彈性集區的狀態。

Description
Creating
Disabled
Ready

ElasticPoolUpdate

彈性集區更新。

名稱 類型 Description
properties.autoPauseDelay

integer (int32)

彈性集區自動暫停的分鐘數。 -1 值表示已停用自動暫停

properties.availabilityZone

AvailabilityZoneType

指定集區主要複本釘選到的可用性區域。

properties.highAvailabilityReplicaCount

integer (int32)

與商務關鍵、進階或超大規模資料庫版本彈性集區相關聯的次要複本數目,這些復本可用來提供高可用性。 僅適用於超大規模彈性集區。

properties.licenseType

ElasticPoolLicenseType

要套用此彈性集區的授權類型。

properties.maintenanceConfigurationId

string

指派給彈性集區的維護組態標識碼。 此組態會定義將發生維護更新的期間。

properties.maxSizeBytes

integer (int64)

資料庫彈性集區的記憶體限制,以位元組為單位。

properties.minCapacity

number (double)

如果未暫停,無伺服器集區的最小容量將不會縮小到下方

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

彈性集區的每個資料庫設定。

properties.preferredEnclaveType

AlwaysEncryptedEnclaveType

彈性集區上要求的記憶體保護區類型。

properties.zoneRedundant

boolean

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

sku

Sku

ARM 資源 SKU。

tags

object

資源標籤。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細數據。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

error 物件。

Sku

ARM 資源 SKU。

名稱 類型 Description
capacity

integer (int32)

特定 SKU 的容量。

family

string

如果服務有不同世代的硬體,針對相同的 SKU,則可以在這裡擷取。

name

string

SKU 的名稱,通常是字母 + 數位碼,例如 P3。

size

string

特定 SKU 的大小

tier

string

特定 SKU 的階層或版本,例如基本、進階。