Microsoft.Sql/servers/databases 2014-04-01 - Bicep, ARM template & Terraform AzAPI reference

Définition de ressource Bicep

Le type de ressource serveurs/bases de données peut être déployé avec des opérations qui ciblent :

groupes de ressources - Consultez commandes de déploiement de groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Sql/servers/databases, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Sql/servers/databases@2014-04-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    collation: 'string'
    createMode: 'string'
    edition: 'string'
    elasticPoolName: 'string'
    maxSizeBytes: 'string'
    readScale: 'string'
    recoveryServicesRecoveryPointResourceId: 'string'
    requestedServiceObjectiveId: 'string'
    requestedServiceObjectiveName: 'string'
    restorePointInTime: 'string'
    sampleName: 'string'
    sourceDatabaseDeletionDate: 'string'
    sourceDatabaseId: 'string'
    zoneRedundant: bool
  }
  tags: {
    {customized property}: 'string'
  }
}

Valeurs de propriété

DatabaseProperties

| Nom | Description | Valeur | | ---- | ----------- | ------------ | | classement | Classement de la base de données. Si createMode n’est pas default, cette valeur est ignorée. | string | | createMode | Spécifie le mode de création de base de données.

Valeur par défaut : création régulière de la base de données.

Copie : crée une base de données en tant que copie d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données source.

OnlineSecondary/NonReadableSecondary : crée une base de données en tant que réplica secondaire (lisible ou non lisible) d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données primaire existante.

PointInTimeRestore : crée une base de données en restaurant une sauvegarde à un point dans le temps d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données existante, et restorePointInTime doit être spécifié.

Récupération : crée une base de données en restaurant une sauvegarde géorépliquée. sourceDatabaseId doit être spécifié comme ID de ressource de base de données récupérable à restaurer.

Restauration : crée une base de données en restaurant une sauvegarde d’une base de données supprimée. sourceDatabaseId doit être spécifié. Si sourceDatabaseId est l’ID de ressource d’origine de la base de données, sourceDatabaseDeletionDate doit être spécifié. Sinon, sourceDatabaseId doit être l’ID de ressource de base de données supprimé pouvant être restauré et sourceDatabaseDeletionDate est ignoré. restorePointInTime peut également être spécifié pour effectuer une restauration à partir d’un point antérieur dans le temps.

RestoreLongTermRetentionBackup : crée une base de données en effectuant une restauration à partir d’un coffre de rétention à long terme. recoveryServicesRecoveryPointResourceId doit être spécifié comme ID de ressource de point de récupération.

Copy, NonReadableSecondary, OnlineSecondary et RestoreLongTermRetentionBackup ne sont pas pris en charge pour l’édition DataWarehouse. | 'Copy'
'Default'
'NonReadableSecondary'
'OnlineSecondary'
'PointInTimeRestore'
'Recovery'
'Restore'
'RestoreLongTermRetentionBackup' | | édition | Édition de la base de données. L’énumération DatabaseEditions contient toutes les éditions valides. Si createMode est NonReadableSecondary ou OnlineSecondary, cette valeur est ignorée.

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 l’une des commandes suivantes :

azurecli az sql db list-editions -l <location> -o table ```` powershell
Get-AzSqlServerServiceObjective -Location <emplacement>
| 'Basic' 'Business' 'BusinessCritical' 'DataWarehouse' 'Free' 'GeneralPurpose' 'Hyperscale' 'Premium' 'PremiumRS' 'Standard' 'Stretch' 'System' 'System2' 'Web' | | elasticPoolName | The name of the elastic pool the database is in. If elasticPoolName and requestedServiceObjectiveName are both updated, the value of requestedServiceObjectiveName is ignored. Not supported for DataWarehouse edition. | string | | maxSizeBytes | The max size of the database expressed in bytes. If createMode is not Default, this value is ignored. To see possible values, query the capabilities API (/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities) referred to by operationId: "Capabilities_ListByLocation." | string | | readScale | Conditional. If the database is a geo-secondary, readScale indicates whether read-only connections are allowed to this database or not. Not supported for DataWarehouse edition. | 'Disabled' 'Enabled' | | recoveryServicesRecoveryPointResourceId | Conditional. If createMode is RestoreLongTermRetentionBackup, then this value is required. Specifies the resource ID of the recovery point to restore from. | string | | requestedServiceObjectiveId | The configured service level objective ID of the database. This is the service level objective that is in the process of being applied to the database. Once successfully updated, it will match the value of currentServiceObjectiveId property. If requestedServiceObjectiveId and requestedServiceObjectiveName are both updated, the value of requestedServiceObjectiveId overrides the value of requestedServiceObjectiveName. The list of SKUs may vary by region and support offer. To determine the service objective ids that are available to your subscription in an Azure region, use the `Capabilities_ListByLocation` REST API. | string Constraints: Min length = 36 Max length = 36 Pattern = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$` | | requestedServiceObjectiveName | The name of the configured service level objective of the database. This is the service level objective that is in the process of being applied to the database. Once successfully updated, it will match the value of serviceLevelObjective property. The list of SKUs may vary by region and support offer. To determine the SKUs (including the SKU name, tier/edition, family, and capacity) that are available to your subscription in an Azure region, use the `Capabilities_ListByLocation` REST API or one of the following commands: ```azurecli az sql db list-editions -l <location> -o table 

'''powershell
Get-AzSqlServerServiceObjective -Location <emplacement>
```` | 'De base'
'DS100'
'DS1000'
'DS1200'
'DS1500'
'DS200'
'DS2000'
'DS300'
'DS400'
'DS500'
'DS600'
'DW100'
'DW1000'
'DW10000c'
'DW1000c'
'DW1200'
'DW1500'
'DW15000c'
'DW1500c'
'DW200'
'DW2000'
'DW2000c'
'DW2500c'
'DW300'
'DW3000'
'DW30000c'
'DW3000c'
'DW400'
'DW500'
'DW5000c'
'DW600'
'DW6000'
'DW6000c'
'DW7500c'
'ElasticPool'
'Free'
'P1'
'P11'
'P15'
'P2'
'P3'
'P4'
'P6'
'PRS1'
'PRS2'
'PRS4'
'PRS6'
'S0'
'S1'
'S12'
'S2'
'S3'
'S4'
'S6'
'S7'
'S9'
'System'
'System0'
'System1'
'System2'
'System2L'
'System3'
'System3L'
'System4'
'System4L' | | restorePointInTime | Conditionnel. Si createMode est PointInTimeRestore, cette valeur est requise. Si createMode est Restore, cette valeur est facultative. Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restauré pour créer la nouvelle base de données. Doit être supérieur ou égal à la valeur la plus ancienne de la base de données source. | string | | sampleName | Indique le nom de l’exemple de schéma à appliquer lors de la création de cette base de données. Si createMode n’est pas default, cette valeur est ignorée. Non pris en charge pour l’édition DataWarehouse. | 'AdventureWorksLT' | | sourceDatabaseDeletionDate | Conditionnel. Si createMode est Restore et sourceDatabaseId est l’ID de ressource d’origine de la base de données supprimée lorsqu’elle existait (par opposition à son ID de base de données supprimé pouvant être restauré), cette valeur est requise. Spécifie l’heure à laquelle la base de données a été supprimée. | string | | sourceDatabaseId | Conditionnel. Si createMode est Copy, NonReadableSecondary, OnlineSecondary, PointInTimeRestore, Recovery ou Restore, cette valeur est requise. Spécifie l’ID de ressource de la base de données source. Si createMode est NonReadableSecondary ou OnlineSecondary, le nom de la base de données source doit être identique à celui de la nouvelle base de données en cours de création. | string | | zoneRedundant | Indique si cette base de données est redondante interzone, ce qui signifie que les réplicas de cette base de données seront répartis entre plusieurs zones de disponibilité. | bool |