Freigeben über


Instance Pools - Create Or Update

Erstellt oder aktualisiert einen instance-Pool.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
instancePoolName
path True

string

Der Name des instance Pools, der erstellt oder aktualisiert werden soll.

resourceGroupName
path True

string

Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.

subscriptionId
path True

string

Abonnement-ID für ein Azure-Abonnement.

api-version
query True

string

API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name Erforderlich Typ Beschreibung
location True

string

Ressourcenspeicherort

properties.licenseType True

InstancePoolLicenseType

Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (Preis für SQL-Lizenz ist inbegriffen) und "BasePrice" (ohne SQL-Lizenzpreis).

properties.subnetId True

string

Ressourcen-ID des Subnetzes, in dem dieser instance Pool platziert werden soll.

properties.vCores True

integer

Anzahl der virtuellen Kerne, die zu diesem instance-Pool gehören.

sku

Sku

Der Name und die Ebene der SKU.

tags

object

Ressourcentags.

Antworten

Name Typ Beschreibung
200 OK

InstancePool

Der instance-Pool wurde erfolgreich aktualisiert.

201 Created

InstancePool

Der instance Pool wurde erfolgreich erstellt.

202 Accepted

Akzeptiert

Other Status Codes

Fehlerantworten: ***

  • 400 InvalidResourceRequestBody: Die Ressourcen- oder Ressourceneigenschaften im Anforderungstext sind leer oder ungültig.

  • 400 MissingSkuName: SKU-Name ist erforderlich.

  • 400 InstancePoolRequestedVcoreCountIsInvalid : Anzahl der angeforderten virtuellen Kerne für instance Pool ungültig ist

  • 400 InstancePoolRequestMissingSku : Anforderung des Instanzpools fehlt SKU

  • 400 InstancePoolRequestMissingSkuTier: Anforderung des Instanzpools fehlt SKU-Ebene

  • 400 InstancePoolRequestMissingSkuFamily – Instanzpoolanforderung fehlt SKU-Familie

  • 400 InstancePoolRequestedSubnetResourceIdIsInvalid : Subnetz-ID für instance Pool null oder leer ist

  • 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden.

  • 409 InstancePoolBusy: Ein instance Pool ist mit einem anderen laufenden Vorgang beschäftigt

  • 409 OperationCancelled: Der Vorgang wurde vom Benutzer abgebrochen.

  • 409 OperationInterrupted: Der Vorgang für die Ressource konnte nicht abgeschlossen werden, da er durch einen anderen Vorgang für dieselbe Ressource unterbrochen wurde.

  • 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

  • 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

  • 500 OperationTimedOut: Timeout des Vorgangs und automatisches Rollback. Wiederholen Sie den Vorgang.

  • 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

Create an instance pool with all properties.
Create an instance pool with min properties.

Create an instance pool with all properties.

Beispielanforderung

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP?api-version=2021-11-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"
  }
}

Beispiel für eine Antwort

{
  "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": {
    "a": "b"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
  "name": "testIP",
  "type": "Microsoft.Sql/instancePools"
}
{
  "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": {
    "a": "b"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
  "name": "testIP",
  "type": "Microsoft.Sql/instancePools"
}

Create an instance pool with min properties.

Beispielanforderung

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP?api-version=2021-11-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"
  }
}

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
InstancePool

Ein Azure SQL instance-Pool.

InstancePoolLicenseType

Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (Preis für SQL-Lizenz ist inbegriffen) und "BasePrice" (ohne SQL-Lizenzpreis).

Sku

Eine ARM-Ressourcen-SKU.

InstancePool

Ein Azure SQL instance-Pool.

Name Typ Beschreibung
id

string

Ressourcen-ID

location

string

Ressourcenspeicherort

name

string

Name der Ressource.

properties.licenseType

InstancePoolLicenseType

Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (Preis für SQL-Lizenz ist inbegriffen) und "BasePrice" (ohne SQL-Lizenzpreis).

properties.subnetId

string

Ressourcen-ID des Subnetzes, in dem dieser instance Pool platziert werden soll.

properties.vCores

integer

Anzahl der virtuellen Kerne, die zu diesem instance-Pool gehören.

sku

Sku

Der Name und die Ebene der SKU.

tags

object

Ressourcentags.

type

string

Der Ressourcentyp.

InstancePoolLicenseType

Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (Preis für SQL-Lizenz ist inbegriffen) und "BasePrice" (ohne SQL-Lizenzpreis).

Name Typ Beschreibung
BasePrice

string

LicenseIncluded

string

Sku

Eine ARM-Ressourcen-SKU.

Name Typ Beschreibung
capacity

integer

Kapazität der jeweiligen SKU.

family

string

Wenn der Dienst über unterschiedliche Hardwaregenerationen für dieselbe SKU verfügt, kann dies hier erfasst werden.

name

string

Der Name der SKU, in der Regel ein Buchstabe + Zahlencode, z. B. P3.

size

string

Größe der jeweiligen SKU

tier

string

Der Tarif oder die Edition der jeweiligen SKU, z. B. Basic, Premium.