Instance Pools - Create Or Update

Servizio:: SQL Database

Versione API:: 2023-08-01

Crea o aggiorna un pool di istanze.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
instancePoolName	path	True	string	Nome del pool di istanze da creare o aggiornare.
resourceGroupName	path	True	string	Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Percorso della risorsa.
properties.licenseType	True	InstancePoolLicenseType	Tipo di licenza. I valori possibili sono 'LicenseIncluded' (prezzo per la licenza SQL è inclusa) e 'BasePrice' (senza prezzo di licenza SQL).
properties.subnetId	True	string	ID risorsa della subnet in cui inserire il pool di istanze.
properties.vCores	True	integer (int32)	Numero di vCore appartenenti a questo pool di istanze.
properties.maintenanceConfigurationId		string (arm-id)	Specifica l'ID di configurazione della manutenzione da applicare a questa istanza gestita.
sku		Sku	Nome e livello dello SKU.
tags		object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	InstancePool	Aggiornamento corretto del pool di istanze.
201 Created	InstancePool	Creazione del pool di istanze completata.
202 Accepted		Accettato Intestazioni Location: string
Other Status Codes	ErrorResponse	Risposte di errore: 400 Mancata corrispondenzaResourceGroupNameWithUrl- Il nome del gruppo di risorse specificato non corrisponde al nome nell'URL. 400 Mancata corrispondenzaSubscriptionWithUrl: la sottoscrizione specificata non corrisponde alla sottoscrizione nell'URL. 400 InvalidMinimalTlsVersion - Versione minima di TLS non valida. 400 InvalidResourceId - Identificatore di risorsa non valido. 400 InvalidParameterValue- È stato assegnato un valore non valido a un parametro. 400 DeleteOfManagedInstanceIsDisabled - L'operazione di eliminazione dell'istanza gestita è disabilitata. 400 CustomMaintenanceWindowIsDisabled - Finestra di manutenzione personalizzata non abilitata. 400 MICantBeMovedFromOrToInstancePool: l'istanza gestita esistente non può essere spostata nel pool di istanze gestite. 400 InvalidResourceRequestBody: le proprietà della risorsa o della risorsa nel corpo della richiesta sono vuote o non valide. 400 MissingSkuName : è necessario il nome sku. 400 InstancePoolRequestedVcoreCountIsInvalid - Numero di vcore richiesto per il pool di istanze non valido 400 InstancePoolRequestMissingSku - Richiesta pool di istanze mancante 400 InstancePoolRequestMissingSkuTier - Richiesta del pool di istanze mancante 400 InstancePoolRequestMissingSkuFamily - Richiesta pool di istanze mancante 400 InstancePoolRequestedSubnetResourceIdIsInvalid - L'ID subnet per il pool di istanze è null o vuoto 400 DeploymentIntoPrivateSubnetsNotAllowed: la distribuzione di istanze gestite e pool di istanze in subnet private non è supportata. 404 OperationIdNotFound - L'operazione con ID non esiste. 409 MiCreateFailedNonDelegatedSubnet- L'utente ha tentato di distribuire Istanza gestita o pool di Istanza gestita nella subnet non delegata a Microsoft.Sql/managedInstances. 409 InstancePoolBusy - Un pool di istanze è occupato con un'altra operazione in corso 409 MiCreateFailedNonDelegatedSubnet- L'utente ha tentato di distribuire Istanza gestita o pool di Istanza gestita nella subnet non delegata a Microsoft.Sql/managedInstances. 409 CannotCancelOperation: l'operazione di gestione si trova in uno stato che non può essere annullato. 409 OperationCancelled - L'operazione è stata annullata dall'utente. 409 OperationInterrupted - Impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa. 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 500 OperationTimedOut: timeout dell'operazione e rollback automatico. Ripetere l'operazione. 503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

Create an instance pool with all properties.

Create an instance pool with min properties.

Create an instance pool with all properties.

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
}

Codice di stato:: 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"
}

Codice di stato:: 202

Create an instance pool with min properties.

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
}

Codice di stato:: 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"
}

Codice di stato:: 202

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
InstancePool	Un pool di istanze sql di Azure.
InstancePoolLicenseType	Tipo di licenza. I valori possibili sono 'LicenseIncluded' (prezzo per la licenza SQL è inclusa) e 'BasePrice' (senza prezzo di licenza SQL).
Sku	SKU della risorsa ARM.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

InstancePool

Oggetto

Un pool di istanze sql di Azure.

Nome	Tipo	Descrizione
id	string	ID risorsa.
location	string	Percorso della risorsa.
name	string	Nome risorsa.
properties.dnsZone	string	Zona DNS in cui si trova il pool di istanze gestite.
properties.licenseType	InstancePoolLicenseType	Tipo di licenza. I valori possibili sono 'LicenseIncluded' (prezzo per la licenza SQL è inclusa) e 'BasePrice' (senza prezzo di licenza SQL).
properties.maintenanceConfigurationId	string (arm-id)	Specifica l'ID di configurazione della manutenzione da applicare a questa istanza gestita.
properties.subnetId	string	ID risorsa della subnet in cui inserire il pool di istanze.
properties.vCores	integer (int32)	Numero di vCore appartenenti a questo pool di istanze.
sku	Sku	Nome e livello dello SKU.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa.

InstancePoolLicenseType

Enumerazione

Tipo di licenza. I valori possibili sono 'LicenseIncluded' (prezzo per la licenza SQL è inclusa) e 'BasePrice' (senza prezzo di licenza SQL).

Valore	Descrizione
LicenseIncluded
BasePrice

Sku

Oggetto

SKU della risorsa ARM.

Nome	Tipo	Descrizione
capacity	integer (int32)	Capacità dello SKU specifico.
family	string	Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.
name	string	Il nome dello SKU, in genere, una lettera + codice numerico, ad esempio P3.
size	string	Dimensioni dello SKU specifico
tier	string	Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium.

Condividi tramite

Instance Pools - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

Create an instance pool with all properties.

Esempio di richiesta

Risposta di esempio

Create an instance pool with min properties.

Esempio di richiesta

Risposta di esempio

Definizioni

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InstancePool

InstancePoolLicenseType

Sku