az functionapp flex-migration

Manage migration between Linux Consumption and Flex Consumption plans.

Commands

Name	Description	Type	Status
az functionapp flex-migration list	List all Linux Consumption function apps that are eligible for migration to the Flex Consumption plan.	Core	GA
az functionapp flex-migration revert	Revert an in-place upgraded Flex Consumption function app to Linux Consumption.	Core	Preview
az functionapp flex-migration start	Migrate a Linux Consumption function app to Flex Consumption. Supports side-by-side (new app) or in-place (same app) upgrade.	Core	GA

az functionapp flex-migration list

Edit

List all Linux Consumption function apps that are eligible for migration to the Flex Consumption plan.

az functionapp flex-migration list

Examples

List all Linux Consumption function apps that are eligible for migration to the Flex Consumption plan.

az functionapp flex-migration list

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az functionapp flex-migration revert

Edit

Preview

This command is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Revert an in-place upgraded Flex Consumption function app to Linux Consumption.

az functionapp flex-migration revert --source-name
                                     --source-resource-group
                                     [--acquire-policy-token]
                                     [--change-reference]

Examples

Revert a function app to Linux Consumption within its revert window.

az functionapp flex-migration revert --source-name MyFunctionApp --source-resource-group MyResourceGroup

Required Parameters

--source-name

The name of the function app to revert.

--source-resource-group

The resource group of the function app to revert.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az functionapp flex-migration start

Edit

Migrate a Linux Consumption function app to Flex Consumption. Supports side-by-side (new app) or in-place (same app) upgrade.

az functionapp flex-migration start --source-name
                                    --source-resource-group
                                    [--acquire-policy-token]
                                    [--always-ready-instances]
                                    [--change-reference]
                                    [--deployment-storage-auth-type --dsat {StorageAccountConnectionString, SystemAssignedIdentity, UserAssignedIdentity}]
                                    [--deployment-storage-auth-value --dsav]
                                    [--deployment-storage-container-name --dscn]
                                    [--deployment-storage-name --dsn]
                                    [--ids]
                                    [--in-place {false, true}]
                                    [--instance-memory]
                                    [--maximum-instance-count]
                                    [--name]
                                    [--resource-group]
                                    [--sar --skip-access-restrictions {false, true}]
                                    [--sc --skip-cors {false, true}]
                                    [--sh --skip-hostnames {false, true}]
                                    [--skip-managed-identities --smi {false, true}]
                                    [--skip-storage-mount --ssm {false, true}]
                                    [--storage-account]
                                    [--subscription]

Examples

Migrate a Linux Consumption function app to the Flex Consumption plan (side-by-side, creates a new app).

az functionapp flex-migration start --source-name MyLinuxConsumptionApp --source-resource-group MyLinuxConsumptionResourceGroup --name MyFunctionApp --resource-group MyResourceGroup --storage-account MyStorageAccount

Migrate a Linux Consumption function app to the Flex Consumption plan without migrating managed identity configurations.

az functionapp flex-migration start --source-name MyLinuxConsumptionApp --source-resource-group MyLinuxConsumptionResourceGroup --name MyFunctionApp --resource-group MyResourceGroup --storage-account MyStorageAccount --skip-managed-identities

Upgrade a Linux Consumption function app to Flex Consumption in place (same app, same name).

az functionapp flex-migration start --source-name MyLinuxConsumptionApp --source-resource-group MyLinuxConsumptionResourceGroup --in-place

Required Parameters

--source-name

The name of the source function app to migrate from.

--source-resource-group

The resource group of the source function app to migrate from.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--always-ready-instances

Space-separated configuration for the number of pre-allocated instances in the format <name>=<value>.

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--deployment-storage-auth-type --dsat

The deployment storage account authentication type.

Property	Value
Accepted values:	StorageAccountConnectionString, SystemAssignedIdentity, UserAssignedIdentity

--deployment-storage-auth-value --dsav

The deployment storage account authentication value. For the user-assigned managed identity authentication type, this should be the user assigned identity resource id. For the storage account connection string authentication type, this should be the name of the app setting that will contain the storage account connection string. For the system assigned managed-identity authentication type, this parameter is not applicable and should be left empty.

--deployment-storage-container-name --dscn

The deployment storage account container name.

--deployment-storage-name --dsn

The deployment storage account name.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

Property	Value
Parameter group:	Resource Id Arguments

--in-place -i

Preview

Upgrade the source app to Flex Consumption in place (same app, same name, same hostname). Cannot be used with --name or --resource-group.

Property	Value
Default value:	False
Accepted values:	false, true

--instance-memory

The instance memory size in MB. See https://aka.ms/flex-instance-sizes for more information on the supported values.

--maximum-instance-count

The maximum number of instances.

--name -n

The name of the target function app to migrate to. Not applicable with --in-place.

Property	Value
Parameter group:	Resource Id Arguments

--resource-group

The resource group of the target function app to migrate to. Not applicable with --in-place.

--sar --skip-access-restrictions

Skip migrating access restrictions.

Property	Value
Default value:	False
Accepted values:	false, true

--sc --skip-cors

Skip migrating CORS settings.

Property	Value
Default value:	False
Accepted values:	false, true

--sh --skip-hostnames

Skip migrating hostnames.

Property	Value
Default value:	False
Accepted values:	false, true

--skip-managed-identities --smi

Skip migrating managed identities.

Property	Value
Default value:	False
Accepted values:	false, true

--skip-storage-mount --ssm

Skip migrating storage mounts.

Property	Value
Default value:	False
Accepted values:	false, true

--storage-account

The storage account to use for the target function app. If no storage account is provided, the storage account of the source function app will be used.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

Feedback

Was this page helpful?