Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
- Latest
- 2024-05-01-preview
- 2024-01-01-preview
- 2023-12-01
- 2023-11-01-preview
- 2023-09-01-preview
- 2023-07-01-preview
- 2023-05-01-preview
- 2023-03-01-preview
- 2023-01-01-preview
- 2022-12-01
- 2022-11-01-preview
- 2022-09-01-preview
- 2022-05-01-preview
- 2022-04-01
- 2022-03-01-preview
- 2022-01-01-preview
- 2021-09-01-preview
- 2021-06-01-preview
- 2020-11-01-preview
- 2020-07-01
Remarks
Note: Azure Spring Apps Application Deployments (Microsoft.AppPlatform/Spring/apps/deployments) is now deprecated and will be retired on 2028-05-31. See https://aka.ms/asaretirement for more information.
Bicep resource definition
The Spring/apps/deployments resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.AppPlatform/Spring/apps/deployments resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.AppPlatform/Spring/apps/deployments@2022-04-01' = {
parent: resourceSymbolicName
name: 'string'
properties: {
active: bool
deploymentSettings: {
addonConfigs: {
{customized property}: {
{customized property}: any(...)
}
}
environmentVariables: {
{customized property}: 'string'
}
resourceRequests: {
cpu: 'string'
memory: 'string'
}
}
source: {
version: 'string'
type: 'string'
// For remaining properties, see UserSourceInfo objects
}
}
sku: {
capacity: int
name: 'string'
tier: 'string'
}
}
UserSourceInfo objects
Set the type property to specify the type of object.
For BuildResult, use:
{
buildResultId: 'string'
type: 'BuildResult'
}
For Jar, use:
{
jvmOptions: 'string'
relativePath: 'string'
runtimeVersion: 'string'
type: 'Jar'
}
For NetCoreZip, use:
{
netCoreMainEntryPath: 'string'
relativePath: 'string'
runtimeVersion: 'string'
type: 'NetCoreZip'
}
For Source, use:
{
artifactSelector: 'string'
relativePath: 'string'
runtimeVersion: 'string'
type: 'Source'
}
Property Values
Microsoft.AppPlatform/Spring/apps/deployments
| Name | Description | Value |
|---|---|---|
| name | The resource name | string (required) |
| parent | In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource. For more information, see Child resource outside parent resource. |
Symbolic name for resource of type: Spring/apps |
| properties | Properties of the Deployment resource | DeploymentResourceProperties |
| sku | Sku of the Deployment resource | Sku |
AddonProfile
| Name | Description | Value |
|---|
BuildResultUserSourceInfo
| Name | Description | Value |
|---|---|---|
| buildResultId | Resource id of an existing succeeded build result under the same Spring instance. | string |
| type | Type of the source uploaded | 'BuildResult' (required) |
DeploymentResourceProperties
| Name | Description | Value |
|---|---|---|
| active | Indicates whether the Deployment is active | bool |
| deploymentSettings | Deployment settings of the Deployment | DeploymentSettings |
| source | Uploaded source information of the deployment. | UserSourceInfo |
DeploymentSettings
| Name | Description | Value |
|---|---|---|
| addonConfigs | Collection of addons | DeploymentSettingsAddonConfigs |
| environmentVariables | Collection of environment variables | DeploymentSettingsEnvironmentVariables |
| resourceRequests | The requested resource quantity for required CPU and Memory. It is recommended that using this field to represent the required CPU and Memory, the old field cpu and memoryInGB will be deprecated later. | ResourceRequests |
DeploymentSettingsAddonConfigs
| Name | Description | Value |
|---|
DeploymentSettingsEnvironmentVariables
| Name | Description | Value |
|---|
JarUploadedUserSourceInfo
| Name | Description | Value |
|---|---|---|
| jvmOptions | JVM parameter | string |
| relativePath | Relative path of the storage which stores the source | string |
| runtimeVersion | Runtime version of the Jar file | string |
| type | Type of the source uploaded | 'Jar' (required) |
NetCoreZipUploadedUserSourceInfo
| Name | Description | Value |
|---|---|---|
| netCoreMainEntryPath | The path to the .NET executable relative to zip root | string |
| relativePath | Relative path of the storage which stores the source | string |
| runtimeVersion | Runtime version of the .Net file | string |
| type | Type of the source uploaded | 'NetCoreZip' (required) |
ResourceRequests
| Name | Description | Value |
|---|---|---|
| cpu | Required CPU. 1 core can be represented by 1 or 1000m. This should be 500m or 1 for Basic tier, and {500m, 1, 2, 3, 4} for Standard tier. | string |
| memory | Required memory. 1 GB can be represented by 1Gi or 1024Mi. This should be {512Mi, 1Gi, 2Gi} for Basic tier, and {512Mi, 1Gi, 2Gi, ..., 8Gi} for Standard tier. | string |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Current capacity of the target resource | int |
| name | Name of the Sku | string |
| tier | Tier of the Sku | string |
SourceUploadedUserSourceInfo
| Name | Description | Value |
|---|---|---|
| artifactSelector | Selector for the artifact to be used for the deployment for multi-module projects. This should be the relative path to the target module/project. |
string |
| relativePath | Relative path of the storage which stores the source | string |
| runtimeVersion | Runtime version of the source file | string |
| type | Type of the source uploaded | 'Source' (required) |
UserSourceInfo
| Name | Description | Value |
|---|---|---|
| type | Set to 'BuildResult' for type BuildResultUserSourceInfo. Set to 'Jar' for type JarUploadedUserSourceInfo. Set to 'NetCoreZip' for type NetCoreZipUploadedUserSourceInfo. Set to 'Source' for type SourceUploadedUserSourceInfo. | 'BuildResult' 'Jar' 'NetCoreZip' 'Source' (required) |
| version | Version of the source | string |
Usage Examples
Azure Quickstart Samples
The following Azure Quickstart templates contain Bicep samples for deploying this resource type.
| Bicep File | Description |
|---|---|
| Deploy a simple Azure Spring Apps microservice application | This template deploys a simple Azure Spring Apps microservice application to run on Azure. |
ARM template resource definition
The Spring/apps/deployments resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.AppPlatform/Spring/apps/deployments resource, add the following JSON to your template.
{
"type": "Microsoft.AppPlatform/Spring/apps/deployments",
"apiVersion": "2022-04-01",
"name": "string",
"properties": {
"active": "bool",
"deploymentSettings": {
"addonConfigs": {
"{customized property}": {
"{customized property}": {}
}
},
"environmentVariables": {
"{customized property}": "string"
},
"resourceRequests": {
"cpu": "string",
"memory": "string"
}
},
"source": {
"version": "string",
"type": "string"
// For remaining properties, see UserSourceInfo objects
}
},
"sku": {
"capacity": "int",
"name": "string",
"tier": "string"
}
}
UserSourceInfo objects
Set the type property to specify the type of object.
For BuildResult, use:
{
"buildResultId": "string",
"type": "BuildResult"
}
For Jar, use:
{
"jvmOptions": "string",
"relativePath": "string",
"runtimeVersion": "string",
"type": "Jar"
}
For NetCoreZip, use:
{
"netCoreMainEntryPath": "string",
"relativePath": "string",
"runtimeVersion": "string",
"type": "NetCoreZip"
}
For Source, use:
{
"artifactSelector": "string",
"relativePath": "string",
"runtimeVersion": "string",
"type": "Source"
}
Property Values
Microsoft.AppPlatform/Spring/apps/deployments
| Name | Description | Value |
|---|---|---|
| apiVersion | The api version | '2022-04-01' |
| name | The resource name | string (required) |
| properties | Properties of the Deployment resource | DeploymentResourceProperties |
| sku | Sku of the Deployment resource | Sku |
| type | The resource type | 'Microsoft.AppPlatform/Spring/apps/deployments' |
AddonProfile
| Name | Description | Value |
|---|
BuildResultUserSourceInfo
| Name | Description | Value |
|---|---|---|
| buildResultId | Resource id of an existing succeeded build result under the same Spring instance. | string |
| type | Type of the source uploaded | 'BuildResult' (required) |
DeploymentResourceProperties
| Name | Description | Value |
|---|---|---|
| active | Indicates whether the Deployment is active | bool |
| deploymentSettings | Deployment settings of the Deployment | DeploymentSettings |
| source | Uploaded source information of the deployment. | UserSourceInfo |
DeploymentSettings
| Name | Description | Value |
|---|---|---|
| addonConfigs | Collection of addons | DeploymentSettingsAddonConfigs |
| environmentVariables | Collection of environment variables | DeploymentSettingsEnvironmentVariables |
| resourceRequests | The requested resource quantity for required CPU and Memory. It is recommended that using this field to represent the required CPU and Memory, the old field cpu and memoryInGB will be deprecated later. | ResourceRequests |
DeploymentSettingsAddonConfigs
| Name | Description | Value |
|---|
DeploymentSettingsEnvironmentVariables
| Name | Description | Value |
|---|
JarUploadedUserSourceInfo
| Name | Description | Value |
|---|---|---|
| jvmOptions | JVM parameter | string |
| relativePath | Relative path of the storage which stores the source | string |
| runtimeVersion | Runtime version of the Jar file | string |
| type | Type of the source uploaded | 'Jar' (required) |
NetCoreZipUploadedUserSourceInfo
| Name | Description | Value |
|---|---|---|
| netCoreMainEntryPath | The path to the .NET executable relative to zip root | string |
| relativePath | Relative path of the storage which stores the source | string |
| runtimeVersion | Runtime version of the .Net file | string |
| type | Type of the source uploaded | 'NetCoreZip' (required) |
ResourceRequests
| Name | Description | Value |
|---|---|---|
| cpu | Required CPU. 1 core can be represented by 1 or 1000m. This should be 500m or 1 for Basic tier, and {500m, 1, 2, 3, 4} for Standard tier. | string |
| memory | Required memory. 1 GB can be represented by 1Gi or 1024Mi. This should be {512Mi, 1Gi, 2Gi} for Basic tier, and {512Mi, 1Gi, 2Gi, ..., 8Gi} for Standard tier. | string |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Current capacity of the target resource | int |
| name | Name of the Sku | string |
| tier | Tier of the Sku | string |
SourceUploadedUserSourceInfo
| Name | Description | Value |
|---|---|---|
| artifactSelector | Selector for the artifact to be used for the deployment for multi-module projects. This should be the relative path to the target module/project. |
string |
| relativePath | Relative path of the storage which stores the source | string |
| runtimeVersion | Runtime version of the source file | string |
| type | Type of the source uploaded | 'Source' (required) |
UserSourceInfo
| Name | Description | Value |
|---|---|---|
| type | Set to 'BuildResult' for type BuildResultUserSourceInfo. Set to 'Jar' for type JarUploadedUserSourceInfo. Set to 'NetCoreZip' for type NetCoreZipUploadedUserSourceInfo. Set to 'Source' for type SourceUploadedUserSourceInfo. | 'BuildResult' 'Jar' 'NetCoreZip' 'Source' (required) |
| version | Version of the source | string |
Usage Examples
Azure Quickstart Templates
The following Azure Quickstart templates deploy this resource type.
| Template | Description |
|---|---|
| Deploy a simple Azure Spring Apps microservice application |
This template deploys a simple Azure Spring Apps microservice application to run on Azure. |
Terraform (AzAPI provider) resource definition
The Spring/apps/deployments resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.AppPlatform/Spring/apps/deployments resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.AppPlatform/Spring/apps/deployments@2022-04-01"
name = "string"
parent_id = "string"
body = {
properties = {
active = bool
deploymentSettings = {
addonConfigs = {
{customized property} = {
{customized property} = ?
}
}
environmentVariables = {
{customized property} = "string"
}
resourceRequests = {
cpu = "string"
memory = "string"
}
}
source = {
version = "string"
type = "string"
// For remaining properties, see UserSourceInfo objects
}
}
sku = {
capacity = int
name = "string"
tier = "string"
}
}
}
UserSourceInfo objects
Set the type property to specify the type of object.
For BuildResult, use:
{
buildResultId = "string"
type = "BuildResult"
}
For Jar, use:
{
jvmOptions = "string"
relativePath = "string"
runtimeVersion = "string"
type = "Jar"
}
For NetCoreZip, use:
{
netCoreMainEntryPath = "string"
relativePath = "string"
runtimeVersion = "string"
type = "NetCoreZip"
}
For Source, use:
{
artifactSelector = "string"
relativePath = "string"
runtimeVersion = "string"
type = "Source"
}
Property Values
Microsoft.AppPlatform/Spring/apps/deployments
| Name | Description | Value |
|---|---|---|
| name | The resource name | string (required) |
| parent_id | The ID of the resource that is the parent for this resource. | ID for resource of type: Spring/apps |
| properties | Properties of the Deployment resource | DeploymentResourceProperties |
| sku | Sku of the Deployment resource | Sku |
| type | The resource type | "Microsoft.AppPlatform/Spring/apps/deployments@2022-04-01" |
AddonProfile
| Name | Description | Value |
|---|
BuildResultUserSourceInfo
| Name | Description | Value |
|---|---|---|
| buildResultId | Resource id of an existing succeeded build result under the same Spring instance. | string |
| type | Type of the source uploaded | 'BuildResult' (required) |
DeploymentResourceProperties
| Name | Description | Value |
|---|---|---|
| active | Indicates whether the Deployment is active | bool |
| deploymentSettings | Deployment settings of the Deployment | DeploymentSettings |
| source | Uploaded source information of the deployment. | UserSourceInfo |
DeploymentSettings
| Name | Description | Value |
|---|---|---|
| addonConfigs | Collection of addons | DeploymentSettingsAddonConfigs |
| environmentVariables | Collection of environment variables | DeploymentSettingsEnvironmentVariables |
| resourceRequests | The requested resource quantity for required CPU and Memory. It is recommended that using this field to represent the required CPU and Memory, the old field cpu and memoryInGB will be deprecated later. | ResourceRequests |
DeploymentSettingsAddonConfigs
| Name | Description | Value |
|---|
DeploymentSettingsEnvironmentVariables
| Name | Description | Value |
|---|
JarUploadedUserSourceInfo
| Name | Description | Value |
|---|---|---|
| jvmOptions | JVM parameter | string |
| relativePath | Relative path of the storage which stores the source | string |
| runtimeVersion | Runtime version of the Jar file | string |
| type | Type of the source uploaded | 'Jar' (required) |
NetCoreZipUploadedUserSourceInfo
| Name | Description | Value |
|---|---|---|
| netCoreMainEntryPath | The path to the .NET executable relative to zip root | string |
| relativePath | Relative path of the storage which stores the source | string |
| runtimeVersion | Runtime version of the .Net file | string |
| type | Type of the source uploaded | 'NetCoreZip' (required) |
ResourceRequests
| Name | Description | Value |
|---|---|---|
| cpu | Required CPU. 1 core can be represented by 1 or 1000m. This should be 500m or 1 for Basic tier, and {500m, 1, 2, 3, 4} for Standard tier. | string |
| memory | Required memory. 1 GB can be represented by 1Gi or 1024Mi. This should be {512Mi, 1Gi, 2Gi} for Basic tier, and {512Mi, 1Gi, 2Gi, ..., 8Gi} for Standard tier. | string |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Current capacity of the target resource | int |
| name | Name of the Sku | string |
| tier | Tier of the Sku | string |
SourceUploadedUserSourceInfo
| Name | Description | Value |
|---|---|---|
| artifactSelector | Selector for the artifact to be used for the deployment for multi-module projects. This should be the relative path to the target module/project. |
string |
| relativePath | Relative path of the storage which stores the source | string |
| runtimeVersion | Runtime version of the source file | string |
| type | Type of the source uploaded | 'Source' (required) |
UserSourceInfo
| Name | Description | Value |
|---|---|---|
| type | Set to 'BuildResult' for type BuildResultUserSourceInfo. Set to 'Jar' for type JarUploadedUserSourceInfo. Set to 'NetCoreZip' for type NetCoreZipUploadedUserSourceInfo. Set to 'Source' for type SourceUploadedUserSourceInfo. | 'BuildResult' 'Jar' 'NetCoreZip' 'Source' (required) |
| version | Version of the source | string |
Usage Examples
Terraform Samples
A basic example of deploying Spring Cloud Deployment.
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 = ["*"]
}
resource "azapi_resource" "deployment" {
type = "Microsoft.AppPlatform/Spring/apps/deployments@2023-05-01-preview"
parent_id = azapi_resource.app.id
name = var.resource_name
body = {
properties = {
deploymentSettings = {
environmentVariables = {
}
}
source = {
customContainer = {
args = [
]
command = [
]
containerImage = "springio/gs-spring-boot-docker"
languageFramework = ""
server = "docker.io"
}
type = "Container"
}
}
sku = {
capacity = 1
name = "E0"
tier = "Enterprise"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}