az appservice plan
Manage app service plans.
Commands
az appservice plan create |
Create an app service plan. |
az appservice plan delete |
Delete an app service plan. |
az appservice plan list |
List app service plans. |
az appservice plan show |
Get the app service plans for a resource group or a set of resource groups. |
az appservice plan update |
Update an app service plan. |
az appservice plan create
Create an app service plan.
az appservice plan create --name
--resource-group
[--app-service-environment]
[--hyper-v]
[--is-linux]
[--location]
[--no-wait]
[--number-of-workers]
[--per-site-scaling]
[--sku {B1, B2, B3, D1, F1, FREE, I1, I2, I3, P1V2, P1V3, P2V2, P2V3, P3V2, P3V3, PC2, PC3, PC4, S1, S2, S3, SHARED}]
[--subscription]
[--tags]
Examples
Create a basic app service plan.
az appservice plan create -g MyResourceGroup -n MyPlan
Create a standard app service plan with with four Linux workers.
az appservice plan create -g MyResourceGroup -n MyPlan \
--is-linux --number-of-workers 4 --sku S1
Create an app service plan for app service environment.
az appservice plan create -g MyResourceGroup -n MyPlan \
--app-service-environment MyAppServiceEnvironment --sku I1
Required Parameters
Name of the new app service plan.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Optional Parameters
Name or ID of the app service environment.
Host web app on Windows container.
Host web app on Linux worker.
Location. Values from: az account list-locations
. You can configure the default location using az configure --defaults location=<location>
.
Do not wait for the long-running operation to finish.
Number of workers to be allocated.
Enable per-app scaling at the App Service plan level to allow for scaling an app independently from the App Service plan that hosts it.
The pricing tiers, e.g., F1(Free), D1(Shared), B1(Basic Small), B2(Basic Medium), B3(Basic Large), S1(Standard Small), P1V2(Premium V2 Small), P1V3(Premium V3 Small), P2V3(Premium V3 Medium), P3V3(Premium V3 Large), PC2 (Premium Container Small), PC3 (Premium Container Medium), PC4 (Premium Container Large), I1 (Isolated Small), I2 (Isolated Medium), I3 (Isolated Large).
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az appservice plan delete
Delete an app service plan.
az appservice plan delete [--ids]
[--name]
[--resource-group]
[--subscription]
[--yes]
Examples
Delete an app service plan. (autogenerated)
az appservice plan delete --name MyAppServicePlan --resource-group MyResourceGroup
Optional Parameters
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.
The name of the app service plan.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Do not prompt for confirmation.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az appservice plan list
List app service plans.
az appservice plan list [--query-examples]
[--resource-group]
[--subscription]
Examples
List all free tier App Service plans.
az appservice plan list --query "[?sku.tier=='Free']"
List all App Service plans for an App Service environment.
az appservice plan list --query "[?hostingEnvironmentProfile.name=='<ase-name>']"
Optional Parameters
Recommend JMESPath string for you. You can copy one of the query and paste it after --query parameter within double quotation marks to see the results. You can add one or more positional keywords so that we can give suggestions based on these key words.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az appservice plan show
Get the app service plans for a resource group or a set of resource groups.
az appservice plan show [--ids]
[--name]
[--query-examples]
[--resource-group]
[--subscription]
Examples
Get the app service plans for a resource group or a set of resource groups. (autogenerated)
az appservice plan show --name MyAppServicePlan --resource-group MyResourceGroup
Optional Parameters
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.
The name of the app service plan.
Recommend JMESPath string for you. You can copy one of the query and paste it after --query parameter within double quotation marks to see the results. You can add one or more positional keywords so that we can give suggestions based on these key words.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az appservice plan update
Update an app service plan.
See https:///go.microsoft.com/fwlink/?linkid=2133856 to learn more.
az appservice plan update [--add]
[--force-string]
[--ids]
[--name]
[--no-wait]
[--number-of-workers]
[--remove]
[--resource-group]
[--set]
[--sku {B1, B2, B3, D1, F1, FREE, I1, I2, I3, P1V2, P1V3, P2V2, P2V3, P3V2, P3V3, PC2, PC3, PC4, S1, S2, S3, SHARED}]
[--subscription]
Examples
Update an app service plan. (autogenerated)
az appservice plan update --name MyAppServicePlan --resource-group MyResourceGroup --sku F1
Optional Parameters
Add an object to a list of objects by specifying a path and key value pairs. Example: --add property.listProperty <key=value, string or JSON string>.
When using 'set' or 'add', preserve string literals instead of attempting to convert to JSON.
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.
The name of the app service plan.
Do not wait for the long-running operation to finish.
Number of workers to be allocated.
Remove a property or an element from a list. Example: --remove property.list OR --remove propertyToRemove.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Update an object by specifying a property path and value to set. Example: --set property1.property2=.
The pricing tiers, e.g., F1(Free), D1(Shared), B1(Basic Small), B2(Basic Medium), B3(Basic Large), S1(Standard Small), P1V2(Premium V2 Small), P1V3(Premium V3 Small), P2V3(Premium V3 Medium), P3V3(Premium V3 Large), PC2 (Premium Container Small), PC3 (Premium Container Medium), PC4 (Premium Container Large), I1 (Isolated Small), I2 (Isolated Medium), I3 (Isolated Large).
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.