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 |
---|---|---|---|---|
elastic
|
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 |
---|---|---|
properties.autoPauseDelay |
integer (int32) |
彈性集區自動暫停的分鐘數。 -1 值表示已停用自動暫停 |
properties.availabilityZone |
指定集區主要複本釘選到的可用性區域。 |
|
properties.highAvailabilityReplicaCount |
integer (int32) |
與商務關鍵、進階或超大規模資料庫版本彈性集區相關聯的次要複本數目,這些復本可用來提供高可用性。 僅適用於超大規模彈性集區。 |
properties.licenseType |
要套用此彈性集區的授權類型。 |
|
properties.maintenanceConfigurationId |
string |
指派給彈性集區的維護組態標識碼。 此組態會定義將發生維護更新的期間。 |
properties.maxSizeBytes |
integer (int64) |
資料庫彈性集區的記憶體限制,以位元組為單位。 |
properties.minCapacity |
number (double) |
如果未暫停,無伺服器集區的最小容量將不會縮小到下方 |
properties.perDatabaseSettings |
彈性集區的每個資料庫設定。 |
|
properties.preferredEnclaveType |
彈性集區上要求的記憶體保護區類型。 |
|
properties.zoneRedundant |
boolean |
此彈性集區是否為區域備援,這表示此彈性集區的複本會分散到多個可用性區域。 |
sku |
ARM 資源 SKU。 |
|
tags |
object |
資源標籤。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
已更新彈性集區 |
|
202 Accepted |
接受 標題 Location: string |
|
Other Status Codes |
錯誤回應: ***
|
範例
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 |
---|---|
Always |
彈性集區上要求的記憶體保護區類型。 |
Availability |
指定集區主要複本釘選到的可用性區域。 |
Elastic |
彈性集區。 |
Elastic |
要套用此彈性集區的授權類型。 |
Elastic |
彈性集區的每個資料庫設定。 |
Elastic |
彈性集區的狀態。 |
Elastic |
彈性集區更新。 |
Error |
資源管理錯誤其他資訊。 |
Error |
錯誤詳細數據。 |
Error |
錯誤回應 |
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 |
指定集區主要複本釘選到的可用性區域。 |
|
properties.creationDate |
string (date-time) |
彈性集區的建立日期(ISO8601格式)。 |
properties.highAvailabilityReplicaCount |
integer (int32) |
與商務關鍵、進階或超大規模資料庫版本彈性集區相關聯的次要複本數目,這些復本可用來提供高可用性。 僅適用於超大規模彈性集區。 |
properties.licenseType |
要套用此彈性集區的授權類型。 |
|
properties.maintenanceConfigurationId |
string |
指派給彈性集區的維護組態標識碼。 此組態會定義將發生維護更新的期間。 |
properties.maxSizeBytes |
integer (int64) |
資料庫彈性集區的記憶體限制,以位元組為單位。 |
properties.minCapacity |
number (double) |
如果未暫停,無伺服器集區的最小容量將不會縮小到下方 |
properties.perDatabaseSettings |
彈性集區的每個資料庫設定。 |
|
properties.preferredEnclaveType |
彈性集區上要求的記憶體保護區類型。 |
|
properties.state |
彈性集區的狀態。 |
|
properties.zoneRedundant |
boolean |
此彈性集區是否為區域備援,這表示此彈性集區的複本會分散到多個可用性區域。 |
sku |
彈性集區 SKU。 SKU 清單可能會因區域和支援供應項目而異。 若要判斷 Azure 區域中訂用帳戶可用的 SKU(包括 SKU 名稱、層/版本、系列和容量),請使用
|
|
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 |
指定集區主要複本釘選到的可用性區域。 |
|
properties.highAvailabilityReplicaCount |
integer (int32) |
與商務關鍵、進階或超大規模資料庫版本彈性集區相關聯的次要複本數目,這些復本可用來提供高可用性。 僅適用於超大規模彈性集區。 |
properties.licenseType |
要套用此彈性集區的授權類型。 |
|
properties.maintenanceConfigurationId |
string |
指派給彈性集區的維護組態標識碼。 此組態會定義將發生維護更新的期間。 |
properties.maxSizeBytes |
integer (int64) |
資料庫彈性集區的記憶體限制,以位元組為單位。 |
properties.minCapacity |
number (double) |
如果未暫停,無伺服器集區的最小容量將不會縮小到下方 |
properties.perDatabaseSettings |
彈性集區的每個資料庫設定。 |
|
properties.preferredEnclaveType |
彈性集區上要求的記憶體保護區類型。 |
|
properties.zoneRedundant |
boolean |
此彈性集區是否為區域備援,這表示此彈性集區的複本會分散到多個可用性區域。 |
sku |
ARM 資源 SKU。 |
|
tags |
object |
資源標籤。 |
ErrorAdditionalInfo
資源管理錯誤其他資訊。
名稱 | 類型 | Description |
---|---|---|
info |
object |
其他資訊。 |
type |
string |
其他信息類型。 |
ErrorDetail
錯誤詳細數據。
名稱 | 類型 | Description |
---|---|---|
additionalInfo |
錯誤其他資訊。 |
|
code |
string |
錯誤碼。 |
details |
錯誤詳細數據。 |
|
message |
string |
錯誤訊息。 |
target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
名稱 | 類型 | Description |
---|---|---|
error |
error 物件。 |
Sku
ARM 資源 SKU。
名稱 | 類型 | Description |
---|---|---|
capacity |
integer (int32) |
特定 SKU 的容量。 |
family |
string |
如果服務有不同世代的硬體,針對相同的 SKU,則可以在這裡擷取。 |
name |
string |
SKU 的名稱,通常是字母 + 數位碼,例如 P3。 |
size |
string |
特定 SKU 的大小 |
tier |
string |
特定 SKU 的階層或版本,例如基本、進階。 |