Microsoft.AppPlatform Printemps/applications 2022-12-01

Remarques

Note : Azure Spring Apps Applications (Microsoft.AppPlatform/Spring/apps) est désormais désolé et sera retiré du service le 31-05-2028. Pour plus d’informations, consultez https://aka.ms/asaretirement.

Définition de ressource Bicep

Le type de ressource Spring/apps 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.AppPlatform/Spring/apps, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.AppPlatform/Spring/apps@2022-12-01' = {
  parent: resourceSymbolicName
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    addonConfigs: {
      {customized property}: any(...)
    }
    customPersistentDisks: [
      {
        customPersistentDiskProperties: {
          mountOptions: [
            'string'
          ]
          mountPath: 'string'
          readOnly: bool
          type: 'string'
          // For remaining properties, see CustomPersistentDiskProperties objects
        }
        storageId: 'string'
      }
    ]
    enableEndToEndTLS: bool
    httpsOnly: bool
    ingressSettings: {
      backendProtocol: 'string'
      clientAuth: {
        certificates: [
          'string'
        ]
      }
      readTimeoutInSeconds: int
      sendTimeoutInSeconds: int
      sessionAffinity: 'string'
      sessionCookieMaxAge: int
    }
    loadedCertificates: [
      {
        loadTrustStore: bool
        resourceId: 'string'
      }
    ]
    persistentDisk: {
      mountPath: 'string'
      sizeInGB: int
    }
    public: bool
    temporaryDisk: {
      mountPath: 'string'
      sizeInGB: int
    }
    vnetAddons: {
      publicEndpoint: bool
    }
  }
}

Objets CustomPersistentDiskProperties

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

Pour AzureFileVolume, utilisez :

{
  shareName: 'string'
  type: 'AzureFileVolume'
}

Valeurs de propriété

Microsoft.AppPlatform/Spring/apps

Nom Descriptif Valeur
identité Type d’identité managée de la ressource d’application ManagedIdentityProperties
emplacement Emplacement GEO de l’application, toujours identique à sa ressource parente corde
nom Nom de la ressource chaîne (obligatoire)
parent Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez ressource enfant en dehors de la ressource parente.
Nom symbolique de la ressource de type : Spring
Propriétés Propriétés de la ressource d’application AppResourceProperties

AppResourceProperties

Nom Descriptif Valeur
addonConfigs Collection de compléments AppResourcePropertiesAddonConfigs
customPersistentDisks Liste des disques persistants personnalisés CustomPersistentDiskResource[]
enableEndToEndTLS Indiquez si TLS de bout en bout est activé. Bool
httpsUniquement Indiquez si seul https est autorisé. Bool
entréeParamètres Charge utile des paramètres d’entrée de l’application. ingressSettings
loadedCertificates Collection de certificats chargés loadedCertificate[]
persistentDisk Paramètres de disque persistant persistentDisk
public Indique si l’application expose le point de terminaison public Bool
temporaireDisque Paramètres de disque temporaire Disque temporaire
vnetAddons Paramètres d’application supplémentaires dans l’instance d’injection de réseau virtuel appVNetAddons

AppResourcePropertiesAddonConfigs

Nom Descriptif Valeur

AppVNetAddons

Nom Descriptif Valeur
publicPoint de terminaison Indique si l’application dans l’instance d’injection de réseau virtuel expose le point de terminaison accessible à partir d’Internet. Bool

AzureFileVolume

Nom Descriptif Valeur
shareName Nom du partage de fichiers Azure. chaîne (obligatoire)
type Type de la ressource sous-jacente à monter en tant que disque persistant. 'AzureFileVolume' (obligatoire)

CustomPersistentDiskProperties

Nom Descriptif Valeur
mountOptions de montage Il s’agit des options de montage d’un disque persistant. chaîne de caractères[]
mountPath Chemin de montage du disque persistant. chaîne (obligatoire)
lecture seule Indique si le disque persistant est un disque en lectureOnly. Bool
type Défini sur « AzureFileVolume » pour le type AzureFileVolume. 'AzureFileVolume' (obligatoire)

CustomPersistentDiskResource

Nom Descriptif Valeur
customPersistentDiskProperties Propriétés de la charge utile de ressource de disque persistant personnalisée. CustomPersistentDiskProperties
storageId ID de ressource de la ressource Stockage Azure Spring Apps. chaîne (obligatoire)

Paramètres d’entrée

Nom Descriptif Valeur
backendProtocole Comment l’entrée doit communiquer avec ce service back-end d’application. Valeur par défaut
'GRPC'
clientAuth Authentification Client-Certification. IngressSettingsClientAuth
readTimeoutInSeconds Délai de lecture d’entrée en secondes. Int
sendTimeoutInSeconds L’entrée envoie un délai d’expiration en secondes. Int
sessionAffinité Type de l’affinité, définissez-le sur Cookie pour activer l’affinité de session. 'Cookie'
« Aucun »
sessionCookieMaxAge Durée en secondes jusqu’à l’expiration du cookie. Int

IngressSettingsClientAuth

Nom Descriptif Valeur
Certificats Collection d’ID de ressource de certificat. chaîne de caractères[]

LoadedCertificate

Nom Descriptif Valeur
loadTrustStore Indiquez si le certificat sera chargé dans le magasin d’approbations par défaut, uniquement pour le runtime Java. Bool
identifiant de ressource ID de ressource du certificat chargé chaîne (obligatoire)

ManagedIdentityProperties

Nom Descriptif Valeur
principalId ID principal de l’identité managée affectée par le système. corde
ID de locataire ID de locataire de l’identité managée affectée par le système. corde
type Type de l’identité managée « Aucun »
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
Identités attribuées par l'utilisateur Propriétés des identités managées affectées par l’utilisateur UserAssignedManagedIdentities

Disque persistant

Nom Descriptif Valeur
mountPath Chemin de montage du disque persistant corde
sizeInGB Taille du disque persistant en Go Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 50

Disque temporaire

Nom Descriptif Valeur
mountPath Chemin de montage du disque temporaire corde
sizeInGB Taille du disque temporaire en Go Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 5

UserAssignedManagedIdentities

Nom Descriptif Valeur

UserAssignedManagedIdentity

Nom Descriptif Valeur

Exemples d’utilisation

Exemples Bicep

Exemple de base de déploiement d’une application cloud Azure Spring.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource spring 'Microsoft.AppPlatform/Spring@2023-05-01-preview' = {
  name: resourceName
  location: location
  properties: {
    zoneRedundant: false
  }
  sku: {
    name: 'E0'
  }
}

resource app 'Microsoft.AppPlatform/Spring/apps@2023-05-01-preview' = {
  parent: spring
  name: resourceName
  location: location
  properties: {
    customPersistentDisks: []
    enableEndToEndTLS: false
    public: false
  }
}

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 Descriptif
Déployer une application de microservice Azure Spring Apps simple Ce modèle déploie une application de microservice Azure Spring Apps simple à exécuter sur Azure.

Définition de ressource de modèle ARM

Le type de ressource Spring/apps 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.AppPlatform/Spring/apps, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.AppPlatform/Spring/apps",
  "apiVersion": "2022-12-01",
  "name": "string",
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "addonConfigs": {
      "{customized property}": {}
    },
    "customPersistentDisks": [
      {
        "customPersistentDiskProperties": {
          "mountOptions": [ "string" ],
          "mountPath": "string",
          "readOnly": "bool",
          "type": "string"
          // For remaining properties, see CustomPersistentDiskProperties objects
        },
        "storageId": "string"
      }
    ],
    "enableEndToEndTLS": "bool",
    "httpsOnly": "bool",
    "ingressSettings": {
      "backendProtocol": "string",
      "clientAuth": {
        "certificates": [ "string" ]
      },
      "readTimeoutInSeconds": "int",
      "sendTimeoutInSeconds": "int",
      "sessionAffinity": "string",
      "sessionCookieMaxAge": "int"
    },
    "loadedCertificates": [
      {
        "loadTrustStore": "bool",
        "resourceId": "string"
      }
    ],
    "persistentDisk": {
      "mountPath": "string",
      "sizeInGB": "int"
    },
    "public": "bool",
    "temporaryDisk": {
      "mountPath": "string",
      "sizeInGB": "int"
    },
    "vnetAddons": {
      "publicEndpoint": "bool"
    }
  }
}

Objets CustomPersistentDiskProperties

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

Pour AzureFileVolume, utilisez :

{
  "shareName": "string",
  "type": "AzureFileVolume"
}

Valeurs de propriété

Microsoft.AppPlatform/Spring/apps

Nom Descriptif Valeur
apiVersion Version de l’API '2022-12-01'
identité Type d’identité managée de la ressource d’application ManagedIdentityProperties
emplacement Emplacement GEO de l’application, toujours identique à sa ressource parente corde
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés de la ressource d’application AppResourceProperties
type Type de ressource 'Microsoft.AppPlatform/Spring/apps'

AppResourceProperties

Nom Descriptif Valeur
addonConfigs Collection de compléments AppResourcePropertiesAddonConfigs
customPersistentDisks Liste des disques persistants personnalisés CustomPersistentDiskResource[]
enableEndToEndTLS Indiquez si TLS de bout en bout est activé. Bool
httpsUniquement Indiquez si seul https est autorisé. Bool
entréeParamètres Charge utile des paramètres d’entrée de l’application. ingressSettings
loadedCertificates Collection de certificats chargés loadedCertificate[]
persistentDisk Paramètres de disque persistant persistentDisk
public Indique si l’application expose le point de terminaison public Bool
temporaireDisque Paramètres de disque temporaire Disque temporaire
vnetAddons Paramètres d’application supplémentaires dans l’instance d’injection de réseau virtuel appVNetAddons

AppResourcePropertiesAddonConfigs

Nom Descriptif Valeur

AppVNetAddons

Nom Descriptif Valeur
publicPoint de terminaison Indique si l’application dans l’instance d’injection de réseau virtuel expose le point de terminaison accessible à partir d’Internet. Bool

AzureFileVolume

Nom Descriptif Valeur
shareName Nom du partage de fichiers Azure. chaîne (obligatoire)
type Type de la ressource sous-jacente à monter en tant que disque persistant. 'AzureFileVolume' (obligatoire)

CustomPersistentDiskProperties

Nom Descriptif Valeur
mountOptions de montage Il s’agit des options de montage d’un disque persistant. chaîne de caractères[]
mountPath Chemin de montage du disque persistant. chaîne (obligatoire)
lecture seule Indique si le disque persistant est un disque en lectureOnly. Bool
type Défini sur « AzureFileVolume » pour le type AzureFileVolume. 'AzureFileVolume' (obligatoire)

CustomPersistentDiskResource

Nom Descriptif Valeur
customPersistentDiskProperties Propriétés de la charge utile de ressource de disque persistant personnalisée. CustomPersistentDiskProperties
storageId ID de ressource de la ressource Stockage Azure Spring Apps. chaîne (obligatoire)

Paramètres d’entrée

Nom Descriptif Valeur
backendProtocole Comment l’entrée doit communiquer avec ce service back-end d’application. Valeur par défaut
'GRPC'
clientAuth Authentification Client-Certification. IngressSettingsClientAuth
readTimeoutInSeconds Délai de lecture d’entrée en secondes. Int
sendTimeoutInSeconds L’entrée envoie un délai d’expiration en secondes. Int
sessionAffinité Type de l’affinité, définissez-le sur Cookie pour activer l’affinité de session. 'Cookie'
« Aucun »
sessionCookieMaxAge Durée en secondes jusqu’à l’expiration du cookie. Int

IngressSettingsClientAuth

Nom Descriptif Valeur
Certificats Collection d’ID de ressource de certificat. chaîne de caractères[]

LoadedCertificate

Nom Descriptif Valeur
loadTrustStore Indiquez si le certificat sera chargé dans le magasin d’approbations par défaut, uniquement pour le runtime Java. Bool
identifiant de ressource ID de ressource du certificat chargé chaîne (obligatoire)

ManagedIdentityProperties

Nom Descriptif Valeur
principalId ID principal de l’identité managée affectée par le système. corde
ID de locataire ID de locataire de l’identité managée affectée par le système. corde
type Type de l’identité managée « Aucun »
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
Identités attribuées par l'utilisateur Propriétés des identités managées affectées par l’utilisateur UserAssignedManagedIdentities

Disque persistant

Nom Descriptif Valeur
mountPath Chemin de montage du disque persistant corde
sizeInGB Taille du disque persistant en Go Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 50

Disque temporaire

Nom Descriptif Valeur
mountPath Chemin de montage du disque temporaire corde
sizeInGB Taille du disque temporaire en Go Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 5

UserAssignedManagedIdentities

Nom Descriptif Valeur

UserAssignedManagedIdentity

Nom Descriptif Valeur

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.

Modèle Descriptif
Déployer une application de microservice Azure Spring Apps simple

Déployer sur Azure
Ce modèle déploie une application de microservice Azure Spring Apps simple à exécuter sur Azure.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource Spring/apps 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.AppPlatform/Spring/apps, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.AppPlatform/Spring/apps@2022-12-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  body = {
    properties = {
      addonConfigs = {
        {customized property} = ?
      }
      customPersistentDisks = [
        {
          customPersistentDiskProperties = {
            mountOptions = [
              "string"
            ]
            mountPath = "string"
            readOnly = bool
            type = "string"
            // For remaining properties, see CustomPersistentDiskProperties objects
          }
          storageId = "string"
        }
      ]
      enableEndToEndTLS = bool
      httpsOnly = bool
      ingressSettings = {
        backendProtocol = "string"
        clientAuth = {
          certificates = [
            "string"
          ]
        }
        readTimeoutInSeconds = int
        sendTimeoutInSeconds = int
        sessionAffinity = "string"
        sessionCookieMaxAge = int
      }
      loadedCertificates = [
        {
          loadTrustStore = bool
          resourceId = "string"
        }
      ]
      persistentDisk = {
        mountPath = "string"
        sizeInGB = int
      }
      public = bool
      temporaryDisk = {
        mountPath = "string"
        sizeInGB = int
      }
      vnetAddons = {
        publicEndpoint = bool
      }
    }
  }
}

Objets CustomPersistentDiskProperties

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

Pour AzureFileVolume, utilisez :

{
  shareName = "string"
  type = "AzureFileVolume"
}

Valeurs de propriété

Microsoft.AppPlatform/Spring/apps

Nom Descriptif Valeur
identité Type d’identité managée de la ressource d’application ManagedIdentityProperties
emplacement Emplacement GEO de l’application, toujours identique à sa ressource parente corde
nom Nom de la ressource chaîne (obligatoire)
parent_id ID de la ressource qui est le parent de cette ressource. ID de la ressource de type : Spring
Propriétés Propriétés de la ressource d’application AppResourceProperties
type Type de ressource « Microsoft.AppPlatform/Spring/apps@2022-12-01 »

AppResourceProperties

Nom Descriptif Valeur
addonConfigs Collection de compléments AppResourcePropertiesAddonConfigs
customPersistentDisks Liste des disques persistants personnalisés CustomPersistentDiskResource[]
enableEndToEndTLS Indiquez si TLS de bout en bout est activé. Bool
httpsUniquement Indiquez si seul https est autorisé. Bool
entréeParamètres Charge utile des paramètres d’entrée de l’application. ingressSettings
loadedCertificates Collection de certificats chargés loadedCertificate[]
persistentDisk Paramètres de disque persistant persistentDisk
public Indique si l’application expose le point de terminaison public Bool
temporaireDisque Paramètres de disque temporaire Disque temporaire
vnetAddons Paramètres d’application supplémentaires dans l’instance d’injection de réseau virtuel appVNetAddons

AppResourcePropertiesAddonConfigs

Nom Descriptif Valeur

AppVNetAddons

Nom Descriptif Valeur
publicPoint de terminaison Indique si l’application dans l’instance d’injection de réseau virtuel expose le point de terminaison accessible à partir d’Internet. Bool

AzureFileVolume

Nom Descriptif Valeur
shareName Nom du partage de fichiers Azure. chaîne (obligatoire)
type Type de la ressource sous-jacente à monter en tant que disque persistant. 'AzureFileVolume' (obligatoire)

CustomPersistentDiskProperties

Nom Descriptif Valeur
mountOptions de montage Il s’agit des options de montage d’un disque persistant. chaîne de caractères[]
mountPath Chemin de montage du disque persistant. chaîne (obligatoire)
lecture seule Indique si le disque persistant est un disque en lectureOnly. Bool
type Défini sur « AzureFileVolume » pour le type AzureFileVolume. 'AzureFileVolume' (obligatoire)

CustomPersistentDiskResource

Nom Descriptif Valeur
customPersistentDiskProperties Propriétés de la charge utile de ressource de disque persistant personnalisée. CustomPersistentDiskProperties
storageId ID de ressource de la ressource Stockage Azure Spring Apps. chaîne (obligatoire)

Paramètres d’entrée

Nom Descriptif Valeur
backendProtocole Comment l’entrée doit communiquer avec ce service back-end d’application. Valeur par défaut
'GRPC'
clientAuth Authentification Client-Certification. IngressSettingsClientAuth
readTimeoutInSeconds Délai de lecture d’entrée en secondes. Int
sendTimeoutInSeconds L’entrée envoie un délai d’expiration en secondes. Int
sessionAffinité Type de l’affinité, définissez-le sur Cookie pour activer l’affinité de session. 'Cookie'
« Aucun »
sessionCookieMaxAge Durée en secondes jusqu’à l’expiration du cookie. Int

IngressSettingsClientAuth

Nom Descriptif Valeur
Certificats Collection d’ID de ressource de certificat. chaîne de caractères[]

LoadedCertificate

Nom Descriptif Valeur
loadTrustStore Indiquez si le certificat sera chargé dans le magasin d’approbations par défaut, uniquement pour le runtime Java. Bool
identifiant de ressource ID de ressource du certificat chargé chaîne (obligatoire)

ManagedIdentityProperties

Nom Descriptif Valeur
principalId ID principal de l’identité managée affectée par le système. corde
ID de locataire ID de locataire de l’identité managée affectée par le système. corde
type Type de l’identité managée « Aucun »
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
Identités attribuées par l'utilisateur Propriétés des identités managées affectées par l’utilisateur UserAssignedManagedIdentities

Disque persistant

Nom Descriptif Valeur
mountPath Chemin de montage du disque persistant corde
sizeInGB Taille du disque persistant en Go Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 50

Disque temporaire

Nom Descriptif Valeur
mountPath Chemin de montage du disque temporaire corde
sizeInGB Taille du disque temporaire en Go Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 5

UserAssignedManagedIdentities

Nom Descriptif Valeur

UserAssignedManagedIdentity

Nom Descriptif Valeur

Exemples d’utilisation

Échantillons Terraform

Exemple de base de déploiement d’une application cloud Azure Spring.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "Spring" {
  type      = "Microsoft.AppPlatform/Spring@2023-05-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      zoneRedundant = false
    }
    sku = {
      name = "E0"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "app" {
  type      = "Microsoft.AppPlatform/Spring/apps@2023-05-01-preview"
  parent_id = azapi_resource.Spring.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      customPersistentDisks = [
      ]
      enableEndToEndTLS = false
      public            = false
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}