Microsoft.DBforMySQL/servers - Bicep, ARM template & Terraform AzAPI reference

Définition de ressource Bicep

Le type de ressource des serveurs 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.DBforMySQL/servers, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.DBforMySQL/servers@2017-12-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    infrastructureEncryption: 'string'
    minimalTlsVersion: 'string'
    publicNetworkAccess: 'string'
    sslEnforcement: 'string'
    storageProfile: {
      backupRetentionDays: int
      geoRedundantBackup: 'string'
      storageAutogrow: 'string'
      storageMB: int
    }
    version: 'string'
    createMode: 'string'
    // For remaining properties, see ServerPropertiesForCreateOrServerProperties objects
  }
}

Objets ServerPropertiesForCreateOrServerProperties

Définissez la propriété createMode pour spécifier le type d’objet.

Pour par défaut, utilisez :

  createMode: 'Default'
  administratorLogin: 'string'
  administratorLoginPassword: 'string'

Pour GeoRestore, utilisez :

  createMode: 'GeoRestore'
  sourceServerId: 'string'

Pour PointInTimeRestore, utilisez :

  createMode: 'PointInTimeRestore'
  restorePointInTime: 'string'
  sourceServerId: 'string'

Pour réplica, utilisez :

Note

L’utilisation d’un modèle pour créer un serveur MySQL avec la valeur replica n’est pas idempotente. Le serveur est créé avec succès la première fois. Toutefois, le déploiement du modèle lorsque le serveur réplica existe déjà retourne une erreur.

  createMode: 'Replica'
  sourceServerId: 'string'

Valeurs de propriété

Serveurs

Nom	Description	Valeur
nom	Nom de la ressource	chaîne (obligatoire) Limite de caractères : 3 à 63 Caractères valides : Lettres minuscules, traits d’union et chiffres. Impossible de commencer ou de se terminer par un trait d’union. Le nom de la ressource doit être unique dans Azure.
emplacement	Emplacement dans lequel réside la ressource.	chaîne (obligatoire)
étiquettes	Métadonnées spécifiques à l’application sous la forme de paires clé-valeur.	Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
Sku	Référence SKU (niveau tarifaire) du serveur.	référence SKU
identité	Identité Azure Active Directory du serveur.	ResourceIdentity
Propriétés	Propriétés du serveur.	ServerPropertiesForCreateOrServerProperties (obligatoire)

ResourceIdentity

Nom	Description	Valeur
type	Type d’identité. Définissez cette valeur sur « SystemAssigned » pour créer et affecter automatiquement un principal Azure Active Directory pour la ressource.	'SystemAssigned'

ServerPropertiesForCreateOrServerProperties

Nom	Description	Valeur
infrastructureEncryption	État montrant si le chiffrement d’infrastructure activé par le serveur.	'Désactivé' 'Activé'
minimalTlsVersion	Appliquez une version minimale de Tls pour le serveur.	'TLS1_0' 'TLS1_1' 'TLS1_2' 'TLSEnforcementDisabled'
publicNetworkAccess	Indique si l’accès au réseau public est autorisé pour ce serveur. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé »	'Désactivé' 'Activé'
sslEnforcement	Activez l’application ssl ou non lors de la connexion au serveur.	'Désactivé' 'Activé'
storageProfile	Profil de stockage d’un serveur.	StorageProfile
Version	Version du serveur.	'5.6' '5.7' '8.0'
createMode	Définir le type d’objet	par défaut geoRestore PointInTimeRestore réplica (obligatoire)

StorageProfile

Nom	Description	Valeur
backupRetentionDays	Jours de rétention de sauvegarde pour le serveur.	Int
geoRedundantBackup	Activez la sauvegarde géoredondante ou non pour la sauvegarde du serveur.	'Désactivé' 'Activé'
storageAutogrow	Activer la croissance automatique du stockage.	'Désactivé' 'Activé'
storageMB	Stockage maximal autorisé pour un serveur.	Int

ServerPropertiesForDefaultCreate

Nom	Description	Valeur
createMode	Mode de création d’un serveur.	'Default' (obligatoire)
administratorLogin	Nom de connexion de l’administrateur d’un serveur. Ne peut être spécifié que lorsque le serveur est en cours de création (et est requis pour la création). Le nom de connexion est requis lors de la mise à jour du mot de passe.	chaîne (obligatoire)
administratorLoginPassword	Mot de passe de la connexion administrateur.	chaîne (obligatoire) Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé.

ServerPropertiesForGeoRestore

Nom	Description	Valeur
createMode	Mode de création d’un serveur.	'GeoRestore' (obligatoire)
sourceServerId	ID du serveur source à partir duquel effectuer la restauration.	chaîne (obligatoire)

ServerPropertiesForRestore

Nom	Description	Valeur
createMode	Mode de création d’un serveur.	'PointInTimeRestore' (obligatoire)
restorePointInTime	Heure de création du point de restauration (format ISO8601), en spécifiant l’heure de restauration à partir de laquelle effectuer la restauration.	chaîne (obligatoire)
sourceServerId	ID du serveur source à partir duquel effectuer la restauration.	chaîne (obligatoire)

ServerPropertiesForReplica

Nom	Description	Valeur
createMode	Mode de création d’un serveur.	'Replica' (obligatoire)
sourceServerId	ID de serveur principal à partir duquel créer un réplica.	chaîne (obligatoire)

Sku

Nom	Description	Valeur
capacité	Capacité de montée en puissance/sortie représentant les unités de calcul du serveur.	Int Contraintes: Valeur minimale = 0
Famille	Famille de matériel.	corde
nom	Nom de la référence SKU, généralement de niveau + famille + cœurs, par exemple B_Gen4_1, GP_Gen5_8.	chaîne (obligatoire)
taille	Code de taille, à interpréter par ressource selon le cas.	corde
niveau	Niveau de la référence SKU particulière, par exemple De base.	'De base' 'GeneralPurpose' 'MemoryOptimized'

Modèles de démarrage rapide

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

Modèle	Description
Buffalo Web App	Commencez à exécuter votre application Golang Buffalo sur Azure rapidement et à moindre coût.
CI/CD Java à l’aide de Jenkins et d’Azure Web Apps	Il s’agit d’un exemple pour java CI/CD à l’aide de Jenkins et d’Azure Web Apps.
Déploie 1 instance PaaS MySQL et jusqu’à 5 réplicas en lecture seule	Ce modèle déploie une instance de serveur PaaS MySQL, et de 0 à 5 réplicas en lecture seule. Ils seront tous définis sur le même emplacement que le maître et la réplication seront automatiquement configurés.
déployer Azure Database pour MySQL avec de réseau virtuel	Ce modèle permet de déployer une base de données Azure pour MySQL avec l’intégration au réseau virtuel.
Application Gateway pour une application web avec de restriction IP	Ce modèle crée une passerelle d’application devant une application web Azure avec une restriction IP activée sur l’application web.
Créer une application web sur Linux avec une base de données Azure pour MySQL	Ce modèle permet de déployer Web Apps sur Linux avec Azure Database pour MySQL.
Application web Docker Sonarqube sur Linux avec MySQL	Ce modèle offre un moyen simple de déployer une image Docker Sonarqube (balise alpine) sur une application web Linux avec une base de données Azure pour MySQL
Web App avec la base de données Azure pour MySQL	Ce modèle offre un moyen simple de déployer une application web sur Azure App Service Web Apps avec la base de données Azure pour MySQL.

Définition de ressource de modèle ARM

Le type de ressource des serveurs 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.DBforMySQL/servers, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.DBforMySQL/servers",
  "apiVersion": "2017-12-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "identity": {
    "type": "SystemAssigned"
  },
  "properties": {
    "infrastructureEncryption": "string",
    "minimalTlsVersion": "string",
    "publicNetworkAccess": "string",
    "sslEnforcement": "string",
    "storageProfile": {
      "backupRetentionDays": "int",
      "geoRedundantBackup": "string",
      "storageAutogrow": "string",
      "storageMB": "int"
    },
    "version": "string",
    "createMode": "string"
    // For remaining properties, see ServerPropertiesForCreateOrServerProperties objects
  }
}

Objets ServerPropertiesForCreateOrServerProperties

Définissez la propriété createMode pour spécifier le type d’objet.

Pour par défaut, utilisez :

  "createMode": "Default",
  "administratorLogin": "string",
  "administratorLoginPassword": "string"

Pour GeoRestore, utilisez :

  "createMode": "GeoRestore",
  "sourceServerId": "string"

Pour PointInTimeRestore, utilisez :

  "createMode": "PointInTimeRestore",
  "restorePointInTime": "string",
  "sourceServerId": "string"

Pour réplica, utilisez :

Note

L’utilisation d’un modèle pour créer un serveur MySQL avec la valeur replica n’est pas idempotente. Le serveur est créé avec succès la première fois. Toutefois, le déploiement du modèle lorsque le serveur réplica existe déjà retourne une erreur.

  "createMode": "Replica",
  "sourceServerId": "string"

Valeurs de propriété

Serveurs

Nom	Description	Valeur
type	Type de ressource	'Microsoft.DBforMySQL/servers'
apiVersion	Version de l’API de ressource	'2017-12-01'
nom	Nom de la ressource	chaîne (obligatoire) Limite de caractères : 3 à 63 Caractères valides : Lettres minuscules, traits d’union et chiffres. Impossible de commencer ou de se terminer par un trait d’union. Le nom de la ressource doit être unique dans Azure.
emplacement	Emplacement dans lequel réside la ressource.	chaîne (obligatoire)
étiquettes	Métadonnées spécifiques à l’application sous la forme de paires clé-valeur.	Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
Sku	Référence SKU (niveau tarifaire) du serveur.	référence SKU
identité	Identité Azure Active Directory du serveur.	ResourceIdentity
Propriétés	Propriétés du serveur.	ServerPropertiesForCreateOrServerProperties (obligatoire)

ResourceIdentity

Nom	Description	Valeur
type	Type d’identité. Définissez cette valeur sur « SystemAssigned » pour créer et affecter automatiquement un principal Azure Active Directory pour la ressource.	'SystemAssigned'

ServerPropertiesForCreateOrServerProperties

Nom	Description	Valeur
infrastructureEncryption	État montrant si le chiffrement d’infrastructure activé par le serveur.	'Désactivé' 'Activé'
minimalTlsVersion	Appliquez une version minimale de Tls pour le serveur.	'TLS1_0' 'TLS1_1' 'TLS1_2' 'TLSEnforcementDisabled'
publicNetworkAccess	Indique si l’accès au réseau public est autorisé pour ce serveur. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé »	'Désactivé' 'Activé'
sslEnforcement	Activez l’application ssl ou non lors de la connexion au serveur.	'Désactivé' 'Activé'
storageProfile	Profil de stockage d’un serveur.	StorageProfile
Version	Version du serveur.	'5.6' '5.7' '8.0'
createMode	Définir le type d’objet	par défaut geoRestore PointInTimeRestore réplica (obligatoire)

StorageProfile

Nom	Description	Valeur
backupRetentionDays	Jours de rétention de sauvegarde pour le serveur.	Int
geoRedundantBackup	Activez la sauvegarde géoredondante ou non pour la sauvegarde du serveur.	'Désactivé' 'Activé'
storageAutogrow	Activer la croissance automatique du stockage.	'Désactivé' 'Activé'
storageMB	Stockage maximal autorisé pour un serveur.	Int

ServerPropertiesForDefaultCreate

Nom	Description	Valeur
createMode	Mode de création d’un serveur.	'Default' (obligatoire)
administratorLogin	Nom de connexion de l’administrateur d’un serveur. Ne peut être spécifié que lorsque le serveur est en cours de création (et est requis pour la création). Le nom de connexion est requis lors de la mise à jour du mot de passe.	chaîne (obligatoire)
administratorLoginPassword	Mot de passe de la connexion administrateur.	chaîne (obligatoire) Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé.

ServerPropertiesForGeoRestore

Nom	Description	Valeur
createMode	Mode de création d’un serveur.	'GeoRestore' (obligatoire)
sourceServerId	ID du serveur source à partir duquel effectuer la restauration.	chaîne (obligatoire)

ServerPropertiesForRestore

Nom	Description	Valeur
createMode	Mode de création d’un serveur.	'PointInTimeRestore' (obligatoire)
restorePointInTime	Heure de création du point de restauration (format ISO8601), en spécifiant l’heure de restauration à partir de laquelle effectuer la restauration.	chaîne (obligatoire)
sourceServerId	ID du serveur source à partir duquel effectuer la restauration.	chaîne (obligatoire)

ServerPropertiesForReplica

Nom	Description	Valeur
createMode	Mode de création d’un serveur.	'Replica' (obligatoire)
sourceServerId	ID de serveur principal à partir duquel créer un réplica.	chaîne (obligatoire)

Sku

Nom	Description	Valeur
capacité	Capacité de montée en puissance/sortie représentant les unités de calcul du serveur.	Int Contraintes: Valeur minimale = 0
Famille	Famille de matériel.	corde
nom	Nom de la référence SKU, généralement de niveau + famille + cœurs, par exemple B_Gen4_1, GP_Gen5_8.	chaîne (obligatoire)
taille	Code de taille, à interpréter par ressource selon le cas.	corde
niveau	Niveau de la référence SKU particulière, par exemple De base.	'De base' 'GeneralPurpose' 'MemoryOptimized'

Modèles de démarrage rapide

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

Modèle	Description
Buffalo Web App	Commencez à exécuter votre application Golang Buffalo sur Azure rapidement et à moindre coût.
CI/CD Java à l’aide de Jenkins et d’Azure Web Apps	Il s’agit d’un exemple pour java CI/CD à l’aide de Jenkins et d’Azure Web Apps.
Déploie 1 instance PaaS MySQL et jusqu’à 5 réplicas en lecture seule	Ce modèle déploie une instance de serveur PaaS MySQL, et de 0 à 5 réplicas en lecture seule. Ils seront tous définis sur le même emplacement que le maître et la réplication seront automatiquement configurés.
déployer Azure Database pour MySQL avec de réseau virtuel	Ce modèle permet de déployer une base de données Azure pour MySQL avec l’intégration au réseau virtuel.
Application Gateway pour une application web avec de restriction IP	Ce modèle crée une passerelle d’application devant une application web Azure avec une restriction IP activée sur l’application web.
Créer une application web sur Linux avec une base de données Azure pour MySQL	Ce modèle permet de déployer Web Apps sur Linux avec Azure Database pour MySQL.
Application web Docker Sonarqube sur Linux avec MySQL	Ce modèle offre un moyen simple de déployer une image Docker Sonarqube (balise alpine) sur une application web Linux avec une base de données Azure pour MySQL
Web App avec la base de données Azure pour MySQL	Ce modèle offre un moyen simple de déployer une application web sur Azure App Service Web Apps avec la base de données Azure pour MySQL.

Définition de ressource Terraform (fournisseur AzAPI)

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DBforMySQL/servers@2017-12-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "SystemAssigned"
  }
  body = jsonencode({
    properties = {
      infrastructureEncryption = "string"
      minimalTlsVersion = "string"
      publicNetworkAccess = "string"
      sslEnforcement = "string"
      storageProfile = {
        backupRetentionDays = int
        geoRedundantBackup = "string"
        storageAutogrow = "string"
        storageMB = int
      }
      version = "string"
      createMode = "string"
      // For remaining properties, see ServerPropertiesForCreateOrServerProperties objects
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  })
}

Objets ServerPropertiesForCreateOrServerProperties

Définissez la propriété createMode pour spécifier le type d’objet.

Pour par défaut, utilisez :

  createMode = "Default"
  administratorLogin = "string"
  administratorLoginPassword = "string"

Pour GeoRestore, utilisez :

  createMode = "GeoRestore"
  sourceServerId = "string"

Pour PointInTimeRestore, utilisez :

  createMode = "PointInTimeRestore"
  restorePointInTime = "string"
  sourceServerId = "string"

Pour réplica, utilisez :

Note

L’utilisation d’un modèle pour créer un serveur MySQL avec la valeur replica n’est pas idempotente. Le serveur est créé avec succès la première fois. Toutefois, le déploiement du modèle lorsque le serveur réplica existe déjà retourne une erreur.

  createMode = "Replica"
  sourceServerId = "string"

Valeurs de propriété

Serveurs

Nom	Description	Valeur
type	Type de ressource	« Microsoft.DBforMySQL/servers@2017-12-01 »
nom	Nom de la ressource	chaîne (obligatoire) Limite de caractères : 3 à 63 Caractères valides : Lettres minuscules, traits d’union et chiffres. Impossible de commencer ou de se terminer par un trait d’union. Le nom de la ressource doit être unique dans Azure.
emplacement	Emplacement dans lequel réside la ressource.	chaîne (obligatoire)
parent_id	Pour effectuer un déploiement sur un groupe de ressources, utilisez l’ID de ce groupe de ressources.	chaîne (obligatoire)
étiquettes	Métadonnées spécifiques à l’application sous la forme de paires clé-valeur.	Dictionnaire de noms et de valeurs d’étiquettes.
Sku	Référence SKU (niveau tarifaire) du serveur.	référence SKU
identité	Identité Azure Active Directory du serveur.	ResourceIdentity
Propriétés	Propriétés du serveur.	ServerPropertiesForCreateOrServerProperties (obligatoire)

ResourceIdentity

Nom	Description	Valeur
type	Type d’identité. Définissez cette valeur sur « SystemAssigned » pour créer et affecter automatiquement un principal Azure Active Directory pour la ressource.	« SystemAssigned »

ServerPropertiesForCreateOrServerProperties

Nom	Description	Valeur
infrastructureEncryption	État montrant si le chiffrement d’infrastructure activé par le serveur.	« Désactivé » « Activé »
minimalTlsVersion	Appliquez une version minimale de Tls pour le serveur.	« TLS1_0 » « TLS1_1 » « TLS1_2 » « TLSEnforcementDisabled »
publicNetworkAccess	Indique si l’accès au réseau public est autorisé pour ce serveur. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé »	« Désactivé » « Activé »
sslEnforcement	Activez l’application ssl ou non lors de la connexion au serveur.	« Désactivé » « Activé »
storageProfile	Profil de stockage d’un serveur.	StorageProfile
Version	Version du serveur.	"5.6" "5.7" "8.0"
createMode	Définir le type d’objet	par défaut geoRestore PointInTimeRestore réplica (obligatoire)

StorageProfile

Nom	Description	Valeur
backupRetentionDays	Jours de rétention de sauvegarde pour le serveur.	Int
geoRedundantBackup	Activez la sauvegarde géoredondante ou non pour la sauvegarde du serveur.	« Désactivé » « Activé »
storageAutogrow	Activer la croissance automatique du stockage.	« Désactivé » « Activé »
storageMB	Stockage maximal autorisé pour un serveur.	Int

ServerPropertiesForDefaultCreate

Nom	Description	Valeur
createMode	Mode de création d’un serveur.	« Par défaut » (obligatoire)
administratorLogin	Nom de connexion de l’administrateur d’un serveur. Ne peut être spécifié que lorsque le serveur est en cours de création (et est requis pour la création). Le nom de connexion est requis lors de la mise à jour du mot de passe.	chaîne (obligatoire)
administratorLoginPassword	Mot de passe de la connexion administrateur.	chaîne (obligatoire) Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé.

ServerPropertiesForGeoRestore

Nom	Description	Valeur
createMode	Mode de création d’un serveur.	« GeoRestore » (obligatoire)
sourceServerId	ID du serveur source à partir duquel effectuer la restauration.	chaîne (obligatoire)

ServerPropertiesForRestore

Nom	Description	Valeur
createMode	Mode de création d’un serveur.	« PointInTimeRestore » (obligatoire)
restorePointInTime	Heure de création du point de restauration (format ISO8601), en spécifiant l’heure de restauration à partir de laquelle effectuer la restauration.	chaîne (obligatoire)
sourceServerId	ID du serveur source à partir duquel effectuer la restauration.	chaîne (obligatoire)

ServerPropertiesForReplica

Nom	Description	Valeur
createMode	Mode de création d’un serveur.	« Réplica » (obligatoire)
sourceServerId	ID de serveur principal à partir duquel créer un réplica.	chaîne (obligatoire)

Sku

Nom	Description	Valeur
capacité	Capacité de montée en puissance/sortie représentant les unités de calcul du serveur.	Int Contraintes: Valeur minimale = 0
Famille	Famille de matériel.	corde
nom	Nom de la référence SKU, généralement de niveau + famille + cœurs, par exemple B_Gen4_1, GP_Gen5_8.	chaîne (obligatoire)
taille	Code de taille, à interpréter par ressource selon le cas.	corde
niveau	Niveau de la référence SKU particulière, par exemple De base.	« De base » « GeneralPurpose » « MemoryOptimized »

Partager via

Serveurs Microsoft.DBforMySQL

Définition de ressource Bicep

Format de ressource

Objets ServerPropertiesForCreateOrServerProperties

Valeurs de propriété

Serveurs

ResourceIdentity

ServerPropertiesForCreateOrServerProperties

StorageProfile

ServerPropertiesForDefaultCreate

ServerPropertiesForGeoRestore

ServerPropertiesForRestore

ServerPropertiesForReplica

Sku

Modèles de démarrage rapide

Définition de ressource de modèle ARM

Format de ressource

Objets ServerPropertiesForCreateOrServerProperties

Valeurs de propriété

Serveurs

ResourceIdentity

ServerPropertiesForCreateOrServerProperties

StorageProfile

ServerPropertiesForDefaultCreate

ServerPropertiesForGeoRestore

ServerPropertiesForRestore

ServerPropertiesForReplica

Sku

Modèles de démarrage rapide

Définition de ressource Terraform (fournisseur AzAPI)

Format de ressource

Objets ServerPropertiesForCreateOrServerProperties

Valeurs de propriété

Serveurs

ResourceIdentity

ServerPropertiesForCreateOrServerProperties

StorageProfile

ServerPropertiesForDefaultCreate

ServerPropertiesForGeoRestore

ServerPropertiesForRestore

ServerPropertiesForReplica

Sku

Commentaires

Ressources supplémentaires