Instance Pools - Create Or Update

Layanan:: SQL Database

Versi API:: 2023-08-01

Membuat atau memperbarui kumpulan instans.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/instancePools/{instancePoolName}?api-version=2023-08-01

Parameter URI

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

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
location	True	string	Lokasi sumber daya.
properties.licenseType	True	InstancePoolLicenseType	Jenis lisensi. Nilai yang mungkin adalah 'LicenseIncluded' (harga untuk lisensi SQL disertakan) dan 'BasePrice' (tanpa harga lisensi SQL).
properties.subnetId	True	string	ID sumber daya subnet untuk menempatkan kumpulan instans ini.
properties.vCores	True	integer (int32)	Jumlah vCore milik kumpulan instans ini.
properties.maintenanceConfigurationId		string (arm-id)	Menentukan id konfigurasi pemeliharaan untuk diterapkan ke instans terkelola ini.
sku		Sku	Nama dan tingkat SKU.
tags		object	Tag sumber daya.

Respons

Nama	Jenis	Deskripsi
200 OK	InstancePool	Berhasil memperbarui kumpulan instans.
201 Created	InstancePool	Berhasil membuat kumpulan instans.
202 Accepted		Diterima Header Location: string
Other Status Codes	ErrorResponse	Respons Kesalahan: *** 400 MismatchingResourceGroupNameWithUrl - Nama grup sumber daya yang disediakan tidak cocok dengan nama di Url. 400 MismatchingSubscriptionWithUrl - Langganan yang disediakan tidak cocok dengan langganan di Url. 400 InvalidMinimalTlsVersion - Versi TLS minimal tidak valid. 400 InvalidResourceId - Pengidentifikasi sumber daya tidak valid. 400 InvalidParameterValue - Nilai yang tidak valid diberikan ke parameter. 400 DeleteOfManagedInstanceIsDisabled - Operasi penghapusan instans terkelola dinonaktifkan. 400 CustomMaintenanceWindowIsDisabled - Jendela pemeliharaan kustom tidak diaktifkan. 400 MICantBeMovedFromOrToInstancePool - Instans terkelola yang ada tidak dapat dipindahkan ke kumpulan instans terkelola. 400 InvalidResourceRequestBody - Properti sumber daya atau sumber daya dalam isi permintaan kosong atau tidak valid. Diperlukan 400 MissingSkuName - Nama Sku. 400 InstancePoolRequestedVcoreCountIsInvalid - Jumlah vcore yang diminta untuk kumpulan instans tidak valid 400 InstancePoolRequestMissingSku - Permintaan kumpulan instans kehilangan sku 400 InstancePoolRequestMissingSkuTier - Permintaan kumpulan instans kehilangan tingkat sku 400 InstancePoolRequestMissingSkuFamily - Permintaan kumpulan instans kehilangan keluarga sku 400 InstancePoolRequestedSubnetResourceIdIsInvalid - Id subnet untuk kumpulan instans null atau kosong 400 DeploymentIntoPrivateSubnetsNotAllowed - Menyebarkan instans terkelola dan kumpulan instans ke subnet privat tidak didukung. 404 OperationIdNotFound - Operasi dengan Id tidak ada. 409 MiCreateFailedNonDelegatedSubnet - Pengguna mencoba menyebarkan Instans Terkelola atau kumpulan Instans Terkelola di subnet yang tidak didelegasikan ke Microsoft.Sql/managedInstances. 409 InstancePoolBusy - Kumpulan instans sibuk dengan operasi lain yang sedang berlangsung 409 MiCreateFailedNonDelegatedSubnet - Pengguna mencoba menyebarkan Instans Terkelola atau kumpulan Instans Terkelola di subnet yang tidak didelegasikan ke Microsoft.Sql/managedInstances. 409 CannotCancelOperation - Operasi manajemen dalam keadaan yang tidak dapat dibatalkan. 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 OperationTimedOut - Waktu operasi habis dan secara otomatis digulung balik. Silakan coba lagi operasi ini. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

Contoh

Create an instance pool with all properties.

Create an instance pool with min properties.

Create an instance pool with all properties.

Permintaan sampel

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP?api-version=2023-08-01

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "family": "Gen5"
  },
  "location": "japaneast",
  "tags": {
    "a": "b"
  },
  "properties": {
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1",
    "vCores": 8,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1"
  }
}

Respon sampel

Kode status:: 200

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "family": "Gen5"
  },
  "properties": {
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1",
    "vCores": 8,
    "licenseType": "LicenseIncluded",
    "dnsZone": "1234567890",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1"
  },
  "location": "japaneast",
  "tags": {
    "a": "b"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
  "name": "testIP",
  "type": "Microsoft.Sql/instancePools"
}

Kode status:: 201

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "family": "Gen5"
  },
  "properties": {
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1",
    "vCores": 8,
    "licenseType": "LicenseIncluded",
    "dnsZone": "1234567890",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1"
  },
  "location": "japaneast",
  "tags": {
    "a": "b"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
  "name": "testIP",
  "type": "Microsoft.Sql/instancePools"
}

Kode status:: 202

Create an instance pool with min properties.

Permintaan sampel

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP?api-version=2023-08-01

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "family": "Gen5"
  },
  "location": "japaneast",
  "properties": {
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1",
    "vCores": 8,
    "licenseType": "LicenseIncluded"
  }
}

Respon sampel

Kode status:: 200

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "family": "Gen5"
  },
  "properties": {
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1",
    "vCores": 8,
    "licenseType": "LicenseIncluded"
  },
  "location": "japaneast",
  "tags": {},
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
  "name": "testIP",
  "type": "Microsoft.Sql/instancePools"
}

Kode status:: 201

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "family": "Gen5"
  },
  "properties": {
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1",
    "vCores": 8,
    "licenseType": "LicenseIncluded"
  },
  "location": "japaneast",
  "tags": {},
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
  "name": "testIP",
  "type": "Microsoft.Sql/instancePools"
}

Kode status:: 202

Definisi

Nama	Deskripsi
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
InstancePool	Kumpulan instans Azure SQL.
InstancePoolLicenseType	Jenis lisensi. Nilai yang mungkin adalah 'LicenseIncluded' (harga untuk lisensi SQL disertakan) dan 'BasePrice' (tanpa harga lisensi SQL).
Sku	SKU Sumber Daya ARM.

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Respons kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

InstancePool

Objek

Kumpulan instans Azure SQL.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
location	string	Lokasi sumber daya.
name	string	Nama sumber daya.
properties.dnsZone	string	Zona Dns tempat kumpulan instans terkelola berada.
properties.licenseType	InstancePoolLicenseType	Jenis lisensi. Nilai yang mungkin adalah 'LicenseIncluded' (harga untuk lisensi SQL disertakan) dan 'BasePrice' (tanpa harga lisensi SQL).
properties.maintenanceConfigurationId	string (arm-id)	Menentukan id konfigurasi pemeliharaan untuk diterapkan ke instans terkelola ini.
properties.subnetId	string	ID sumber daya subnet untuk menempatkan kumpulan instans ini.
properties.vCores	integer (int32)	Jumlah vCore milik kumpulan instans ini.
sku	Sku	Nama dan tingkat SKU.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya.

InstancePoolLicenseType

Enumerasi

Jenis lisensi. Nilai yang mungkin adalah 'LicenseIncluded' (harga untuk lisensi SQL disertakan) dan 'BasePrice' (tanpa harga lisensi SQL).

Nilai	Deskripsi
LicenseIncluded
BasePrice

Sku

Objek

SKU Sumber Daya ARM.

Nama	Jenis	Deskripsi
capacity	integer (int32)	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.

Bagikan melalui

Instance Pools - Create Or Update

Parameter URI

Isi Permintaan

Respons

Contoh

Create an instance pool with all properties.

Permintaan sampel

Respon sampel

Create an instance pool with min properties.

Permintaan sampel

Respon sampel

Definisi

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InstancePool

InstancePoolLicenseType

Sku