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 パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
elastic
|
path | True |
string |
エラスティック プールの名前。 |
resource
|
path | True |
string |
リソースが含まれているリソース グループの名前。 この値は、Azure リソース マネージャー API またはポータルから取得できます。 |
server
|
path | True |
string |
サーバーの名前。 |
subscription
|
path | True |
string |
Azure サブスクリプションを識別するサブスクリプション ID。 |
api-version
|
query | True |
string |
要求で使用する API のバージョン。 |
要求本文
名前 | 必須 | 型 | 説明 |
---|---|---|---|
location | True |
string |
リソースの場所。 |
properties.highAvailabilityReplicaCount |
integer |
高可用性を提供するために使用されるエラスティック プールに関連付けられているセカンダリ レプリカの数。 Hyperscale エラスティック プールにのみ適用されます。 |
|
properties.licenseType |
このエラスティック プールに適用するライセンスの種類。 |
||
properties.maintenanceConfigurationId |
string |
エラスティック プールに割り当てられたメンテナンス構成 ID。 この構成では、メンテナンス更新が発生する期間を定義します。 |
|
properties.maxSizeBytes |
integer |
データベース エラスティック プールのストレージ制限 (バイト単位)。 |
|
properties.minCapacity |
number |
一時停止されていない場合、サーバーレス プールが以下に縮小しない最小容量 |
|
properties.perDatabaseSettings |
エラスティック プールのデータベースごとの設定。 |
||
properties.zoneRedundant |
boolean |
このエラスティック プールがゾーン冗長であるかどうか。つまり、このエラスティック プールのレプリカは複数の可用性ゾーンに分散されます。 |
|
sku |
エラスティック プール SKU。 SKU の一覧は、リージョンとサポート オファーによって異なる場合があります。 Azure リージョンのサブスクリプションで使用できる SKU (SKU 名、レベル/エディション、ファミリ、容量を含む) を確認するには、REST API または次のコマンドを使用
|
||
tags |
object |
リソース タグ。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
エラスティック プールを更新しました |
|
201 Created |
エラスティック プールを作成しました |
|
202 Accepted |
同意 |
|
Other Status Codes |
エラー応答: ***
|
例
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
要求のサンプル
応答のサンプル
{
"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
}
}
定義
名前 | 説明 |
---|---|
Elastic |
エラスティック プール。 |
Elastic |
このエラスティック プールに適用するライセンスの種類。 |
Elastic |
エラスティック プールのデータベースごとの設定。 |
Elastic |
エラスティック プールの状態。 |
Sku |
ARM リソース SKU。 |
ElasticPool
エラスティック プール。
名前 | 型 | 説明 |
---|---|---|
id |
string |
リソースの ID |
kind |
string |
エラスティック プールの種類。 これは、Azure portal エクスペリエンスに使用されるメタデータです。 |
location |
string |
リソースの場所。 |
name |
string |
リソース名。 |
properties.creationDate |
string |
エラスティック プールの作成日 (ISO8601形式)。 |
properties.highAvailabilityReplicaCount |
integer |
高可用性を提供するために使用されるエラスティック プールに関連付けられているセカンダリ レプリカの数。 Hyperscale エラスティック プールにのみ適用されます。 |
properties.licenseType |
このエラスティック プールに適用するライセンスの種類。 |
|
properties.maintenanceConfigurationId |
string |
エラスティック プールに割り当てられたメンテナンス構成 ID。 この構成では、メンテナンス更新が発生する期間を定義します。 |
properties.maxSizeBytes |
integer |
データベース エラスティック プールのストレージ制限 (バイト単位)。 |
properties.minCapacity |
number |
一時停止されていない場合、サーバーレス プールが以下に縮小しない最小容量 |
properties.perDatabaseSettings |
エラスティック プールのデータベースごとの設定。 |
|
properties.state |
エラスティック プールの状態。 |
|
properties.zoneRedundant |
boolean |
このエラスティック プールがゾーン冗長であるかどうか。つまり、このエラスティック プールのレプリカは複数の可用性ゾーンに分散されます。 |
sku |
エラスティック プール SKU。 SKU の一覧は、リージョンとサポート オファーによって異なる場合があります。 Azure リージョンのサブスクリプションで使用できる SKU (SKU 名、レベル/エディション、ファミリ、容量を含む) を確認するには、REST API または次のコマンドを使用
|
|
tags |
object |
リソース タグ。 |
type |
string |
リソースの種類。 |
ElasticPoolLicenseType
このエラスティック プールに適用するライセンスの種類。
名前 | 型 | 説明 |
---|---|---|
BasePrice |
string |
|
LicenseIncluded |
string |
ElasticPoolPerDatabaseSettings
エラスティック プールのデータベースごとの設定。
名前 | 型 | 説明 |
---|---|---|
maxCapacity |
number |
1 つのデータベースで使用できる最大容量。 |
minCapacity |
number |
すべてのデータベースの最小容量が保証されます。 |
ElasticPoolState
エラスティック プールの状態。
名前 | 型 | 説明 |
---|---|---|
Creating |
string |
|
Disabled |
string |
|
Ready |
string |
Sku
ARM リソース SKU。
名前 | 型 | 説明 |
---|---|---|
capacity |
integer |
特定の SKU の容量。 |
family |
string |
同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。 |
name |
string |
SKU の名前 。通常は、文字 + 数値コード (P3 など)。 |
size |
string |
特定の SKU のサイズ |
tier |
string |
特定の SKU のレベルまたはエディション (Basic、Premium など)。 |