Instance Pools - Create Or Update
Skapar eller uppdaterar en instanspool.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/instancePools/{instancePoolName}?api-version=2025-01-01
URI-parametrar
| Name | I | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
instance
|
path | True |
string |
Namnet på den instanspool som ska hämtas. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
|
subscription
|
path | True |
string (uuid) |
ID för målprenumerationen. Värdet måste vara ett UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Den API-version som ska användas för den här åtgärden. |
Begärandetext
| Name | Obligatorisk | Typ | Description |
|---|---|---|---|
| location | True |
string |
Den geo-plats där resursen finns |
| properties.licenseType | True |
Licenstypen. Möjliga värden är "LicenseIncluded" (priset för SQL-licens ingår) och "BasePrice" (utan SQL-licenspris). |
|
| properties.subnetId | True |
string |
Resurs-ID för undernätet för att placera instanspoolen i. |
| properties.vCores | True |
integer (int32) |
Antal virtuella kärnor som tillhör den här instanspoolen. |
| properties.maintenanceConfigurationId |
string (arm-id) |
Anger underhållskonfigurations-ID som ska tillämpas på den här hanterade instansen. |
|
| sku |
SKU:ns namn och nivå. |
||
| tags |
object |
Resursetiketter. |
Svar
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Resursens 'InstancePool'-uppdateringsoperation lyckades |
|
| 201 Created |
Resursen 'InstancePool' skapade operationen lyckades Sidhuvuden
|
|
| 202 Accepted |
Resursåtgärden har godkänts. Sidhuvuden
|
|
| Other Status Codes |
Ett oväntat felsvar. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
| Name | Description |
|---|---|
| user_impersonation | personifiera ditt användarkonto |
Exempel
| Create an instance pool with all properties. |
| Create an instance pool with min properties. |
Create an instance pool with all properties.
Exempelbegäran
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP?api-version=2025-01-01
{
"location": "japaneast",
"properties": {
"licenseType": "LicenseIncluded",
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1",
"vCores": 8
},
"sku": {
"name": "GP_Gen5",
"family": "Gen5",
"tier": "GeneralPurpose"
},
"tags": {
"a": "b"
}
}
Exempelsvar
{
"name": "testIP",
"type": "Microsoft.Sql/instancePools",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
"location": "japaneast",
"properties": {
"dnsZone": "1234567890",
"licenseType": "LicenseIncluded",
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1",
"vCores": 8
},
"sku": {
"name": "GP_Gen5",
"family": "Gen5",
"tier": "GeneralPurpose"
},
"tags": {
"a": "b"
}
}
{
"name": "testIP",
"type": "Microsoft.Sql/instancePools",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
"location": "japaneast",
"properties": {
"dnsZone": "1234567890",
"licenseType": "LicenseIncluded",
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1",
"vCores": 8
},
"sku": {
"name": "GP_Gen5",
"family": "Gen5",
"tier": "GeneralPurpose"
},
"tags": {
"a": "b"
}
}
Create an instance pool with min properties.
Exempelbegäran
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP?api-version=2025-01-01
{
"location": "japaneast",
"properties": {
"licenseType": "LicenseIncluded",
"subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1",
"vCores": 8
},
"sku": {
"name": "GP_Gen5",
"family": "Gen5",
"tier": "GeneralPurpose"
}
}
Exempelsvar
{
"name": "testIP",
"type": "Microsoft.Sql/instancePools",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
"location": "japaneast",
"properties": {
"licenseType": "LicenseIncluded",
"subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1",
"vCores": 8
},
"sku": {
"name": "GP_Gen5",
"family": "Gen5",
"tier": "GeneralPurpose"
},
"tags": {}
}
{
"name": "testIP",
"type": "Microsoft.Sql/instancePools",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
"location": "japaneast",
"properties": {
"licenseType": "LicenseIncluded",
"subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet1",
"vCores": 8
},
"sku": {
"name": "GP_Gen5",
"family": "Gen5",
"tier": "GeneralPurpose"
},
"tags": {}
}
Definitioner
| Name | Description |
|---|---|
|
created |
Den typ av identitet som skapade resursen. |
|
Error |
Resurshanteringsfelet ytterligare information. |
|
Error |
Detaljerna om felet. |
|
Error |
Felsvar |
|
Instance |
An Azure SQL instance pool. |
|
Instance |
Licenstypen. Möjliga värden är "LicenseIncluded" (priset för SQL-licens ingår) och "BasePrice" (utan SQL-licenspris). |
| Sku |
En ARM-resurs-SKU. |
|
system |
Metadata som rör skapande och senaste ändring av resursen. |
createdByType
Den typ av identitet som skapade resursen.
| Värde | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Resurshanteringsfelet ytterligare information.
| Name | Typ | Description |
|---|---|---|
| info |
object |
Den ytterligare informationen. |
| type |
string |
Typen av ytterligare information. |
ErrorDetail
Detaljerna om felet.
| Name | Typ | Description |
|---|---|---|
| additionalInfo |
Felet ytterligare information. |
|
| code |
string |
Felkoden. |
| details |
Felinformationen. |
|
| message |
string |
Felmeddelandet. |
| target |
string |
Felmålet. |
ErrorResponse
Felsvar
| Name | Typ | Description |
|---|---|---|
| error |
Felet objektet. |
InstancePool
An Azure SQL instance pool.
| Name | Typ | Description |
|---|---|---|
| id |
string (arm-id) |
Fullständigt kvalificerat resurs-ID för resursen. T.ex. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| location |
string |
Den geo-plats där resursen finns |
| name |
string |
Namnet på resursen |
| properties.dnsZone |
string |
Dns-zonen som den hanterade instanspoolen finns i. |
| properties.licenseType |
Licenstypen. Möjliga värden är "LicenseIncluded" (priset för SQL-licens ingår) och "BasePrice" (utan SQL-licenspris). |
|
| properties.maintenanceConfigurationId |
string (arm-id) |
Anger underhållskonfigurations-ID som ska tillämpas på den här hanterade instansen. |
| properties.subnetId |
string |
Resurs-ID för undernätet för att placera instanspoolen i. |
| properties.vCores |
integer (int32) |
Antal virtuella kärnor som tillhör den här instanspoolen. |
| sku |
SKU:ns namn och nivå. |
|
| systemData |
Azure Resource Manager-metadata som innehåller creationBy och modifiedBy-information. |
|
| tags |
object |
Resursetiketter. |
| type |
string |
Resurstypen. T.ex. "Microsoft. Compute/virtualMachines" eller "Microsoft. Storage/storageAccounts" |
InstancePoolLicenseType
Licenstypen. Möjliga värden är "LicenseIncluded" (priset för SQL-licens ingår) och "BasePrice" (utan SQL-licenspris).
| Värde | Description |
|---|---|
| LicenseIncluded |
LicensInkluderad |
| BasePrice |
BasePrice |
Sku
En ARM-resurs-SKU.
| Name | Typ | Description |
|---|---|---|
| capacity |
integer (int32) |
Kapacitet för den specifika SKU:n. |
| family |
string |
Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här. |
| name |
string |
Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3. |
| size |
string |
Storleken på den specifika SKU:n |
| tier |
string |
Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium. |
systemData
Metadata som rör skapande och senaste ändring av resursen.
| Name | Typ | Description |
|---|---|---|
| createdAt |
string (date-time) |
Tidsstämpeln för resursskapande (UTC). |
| createdBy |
string |
Identiteten som skapade resursen. |
| createdByType |
Den typ av identitet som skapade resursen. |
|
| lastModifiedAt |
string (date-time) |
Tidsstämpeln för senaste ändring av resurs (UTC) |
| lastModifiedBy |
string |
Identiteten som senast ändrade resursen. |
| lastModifiedByType |
Den typ av identitet som senast ändrade resursen. |