共用方式為


Elastic Pools - Create Or Update

建立或更新彈性集區。

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

URI 參數

名稱 位於 必要 類型 Description
elasticPoolName
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
location True

string

資源位置。

properties.highAvailabilityReplicaCount

integer

與彈性集區相關聯的次要複本數目,可用來提供高可用性。 僅適用於超大規模彈性集區。

properties.licenseType

ElasticPoolLicenseType

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

properties.maintenanceConfigurationId

string

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

properties.maxSizeBytes

integer

資料庫彈性集區的儲存限制,以位元組為單位。

properties.minCapacity

number

無伺服器集區在未暫停的情況下,不會縮小的最小容量

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

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

properties.zoneRedundant

boolean

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

sku

Sku

彈性集區 SKU。

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

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

object

資源標籤。

回應

名稱 類型 Description
200 OK

ElasticPool

已更新彈性集區

201 Created

ElasticPool

已建立彈性集區

202 Accepted

已接受

Other Status Codes

錯誤回應: ≦

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

  • 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 min。

  • 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 ElasticPoolStorageAboveLimitMB - 嘗試將彈性集區記憶體限制設定為低於支援的限制。

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

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

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

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

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

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

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

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

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

  • 400 ElasticPoolDbVcoreMaxBelowLimit - 針對要求的彈性集區服務層級,每個資料庫 VCore 要求的數目太低。

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

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

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

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

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

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

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

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

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

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

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

  • 400 InvalidSkuName - 無效的 SKU 名稱。

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

  • 400 不符SkuNameAndTier - SKU 名稱和層之間的不符。

  • 400 不符SkuNameAndFamily - SKU 名稱和系列之間的不符。

  • 400 不符SubscriptionWithUrl - 提供的訂用帳戶不符合 URL 中的訂用帳戶。

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

  • 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 min。

  • 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 ElasticPoolStorageAboveLimitMB - 嘗試將彈性集區記憶體限制設定為低於支援的限制。

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

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

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

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

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

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

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

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

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

  • 400 ElasticPoolDbVcoreMaxBelowLimit - 針對要求的彈性集區服務層級,每個資料庫 VCore 要求的數目太低。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • 405 NotSupported - 不支援此功能。

  • 405 NotSupported - 不支援此功能。

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

  • 409 ServerDisabled - 伺服器已停用。

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

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

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

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

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

  • 409 ServerDisabled - 伺服器已停用。

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

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

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

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

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

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

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

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

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

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

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

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

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

範例

Create or update elastic pool with all parameter
Create or update elastic pool with maintenance configuration parameter
Create or update elastic pool with minimum parameters
Create or update Hyperscale elastic pool with high availability replica count parameter

Create or update elastic pool with all parameter

範例要求

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

{
  "location": "Japan East",
  "sku": {
    "name": "GP_Gen4_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 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": null,
  "sku": {
    "name": "GP_Gen4_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 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": null,
  "sku": {
    "name": "GP_Gen4_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 2
    }
  }
}

Create or update elastic pool with maintenance configuration parameter

範例要求

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

{
  "location": "Japan East",
  "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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    },
    "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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    },
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

Create or update elastic pool with minimum parameters

範例要求

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

{
  "location": "Japan East"
}

範例回覆

{
  "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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    }
  }
}
{
  "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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    }
  }
}

Create or update Hyperscale elastic pool with high availability replica count parameter

範例要求

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

{
  "location": "Japan East",
  "sku": {
    "name": "HS_Gen5_4"
  },
  "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
  }
}
{
  "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
  }
}

定義

名稱 Description
ElasticPool

彈性集區。

ElasticPoolLicenseType

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

ElasticPoolPerDatabaseSettings

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

ElasticPoolState

彈性集區的狀態。

Sku

ARM 資源 SKU。

ElasticPool

彈性集區。

名稱 類型 Description
id

string

資源識別碼。

kind

string

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

location

string

資源位置。

name

string

資源名稱。

properties.creationDate

string

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

properties.highAvailabilityReplicaCount

integer

與彈性集區相關聯的次要複本數目,可用來提供高可用性。 僅適用於超大規模彈性集區。

properties.licenseType

ElasticPoolLicenseType

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

properties.maintenanceConfigurationId

string

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

properties.maxSizeBytes

integer

資料庫彈性集區的儲存限制,以位元組為單位。

properties.minCapacity

number

無伺服器集區在未暫停的情況下,不會縮小的最小容量

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

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

properties.state

ElasticPoolState

彈性集區的狀態。

properties.zoneRedundant

boolean

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

sku

Sku

彈性集區 SKU。

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

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

object

資源標籤。

type

string

資源類型。

ElasticPoolLicenseType

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

名稱 類型 Description
BasePrice

string

LicenseIncluded

string

ElasticPoolPerDatabaseSettings

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

名稱 類型 Description
maxCapacity

number

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

minCapacity

number

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

ElasticPoolState

彈性集區的狀態。

名稱 類型 Description
Creating

string

Disabled

string

Ready

string

Sku

ARM 資源 SKU。

名稱 類型 Description
capacity

integer

特定 SKU 的容量。

family

string

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

name

string

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

size

string

特定 SKU 的大小

tier

string

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