Elastic Pools - Get

Layanan:

SQL Database

Versi API:

2021-11-01

Mendapat kumpulan elastis.

GET 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.

Respons

Nama	Jenis	Deskripsi
200 OK	ElasticPool	Berhasil
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). 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 ResourceNotFound - Sumber daya yang diminta tidak ditemukan. 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. 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. 503 ServiceTemporarilyUnavailable - Fitur untuk sementara tidak tersedia. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

Contoh

Get a Hyperscale elastic pool

Get an elastic pool

Get a Hyperscale elastic pool

Permintaan sampel

HTTP

GET 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

Java

/**
 * Samples for ElasticPools Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/HyperscaleElasticPoolGet.json
     */
    /**
     * Sample code: Get a Hyperscale elastic pool.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAHyperscaleElasticPool(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().getWithResponse("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102", com.azure.core.util.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

Respon sampel

Kode status:

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

Get an elastic pool

Permintaan sampel

HTTP

GET 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

Java

/**
 * Samples for ElasticPools Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ElasticPoolGet.json
     */
    /**
     * Sample code: Get an elastic pool.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAnElasticPool(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().getWithResponse("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102", com.azure.core.util.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

Respon sampel

Kode status:

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_Gen5_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-10-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 1
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

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.