Elastic Pools - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

Membuat atau memperbarui kumpulan elastis.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
elasticPoolName	path	True	string	Nama kumpulan elastis.
resourceGroupName	path	True	string	Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.
serverName	path	True	string	Nama server.
subscriptionId	path	True	string	ID langganan yang mengidentifikasi langganan Azure.
api-version	query	True	string	Versi API yang digunakan untuk permintaan.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
location	True	string	Lokasi sumber daya.
properties.highAvailabilityReplicaCount		integer	Jumlah replika sekunder yang terkait dengan kumpulan elastis yang digunakan untuk memberikan ketersediaan tinggi. Hanya berlaku untuk kumpulan elastis Hyperscale.
properties.licenseType		ElasticPoolLicenseType	Jenis lisensi yang akan diterapkan untuk kumpulan elastis ini.
properties.maintenanceConfigurationId		string	Id konfigurasi pemeliharaan yang ditetapkan ke kumpulan elastis. Konfigurasi ini menentukan periode kapan pembaruan pemeliharaan akan terjadi.
properties.maxSizeBytes		integer	Batas penyimpanan untuk kumpulan elastis database dalam byte.
properties.minCapacity		number	Kapasitas minimal yang tidak akan menyusut di bawah ini, jika tidak dijeda
properties.perDatabaseSettings		ElasticPoolPerDatabaseSettings	Pengaturan per database untuk kumpulan elastis.
properties.zoneRedundant		boolean	Apakah kumpulan elastis ini zona redundan atau tidak, yang berarti replika kumpulan elastis ini akan tersebar di beberapa zona ketersediaan.
sku		Sku	SKU kumpulan elastis. Daftar SKU dapat bervariasi menurut wilayah dan penawaran dukungan. Untuk menentukan SKU (termasuk nama SKU, tingkat/edisi, keluarga, dan kapasitas) yang tersedia untuk langganan Anda di wilayah Azure, gunakan Capabilities_ListByLocation REST API atau perintah berikut: az sql elastic-pool list-editions -l <location> -o table
tags		object	Tag sumber daya.

Respons

Nama	Jenis	Deskripsi
200 OK	ElasticPool	Memperbarui kumpulan elastis
201 Created	ElasticPool	Membuat kumpulan elastis
202 Accepted		Diterima
Other Status Codes		Respons Kesalahan: *** 400 ElasticPoolOverStorageUsage - Mencoba menulis data ke database ketika batas penyimpanan kumpulan elastis telah tercapai. 400 InvalidSku - Pengguna menentukan sku yang tidak valid. 400 InvalidTierSkuCombination - Tingkat yang ditentukan tidak mendukung sku yang ditentukan. 400 ServerQuotaExceeded - Server mencapai batasnya untuk Unit Throughput Database yang diizinkan. 400 ElasticPoolAlreadyExists - Server sudah berisi kumpulan elastis dengan nama yang ditentukan. 400 SubscriptionVcoreQuotaExceeded - Tidak dapat melakukan operasi karena langganan akan melebihi kuota vCore yang diizinkan. 400 InvalidInputValueForEdition - Edisi yang ditentukan tidak didukung untuk provisi kumpulan elastis. 400 ElasticPoolDtuBelowLimit - Nilai DTU yang diminta terlalu rendah untuk tingkat layanan kumpulan elastis yang diminta. 400 ElasticPoolDtuAboveLimit - Nilai DTU yang diminta terlalu tinggi untuk tingkat layanan kumpulan elastis yang diminta. 400 InvalidMaxSize - Ukuran maksimum tidak valid. 400 ElasticPoolDbDtuMaxBelowLimit - DTU max per database yang diminta terlalu rendah untuk tingkat layanan kumpulan elastis yang diminta. 400 ElasticPoolDbDtuMaxAboveLimit - DTU max per database yang diminta terlalu tinggi untuk tingkat layanan kumpulan elastis yang diminta. 400 InvalidInputValueForDatabaseDtuMax - Mencoba mengatur DTU max per database untuk Kumpulan Sumber Daya yang tidak cocok dengan nilai yang diizinkan. 400 ElasticPoolDbDtuMinAboveLimit - DTU min yang diminta per database terlalu tinggi untuk tingkat layanan yang diminta. 400 ElasticPoolOverStorage - Mencoba menulis data ke database ketika batas penyimpanan kumpulan elastis telah tercapai. 400 InvalidInputValueForDatabaseDtuMin - Mencoba mengatur DTU min per database untuk Kumpulan Sumber Daya yang tidak cocok dengan nilai yang diizinkan. 400 ElasticPoolInconsistentDtuGuaranteeSettings - Mencoba menyediakan DTU min untuk database di kumpulan elastis yang melebihi DTU yang diminta dari kumpulan elastis. 400 ElasticPoolDtuUnsupported - Pengguna mencoba membuat atau memperbarui kumpulan elastis dengan kapasitas DTU yang tidak didukung. 400 ElasticPoolStorageAboveLimitGB - Mencoba mengatur batas penyimpanan kumpulan elastis di bawah batas yang didukung. 400 ElasticPoolsNotEnabled - Kumpulan elastis belum diaktifkan di wilayah ini. 400 ElasticPoolNotEmpty - Permintaan untuk menghapus kumpulan elastis yang tidak kosong. 400 ElasticPoolStorageBelowLimitGB - Mencoba mengatur batas penyimpanan kumpulan elastis di bawah batas yang didukung. 400 ElasticPoolStorageNotAllowedGB - Mencoba mengatur batas penyimpanan kumpulan elastis dalam gb yang tidak cocok dengan nilai yang diizinkan. 400 ElasticPoolDatabaseLimit - Kumpulan elastis telah mencapai batas jumlah database. 400 ElasticPoolDecreaseStorageLimitBelowUsage - Mencoba mengurangi batas penyimpanan kumpulan elastis di bawah penggunaan penyimpanannya. 400 InvalidInputValueDatabaseDtuMinLargerThanMax - Mencoba mengatur DTU min per database lebih tinggi dari DTU max per database. 400 ElasticPoolInconsistentVcoreGuaranteeSettings - Jumlah database dan VCore min per database tidak dapat melebihi VCore yang diminta dari kumpulan elastis. 400 ElasticPoolStorageBelowLimitMB - Mencoba mengatur batas penyimpanan kumpulan elastis di bawah batas yang didukung. 400 ElasticPoolStorageNotAllowedMB - Mencoba mengatur batas penyimpanan kumpulan elastis dalam mb yang tidak cocok dengan nilai yang diizinkan. 400 ElasticPoolCapacityStorageNotAllowedMB - Mencoba mengatur batas penyimpanan kumpulan elastis dalam mb yang tidak cocok dengan nilai yang diizinkan. 400 ElasticPoolStorageAboveLimitMB - Mencoba mengatur batas penyimpanan kumpulan elastis di bawah batas yang didukung. 400 RegionDoesNotSupportVersion - Pengguna mencoba membuat server dari versi tertentu di lokasi di mana versi server tersebut tidak didukung. 400 InvalidTier - Pengguna menentukan tingkat yang tidak valid. 400 SourceDatabaseEditionCouldNotBeUpgraded - Database sumber tidak boleh memiliki edisi yang lebih tinggi daripada database target. 400 TargetDatabaseEditionCouldNotBeDowngraded - Database target tidak boleh memiliki edisi yang lebih rendah daripada database sumber. 400 ElasticPoolUpdateHkNotAllowed - Kumpulan elastis tidak dapat menurunkan tingkat layanannya dari Premium ke Standar atau Dasar karena satu atau beberapa databasenya menggunakan objek yang dioptimalkan memori. 400 UpdateNotAllowedIfGeoDrOperationInProgress - Operasi tidak diizinkan karena operasi salin atau failover untuk database '{0}' di server '{1}' saat ini sedang berlangsung. 400 RegionDoesNotAllowProvisioning - Lokasi yang dipilih tidak menerima server Windows Azure SQL Database baru. Ini dapat berubah di lain waktu. 400 ElasticPoolOverFileSpace - Ruang file yang tidak memadai di kumpulan elastis. 400 ElasticPoolDbDtuMinBelowLimit - DTU min per database yang diminta terlalu rendah untuk tingkat layanan kumpulan elastis yang diminta. 400 ElasticPoolDbVcoreMaxBelowLimit - Maksimum VCore per database yang diminta terlalu rendah untuk tingkat layanan kumpulan elastis yang diminta. 400 ElasticPoolDbVcoreMaxAboveLimit - Maksimum VCore per database yang diminta terlalu tinggi untuk tingkat layanan kumpulan elastis yang diminta. 400 InvalidInputValueForDatabaseVcoreMax - Mencoba mengatur VCore max per database untuk Kumpulan Sumber Daya yang tidak cocok dengan nilai yang diizinkan. 400 ElasticPoolDbVcoreMinBelowLimit - VCore min per database yang diminta terlalu rendah untuk tingkat layanan kumpulan elastis yang diminta. 400 InvalidInputValueForDatabaseVcoreMin - Mencoba mengatur VCore min per database untuk Kumpulan Sumber Daya yang tidak cocok dengan nilai yang diizinkan. 400 PartnerDBNotCompatibleForSGXEnclave - Mencoba mengatur tautan GeoDR atau memperbarui SLO untuk database yang diaktifkan enklave hanya didukung ketika kedua database berjalan pada perangkat keras seri DC. 400 InvalidInputValueDatabaseVcoreMinLargerThanMax - Mencoba mengatur VCore min per database lebih tinggi dari VCore max per database. 400 InvalidLicenseType - Pengguna mencoba membuat atau memperbarui database atau kumpulan elastis dengan jenis lisensi yang tidak didukung. 400 ProvisioningDisabled - Menampilkan pesan kesalahan dari otorisasi operasi sumber daya apa adanya, tanpa perubahan 400 InvalidPublicMaintenanceConfiguration - Pengguna mencoba menentukan konfigurasi pemeliharaan publik yang tidak dapat dikonversi ke id internal (salah bentuk atau wilayah yang salah). 400 InvalidResourceRequestBody - Properti sumber daya atau sumber daya dalam isi permintaan kosong atau tidak valid. 400 InvalidResourceId - Pengidentifikasi sumber daya tidak valid. 400 InvalidSkuName - Nama SKU tidak valid. 400 MismatchedSkuNameAndCapacity - Ketidakcocokan antara nama dan kapasitas SKU. 400 MismatchedSkuNameAndTier - Ketidakcocokan antara nama dan tingkat SKU. 400 MismatchedSkuNameAndFamily - Ketidakcocokan antara nama SKU dan keluarga. 400 MismatchingSubscriptionWithUrl - Langganan yang disediakan tidak cocok dengan langganan di Url. 400 ElasticPoolOverStorageUsage - Mencoba menulis data ke database ketika batas penyimpanan kumpulan elastis telah tercapai. 400 InvalidSku - Pengguna menentukan sku yang tidak valid. 400 InvalidTierSkuCombination - Tingkat yang ditentukan tidak mendukung sku yang ditentukan. 400 ServerQuotaExceeded - Server mencapai batasnya untuk Unit Throughput Database yang diizinkan. 400 ElasticPoolAlreadyExists - Server sudah berisi kumpulan elastis dengan nama yang ditentukan. 400 SubscriptionVcoreQuotaExceeded - Tidak dapat melakukan operasi karena langganan akan melebihi kuota vCore yang diizinkan. 400 InvalidInputValueForEdition - Edisi yang ditentukan tidak didukung untuk provisi kumpulan elastis. 400 ElasticPoolDtuBelowLimit - Nilai DTU yang diminta terlalu rendah untuk tingkat layanan kumpulan elastis yang diminta. 400 ElasticPoolDtuAboveLimit - Nilai DTU yang diminta terlalu tinggi untuk tingkat layanan kumpulan elastis yang diminta. 400 InvalidMaxSize - Ukuran maksimum tidak valid. 400 ElasticPoolDbDtuMaxBelowLimit - DTU max per database yang diminta terlalu rendah untuk tingkat layanan kumpulan elastis yang diminta. 400 ElasticPoolDbDtuMaxAboveLimit - DTU max per database yang diminta terlalu tinggi untuk tingkat layanan kumpulan elastis yang diminta. 400 InvalidInputValueForDatabaseDtuMax - Mencoba mengatur DTU max per database untuk Kumpulan Sumber Daya yang tidak cocok dengan nilai yang diizinkan. 400 ElasticPoolDbDtuMinAboveLimit - DTU min yang diminta per database terlalu tinggi untuk tingkat layanan yang diminta. 400 ElasticPoolOverStorage - Mencoba menulis data ke database ketika batas penyimpanan kumpulan elastis telah tercapai. 400 InvalidInputValueForDatabaseDtuMin - Mencoba mengatur DTU min per database untuk Kumpulan Sumber Daya yang tidak cocok dengan nilai yang diizinkan. 400 ElasticPoolInconsistentDtuGuaranteeSettings - Mencoba menyediakan DTU min untuk database di kumpulan elastis yang melebihi DTU yang diminta dari kumpulan elastis. 400 ElasticPoolDtuUnsupported - Pengguna mencoba membuat atau memperbarui kumpulan elastis dengan kapasitas DTU yang tidak didukung. 400 ElasticPoolStorageAboveLimitGB - Mencoba mengatur batas penyimpanan kumpulan elastis di bawah batas yang didukung. 400 ElasticPoolsNotEnabled - Kumpulan elastis belum diaktifkan di wilayah ini. 400 ElasticPoolNotEmpty - Permintaan untuk menghapus kumpulan elastis yang tidak kosong. 400 ElasticPoolStorageBelowLimitGB - Mencoba mengatur batas penyimpanan kumpulan elastis di bawah batas yang didukung. 400 ElasticPoolStorageNotAllowedGB - Mencoba mengatur batas penyimpanan kumpulan elastis dalam gb yang tidak cocok dengan nilai yang diizinkan. 400 ElasticPoolDatabaseLimit - Kumpulan elastis telah mencapai batas jumlah database. 400 ElasticPoolDecreaseStorageLimitBelowUsage - Mencoba mengurangi batas penyimpanan kumpulan elastis di bawah penggunaan penyimpanannya. 400 InvalidInputValueDatabaseDtuMinLargerThanMax - Mencoba mengatur DTU min per database lebih tinggi dari DTU max per database. 400 ElasticPoolInconsistentVcoreGuaranteeSettings - Jumlah database dan VCore min per database tidak dapat melebihi VCore yang diminta dari kumpulan elastis. 400 ElasticPoolStorageBelowLimitMB - Mencoba mengatur batas penyimpanan kumpulan elastis di bawah batas yang didukung. 400 ElasticPoolStorageNotAllowedMB - Mencoba mengatur batas penyimpanan kumpulan elastis dalam mb yang tidak cocok dengan nilai yang diizinkan. 400 ElasticPoolCapacityStorageNotAllowedMB - Mencoba mengatur batas penyimpanan kumpulan elastis dalam mb yang tidak cocok dengan nilai yang diizinkan. 400 ElasticPoolStorageAboveLimitMB - Mencoba mengatur batas penyimpanan kumpulan elastis di bawah batas yang didukung. 400 RegionDoesNotSupportVersion - Pengguna mencoba membuat server dari versi tertentu di lokasi di mana versi server tersebut tidak didukung. 400 InvalidTier - Pengguna menentukan tingkat yang tidak valid. 400 SourceDatabaseEditionCouldNotBeUpgraded - Database sumber tidak boleh memiliki edisi yang lebih tinggi daripada database target. 400 TargetDatabaseEditionCouldNotBeDowngraded - Database target tidak boleh memiliki edisi yang lebih rendah daripada database sumber. 400 ElasticPoolUpdateHkNotAllowed - Kumpulan elastis tidak dapat menurunkan tingkat layanannya dari Premium ke Standar atau Dasar karena satu atau beberapa databasenya menggunakan objek yang dioptimalkan memori. 400 UpdateNotAllowedIfGeoDrOperationInProgress - Operasi tidak diizinkan karena operasi salin atau failover untuk database '{0}' di server '{1}' saat ini sedang berlangsung. 400 RegionDoesNotAllowProvisioning - Lokasi yang dipilih tidak menerima server Windows Azure SQL Database baru. Ini dapat berubah di lain waktu. 400 ElasticPoolOverFileSpace - Ruang file yang tidak memadai di kumpulan elastis. 400 ElasticPoolDbDtuMinBelowLimit - DTU min per database yang diminta terlalu rendah untuk tingkat layanan kumpulan elastis yang diminta. 400 ElasticPoolDbVcoreMaxBelowLimit - Maksimum VCore per database yang diminta terlalu rendah untuk tingkat layanan kumpulan elastis yang diminta. 400 ElasticPoolDbVcoreMaxAboveLimit - Maksimum VCore per database yang diminta terlalu tinggi untuk tingkat layanan kumpulan elastis yang diminta. 400 InvalidInputValueForDatabaseVcoreMax - Mencoba mengatur VCore max per database untuk Kumpulan Sumber Daya yang tidak cocok dengan nilai yang diizinkan. 400 ElasticPoolDbVcoreMinBelowLimit - VCore min per database yang diminta terlalu rendah untuk tingkat layanan kumpulan elastis yang diminta. 400 InvalidInputValueForDatabaseVcoreMin - Mencoba mengatur VCore min per database untuk Kumpulan Sumber Daya yang tidak cocok dengan nilai yang diizinkan. 400 PartnerDBNotCompatibleForSGXEnclave - Mencoba mengatur tautan GeoDR atau memperbarui SLO untuk database yang diaktifkan enklave hanya didukung ketika kedua database berjalan pada perangkat keras seri DC. 400 InvalidInputValueDatabaseVcoreMinLargerThanMax - Mencoba mengatur VCore min per database lebih tinggi dari VCore max per database. 400 InvalidLicenseType - Pengguna mencoba membuat atau memperbarui database atau kumpulan elastis dengan jenis lisensi yang tidak didukung. 400 ProvisioningDisabled - Menampilkan pesan kesalahan dari otorisasi operasi sumber daya apa adanya, tanpa perubahan 400 InvalidPublicMaintenanceConfiguration - Pengguna mencoba menentukan konfigurasi pemeliharaan publik yang tidak dapat dikonversi ke id internal (salah bentuk atau wilayah yang salah). 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan. 404 ElasticPoolNotFound - Kumpulan elastis yang ditentukan tidak ada untuk server yang ditentukan. 404 OperationIdNotFound - Operasi dengan Id tidak ada. 404 ElasticPoolNotFound - Kumpulan elastis yang ditentukan tidak ada untuk server yang ditentukan. 405 NotSupported - Fungsionalitas ini tidak didukung. 405 NotSupported - Fungsionalitas ini tidak didukung. 409 ElasticPoolBusy - Operasi manajemen dicoba pada kumpulan elastis yang sibuk. 409 ServerDisabled - Server dinonaktifkan. 409 SimultaneousSkuChangeNotAllowed - Operasi perubahan tujuan layanan tidak dapat berjalan pada kedua database hubungan replikasi secara bersamaan. 409 ElasticPoolUpdateLinksNotInCatchup - Tidak dapat memperbarui kumpulan elastis saat salah satu databasenya melakukan operasi failover salinan atau replikasi geografis. 409 OperationCancelled - Operasi telah dibatalkan oleh pengguna. 409 OperationInterrupted - Operasi pada sumber daya tidak dapat diselesaikan karena terganggu oleh operasi lain pada sumber daya yang sama. 409 ElasticPoolBusy - Operasi manajemen dicoba pada kumpulan elastis yang sibuk. 409 ServerDisabled - Server dinonaktifkan. 409 SimultaneousSkuChangeNotAllowed - Operasi perubahan tujuan layanan tidak dapat berjalan pada kedua database hubungan replikasi secara bersamaan. 409 ElasticPoolUpdateLinksNotInCatchup - Tidak dapat memperbarui kumpulan elastis saat salah satu databasenya melakukan operasi failover salinan atau replikasi geografis. 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 500 ElasticPoolFailedMoveDbToElasticPool - Gagal memindahkan database ke kumpulan elastis karena kendala sumber daya internal. Ini mungkin kondisi sementara, silakan coba lagi. 500 OperationTimedOut - Waktu operasi habis dan secara otomatis digulung balik. Coba lagi operasi ini. 500 ElasticPoolFailedMoveDbToElasticPool - Gagal memindahkan database ke kumpulan elastis karena kendala sumber daya internal. Ini mungkin kondisi sementara, silakan coba lagi. 503 ServiceTemporarilyUnavailable - Fitur untuk sementara tidak tersedia. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 503 ServiceTemporarilyUnavailable - Fitur untuk sementara tidak tersedia. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

Contoh

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

Sample Request

HTTP

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
    }
  }
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ElasticPoolInner;
import com.azure.resourcemanager.sql.models.ElasticPoolPerDatabaseSettings;
import com.azure.resourcemanager.sql.models.Sku;

/** Samples for ElasticPools CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ElasticPoolCreateOrUpdateMax.json
     */
    /**
     * Sample code: Create or update elastic pool with all parameter.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateElasticPoolWithAllParameter(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().createOrUpdate("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102",
            new ElasticPoolInner().withLocation("Japan East")
                .withSku(new Sku().withName("GP_Gen4_2").withTier("GeneralPurpose").withCapacity(2))
                .withPerDatabaseSettings(
                    new ElasticPoolPerDatabaseSettings().withMinCapacity(0.25D).withMaxCapacity(2.0D)),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "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
    }
  }
}

Status code:

201

{
  "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
    }
  }
}

Status code:

202

Create or update elastic pool with maintenance configuration parameter

Sample Request

HTTP

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"
  }
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ElasticPoolInner;

/** Samples for ElasticPools CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ElasticPoolCreateOrUpdateSetMaintenanceConfiguration.json
     */
    /**
     * Sample code: Create or update elastic pool with maintenance configuration parameter.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateElasticPoolWithMaintenanceConfigurationParameter(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().createOrUpdate("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102",
            new ElasticPoolInner().withLocation("Japan East").withMaintenanceConfigurationId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "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"
  }
}

Status code:

201

{
  "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"
  }
}

Status code:

202

Create or update elastic pool with minimum parameters

Sample Request

HTTP

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"
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ElasticPoolInner;

/** Samples for ElasticPools CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ElasticPoolCreateOrUpdateMin.json
     */
    /**
     * Sample code: Create or update elastic pool with minimum parameters.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createOrUpdateElasticPoolWithMinimumParameters(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().createOrUpdate("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102", new ElasticPoolInner().withLocation("Japan East"), Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "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
    }
  }
}

Status code:

201

{
  "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
    }
  }
}

Status code:

202

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

Sample Request

HTTP

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
  }
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ElasticPoolInner;
import com.azure.resourcemanager.sql.models.Sku;

/** Samples for ElasticPools CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * HyperscaleElasticPoolCreateOrUpdateSetHighAvailabilityReplicaCount.json
     */
    /**
     * Sample code: Create or update Hyperscale elastic pool with high availability replica count parameter.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateHyperscaleElasticPoolWithHighAvailabilityReplicaCountParameter(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().createOrUpdate("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102", new ElasticPoolInner().withLocation("Japan East")
                .withSku(new Sku().withName("HS_Gen5_4")).withHighAvailabilityReplicaCount(2),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "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
  }
}

Status code:

201

{
  "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
  }
}

Status code:

202

Definisi

Nama	Deskripsi
ElasticPool	Kumpulan elastis.
ElasticPoolLicenseType	Jenis lisensi yang akan diterapkan untuk kumpulan elastis ini.
ElasticPoolPerDatabaseSettings	Per pengaturan database kumpulan elastis.
ElasticPoolState	Status kumpulan elastis.
Sku	SKU Sumber Daya ARM.

ElasticPool

Kumpulan elastis.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
kind	string	Jenis kumpulan elastis. Ini adalah metadata yang digunakan untuk pengalaman portal Azure.
location	string	Lokasi sumber daya.
name	string	Nama sumber daya.
properties.creationDate	string	Tanggal pembuatan kumpulan elastis (format ISO8601).
properties.highAvailabilityReplicaCount	integer	Jumlah replika sekunder yang terkait dengan kumpulan elastis yang digunakan untuk memberikan ketersediaan tinggi. Hanya berlaku untuk kumpulan elastis Hyperscale.
properties.licenseType	ElasticPoolLicenseType	Jenis lisensi yang akan diterapkan untuk kumpulan elastis ini.
properties.maintenanceConfigurationId	string	Id konfigurasi pemeliharaan yang ditetapkan ke kumpulan elastis. Konfigurasi ini menentukan periode kapan pembaruan pemeliharaan akan terjadi.
properties.maxSizeBytes	integer	Batas penyimpanan untuk kumpulan elastis database dalam byte.
properties.minCapacity	number	Kapasitas minimal yang tidak akan menyusut di bawah ini, jika tidak dijeda
properties.perDatabaseSettings	ElasticPoolPerDatabaseSettings	Pengaturan per database untuk kumpulan elastis.
properties.state	ElasticPoolState	Status kumpulan elastis.
properties.zoneRedundant	boolean	Apakah kumpulan elastis ini zona redundan atau tidak, yang berarti replika kumpulan elastis ini akan tersebar di beberapa zona ketersediaan.
sku	Sku	SKU kumpulan elastis. Daftar SKU dapat bervariasi menurut wilayah dan penawaran dukungan. Untuk menentukan SKU (termasuk nama SKU, tingkat/edisi, keluarga, dan kapasitas) yang tersedia untuk langganan Anda di wilayah Azure, gunakan Capabilities_ListByLocation REST API atau perintah berikut: az sql elastic-pool list-editions -l <location> -o table
tags	object	Tag sumber daya.
type	string	Jenis sumber daya

ElasticPoolLicenseType

Jenis lisensi yang akan diterapkan untuk kumpulan elastis ini.

Nama	Jenis	Deskripsi
BasePrice	string
LicenseIncluded	string

ElasticPoolPerDatabaseSettings

Per pengaturan database kumpulan elastis.

Nama	Jenis	Deskripsi
maxCapacity	number	Kapasitas maksimum yang dapat dikonsumsi oleh satu database.
minCapacity	number	Kapasitas minimum semua database dijamin.

ElasticPoolState

Status kumpulan elastis.

Nama	Jenis	Deskripsi
Creating	string
Disabled	string
Ready	string

Sku

SKU Sumber Daya ARM.

Nama	Jenis	Deskripsi
capacity	integer	Kapasitas SKU tertentu.
family	string	Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini.
name	string	Nama SKU, biasanya, kode huruf + Angka, misalnya P3.
size	string	Ukuran SKU tertentu
tier	string	Tingkat atau edisi SKU tertentu, misalnya Dasar, Premium.