Microsoft.AppPlatform Spring/apps/deployments 2022-01-01-preview

Article
04/28/2023

Bicep resource definition

The Spring/apps/deployments resource type can be deployed with operations that target:

Resource groups - See resource group deployment commands

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-01-01-preview' = {
  name: 'string'
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  parent: resourceSymbolicName
  properties: {
    active: bool
    deploymentSettings: {
      addonConfigs: {}
      containerProbeSettings: {
        disableProbe: bool
      }
      environmentVariables: {}
      resourceRequests: {
        cpu: 'string'
        memory: 'string'
      }
    }
    source: {
      version: 'string'
      type: 'string'
      // For remaining properties, see UserSourceInfo objects
    }
  }
}

UserSourceInfo objects

Set the type property to specify the type of object.

For BuildResult, use:

  type: 'BuildResult'
  buildResultId: 'string'

For Container, use:

  type: 'Container'
  customContainer: {
    args: [
      'string'
    ]
    command: [
      'string'
    ]
    containerImage: 'string'
    imageRegistryCredential: {
      password: 'string'
      username: 'string'
    }
    server: 'string'
  }

For Jar, use:

  type: 'Jar'
  jvmOptions: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'

For NetCoreZip, use:

  type: 'NetCoreZip'
  netCoreMainEntryPath: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'

For Source, use:

  type: 'Source'
  artifactSelector: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'

Property values

Spring/apps/deployments

Name	Description	Value
name	The resource name See how to set names and types for child resources in Bicep.	string (required)
sku	Sku of the Deployment resource	Sku
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: apps
properties	Properties of the Deployment resource	DeploymentResourceProperties

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	object
containerProbeSettings	Container liveness and readiness probe settings	ContainerProbeSettings
environmentVariables	Collection of environment variables	object
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

ContainerProbeSettings

Name	Description	Value
disableProbe	Indicates whether disable the liveness and readiness probe	bool

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

UserSourceInfo

Name	Description	Value
version	Version of the source	string
type	Set the object type	BuildResult Container Jar NetCoreZip Source (required)

BuildResultUserSourceInfo

Name	Description	Value
type	Type of the source uploaded	'BuildResult' (required)
buildResultId	Resource id of an existing succeeded build result under the same Spring instance.	string

CustomContainerUserSourceInfo

Name	Description	Value
type	Type of the source uploaded	'Container' (required)
customContainer	Custom container payload	CustomContainer

CustomContainer

Name	Description	Value
args	Arguments to the entrypoint. The docker image's CMD is used if this is not provided.	string[]
command	Entrypoint array. Not executed within a shell. The docker image's ENTRYPOINT is used if this is not provided.	string[]
containerImage	Container image of the custom container. This should be in the form of {repository}:{tag} without the server name of the registry	string
imageRegistryCredential	Credential of the image registry	ImageRegistryCredential
server	The name of the registry that contains the container image	string

ImageRegistryCredential

Name	Description	Value
password	The password of the image registry credential	string
username	The username of the image registry credential	string

JarUploadedUserSourceInfo

Name	Description	Value
type	Type of the source uploaded	'Jar' (required)
jvmOptions	JVM parameter	string
relativePath	Relative path of the storage which stores the source	string
runtimeVersion	Runtime version of the Jar file	string

NetCoreZipUploadedUserSourceInfo

Name	Description	Value
type	Type of the source uploaded	'NetCoreZip' (required)
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

SourceUploadedUserSourceInfo

Name	Description	Value
type	Type of the source uploaded	'Source' (required)
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

Sku

Name	Description	Value
capacity	Current capacity of the target resource	int
name	Name of the Sku	string
tier	Tier of the Sku	string

ARM template resource definition

The Spring/apps/deployments resource type can be deployed with operations that target:

Resource groups - See resource group deployment commands

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-01-01-preview",
  "name": "string",
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "properties": {
    "active": "bool",
    "deploymentSettings": {
      "addonConfigs": {},
      "containerProbeSettings": {
        "disableProbe": "bool"
      },
      "environmentVariables": {},
      "resourceRequests": {
        "cpu": "string",
        "memory": "string"
      }
    },
    "source": {
      "version": "string",
      "type": "string"
      // For remaining properties, see UserSourceInfo objects
    }
  }
}

UserSourceInfo objects

Set the type property to specify the type of object.

For BuildResult, use:

  "type": "BuildResult",
  "buildResultId": "string"

For Container, use:

  "type": "Container",
  "customContainer": {
    "args": [ "string" ],
    "command": [ "string" ],
    "containerImage": "string",
    "imageRegistryCredential": {
      "password": "string",
      "username": "string"
    },
    "server": "string"
  }

For Jar, use:

  "type": "Jar",
  "jvmOptions": "string",
  "relativePath": "string",
  "runtimeVersion": "string"

For NetCoreZip, use:

  "type": "NetCoreZip",
  "netCoreMainEntryPath": "string",
  "relativePath": "string",
  "runtimeVersion": "string"

For Source, use:

  "type": "Source",
  "artifactSelector": "string",
  "relativePath": "string",
  "runtimeVersion": "string"

Property values

Spring/apps/deployments

Name	Description	Value
type	The resource type	'Microsoft.AppPlatform/Spring/apps/deployments'
apiVersion	The resource api version	'2022-01-01-preview'
name	The resource name See how to set names and types for child resources in JSON ARM templates.	string (required)
sku	Sku of the Deployment resource	Sku
properties	Properties of the Deployment resource	DeploymentResourceProperties

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	object
containerProbeSettings	Container liveness and readiness probe settings	ContainerProbeSettings
environmentVariables	Collection of environment variables	object
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

ContainerProbeSettings

Name	Description	Value
disableProbe	Indicates whether disable the liveness and readiness probe	bool

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

UserSourceInfo

Name	Description	Value
version	Version of the source	string
type	Set the object type	BuildResult Container Jar NetCoreZip Source (required)

BuildResultUserSourceInfo

Name	Description	Value
type	Type of the source uploaded	'BuildResult' (required)
buildResultId	Resource id of an existing succeeded build result under the same Spring instance.	string

CustomContainerUserSourceInfo

Name	Description	Value
type	Type of the source uploaded	'Container' (required)
customContainer	Custom container payload	CustomContainer

CustomContainer

Name	Description	Value
args	Arguments to the entrypoint. The docker image's CMD is used if this is not provided.	string[]
command	Entrypoint array. Not executed within a shell. The docker image's ENTRYPOINT is used if this is not provided.	string[]
containerImage	Container image of the custom container. This should be in the form of {repository}:{tag} without the server name of the registry	string
imageRegistryCredential	Credential of the image registry	ImageRegistryCredential
server	The name of the registry that contains the container image	string

ImageRegistryCredential

Name	Description	Value
password	The password of the image registry credential	string
username	The username of the image registry credential	string

JarUploadedUserSourceInfo

Name	Description	Value
type	Type of the source uploaded	'Jar' (required)
jvmOptions	JVM parameter	string
relativePath	Relative path of the storage which stores the source	string
runtimeVersion	Runtime version of the Jar file	string

NetCoreZipUploadedUserSourceInfo

Name	Description	Value
type	Type of the source uploaded	'NetCoreZip' (required)
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

SourceUploadedUserSourceInfo

Name	Description	Value
type	Type of the source uploaded	'Source' (required)
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

Sku

Name	Description	Value
capacity	Current capacity of the target resource	int
name	Name of the Sku	string
tier	Tier of the Sku	string

Terraform (AzAPI provider) resource definition

The Spring/apps/deployments resource type can be deployed with operations that target:

Resource groups

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-01-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      active = bool
      deploymentSettings = {
        addonConfigs = {}
        containerProbeSettings = {
          disableProbe = bool
        }
        environmentVariables = {}
        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:

  type = "BuildResult"
  buildResultId = "string"

For Container, use:

  type = "Container"
  customContainer = {
    args = [
      "string"
    ]
    command = [
      "string"
    ]
    containerImage = "string"
    imageRegistryCredential = {
      password = "string"
      username = "string"
    }
    server = "string"
  }

For Jar, use:

  type = "Jar"
  jvmOptions = "string"
  relativePath = "string"
  runtimeVersion = "string"

For NetCoreZip, use:

  type = "NetCoreZip"
  netCoreMainEntryPath = "string"
  relativePath = "string"
  runtimeVersion = "string"

For Source, use:

  type = "Source"
  artifactSelector = "string"
  relativePath = "string"
  runtimeVersion = "string"

Property values

Spring/apps/deployments

Name	Description	Value
type	The resource type	"Microsoft.AppPlatform/Spring/apps/deployments@2022-01-01-preview"
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: apps
sku	Sku of the Deployment resource	Sku
properties	Properties of the Deployment resource	DeploymentResourceProperties

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	object
containerProbeSettings	Container liveness and readiness probe settings	ContainerProbeSettings
environmentVariables	Collection of environment variables	object
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

ContainerProbeSettings

Name	Description	Value
disableProbe	Indicates whether disable the liveness and readiness probe	bool

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

UserSourceInfo

Name	Description	Value
version	Version of the source	string
type	Set the object type	BuildResult Container Jar NetCoreZip Source (required)

BuildResultUserSourceInfo

Name	Description	Value
type	Type of the source uploaded	"BuildResult" (required)
buildResultId	Resource id of an existing succeeded build result under the same Spring instance.	string

CustomContainerUserSourceInfo

Name	Description	Value
type	Type of the source uploaded	"Container" (required)
customContainer	Custom container payload	CustomContainer

CustomContainer

Name	Description	Value
args	Arguments to the entrypoint. The docker image's CMD is used if this is not provided.	string[]
command	Entrypoint array. Not executed within a shell. The docker image's ENTRYPOINT is used if this is not provided.	string[]
containerImage	Container image of the custom container. This should be in the form of {repository}:{tag} without the server name of the registry	string
imageRegistryCredential	Credential of the image registry	ImageRegistryCredential
server	The name of the registry that contains the container image	string

ImageRegistryCredential

Name	Description	Value
password	The password of the image registry credential	string
username	The username of the image registry credential	string

JarUploadedUserSourceInfo

Name	Description	Value
type	Type of the source uploaded	"Jar" (required)
jvmOptions	JVM parameter	string
relativePath	Relative path of the storage which stores the source	string
runtimeVersion	Runtime version of the Jar file	string

NetCoreZipUploadedUserSourceInfo

Name	Description	Value
type	Type of the source uploaded	"NetCoreZip" (required)
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

SourceUploadedUserSourceInfo

Name	Description	Value
type	Type of the source uploaded	"Source" (required)
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

Sku

Name	Description	Value
capacity	Current capacity of the target resource	int
name	Name of the Sku	string
tier	Tier of the Sku	string

Microsoft.AppPlatform Spring/apps/deployments 2022-01-01-preview

Bicep resource definition

Resource format

UserSourceInfo objects

Property values

Spring/apps/deployments

DeploymentResourceProperties

DeploymentSettings

ContainerProbeSettings

ResourceRequests

UserSourceInfo

BuildResultUserSourceInfo

CustomContainerUserSourceInfo

CustomContainer

ImageRegistryCredential

JarUploadedUserSourceInfo

NetCoreZipUploadedUserSourceInfo

SourceUploadedUserSourceInfo

Sku

ARM template resource definition

Resource format

UserSourceInfo objects

Property values

Spring/apps/deployments

DeploymentResourceProperties

DeploymentSettings

ContainerProbeSettings

ResourceRequests

UserSourceInfo

BuildResultUserSourceInfo

CustomContainerUserSourceInfo

CustomContainer

ImageRegistryCredential

JarUploadedUserSourceInfo

NetCoreZipUploadedUserSourceInfo

SourceUploadedUserSourceInfo

Sku

Terraform (AzAPI provider) resource definition

Resource format

UserSourceInfo objects

Property values

Spring/apps/deployments

DeploymentResourceProperties

DeploymentSettings

ContainerProbeSettings

ResourceRequests

UserSourceInfo

BuildResultUserSourceInfo

CustomContainerUserSourceInfo

CustomContainer

ImageRegistryCredential

JarUploadedUserSourceInfo

NetCoreZipUploadedUserSourceInfo

SourceUploadedUserSourceInfo

Sku

Feedback

Feedback

Additional resources