Partager via


Microsoft.Sql managedInstances

Définition de ressource Bicep

Le type de ressource managedInstances peut être déployé avec des opérations qui ciblent :

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/managedInstances, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Sql/managedInstances@2024-11-01-preview' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    administratorLogin: 'string'
    administratorLoginPassword: 'string'
    administrators: {
      administratorType: 'string'
      azureADOnlyAuthentication: bool
      login: 'string'
      principalType: 'string'
      sid: 'string'
      tenantId: 'string'
    }
    authenticationMetadata: 'string'
    collation: 'string'
    databaseFormat: 'string'
    dnsZonePartner: 'string'
    hybridSecondaryUsage: 'string'
    instancePoolId: 'string'
    isGeneralPurposeV2: bool
    keyId: 'string'
    licenseType: 'string'
    maintenanceConfigurationId: 'string'
    managedInstanceCreateMode: 'string'
    memorySizeInGB: int
    minimalTlsVersion: 'string'
    pricingModel: 'string'
    primaryUserAssignedIdentityId: 'string'
    proxyOverride: 'string'
    publicDataEndpointEnabled: bool
    requestedBackupStorageRedundancy: 'string'
    requestedLogicalAvailabilityZone: 'string'
    restorePointInTime: 'string'
    servicePrincipal: {
      type: 'string'
    }
    sourceManagedInstanceId: 'string'
    storageIOps: int
    storageSizeInGB: int
    storageThroughputMBps: int
    subnetId: 'string'
    timezoneId: 'string'
    vCores: int
    zoneRedundant: bool
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valeurs de propriété

Microsoft.Sql/managedInstances

Name Description Value
identity Identité Azure Active Directory de l’instance managée. ResourceIdentity
location Emplacement des ressources. chaîne (obligatoire)
name Nom de la ressource chaîne (obligatoire)
properties Propriétés de ressource. ManagedInstanceProperties
portée Utilisez-la lors de la création d’une ressource dans une étendue différente de l’étendue de déploiement. Définissez cette propriété sur le nom symbolique d’une ressource pour appliquer la ressource d’extension .
sku Référence SKU d’instance managée. Valeurs autorisées pour sku.name : GP_Gen5 (Usage général, série Standard) ; GP_G8IM (à usage général, série Premium) ; GP_G8IH (à usage général, mémoire optimisée pour la série Premium) ; BC_Gen5 (Critique pour l’entreprise, Standard-Series) ; BC_G8IM (Critique pour l’entreprise, série Premium) ; BC_G8IH (Critique pour l’entreprise, mémoire optimisée pour la série Premium). Sku
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

ManagedInstanceExternalAdministrator

Name Description Value
administratorType Type de l’administrateur de serveur. 'ActiveDirectory'
azureADOnlyAuthentication Authentification Azure Active Directory uniquement activée. bool
login Nom de connexion de l’administrateur du serveur. string
principalType Type de principal de l’administrateur de serveur. 'Application'
'Group'
'User'
sid SID (ID d’objet) de l’administrateur du serveur. string

Constraints:
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
tenantId ID de locataire de l’administrateur. string

Constraints:
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ManagedInstanceProperties

Name Description Value
administratorLogin Nom d’utilisateur administrateur de l’instance managée. Peut être spécifié uniquement lorsque l’instance managée est en cours de création (et est requise pour la création). string
administratorLoginPassword Mot de passe de connexion administrateur (requis pour la création d’une instance managée). string

Constraints:
Valeur sensible. Passez en tant que paramètre sécurisé.
administrators L’administrateur Azure Active Directory peut être utilisé lors de la création et des mises à jour d’instance, à l’exception de la propriété azureADOnlyAuthentication. Pour mettre à jour la propriété azureADOnlyAuthentication, une API individuelle doit être utilisée. ManagedInstanceExternalAdministrator
authenticationMetadata Mode de recherche des métadonnées d’authentification de l’instance managée. 'AzureAD'
'Paired'
'Windows'
collation Classement de l’instance managée. string
databaseFormat Spécifie le format interne des bases de données d’instance spécifiques à la version du moteur SQL. 'AlwaysUpToDate'
'SQLServer2022'
'SQLServer2025'
dnsZonePartner ID de ressource d’une autre instance managée dont la zone DNS que cette instance managée partagera après la création. string
hybridSecondaryUsage Utilisation secondaire hybride. Les valeurs possibles sont « Active » (valeur par défaut) et « Passive » (le client utilise le réplica secondaire comme récupération d’urgence passive). 'Active'
'Passive'
instancePoolId ID du pool d’instances auquel appartient ce serveur managé. string
isGeneralPurposeV2 Indique s’il s’agit d’une variante GPv2 de l’édition Usage général. bool
keyId URI CMK de la clé à utiliser pour le chiffrement. string
licenseType Type de licence. Les valeurs possibles sont « LicenseIncluded » (prix normal inclus d’une nouvelle licence SQL) et « BasePrice » (prix AHB réduit pour apporter vos propres licences SQL). 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Spécifie l’ID de configuration de maintenance à appliquer à cette instance managée. string
managedInstanceCreateMode Spécifie le mode de création de base de données.

Valeur par défaut : création d’une instance régulière.

Restauration : crée une instance en restaurant un ensemble de sauvegardes à un point précis dans le temps. RestorePointInTime et SourceManagedInstanceId doivent être spécifiés.
'Default'
'PointInTimeRestore'
memorySizeInGB Taille de la mémoire en Go. Valeur minimale : 28. Valeur maximale : 870. Les valeurs minimale et maximale dépendent du nombre de vCores et du niveau de service. Pour en savoir plus sur les limites de ressources : https://aka.ms/mi-resource-limits-api. int
minimalTlsVersion Version TLS minimale. Valeurs autorisées : « None », « 1.0 », « 1.1 », « 1.2 » string
pricingModel Modèle de tarification de Managed Instance. 'Freemium'
'Regular'
primaryUserAssignedIdentityId ID de ressource d’une identité affectée par l’utilisateur à utiliser par défaut. string
proxyOverride Type de connexion utilisé pour la connexion à l’instance. 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled Indique si le point de terminaison de données public est activé ou non. bool
requestedBackupStorageRedundancy Type de compte de stockage à utiliser pour stocker des sauvegardes pour cette instance. Les options sont Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) et GeoZone(GeoZoneRedundantStorage) 'Geo'
'GeoZone'
'Local'
'Zone'
requestedLogicalAvailabilityZone Spécifie la zone de disponibilité logique à laquelle Managed Instance est épinglé. '1'
'2'
'3'
'NoPreference'
restorePointInTime 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. string
servicePrincipal Principal de service de l’instance managée. ServicePrincipal
sourceManagedInstanceId Identificateur de ressource de l’instance managée source associée à l’opération de création de cette instance. string
storageIOps E/S de stockage. Valeur minimale : 300. Valeur maximale : 8 0000. Incréments de 1 IOps autorisés uniquement. La valeur maximale dépend de la famille de matériels sélectionnée et du nombre de vCores. int
storageSizeInGB Taille de stockage en Go. Valeur minimale : 32. Valeur maximale : 32768. Incréments de 32 Go autorisés uniquement. La valeur maximale dépend de la famille de matériels sélectionnée et du nombre de vCores. int
storageThroughputMBps Le paramètre MBits/s du débit de stockage n’est pas pris en charge dans l’opération de création/mise à jour de l’instance. int
subnetId ID de ressource de sous-réseau pour l’instance managée. string
timezoneId ID du fuseau horaire. Les valeurs autorisées sont des fuseaux horaires pris en charge par Windows.
Windows conserve les détails sur les fuseaux horaires pris en charge, y compris l’ID, dans le Registre sous
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fuseaux horaires.
Vous pouvez obtenir ces valeurs de Registre via SQL Server en interrogeant le nom SELECT AS timezone_id FROM sys.time_zone_info.
Vous pouvez également obtenir la liste des ID en exécutant [System.TimeZoneInfo] ::GetSystemTimeZones() dans PowerShell.
Un exemple d’ID de fuseau horaire valide est « Pacific Standard Time » ou « W. Heure standard de l’Europe".
string
vCores Nombre de vCores. Valeurs autorisées : 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Les vCores pris en charge dépendent de la famille de matériel et du niveau de service sélectionnés. int
zoneRedundant Indique si la redondance de zone est activée ou non. bool

ResourceIdentity

Name Description Value
type Type d’identité. Définissez cette valeur sur « SystemAssigned » pour créer et affecter automatiquement un principal Azure Active Directory pour la ressource. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities ID de ressource des identités affectées par l’utilisateur à utiliser ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Value

ServicePrincipal

Name Description Value
type Type de principal de service. 'None'
'SystemAssigned'

Sku

Name Description Value
capacity Capacité de la référence SKU particulière. int
family 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. string
name Nom de la référence SKU, généralement une lettre + code numérique, par exemple P3. chaîne (obligatoire)
size Taille de la référence SKU particulière string
tier Niveau ou édition de la référence SKU particulière, par exemple De base, Premium. string

TrackedResourceTags

Name Description Value

UserIdentity

Name Description Value

Exemples d’utilisation

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module Description
SQL Managed Instance Module de ressources AVM pour SQL Managed Instance

Exemples de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.

Fichier Bicep Description
Créer SQL MI à l’intérieur du nouveau réseau virtuel Déployez Azure Sql Database Managed Instance (SQL MI) dans un nouveau réseau virtuel.

Définition de ressource de modèle ARM

Le type de ressource managedInstances peut être déployé avec des opérations qui ciblent :

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/managedInstances, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2024-11-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "administrators": {
      "administratorType": "string",
      "azureADOnlyAuthentication": "bool",
      "login": "string",
      "principalType": "string",
      "sid": "string",
      "tenantId": "string"
    },
    "authenticationMetadata": "string",
    "collation": "string",
    "databaseFormat": "string",
    "dnsZonePartner": "string",
    "hybridSecondaryUsage": "string",
    "instancePoolId": "string",
    "isGeneralPurposeV2": "bool",
    "keyId": "string",
    "licenseType": "string",
    "maintenanceConfigurationId": "string",
    "managedInstanceCreateMode": "string",
    "memorySizeInGB": "int",
    "minimalTlsVersion": "string",
    "pricingModel": "string",
    "primaryUserAssignedIdentityId": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "requestedBackupStorageRedundancy": "string",
    "requestedLogicalAvailabilityZone": "string",
    "restorePointInTime": "string",
    "servicePrincipal": {
      "type": "string"
    },
    "sourceManagedInstanceId": "string",
    "storageIOps": "int",
    "storageSizeInGB": "int",
    "storageThroughputMBps": "int",
    "subnetId": "string",
    "timezoneId": "string",
    "vCores": "int",
    "zoneRedundant": "bool"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valeurs de propriété

Microsoft.Sql/managedInstances

Name Description Value
apiVersion Version de l’API '2024-11-01-preview'
identity Identité Azure Active Directory de l’instance managée. ResourceIdentity
location Emplacement des ressources. chaîne (obligatoire)
name Nom de la ressource chaîne (obligatoire)
properties Propriétés de ressource. ManagedInstanceProperties
sku Référence SKU d’instance managée. Valeurs autorisées pour sku.name : GP_Gen5 (Usage général, série Standard) ; GP_G8IM (à usage général, série Premium) ; GP_G8IH (à usage général, mémoire optimisée pour la série Premium) ; BC_Gen5 (Critique pour l’entreprise, Standard-Series) ; BC_G8IM (Critique pour l’entreprise, série Premium) ; BC_G8IH (Critique pour l’entreprise, mémoire optimisée pour la série Premium). Sku
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.Sql/managedInstances'

ManagedInstanceExternalAdministrator

Name Description Value
administratorType Type de l’administrateur de serveur. 'ActiveDirectory'
azureADOnlyAuthentication Authentification Azure Active Directory uniquement activée. bool
login Nom de connexion de l’administrateur du serveur. string
principalType Type de principal de l’administrateur de serveur. 'Application'
'Group'
'User'
sid SID (ID d’objet) de l’administrateur du serveur. string

Constraints:
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
tenantId ID de locataire de l’administrateur. string

Constraints:
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ManagedInstanceProperties

Name Description Value
administratorLogin Nom d’utilisateur administrateur de l’instance managée. Peut être spécifié uniquement lorsque l’instance managée est en cours de création (et est requise pour la création). string
administratorLoginPassword Mot de passe de connexion administrateur (requis pour la création d’une instance managée). string

Constraints:
Valeur sensible. Passez en tant que paramètre sécurisé.
administrators L’administrateur Azure Active Directory peut être utilisé lors de la création et des mises à jour d’instance, à l’exception de la propriété azureADOnlyAuthentication. Pour mettre à jour la propriété azureADOnlyAuthentication, une API individuelle doit être utilisée. ManagedInstanceExternalAdministrator
authenticationMetadata Mode de recherche des métadonnées d’authentification de l’instance managée. 'AzureAD'
'Paired'
'Windows'
collation Classement de l’instance managée. string
databaseFormat Spécifie le format interne des bases de données d’instance spécifiques à la version du moteur SQL. 'AlwaysUpToDate'
'SQLServer2022'
'SQLServer2025'
dnsZonePartner ID de ressource d’une autre instance managée dont la zone DNS que cette instance managée partagera après la création. string
hybridSecondaryUsage Utilisation secondaire hybride. Les valeurs possibles sont « Active » (valeur par défaut) et « Passive » (le client utilise le réplica secondaire comme récupération d’urgence passive). 'Active'
'Passive'
instancePoolId ID du pool d’instances auquel appartient ce serveur managé. string
isGeneralPurposeV2 Indique s’il s’agit d’une variante GPv2 de l’édition Usage général. bool
keyId URI CMK de la clé à utiliser pour le chiffrement. string
licenseType Type de licence. Les valeurs possibles sont « LicenseIncluded » (prix normal inclus d’une nouvelle licence SQL) et « BasePrice » (prix AHB réduit pour apporter vos propres licences SQL). 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Spécifie l’ID de configuration de maintenance à appliquer à cette instance managée. string
managedInstanceCreateMode Spécifie le mode de création de base de données.

Valeur par défaut : création d’une instance régulière.

Restauration : crée une instance en restaurant un ensemble de sauvegardes à un point précis dans le temps. RestorePointInTime et SourceManagedInstanceId doivent être spécifiés.
'Default'
'PointInTimeRestore'
memorySizeInGB Taille de la mémoire en Go. Valeur minimale : 28. Valeur maximale : 870. Les valeurs minimale et maximale dépendent du nombre de vCores et du niveau de service. Pour en savoir plus sur les limites de ressources : https://aka.ms/mi-resource-limits-api. int
minimalTlsVersion Version TLS minimale. Valeurs autorisées : « None », « 1.0 », « 1.1 », « 1.2 » string
pricingModel Modèle de tarification de Managed Instance. 'Freemium'
'Regular'
primaryUserAssignedIdentityId ID de ressource d’une identité affectée par l’utilisateur à utiliser par défaut. string
proxyOverride Type de connexion utilisé pour la connexion à l’instance. 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled Indique si le point de terminaison de données public est activé ou non. bool
requestedBackupStorageRedundancy Type de compte de stockage à utiliser pour stocker des sauvegardes pour cette instance. Les options sont Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) et GeoZone(GeoZoneRedundantStorage) 'Geo'
'GeoZone'
'Local'
'Zone'
requestedLogicalAvailabilityZone Spécifie la zone de disponibilité logique à laquelle Managed Instance est épinglé. '1'
'2'
'3'
'NoPreference'
restorePointInTime 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. string
servicePrincipal Principal de service de l’instance managée. ServicePrincipal
sourceManagedInstanceId Identificateur de ressource de l’instance managée source associée à l’opération de création de cette instance. string
storageIOps E/S de stockage. Valeur minimale : 300. Valeur maximale : 8 0000. Incréments de 1 IOps autorisés uniquement. La valeur maximale dépend de la famille de matériels sélectionnée et du nombre de vCores. int
storageSizeInGB Taille de stockage en Go. Valeur minimale : 32. Valeur maximale : 32768. Incréments de 32 Go autorisés uniquement. La valeur maximale dépend de la famille de matériels sélectionnée et du nombre de vCores. int
storageThroughputMBps Le paramètre MBits/s du débit de stockage n’est pas pris en charge dans l’opération de création/mise à jour de l’instance. int
subnetId ID de ressource de sous-réseau pour l’instance managée. string
timezoneId ID du fuseau horaire. Les valeurs autorisées sont des fuseaux horaires pris en charge par Windows.
Windows conserve les détails sur les fuseaux horaires pris en charge, y compris l’ID, dans le Registre sous
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fuseaux horaires.
Vous pouvez obtenir ces valeurs de Registre via SQL Server en interrogeant le nom SELECT AS timezone_id FROM sys.time_zone_info.
Vous pouvez également obtenir la liste des ID en exécutant [System.TimeZoneInfo] ::GetSystemTimeZones() dans PowerShell.
Un exemple d’ID de fuseau horaire valide est « Pacific Standard Time » ou « W. Heure standard de l’Europe".
string
vCores Nombre de vCores. Valeurs autorisées : 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Les vCores pris en charge dépendent de la famille de matériel et du niveau de service sélectionnés. int
zoneRedundant Indique si la redondance de zone est activée ou non. bool

ResourceIdentity

Name Description Value
type Type d’identité. Définissez cette valeur sur « SystemAssigned » pour créer et affecter automatiquement un principal Azure Active Directory pour la ressource. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities ID de ressource des identités affectées par l’utilisateur à utiliser ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Value

ServicePrincipal

Name Description Value
type Type de principal de service. 'None'
'SystemAssigned'

Sku

Name Description Value
capacity Capacité de la référence SKU particulière. int
family 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. string
name Nom de la référence SKU, généralement une lettre + code numérique, par exemple P3. chaîne (obligatoire)
size Taille de la référence SKU particulière string
tier Niveau ou édition de la référence SKU particulière, par exemple De base, Premium. string

TrackedResourceTags

Name Description Value

UserIdentity

Name Description Value

Exemples d’utilisation

Modèles de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants déployer ce type de ressource.

Template Description
Créer SQL MI à l’intérieur du nouveau réseau virtuel

Déployer sur Azure
Déployez Azure Sql Database Managed Instance (SQL MI) dans un nouveau réseau virtuel.
créer sql MI avec l’envoi configuré de journaux et de métriques

Déployer sur Azure
Ce modèle vous permet de déployer SQL MI et des ressources supplémentaires utilisées pour stocker les journaux et les métriques (espace de travail de diagnostic, compte de stockage, event Hub).
Créer sql MI avec jumpbox à l’intérieur d’un nouveau réseau virtuel

Déployer sur Azure
Déployez Azure Sql Database Managed Instance (SQL MI) et JumpBox avec SSMS dans un nouveau réseau virtuel.
Créer un mi SQL avec une connexion point à site configurée

Déployer sur Azure
Déployez Azure Sql Database Managed Instance (SQL MI) et la passerelle de réseau virtuel configurée pour une connexion point à site à l’intérieur du nouveau réseau virtuel.
Déployer SQL Managed Instance avec mise en réseau

Déployer sur Azure
Déployer UDR et NSG pour prendre en charge Azure SQL Managed Instance et déployer Managed Instance

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource managedInstances peut être déployé avec des opérations qui ciblent :

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/managedInstances, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2024-11-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      administrators = {
        administratorType = "string"
        azureADOnlyAuthentication = bool
        login = "string"
        principalType = "string"
        sid = "string"
        tenantId = "string"
      }
      authenticationMetadata = "string"
      collation = "string"
      databaseFormat = "string"
      dnsZonePartner = "string"
      hybridSecondaryUsage = "string"
      instancePoolId = "string"
      isGeneralPurposeV2 = bool
      keyId = "string"
      licenseType = "string"
      maintenanceConfigurationId = "string"
      managedInstanceCreateMode = "string"
      memorySizeInGB = int
      minimalTlsVersion = "string"
      pricingModel = "string"
      primaryUserAssignedIdentityId = "string"
      proxyOverride = "string"
      publicDataEndpointEnabled = bool
      requestedBackupStorageRedundancy = "string"
      requestedLogicalAvailabilityZone = "string"
      restorePointInTime = "string"
      servicePrincipal = {
        type = "string"
      }
      sourceManagedInstanceId = "string"
      storageIOps = int
      storageSizeInGB = int
      storageThroughputMBps = int
      subnetId = "string"
      timezoneId = "string"
      vCores = int
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

Valeurs de propriété

Microsoft.Sql/managedInstances

Name Description Value
identity Identité Azure Active Directory de l’instance managée. ResourceIdentity
location Emplacement des ressources. chaîne (obligatoire)
name Nom de la ressource chaîne (obligatoire)
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. chaîne (obligatoire)
properties Propriétés de ressource. ManagedInstanceProperties
sku Référence SKU d’instance managée. Valeurs autorisées pour sku.name : GP_Gen5 (Usage général, série Standard) ; GP_G8IM (à usage général, série Premium) ; GP_G8IH (à usage général, mémoire optimisée pour la série Premium) ; BC_Gen5 (Critique pour l’entreprise, Standard-Series) ; BC_G8IM (Critique pour l’entreprise, série Premium) ; BC_G8IH (Critique pour l’entreprise, mémoire optimisée pour la série Premium). Sku
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.Sql/managedInstances@2024-11-01-preview »

ManagedInstanceExternalAdministrator

Name Description Value
administratorType Type de l’administrateur de serveur. 'ActiveDirectory'
azureADOnlyAuthentication Authentification Azure Active Directory uniquement activée. bool
login Nom de connexion de l’administrateur du serveur. string
principalType Type de principal de l’administrateur de serveur. 'Application'
'Group'
'User'
sid SID (ID d’objet) de l’administrateur du serveur. string

Constraints:
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
tenantId ID de locataire de l’administrateur. string

Constraints:
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ManagedInstanceProperties

Name Description Value
administratorLogin Nom d’utilisateur administrateur de l’instance managée. Peut être spécifié uniquement lorsque l’instance managée est en cours de création (et est requise pour la création). string
administratorLoginPassword Mot de passe de connexion administrateur (requis pour la création d’une instance managée). string

Constraints:
Valeur sensible. Passez en tant que paramètre sécurisé.
administrators L’administrateur Azure Active Directory peut être utilisé lors de la création et des mises à jour d’instance, à l’exception de la propriété azureADOnlyAuthentication. Pour mettre à jour la propriété azureADOnlyAuthentication, une API individuelle doit être utilisée. ManagedInstanceExternalAdministrator
authenticationMetadata Mode de recherche des métadonnées d’authentification de l’instance managée. 'AzureAD'
'Paired'
'Windows'
collation Classement de l’instance managée. string
databaseFormat Spécifie le format interne des bases de données d’instance spécifiques à la version du moteur SQL. 'AlwaysUpToDate'
'SQLServer2022'
'SQLServer2025'
dnsZonePartner ID de ressource d’une autre instance managée dont la zone DNS que cette instance managée partagera après la création. string
hybridSecondaryUsage Utilisation secondaire hybride. Les valeurs possibles sont « Active » (valeur par défaut) et « Passive » (le client utilise le réplica secondaire comme récupération d’urgence passive). 'Active'
'Passive'
instancePoolId ID du pool d’instances auquel appartient ce serveur managé. string
isGeneralPurposeV2 Indique s’il s’agit d’une variante GPv2 de l’édition Usage général. bool
keyId URI CMK de la clé à utiliser pour le chiffrement. string
licenseType Type de licence. Les valeurs possibles sont « LicenseIncluded » (prix normal inclus d’une nouvelle licence SQL) et « BasePrice » (prix AHB réduit pour apporter vos propres licences SQL). 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Spécifie l’ID de configuration de maintenance à appliquer à cette instance managée. string
managedInstanceCreateMode Spécifie le mode de création de base de données.

Valeur par défaut : création d’une instance régulière.

Restauration : crée une instance en restaurant un ensemble de sauvegardes à un point précis dans le temps. RestorePointInTime et SourceManagedInstanceId doivent être spécifiés.
'Default'
'PointInTimeRestore'
memorySizeInGB Taille de la mémoire en Go. Valeur minimale : 28. Valeur maximale : 870. Les valeurs minimale et maximale dépendent du nombre de vCores et du niveau de service. Pour en savoir plus sur les limites de ressources : https://aka.ms/mi-resource-limits-api. int
minimalTlsVersion Version TLS minimale. Valeurs autorisées : « None », « 1.0 », « 1.1 », « 1.2 » string
pricingModel Modèle de tarification de Managed Instance. 'Freemium'
'Regular'
primaryUserAssignedIdentityId ID de ressource d’une identité affectée par l’utilisateur à utiliser par défaut. string
proxyOverride Type de connexion utilisé pour la connexion à l’instance. 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled Indique si le point de terminaison de données public est activé ou non. bool
requestedBackupStorageRedundancy Type de compte de stockage à utiliser pour stocker des sauvegardes pour cette instance. Les options sont Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) et GeoZone(GeoZoneRedundantStorage) 'Geo'
'GeoZone'
'Local'
'Zone'
requestedLogicalAvailabilityZone Spécifie la zone de disponibilité logique à laquelle Managed Instance est épinglé. '1'
'2'
'3'
'NoPreference'
restorePointInTime 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. string
servicePrincipal Principal de service de l’instance managée. ServicePrincipal
sourceManagedInstanceId Identificateur de ressource de l’instance managée source associée à l’opération de création de cette instance. string
storageIOps E/S de stockage. Valeur minimale : 300. Valeur maximale : 8 0000. Incréments de 1 IOps autorisés uniquement. La valeur maximale dépend de la famille de matériels sélectionnée et du nombre de vCores. int
storageSizeInGB Taille de stockage en Go. Valeur minimale : 32. Valeur maximale : 32768. Incréments de 32 Go autorisés uniquement. La valeur maximale dépend de la famille de matériels sélectionnée et du nombre de vCores. int
storageThroughputMBps Le paramètre MBits/s du débit de stockage n’est pas pris en charge dans l’opération de création/mise à jour de l’instance. int
subnetId ID de ressource de sous-réseau pour l’instance managée. string
timezoneId ID du fuseau horaire. Les valeurs autorisées sont des fuseaux horaires pris en charge par Windows.
Windows conserve les détails sur les fuseaux horaires pris en charge, y compris l’ID, dans le Registre sous
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fuseaux horaires.
Vous pouvez obtenir ces valeurs de Registre via SQL Server en interrogeant le nom SELECT AS timezone_id FROM sys.time_zone_info.
Vous pouvez également obtenir la liste des ID en exécutant [System.TimeZoneInfo] ::GetSystemTimeZones() dans PowerShell.
Un exemple d’ID de fuseau horaire valide est « Pacific Standard Time » ou « W. Heure standard de l’Europe".
string
vCores Nombre de vCores. Valeurs autorisées : 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Les vCores pris en charge dépendent de la famille de matériel et du niveau de service sélectionnés. int
zoneRedundant Indique si la redondance de zone est activée ou non. bool

ResourceIdentity

Name Description Value
type Type d’identité. Définissez cette valeur sur « SystemAssigned » pour créer et affecter automatiquement un principal Azure Active Directory pour la ressource. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities ID de ressource des identités affectées par l’utilisateur à utiliser ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Value

ServicePrincipal

Name Description Value
type Type de principal de service. 'None'
'SystemAssigned'

Sku

Name Description Value
capacity Capacité de la référence SKU particulière. int
family 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. string
name Nom de la référence SKU, généralement une lettre + code numérique, par exemple P3. chaîne (obligatoire)
size Taille de la référence SKU particulière string
tier Niveau ou édition de la référence SKU particulière, par exemple De base, Premium. string

TrackedResourceTags

Name Description Value

UserIdentity

Name Description Value

Exemples d’utilisation

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module Description
SQL Managed Instance Module de ressources AVM pour SQL Managed Instance