Elastic Pools - Create Or Update

Service:

SQL Database

Version d'API:

2021-11-01

Crée ou met à jour un pool élastique.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
elasticPoolName	path	True	string	Nom du pool élastique.
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
serverName	path	True	string	Nom du serveur.
subscriptionId	path	True	string	ID d’abonnement qui identifie un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Corps de la demande

Nom	Obligatoire	Type	Description
location	True	string	Emplacement des ressources.
properties.highAvailabilityReplicaCount		integer (int32)	Nombre de réplicas secondaires associés au pool élastique utilisé pour fournir une haute disponibilité. Applicable uniquement aux pools élastiques Hyperscale.
properties.licenseType		ElasticPoolLicenseType	Type de licence à appliquer pour ce pool élastique.
properties.maintenanceConfigurationId		string	ID de configuration de maintenance affecté au pool élastique. Cette configuration définit la période pendant laquelle les mises à jour de maintenance se produisent.
properties.maxSizeBytes		integer (int64)	Limite de stockage du pool élastique de base de données en octets.
properties.minCapacity		number (double)	Capacité minimale que le pool serverless ne réduit pas en dessous, s’il n’est pas suspendu
properties.perDatabaseSettings		ElasticPoolPerDatabaseSettings	Paramètres par base de données pour le pool élastique.
properties.zoneRedundant		boolean	Indique si ce pool élastique est redondant interzone, ce qui signifie que les réplicas de ce pool élastique sont répartis entre plusieurs zones de disponibilité.
sku		Sku	Référence SKU du pool élastique. La liste des références SKU peut varier selon la région et l’offre de support. Pour déterminer les références SKU (y compris le nom de la référence SKU, le niveau/édition, la famille et la capacité) disponibles pour votre abonnement dans une région Azure, utilisez l’API REST Capabilities_ListByLocation ou la commande suivante : az sql elastic-pool list-editions -l <location> -o table
tags		object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	ElasticPool	Mise à jour du pool élastique
201 Created	ElasticPool	Création du pool élastique
202 Accepted		Accepté
Other Status Codes		Réponses d’erreur : *** 400 ElasticPoolOverStorageUsage : tentative d’écriture de données dans une base de données lorsque la limite de stockage du pool élastique a été atteinte. 400 InvalidSku : l’utilisateur a spécifié une référence SKU non valide. 400 InvalidTierSkuCombination : le niveau spécifié ne prend pas en charge la référence sku spécifiée. 400 ServerQuotaExceeded : le serveur a atteint sa limite pour l’unité de débit de base de données autorisée. 400 ElasticPoolAlreadyExists : le serveur contient déjà un pool élastique portant le nom spécifié. 400 SubscriptionVcoreQuotaExceed : impossible d’effectuer l’opération, car l’abonnement dépasserait le quota vCore autorisé. 400 InvalidInputValueForEdition - L’édition spécifiée n’est pas prise en charge pour l’approvisionnement de pool élastique. 400 ElasticPoolDtuBelowLimit : la valeur DTU demandée est trop faible pour le niveau de service du pool élastique demandé. 400 ElasticPoolDtuAboveLimit : la valeur DTU demandée est trop élevée pour le niveau de service du pool élastique demandé. 400 InvalidMaxSize - Taille maximale non valide. 400 ElasticPoolDbDtuMaxBelowLimit : la valeur maximale DTU demandée par base de données est trop faible pour le niveau de service du pool élastique demandé. 400 ElasticPoolDbDtuMaxAboveLimit : le nombre maximal DTU demandé par base de données est trop élevé pour le niveau de service du pool élastique demandé. 400 InvalidInputValueForDatabaseDtuMax : tentative de définition du nombre maximal de DTU par base de données pour le pool de ressources qui ne correspond pas aux valeurs autorisées. 400 ElasticPoolDbDtuMinAboveLimit : la valeur minimale de DTU demandée par base de données est trop élevée pour le niveau de service demandé. 400 ElasticPoolOverStorage : tentative d’écriture de données dans une base de données lorsque la limite de stockage du pool élastique a été atteinte. 400 InvalidInputValueForDatabaseDtuMin : tentative de définition de la valeur DTU min par base de données pour le pool de ressources qui ne correspond pas aux valeurs autorisées. 400 ElasticPoolInconsistentDtuGuaranteeSettings : tentative de fournir la valeur DTU min pour les bases de données du pool élastique qui dépasse les DTU demandées du pool élastique. 400 ElasticPoolDtuUnsupported : l’utilisateur a essayé de créer ou de mettre à jour un pool élastique avec une capacité DTU qui n’est pas prise en charge. 400 ElasticPoolStorageAboveLimitVB : tentative de définition de la limite de stockage du pool élastique en dessous de la limite prise en charge. 400 ElasticPoolsNotEnabled : les pools élastiques n’ont pas été activés dans cette région. 400 ElasticPoolNotEmpty : demande de supprimer un pool élastique qui n’est pas vide. 400 ElasticPoolStorageBelowLimitVB : tentative de définir la limite de stockage du pool élastique en dessous de la limite prise en charge. 400 ElasticPoolStorageNotAllowedGB : tentative de définition de la limite de stockage du pool élastique en Go qui ne correspond pas aux valeurs autorisées. 400 ElasticPoolDatabaseLimit : le pool élastique a atteint sa limite pour le nombre de bases de données. 400 ElasticPoolDecreaseStorageLimitBelowUsage : tentative de réduire la limite de stockage du pool élastique en dessous de son utilisation du stockage. 400 InvalidInputValueDatabaseDtuMinLargerThanMax : tentative de définir la valeur DTU min par base de données supérieure à la valeur maximale de DTU par base de données. 400 ElasticPoolInconsistentVcoreGuaranteeSettings : le nombre de bases de données et de VCore min par base de données ne peut pas dépasser les VCores demandés du pool élastique. 400 ElasticPoolStorageBelowLimitMB : tentative de définition de la limite de stockage du pool élastique en dessous de la limite prise en charge. 400 ElasticPoolStorageNotAllowedMB : tentative de définition de la limite de stockage du pool élastique en Mo qui ne correspond pas aux valeurs autorisées. 400 ElasticPoolCapacityStorageNotAllowedMB : tentative de définition de la limite de stockage du pool élastique en mo qui ne correspond pas aux valeurs autorisées. 400 ElasticPoolStorageAboveLimitMB : tentative de définition de la limite de stockage du pool élastique en dessous de la limite prise en charge. 400 RegionDoesNotSupportVersion : un utilisateur a tenté de créer un serveur d’une version spécifiée dans un emplacement où cette version de serveur n’est pas prise en charge. 400 InvalidTier : l’utilisateur a spécifié un niveau non valide. 400 SourceDatabaseEditionCouldNotBeUpgraded : la base de données source ne peut pas avoir d’édition supérieure à la base de données cible. 400 TargetDatabaseEditionCouldNotBeDowngrad : la base de données cible ne peut pas avoir d’édition inférieure à la base de données source. 400 ElasticPoolUpdateHkNotAllowed : le pool élastique ne peut pas réduire son niveau de service Premium vers Standard ou De base, car une ou plusieurs de ses bases de données utilisent des objets optimisés en mémoire. 400 UpdateNotAllowedIfGeoDrOperationInProgress : l’opération n’est pas autorisée, car l’opération de copie ou de basculement pour la base de données '{0}' sur le serveur '{1}' est en cours. 400 RegionDoesNotAllowProvisioning : l’emplacement sélectionné n’accepte pas de nouveaux serveurs Windows Azure SQL Database. Cela peut changer ultérieurement. 400 ElasticPoolOverFileSpace - Espace de fichier insuffisant dans le pool élastique. 400 ElasticPoolDbDtuMinBelowLimit : la valeur minimale demandée par base de données DTU est trop faible pour le niveau de service du pool élastique demandé. 400 ElasticPoolDbVcoreMaxBelowLimit : le nombre maximal demandé par base de données VCore est trop faible pour le niveau de service du pool élastique demandé. 400 ElasticPoolDbVcoreMaxAboveLimit : le nombre maximal demandé par base de données VCore est trop élevé pour le niveau de service du pool élastique demandé. 400 InvalidInputValueForDatabaseVcoreMax : tentative de définition du nombre maximal VCore par base de données pour le pool de ressources qui ne correspond pas aux valeurs autorisées. 400 ElasticPoolDbVcoreMinBelowLimit : la valeur minimale demandée par base de données VCore est trop faible pour le niveau de service du pool élastique demandé. 400 InvalidInputValueForDatabaseVcoreMin : tentative de définition du VCore min par base de données pour le pool de ressources qui ne correspond pas aux valeurs autorisées. 400 PartnerDBNotCompatibleForSGXEnclave : la tentative de définition du lien GeoDR ou de la mise à jour de SLO pour la base de données activée pour enclave n’est prise en charge que lorsque les deux bases de données s’exécutent sur du matériel de la série DC. 400 InvalidInputValueDatabaseVcoreMinLargerThanMax : tentative de définition du VCore min par base de données supérieure à la valeur maximale VCore par base de données. 400 InvalidLicenseType : l’utilisateur a essayé de créer ou de mettre à jour une base de données ou un pool élastique avec un type de licence non pris en charge. 400 ProvisioningDisabled - Affiche le message d’erreur de l’autorisation d’opération de ressources tel qu’il est, sans modification 400 InvalidPublicMaintenanceConfiguration - L’utilisateur a essayé de spécifier la configuration de maintenance publique qui ne peut pas être convertie en ID interne (mauvaise forme ou mauvaise région). 400 InvalidResourceRequestBody : les propriétés de ressource ou de ressource dans le corps de la requête sont vides ou non valides. 400 InvalidResourceId - Identificateur de ressource non valide. 400 InvalidSkuName - Nom de la référence SKU non valide. 400 MismatchedSkuNameAndCapacity - Incompatibilité entre le nom de la référence SKU et la capacité. 400 MismatchedSkuNameAndTier - Incompatibilité entre le nom de la référence SKU et le niveau. 400 MismatchedSkuNameAndFamily - Incompatibilité entre le nom de la référence SKU et la famille. 400 IncompatibilitéSubscriptionWithUrl : l’abonnement fourni ne correspondait pas à l’abonnement dans l’URL. 400 ElasticPoolOverStorageUsage : tentative d’écriture de données dans une base de données lorsque la limite de stockage du pool élastique a été atteinte. 400 InvalidSku : l’utilisateur a spécifié une référence SKU non valide. 400 InvalidTierSkuCombination : le niveau spécifié ne prend pas en charge la référence sku spécifiée. 400 ServerQuotaExceeded : le serveur a atteint sa limite pour l’unité de débit de base de données autorisée. 400 ElasticPoolAlreadyExists : le serveur contient déjà un pool élastique portant le nom spécifié. 400 SubscriptionVcoreQuotaExceed : impossible d’effectuer l’opération, car l’abonnement dépasserait le quota vCore autorisé. 400 InvalidInputValueForEdition - L’édition spécifiée n’est pas prise en charge pour l’approvisionnement de pool élastique. 400 ElasticPoolDtuBelowLimit : la valeur DTU demandée est trop faible pour le niveau de service du pool élastique demandé. 400 ElasticPoolDtuAboveLimit : la valeur DTU demandée est trop élevée pour le niveau de service du pool élastique demandé. 400 InvalidMaxSize - Taille maximale non valide. 400 ElasticPoolDbDtuMaxBelowLimit : la valeur maximale DTU demandée par base de données est trop faible pour le niveau de service du pool élastique demandé. 400 ElasticPoolDbDtuMaxAboveLimit : le nombre maximal DTU demandé par base de données est trop élevé pour le niveau de service du pool élastique demandé. 400 InvalidInputValueForDatabaseDtuMax : tentative de définition du nombre maximal de DTU par base de données pour le pool de ressources qui ne correspond pas aux valeurs autorisées. 400 ElasticPoolDbDtuMinAboveLimit : la valeur minimale de DTU demandée par base de données est trop élevée pour le niveau de service demandé. 400 ElasticPoolOverStorage : tentative d’écriture de données dans une base de données lorsque la limite de stockage du pool élastique a été atteinte. 400 InvalidInputValueForDatabaseDtuMin : tentative de définition de la valeur DTU min par base de données pour le pool de ressources qui ne correspond pas aux valeurs autorisées. 400 ElasticPoolInconsistentDtuGuaranteeSettings : tentative de fournir la valeur DTU min pour les bases de données du pool élastique qui dépasse les DTU demandées du pool élastique. 400 ElasticPoolDtuUnsupported : l’utilisateur a essayé de créer ou de mettre à jour un pool élastique avec une capacité DTU qui n’est pas prise en charge. 400 ElasticPoolStorageAboveLimitVB : tentative de définition de la limite de stockage du pool élastique en dessous de la limite prise en charge. 400 ElasticPoolsNotEnabled : les pools élastiques n’ont pas été activés dans cette région. 400 ElasticPoolNotEmpty : demande de supprimer un pool élastique qui n’est pas vide. 400 ElasticPoolStorageBelowLimitVB : tentative de définir la limite de stockage du pool élastique en dessous de la limite prise en charge. 400 ElasticPoolStorageNotAllowedGB : tentative de définition de la limite de stockage du pool élastique en Go qui ne correspond pas aux valeurs autorisées. 400 ElasticPoolDatabaseLimit : le pool élastique a atteint sa limite pour le nombre de bases de données. 400 ElasticPoolDecreaseStorageLimitBelowUsage : tentative de réduire la limite de stockage du pool élastique en dessous de son utilisation du stockage. 400 InvalidInputValueDatabaseDtuMinLargerThanMax : tentative de définir la valeur DTU min par base de données supérieure à la valeur maximale de DTU par base de données. 400 ElasticPoolInconsistentVcoreGuaranteeSettings : le nombre de bases de données et de VCore min par base de données ne peut pas dépasser les VCores demandés du pool élastique. 400 ElasticPoolStorageBelowLimitMB : tentative de définition de la limite de stockage du pool élastique en dessous de la limite prise en charge. 400 ElasticPoolStorageNotAllowedMB : tentative de définition de la limite de stockage du pool élastique en Mo qui ne correspond pas aux valeurs autorisées. 400 ElasticPoolCapacityStorageNotAllowedMB : tentative de définition de la limite de stockage du pool élastique en mo qui ne correspond pas aux valeurs autorisées. 400 ElasticPoolStorageAboveLimitMB : tentative de définition de la limite de stockage du pool élastique en dessous de la limite prise en charge. 400 RegionDoesNotSupportVersion : un utilisateur a tenté de créer un serveur d’une version spécifiée dans un emplacement où cette version de serveur n’est pas prise en charge. 400 InvalidTier : l’utilisateur a spécifié un niveau non valide. 400 SourceDatabaseEditionCouldNotBeUpgraded : la base de données source ne peut pas avoir d’édition supérieure à la base de données cible. 400 TargetDatabaseEditionCouldNotBeDowngrad : la base de données cible ne peut pas avoir d’édition inférieure à la base de données source. 400 ElasticPoolUpdateHkNotAllowed : le pool élastique ne peut pas réduire son niveau de service Premium vers Standard ou De base, car une ou plusieurs de ses bases de données utilisent des objets optimisés en mémoire. 400 UpdateNotAllowedIfGeoDrOperationInProgress : l’opération n’est pas autorisée, car l’opération de copie ou de basculement pour la base de données '{0}' sur le serveur '{1}' est en cours. 400 RegionDoesNotAllowProvisioning : l’emplacement sélectionné n’accepte pas de nouveaux serveurs Windows Azure SQL Database. Cela peut changer ultérieurement. 400 ElasticPoolOverFileSpace - Espace de fichier insuffisant dans le pool élastique. 400 ElasticPoolDbDtuMinBelowLimit : la valeur minimale demandée par base de données DTU est trop faible pour le niveau de service du pool élastique demandé. 400 ElasticPoolDbVcoreMaxBelowLimit : le nombre maximal demandé par base de données VCore est trop faible pour le niveau de service du pool élastique demandé. 400 ElasticPoolDbVcoreMaxAboveLimit : le nombre maximal demandé par base de données VCore est trop élevé pour le niveau de service du pool élastique demandé. 400 InvalidInputValueForDatabaseVcoreMax : tentative de définition du nombre maximal VCore par base de données pour le pool de ressources qui ne correspond pas aux valeurs autorisées. 400 ElasticPoolDbVcoreMinBelowLimit : la valeur minimale demandée par base de données VCore est trop faible pour le niveau de service du pool élastique demandé. 400 InvalidInputValueForDatabaseVcoreMin : tentative de définition du VCore min par base de données pour le pool de ressources qui ne correspond pas aux valeurs autorisées. 400 PartnerDBNotCompatibleForSGXEnclave : la tentative de définition du lien GeoDR ou de la mise à jour de SLO pour la base de données activée pour enclave n’est prise en charge que lorsque les deux bases de données s’exécutent sur du matériel de la série DC. 400 InvalidInputValueDatabaseVcoreMinLargerThanMax : tentative de définition du VCore min par base de données supérieure à la valeur maximale VCore par base de données. 400 InvalidLicenseType : l’utilisateur a essayé de créer ou de mettre à jour une base de données ou un pool élastique avec un type de licence non pris en charge. 400 ProvisioningDisabled - Affiche le message d’erreur de l’autorisation d’opération de ressources tel qu’il est, sans modification 400 InvalidPublicMaintenanceConfiguration - L’utilisateur a essayé de spécifier la configuration de maintenance publique qui ne peut pas être convertie en ID interne (mauvaise forme ou mauvaise région). 404 SubscriptionDoesNotHaveServer - Le serveur demandé est introuvable 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés. 404 ElasticPoolNotFound : le pool élastique spécifié n’existe pas pour le serveur spécifié. 404 OperationIdNotFound : l’opération avec ID n’existe pas. 404 ElasticPoolNotFound : le pool élastique spécifié n’existe pas pour le serveur spécifié. 405 NotSupported : cette fonctionnalité n’est pas prise en charge. 405 NotSupported : cette fonctionnalité n’est pas prise en charge. 409 ElasticPoolBusy : une opération de gestion a été tentée sur un pool élastique occupé. 409 ServerDisabled : le serveur est désactivé. 409 SimultanéeSkuChangeNotAllowed - Les opérations de modification d’objectif de service ne peuvent pas s’exécuter simultanément sur les deux bases de données d’une relation de réplication. 409 ElasticPoolUpdateLinksNotInCatchup : impossible de mettre à jour le pool élastique pendant qu’une de ses bases de données effectue une opération de basculement de copie ou de géoréplication. 409 OperationCancelled : l’opération a été annulée par l’utilisateur. 409 Opération interrompue : l’opération sur la ressource n’a pas pu être terminée, car elle a été interrompue par une autre opération sur la même ressource. 409 ElasticPoolBusy : une opération de gestion a été tentée sur un pool élastique occupé. 409 ServerDisabled : le serveur est désactivé. 409 SimultanéeSkuChangeNotAllowed - Les opérations de modification d’objectif de service ne peuvent pas s’exécuter simultanément sur les deux bases de données d’une relation de réplication. 409 ElasticPoolUpdateLinksNotInCatchup : impossible de mettre à jour le pool élastique pendant qu’une de ses bases de données effectue une opération de basculement de copie ou de géoréplication. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 500 ElasticPoolFailedMoveDbToElasticPool - Échec du déplacement de la base de données dans un pool élastique en raison de contraintes de ressources internes. Il peut s’agir d’une condition temporaire, réessayez. 500 OperationTimedOut : l’opération a expiré et a été restaurée automatiquement. Réessayez l’opération. 500 ElasticPoolFailedMoveDbToElasticPool - Échec du déplacement de la base de données dans un pool élastique en raison de contraintes de ressources internes. Il peut s’agir d’une condition temporaire, réessayez. 503 ServiceTemporarilyUnavailable - Fonctionnalité temporairement indisponible. 503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 503 ServiceTemporarilyUnavailable - Fonctionnalité temporairement indisponible. 503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.

Exemples

Create or update elastic pool with all parameter

Create or update elastic pool with maintenance configuration parameter

Create or update elastic pool with minimum parameters

Create or update Hyperscale elastic pool with high availability replica count parameter

Create or update elastic pool with all parameter

Exemple de requête

HTTP

PUT 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

{
  "location": "Japan East",
  "sku": {
    "name": "GP_Gen4_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 2
    }
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.ElasticPoolInner;
import com.azure.resourcemanager.sql.models.ElasticPoolPerDatabaseSettings;
import com.azure.resourcemanager.sql.models.Sku;

/**
 * Samples for ElasticPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ElasticPoolCreateOrUpdateMax.json
     */
    /**
     * Sample code: Create or update elastic pool with all parameter.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateElasticPoolWithAllParameter(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().createOrUpdate("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102",
            new ElasticPoolInner().withLocation("Japan East")
                .withSku(new Sku().withName("GP_Gen4_2").withTier("GeneralPurpose").withCapacity(2))
                .withPerDatabaseSettings(
                    new ElasticPoolPerDatabaseSettings().withMinCapacity(0.25D).withMaxCapacity(2.0D)),
            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

Exemple de réponse

Code d’état:

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_Gen4_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 2
    }
  }
}

Code d’état:

201

{
  "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_Gen4_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 2
    }
  }
}

Code d’état:

202

Create or update elastic pool with maintenance configuration parameter

Exemple de requête

HTTP

PUT 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

{
  "location": "Japan East",
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.ElasticPoolInner;

/**
 * Samples for ElasticPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ElasticPoolCreateOrUpdateSetMaintenanceConfiguration.json
     */
    /**
     * Sample code: Create or update elastic pool with maintenance configuration parameter.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateElasticPoolWithMaintenanceConfigurationParameter(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().createOrUpdate("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102",
            new ElasticPoolInner().withLocation("Japan East").withMaintenanceConfigurationId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"),
            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

Exemple de réponse

Code d’état:

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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    },
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

Code d’état:

201

{
  "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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    },
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

Code d’état:

202

Create or update elastic pool with minimum parameters

Exemple de requête

HTTP

PUT 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

{
  "location": "Japan East"
}

Java

import com.azure.resourcemanager.sql.fluent.models.ElasticPoolInner;

/**
 * Samples for ElasticPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ElasticPoolCreateOrUpdateMin.json
     */
    /**
     * Sample code: Create or update elastic pool with minimum parameters.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createOrUpdateElasticPoolWithMinimumParameters(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().createOrUpdate("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102", new ElasticPoolInner().withLocation("Japan East"),
            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

Exemple de réponse

Code d’état:

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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    }
  }
}

Code d’état:

201

{
  "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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    }
  }
}

Code d’état:

202

Create or update Hyperscale elastic pool with high availability replica count parameter

Exemple de requête

HTTP

PUT 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

{
  "location": "Japan East",
  "sku": {
    "name": "HS_Gen5_4"
  },
  "properties": {
    "highAvailabilityReplicaCount": 2
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.ElasticPoolInner;
import com.azure.resourcemanager.sql.models.Sku;

/**
 * Samples for ElasticPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * HyperscaleElasticPoolCreateOrUpdateSetHighAvailabilityReplicaCount.json
     */
    /**
     * Sample code: Create or update Hyperscale elastic pool with high availability replica count parameter.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateHyperscaleElasticPoolWithHighAvailabilityReplicaCountParameter(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().createOrUpdate("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102", new ElasticPoolInner().withLocation("Japan East")
                .withSku(new Sku().withName("HS_Gen5_4")).withHighAvailabilityReplicaCount(2),
            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

Exemple de réponse

Code d’état:

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

Code d’état:

201

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

Code d’état:

202

Définitions

Nom	Description
ElasticPool	Un pool élastique.
ElasticPoolLicenseType	Type de licence à appliquer pour ce pool élastique.
ElasticPoolPerDatabaseSettings	Par paramètres de base de données d’un pool élastique.
ElasticPoolState	État du pool élastique.
Sku	Référence SKU de ressource ARM.

ElasticPool

Object

Un pool élastique.

Nom	Type	Description
id	string	ID de ressource.
kind	string	Type de pool élastique. Il s’agit des métadonnées utilisées pour l’expérience du portail Azure.
location	string	Emplacement des ressources.
name	string	Nom de la ressource.
properties.creationDate	string (date-time)	Date de création du pool élastique (format ISO8601).
properties.highAvailabilityReplicaCount	integer (int32)	Nombre de réplicas secondaires associés au pool élastique utilisé pour fournir une haute disponibilité. Applicable uniquement aux pools élastiques Hyperscale.
properties.licenseType	ElasticPoolLicenseType	Type de licence à appliquer pour ce pool élastique.
properties.maintenanceConfigurationId	string	ID de configuration de maintenance affecté au pool élastique. Cette configuration définit la période pendant laquelle les mises à jour de maintenance se produisent.
properties.maxSizeBytes	integer (int64)	Limite de stockage du pool élastique de base de données en octets.
properties.minCapacity	number (double)	Capacité minimale que le pool serverless ne réduit pas en dessous, s’il n’est pas suspendu
properties.perDatabaseSettings	ElasticPoolPerDatabaseSettings	Paramètres par base de données pour le pool élastique.
properties.state	ElasticPoolState	État du pool élastique.
properties.zoneRedundant	boolean	Indique si ce pool élastique est redondant interzone, ce qui signifie que les réplicas de ce pool élastique sont répartis entre plusieurs zones de disponibilité.
sku	Sku	Référence SKU du pool élastique. La liste des références SKU peut varier selon la région et l’offre de support. Pour déterminer les références SKU (y compris le nom de la référence SKU, le niveau/édition, la famille et la capacité) disponibles pour votre abonnement dans une région Azure, utilisez l’API REST Capabilities_ListByLocation ou la commande suivante : az sql elastic-pool list-editions -l <location> -o table
tags	object	Balises de ressource.
type	string	Type de ressource.

ElasticPoolLicenseType

Énumération

Type de licence à appliquer pour ce pool élastique.

Valeur	Description
BasePrice
LicenseIncluded

ElasticPoolPerDatabaseSettings

Object

Par paramètres de base de données d’un pool élastique.

Nom	Type	Description
maxCapacity	number (double)	Capacité maximale qu’une base de données peut consommer.
minCapacity	number (double)	La capacité minimale de toutes les bases de données est garantie.

ElasticPoolState

Énumération

État du pool élastique.

Valeur	Description
Creating
Disabled
Ready

Sku

Object

Référence SKU de ressource ARM.

Nom	Type	Description
capacity	integer (int32)	Capacité de la référence SKU particulière.
family	string	Si le service a différentes générations de matériel, pour la même référence SKU, vous pouvez le capturer ici.
name	string	Nom de la référence SKU, généralement une lettre + code numérique, par exemple P3.
size	string	Taille de la référence SKU particulière
tier	string	Niveau ou édition de la référence SKU particulière, par exemple De base, Premium.